按鈕 (Windows 控制項)
本節包含與按鈕控件搭配使用之程式設計專案的相關信息。 按鈕是使用者可以按兩下的控制件，以提供應用程式的輸入。
概觀
| 主題 | 目錄 |
|---|---|
| 按鈕訊息 | 本主題討論與按鈕搭配使用的訊息。 |
| 按鈕狀態 | 本節討論如何選取按鈕變更其狀態，以及應用程式應該如何回應。 |
| 按鈕類型 | 本主題討論不同類型的按鈕。 |
| 使用按鈕 | 本節說明如何執行與按鈕相關聯的特定工作。 |
函式
| 主題 | 目錄 |
|---|---|
| CheckDlgButton | 變更按鈕控制件的檢查狀態。 |
| CheckRadioButton | 將複選標記新增至 （checks） 群組中指定的單選按鈕，並移除群組中所有其他單選按鈕的複選標記。 |
| IsDlgButtonChecked | IsDlgButtonChecked 函式會判斷是否已檢查按鈕控件，或是否檢查三狀態按鈕控件、未核取或不確定。 |
巨集
| 主題 | 目錄 |
|---|---|
| Button_Enable | 啟用或停用按鈕。 |
| Button_GetCheck | 取得單選按鈕或複選框的核取狀態。 您可以使用這個宏，或明確傳送 BM_GETCHECK 訊息。 |
| Button_GetIdealSize | 如果影像清單存在，取得最符合文字和影像的按鈕大小。 您可以使用這個宏，或明確傳送 BCM_GETIDEALSIZE 訊息。 |
| Button_GetImageList | 取得描述按鈕控制項所設定影像清單的BUTTON_IMAGELIST結構。 您可以使用這個宏，或明確傳送 BCM_GETIMAGELIST 訊息。 |
| Button_GetNote | 取得與命令連結按鈕相關聯的附註文字。 您可以使用這個宏，或明確傳送 BCM_GETNOTE 訊息。 |
| Button_GetNoteLength | 取得可顯示在命令連結描述中的記事文字長度。 使用此宏或明確傳送 BCM_GETNOTELENGTH 訊息。 |
| Button_GetSplitInfo | 取得指定之分割按鈕控制件的資訊。 使用此宏或明確傳送 BCM_GETSPLITINFO 訊息。 |
| Button_GetState | 取得單選按鈕或複選框的核取狀態。 您可以使用這個宏，或明確傳送 BM_GETSTATE 訊息。 |
| Button_GetText | 取得按鈕的文字。 |
| Button_GetTextLength | 取得按鈕文字中的字元數。 |
| Button_GetTextMargin | 取得用來在按鈕控件中繪製文字的邊界。 您可以使用這個宏，或明確傳送 BCM_GETTEXTMARGIN 訊息。 |
| Button_SetCheck | 設定單選按鈕或複選框的核取狀態。 您可以使用這個宏，或明確傳送 BM_SETCHECK 訊息。 |
| Button_SetDropDownState | 設定具有BS_SPLITBUTTON樣式之指定按鈕的下拉式狀態。 使用此宏或明確傳送 BCM_SETDROPDOWNSTATE 訊息。 |
| Button_SetElevationRequiredState | 設定指定按鈕或命令連結的提高許可權必要狀態，以顯示提升許可權的圖示。 使用此宏或明確傳送 BCM_SETSHIELD 訊息。 |
| Button_SetImageList | 將影像清單指派給按鈕控制件。 您可以使用這個宏，或明確傳送 BCM_SETIMAGELIST 訊息。 |
| Button_SetNote | 設定與指定命令連結按鈕相關聯的附註文字。 您可以使用這個宏，或明確傳送 BCM_SETNOTE 訊息。 |
| Button_SetSplitInfo | 設定指定分割按鈕控制件的資訊。 使用此宏或明確傳送 BCM_SETSPLITINFO 訊息。 |
| Button_SetState | 設定按鈕的醒目提示狀態。 醒目提示狀態指出按鈕是否反白顯示，就好像使用者已推送按鈕一樣。 您可以使用這個宏，或明確傳送 BM_SETSTATE 訊息。 |
| Button_SetStyle | 設定按鈕的樣式。 您可以使用這個宏，或明確傳送 BM_SETSTYLE 訊息。 |
| Button_SetText | 設定按鈕的文字。 |
| Button_SetTextMargin | 設定按鈕控制件中繪製文字的邊界。 您可以使用這個宏，或明確傳送 BCM_SETTEXTMARGIN 訊息。 |
訊息
| 主題 | 目錄 |
|---|---|
| BCM_GETIDEALSIZE | 如果影像清單存在，取得最適合其文字和影像的按鈕大小。 您可以明確傳送此訊息，或使用 Button_GetIdealSize 宏。 |
| BCM_GETIMAGELIST | 取得描述指派給按鈕控件之影像清單的BUTTON_IMAGELIST結構。 您可以明確傳送此訊息，或使用 Button_GetImageList 宏。 |
| BCM_GETNOTE | 取得與命令連結按鈕相關聯的附註文字。 您可以明確傳送此訊息，或使用 Button_GetNote 宏。 |
| BCM_GETNOTELENGTH | 取得可在命令連結按鈕描述中顯示的記事文字長度。 使用 Button_GetNoteLength 宏明確傳送此訊息。 |
| BCM_GETSPLITINFO | 取得分割按鈕控制件的資訊。 使用 Button_GetSplitInfo 宏明確傳送此訊息。 |
| BCM_GETTEXTMARGIN | 取得用來在按鈕控件中繪製文字的邊界。 您可以明確傳送此訊息，或使用 Button_GetTextMargin 宏。 |
| BCM_SETDROPDOWNSTATE | 設定具有樣式 TBSTYLE_DROPDOWN按鈕的下拉式狀態。 使用 Button_SetDropDownState 宏明確傳送此訊息。 |
| BCM_SETIMAGELIST | 將影像清單指派給按鈕控制件。 您可以明確傳送此訊息，或使用 Button_SetImageList 宏。 |
| BCM_SETNOTE | 設定與命令連結按鈕相關聯的附註文字。 您可以明確傳送此訊息，或使用 Button_SetNote 宏。 |
| BCM_SETSHIELD | 設定指定按鈕或命令連結的提高許可權必要狀態，以顯示提升許可權的圖示。 使用 Button_SetElevationRequiredState 宏明確傳送此訊息。 |
| BCM_SETSPLITINFO | 設定分割按鈕控制件的資訊。 使用 Button_SetSplitInfo 宏明確傳送此訊息。 |
| BCM_SETTEXTMARGIN | BCM_SETTEXTMARGIN訊息會設定按鈕控件中繪製文字的邊界。 |
| BM_CLICK | 模擬使用者按鍵。 此訊息會導致按鈕接收 WM_LBUTTONDOWN 和 WM_LBUTTONUP 訊息，以及按鈕的父視窗接收 BN_CLICKED 通知碼。 |
| BM_GETCHECK | 取得單選按鈕或複選框的核取狀態。 您可以明確傳送此訊息，或使用 Button_GetCheck 宏。 |
| BM_GETIMAGE | 擷取與按鈕相關聯的影像（圖示或點陣圖）句柄。 |
| BM_GETSTATE | 擷取按鈕或複選框的狀態。 您可以明確傳送此訊息，或使用 Button_GetState 宏。 |
| BM_SETCHECK | 設定單選按鈕或複選框的核取狀態。 您可以明確傳送此訊息，或使用 Button_SetCheck 宏。 |
| BM_SETDONTCLICK | 在單選按鈕上設定旗標，控制按鈕收到焦點時BN_CLICKED訊息的產生。 |
| BM_SETIMAGE | 將新的影像（圖示或點陣圖）與按鈕產生關聯。 |
| BM_SETSTATE | 設定按鈕的醒目提示狀態。 醒目提示狀態指出按鈕是否反白顯示，就好像使用者已推送按鈕一樣。 您可以明確傳送此訊息，或使用 Button_SetState 宏。 |
| BM_SETSTYLE | 設定按鈕的樣式。 您可以明確傳送此訊息，或使用 Button_SetStyle 宏。 |
Notifications
| 主題 | 目錄 |
|---|---|
| BCN_DROPDOWN | 當使用者按鍵上的下拉箭號時傳送。 控件的父視窗會以WM_NOTIFY訊息的形式接收此通知程序代碼。 |
| BCN_HOTITEMCHANGE | 通知按鈕控制項擁有者滑鼠正在進入或離開按鈕控制件的工作區。 按鈕控制項會以WM_NOTIFY訊息的形式傳送此通知程式代碼。 |
| BN_CLICKED | 當使用者按鍵時傳送。 按鈕的父視窗會透過WM_COMMAND訊息接收BN_CLICKED通知程序代碼。 |
| BN_DBLCLK | 當使用者按兩下按鈕時傳送。 此通知碼會自動傳送給 BS_USERBUTTON、 BS_RADIOBUTTON和 BS_OWNERDRAW 按鈕。 只有當BS_NOTIFY樣式時，其他按鈕類型才會傳送BN_DBLCLK。 按鈕的父視窗會透過WM_COMMAND訊息接收BN_DBLCLK通知程序代碼。 |
| BN_DISABLE | 停用按鈕時傳送。 注意： 此通知程式代碼僅針對與 3.0 版之前的 16 位 Windows 版本相容。 應用程式應該針對這項工作使用 BS_OWNERDRAW 按鈕樣式和 DRAWITEMSTRUCT 結構。 按鈕的父視窗會透過WM_COMMAND訊息接收BN_DISABLE通知碼。 |
| BN_DOUBLECLICKED | 當使用者按兩下按鈕時傳送。 此通知碼會自動傳送給 BS_USERBUTTON、 BS_RADIOBUTTON和 BS_OWNERDRAW 按鈕。 其他按鈕類型只有在具有BS_NOTIFY樣式時，才會傳送BN_DOUBLECLICKED。 按鈕的父視窗會透過WM_COMMAND訊息接收BN_DOUBLECLICKED通知程序代碼。 |
| BN_HILITE | 當用戶選取按鈕時傳送。 注意： 此通知程式代碼僅針對與 3.0 版之前的 16 位 Windows 版本相容。 應用程式應該針對這項工作使用 BS_OWNERDRAW 按鈕樣式和 DRAWITEMSTRUCT 結構。 按鈕的父視窗會透過WM_COMMAND訊息接收BN_HILITE通知碼。 |
| BN_KILLFOCUS | 當按鈕失去鍵盤焦點時傳送。 按鈕必須具有 BS_NOTIFY 樣式，才能傳送此通知程序代碼。 按鈕的父視窗會透過WM_COMMAND訊息接收BN_KILLFOCUS通知程序代碼。 |
| BN_PAINT | 應該繪製按鈕時傳送。 注意： 此通知程式代碼僅針對與 3.0 版之前的 16 位 Windows 版本相容。 應用程式應該針對這項工作使用 BS_OWNERDRAW 按鈕樣式和 DRAWITEMSTRUCT 結構。 按鈕的父視窗會透過WM_COMMAND訊息接收BN_PAINT通知碼。 |
| BN_PUSHED | 當按鈕的推送狀態設定為已推送時傳送。 注意： 此通知程式代碼僅針對與 3.0 版之前的 16 位 Windows 版本相容。 應用程式應該針對這項工作使用 BS_OWNERDRAW 按鈕樣式和 DRAWITEMSTRUCT 結構。 按鈕的父視窗會透過WM_COMMAND訊息接收BN_PUSHED通知碼。 |
| BN_SETFOCUS | 當按鈕收到鍵盤焦點時傳送。 按鈕必須具有 BS_NOTIFY 樣式，才能傳送此通知程序代碼。 按鈕的父視窗會透過WM_COMMAND訊息接收BN_SETFOCUS通知碼。 |
| BN_UNHILITE | 應從按鈕移除醒目提示時傳送。 注意： 此通知程式代碼僅針對與 3.0 版之前的 16 位 Windows 版本相容。 應用程式應該針對這項工作使用 BS_OWNERDRAW 按鈕樣式和 DRAWITEMSTRUCT 結構。 按鈕的父視窗會透過WM_COMMAND訊息接收BN_UNHILITE通知碼。 |
| BN_UNPUSHED | 當按鈕的推送狀態設定為未推送時傳送。 注意： 此通知程式代碼僅針對與 3.0 版之前的 16 位 Windows 版本相容。 應用程式應該針對這項工作使用 BS_OWNERDRAW 按鈕樣式和 DRAWITEMSTRUCT 結構。 按鈕的父視窗會透過WM_COMMAND訊息接收BN_UNPUSHED通知程序代碼。 |
| NM_CUSTOMDRAW （按鈕） | 通知按鈕控制件的父視窗，有關按鈕上的自定義繪製作業。 按鈕控制項會以WM_NOTIFY訊息的形式傳送此通知程式代碼。 |
| WM_CTLCOLORBTN | 在繪製按鈕之前，會將WM_CTLCOLORBTN訊息傳送至按鈕的父視窗。 父視窗可以變更按鈕的文字和背景色彩。 不過，只有擁有者繪製的按鈕會回應處理此訊息的父視窗。 |
結構
| 主題 | 目錄 |
|---|---|
| BUTTON_IMAGELIST | 包含與按鈕控制件搭配使用之影像清單的相關信息。 |
| BUTTON_SPLITINFO | 包含定義分割按鈕的資訊（BS_SPLITBUTTON 和 BS_DEFSPLITBUTTON 樣式）。 與BCM_GETSPLITINFO和BCM_SETSPLITINFO訊息搭配使用。 |
| NMBCDROPDOWN | 包含BCN_DROPDOWN通知的相關信息。 |
| NMBCHOTITEM | 包含滑鼠在按鈕控件上移動的相關信息。 |
常數
| 主題 | 目錄 |
|---|---|
| 按鈕樣式 | 指定按鈕樣式的組合。 如果您使用 BUTTON 類別搭配 CreateWindow 或 CreateWindowEx 函式來建立按鈕，您可以指定下列任何按鈕樣式。 |