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樣式。