PushButton 控件
PushButton 控件會顯示基本的按鈕，也稱為命令按鈕。
PushButton 控件無法用來發佈 IgnoreChange ControlEvent、SelectionDescription ControlEvent、SelectionSize ControlEvent、SelectionPath ControlEvent、SelectionPathOn ControlEvent、SelectionAction ControlEvent、SelectionNoItems ControlEvent、ActionText ControlEvent、ActionData ControlEvent、SetProgress ControlEvent 或 TimeRemaining ControlEvent 。
您可以使用下列屬性搭配此控制件。 若要使用事件變更屬性的值，請將控件訂閱至 EventMapping 數據表中的 ControlEvent，並在 [屬性] 資料行中列出屬性的識別碼。 在 [事件] 數據行中輸入 ControlEvent 的標識碼。
| 屬性標識碼 | 十六進位位 | 描述 |
|---|---|---|
| 位置 | 對話框中控件的位置。 在控件數據表的 Width、Height、X 和 Y 資料行中，輸入控件左角的寬度、高度和座標。 使用 安裝程式單位 的長度和距離。 |
|
| Text | 這個控件屬性可以指定控件所顯示的文字、儲存在二進位數據表中的影像，或運行時間的映射集。 若要指定文字，請在 Control 資料表的 Text 資料行中輸入文字字串。 若要設定文字字串的字型和字型樣式，請在顯示字元的字串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 數據表之 TextStyle 數據行中列出的標識碼。 如果兩者都不存在，但 DefaultUIFont 屬性會定義為有效的文字樣式，則會使用該字型。 若要指定儲存在二進位數據表中的 圖示或點陣圖影像，請將影像記錄的主鍵從二進位數據表的 Name 資料行輸入控件數據表記錄的 Text 數據行。 |
|
| Visible | 0x00000000 0x00000001 |
隱藏的控件。 可見控制件。 將這個位包含在 Control 資料表中 Attributes 數據行的位字中，讓控件在建立時可見或隱藏。 您也可以使用 ControlCondition 資料表來隱藏或顯示控件。 |
| 已啟用 | 0x00000000 0x00000002 |
處於停用狀態的控制件。 處於啟用狀態的控制件。 在控件的 [屬性] 資料行中包含此位，以在建立時啟用控件。 您也可以使用 ControlCondition 數據表來啟用或停用控件。 |
| 沉沒 | 0x00000000 0x00000004 |
顯示預設的視覺化樣式。 以沉沒的 3D 外觀顯示控制件。 在 Control 資料表的 [屬性] 資料行中，將這些位包含在位字中。 |
| RTLRO | 0x00000000 0x00000020 |
控件中的文字會以從左至右的閱讀順序顯示。 控件中的文字會以從右至左的閱讀順序顯示。 |
| 點陣圖 | 0x00000000 0x00040000 |
控制件中的文字是在控制項資料表的 Text 資料列中指定。 按鈕具有BS_BITMAP樣式，控件中的文字會由點陣圖影像取代。 Control 數據表中的 Text 數據行會當做二進位數據表的外鍵使用。 將這個位包含在控件的 [屬性] 資料行的位字中。 請勿同時設定圖示和點陣陣圖樣式位。 按鈕不能同時包含位圖影像和文字。 若要設定文字字串的字型和字型樣式，請在顯示字元的字串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 數據表之 TextStyle 數據行中列出的標識碼。 如果兩者都不存在，但 DefaultUIFont 屬性會定義為有效的文字樣式，則會使用該字型。 |
| 圖示控件 | 0x00000000 0x00080000 |
控制件中的文字是在控制項資料表的 Text 資料列中指定。 按鈕具有BS_ICON樣式，控件中的文字會取代為圖示影像。 Control 數據表中的 Text 數據行會當做二進位數據表的外鍵使用。 將這個位包含在控件的 [屬性] 資料行的位字中。 請勿同時設定圖示和點陣陣。 按鈕不能同時包含圖示影像和文字。 若要設定文字字串的字型和字型樣式，請在顯示字元的字串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 數據表之 TextStyle 數據行中列出的標識碼。 如果兩者都不存在，但 DefaultUIFont 屬性會定義為有效的文字樣式，則會使用該字型。 |
| FixedSize | 0x00000000 0x00100000 |
伸展圖示影像以符合控件。 裁剪或置中控件中的圖示影像。 將這個位包含在 BBControl 資料表或 Control 資料表之 Attributes 數據行的位字中。 |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
載入第一個影像。 載入前 16x16 影像。 載入前 32x32 影像。 載入前 48x48 映像。 圖示檔案可以包含相同圖示的不同大小影像。 在 Control 資料表的 [屬性] 資料行中包含適當位字的值 如果未設定這些位，安裝程式會忽略 FixedSize 屬性，並延展影像以符合控件矩形。 如果同時設定 IconSize 位和 FixedSize 位，則小於控件的影像會置中，且影像大於縮小為適合的控件。 |
| ElevationShield | 0x00000000 0x00800000 |
推送按鈕的外觀取決於其他圖示屬性。 將 用戶帳戶控制 （UAC） 提高許可權圖示 （盾牌圖示） 新增至按鈕控制件。 |
備註
您可以使用 CreateWindowEx 函式，從 BUTTON 類別建立此控件。 它具有BS_MULTILINE、WS_CHILD、WS_TABSTOP和WS_GROUP樣式。