PB数据窗口对象之Button

〓Button重要属性
*Action属性
该属性是Button控件最重要的一个属性。在数据窗口画板中，可以选择一个按钮有哪个动作。可选的动作都是事先定义好的，开发人员没有机会精确定义某个动作的执行，只能在运行时动态改变按钮的动作。
可以在设计时指定按钮的动作。在按钮属性窗口的General属性页，下拉列表框Action
中可以选择可用的动作。
在程序运行时可以使用Action属性来获取或者修改按钮的动作。该属性使用时的语法如
下：
直接引用：dw_1.object.buttonname.action
在函数Describe和Modify中："buttonname.action{='value'}"
其中，buttonname是要获取或者设置动作的按钮的名称；value是动作代码，可以是下拉列表框Action中的值。
代码 动作 解释 返回值
11 AppendRow 在最后增加一空白行 新增加行的行号
3 Cancel 取消使用了yield函数的检索过程 0
10 DeleteRow 如果按钮在detail带中则删除按钮 成功返回1，否则-1
，否则删除当前数据行。
9 Filter 显示Filter对话框， 过滤掉的数据行数。
并在指定条件后进行检索 如果发生错误则返回小于0的数
12 InsertRow 如果按钮在detail带中，则以按钮 新插入行的行号
所在行为参数插入数据，否则在当
前行插入一空白行
6 PageFirst 翻到第一页 成功返回1，否则返回-1
7 PageLast 翻到最后一页 最后一页中第一行的行号。
如果失败则返回-1
4 PageNext 翻到下一页 同上
5 PagePrior 翻到前一页 同上
16 Preview 进入、退出预览状态 0
17 PreviewWithRulers 打开或者关闭标尺 0
15 Print 打印一份数据窗口 0
20 QueryClear 删除where子句 0
18 QueryMode 进入、退出查询模式 0
19 QuerySort 指定查询时的排序规则 0
2 Retrieve 从数据库中检索数据 检索到的记录数
1 Retrieve(Yield) 从数据库中检索数据，并随时允许 检索到的记录数
用户终止
14 SaveRowsAs 以用户指定的格式保存数据 记录数
8 Sort 显示排序窗口并按指定规则排序 成功则返回1，否则-1
13 Update 将修改了的数据保存到数据库。修 成功则返回1，否则-1
改成功则自动执行commit，否则执
行rollback
0 UserDefined 允许为按钮的ButtonClicked和 用户脚本中定义的返回值
ButtonClicking事件编写脚本

*SuppressEventProcessing属性
SuppressEventProcessing属性用于是否触发ButtonClicked事件或者ButtonClicking事件。
语法格式是：
直接引用：dw_1.object.buttonname.suppresseventprocessing
在函数describe和modify中："buttonname.suppresseventprocessing{='value'}"
其中，value的取值为yes或者no，表示是否触发事件。如：
dw_1.object.b_name.suppresseventprocessing = 'yes'
dw_1.modify("b_name.suppresseventprocessing = 'no'")
ls_setting = dw_1.describe("b_name.suppresseventprocessing")

*Text属性
通过Text属性可以获取或者设置按钮上的文字。当运行时，如果要动态修改按狃的Action属性，就应该利用Text属性修改。该属性使用时的语法如下：
直接引用：dw_1.object.textname.text
在函数modify和describe中："textname.text{='string'}"
其中，string是一个字符串或者表达式，如果要给按钮设置快捷键，可以在字符串中使用&符号。如：
ls_setting = dw_1.object.text_1.text //获取按钮上的文字
ls_setting = dw_1.describe("text_1.text")
dw_1.object.text_1.text = "employee &Name" //给按钮设置文字，并有快捷键
dw_1.modify("text_1.text = 'employee &Name'")