【摘要】:本节详细介绍DCL控件属性。属性按照字母顺序列出。其可能值是引号引起来的字符串,而且必须是一个有效的AutoLISP表达式。big_increment的默认值是整个值范围的十分之一。如果已显式地指定了height属性,则不能覆盖该属性。指定控件的高度,其值是一个以字符高度为单位表示控件高度的整数或实数。控件的height属性仅指定控件的最小高度。如果属性值为true,文字以粗体字符显示。
本节详细介绍DCL控件属性。属性按照字母顺序列出。
1.Action。

指定一个AutoLISP表达式,当该控件被选定时,该表达式执行一个动作,即回调。对于某些类型的控件,当把焦点切换到其他控件时,也可以使动作发生。
其可能值是引号引起来的字符串,而且必须是一个有效的AutoLISP表达式。一个控件只能具有一个动作。如果应用程序使用actiontile函数为控件指定一个动作,则原来的action属性将被取代。
2.Alignment。

为控件组中的控件指定水平或垂直位置对(正)。
对于列中的子控件,其值可以是左(1eft)、右(right)或居中(centered),默认值为:左。对于行中的子控件,其值可以是顶部(top)、底部b(ottom)或居中(centered),默认值为:居中。
不能沿控件组的长轴指定控件的对齐方式。控件组中的第一个控件和最后一个控件总是与行或列的两端对齐。除非用户插入spacerl-0控件进行调节,否则控件组中的其他控件都均匀排列。
3.allowaccept。

指定用户按下接受键(通常为Enter键)时,指定控件是否被激活。如果该属性值为true,则当用户按接受键时,相当于按下默认按钮(如果存在)。默认按钮是is_default属性被设置为true的button控件。allow_accept属性默认为:false。
4.aspect_ratio。

指定图像的宽高比宽(度,高度)。如果属性值为零O(.o),则控件按图像大小调整。属性值可以是一个浮点数,默认值为:none。
5.bigincrement。

指定滑块增量值。big_increment的默认值是整个值范围的十分之一。增量值的大小必须在属性minvalue和maxvalue确定的范围内。
6.Children alignment。

指定控件组中所有控件的默认对齐方式(与alignment属性类似)。如果已显式地指定了alignment属性,则不能覆盖该属性。
对于列,其值可以是左(left)、右(right)或居中(centered),默认值为:left。
对于行,其值可以是顶部(top)、底部(bottom)或居中(centered),默认值为:centered。
7.children_fixed_height。

指定控件组中所有控件的默认高度(与height属性类似)。如果已显式地指定了height属性,则不能覆盖该属性。其值可以是true或false,默认值为:false。
8.children_fixed_width。

指定控件组中所有控件的默认宽度(与width属性类似)。如果已显式地指定了子控件的width属性,则不能覆盖该属性。其值可以是tlue或false,默认值为:false。
9.Color。

指定图像的背景(填充)色。可使用整数值、AutoCAD为颜色指定的保留字(默认值为:7)或如表15-4中列出的颜色符号名。
表15-4 颜色符号名

其中符号名graphics_background和graphics_foreground可以作为black和white的别名使用。由于颜色的实际显示取决于当前AutoCAD的配置情况,所以使用特定的颜色可能会导致显示的混乱。同时应该注意,幻灯片中的矢量在图像中通常只以黑白两种颜色显示。如果第一次显示时图像控件为空,则可以试着将其color属性设置为graphics_background或graphics_foreground。
10.edit_limit。

指定允许用户在编辑框中输入的最大字符数目。其值可以是一个整数值,默认值为:132。当输入的字符数达到此限制时,AutoCAD将拒绝接受用户后来输入的其他字符(BackSpace或DEL除外)。最大编辑限制允许输入256个字符。
11.edit_width。

以字符宽度为单位指定框的编辑或输入区(即editbox控件的实际加框部分)的宽度,其值是一个整数或实数。如果没有指定editwidth属性值,或指定为零,并且控件的宽度不固定,则编辑框将扩展至填满全部可用空间。如果editwidth非零,则框在控件中向右对齐。如果出于调整布局的目的需要调整控件的宽度,可以使用PDB功能模块在标签和输入区之间插入spacer控件。
12.fixed_height。

指定控件的高度是否可以填满整个可用空间。如果属性值为true,则控件的高度不会添满为布局或对齐操作留出的可用空间。
取值:true或false
默认值为:false。
13.fixed_width。

指定控件的宽度是否可以填满整个可用空间。如果属性值为true,则控件的宽度不会添满为布局或对齐操作留出的可用空间。其值可以是true或false,默认值为:false。
14.fixed_width_font。

指定列表框或打开式列表框是否以固定字符间距的字体显示文字。此属性可以简化为用空格和制表符控制控件按列对齐。其值可以是true或false,默认值为:false。
15.Height。

指定控件的高度,其值是一个以字符高度为单位表示控件高度的整数或实数。字符高度单位被定义为屏幕字符的最大高度包(括行间距)。
除非在默认设置下控件的布局令人不满意,否则不要指定高度值。但是,在使用图像控件和图像按钮时必须指定其高度。
控件的height属性仅指定控件的最小高度。除非控件的高度已由某个fixed属性固定,否则在调整布局时仍然可以扩展该尺寸。默认是根据当前的布局动态地指定宽度。
16.initial_focus。

指定对话框中接受初始键盘焦点的控件的关键字。其值是引号引起来的字符串,无默认值。
17.is_bold。

指定是否以粗体字符显示文字。其值可以是true或false,默认值为:false。如果属性值为true,文字以粗体字符显示。(https://www.chuimin.cn)
18.is_cancel。

指定当用户按Esc键时按钮是否被选中。其值可以是true或false,默认值为:false。
如果按钮的is_cancel属性被设置为true,且动作表达式不能退出对话框(不调用donedialog函数),则对话框会在动作表达式运行之后自动终止,并将DIASTAT系统变量设置为0。对话框中只能有一个按钮的is_cancel属性可以被设置为true。
19.is_default。

指定是否将一个按钮作为默认按钮,当用户按下接受键时,将选中该按钮(被按下)。其值可以是true或false,默认值为:false。如果用户将edit_box、list_box或image_button的allow_accept属性设置为true,则用户按下接受键(仅适用于列表框和图像按钮)或双击时,也会选中默认按钮。如果当前焦点正位于其他按钮上,则按下接受键时不选中默认按钮,这种情况下,会选中焦点所在的按钮。对话框中只能有一个按钮的is_default属性可以被设置为true。
20.is_enabled。

指定控件在打开对话框时是否可用。其值可以是true或false,默认值为:true。如果属性值为false,则控件不可用,显示为灰色。
21.is_tabstop。

指定在用户按Tab键切换控件时,控件是否接受键盘焦点。其值可以是true或false,默认值为:true。如果此属性被设置为false,则使用Tab键不能将焦点移动到此控件上。
22.Key。

指定应用程序引用特定控件时使用的名称。其值是引号引起来的字符串,无默认值。在对话框中,每个key属性值都必须是唯一的。该字符串区分大小写,如果将关键字指定为BigTile,则不能将其引用为bigtile。由于key属性值对用户不可见,因此设计者可以随意指定此属性值(但必须保证其对对话框的唯一性)。同理,在将应用程序翻译成其他语言时,key属性的值可以不必翻译。
23.Label。

指定显示在控件中的文字。其值是引号引起来的字符串,默认值为:空子符串,“”。label文字的位置由控件决定。label属性可以为控件指定一个助记符。在控件标签中,助记符是一个带下划线的字符。
如果标签字符串中某字符的前面有一个与符号(&),则此字符是控件的助记符。对话框中的助记符不必是唯一的。如果对话框中的多个控件有相同的助记符,当在键盘上按助记符时,焦点将在这些控件之间循环切换。
助记符只是切换焦点所在的位置,并不选择控件。如果用户为一个包含一组项目的控件指定一个助记符,例如控件组或列表框,则焦点将移动到控件的第一个接受制表位切换的项目上。除了is_tabstop属性被设置为false的控件外,其他所有活动控件都可以使用Tab键切换。
24.Layout。

指定滑块的方向。其值可以是horizontal或vertical,默认值为:horizontal。对于水平滑块,其值从左至右递增;对于垂直滑块,其值从下至上递增。
25.List。

指定popuplist或list_box控件的初始行(选项)。其值是引号引起来的字符串,无默认值。行由换行符(\n)分隔,Tab字符(\t)出现在每行中。
26.maxvalue。

指定slider控件返回值的上限,默认值为10000。此值是一个带符号的16位整数,最大不能超过32767。
27.min_value。

指定slider控件返回值的下限,默认值为0。此值是一个带符号的16位整数,最小不能低于-32768。minvalue的值可以超过maxvalue的值。
28.Mnemonic。

指定控件的键盘助记符。在控件标签中,助记符是一个带下划线的字符。其值是引号引起来的字符串,其中只包含一个字符,无默认值,该字符必须是控件标签中的某个字符。
从用户的角度来看,助记符是不区分大小写的。例如,如果按钮的助记符为A,用户输入a或A都可以使焦点移动到该按钮上。然而,在DCL文件中,助记符必须是控件label属性的一个字符,并且其大小写也应该与label字符串中的相应字符保持一致。
29.multiple_select。

指定是否可以在list_box控件中同时进行多项选择(亮显)。其值可以是true或false,默认值为false。如果值为true,则可以同时选择多项。
30.password_char。

指定用于屏蔽用户输入的字符。如果指定了password_char,并且其值不为空,则当用户输入时,在编辑框中仅显示指定的屏蔽字符,而不显示用户输入的内容。此属性不会影响到应用程序检索用户输入的正确内容,只是改变用户输入字符的显示。
31.small_increment。

指定滑块增量控制值。small_increment的默认值是整个取值范围的百分之一。增量值的大小必须在属性min_value和max_value确定的范围内,此属性是可选的。
32.Tabs。

以字符宽度为单位指定制表位的位置。其值可以是一个包含整数或浮点数的引号引起来的字符串,由空格分隔(无默认值)。这些值用于将popuplist或list_box控件中的文字垂直对齐。例如,下列代码用于在每8个字符处指定一个制表位。

33.tab_truncate。

指定当列表框或打开式列表框中文字超出关联制表位时,是否截断文字。其值可以是true或false,默认值为:false。
34.Value。

指定控件的初始值,其值是一个引号引起来的字符串。对于不同类型的控件,其值在含义上有很大的区别。实际使用时,通过用户输入或者调用set_tile函数可以改变控件的值。
在对话框布局过程中,不必考虑控件的value属性。当布局完成并且对话框显示在屏幕上以后,new_dialog函数将使用value属性初始化对话框中的所有控件。控件的value属性不会影响对话框中的控件的大小和间距。
35.Width。

指定控件宽度。其值是一个整数或实数值,以字符宽度为单位表示控件的宽度。字符宽度单位是所有大小写字母字符的平均宽度,也可以定义为屏幕的宽度除以80。这两种算法的结果都小于((A..Z)字符的宽度+(a..z)字符的宽度)/52。
除非对默认设置下的控件外观不满意,否则不要指定宽度值。不过,在使用图像控件和图像按钮时,必须指定其宽度。
控件的width属性仅指定其最小宽度。除非控件的宽度已由某个fixed属性固定,否则在调整布局时仍然可以扩展该尺寸。默认时根据当前的布局动态地指定宽度。
相关推荐