Oracle - form - builder内置函数说明

1 / 20

abort_query; 停止查询的执行

add_group_column(record group id 或 name,group column 添加一个列到一个记录组，Record group id name,column type,column width);

add_group_row(record group id 或 name,row number);

add_list_element(list name or list id,

list index,list lable,list value);

add_parameter(list或name,parameter,parameter type,value)

application_parameter

background_menu (1...10);

添加一个行到一个记录组，record group id是oracle赋 予这个组的唯一的名称，row number指定了这个行在组中 位置. 添加一项到下拉列表框,list name是list的名字,list index 是添加到列表框的索引，list label指定了放入列表中的数值 串,list value包含了列表标识所对应的数据库的数值. 添加一个参数到一个参数列表,参数列表是一个变量列表,这些 变量将被伟给其他对象，list或name指定了这个列表的标识, parameter type(参数类型)包含两种可用数值：

text_type是一串字符;data_parameter是一个指定已在form 中定义的记录组的串.value是传给被调模块的实际数值. 促使oracle显示Enter parameter values对话框。关联了 当前菜单form的参数按其数值被显示。 从背景菜单中显示一个菜单项 2 / 20

bell; 促使终址产生一个鸣叫(要有音响或耳机才能听以哦！)

block_menu; 显示一个数值的列表，它包括有效块的名字和它们的序 列号

break;

call_input;

checkbox_checked(name);

check_record_uniqueness

clear_block

clear_eol;

clear_form

(commit mode,rollback mode)

clear_item(name);

停止form的执行，显示调试器.注:只能在调试模式时 接受并执行功能键输入; 返回一个真或假的值表示检查框的状态 被on_check_unique触发器调用时，为检查主关键字的唯 一性而被始化form过程. 人当前的块中清除记录. 从光标开始到些行结束清除文本项的值。 清除form的所有记录。commit mode 参数具有的参数为 ask_commit提示操作者提交记录;do_commit扫行提交; no_commit清除form并不提交记录.no_validate提交 未经有效检验的数据. 清除指定的项. 3 / 20

clear_list(name); 清除下拉列表的值

clear_message; 清除信息提示区域中所有的信息

clear_record;

close_form(name)

commit_form;

convert_other_value(name)

copy(variable 1,variable 2);

count_query;

create_group(record group name);

create _group_from_queryny( record group name,select statement);

清除当前记录中的所有值. 关闭当前form，其它的form通过指定的name关闭. 使form中的值改修数库库的的表. 改变下接列表框，圆形按钮组，检查框的值为符合当前项状态的值. 拷贝值从变量1到变量2; 使用oncount触发器标明查询所获取的记录数. 创建静态或无查询记录组，创建后可用子程序： populate_group_with_query,

add_group_column,add_group_row来向组添加记录 按指定select语句创建记录组. 4 / 20

create_parameter_list(list name); 创建参数列表，可用子程序:add_parameter来添加 参数。paraneter list（参数列表）经常被作为依 据传给run_product,call_form,new_form子程序.

create_queried_record;

create_record;

create_time(time name,milliseconds,iterale);

cut_region

dbms_err_code

dbms_error_text

debug_mode

default_value(literal, variable);

delete_group(name)

当使用on_fetch触发器时，在块主录缓存中创建记录. 缓存存放着那些未被显示的记录 在当前块中创建一条记录. 创建一个计时器。milliseconds(秒)块定每个循环的

分配时间。参娄iterate有两个选项:repeat：默认，告诉 计时器在完成一次计时后重复;on_repeat,完成一次计时后不重复.

剪切选中的文本并保存于剪切板中. 获并显示最后的数据库错误代码 显示数据库错误类型信息和文字信息 开启或关闭调试模式,这种模式只用于菜单模块. 如果当前值为null，则放置文字串literal到variable中. 删除记录组. 5 / 20

delete_group_row(name,row,number); 从记录组中删除标出的行。

delete_list_element(name,list index); 删除下接列表中的一项.索引为list index

delete_parameter(name,parameter);

delete_record

delete_time(name)

destroy_paramter_list(name);

do_key(内置子程序名)

duplicate_item

duplicate_record

edit_textitem(x,y[,高度,宽度])

enforce_column_security

enter

enter_query

从参数列表中删除指定参数。 删除当前记录; 删除记时器 删除一个预定的被调参数列表，name即为列表名称 模拟按下以子程序命名的功能键; 从上一记录中拷贝相同项的值到当前记录的项中. 从上一记录中拷贝每每个项到当前记录的对应项中 为当前文本项显示一个编辑器(很有意思的咧!) 促使应用检查列的安全性. 对当前项检查期有效性 改form的模式为enter query

6 / 20

erase(全局变量名); 从内存中消去指定的全局变量;

error_code; 捕获并且显示oracle forms的错误序号

error_text;

error_type;

execute_query

execute_trigger(触发器名)

fetch_records;

find_block(块名);

find_canvas(画板名);

find_column(记录组，组列名);

find_editor(编辑器名);

find_form(form名);

find_group(记录组名);

显示解释form错误的文字信息 显示错误的类型.frm说明forms错误,ora说明是数据库错误 使oracle提取记录到form中,并置form于更新模式 执行指定的触发器 启动将记录提取到form中 查找块的ID. 查找画板名的ID. 查找组列的ID. 查找编辑器的ID. 查找form的ID. 查找记录组的ID. 7 / 20

find_item(项名) 查找项名的ID.

find_menu_item(菜单项名); 查找菜单项的ID.

find_relation(关系名);

find_time(time名);

find_view(canvas-view名);

find_window(窗口名);

first_record;

form_failire

form_fatal

form_success;

forms_ddl(statement);

forms_ole.activate_server(id); 查找关系的ID. 查找time的ID. 查找画布的ID. 查找窗口的ID. 显示第一条记录 返回表示最后一个form执行结果的布尔值 返回表示最后一个执行结果的布尔表达式。成功或失败返回false 致命的错误才返回true 返回表示最后执行结果的布称表达式。成功返回true,失败或致命 错误返回false 操作form过程中执行sql命令,命令语句可以是文字，dml,ddl或代 表pl/sql代码块的表达式. 启动一个ole服务器使其准备接受ole自动事件

8 / 20

forms_ole.close_server(id); 关闭一个ole服务器使期切断与各个ole容器的连接

forms_ole.exec_verb(id,verb name); 告诉ole服务器执行邮verb id 或name标明的执行命令;

forms_ole.find_ole_verb(id,verb name)

forms_ole.get_interface_pointer(name);

forms_ole.get_verb_count(id);

forms_ole.initialize_container(id,file name);

generate_sequence_number

get_application_property(property name);

get_block_property(name,property)

get_canvas_property(name,property);

get_group_char_cell(group column id,row number);

get_form_property(name,property);

get_group_date_cell(group column id,row number);

返回ole verb的索引值 标识一个ole2自动执行对象的句柄; 标识出ole服务器所能识别的命令数量 当服务器兼容时，添加一个ole对象到ole容器中 当序列被定义为项属性的默认值时启动产生这个序号 为当前form的属性定义数值 返回块属性值 返回画布属性值 指定一个字符或者记录组单元的字串。单元是一个行/列交叉点。 返回指定的forms的属性值 指定一个记录组单元的日期值，单元是一个行/列交叉点 9 / 20

get_group_number_cell(group column id,row number); 指定一个记录组单元的数字值，单元是一个行/列交叉点

get_group_row_count(group name); 标识指定记录组中的行号

get_group_selection(name,selection number);

get_group_selection_count(name);

get_item_property(name,property);

get_list_element_count(list name);

get_list_element_label(list name,list_index);

get_list_element_value(list name,list_index);

get_lov_property(name,property);

get_menu_item_property(menu name,property);

get_message;

get_parameter_list(list name); get_parameter_attr(listname,参数名，参数类型，数值); 标识指定记录组中行的数字位置 指定自动标定为选中行的总数 返回项属性值 指定下接列表框内的值的总个数 标识选中的下拉列表框内项的标识名称

标识选中的下拉列表框内项的实际值 标识不同的数值属性设定列表 标识选中的菜单项的状态。选项为:checked,enabled和labeld 显示当前的信息 为指定的列表定义参数列表ID

标识被选参数列表中参数的类型的数值。参数类型为： data_parameter：表示此值是组的我称；

text_parameter:表明参数值是一个实际数据值

10 / 20

get_radio_button_property(item name,button name,property);

标识选中的圆形按钮属性.

get_record_property(record number,block name,property); 标识指定记录的状态。被支持的属性为：status.不同的状态值 是：new,changed,query,insert

get_view_property(view name,property);

get_window_property(window name,property);

go_block(name);

go_item(name);

go_form(name);

go_record(记录号);

help;

hide_menu

hide_view(name)

hide_window(name); 标识指定视图属性的值。属性为：display_x_pos,display_y_pos,height, visible,width,window_name,x_pos_on_canvas,y_pos_on_canvas 标识指定窗口属性的值,属性为:height,remove_on_exit,title,visible, width,window_handle,window_size,window_state,x_pos; 定位到指定的块 定位到指定的项 定位到指定的form 定位到指定的记录 显示当前项的提示信息 在字符模式平台上操作时，使当前菜单消失 使指定的视图消失 使指定的窗口消失

11 / 20

host(系统命令，屏幕操作); 执行指定的操作系统命令

id_null(对象id); 若指定的对象是有效的则返回真，事则返回假

image_zoom(image_id,zoom类型,zoomfactor);

insert_record

issue_rollbaco(savepoint名);

issue_savepoint(savepoint名);

item_enabled(菜单名,项名);

last_record;

list_value(参数值)

lock_record;

logon(用户名,口令显示登录屏幕错误信息)

改变由zoomin/out产生的可视图像大小,它的类型有：adjust_tofit, selection_rectangle,zoom_in_factor,zoom_percent,zoom的系数 是百分比. 将当前记录添回到数据库中 执行rollback命令,savepoint name是指数据被提交的最后时间 执行一个保存动作 当菜单项有效时返回一个真值，不则值为假 显示记录缓存中最后记录 显示当前项值的列表。参数值是:on_restrict,它告诉form不要 使用自动查找和完整模式；与其相反的是restrict. 锁定数据库中的相应行. 使form连接到oracle数据库上。在登录屏幕参数设定上设定true 会使oracle在子程序连接数据库失败时显示登录屏幕. 12 / 20

logon_screen; 显示数据库登录民幕

logout; 退出数据库登录;

main_menu;

menu_clear_field;

menu_next_field;

menu_parameter;

menu_previous_field;

menu_redisplay;

menu_show_keys;

message(信息字符，返回响应);

message_code;

message_text;

显示应用主菜单 删除当前项到光标右边的字符 移动光标到输入参数值对话框中下一项上. 显示输入参数值对话框中所有当前菜单参数的值 移动光标到输入参数值对话框中前一项上. 在菜单刷新屏幕 显示功能键对话框 在信息栏上放置指定信息，它有两个参数:acknowledge 显示一个提醒操作者不可忽视的模块；no_acknowledge 告诉oracle两个信息被送出后不需要返回响应; 指定当前生成信息的个数 指定当前生成信息的文字 13 / 20

message_type; 指定当前生成信息的类型

move_window(window name,x,y); 移动窗口

name_in(variable);

next_block;

next_form;

next_item;

next_key;

next_menu_item;

next_record;

next_set;

paste_region;

pause;

populate_group(组名); 为指定变量定义数值 移动到下一个块 移动到下一个form 移动到下一个项 移动到下一个关键字项，这个关键字必须是光标可移向的 ，有效的 移动到下一个菜单项 移动到下一条记录 从数据库获取下一记录集并将光标指向第一个记录 粘贴剪切板内容到光标处 停止form进程直到用户按下一个功能键 执行记录组查询，返回一个数字表明成功(0),非(0)表失败

14 / 20

populate_group_with_query(记录组id或名称查询) 用查询结果重置记录组的一个记录行

populate_list(list name,record group id); 用指定记录组的数值来重置下拉列表

post;

previous_block;

previous_form;

previous_item;

previous_menu;

previous_menu_item;

previous_record;

print;

query_parameter(parameter literal);

read_image_file(文件名,文件类型,项名);

redisplay;

从form传送数据到数据库，无须提交 移动光标到前一个块 移动光标到前一个form 移动光标到前一个项 移动光标到前一个菜单 移动光标到前一个菜单项 移动光标到前一条记录 执行当前窗口的屏幕打印 显示包含指定参数值的query parameter对话框显示forms图像项所对应的文件 清除现存屏幕并重新启动屏幕 15 / 20

replace_content_view(window name,view name); 在当前窗口中改变画板_视图的内容

replace_menu(菜单文件名，菜单类型，初始化菜单名， 用新菜单代替当前菜单 组名，use_file);

rest_group_selection(record group id或record group name);

resize_window(window id,宽,高);

retrieve_list(list name,record group name);

run_product(oracle产品,文件,通讯style,executi on style,location, list ,display);

scroll_down;

scroll_up;

scroll_view(view name,x,y);

select_all;

取消组中行记录的当前选定 改窗口大小到指定的设置 保存当前列表到指定的记录组中

启动指定的oracle软件产品并执行文件communications

设定为:synchronous告诉oracle在新软件关闭后返回form控制 asynchronous告诉oracle立即返回forms控制,执行设定是:batch, runtime.定位设定决定了产品要执行的文件的位置;list或name 变量决定了要传给产品的参数列表。display变量指定了由 graphics生成的forms图表的名称. 从记录缓存中显示下一个记录集 从主录缓存中显示前一个记录集 修改x,y画板坐标属性设定来重设视图的位置 全选当前项中的文本

16 / 20

set_alert_property(alert name,alert_message_text,message); 修改显示于报警提示中的文字信息。报警信息属性是 alert_message_text(第二个参数);

set_application_property(property,setting); 改变当前应用的属性。属性为：cursor_style.其值为:

set_block_property(block name,property,value);

set_canvas_property(canvas name,property,value或[x,y]);

set_form_property(form name,property,value);

set_group_char_cell(组列名或id,行号,数值);

set_group_data_cell(组列名或id,行号,数值);

set_group_number_cell(组列名或id,行号,数值);

set_group_selection(记录组名或id,行号);

set_input_focus(菜单);

set_item_property(项名,属性,值或[x,y]);

set_lov_property(名称,属性,值或[x,y]);

busy,crosshair,default,help,insertion 改变块属性 改变画板属性 改变form属性

改变一个字符组单元的值 改变一个数据组单元的值 改变一个数字组单元的值 选中或定位到指定的记录组的一行 改变输入点到当前的form菜单上 改变项属性 改变值列表属性 17 / 20

set_menu_item_property(菜单项id,属性,值); 改变菜单项属性

set_parameter_attr(列表或名称,参数,参数类型,值); 改变参数列表中指定的参数的类型和数值.

set_record_property(记录号,块名,属性,数值);

set_relation_property(relation id工名称,属性,数值);

set_view_property(view name,property ,vlalue[x,y]);

set_timer(计时器id,毫秒,反覆);

set_window_property(name,property,value[x,y]);

show_alert(name);

show_ackground_menu;

show_editor(编辑器名字,text in[x,y]optional,tex tount,result);

show_keys;

show_lov(name,[x,y]);

改变指定记录的状态属性,属性值为:changed_status,i insert_status,new_status,query_status 改变指定关系的属性 修改view的属性

修改计时器的设定. 修改窗口的属性 启动指定的警报器并返回对应所选按钮的数值 展示背景菜单 在指定位置启动编辑器,将一串文字伟入/出编辑器 展现form功能键对话框 显示指定的数值列表,这个内置子程序返回一个布尔 值,它将被作为等式的一部分(比如:a=show_lov(lov_name) 18 / 20

show_menu; 激活并显示当前菜单

show_view(name); 显示指定的画板或视图

show_window(name,[x,y]);

synchronize;

terminate;

unset_group_selection(记录组名,行号)

up;

update_record;

user_exit(表达式,错误文字);

validate(参数);

vbx.fire_event(itemname,事件,参数表list id或名称)

vbx.get_property(item name或名称,属性);

在x,y坐标上显示指定的窗口 仅在如下两个条件满足时允许oracle修改显示:已经

完成对新画板或视图的定位并form是处于项的级别之上 停止向form或对话框输入数据. 取消由set_group_selection所作的行的选定 从记录缓存中显示前一个记录 使form通过form的修改进行数据库更改 启用包含在表达式参数中的用户退出程序 使form执行基于参数范围的有效的过程.参数为: default_scope,form_scope,record_scope,item_scope 为vbx控件进行事件的启动 标识vbx控件属性的值 19 / 20

vbx.get_value_property(name,属性); 标识vbx控件的vbx控制属性值

vbx.invoke_method(name,方法名,w,x,y,z); 执行包含在项的方法名中的中间项

vbx.set_value_property(name,属性); 更改指定的vbx控件数值属性

where_display; 更改where菜单光标移动选项的数值,值为on,off

write_image_file(图像文件,文件类型,名称) 从oracle forms的图像项存放图像到文件中

Do_key()这里说明一下，它的作用是执行某个key-xxxx 即按键动作，在6i下，有如下一些动作：

Built-in Key Trigger Associated Function Key

-------------------------------------------------------------------------------- BLOCK_MENU Key-MENU [Block Menu] CLEAR_BLOCK Key-CLRBLK [Clear Block] CLEAR_FORM Key-CLRFRM [Clear Form] CLEAR_RECORD Key-CLRREC [Clear Record] COMMIT_FORM Key-COMMIT [Commit]

COUNT_QUERY Key-CQUERY [Count Query Hits] CREATE_RECORD Key-CREREC [Insert Record] DELETE_RECORD Key-DELREC [Delete Record] DOWN Key-DOWN [Down] DUPLICATE_ITEM Key-DUP-ITEM [Duplicate Item] DUPLICATE_RECORD Key-DUPREC [Duplicate Record] EDIT_TEXTITEM Key-EDIT [Edit]

20 / 20

ENTER Key-ENTER [Enter] ENTER_QUERY Key-ENTQRY [Enter Query] EXECUTE_QUERY Key-EXEQRY [Execute Query]

EXIT_FORM Key-EXIT [Exit/Cancel] HELP Key-HELP [Help] LIST_VALUES Key-LISTVAL [List]

LOCK_RECORD Key-UPDREC [Lock Record] NEXT_BLOCK Key-NXTBLK [Next Block] NEXT_ITEM Key-NEXT-ITEM [Next Item]

NEXT_KEY Key-NXTKEY [Next Primary Key Fld] NEXT_RECORD Key-NXTREC [Next Record]

NEXT_SET Key-NXTSET [Next Set of Records] PREVIOUS_BLOCK Key-PRVBLK [Previous Block] PREVIOUS_ITEM Key-PREV-ITEM [Previous Item] PREVIOUS_RECORD Key-PRVREC [Previous Record] PRINT Key-PRINT [Print] SCROLL_DOWN Key-SCRDOWN [Scroll Down] SCROLL_UP Key-SCRUP [Scroll Up] UP Key-UP [Up]

本文来源：https://www.bwwdw.com/article/5kwd.html