CnPack Open Source Projects - 实现选项配置管理对话框的一小型框架PreferneceManager 0.1.3
  Home Page News Downloads Nightly Build Documents Donation Forum Credits 简体中文
 Latest Releases

 
CnWizards 1.5.1.1219
[2024-11-03]

 
CnVCL 20241103
[2024-11-03]
  Nightly Build
  CnWizards Timeline
 Project Links
 

 
CnPack at GitHub
Use GitHub
 Visitors
Today Visitors: 287
Today Pages: 2309
Total Visitors: 5301907
Total Pages: 21370406
Since: 2003-09-01
 
实现选项配置管理对话框的一小型框架PreferneceManager 0.1.3
 
CnPack Open Source Projects 2007-08-03 20:29:17

实现选项配置管理对话框的一小型框架PreferneceManager 1.3
2008-01-18升级至0.1.3版本
作者:CnPack开发组 许子健

一、概述
本组件包用于实现对软件中类似“选项”或“配置”功能,分为配置管理器和配置项目两个部分,它们不依赖具体所用界面控件的载体,可以按需定制,因此具有扩展性。目前已经实现了基于TFrame的配置项目类。

二、快速指南

01.从IDE新建一个Frame;
02.使用uses引用untTBasePreferenceMgr.pas和untTPreferenceMgr.pas;
03.绘制你的Frame界面;
04.为你的Frame类加上下列Public声明;
   Procedure Apply;
   Procedure Revert;
   Function IsModified: Boolean;
05.在Implementation上方加入下列代码,并替换TYourFrame为在01中新建Frame的类名;
   {$DEFINE TPL_FRAME_PREFERENCE_ITEM}
     T_FRAME_UI = TYourFrame;
   {$INCLUDE 'tplTFramePreferenceItem.pas'}
06.在{$R *.dfm}下方加上下列代码,并替换TYourFrame为在01中新建Frame的类名,然后
   根据实际需求定义各项行为(Apply,Revert,IsModified);
   {$INCLUDE 'tplTFramePreferenceItem.pas'}

   Procedure TFramePreferenceItem.Apply;
   Begin
     TYourFrame(FFrameUI).Apply;
   End;

   Function TFramePreferenceItem.IsModified: Boolean;
   Begin
     Result := TYourFrame(FFrameUI).IsModified;
   End;

   Procedure TFramePreferenceItem.Revert;
   Begin
     TYourFrame(FFrameUI).Revert;
   End;

   Procedure TFrameItemA.Revert;
   Begin
     //加上自己的代码,比如恢复界面为默认设置的样子
   End;

   Procedure TFrameItemA.Apply;
   Begin
     //加上自己的代码,比如将设置写进ini或注册表
   End;

   Function TFrameItemA.IsModified: Boolean;
   Begin
     //加上自己的代码,比如判断是否界面与默认值一样
   End;

07.保存文件;
08.重复01至07,以设计其他的配置项目;
09.设计配置中心的界面;
10.在09的界面单元引用untTPreferenceMgr和01至07产生的所有单元;
11.定义01个TPreferenceMgr类型全局变量;
11.配置管理器的初始化,例如:

   Procedure TPreferenceForm.FormCreate(Sender: TObject);
   Begin
     // var M: TPreferenceMgr;
     M := TPreferenceMgr.Create;
     M.Parent := Self.RightPanel; //控制配置项目显示的位置
     M.Add(untFrame1.TFramePreferenceItem); //添加配置项目的类
   End;
12.配置管理器的销毁,例如;
   Procedure TPreferenceForm.FormDestroy(Sender: TObject);
   Begin
     M.Free;
     M := Nil;
   End;
13.调用TPreferenceMgr类型对象的各个方法实现所需功能,例如下面使用一个TreeView
   来控制;
   Procedure TPreferenceForm.StdBtnApplyAllClick(Sender: TObject);
   Begin
     M.ApplyAll;
   End;

   Procedure TPreferenceForm.StdBtnApplyCurrClick(Sender: TObject);
   Begin
     M.ApplyCurrent;
   End;

   Procedure TPreferenceForm.StdBtnCancelClick(Sender: TObject);
   Begin
     Self.Close; //关闭配置中心窗体
   End;

   Procedure TPreferenceForm.StdBtnDoneClick(Sender: TObject);
   Begin
     M.ApplyAll;
     Self.Close;
   End;

   Procedure TPreferenceForm.StdBtnRevertAllClick(Sender: TObject);
   Begin
     M.RevertAll;
   End;

   Procedure TPreferenceForm.StdBtnRevertCurrClick(Sender: TObject);
   Begin
     M.RevertCurrent;
   End;

   Procedure TPreferenceForm.WinTrvLeftMouseUp(Sender: TObject; Button: TMouseButton;
     Shift: TShiftState; X, Y: Integer);
   Begin
     M.Open(WinTrvLeft.Selected.AbsoluteIndex); //根据序号打开对应配置项目
     M.SetAsCurrent(WinTrvLeft.Selected.AbsoluteIndex); //激活显示在界面上
   End;


Downloads:
PreferenceManager 1.3 源码与示例下载 (3256 times)

Page hits: 8582 times
From: CnPack Open Source Projects

Previous | UpNext

Links:

(C)Copyright 2001-2024 CnPack Develop Team  Site author: JingYu Zhou