# 4.9 控制條 控制條提供了一個比較直觀而方便的方法來排列多個控件。目前有三種類型的控制條，分別是：菜單條，工具條和狀態條，其中菜單條只能在frame窗口上使用，工具條和狀態條通常也是在frame窗口上使用，不過它們也可以作為別的窗口的子窗口。 wxMenuBar 菜單條包含一系列的菜單，顯示在frame窗口頂部標題欄的下方。你可以通過調用SetMenuBar函數覆蓋frame窗口當前的菜單條，使用下面的代碼創建一個菜單條： ``` wxMenuBar* menuBar = new wxMenuBar; wxMenu* fileMenu = new wxMenu; fileMenu->Append(wxID_OPEN, wxT("&Open..."), wxT("Opens a file")); fileMenu->AppendSeparator(); fileMenu->Append(wxID_EXIT, wxT("E&xit"), wxT("Quits the program")); menuBar->Append(fileMenu); frame->SetMenuBar(menuBar, wxT("&File")); ``` 上述代碼創建了一個只有一個菜單的菜單條，如下圖所示：  你可以給菜單增加子菜單，也可以在菜單上增加單選框和復選框，還可以給菜單項增加快捷鍵和加速鍵（請參考本章前一章節的內容）。 如果你提供了一個幫助字符創，那么默認的EVT_MENU_HIGHLIGHT函數會將其顯示到frame的窗口的狀態欄上（如果有的話）。 wxMenuBar的窗口類型 wxMenuBar擁有一個wxMB_DOCKABLE類型，在GTK+平臺上允許菜單條從主窗口分離出來。 wxMenuBar事件 參考本章前一小節中的相關內容。 wxMenuBar成員函數 Append函數在菜單條的末尾增加一個菜單項，一旦菜單項被成功增加，那么它將被菜單條管理并且在合適的時候被釋放。這個函數參數為要增加的菜單以及一個標簽。Insert函數則在給定的位置插入一個菜單。 Enable函數允許或者禁止給定標識符的菜單項. 使用IsEnabled函數判斷菜單項是否被允許. Check函數選中或者去選中一個復選框或者單選框菜單項. 使用IsChecked函數來獲得當前的選擇狀態。 EnableTop函數允許或者禁止一整個菜單。參數為基于0的菜單索引。 FindMenu使用給定的標簽字符串查找某個菜單，其中參數字符串可以帶有前導字符也可以不帶有前導字符.如果找不到則返回wxNOT_FOUND. FindMenuItem通過菜單名和菜單項返回菜單項的索引。 FindItem通過給定的菜單項標識符返回wxMenuItem類型的菜單項，如果這個菜單項是一個子菜單，那么第二個參數將會返回這個子菜單的指針。 GetHelpString和SetHelpString用來獲取或者設置某個菜單項的幫助信息。 GetLabel和SetLabel用來設置某個菜單項的標簽， GetLabelTop和 SetLabelTop用來獲取和設置某個菜單在菜單條上的標簽，參數為基于0的索引。 GetMenu根據索引返回對應菜單指針， GetMenuCount返回菜單條上所有菜單的個數， Refresh重畫菜單條。 Remove移除一個菜單項并且返回對應的菜單指針，然后用戶應該自己釋放這個已經移除的菜單。 Replace函數則將某個位置的菜單使用新的菜單代替并且返回老的菜單的指針。 用戶應該自己釋放這個老的菜單， wxToolBar 工具條用來放置各種按鈕和控件。工具條可以是水平的也可以是垂直的，其上的按鈕可以是單選，復選以及push按鈕。這些按鈕可以顯示標簽也可以顯示圖片。如果你使用wxFrame::CreateToolBar函數創建工具條，或者使用wxFrame::SetToolBar函數將你創建的工具條和 frame窗口綁定，那么frame窗口將會管理這個工具條的位置和大小以及釋放，并且工具條的大小也不算作frame的客戶區大小。。任何其它方法創建的工具條，你都需要自己使用布局控件或者其它方法來來負責這個工具條的位置和大小， 下面是創建工具條以及和frame窗口綁定的例子代碼： ``` #include "wx/toolbar.h" #include "open.xpm" #include "save.xpm" wxToolBar* toolBar = new wxToolBar(frame, wxID_ANY, wxDefaultPosition, wxDefaultSize, wxTB_HORIZONTAL|wxNO_BORDER); wxBitmap bmpOpen(open_xpm); wxBitmap bmpSave(save_xpm); toolBar->AddTool(wxID_OPEN, bmpOpen, wxT("Open")); toolBar->AddTool(wxID_SAVE, bmpSave, wxT("Save")); toolBar->AddSeparator(); wxComboBox* comboBox = new wxComboBox(toolBar, ID_COMBOBOX); toolBar->AddControl(comboBox); toolBar->Realize(); frame->SetToolBar(toolBar); ``` 在windows平臺上的外觀如下圖所示：  注意調用Realize之前，所有位于其上的按鈕和控件應該已經被增加到了工具條中，否則工具條上將什么也不會顯示。 你可以查看wxWidgets的samples/toolbar中的例子，來了解怎樣更改工具條的方向，增加顯示按鈕上的標簽以及更改按鈕的大小等等其它方面的內容。 Windows平臺上工具按鈕上的圖片的顏色 在windows平臺上，wxWidgets試圖將工具按鈕上的圖片的顏色映射到當前桌面風格下的標準顏色。通常來說，亮灰色（light gray）用來表示透明顏色。下表列出了所有這些顏色。事實上，工具按鈕上的圖片的顏色只需要接近于標準顏色。接近意味著RGB三原色的值和標準顏色的值差別在10個單位范圍內。 | 顏色值 | 顏色名 | 用于 | |:--- |:--- |:--- | | wxColour(0, 0, 0) | 黑色 | 深色陰影 | | wxColour(128, 128, 128) | 深灰 | 亮物體的3維邊緣的陰面 | | wxColour(192, 192, 192) | 亮灰 | 3維物體的表面(按鈕背景), 表示透明區域 | | wxColour(255, 255, 255) | 白色 | 亮物體的3維邊緣的高亮面 | 對于16色的圖片來說，這中映射是沒有問題的，但是如果你使用的是顏色更豐富的按鈕圖片甚至真彩圖片，那么這種映射可能會讓你的按鈕上的圖片變的非常丑陋，在這種情況下，你可以使用下面的代碼禁止這種映射： ``` wxSystemOptions::SetOption(wxT("msw.remap"), 0); ``` 要使用上面的代碼，你需要包含"wx/sysopt.h"頭文件。 wxToolBar的窗口類型 | wxTB_HORIZONTAL | 創建水平工具條. | |:--- |:--- | | wxTB_VERTICAL | 創建垂直工具條. | | wxTB_FLAT | 給工具條一個浮動外觀. Windows and GTK+ only. | | wxTB_DOCKABLE | 使得工具條可以支持浮動和放置. GTK+ only. | | wxTB_TEXT | 顯示按鈕上的標簽;默認情況下只顯示圖標. | | wxTB_NOICONS | 不顯示按鈕上的圖標;默認情況下是顯示的. | | wxTB_NODIVIDER | 指示工具條上沒有分割線. Windows only. | | wxTB_HORZ_LAYOUT | 指示文本顯示在圖片的旁邊而不是下面. 僅適用于Windows和GTK+. 這個類型必須和wxTB_TEXT共同使用. | | wxTB_HORZ_TEXT | 是wxTB_HORZ_LAYOUT和wxTB_TEXT的組合. | wxToolBar的事件 工具條事件映射宏如下表所示。象前面說過的那樣，工具條的事件宏和菜單的事件宏是完全一樣的，你既可以使用EVT_MENU宏，也可以使用EVT_TOOL宏。它們的事件處理函數的參數類型都是wxCommandEvent。對于它們中的大多數來說，窗口標識符指的都是工具按鈕的窗口標識符，只有EVT_TOOL_ENTER事件宏的窗口標識符指的是工具條的窗口標識符，而對應的工具按鈕的窗口標識符要從wxCommandEvent事件中獲取，這是因為在表示鼠標離開一個工具按鈕的時候，窗口標識符可能為-1,而在wxWidgets的事件體系中是不允許標識符為-1的。 | EVT_TOOL(id, func) | 用于處理wxEVT_COMMAND_TOOL_CLICKED事件 (和wxEVT_COMMAND_MENU_SELECTED的值相同), 在用戶點擊工具按鈕的時候產生. 在宏中使用工具按鈕的標識符. | |:--- |:--- | | EVT_TOOL_RANGE(id1, id2, func) | 用于處理一組工具按鈕標識符的wxEVT_COMMAND_TOOL_CLICKED事件. | | EVT_TOOL_RCLICKED(id, func) | 用于處理wxEVT_COMMAND_TOOL_RCLICKED事件,用戶在工具按鈕上點擊右鍵的時候產生.使用工具按鈕的窗口標識符. | | EVT_TOOL_RCLICKED_RANGE (id1, id2, func) | 用于處理一組工具按鈕標識符的wxEVT_COMMAND_TOOL_RCLICKED事件. | | EVT_TOOL_ENTER(id, func) | 用于處理wxEVT_COMMAND_TOOL_ENTER事件, 用戶的鼠標移入或者移出某個工具按鈕的額時候產生，宏中使用工具條的窗口標識符，使用wxCommandEvent::GetSelection函數來獲得移入的工具按鈕的標識符，如果是移出則這個值是-1 | wxToolBar的成員函數 AddTool增加一個工具按鈕:指定按鈕的標識符,一個可選的標簽,一個圖片,一個幫助信息,以及按鈕的類型(wxITEM_NORMAL, wxITEM_CHECK, 或者wxITEM_RADIO). 使用InsertTool在某個特定的位置插入一個工具按鈕. 也可以使用AddCheckTool和AddRadioTool來避免指定wxITEM_CHECK或wxITEM_RADIO類型. AddSeparator 增加一個分割線,基于實現的不同，它可能顯示為一條線或者一段空白. 使用InsertSeparator在某個特定的位置插入一個分割線,例如下面的代碼將增加一個復選框工具按鈕，它包含一個標簽("Save"), 一個圖片，一個幫助字符串 ("Toggle button 1"): ``` toolBar->AddTool(wxID_SAVE, wxT("Save"), bitmap, wxT("Toggle button 1"), wxITEM_CHECK); ``` AddControl增加一個控件，比如combo框. InsertControl在某個位置插入一個控件， DeleteTool刪除給定標識符的工具按鈕. DeleteToolByPos刪除指定位置的按鈕. RemoveTool移除給定位置的那個按鈕但是并不釋放它，而是將它的指針返回給. EnableTool用來允許或者禁止某個工具按鈕,你可能想參考第9章中的方法，使用用戶界面更新事件來更合理的作這個動作。 GetToolEnabled函數返回某個工具按鈕的當前可用狀態。 FindById和FindControl來通過窗口標識符尋找某個按鈕或者某個控件。 如果你想使用非默認大小16x15的圖標。你可以使用SetToolBitmapSize函數. 使用GetToolBitmapSize函數獲得當前設置的圖片尺寸. GetToolSize返回當前工具按鈕整個的大小。 GetMargins和SetMargins用來獲取和設置工具條的左右和上下的邊界。 GetToolClientData和SetToolClientData通過窗口標識符獲取和設置工具按鈕綁定的某個繼承自wxObject的類. GetToolLongHelp和SetToolLongHelp用來獲取或者設置和工具按鈕綁定的長的幫助信息。這個信息可以被顯示在狀態條或者別的什么位置。GetToolShortHelp則用來獲取或者設置工具按鈕的短的幫助信息。 GetToolPacking 和 SetToolPacking用來獲取和設置兩排工具按鈕之間的間隔。如果是垂直工具條，則為水平工具按鈕之間的間隔，如果為水平工具條，則為垂直工具按鈕之間的間隔。 GetToolPosition返回某個由窗口標識符指定的工具按鈕在工具條上的位置。 GetToolSeparation和 SetToolSeparation用來獲取或者設置工具條上分割線的大小。 GetToolState和SetToolState用來獲取或者設置某個單選框或者復選框的狀態。 Realize必須在任何按鈕被增加以后調用。 ToggleTool反選某個單選或者復選按鈕的狀態。 wxStatusBar 狀態條是一個狹長的窗口，這個窗口通常被放置在一個Frame窗口的底部，用來提供一些狀態信息。狀態條可以包含一個或多個區域，區域可以擁有固定的或者可變的寬度。如果你使用wxFrame::CreateStatusBar或者wxFrame::SetStatusBar創建或者將某個狀態條和frame窗口綁定，那么這個狀態條的大小，位置以及其釋放都由這個frame窗口負責，并且這個狀態條的大小也不包含在frame窗口的客戶區域內，反之，任何其它的方式創建的狀態條，這些事情都要由你自己的代碼去做。 下面是創建一個狀態條的例子代碼，這個狀態條有三個區域，前兩個的大小固定是60象素，第三個將使用剩余的區域： ``` #include "wx/statusbr.h" wxStatusBar* statusBar = new wxStatusBar(frame, wxID_ANY, wxST_SIZEGRIP); frame->SetStatusBar(statusBar); int widths[] = { 60, 60, -1 }; statusBar->SetFieldWidths(WXSIZEOF(widths), widths); statusBar->SetStatusText(wxT("Ready"), 0); ``` 這段代碼產生的結果如下圖所示：  如果你想，你甚至可以在狀態條的區域里面放置一些小的控件。這需要你自己管理它們的尺寸和大小，例如在你繼承自wxStatusBar的新類的size事件的處理函數中。 wxStatusBar的窗口類型,注意你可以使用SetStatusStyles函數設置某個區域的類型 |:--- |:--- | | wxST_SIZEGRIP | 在狀態條的右邊顯示一個小的修飾. | wxStatusBar的事件 沒有特別的事件。 wxStatusBar的成員函數 GetFieldRect返回某個區域的內部的大小和位置. GetFieldsCount返回當前區域的個數. SetFieldsCount用來設置區域的個數。 GetStatusText返回當前某個區域的文本, SetStatusText用來設置某個區域的文本. PushStatusText保存當前的區域的文本到一個堆棧中，并且把參數的字符串顯示在狀態條上. PopStatusText則將堆棧中最頂層的字符串顯示在狀態條上。 SetMinHeight設置狀態條最小的合理高度。 SetStatusWidths采用一個整數數組來設置各個區域的寬度。其中整數代表絕對值，而負數則代表比例，比如說，如果你希望創建一個有三個區域的狀態條，其中最右邊的區域固定為100個象素，左邊的兩個區域按照2/3和1/3的比例瓜分剩下的區域，則你應該使用一個包含-2,- 1,100三個整數的數組作為這個函數的參數。 SetStatusStyles使用區域個數和一組整數的類型數組來給各個區域設置不同的類型，這些整數的類型決定了區域的外觀。其中 wxSB_NORMAL用來顯示標準的擁有三維邊界的下沉區域，而wxSB_FLAT顯示一個沒有邊框的區域，而wxSB_RAISED則顯示一個鼓起的擁有三維邊框的區域。