控制資料表
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 字型大小的一十二分之一高度。 控制項的座標相對於看板。
驗證