forms builder开发form常用函数汇总

（1）abort_query：停止查询的执行。

（2）add_group_column（record group id 或 name，group column）：添加一个列到一个记录组，Record group id、name，column type，column width。

（3）add_group_row（record group id 或 name，row number）： 添加一个行到一个记录组，record group id是oracle赋予这个组的唯一的名称，row number指定了这个行在组中位置。

（4）add_list_element（list name or list id，list index，list lable，list value）：添加一项到下拉列表框，list name是list的名字，list index是添加到列表框的索引，list label指定了放入列表中的数值串，list value包含了列表标识所对应的数据库的数值。

（5）add_parameter（list或name，parameter，parameter type，value）添加一个参数到一个参数列表，参数列表是一个变数列表，这些变量将被伟给其它对象，list或name指定了这个列表的标识，parameter type（参数类型）包含两种可用数值：text_type是一串字符。

（6）data_parameter是一个指定已在form中定义的记录组的串，value是传给被调模块的实际数值。

（7）application_parameter促使oracle显示Enter parameter values对话框，关联了当前菜单form的参数按其数值被显示。

（8）background_menu（1。。。10）：从背景菜单中显示一个菜单项。

（9）bell：促使终址产生一个鸣叫（要有音响或耳机才能听）。

（10）block_menu：显示一个数值的列表，它包括有效块的名字和它们的序列号。

（11）break：停止form的执行，显示调试器。注：只能在调试模式时。

（12）call_input：接受并执行功能键输入。

（13）checkbox_checked（name）：返回一个真或假的值表示检查框的状态。

（14）check_record_uniqueness：被on_check_unique触发器调用时，为检查主关键词的唯一性而被始化form过程。

（15）clear_block：从当前的块中清除记录。

（16）clear_eol：从光标开始到些行结束清除文本项的值。

（17）clear_form：清除form的所有记录。

（18）commit mode：参数具有的参数为（commit mode，rollback mode）。

（19）ask_commit：提示操作者提交记。

（20）do_commit：执行提交。

（21）no_commit：清除form并不提交记录。

（22）no_validate：提交未经有效检验的数据。

（23）clear_item（name）：清除指定的项。

（24）clear_list（name）：清除下拉列表的值。

（25）clear_message：清除信息提示区域中所有的信息。

（26）clear_record：清除当前记录中的所有值。

（27）close_form（name）：关闭当前form，其它的form通过指定的name关闭。

（28）commit_form：使form中的值改修数库库的的表。

（29）convert_other_value（name）：改变下接列表框，圆形按钮组，检查框的值为符合当前项状态的值。

（30）copy（variable 1，variable 2）：拷贝值从变量1到变量2。

（31）count_query：使用oncount触发器标明查询所获取的记录数。

（32）create_group（record group name）：创建静态或无查询记录组，创建后可用子程序。

（33）populate_group_with_query

（34）add_group_column，add_group_row：来向组添加记录。

（35）create_group_from_query：（按指定select语句创建记录组，record group name，select statement）。

（36）create_parameter_list（list name）：创建参数列表，可用子程序:add_parameter来添加参数。

（37）paraneter list（参数列表）：经常被作为依据传给run_product，call_form，new_form子程序。

（38）create_queried_record：当使用on_fetch触发器时，在块主录缓存中创建记录。缓存存放着那些未被显示的记录。

（39）create_record：在当前块中创建一条记录。

（40）create_time（time name，milliseconds，iterale）：创建一个定时器。milliseconds（秒）块定每个循环的分配时间。参数iterate有两个选项：repeat：默认，告诉定时器在完成一次计时后重复。on_repeat，完成一次计时后不重复。

（41）cut_region：剪切选中的文本并保存于剪切板中。

（42）dbms_err_code：获并显示最后的数据库错误代码。

（43）dbms_error_text：显示数据库错误类型信息和文字信息。

（44）debug_mode：开启或关闭调试模式，这种模式只用于菜单模块。

（45）default_value（literal，variable）：如果当前值为null，则放置文字符串literal到variable中。

（46）delete_group（name）：删除记录组。

（47）delete_group_row（name，row，number）：从记录组中删除标出的行。

（48）delete_list_element（name，list index）：删除下接列表中的一项，索引为list index。

（49）delete_parameter（name，parameter）：从参数列表中删除指定参数。

（50）delete_record：删除当前记录。

（51）delete_time（name）：删除记时器。

（52）destroy_paramter_list（name）：删除一个预定的被调参数列表，name即为列表名称。

（53）do_key（内置子程序名）：模拟按下以子程序命名的功能键。

（54）duplicate_item：从上一记录中拷贝相同项的值到当前记录的项中。

（55）duplicate_record：从上一记录中拷贝每个项到当前记录的对应项中。

（56）edit_textitem（x，y[，高度，宽度]）：为当前文本项显示一个编辑器。

（57）enforce_column_security：促使应用检查列的安全性。

（58）enter：对当前项检查期有效性。

（59）enter_query：改form的模式为enter query。

（60）erase（全局变量名）：从内存中消去指定的全局变量。

（61）error_code：捕获并且显示oracle forms的错误序号。

（62）error_text：显示解释form错误的文字信息。

（63）error_type：显示错误的类型。frm说明forms错误，ora说明是数据库错误。

（64）execute_query：使oracle提取记录到form中，并置form于更新模式。

（65）execute_trigger（触发器名）：执行指定的触发器。

（66）fetch_records：启动将记录提取到form中。

（67）find_block（块名）：查找块的ID。

（68）find_canvas（画板名）：查找画板名的ID。

（69）find_column（记录组，组列名）：查找组列的ID。

（70）find_editor（编辑器名）：查找编辑器的ID。

（71）find_form（form名）：查找form的ID。

（72）find_group（记录组名）：查找记录组的ID。

（73）find_item（项名）：查找项名的ID。

（74）find_menu_item（菜单项名）：查找菜单项的ID。

（75）find_relation（关系名）：查找关系的ID。

（76）find_time（time名）：查找time的ID。

（77）find_view（canvas-view名）：查找画布的ID。

（78）find_window（窗口名）：查找窗口的ID。

（79）first_record：显示第一条记录。

（80）form_failire：返回表示最后一个form执行结果的布尔值。

（81）form_fatal：返回表示最后一个执行结果的布尔表达式。成功或失败返回false致命的错误才返回true。

（82）form_success：返回表示最后执行结果的布称表达式。成功返回true，失败或致命错误返回false。

（83）forms_ddl（statement）：操作form过程中执行sql命令，命令语句可以是文字，dml，ddl或代表pl/sql代码块的表达式。

（84）forms_ole activate_server（id）：启动一个ole服务器使其准备接受ole自动事件。

（85）forms_ole close_server（id）：关闭一个ole服务器使期切断与各个ole容器的连接。

（86）forms_ole exec_verb（id，verb name）：告诉ole服务器执行邮verb id 或name标明的执行命令。

（87）forms_ole find_ole_verb（id，verb name）：返回ole verb的索引值。

（88）forms_ole get_interface_pointer（name）：标识一个ole2自动执行对象的句柄。

（89）forms_ole get_verb_count（id）：标识出ole服务器所能识别的命令数量。

（90）forms_ole initialize_container（id，file name）：当服务器兼容时，添加一个ole对象到ole容器中。

（91）generate_sequence_number：当序列被定义为项属性的默认值时启动产生这个序号。

（92）get_application_property（property name）：为当前form的属性定义数值。

（93）get_block_property（name，property）：返回块属性值。

（94）get_canvas_property（name，property）：返回画布属性值。

（95）get_group_char_cell（group column id，row number）：指定一个字符或者记录组单元的字符串。单元是一个行/列交叉点。

（96）get_form_property（name，property）：返回指定的forms的属性值。

（97）get_group_date_cell（group column id，row number）：指定一个记录组单元的日期值，单元是一个行/列交叉点。

（98）get_group_number_cell（group column id，row number）：指定一个记录组单元的数字值，单元是一个行/列交叉点。

（99）get_group_row_count（group name）：标识指定记录组中的行号。

（100）get_group_selection（name，selection number）：标识指定记录组中行的数字位置。

（101）get_group_selection_count（name）：指定自动标定为选中行的总数。

（102）get_item_property（name，property）：返回项属性值。

（103）get_list_element_count（list name）：指定下接列表框内的值的总个数。

（104）get_list_element_label（list name，list_index）：标识选中的下拉列表框内项的标识名称。

（105）get_list_element_value（list name，list_index）：标识选中的下拉列表框内项的实际值。

（106）get_lov_property（name，property）：标识不同的数值属性设定列表。

（107）get_menu_item_property（menu name，property）：标识选中的菜单项的状态。选项为:checked，enabled和labeled。

（108）get_message：显示当前的信息。

（109）get_parameter_list（list name）：为指定的列表定义参数列表ID。

（110）get_parameter_attr（listname，参数名，参数类型，数值）：标识被选参数列表中参数的类型的数值。

（111）data_parameter：表示此值是组的名称。

（112）text_parameter：表明参数值是一个实际数据值。

（113）get_radio_button_property（item name，button name，property）：标识选中的圆形按钮属性。

（114）get_record_property（record number，block name，property）：标识指定记录的状态。被支持的属性为：status。不同的状态值是：new，changed，query，insert。

（115）get_view_property（view name，property）：标识指定视图属性的值。属性为：display_x_pos，display_y_pos，height，visible，width，window_name，x_pos_on_canvas，y_pos_on_canvas。

（116）get_window_property（window name，property）：标识指定窗口属性的值，属性为:height，remove_on_exit，title，visible，width，window_handle，window_size，window_state，x_pos。

（117）go_block（name）：定位到指定的块。

（118）go_item（name）：定位到指定的项。

（119）go_form（name）：定位到指定的form。

（120）go_record（记录号）：定位到指定的记录。

（121）help：显示当前项的提示信息。

（122）hide_menu：在字符模式平台上操作时，使当前菜单消失。

（123）hide_view（name）：使指定的视图消失。

（124）hide_window（name）：使指定的窗口消失。

（125）host（系统命令，屏幕操作）：执行指定的操作系统命令。

（126）id_null（对象id）：若指定的对象是有效的则返回真，事则返回假。

（127）image_zoom（image_id，zoom类型，zoomfactor）：改变由zoomin/out产生的可视图像大小。

（128）selection_rectangle，zoom_in_factor，zoom_percent，zoom的系数是百分比。

（129）insert_record：将当前记录添回到数据库中。

（130）issue_rollback（savepoint名）：执行rollback命令，savepoint name是指数据被提交的最后时间。

（131）issue_savepoint（savepoint名）：执行一个保存动作。

（132）item_enabled（菜单名，项名）：当菜单项有效时返回一个真值，不则值为假。

（133）last_record：显示记录缓存中最后记录。

（134）list_value（参数值）：显示当前项值的列表，参数值是：on_restrict，它告诉form不要使用自动查找和完整模式；与其相反的是restrict。

（135）lock_record：锁定数据库中的相应行。

（136）logon（用户名，口令显示登录屏幕错误信息）：使form连接到oracle数据库上。在登录屏幕参数设定上设定true会使oracle在子程序连接数据库失败时显示登录屏幕。

（137）logon_screen：显示数据库登录屏幕。

（138）logout：退出数据库登录。

（139）main_menu：显示应用主菜单。

（140）menu_clear_field：删除当前项到光标右边的字符。

（141）menu_next_field：移动光标到输入参数值对话框中下一项上。

（142）menu_parameter：显示输入参数值对话框中所有当前菜单参数的值。

（143）menu_previous_field：移动光标到输入参数值对话框中前一项上。

（144）menu_redisplay：在菜单刷新屏幕。

（145）menu_show_keys：显示功能键对话框。

（146）message（信息字符，返回响应）：在信息栏上放置指定信息，它有两个参数:acknowledge显示一个提醒操作者不可忽视的模块；no_acknowledge，告诉oracle两个信息被送出后不需要返回响应。

（147）message_code：指定当前生成信息的个数。

（148）message_text：指定当前生成信息的文字。

（149）message_type：指定当前生成信息的类型。

（150）move_window（window name，x，y）：移动窗口。

（151）name_in（variable）：为指定变量定义数值。

（152）next_block：移动到下一个块。

（153）next_form：移动到下一个form。

（154）next_item：移动到下一个项。

（155）next_key：移动到下一个关键词项，这个关键词必须是光标可移向的，有效的。

（156）next_menu_item：移动到下一个菜单项。

（157）next_record：移动到下一条记录。

（158）next_set：从数据库获取下一记录集并将光标指向第一个记录。

（159）paste_region：粘贴剪切板内容到游标处。

（160）pause：停止form进程直到用户按下一个功能键。

（161）populate_group（组名）：执行记录组查询，返回一个数字表明成功（0），非（0）表失败。

（162）populate_group_with_query（记录组id或名称查询）：用查询结果重置记录组的一个记录行。

（163）populate_list（list name，record group id）：用指定记录组的数值来重置下拉列表。

（164）post：从form传送数据到数据库，无须提交。

（165）previous_block：移动光标到前一个块。

（166）previous_form：移动光标到前一个form。

（167）previous_item：移动光标到前一个项。

（168）previous_menu：移动光标到前一个菜单。

（169）previous_menu_item：移动光标到前一个菜单项。

（170）previous_record：移动光标到前一条记录。

（171）print：执行当前窗口的屏幕打印。

（172）query_parameter（parameter literal）：显示包含指定参数值的query parameter对话框。

（173）read_image_file（文件名，檔类型，项名）：显示forms图像项所对应的文件。

（174）redisplay：清除现存屏幕并重新启动屏幕。

（175）replace_content_view（window name，view name）：在当前窗口中改变画板_视图的内容。

（176）replace_menu（菜单文件名，菜单类型，初始化菜单名，用新菜单代替当前菜单组名，use_file）。

（177）rest_group_selection（record group id或record group name）：取消组中行记录的当前选定。

（178）resize_window（window id，宽，高）：改窗口大小到指定的设置。

（179）retrieve_list（list name，record group name）：保存当前列表到指定的记录组中。

（180）run_product（oracle产品，文件，通讯style，executi on style，location， 启动指定的oracle软件产品并执行文件communications list ，display）：设为:synchronous告诉oracle在新软件关闭后返回form控制asynchronous告诉oracle立即返回forms控制，执行设定是:batch，runtime。定位设定决定了产品要执行的文件的位置。list或name变量决定了要传给产品的参数列表。display变数指定了由graphics生成的forms图表的名称。

（181）scroll_down：从记录缓存中显示下一个记录集。

（182）scroll_up：从主录缓存中显示前一个记录集。

（183）scroll_view（view name，x，y）：修改x，y画板坐标属性设定来重设视图的位置。

（184）select_all：全选当前项中的文本。

（185）set_alert_property（alert name，alert_message_text，message）：修改显示于报警提示中的文字信息。报警信息属性是alert_message_text（第二个参数）。

（186）set_application_property（property，setting）：改变当前应用的属性。属性为：cursor_style。其值为:busy，crosshair，default，help，insertion。

（187）set_block_property（block name，property，value）：改变块属性。

（188）set_canvas_property（canvas name，property，value或[x，y]）：改变画板属性。

（189）set_form_property（form name，property，value）：改变form属性。

（190）set_group_char_cell（组列名或id，行号，数值）：改变一个字符组单元的值。

（191）set_group_data_cell（组列名或id，行号，数值）：改变一个数据组单元的值。

（192）set_group_number_cell（组列名或id，行号，数值）：改变一个数字组单元的值。

（193）set_group_selection（记录组名或id，行号）：选中或定位到指定的记录组的一行。

（194）set_input_focus（菜单）：改变输入点到当前的form菜单上。

（195）set_item_property（项名，属性，值或[x，y]）：改变项属性。

（196）set_lov_property（名称，属性，值或[x，y]）：改变值列表属性。

（197）set_menu_item_property（菜单项id，属性，值）：改变菜单项属性。

（198）set_parameter_attr（列表或名称，参数，参数类型，值）：改变参数列表中指定的参数的类型和数值。

（199）set_record_property（记录号，块名，属性，数值）：改变指定记录的状态属性，属性值为:changed_status，insert_status，new_status，query_status。

（200）set_relation_property（relation id工名称，属性，数值）：改变指定关系的属性。

（201）set_view_property（view name，property ，vlalue[x，y]）：修改view的属性。

（202）set_timer（定时器id，毫秒，反复）：修改定时器的设定。

（203）set_window_property（name，property，value[x，y]）：修改窗口的属性。

（204）show_alert（name）：启动指定的警报器并返回对应所选按钮的数值。

（205）show_ackground_menu：展示背景菜单。

（206）show_editor（编辑器名字，text in[x，y]optional，tex tount，result）：在指定位置启动编辑器，将一串文字伟入/出编辑器。

（207）show_keys：展现form功能键对话框。

（208）show_lov（name，[x，y]）：显示指定的数值列表，这个内置子程序返回一个布尔值，它将被作为等式的一部分（比如:a=show_lov（lov_name）。

（209）show_menu：启动并显示当前菜单。

（210）show_view（name）：显示指定的画板或视图。

（211）show_window（name，[x，y]）：在x，y坐标上显示指定的窗口。

（212）synchronize：仅在如下两个条件满足时允许oracle修改显示，已经完成对新画板或视图的定位并form是处于项的级别之上。

（213）terminate：停止向form或对话框输入数据。

（214）unset_group_selection（记录组名，行号）：取消由set_group_selection所作的行的选定。

（215）up：从记录缓存中显示前一个记录。

（216）update_record：使form通过form的修改进行数据库更改。

（217）user_exit（表达式，错误文字）：启用包含在表达式参数中的用户退出程序。

（218）validate（参数）：使form执行基于参数范围的有效的过程。参数为:default_scope，form_scope，record_scope，item_scope。

（219）vbx fire_event（itemname，事件，参数表list id或名称） 为vbx控件进行事件的启动。

（220）vbx get_property（item name或名称，属性）：标识vbx控件属性的值。

（221）vbx get_value_property（name，属性）：标识vbx控件的vbx控制属性值。

（222）vbx invoke_method（name，方法名，w，x，y，z）：执行包含在项的方法名中的中间项。

（223）vbx set_value_property（name，属性）：更改指定的vbx控件数值属性。

（224）where_display：更改where菜单光标移动选项的数值，值为on，off。

（225）write_image_file（图像文件，文件类型，名称）：从oracle forms的图像项存放图像到文件中。

PS：本文转自“Oracle EBS”的“Forms Builder常用函数”一文，只做学习交流之用。