ProgressBar 控制項

ProgressBar 控件會顯示在接收進度訊息時變更長度的條形圖。 此控件訂閱 SetProgress ControlEvent。 它可以訂閱以受監視動作命名的ControlEvent。

如需相關信息，請參閱 撰寫 ProgressBar 控件和 將自定義動作新增至 ProgressBar。

控件屬性

您可以使用下列屬性搭配此控制件。 若要使用事件變更屬性的值，請將控件訂閱至 EventMapping 數據表中的 ControlEvent，並在 [屬性] 資料行中列出屬性的識別碼。 在 [事件] 數據行中輸入 ControlEvent 的標識碼。

屬性標識碼	十六進位位	描述
位置		控件在對話框中的位置。 在控件數據表的 Width、Height、X 和 Y 資料行中，輸入控件左角的寬度、高度和座標。 使用 安裝程式單位 的長度和距離。
Progress		這個屬性會指定有多少 ProgressBar 已填滿。 屬性是由兩個整數和一個字串所組成。 第一個整數位段是目前進度刻度的數目，而第二個整數位段是進度刻度的預設最大數目（1024）。 第三個字段是正在進行中動作名稱的字串。 如果目前的進度刻度數目大於最大值，安裝程式會將它變更為最大值。 這個屬性是由 SetProgress ControlEvent 所設定和變更。 您必須在 EventMapping 數據表中輸入 SetProgress，並將 Progress 輸入至 Attribute 數據行，以訂閱此事件的控件。
Text		控件顯示的文字。 若要設定文字字串的字型和字型樣式，請在顯示字元的字串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 數據表之 TextStyle 數據行中列出的標識碼。 如果兩者都不存在，但 DefaultUIFont 屬性會定義為有效的文字樣式，則會使用該字型。
Visible	0x00000000 0x00000001	隱藏的控件。 可見控制件。 將這個位包含在 Control 資料表中 Attributes 數據行的位字中，讓控件在建立時可見或隱藏。 您也可以使用 ControlCondition 資料表來隱藏或顯示控件。
沉沒	0x00000000 0x00000004	顯示預設的視覺化樣式。 以沉沒的 3D 外觀顯示控制件。 在 Control 資料表的 [屬性] 資料行中，將這些位包含在位字中。
RTLRO	0x00000000 0x00000020	控件中的文字會以從左至右的閱讀順序顯示。 控件中的文字會以從右至左的閱讀順序顯示。
Progress95	0x00000000 0x00010000	進度列繪製為連續列。 以一系列矩形繪製的進度列。 在 Control 資料表的 [屬性] 資料行中，將這些位包含在位字中。

 

備註

您可以使用 CreateWindowEx 函式，從PROGRESS_CLASS類別建立此控件。 它有 WS_CHILD 和 WS_GROUP 樣式。