Symbian对话框之表单Form

本文转自：http://www.devdiv.net/blog/space.php?uid=15450&do=blog&id=399

表单（Form）有的书籍也称之为表格，是S60平台提供的一种特殊的对话框，他的基类是CAknForm，从CAknDialog派生而来 的。
分为视图模式（也称查看模式）和编辑模式。
如果一个表格有查看模式的话，那么查看模式将是缺省模式，可以通过"选项"菜单中的“编 辑”切换到编辑模式，在编辑模式下“选项”菜单有四个缺省的项，见图:表单在编辑模式下缺省菜单项

由于表单也是对话框，故他的创建方式和对话框类似：
1 定义资源
DIALOG 在eikon.rh中定义

STRUCT DIALOG
    {
    LONG flags=0;
    LTEXT title="";
 LLINK pages=0;
    LLINK buttons=0;
    STRUCT items[];
 LLINK form=0;   //这个Form就是我们要用的
    }
例如：
RESOURCE DIALOG  r_my_dialog
 {
  flags=……;
  buttons=……;
  form=r_my_form;
 }

FORM在eikon.h中定义
STRUCT FORM
 {
 WORD flags=0 ;
 STRUCT items[] ;
 }
例如：
RESOURCE FORM r_my_form
{
flags = ……；
items =
{
GLG_LINE
{
……
}，
……
}
}
定义Form至少要为他的两个成员 赋值：flags和items
flags指明form的风格，如下，在eikon.hrh中
#define EEikFormShowEmptyFields     0   // default
#define EEikFormHideEmptyFields     1   //表示隐藏空白字段
#define EEikFormShowBitmaps         2    //表示在空白位置上显示图标
#define EEikFormEditModeOnly        4    //表示只有编辑模式
#define EEikFormUseDoubleSpacedFormat   8  //表示将标签和控件分成两行显示
items是一个对话框行 （DLG_LINE）的数组，它定义了每一个FORM字段DLG_LINE与Dialog中的定义相同。

       
2 表单中的数据操作
想要处理表单中的数据，必须定义表单类继承自CAknForm类，并实现相关函数。其中 最重要的函数有SaveFormDataL()和DONotFormDataL()
这两个函数调用EEikDialog的SetXXX和 GetXXX函数来实现保存和恢复数据，另，用ControlOrNull()函数来判断控件是否存在，如果存在的话返回控件的ID，否则，返回 NULL。
如果在表单中的数据修改之后，用户没有按保存，直接返回的话，CAknForm类会调用QuerySaveChangesL函数，该函 数显示一个提示对话框，询问用户是否保存数据，如果以后选择是，则调用SaveFormDataL函数，否则调用DoNotSaveDataL函数，用于 恢复上次保存的数据。
如果想要在退出的时候不提问用户要不要保存，直接保存用户的修改的话，可以重载CAknForm类的 QuerySaveChangesL方法，如下：
TBool CMyForm::QuerySaveChangesL() { SaveFormDataL(); return ETrue; }