# 8.4 輸入對話框
這一類對話框讓用戶自己輸入信息,包括:wxNumberEntryDialog, wxTextEntryDialog, wxPasswordEntryDialog和 wxFindReplaceDialog.
wxNumberEntryDialog
wxNumberEntryDialog提示用戶輸入一個固定范圍內的數字,這個對話框包含一個spin控件因此,用戶既可以手動輸入數字,也可以通過鼠標點擊spin按鈕來調整數字的值,這個對話框是wxWidgets自己實現的,因此在各個平臺上的表現都是相似的.
創建wxNumberEntryDialog需要提供的參數包括一個父窗口,消息文本,提示文本(顯示在spin控件的前面),標題文本,默認值,最小值和最大值,位置等,然后調用ShowDialog函數,如果返回wxID_OK,則可以調用GetValue函數返回用戶輸入的數字的值.
下圖演示了其在windows平臺上的樣子:
wxNumberEntryDialog使用舉例
上圖中的對話框是用下面的代碼創建的:
```
#include "wx/numdlg.h"
wxNumberEntryDialog dialog(parent,
wxT("This is some text, actually a lot of text\nEven two rows of text"),
wxT("Enter a number:"), wxT("Numeric input test"), 50, 0, 100);
if (dialog.ShowModal() == wxID_OK)
{
long value = dialog.GetValue();
}
```
wxTextEntryDialog和wxPasswordEntryDialog
wxTextEnTRyDialog和wxPasswordEntryDialog提供一個消息文本和一個單行文本框控件,以便用戶可以輸入文本,它們的功能很類似,只不過在wxPasswordEntryDialog中輸入的文本被以掩碼的方式顯示,因此是不能直接看到的. 下圖演示了wxTextEntryDialog對話框在windows平臺上的例子:
創建這兩個對話框需要提供的參數包括父窗口指針,消息文本,標題文本,默認文本和一個類型參數.類型參數是一個比特位列表,其值為 wxOK, wxCANCEL,wxCENTRE(或者wxCENTER)等,你還可以傳遞wxTextCtrl的窗口類型wxTE_CENTRE(或 wxTE_CENTER)等.
你可以使用SetValue函數單獨設置其默認文本,還可以使用GetValue函數獲取用戶輸入的文本.
wxTextEntryDialog使用舉例
上圖演示的對話框是用下面的代碼創建的:
```
#include "wx/textdlg.h"
wxTextEntryDialog dialog(this,
wxT("This is a small sample\n")
wxT("A long, long string to test out the text entrybox"),
wxT("Please enter a string"),
wxT("Default value"),
wxOK | wxCANCEL);
if (dialog.ShowModal() == wxID_OK)
wxMessageBox(dialog.GetValue(), wxT("Got string"));
```
wxFindReplaceDialog
wxFindReplaceDialog是一個非模式對話框,它允許用戶用來輸入用于搜索的文本以及(如果需要的話)用來替換的文本.實際的搜索動作需要在其派生類或者其父窗口作為這個對話框某個按鈕時間的響應來完成.和大多數標準對話框不同,這種對話框必須擁有一個父窗口(非空),并且這個對話框必須是非模式顯示的,無論是基于設計還是實現來說.
下圖演示了windows系統上的查找和替換對話框:
在其它平臺(比如GTK+或Mac OS X)上, wxWidgets使用自己實現的通用版對話框,如下圖所示:
處理這個對話框相關的事件
wxFindReplaceDialog對話框在用戶點擊其上的按鈕的時候產生一些命令事件.事件處理函數采用wxFindDialogEvent類型的參數,事件映射宏中的窗口標識符為這個對話框的標識符,這些宏如下表所示:
| EVT_FIND(id, func) | 當"查找"按鈕被按下時產生. |
|:--- |:--- |
| EVT_FIND_NEXT(id, func) | 當"下一個"按鈕被按下時產生. |
| EVT_FIND_REPLACE(id, func) | 當"替換"按鈕被按下時產生. |
| EVT_FIND_REPLACE_ALL(id, func) | 當"替換全部"按鈕被按下時產生. |
| EVT_FIND_CLOSE(id, func) | 當用戶通過取消或者別的途徑關閉對話框的時候產生. |
wxFindDialogEvent的成員函數
GetFlags返回下列值的一組比特位列表:wxFR_DOWN, wxFR_WHOLEWORD和wxFR_MATCHCASE.
GetFindString返回用戶輸入的要查找的文本.
GetreplaceString返回用戶輸入的要替換的文本.
Getdialog返回一個指向產生這個事件的對話框的指針.
向對話框傳遞數據
創建wxFindReplaceDialog需要傳遞的參數包括一個父窗口,一個指向wxFindReplaceData的指針,標題文本和一個類型,類型是下表所示比特值的列表:
| wxFR_REPLACEDIALOG | 指定對話框是查找替換對話框,而不是查找對話框. |
|:--- |:--- |
| wxFR_NOUPDOWN | 只是查找方向不允許被改變. |
| wxFR_NOMATCHCASE | 支持僅允許大小敏感的搜索或替換. |
| wxFR_NOWHOLEWORD | 指定不支持整字搜索的選項. |
wxFindReplaceData保存了所有wxFindReplaceDialog相關的信息.用來對 wxFindReplaceDialog對象進行初始化的動作以及用來在wxFindReplaceDialog對話框關閉以后保存其相關的信息,它的值也會在每次產生wxFindDialogEvent事件的時候自動更新,因此你可以直接使用它的成員函數來代替使用wxFindDialogEvent事件的成員函數.使用對話框的GetData函數可以返回在構造對話框的時候填充的wxFindReplaceData對象指針.
wxFindReplaceData的成員函數
下面列出了wxFindReplaceData的用來設置或者獲取相關數據的函數,注意那些用于設置的函數只在這個對話框顯示之前有用,在對話框顯示以后,調用這些用于設置的函數是沒有任何效果的.
GetFindString和SetFindString用來設置或者獲取要查找的字符串.
GetFlags和SetFlags用來設置或者獲取查找替換對話框選項的相應狀態(前面已經有具體描述).
GetreplaceString和SetReplaceString用來設置或者獲取要替換成的字符串.
查找和替換使用舉例
下面演示了查找和替換對話框的使用方法,其中DoFind和DoReplace函數的代碼沒有列出來,它們用來進行應用程序相關的查找和替換動作.同時,這些函數還應該維護一組應用程序相關的變量,用來保存當前查找的位置,以便下次查找在這之后進行,這些函數還應該完成文檔視圖相匹配部分的高亮顯示.
```
#include "wx/fdrepdlg.h"
BEGIN_EVENT_TABLE(MyFrame, wxFrame)
EVT_MENU(ID_REPLACE, MyFrame::ShowReplaceDialog)
EVT_FIND(wxID_ANY, MyFrame::OnFind)
EVT_FIND_NEXT(wxID_ANY, MyFrame::OnFind)
EVT_FIND_REPLACE(wxID_ANY, MyFrame::OnReplace)
EVT_FIND_REPLACE_ALL(wxID_ANY, MyFrame::OnReplaceAll)
EVT_FIND_CLOSE(wxID_ANY, MyFrame::OnFindClose)
END_EVENT_TABLE()
void MyFrame::ShowReplaceDialog( wxCommandEvent& event )
{
if ( m_dlgReplace )
{
delete m_dlgReplace;
m_dlgReplace = NULL;
}
else
{
m_dlgReplace = new wxFindReplaceDialog
(
this,
&m_findData,
wxT("Find and replace dialog"),
wxFR_REPLACEDIALOG
);
m_dlgReplace->Show(true);
}
}
void MyFrame::OnFind(wxFindDialogEvent& event)
{
if (!DoFind(event.GetFindString(), event.GetFlags()))
{
wxMessageBox(wxT("No more matches."));
}
}
void MyFrame::OnReplace(wxFindDialogEvent& event)
{
if (!DoReplace(event.GetFindString(), event.GetReplaceString(),
event.GetFlags(), REPLACE_THIS))
{
wxMessageBox(wxT("No more matches."));
}
}
void MyFrame::OnReplaceAll(wxFindDialogEvent& event)
{
if (DoReplace(event.GetFindString(), event.GetReplaceString(),
event.GetFlags(), REPLACE_ALL))
{
wxMessageBox(wxT("Replacements made."));
}
else
{
wxMessageBox(wxT("No replacements made."));
}
}
void MyFrame::OnFindClose(wxFindDialogEvent& event)
{
m_dlgReplace->Destroy();
m_dlgReplace = NULL;
}
```
- 第一章 介紹
- 1.1 為什么要使用wxWidgets?
- 1.2 wxWidgets的歷史
- 1.3 wxWidgets社區
- 1.4 wxWidgets和面向對象編程
- 1.5 wxWidgets的體系結構
- 1.6 許可協議
- 第一章小結
- 第二章 開始使用
- 2.1 一個小例子
- 2.2 應用程序類
- 2.3 Frame窗口類
- 2.4 事件處理函數
- 2.5 Frame窗口的構造函數
- 2.6 完整的例子
- 2.7 wxWidgets程序一般執行過程
- 2.8 編譯和運行程序
- 第二章小結
- 第三章 事件處理
- 3.1 事件驅動編程
- 3.2 事件表和事件處理過程
- 3.3 過濾某個事件
- 3.4 掛載事件表
- 3.5 動態事件處理方法
- 3.6 窗口標識符
- 3.7 自定義事件
- 第三章小結
- 第四章 窗口的基礎知識
- 4.1 窗口解析
- 4.2 窗口類概覽
- 4.3 基礎窗口類
- 4.4 頂層窗口
- 4.5 容器窗口
- 4.6 非靜態控件
- 4.7 靜態控件
- 4.8 菜單
- 4.9 控制條
- 第四章小結
- 第五章繪畫和打印
- 5.1 理解設備上下文
- 5.2 繪畫工具
- 5.3 設備上下文中的繪畫函數
- 5.4 使用打印框架
- 5.5 使用wxGLCanvas繪制三維圖形
- 第五章小節
- 第六章處理用戶輸入
- 6.1 鼠標輸入
- 6.2 處理鍵盤事件
- 6.3 處理游戲手柄事件
- 第六章小結
- 第七章使用布局控件進行窗口布局
- 7.1 窗口布局基礎
- 7.2 窗口布局控件
- 7.3 使用布局控件進行編程
- 7.4 更多關于布局的話題
- 第七章小結
- 第八章使用標準對話框
- 8.1信息對話框
- 8.2 文件和目錄對話框
- 8.3 選擇和選項對話框
- 8.4 輸入對話框
- 8.5 打印對話框
- 第八章小結
- 第九章創建定制的對話框
- 9.1 創建定制對話框的步驟
- 9.2 一個例子:PersonalRecordDialog
- 9.3 在小型設備上調整你的對話框
- 9.4 一些更深入的話題
- 9.5 使用wxWidgets資源文件
- 第九章小結
- 第十章使用圖像編程
- 10.1 wxWidgets中圖片相關的類
- 10.2 使用wxBitmap編程
- 10.3 使用wxIcon編程
- 10.4 使用wxCursor編程
- 10.5 使用wxImage編程
- 10.6 圖片列表和圖標集
- 10.7 自定義wxWidgets提供的小圖片
- 第十章小結
- 第十一章剪貼板和拖放操作
- 11.1 數據對象
- 11.2 使用剪貼板
- 11.3 實現拖放操作
- 第十一章小結
- 第十二章高級窗口控件
- 12.1 wxTreeCtrl
- 12.2 wxListCtrl
- 12.3 wxWizard
- 12.4 wxHtmlWindow
- 12.5 wxGrid
- 12.6 wxTaskBarIcon
- 12.7 編寫自定義的控件
- 第十二章小結
- 第十三章數據結構類
- 13.1 為什么沒有使用STL?
- 13.2 字符串類型
- 13.3 wxArray
- 13.4 wxList和wxNode
- 13.5 wxHashMap
- 13.6 存儲和使用日期和時間
- 13.7 其它常用的數據類型
- 第十三章小結
- 第十四章文件和流操作
- 14.1 文件類和函數
- 14.2 流操作相關類
- 第十四章小結
- 第十五章內存管理,調試和錯誤處理
- 15.1 內存管理基礎
- 15.2 檢測內存泄漏和其它錯誤
- 15.3 構建自防御的程序
- 15.4 錯誤報告
- 15.5 提供運行期類型信息
- 15.6 使用wxModule
- 15.7 加載動態鏈接庫
- 15.8 異常處理
- 15.9 調試提示
- 第十五章小結
- 第十六章編寫國際化程序
- 16.1 國際化介紹
- 16.2 從翻譯說起
- 16.3 字符編碼和Unicode
- 16.4 數字和日期
- 16.5 其它媒介
- 16.6 一個小例子
- 第十六章小結
- 第十七章編寫多線程程序
- 17.1 什么時候使用多線程,什么時候不要使用
- 17.2 使用wxThread
- 17.3 用于線程同步的對象
- 17.4 多線程的替代方案
- 第十七章小結
- 第十八章使用wxSocket編程
- 18.1 Socket類和功能概覽
- 18.2 Socket及其基本處理介紹
- 18.3 Socket標記
- 18.4 使用Socket流
- 18.5 替代wxSocket
- 第十八章小結
- 第十九章使用文檔/視圖框架
- 19.1 文檔/視圖基礎
- 19.2 文檔/視圖框架的其它能力
- 19.3 實現Undo/Redo的策略
- 第十九章小結
- 第二十章完善你的應用程序
- 20.1 單個實例和多個實例
- 20.2 更改事件處理機制
- 20.3 降低閃爍
- 20.4 實現聯機幫助
- 20.5 解析命令行參數
- 20.6 存儲應用程序資源
- 20.7 調用別的應用程序
- 20.8 管理應用程序設置
- 20.9 應用程序安裝
- 20.10 遵循用戶界面設計規范
- 20.11 全書小結