控制資料表

Control 資料表會定義出現在每個對話方塊上的控制項。

Control 資料表具有下列資料行。

資料行	類型	答案	Nullable
對話 框_	識別碼	Y	N
控制	識別碼	Y	N
類型	識別碼	N	N
X	整數	N	N
Y	整數	N	N
寬度	整數	N	N
高度	整數	N	N
屬性	DoubleInteger	N	Y
屬性	識別碼	N	Y
Text	格式 化	N	Y
Control_Next	識別碼	N	Y
說明	Text	N	Y

 

資料行

對話 框_

對話方塊資料表第一個資料行的外部索引鍵，即對話方塊的名稱。

控制

控制項的名稱。 此名稱在對話方塊中必須是唯一的，但可以在不同的對話方塊中重複。 與Dialog_資料行結合的 Control 資料行會形成此資料表的主鍵。

類型

控制項的類型。 如需控制項類型清單，請參閱 控制項。

X

控制項矩形界限左上角的水準座標。 這必須是非負數。 請參閱 位置控制項屬性。

Y

控制項矩形界限左上角的垂直座標。 這必須是非負數。 請參閱 位置控制項屬性。

寬度

控制項矩形界限的寬度。 這必須是非負數。 請參閱 位置控制項屬性。

高度

控制項矩形界限的高度。 這必須是非負數。 請參閱 位置控制項屬性。

屬性

32 位字組，指定要套用至這個控制項的位旗標。 這必須是非負數，而且允許的值取決於控制項的類型。 如需所有控制項屬性的清單，以及要在此欄位中輸入的值，請參閱 控制屬性。

財產

要連結至這個控制項之已定義屬性的名稱。 選項按鈕、清單方塊和下拉式方塊值會連結至相同屬性，以系結至群組。 使用中控制項需要此資料行。

文本

可當地語系化的字串，用來設定 控制項中包含的初始文字。 字串也可以包含內嵌屬性。 如需包含屬性的格式化字串語法，請參閱 MsiFormatRecord 函式 。 在文字字串前面加上 {\style}，以指定文字的大小、字型和色彩，其中 style 是撰寫至 TextStyle 資料表之 TextStyle資料行的文字樣式。 如果文字字串太長而無法容納控制項，則會截斷。 文字字串可能是空白的。

如果文字控制項在具有 TrackDiskpace 屬性的對話方塊中顯示文字，則需要此欄位中格式化文字字串的特殊撰寫。 這是 由 TrackDiskSpace 對話方塊樣式位 所指定的案例，出現在 對話方塊資料表的屬性中。 在此情況下，如果 Control 資料表之 Text 資料行中的格式化字串以 「[」 開頭，並以 「]」 結尾，則您必須在字串結尾加上空格。 例如，如果 DlgTextFont 是將設定為 「{\DlgFontBold}」 的屬性，格式化字串 「[DlgTextFont]MyText[ProductName] 」 需要右括弧之後的結尾空格。 安裝程式需要這個額外的空間，才能正確顯示 Text 控制項中的文字。

您可以輸入 VolumeCostList、 ListView、 DirectoryList和 SelectionTree 控制項的簡短描述性文字字串。 使用者看不到此文字，但螢幕助讀程式可以讀取為控制項的描述。

另請參閱 協助工具。

Control_Next

相同對話方塊上的另一個控制項名稱，以及 Control 資料表第二個數據行的外部索引鍵。 如果對話方塊中的焦點位於 [控制項] 資料行的控制項上，按 Tab 鍵會將焦點移至列在 [Control_Next] 欄中的控制項。 因此，此資料行是用來指定對話方塊上控制項的定位順序。 控制項之間的連結必須形成封閉迴圈。 某些控制項，例如靜態文字控制項，可以離開迴圈。 在此情況下，此欄位可能會保留空白。

另請參閱 協助工具。

説明

搭配 [說明] 按鈕使用的選擇性可當地語系化文字字串。 字串會以分隔字元分隔 (分成兩個部分 |) 。 字串的第一個部分會當做工具提示文字使用。 螢幕助讀程式會針對包含圖片的控制項使用此文字。 字串的第二個部分會保留供日後使用。 即使只有兩種文字的其中一種存在，仍需要分隔符號。

備註

x、y、width 和 height 的整數值位於 安裝程式單位中，而不是對話方塊單位。 安裝程式單位等於 10 點 MS Sans Serif 字型大小的一十二分之一高度。 控制項的座標相對於看板。

驗證

ICE03
ICE06
ICE17
ICE20
ICE23
ICE31
ICE32
ICE34
ICE45
ICE46
ICE95