常用控件参数

下面介绍了控件资源定义语句的一般语法。 下面给出了每个参数的含义。 有时,语句会以不同的方式使用参数,或者可能会忽略参数。 语句的文档中介绍了特定于语句的变体。

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

文本

要随 控件一起显示的文本。 文本位于 控件内或控件的相邻位置。

此参数必须包含零个或多个用双引号 (“) 括起来的字符。 字符串自动以 null 结尾,并在生成的资源文件中转换为 Unicode。

默认情况下,双引号之间列出的字符是 ANSI 字符,转义序列被解释为字节转义序列。 如果字符串前面有“L”前缀,则字符串是宽字符字符串,转义序列被解释为指定 Unicode 字符的 2 字节转义序列。 如果文本中需要双引号,则必须包含两次双引号。

文本中 (&) 字符的和号表示以下字符用作控件的助记符。 显示控件时,不会显示和号,但助记符带有下划线。 用户可以通过按对应于带下划线的助记符的键来选择控件。 若要将和号用作字符串中的字符,请在) (&& 插入两个和号。

Id

控制标识符。 此值必须是 0 到 65,535 范围内的 16 位无符号整数,或者是计算结果为该范围内的值的简单算术表达式。

X

控件左侧相对于对话框左侧的 X 坐标。 此值必须是 0 到 65,535 范围内的 16 位无符号整数。 坐标以对话单位表示,相对于包含指定控件的对话框、窗口或控件的原点。

Y

控件顶部相对于对话框顶部的 Y 坐标。 此值必须是 0 到 65,535 范围内的 16 位无符号整数。 坐标以对话框单位表示,相对于包含指定控件的对话框、窗口或控件的原点。

宽度

控件的宽度。 此值必须是 1 到 65,535 范围内的 16 位无符号整数。 宽度以 1/4 个字符为单位。

高度

控件的高度。 此值必须是 1 到 65,535 范围内的 16 位无符号整数。 高度以 1/8 个字符为单位。

风格

控件样式。 使用按位 OR (|) 运算符组合样式。 有关详细信息,请参阅窗口样式

extended-style

扩展窗口样式。 必须指定 样式 才能指定 扩展样式。 有关详细信息,请参阅 EXSTYLE

helpId

指示在WM_HELP处理期间用于标识控件的 ID 数值表达式。

controlData

控件的特定于控件的数据。 创建对话框并创建该对话框中具有特定于控件数据的控件时,指向该数据的指针将通过该控件的WM_CREATE消息的 lParam 传递到控件的窗口过程中。

备注

水平对话单位是对话基宽单位的 1/4。 垂直单位是对话基础高度单位的 1/8。 当前对话框的基本单位是从当前系统字体的高度和宽度计算的。 GetDialogBaseUnits 函数返回以像素为单位的对话基单位。 坐标相对于对话框的原点。