PB数据窗口对象之字段属性和计算域属性

〓字段和计算域的属性-更多见帮助(DataWindow objectproperties)

*获取字段的类型（Coltype属性）

字段的ColType属性是一个非常有用的属性，使用该属性可以在程序运行时获取字段的类型。但是不能在运行时修改该属性。下面是它的语法：

直接引用：dw_1.object.object.objectname.coltype

在Describe函数中："objectname.coltype"

不管使用哪种方式，对同一个字段获得的类型都相同。字段类型有char(n)，date，datetime，decimal(n)，int，long，number，real，time，timestamp及ulong共11种，其中的n代表字符的长度或者小数后的精度。

如：

ls_coltype = dw_1.objcet.emp_id.coltype

ls_coltype = dw_1.describe("emp_id.coltype")

在实际编程中，获取字段的类型后，紧接着使用choose case语句针对不同的类型进行相关的处理。

*背景属性（background.property）

在运行时修改字段的背景，这是标识特殊数据行的一种手段。使用该属性可以在程序运行时获取字段的背景，也可以修改字段的背景。它的语法如下：

直接引用：dw_1.object.objectname.background.property

在Describe和Modify函数中："objectname.background.property{ ='value'}"

其中，property可以是color或者mode。当为color时取值应该是长格式表示的颜色，或者使用RGB函数中红、绿、蓝表示的颜色；当为mode时，0表示将背景设置为不透明的（即可以显示背景颜色），1表示背景为透明的。

实际上，字段的背景属性也可以在数据窗口画板中进行设定。下面是修改和读取字段背景属性的实例：

//修改字段的背景颜色

dw_1.object.oval_1.background.color = rgb(255,0,128)

dw_1.modify("emp_name.background.color = '11665407'") //这里好象不能用rgb()

//读取字段的背景颜色

ls_data = dw_1.describe("oval_1.background.color")

//读取字段的背景模式

ls_data = dw_1.describe("emp_name.background.mode")

//设置字段的背景模式

dw_1.modify("emp_name.background.mode = '1'")

dw_1.modify("mdrect_1.background.mode = '0'")

*指定检索规则（Criteria.property属性）

在脚本运行时，可以控制是否显示检索规则窗口或者读取数据窗口这方面的信息。语法如下：

直接引用：dw_1.object.columnname.criteria.property

在describe和modify函数中："columnname.criteria.property{ = value}"

其中，dw_1是数据窗口控件名称，columnname是要获取或者设置检索规则的字段名称，value为yes或者no，property是以下属性：

a)Dialog：是否显示检索规则窗口。取值为yes则显示，取值为no则不显示。如，在一个数据窗口中放置了字段name，可以编写如下脚本：

dw_1.modify("name.criteria.dialog = yes sex.criteria.override_edit =yes")

dw_1.retrieve()

脚本运行，显示检索规则输入窗口

b)override_edit：是否用户必须在检索规则窗口中输入数据。取值为yes则用户必须输入数据，取值为no时用户可以不输入数据。

c)required：是否用户只能使用等号进行查询。如果取值为yes则用户的输入只能是等号，如果取值为no则用户可以使用各种符号，包括=、<>、>、>=、<=、<等。

*Edit风格的字段属性（Edit.property属性）

编辑风格为Edit类型的字段，可以通过edit.property来获取其相关信息或者设置其外观及动作。下面是它的语法：

直接引用：dw_1.object.columnname.edit.property

在describe和modify函数中："columnname.edit.property{ =value}"

其中，columnname是哟啊读取或者设置属性的字段名称，value根据property不同而可以使用不同类型的值。property可以有17个取值，其中：

a)和滚动控制有关的有AutoHScroll，AutoVScroll，HscrollBar和VscrollBar，它们的取值都是yes或者no，表示是否显示该滚动条。

b)和显示的内容有关的属性有Case，CodeTable，Format，NillsNull和Password，这些属性用来控制字段中的内容如何显示。Case的取值为Any，Upper，Lower与Painter，表示不管用户在该字段上输入的大小写，都按照该属性自动进行转换。CodeTable的取值为yes或者no，表示该字段是否有代码表。Format规定对用户输入的内容进行格式化时应该采用的格式。NillsNull的取值为yes或者no，表示当用户在字段中不输入内容而离开该字段时，是否将该字段中的内容自动置为NULL。Password属性的取值也是yes或者no，表示是否将用户的输入作为密码样式显示，如果作为密码则用户的输入内容作为*号显示，显示的个数和用户输入字符个数相等。

c)和编辑控制有关的属性有AutoSelect，DisplayOn1y，FocusRectangle，Limit，Required，Style和ValidateCode，除了Limit取值为正整数、Stylee取值为String类型外，其他属性的取值都是yes或者no。AutoSelect属性表示当字段获得焦点时是否自动选中该单元中的内容。Display0nly表示是否允许用户修改该字段中的内容，如果取值为yes，则用户虽然可以选中该字段中的内容但是不能修改。FocusRectangle表示当字段获得焦点时是否显示矩形的边框，以表示当前焦点的位置。Limit是一个相当重要的属性，用来限制用户可以输入字符的长度。Required属性如果为yes，则在获得焦点后用户不输入内容就休想离开。虽然该属性可以很好地保证非空字段不为空，但该属性非常不友好，建议慎重使用。Style属性在程序运行时不能修改，只能读取其中的信息。该属性返回的是关于字段的编辑风格。ValidateCode属性表示是否使用代码表进行有效性校验。该属性当CodeTable属性为yes时才有效。

下面是关于该属性的一些实例：

ls_setting = dw_1.objcet.emp_name.edit.autohscroll //是否允许自动横向滚动

ls_setting = dw_1.describe("emp_name.edit.Autohscroll") //同上

dw_1.object.emp_name.edit.required = "no" //将字段设置成必须输入的字段

dw_1.modify("emp_name.edit.required = no") //同上

*字段的显示格式（Format属性）

可以使用Format属性来指定字段的显示格式。但是，在实际编程中使用更多的是函数GetFormat或者SetFormat，以取代Modify或者Descrie来设置字段的显示格式。

该语法使用时的重点在于格式串的使用。下面是相关的语法：

直接引用：dw_1.object.objectname.format

在函数describe和modify中："objectname.format{='value'}"

其中，objectname是字段或者计算字段或者计算域的名称value是字符型的表达式，取值是一种格式串。下面是一些使用实例：

ls_setting = dw_1.object.phone.format //读取字段的电话显示格式

ls_setting = dw_1.describe("phone.format")

dw_1.object.shipdate.format = "yyyy-mm-dd" //设置日期格式

dw_1.modify("shipdate.format = 'yyyy-mm-dd'")

*设置数据窗口修改时的主键（key属性）

该属性在一个数据窗口修改多个表时非常有用，因为这时必须根据要修改的表动态修改主键，属性key就可以实现该功能。该属性使用时的语法如下：

直接引用：dw_1.object.columnname.key

在函数modify或者describe中："columnname.key{=value}"

其中，columnname是要作为主键的字段名，或者是要判断是否为主键的字段的名称；value取值为yes或者no。如：

ls_setting = dw_1.object.empid.key //判断字段empid是否为主键

ls_setting = dw_1.describe("empid.key")

dw_1.object.empid.key = "yes" //将字段empid作为主键

dw_1.modify("empid.key = yes")

*字段名称（name属性）

使用name属性可以获取字段的名称。可以使用字段号或者字段名称来标识一个字段，但使用字段号不太安全，所以用获取字段名比较好一些。语法如下：

直接引用：dw_1.object.objectname.name

在函数describe中："objectname.name"

其中，objectname是要获取名称的控件标识，因为在数据窗口对象中有很多控件有多种标识方法。如，下面可以获取字段号为1的字段的名称：

dw_1.describe("#1.name")

*字段中的数据保护（protect属性）

该属性表示是否对字段中的数据进行保护，取值为0或者1。1表示实行保护，0表示不保护。当进行数据保护时，即使字段的TabOrder值大于0用户也不能对字段进行编辑，并且该字段都不能获得焦点（和TabOrder取值为0时的表现完全相同）。下面是该属性使用时的语法：

直接引用：dw_1.object.columnname.protect

在函数describe和modify中："columnname.protect{='integer'}"

其中，columnname是要获取或者设置protect属性的字段的标识，integer取值为0或者1。

下面是使用实例：

ls_setting = dw_1.object.emp_start.protect //获取字段emp_start的protect属性取值

ls_setting = dw_1.describe("emp_start.protect")

dw_1.object.emp_start.protect = 1 //设置字段emp_start的protect属性

dw_1.modify("emp_start.protect = 1")

dw_1.modify("emp_start.protect = '1~tif(isrownew(),0,1)'")

//设置protect属性为表达式，含义是：如果是新数据行则将protect设置为0，否则设置为1//，缺省为1。

*字段的滑动属性（slideleft和slideup）

使用字段的滑动属性可以更好地根据运动时的情况安排数据的布局。有两个和滑动有关的属性，SlideLeft表示当左面空白时是否向左滑动，SlideUp表示当上面出现空白时是否向上滑动。使用该属性的语法是：

直接引用：

dw_1.object.objectname.slideleft

dw_1.object.objectname.slideup

在函数describe和modify中：

"objectname.slideleft{='value'}"

"objectname.slideup{='value'}"

其中，slideleft中的value取值为yes或者no。slideup中的value取值为：

a)AllAbove:当上面数据行中的所有 对象都为空时向上滑动

b)DirectlyAbove:当上面和本对象对应位置的对象为空时向上滑动

c)No:不进行滑动

下面是应用的实例：

dw_1.object.emp_lname.slideup = 'no'

ls_setting = dw_1.describe("graph_1.slideup")

dw_1.modify("emp_lname.slideup = no")

*字段的TabOrder值（TabSequence属性）

字段的TabOrder值是一个比较重要的属性，取值大于0时用户可以编辑该字段，等于0时无法编辑该字段。在运行时，根据程序的运行情况有可能动态修改字段的TabOrder值，这时可以使用TabSequence属性。该属性应用时的语法如下：

直接引用：dw_1.object.columnname.TabSequence

在函数modify或Describe中："columnname.TabSequence{=number}"

其中，number为从0到32000的正整数，当为0时表示字段不允许编辑。下面是使用实例：

ls_setting = dw_1.object.emp_name.tabsequence //获取字段的TabOrder值

ls_setting = dw_1.Describe("emp_name.tabsequence")

dw_1.object.emp_name.tabsequence = 10 //设置字段的taborder值

dw_1.modify("emp_name.tabsequence = 10")

实际上，在编程时经常使用函数SetTabOrder来设置或者获取字段的TabOrder值，因为该函数正确执行后，字段被设置成指定的TabOrder值，并且返回设置之前的TabOrder值。

*用户是否可以保存字段内容（update属性）

当数据窗口中的数据提交时，可以修改的字段及其对应的数据用来产生update SQL语句，使用该SQL语句进行数据的保护。所以，在程序运行时，如果不希望用户保存某字段中的数据，可以修改字段的update属性。下面是该属性的语法：

直接引用：dw_1.object.columnname.update

在函数modify或者describe中："columnname.update{=value}"

其中，value的取值为yes或者no。下面是使用实例：

ls_setting = dw_1.object.emp_name.update //获取字段是否可以修改

ls_setting = dw_1.describe("emp_name.update")

dw_1.object.emp_name.update = "no" //使字段emp_name不能修改

dw_1.modify("emp_name.update = no")

在应用时，可以根据用户的权限，或者根据用户的录入数据是否齐全（通常需要保证数据一致性）来动态修改某些字段的update属性。另外，在一个数据窗口修改多个数据表时也经常使用该属性。

*字段校验（Validation和ValidationMsg属性）

字段的校验规则在数据窗口画板中可以指定，但有时需要在程序运行时动态地修改，可以使用Validation和ValidationMsg属性来指定。属性Validation使用时的语法如下：

直接引用：dw_1.object.columnname.validation

在函数describe和modify中："columnname.validation{='validationstring'}"

其中，validaionstring是一个包含校验规则的字符串，该字符串的结果或者是True或者是False。下面是使用实例：

ls_setting = dw_1.object.emp_status.validation //获取字段的校验规则

ls_setting = dw_1.describe("emp_status.validation")

dw_1.modify("sex.validation = 'sex = ~~~'f~~~' or sex = ~~~'m~~~''")//设置规则

dw_1.object.sex.validation="sex='f' or sex='m'"

字段的校验规则设置好后，用户在该字段上输入数据并要离开时，如果数据不能通过校验则显示错误信息，采用系统缺省的错误信息不太友好。这时，可以通过设置validationgMsg属性来指定错误信息。该属性使用时的语法如下：

直接引用：dw_1.object.columnname.validationMsg

在函数describe和Modify中："columname.validationMsg{='string'}"

其中，string为数据不能通过校验规则时要提示的信息。如：

dw_1.object.sex.validationgmsg = "性别必须为f或者m!"

实际上，当用户输入的数据不能通过校验规则时将触发数据窗口控件的itemerror事件，该事件的返回值可以决定是否显示错误信息提示窗口。如果在itemerror事件中也编写了错误信息提示脚本，该脚本能够正常执行并且用validationgmsg属性定义的错误信息也会显示。

*计算域的属性

计算域除了具有上面介绍的属性外，还有一个重要属性Expression。使用这个属性可以根据用户的执行情况来更好地调整程序的动作，下面是其使用时的语法：

直接引用：dw_1.object.computename.expression

在函数modify和describe中："computename,expression{='string'}"

其中，computename是计算域的名称，string是字符串，它应该包含合法的表达式。如：

ls_setting = dw_1.object.comp_1.expression //获取表达式

ls_setting = dw_1.describe("comp_1.expression")

dw_1.object.comp_1.expression = "avg(salart for all)" //设置表达式

dw_1.modify("comp_1.expression = 'avg(salary for all)'")