首页 理论教育AutoCAD2014中文版DCL属性目录指南

AutoCAD2014中文版DCL属性目录指南

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

本节详细介绍DCL控件属性。属性按照字母顺序列出。

1.Action。

978-7-111-45924-8-Chapter15-40.jpg

指定一个AutoLISP表达式,当该控件被选定时,该表达式执行一个动作,即回调。对于某些类型的控件,当把焦点切换到其他控件时,也可以使动作发生。

其可能值是引号引起来的字符串,而且必须是一个有效的AutoLISP表达式。一个控件只能具有一个动作。如果应用程序使用actiontile函数为控件指定一个动作,则原来的action属性将被取代。

2.Alignment。

978-7-111-45924-8-Chapter15-41.jpg

为控件组中的控件指定水平或垂直位置对(正)。

对于列中的子控件,其值可以是左(1eft)、右(right)或居中(centered),默认值为:左。对于行中的子控件,其值可以是顶部(top)、底部b(ottom)或居中(centered),默认值为:居中。

不能沿控件组的长轴指定控件的对齐方式。控件组中的第一个控件和最后一个控件总是与行或列的两端对齐。除非用户插入spacerl-0控件进行调节,否则控件组中的其他控件都均匀排列。

3.allowaccept。

978-7-111-45924-8-Chapter15-42.jpg

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

4.aspect_ratio。

978-7-111-45924-8-Chapter15-43.jpg

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

5.bigincrement。

978-7-111-45924-8-Chapter15-44.jpg

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

6.Children alignment。

978-7-111-45924-8-Chapter15-45.jpg

指定控件组中所有控件的默认对齐方式(与alignment属性类似)。如果已显式地指定了alignment属性,则不能覆盖该属性。

对于列,其值可以是左(left)、右(right)或居中(centered),默认值为:left。

对于行,其值可以是顶部(top)、底部(bottom)或居中(centered),默认值为:centered。

7.children_fixed_height。

978-7-111-45924-8-Chapter15-46.jpg

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

8.children_fixed_width。

978-7-111-45924-8-Chapter15-47.jpg

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

9.Color。

978-7-111-45924-8-Chapter15-48.jpg

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

表15-4 颜色符号名

978-7-111-45924-8-Chapter15-49.jpg

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

10.edit_limit。

978-7-111-45924-8-Chapter15-50.jpg

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

11.edit_width。

978-7-111-45924-8-Chapter15-51.jpg

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

12.fixed_height。

978-7-111-45924-8-Chapter15-52.jpg

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

取值:true或false

默认值为:false。

13.fixed_width。

978-7-111-45924-8-Chapter15-53.jpg

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

14.fixed_width_font。

978-7-111-45924-8-Chapter15-54.jpg

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

15.Height。

978-7-111-45924-8-Chapter15-55.jpg

指定控件的高度,其值是一个以字符高度为单位表示控件高度的整数或实数。字符高度单位被定义为屏幕字符的最大高度包(括行间距)。

除非在默认设置下控件的布局令人不满意,否则不要指定高度值。但是,在使用图像控件和图像按钮时必须指定其高度。

控件的height属性仅指定控件的最小高度。除非控件的高度已由某个fixed属性固定,否则在调整布局时仍然可以扩展该尺寸。默认是根据当前的布局动态地指定宽度。

16.initial_focus。

978-7-111-45924-8-Chapter15-56.jpg

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

17.is_bold。

978-7-111-45924-8-Chapter15-57.jpg

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

18.is_cancel。

978-7-111-45924-8-Chapter15-58.jpg

指定当用户按Esc键时按钮是否被选中。其值可以是true或false,默认值为:false。

如果按钮的is_cancel属性被设置为true,且动作表达式不能退出对话框(不调用donedialog函数),则对话框会在动作表达式运行之后自动终止,并将DIASTAT系统变量设置为0。对话框中只能有一个按钮的is_cancel属性可以被设置为true。

19.is_default。

978-7-111-45924-8-Chapter15-59.jpg

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

20.is_enabled。

978-7-111-45924-8-Chapter15-60.jpg

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

21.is_tabstop。

978-7-111-45924-8-Chapter15-61.jpg

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

22.Key。

978-7-111-45924-8-Chapter15-62.jpg

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

23.Label。

978-7-111-45924-8-Chapter15-63.jpg

指定显示在控件中的文字。其值是引号引起来的字符串,默认值为:空子符串,“”。label文字的位置由控件决定。label属性可以为控件指定一个助记符。在控件标签中,助记符是一个带下划线的字符。

如果标签字符串中某字符的前面有一个与符号(&),则此字符是控件的助记符。对话框中的助记符不必是唯一的。如果对话框中的多个控件有相同的助记符,当在键盘上按助记符时,焦点将在这些控件之间循环切换。

助记符只是切换焦点所在的位置,并不选择控件。如果用户为一个包含一组项目的控件指定一个助记符,例如控件组或列表框,则焦点将移动到控件的第一个接受制表位切换的项目上。除了is_tabstop属性被设置为false的控件外,其他所有活动控件都可以使用Tab键切换。

24.Layout。

978-7-111-45924-8-Chapter15-64.jpg

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

25.List。

978-7-111-45924-8-Chapter15-65.jpg

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

26.maxvalue。

978-7-111-45924-8-Chapter15-66.jpg

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

27.min_value。

978-7-111-45924-8-Chapter15-67.jpg

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

28.Mnemonic。

978-7-111-45924-8-Chapter15-68.jpg

指定控件的键盘助记符。在控件标签中,助记符是一个带下划线的字符。其值是引号引起来的字符串,其中只包含一个字符,无默认值,该字符必须是控件标签中的某个字符。

从用户的角度来看,助记符是不区分大小写的。例如,如果按钮的助记符为A,用户输入a或A都可以使焦点移动到该按钮上。然而,在DCL文件中,助记符必须是控件label属性的一个字符,并且其大小写也应该与label字符串中的相应字符保持一致。

29.multiple_select。

978-7-111-45924-8-Chapter15-69.jpg

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

30.password_char。

978-7-111-45924-8-Chapter15-70.jpg

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

31.small_increment。

978-7-111-45924-8-Chapter15-71.jpg

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

32.Tabs。

978-7-111-45924-8-Chapter15-72.jpg

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

978-7-111-45924-8-Chapter15-73.jpg

33.tab_truncate。

978-7-111-45924-8-Chapter15-74.jpg

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

34.Value。

978-7-111-45924-8-Chapter15-75.jpg

指定控件的初始值,其值是一个引号引起来的字符串。对于不同类型的控件,其值在含义上有很大的区别。实际使用时,通过用户输入或者调用set_tile函数可以改变控件的值。

在对话框布局过程中,不必考虑控件的value属性。当布局完成并且对话框显示在屏幕上以后,new_dialog函数将使用value属性初始化对话框中的所有控件。控件的value属性不会影响对话框中的控件的大小和间距。

35.Width。

978-7-111-45924-8-Chapter15-76.jpg

指定控件宽度。其值是一个整数或实数值,以字符宽度为单位表示控件的宽度。字符宽度单位是所有大小写字母字符的平均宽度,也可以定义为屏幕的宽度除以80。这两种算法的结果都小于((A..Z)字符的宽度+(a..z)字符的宽度)/52。

除非对默认设置下的控件外观不满意,否则不要指定宽度值。不过,在使用图像控件和图像按钮时,必须指定其宽度。

控件的width属性仅指定其最小宽度。除非控件的宽度已由某个fixed属性固定,否则在调整布局时仍然可以扩展该尺寸。默认时根据当前的布局动态地指定宽度。