20.8 管理应用程序设置

大多数的应用程序都会给用户一些选项,以便用户自己决定一些应用程序的行为,比如是否显示每日提示,文本应用什么字体,或者是否显示启动画面等.而程序员需要作的决定是怎样保存和显示这些配置数据.关于怎样存储,通常我们需要使用wxConfig家族的类,这些类让你可以直接处理类型化的配置数据.至于如何显示,则是非常灵活的,我们将简短的介绍一些可能的选项.

保存配置数据

所有wxWidgets提供的用于处理配置数据的类都是wxConfigBase的派生类,因此你可以在这个基类的手册中找到相关的使用方法.而wxConfig则被定义为各个平台上推荐使用的用于处理配置数据的类:在windows平台,它被定义为wxRegConfig(这个类使用 windows的注册表),在所有别的平台上它被定义为wxFileConfig(它使用文本文件).另外还有wxIniConfig类,它使用一个 Windows 3.1风格的.ini配置文件,不过这个类很少被使用到.而wxFileConfig则可以支持各个平台.

wxConfig类提供了各种Read和Write函数的重载函数,用来直接读写各种数据类型,包括wxString, long, double和bool类型等. 配置文件中的每个项目都需要提供一个路径,这个路径由"/"分割并且最后必须是一个名称,比如"/General/UseTooltips".你可以使用 wxConfig::SetPath函数设置一个当前路径,这样的话,在后续的读写中,如果没有指定绝对路径(以"/"开头),所有的路径都被认为是相对于这个路径的路径. 使用路径的目的是为了对配置项进行分组.

wxConfig的构造函数需要使用应用程序名和供应商名称,这两个名称用来决定配置项的位置,比如:

#include "wx/config.h"
wxConfig config(wxT("MyApp"), wxT("Acme"));

wxRegConfig将会从应用程序名和供应商名称构造一个注册表项,比如前面的例子中将会导致注册表项 HKEY_CURRENT_USER/Software/Acme/MyApp被创建.而如果是Unix系统上的wxFileConfig类,配置文件默认被保存在文件~/.MyApp中. 而在Mac OSX上,则保存在/Library/Preferences/MyApp/Preferences中.这些缺省位置可以通过给wxConfig传递第三个参数来改变:

下面是一些wxConfig的用法:

// 读取
wxString str;
if (config.Read(wxT("General/DataPath"), & str))
{
    ...
}
bool useToolTips = false;
config.Read(wxT("General/ToolTips"), & useToolTips));
long usageCount = 0;
config.Read(wxT("General/Usage"), & usageCount));
// 写入
config.Write(wxT("General/DataPath"), str))
config.Write(wxT("General/ToolTips"), useToolTips));
config.Write(wxT("General/Usage"), usageCount));

其它一些可以使用的操作包括比例组和选项条目,查询某个组或者某个选项是否存在,删除一个条目或者一个组等.

你可以临时使用wxConfig来读取一些存放在某个地方的数据,你也可以创建一个wxConfig的实例并且在应用程序的整个生命周期维持它.wxWidgets也有一个称为默认wxConfig对象的机制,这个默认的对象可以通过wxConfig::Set函数设置.如果设置了这个默认对象,一些wxWidgets的内部实现将会使用这个对象,比如wxFontMapper类或者平台通用的wxFileDialog实现.

编辑选项

如果你只有很少的选项,那么普通的对话框也许就足够了.但是有时候,选项有很多,并且非常复杂,这时候,你可能需要很多对话框或者面板, 这种情况下最通常的作法是使用包含一个wxNotebook的模式对话框,这个对话框的底部应该有OK,Cancel或者Help按钮.其中Help按钮的处理函数将会查询当前正在显示的页面并显示一个相应的帮助文件主题.wxWidgets提供了一个叫做wxPropertySheetDialog的对话框来处理这种情形.wxWidgets自带的samples/dialogs例子中演示了它的使用方法.在Pocket PC上,这个对话框里的notebook控件将显示成屏幕底部标准的属性页面.

你也可以使用wxListbook和wxChoicebook来代替wxNotebook,它们是控制多页控件的又一个选择.尤其是 wxListbook,它的API和wxNotebook几乎相同,但是它使用wxListCtrl而不是TAB来控制页标签,因此你可以使用图标和标签来代替TAB按钮.这在你拥有很多页面的时候也很有用.尤其是在Mac OSX平台上,这个平台的wxNotebook控件不能够自己滚动标签按钮,因此标签按钮的数目受限于wxNotebook的宽度和标签的宽度.另外你也可以下载第三方的awxOutbarDialog控件,它实现了一个类似Outlook外观的那种多页控件,使用图标来在页面间切换.

你也可以创建自定义的分页管理对话框,比如你可以使用wxtreeCtrl控件,这可以让你的各个页面保持一种树状的继承关系.要实现这个自定义控件,你可以维护一组面板列表,每一个都绑定一个名字.当用户点击树状控件上的某个子项的时候,隐藏当前正在显示的面板,而显示树状控件子项对应的面板.另外一个方案是使用Jorgen Bodde制作的wxTreeMultiCtrl控件,这个控件实现了上面所介绍的内容,因此你可以以更直观的方法使用树状分页控件,而不比自己处理每个单独的页面.

你也可以考虑使用一个属性编辑框:这是一个拥有一系列子项,每个子项左边拥有一个文本标签,右边拥有一个编辑框.这个控件的好处在于增加和删除设置是非常容易的,并且不影响界面的布局.不好的地方在于,如果你要编辑多行文本或者编辑一个列表就比较困难,尽管你可以拦截子项的双击事件,使用定制的对话框来显示其内容. 你可以实现自己的属性编辑框,或者你可以考虑使用wxGrid.,或者使用第三方的属性编辑控件比如Jaakko Salli的wxPropertyGrid.有些应用程序混合使用了对话框和属性列表,比如DialogBlocks设置对话框的配置页面.

你最好不要使用带有滚动条的面板或者对话框来避免配置项控件超出范围之外,因为这会是人感觉迷惑并且也是很丑陋的.

你应该考虑将你应用程序的所有设置保存在一个统一的类中,并且为这个类实现一个拷贝构造函数,一个等于操作以及一个赋值操作.通过这种方法,你可以很容易的创建一个所有配置项的副本,将其传递给你的配置对话框,并且仅仅在用户点击了配置对话框上的OK按钮的时候,才将修改的数据保存回你的全局配置中.

如果你没有单独的保存各个配置项,你需要给你的用户提供一种直接修改配置的方法.参考光盘中的 examples/chap20/valconfig例子.其中包含了一个类wxConfigValidator,这个类可以用来作为普通控件的验证器, 它的参数包括配置项路径,配置项类型以及一个指向wxConfig对象的指针.其中值类型可以是wxVAL_BOOL, wxVAL_STRING或者wxVAL_LONG.如下所示:

void MyDialog::SetValidators(wxConfig* config)
{
    FindWindow( ID_LOAD_LAST_DOCUMENT )->SetValidator(
        wxConfigValidator(wxT("LoadLastDoc"), wxVAL_BOOL, config));
    FindWindow( ID_LAST_DOCUMENT )->SetValidator(
        wxConfigValidator(wxT("LastDoc"), wxVAL_STRING, config));
    FindWindow( ID_MAX_DOCUMENTS)->SetValidator(
        wxConfigValidator(wxT("MaxDocs"), wxVAL_LONG, config));
}

第9章中介绍了更多关于验证器的知识.本节提到的那些第三方控件可以在附录E,"wxWidgets的三方控件"中找到.