共用方式為


一般控件參數

下列描述控件資源定義語句的一般語法。 每個參數的意義如下。 有時候,語句會以不同的方式使用 參數,或可能會忽略參數。 語句的特定變化會在語句的檔中描述。

control [[text,]] id, x, y, width, height[[, style[[, extended-style]]]][, helpId]
[{ data-element-1 [, data-element-2 [,  . . . ]]}]

text

要與控件一起顯示的文字。 文字位於控件內或與控件相鄰。

此參數必須包含以雙引號括住的零個或多個字元()。 字串會自動以 Null 終止,並轉換成產生的資源檔中的 Unicode。

根據預設,雙引號之間所列的字元為 ANSI 字元,而逸出序列則會解譯為位元組逸出序列。 如果字串前面加上 「L」 前置詞,則字元串是寬字元字串,而逸出序列會解譯為指定 Unicode 字元的 2 位元組逸出序列。 如果文字中需要雙引號,您必須包含雙引號兩次。

文字中的 &ersand (&) 字元表示下列字元會當做控件的助記字元使用。 顯示控件時,不會顯示連字元,但助記字元會加上底線。 用戶可以按下對應至底線助記字元的按鍵來選擇控件。 若要在字串中使用 ampersand 做為字元,請插入兩個連字元 (&&)。

id

控制標識碼。 這個值必須是範圍 0 到 65,535 的 16 位無符號整數,或評估為該範圍內值的簡單算術表達式。

x

控件左側相對於對話框左側的 X 座標。 此值必須是範圍 0 到 65,535 的 16 位無符號整數。 座標位於對話框單位中,相對於包含指定控件之對話框、視窗或控件的原點。

y

控件頂端相對於對話框頂端的 Y 座標。 此值必須是範圍 0 到 65,535 的 16 位無符號整數。 座標是相對於包含指定控件之對話框、視窗或控件原點的對話框單位。

寬度

控件的寬度。 此值必須是範圍 1 到 65,535 中的 16 位無符號整數。 寬度以 1/4 個字元為單位。

height (高度)

控制件的高度。 此值必須是範圍 1 到 65,535 中的 16 位無符號整數。 高度以 1/8 個字元為單位。

style

控件樣式。 使用位 OR (|) 運算符來結合樣式。 如需詳細資訊,請參閱 窗口樣式

extended-style

延伸窗口樣式。 您必須指定樣式以指定擴充樣式。 如需詳細資訊,請參閱 EXSTYLE

helpId

數值表達式,指出在WM_HELP處理期間用來識別控件的標識碼。

controlData

控制件的控制項特定數據。 建立對話框,且該對話框中建立具有控件特定數據的控件時,該數據的指標會透過該控件WM_CREATE訊息的 lParam傳遞至控件的視窗程式。

備註

水平對話框單位是對話框基底寬度單位的 1/4。 垂直單位為對話框基底高度單位的 1/8。 目前的對話框基底單位是從目前系統字型的高度和寬度計算。 GetDialogBaseUnits 函式會以像素為單位傳回對話框基底單位。 座標相對於對話框的原點。