Text Control

[文字] 控制項會顯示靜態文字，可使用預先定義的樣式。

顯示具有指定換行符之文字的建議方法是使用位於彼此下方的多個單行文字控件。 控件文字欄位中的字元序列 \n、\r\n 或 \n\r 不會顯示為換行符。 控制件會以字面方式顯示這些字元序列。

控件屬性

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

屬性標識碼	十六進位位	描述
位置		對話框中控件的位置。 在 Control 資料表或 BBControl 數據表的 Width、Height、X 和 Y 數據行中，輸入控件左角的寬度、高度和座標。 使用 安裝程式單位 的長度和距離。
Text		控件顯示的文字。 若要設定文字字串的字型和字型樣式，請在顯示字元的字串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 數據表之 TextStyle 數據行中列出的標識碼。 如果兩者都不存在，但 DefaultUIFont 屬性會定義為有效的文字樣式，則會使用該字型。
TimeRemaining		此屬性可讓 Text 控制件顯示安裝剩餘的大約分鐘和秒數。 將 Text 控制件訂閱 Eventmapping 資料表中的 TimeRemaining ControlEvent，然後在 [屬性] 資料行中輸入 TimeRemaining。 安裝程式會發佈包含一個整數的記錄，代表安裝中剩餘的秒數。 在UIText資料表中包含一個數據列，並在Key資料行中包含 TimeRemaining。 在所撰寫的 Text 資料行中輸入格式化的文字字串，以顯示分鐘和秒。 格式化此字串， 如 MsiFormatRecord 所述。
Visible	0x00000000 0x00000001	隱藏的控件。 可見控制件。 將這個位包含在 Control 資料表或 BBControl 資料表中 Attributes 數據行的位字中，讓控件在建立時可見或隱藏。 您也可以使用 ControlCondition 資料表來隱藏或顯示控件。
已啟用	0x00000000 0x00000002	處於停用狀態的控制件。 處於啟用狀態的控制件。 在 Control 或 BBControl 數據表的 [屬性] 資料行中包含此位，以在建立時啟用控制件。 您也可以使用 ControlCondition 數據表來啟用或停用控件。
沉沒	0x00000000 0x00000004	顯示預設的視覺化樣式。 以沉沒的 3D 外觀顯示控制件。 在 Control 資料表的 [屬性] 資料行中，將這些位包含在位字中。
RTLRO	0x00000000 0x00000020	控件中的文字會以從左至右的閱讀順序顯示。 控件中的文字會以從右至左的閱讀順序顯示。
RightAligned	0x00000000 0x00000040	控件中的文字會對齊左邊。 控件中的文字會對齊右邊。
透明	0x00000000 0x00010000	不透明控件。 透過控件顯示背景。 控制件具有WS_EX_TRANSPARENT樣式。 將這個位包含在 Control 或 BBControl 數據表的 [屬性] 資料行中。
NoPrefix	0x00000000 0x00020000	在文字字串中使用 和 ，將下一個字元顯示為底線。 字串中的字元和 會顯示為本身。 在 Control 或 BBControl 資料表的 [屬性] 資料行中包含此位。
NoWrap	0x00000000 0x00040000	文字換行。 文字會顯示在單行上。 如果文字超出控件的邊界，則會裁剪並插入省略號 （“...”“ ）。 在 Control 或 BBControl 資料表的 [屬性] 資料行中包含此位。
UsersLanguage	0x00000000 0x00100000	在資料庫代碼頁中建立的字型。 在用戶的預設 UI 代碼頁中建立的字型。
FormatSize 控件屬性	0x00000000 0x00080000	格式化為文字。 如果設定此位，控件會嘗試將顯示的文字格式化為代表位元組計數的數位。 若要進行適當的格式設定，控件的文字必須設定為代表以 512 位元組單位表示的數位字串。 然後，顯示的值會以 KB（KB）、MB 或 GB（GB）來格式化，並以代表單位的適當字串來顯示。

 

備註

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

請勿將透明文字控件放在彩色點圖的頂端。 如果使用者變更顯示色彩配置，可能無法顯示文字。 例如，如果使用者基於輔助功能考慮設定高對比度參數，文字可能會變成看不見。