編輯控制件 (Windows Installer)

[編輯] 控制項是與字串或整數值屬性相關聯的編輯欄位。 在 Control 資料表[屬性] 資料行中輸入屬性的名稱。

控件屬性

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

屬性標識碼 十六進位位 描述
IndirectPropertyName 這是與控件相關聯的間接屬性名稱。 如果已設定 Indirect 屬性位,控制項會顯示或變更具有這個名稱的屬性值。 如果已設定 Indirect 屬性位,這個名稱也是 Control 資料表的 Property 資料行中列出的屬性值。
位置 控件在對話框中的位置。 在控件數據表的 Width、Height、X 和 Y 資料行中,輸入控件左角的寬度、高度和座標。 使用 安裝程式單位 的長度和距離。
PropertyName 這是與這個控件相關聯的屬性名稱。 如果未設定 Indirect 屬性位,控制項會顯示或變更具有這個名稱的屬性值。 此屬性是在 Control 資料表Property 資料行中指定。
PropertyValue 這個控件所顯示或變更之屬性的目前值。 如果未設定 Indirect 屬性位,這是 PropertyName 的值。 如果已設定 Indirect 屬性位,這是 IndirectPropertyName 的值。 如果屬性變更,控件會反映新的值。
Text 若要設定文字字串的字型和字型樣式,請在顯示字元的字串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 數據表之 TextStyle 數據行中列出的標識碼。 如果兩者都不存在,但 DefaultUIFont 屬性會定義為有效的文字樣式,則會使用該字型。 若要指定使用者可以輸入的字元數,請在任何字型規格後面附加 {n}。 其中 n 是正整數。
Visible 0x00000000 0x00000001
隱藏的控件。 可見控制件。
將這個位包含在 Control 資料表中 Attributes 數據行的位字中,讓控件在建立時可見或隱藏。
您也可以使用 ControlCondition 資料表來隱藏或顯示控件。
已啟用 0x00000000 0x00000002
處於停用狀態的控制件。 處於啟用狀態的控制件。
將這個位包含在控件[屬性] 數據行的位字中,以在建立時啟用控件。
您也可以使用 ControlCondition 數據表來啟用或停用控件。
沉沒 0x00000000 0x00000004
顯示預設的視覺化樣式。 以沉沒的 3D 外觀顯示控制件。
在 Control 資料表的 [屬性] 資料行中,將這些位包含在位字中
間接 0x00000000 0x00000008
控制項會在 Control 資料表[屬性] 資料行中顯示或變更 屬性的值。 控件會顯示或變更屬性的值,該屬性值已列在 Control 資料表的 [屬性] 資料行中。
判斷與這個控件相關聯的屬性是否間接參考。
整數 0x00000000 0x00000010
與控件相關聯的屬性是字串值。 與控件相關聯的屬性是整數值。
將這個位包含在 Control 數據表Attributes 數據行的位字中,以在建立控件時設定此屬性。
RTLRO 0x00000000 0x00000020
控件中的文字會以從左至右的閱讀順序顯示。 控件中的文字會以從右至左的閱讀順序顯示。
RightAligned 0x00000000 0x00000040
控件中的文字會對齊左邊。 控件中的文字會對齊右邊。
LeftScroll 0x00000000 0x00000080
滾動條位於控件右側。 滾動條位於控件的左側。
BiDi 0x000000E0 為 RTLRORightAlignedLeftScroll 屬性的組合設定此值。
MultiLine 0x00010000 使用垂直滾動條建立多行編輯控件。 在控件[屬性] 數據行的位字中包含 65536,以建立具有垂直滾動條的多行編輯控件。
密碼 0x00200000 建立輸入密碼的編輯控制件。 將2097152新增至 Control 資料表 [屬性] 資料行中的值,以建立編輯控制件,將每個字元顯示為星號 ≦ 。 設定 Password 屬性可防止安裝程式將與編輯控件相關聯的屬性寫入記錄檔。 如需詳細資訊,請參閱 防止機密資訊寫入記錄檔

備註

您可以使用 CreateWindowEx 函式,從 EDIT 類別建立此控件。 它具有WS_BORDERWS_CHILDWS_TABSTOPWS_GROUP樣式。

可以輸入的文字長度可以限制,方法是將數位從 0 到 2147483646大括號放在 [控件] 資料表[文字] 字段開頭的大括號中。 例如,如果文字欄位以 開頭 {80},字串的長度會限製為80個字元。 如果未在數據表中提供這類限制,或指定了 0,長度會設定為可能的最大長度(2147483646個字元)。 負值或非數值會產生錯誤。

為了與螢幕助讀程式相容,在撰寫含有編輯控件的對話框做為第一個使用中控件時,您必須將屬於編輯字段的文字欄位設為對話框表格中的第一個使用中控件。 由於靜態文字無法取得焦點,因此建立對話框時,編輯欄位一開始會有焦點,但這樣做可確保螢幕助讀程序顯示正確的資訊。

只有在控件失去焦點時,才會設定與編輯控件相關聯的屬性。 因此,您必須從控件索引標籤,或選取要更新之屬性的不同控件。