Symbian 中各种提示、输入对话框的使用

Symbian 中各种提示、输入对话框的使用         

                  1、非阻塞提示框
                  symbian定义了几个提示类，分别是：
                  confirm类：CAknConfirmationNote
                  info类： CAknInformationNote
                  warning类：CAknWarningNote
                  error类： CAknErrorNote
                  头文件：aknnotewrappers.h
                  lib：avkon.lib eikcdlg.lib eikctl.lib
                  使用方法：
                  Code:
                  TBuf<32> buf;
                     buf.Copy(_L("info note"));
                     CAknInformationNote* iInfoNote = new (ELeave)
                  CAknInformationNote;
                     iInfoNote->ExecuteLD(buf);
                  2、阻塞提示框
                  void CEikonEnv::AlertWin(const TDesC& aMsg);
                  void CEikonEnv::AlertWin(const TDesC& aMsg1,const TDesC&
                  aMsg2);
                  static void CEikonEnv::InfoWinL(const TDesC& aFirstLine,const
                  TDesC& aSecondLine);
                  AlertWin为CEikonEnv类的非静态成员函数，InfoWinL为CEikonEnv类的静态成员函数。
                  AlertWin只能在ui、view和container中使用，使用方法如下：
                  Code:
                  iEikonEnv->AlertWin(_L("text"));
                  InfoWinL可以在任意类中使用，使用方法如下：
                  Code:
                  CEikonEnv::Static()->InfoWinL(_L("note:"), _L("text"));
                  为方便使用，常定义宏来使用这类提示框，如：
                  Code:
                  #define DEBUG_DIALOG(x) iEikonEnv->AlertWin(##x);
                  #define DEBUG_DIALOG1(x)
                  CEikonEnv::Static()->InfoWinL(_L("note:"), ##x);
                  #define DEBUG_DIALOG2(x,y) CEikonEnv::Static()->InfoWinL(##x,
                  ##y);

                  可以这么使用：
                  TBuf<32> buf;
                  buf.Copy(_L("test"));
                  DEBUG_DIALOG(buf);
                  DEBUG_DIALOG1(buf);
                  DEBUG_DIALOG2(buf,_L("text"));
                  此类提示框阻塞线程，只有用户按键退出提示框后，后面的程序才能接着运行。
                  3、进度条对话框
                  进度条对话框类为：
                  CAknProgressDialog
                  头文件：aknprogressdialog.h
                  lib： avkon.lib eikcdlg.lib eikctl.lib
                  使用方法：
                  Code:
                  //初始化进度条
                  CAknProgressDialog* iProgressDialog;
                  CEikProgressInfo* iProgressInfo;
                     iProgressDialog = new ( ELeave ) CAknProgressDialog(
                  reinterpret_cast
                                                                         
                  <CEikDialog**>
                                                                          (
                  &iProgressDialog ) );
                     iProgressDialog->SetCallback( this );
                     iProgressDialog->PrepareLC( R_RESOURCE_PROGRESS_NOTE );  
                  //从资源文件构造对话框，资源见下面的定义
                     iProgressInfo = iProgressDialog->GetProgressInfoL();
                     iProgressInfo->SetFinalValue( aMaxValue );  
                  //设置进度条的最大值（结束值）
                     iProgressDialog->RunLD();
                   
                     //更新进度条
                     iProgressInfo->IncrementAndDraw( aStep ); 
                  //结束进度条
                  iProgressDialog->ProcessFinishedL();
                  delete iProgressDialog;

                  RESOURCE DIALOG R_RESOURCE_PROGRESS_NOTE   //进度条对话框资源
                       {
                       flags = EAknProgressNoteFlags;
                       buttons = R_AVKON_SOFTKEYS_CANCEL;
                       items =
                           {
                           DLG_LINE
                               {
                               type = EAknCtNote;
                               id = EMagicBoxCtrlIdProgressNote;
                               control = AVKON_NOTE
                                   {
                                   layout = EProgressLayout;
                                   singular_label = "对话框中显示的文字";
                                   plural_label = "download";
                                   imagefile = AVKON_BMPFILE_NAME;    //第二版中
                  图标文件为 #define AVKON_BMPFILE_NAME "z://system//data//avkon.mbm"
                                   imageid = EMbmAvkonQgn_note_sml;  
                  //这两项可更改显示不同图标
                                   imagemask = EMbmAvkonQgn_note_sml_mask;
                                   };
                               }
                           };
                       }
                  4、等待对话框
                  等待对话框要用到的类：
                  CAknGlobalNote
                  头文件：aknglobalnote.h
                  lib：aknnotify.lib eiksrv.lib
                  使用方法：
                  Code:
                  //显示等待对话框
                     CAknGlobalNote* globalNote = CAknGlobalNote::NewL();
                     CleanupStack::PushL( globalNote );
                     TInt iWaitNoteId = globalNote->ShowNoteL(
                  EAknGlobalWaitNote, _L("对话框中显示的文字") );
                     CleanupStack::PopAndDestroy();
                   
                     //结束等待对话框
                     CAknGlobalNote * note = CAknGlobalNote::NewL();
                     CleanupStack::PushL( note );
                     note->CancelNoteL( iWaitNoteId );
                     CleanupStack::PopAndDestroy();
                  注：
                  CAknGlobalNote类除了显示等待对话框外还可显示多种类型的全局对话框，具体类型可通过ShowNoteL的第一个参数指定，可能的类型如下：

                  Code:
                  enum TAknGlobalNoteType
                  {
                  EAknGlobalInformationNote = 1,
                  EAknGlobalWarningNote,
                  EAknGlobalConfirmationNote,
                  EAknGlobalErrorNote,
                  EAknGlobalChargingNote,
                  EAknGlobalWaitNote,
                  EAknGlobalPermanentNote,
                  EAknGlobalNotChargingNote,
                  EAknGlobalBatteryFullNote,
                  EAknGlobalBatteryLowNote,
                  EAknGlobalRechargeBatteryNote,
                  EAknCancelGlobalNote,
                  EAknGlobalTextNote
                  };
                  5、询问对话框
                  询问对话框用到的类：
                  CAknQueryDialog
                  头文件：AknQueryDialog.h
                  lib：avkon.lib
                  使用方法：
                  Code:
                  CAknQueryDialog* dlg;
                  dlg = CAknQueryDialog::NewL( CAknQueryDialog::ENoTone );
                  dlg->PrepareLC( R_RESOURCE_QUERY_DIALOG );
                  //从资源文件构造对话框，资源见下面的定义
                  TInt ret = dlg->RunLD();   //若用户选择“是”，返回非0，选择“否”，则返回0
                  RESOURCE DIALOG R_RESOURCE_QUERY_DIALOG   //询问对话框资源
                       {
                       flags = EGeneralQueryFlags;
                       buttons = R_AVKON_SOFTKEYS_YES_NO;   //CBA显示“是”和“否”两个按钮
                       items =
                           {
                           DLG_LINE
                               {
                               type = EAknCtQuery;
                               id = EGeneralQuery;
                               control = AVKON_CONFIRMATION_QUERY   
                  //表示这是confirm询问对话框，用户选择“是”或“否”
                                   {
                                   layout = EConfirmationQueryLayout;
                                   label = "对话框中显示的文字";
                                   };
                               }
                           };
                       }
                  此类对话框可以有声音提示，由NewL的const TTone& aTone参数指定，可能的值如下：
                  Code:
                  enum TTone {
                       /// No tone is played
                       ENoTone = 0,       
                       /// A confirmation tone is played
                       EConfirmationTone = EAvkonSIDConfirmationTone,
                       /// A warning tone is played
                       EWarningTone = EAvkonSIDWarningTone,     
                       /// An error tone is played 
                       EErrorTone = EAvkonSIDErrorTone        
                       };
                  通过定义不同的询问对话框资源，可实现不同的询问对话框，如让用户输入文字的询问对话框资源定义如下：
                  Code:
                  RESOURCE DIALOG R_RESOURCE_DATA_QUERY
                     {
                     flags = EGeneralQueryFlags;
                     buttons = R_AVKON_SOFTKEYS_OK_CANCEL;   //CBA按钮显示“确定”和“取消”
                     items =
                         {
                         DLG_LINE
                             {
                             type = EAknCtQuery;
                             id = EGeneralQuery;
                             control = AVKON_DATA_QUERY  
                  //表示这是data询问对话框，需要用户输入内容
                                 {
                                 layout = EDataLayout;
                                 label = "提示内容";
                                 control = EDWIN
                                     {
                                     flags = EEikEdwinNoHorizScrolling |
                  EEikEdwinResizable;
                                     width = 30;
                                     lines = 2;
                                     maxlength = 159;
                                     };
                                 };
                             }
                         };
                     }   
                  使用方法：
                  Code:
                  TBuf<128> msg;
                  CAknTextQueryDialog* dlg = new (ELeave)
                  CAknTextQueryDialog(msg,CAknQueryDialog::ENoTone);
                     TInt ret = dlg->ExecuteLD(R_RESOURCE_DATA_QUERY);
                  用户输入内容后按“确定”，内容就存储到msg中，函数返回非0；按“取消”，函数返回0。
                  这里用到的类是CAknQueryDialog的子类CAknTextQueryDialog。
                  CAknQueryDialog的子类有：
                  Code:
                  CAknFloatingPointQueryDialog   //This class should be used
                  when user is reguest to enter a flotaing point number
                     CAknFixedPointQueryDialog      //...
                     CAknDurationQueryDialog        //This class should be used
                  when user is reguest to enter duration
                     CAknIpAddressQueryDialog       //This class should be used
                  when user is reguest to enter IP address,@since 2.1
                     CAknMultiLineDataQueryDialog   //Query Dialog with data
                  input on more than one line (2 lines at the moment)
                                    Create using NewL methods and passing
                  parameters as appropriate.
                                    Attention: When deriving from this class,
                  you must call SetDataL during
                                    second phase construction.
                     CAknMultiLineIpQueryDialog     //...
                     CAknNumberQueryDialog          //This class should be used
                  when user is reguest to enter number
                     CAknTextQueryDialog            //This class should be used
                  when user is reguest to enter plain text, secret text,
                  phonenumber or PIN-code
                  CAknTimeQueryDialog            //This class should be used
                  when user is reguest to enter time or date
                  使用不同的类，资源文件会有所不同。
                  另外，在资源中定义EDWIN时，可指定输入发，如：
                  Code:
                  control = EDWIN
                     {
                       flags = EEikEdwinNoHorizScrolling | EEikEdwinResizable;
                       width = 11;
                       lines = 1;
                       maxlength = 11;
                     avkon_flags = EAknEditorFlagFixedCase |
                           EAknEditorFlagNoT9 | EAknEditorFlagSupressShiftMenu; 
                   //EAknEditorFlagSupressShiftMenu屏蔽切换输入法键
                     allowed_input_modes = EAknEditorNumericInputMode;
                     default_input_mode = EAknEditorNumericInputMode;
                     numeric_keymap = EAknEditorPlainNumberModeKeymap;
                     };
                  以上写法表示默认输入法为数字，并且屏蔽了输入法切换键，即不能通过输入法切换键来切换输入法。
                  6、编辑框
                  编辑框使用的类：
                  CEikGlobalTextEditor
                  头文件：eikgted.h
                  使用方法：
                  Code:
                  CEikGlobalTextEditor* iGKeyEd;
                  TBuf<128> iKeyText;
                  TResourceReader reader;
                     iCoeEnv->CreateResourceReaderLC( reader, R_RESOURCE_EDITOR
                  );   //从资源文件构造编辑框，资源见下面的定义
                     iGKeyEd = new ( ELeave ) CEikGlobalTextEditor;
                     iGKeyEd->SetContainerWindowL( *this );
                     iGKeyEd->ConstructFromResourceL( reader );
                     CleanupStack::PopAndDestroy();   // Resource reader
                  //设置编辑框的初始文本和位置，编辑框大小在资源中定义
                  TBuf<32> buf;
                  buf.Copy(_L("demo"));
                  iGKeyEd->SetTextL(&buf);
                  iGKeyEd->SetExtent( TPoint(5,2), iGKeyEd->MinimumSize() );
                  iGKeyEd->SetFocus(ETrue);
                  // iGKeyEd->SetReadOnly(ETrue);   //设置编辑框为只读

                  //使文字居中
                     CParaFormat      paraFormat;
                     TParaFormatMask paraFormatMask;
                     paraFormatMask.SetAttrib( EAttAlignment );     // set mask
                     paraFormat.iHorizontalAlignment =
CParaFormat::ECenterAlign;
                     iGKeyEd->ApplyParaFormatL( &paraFormat, paraFormatMask );
                   
                     iGKeyEd->GetText(iKeyText); //获取编辑框中的内容，保存到iKeyText中
                  RESOURCE GTXTED R_RESOURCE_EDITOR   //编辑框资源 
                     {
                       flags = EAknEditorFlagDefault;
                       width = 53;
                       height = 16;
                       numlines = 1;
                       textlimit= 1;
                       fontcontrolflags = EGulFontControlAll;
                       fontnameflags = EGulNoSymbolFonts;
                  //这里也可设置输入法
                  //    avkon_flags = EAknEditorFlagFixedCase |
                                                     EAknEditorFlagNoT9 |
                  EAknEditorFlagSupressShiftMenu;  
                  //EAknEditorFlagSupressShiftMenu屏蔽切换输入法键
                  //     allowed_input_modes = EAknEditorNumericInputMode;
                  //     default_input_mode = EAknEditorNumericInputMode;
                  //     numeric_keymap = EAknEditorPlainNumberModeKeymap; 
                     }
                  注意，要使编辑框正常显示，记得更改container的CountComponentControls和ComponentControl函数，正确处理控件数目和编辑框指针。另外，要使编辑框能正常接收按键事件，要显示调用编辑框的OfferKeyEventL函数，如下：
                  Code:
                  TKeyResponse CMobileGuardSetKeyContainer::OfferKeyEventL(
                  const TKeyEvent& aKeyEvent, TEventCode aType )
                  {
                       return iGKeyEd->OfferKeyEventL( aKeyEvent, aType );
                  }