1074
Forms t Reference Manual Release 4.5

Forms 4.5 Reference Manual, Vol. 1 and 2

Embed Size (px)

Citation preview

Formst Reference Manual

Release 4.5

*A32507-2* *A32507-2*A325072

Formst Reference Manual

Release 4.5

Volume 1

Formst Reference ManualRelease 4.5Part No. A325092

Forms Reference Manual, Release 4.5 Part No. A325092 Copyright E Oracle Corporation 1994 All rights reserved. Printed in the U.S.A. Contributing Authors: Ken Chu, Gina Lim Contributors: Mark Clark, Frank Dancs, Tim Eicher, Anusheel Kak, Donald King, Phil Kuhn, Kevin Mallory, Steve Muench, Rubik Sadeghi, Kam Yue This software was not developed for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It is the customers responsibility to take all appropriate measures to ensure the safe use of such applications if the programs are used for such purposes. This software/documentation contains proprietary information of Oracle Corporation; it is provided under a license agreement containing restrictions on use and disclosure and is also protected by copyright law. Reverse engineering of the software is prohibited. If this software/documentation is delivered to a U.S. Government Agency of the Department of Defense, then it is delivered with Restricted Rights and the following legend is applicable: Restricted Rights Legend Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of DFARS 252.2277013, Rights in Technical Data and Computer Software (October 1988). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065. If this software/documentation is delivered to a U.S. Government Agency not within the Department of Defense, then it is delivered with Restricted Rights, as defined in FAR 52.22714, Rights in Data General, including Alternate III (June 1987). The information in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is errorfree. ORACLE, SQL*Net, and SQL*Plus are registered trademarks of Oracle Corporation. Oracle Forms, Oracle Reports, Oracle Graphics, Oracle Book, Oracle Terminal, PL/SQL, and ORACLE7 are trademarks of Oracle Corporation. MS, MSDOS, Microsoft, and Windows are trademarks of Microsoft Corporation. All other products or company names are used for identification purposes only, and may be trademarks of their respective owners.

Preface

Prefacehe Forms Reference Manual, Volume 1, provides information necessary to help you use Forms 4.5. This preface includes the following topics:

T

Forms Documentation Set Audience Related Publications Typographic Conventions Your Comments Are Welcome

Preface

i

Forms Documentation SetThe documentation set for Forms Version 4.5 consists of the following documents:Document Forms Documentation Set, Version 4.5 Getting Started with Forms, Version 4.5 Forms Developers Guide, Version 4.5 Forms Advanced Techniques, Version 4.5 Forms Reference Manual, Version 4.5, Vol. 1 and Vol. 2 Forms Messages and Codes, Version 4.5 Part Number A32503 A32504 A32505 A32506 A32507 A32508

AudienceAll the manuals in the Forms Version 4.5 documentation set are written for the application developer.

Related PublicationsAs an application designer using Version 4.5 of Forms, you should also be familiar with the following documents:Document Procedure Builder Developers Guide Oracle Terminal Users Guide, Version 2.0 Oracle7 Server Messages and Codes Manual Oracle7 Server SQL Language Reference Manual, Version 7.0 PL/SQL Users Guide and Reference, Version 2.0 Forms documentation for your operating system Part Number A32485 A11700 A12379 778701292 800201292

ii

Forms Reference Manual

Typographic ConventionsThis manual uses the following typographic conventions to distinguish important elements from the body of the manual.

Function KeysForms function keys are represented by the key name enclosed in square brackets: [Next Item]. For key mappings for your particular keyboard type, refer to the following sources:

online Forms Show Keys screen (for most keyboards, [CtrlK]) the keypad diagram For more information on the keypad diagram, refer to the Forms documentation for your operating system.

Screen MessagesHint messages and error messages appear in a monotype font:This is a monotype font.

Preface

iii

Command and Example SyntaxCommands and examples appear in a monotype font, as follows: Syntax: Example:SET_CANVAS_PROPERTY( canvas_name, property, value); /* ** Builtin: SET_CANVAS_PROPERTY ** Example: Change the background color by setting the ** canvas color dynamically at runtime to the name ** of a visual attribute you created. */ BEGIN Set_Canvas_Property(my_main_cnv,VISUAL_ATTRIBUTE,blue_text); END;

Command and example syntax adhere to the following conventions: Convention UPPERCASE MONOTYPE plain monotype italic monotype underlined monotype ... Explanation Indicates a PL/SQL keyword or, if used within the parameter list for a builtin routine, a constant that you must enter exactly as spelled. Used for code fragments and examples. Indicates usersupplied items such as variables, exceptions, and actual parameters. Indicates a default parameter. If you indicate no parameter in a parameter set, Forms applies the default parameter. An ellipsis shows that statements or clauses were left out. The ellipsis can appear horizontally as shown, or in vertical format. A slash and asterisk begin a Cstyle comment. An asterisk and slash end a Cstyle comment. Two consecutive hyphens begin an ANSIstyle comment, which extends to the end of the line. Indentation helps show structure within code examples, but is not required.

/* */ indentation

iv

Forms Reference Manual

Case SensitivityAlthough neither PL/SQL nor Forms commands are case sensitive (that is, you can enter text in upper or lower case without restriction), in the documentation both upper and lower case are used for ease in reading. In syntax examples, builtin names are shown in all caps; userdefined values are shown in lower case. Syntax:SET_CANVAS_PROPERTY( canvas_name, property, value);

All caps. In code examples, PL/SQL reserved words (such as BEGIN, IF, THEN, ELSE, and END) and SQL commands (such as SELECT, WHERE, ORDERBY, and INTO) are shown in all caps. Properties, such as VISUAL_ATTRIBUTE, are also shown in upper case. Upper and lower case. Names of builtin procedures (Set_Canvas_Property) and system variables (System.Suppress_Working) are shown in upper and lower case. Lower case. Userdefined values (my_main_cnv) are shown in lower case. Example:/* ** Builtin: SET_CANVAS_PROPERTY ** Example: Change the background color by setting the ** canvas color dynamically at runtime to the name ** of a visual attribute you created. */ BEGIN Set_Canvas_Property(my_main_cnv,VISUAL_ATTRIBUTE,blue_text); END;

Syntax ExamplesThis example illustrates first how the syntax is presented in this manual, followed by an example of how you actually enter a builtin procedure into your triggers. Example Syntax: With Values: Example Syntax: With Values:SET_FORM_PROPERTY( formmodule_name, property, value); Set_Form_Property(my_form, savepoint_mode, PROPERTY_ON); SET_TIMER(timer_name, milliseconds, iterate); Set_Timer(my_timer, 12000, REPEAT);

Preface

v

Your Comments Are WelcomeWe value and appreciate your comments as an Oracle user and reader of the manuals. As we write, revise, and evaluate our documentation, your opinions are the most important input we receive. At the back of our printed manuals is a Readers Comment Form, which we encourage you to use to tell us what you like and dislike about this manual or other Oracle manuals. If the form is not available, please use the following address or FAX number. Forms Documentation Manager Oracle Corporation 500 Oracle Parkway Redwood City, CA 94065 U.S.A. FAX: 4155067200

vi

Forms Reference Manual

Contents

Chapter 1

Components and Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About Oracle Forms Components . . . . . . . . . . . . . . . . . . . . . . . . . . Starting Oracle Forms Components . . . . . . . . . . . . . . . . . . . . . . . . Logging In to the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . USERID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Runform Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Array (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Block_Menu (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Buffer_Records (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Debug (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Debug_Messages (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Help (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Keyin (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Keyout (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Logon_Screen (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OptimizeSQL (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OptimizeTP (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Options_Screen (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Output_File (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PECS (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Query_Only (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Quiet (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Session (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Statistics (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Term (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11 12 13 18 18 19 1 11 1 11 1 12 1 12 1 12 1 13 1 13 1 13 1 14 1 14 1 15 1 16 1 17 1 17 1 18 1 19 1 19 1 19 1 20 1 20

Contents

vii

Window_State (Runform) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Generate Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Add_Triggers (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Batch (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CRT_File (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Debug (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Delete (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Extract (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Generate_on_Upgrade (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . Help (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Insert (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Logon (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Module_Access (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Module_Type (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Nofail (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Options_Screen (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Output_File (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parse (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Script (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Statistics (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Upgrade (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Upgrade_Roles (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Version (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Widen_Fields (Generate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Designer Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Designer Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Runtime Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Keyword Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Color Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Color Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Generate Before Run . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Help (Designer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Module_Access (Designer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Module_Type (Designer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Run Modules Asynchronously . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Save Before Generate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Suppress Hints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Term (Designer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Use System Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . User Preference File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Syntax for Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1 21 1 21 1 23 1 23 1 23 1 24 1 24 1 24 1 25 1 25 1 25 1 26 1 26 1 26 1 27 1 27 1 27 1 28 1 28 1 29 1 29 1 30 1 30 1 31 1 31 1 31 1 32 1 32 1 33 1 34 1 34 1 35 1 35 1 36 1 36 1 37 1 37 1 37 1 38 1 38 1 39 1 39

viii

Forms Reference Manual

Chapter 2

Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About Triggers and Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SQL Statements in Trigger Text . . . . . . . . . . . . . . . . . . . . . . . . . Trigger Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Function Key Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . KeyFn Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . KeyOthers Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnCheckDeleteMaster Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . OnCheckUnique Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnClearDetails Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnClose Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnColumnSecurity Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnCommit Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnCount Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnDelete Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnError Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnFetch Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnInsert Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnLock Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnLogon Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnLogout Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnMessage Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnPopulateDetails Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnRollback Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnSavepoint Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnSelect Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnSequenceNumber Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . OnUpdate Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostBlock Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostChange Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostDatabaseCommit Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostDelete Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostForm Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostFormsCommit Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostInsert Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostLogon Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostLogout Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostQuery Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostRecord Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostSelect Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostTextItem Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PostUpdate Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreBlock Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21 22 22 23 26 28 29 2 10 2 11 2 12 2 13 2 14 2 15 2 16 2 17 2 18 2 19 2 21 2 22 2 23 2 24 2 25 2 26 2 27 2 28 2 29 2 30 2 31 2 32 2 33 2 35 2 36 2 37 2 38 2 39 2 40 2 41 2 42 2 44 2 45 2 46 2 47 2 48

Contents

ix

PreCommit Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreDelete Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreForm Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreInsert Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreLogon Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreLogout Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreQuery Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreRecord Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreSelect Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreTextItem Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreUpdate Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . UserNamed Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenButtonPressed Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenCheckboxChanged Trigger . . . . . . . . . . . . . . . . . . . . . . . . . WhenClearBlock Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenCreateRecord Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenCustomItemEvent Trigger . . . . . . . . . . . . . . . . . . . . . . . . WhenDatabaseRecord Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenFormNavigate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenImageActivated Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenImagePressed Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenListActivated Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenListChanged Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenMouseClick Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenMouseDoubleClick Trigger . . . . . . . . . . . . . . . . . . . . . . . . . WhenMouseDown Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenMouseEnter Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenMouseLeave Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenMouseMove Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenMouseUp Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenNewBlockInstance Trigger . . . . . . . . . . . . . . . . . . . . . . . . WhenNewFormInstance Trigger . . . . . . . . . . . . . . . . . . . . . . . . WhenNewItemInstance Trigger . . . . . . . . . . . . . . . . . . . . . . . . . WhenNewRecordInstance Trigger . . . . . . . . . . . . . . . . . . . . . . . WhenRadioChanged Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenRemoveRecord Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenTimerExpired Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenValidateItem Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenValidateRecord Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenWindowActivated Trigger . . . . . . . . . . . . . . . . . . . . . . . . . WhenWindowClosed Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . . . WhenWindowDeactivated Trigger . . . . . . . . . . . . . . . . . . . . . . . WhenWindowResized Trigger . . . . . . . . . . . . . . . . . . . . . . . . . . .

2 49 2 50 2 51 2 52 2 53 2 54 2 55 2 57 2 58 2 59 2 60 2 62 2 63 2 64 2 65 2 66 2 67 2 68 2 69 2 69 2 70 2 70 2 71 2 71 2 72 2 74 2 75 2 76 2 77 2 78 2 79 2 80 2 81 2 82 2 83 2 84 2 85 2 87 2 89 2 91 2 92 2 92 2 93

x

Forms Reference Manual

Chapter 3

Builtin Subprograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Named Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Code Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Object IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Form Coordinate Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uppercase Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Restricted BuiltIn Subprograms . . . . . . . . . . . . . . . . . . . . . . . Constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Builtin Subprograms Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Individual Builtin Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . ABORT_QUERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ADD_GROUP_COLUMN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ADD_GROUP_ROW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ADD_LIST_ELEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ADD_PARAMETER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . APPLICATION_PARAMETER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BACKGROUND_MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BLOCK_MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BREAK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CALL_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CALL_INPUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CHECKBOX_CHECKED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CHECK_RECORD_UNIQUENESS . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_BLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_EOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_MESSAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLOSE_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . COMMIT_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONVERT_OTHER_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . COPY_REGION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . COUNT_QUERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CREATE_GROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CREATE_GROUP_FROM_QUERY . . . . . . . . . . . . . . . . . . . . . . . . . CREATE_PARAMETER_LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CREATE_QUERIED_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . .

31 32 32 33 33 34 34 35 35 36 37 3 16 3 17 3 18 3 20 3 22 3 23 3 24 3 25 3 26 3 26 3 27 3 28 3 31 3 31 3 33 3 34 3 35 3 36 3 37 3 38 3 39 3 40 3 41 3 41 3 43 3 44 3 45 3 46 3 47 3 49 3 51 3 52

Contents

xi

CREATE_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CREATE_TIMER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CUT_REGION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DBMS_ERROR_CODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DBMS_ERROR_TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DEBUG_MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DEFAULT_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DELETE_GROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DELETE_GROUP_ROW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DELETE_LIST_ELEMENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DELETE_PARAMETER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DELETE_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DELETE_TIMER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DESTROY_PARAMETER_LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . DISPLAY_ERROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DISPLAY_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DO_KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DUPLICATE_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DUPLICATE_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . EDIT_TEXTITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ENFORCE_COLUMN_SECURITY . . . . . . . . . . . . . . . . . . . . . . . . . ENTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ENTER_QUERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ERASE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ERROR_CODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ERROR_TEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ERROR_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . EXECUTE_QUERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . EXECUTE_TRIGGER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . EXIT_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FETCH_RECORDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_ALERT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_BLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_CANVAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_COLUMN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_EDITOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_GROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_LOV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_MENU_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_RELATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3 54 3 55 3 56 3 57 3 58 3 59 3 60 3 61 3 62 3 64 3 65 3 66 3 67 3 69 3 70 3 70 3 71 3 72 3 73 3 74 3 75 3 76 3 77 3 77 3 79 3 79 3 80 3 81 3 82 3 84 3 85 3 87 3 89 3 90 3 91 3 91 3 92 3 93 3 94 3 94 3 95 3 96 3 97

xii

Forms Reference Manual

FIND_TIMER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_VIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIND_WINDOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FIRST_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FORM_FAILURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FORM_FATAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FORM_SUCCESS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FORMS_DDL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FORMS_OLE.ACTIVATE_SERVER . . . . . . . . . . . . . . . . . . . . . . . . . FORMS_OLE.CLOSE_SERVER . . . . . . . . . . . . . . . . . . . . . . . . . . . . FORMS_OLE.EXEC_VERB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FORMS_OLE.FIND_OLE_VERB . . . . . . . . . . . . . . . . . . . . . . . . . . . FORMS_OLE.GET_INTERFACE_POINTER . . . . . . . . . . . . . . . . . FORMS_OLE.GET_VERB_COUNT . . . . . . . . . . . . . . . . . . . . . . . . . FORMS_OLE.GET_VERB_NAME . . . . . . . . . . . . . . . . . . . . . . . . . . FORMS_OLE.INITIALIZE_CONTAINER . . . . . . . . . . . . . . . . . . . FORMS_OLE.SERVER_ACTIVE . . . . . . . . . . . . . . . . . . . . . . . . . . . GENERATE_SEQUENCE_NUMBER . . . . . . . . . . . . . . . . . . . . . . . GET_APPLICATION_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . GET_BLOCK_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_CANVAS_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_FORM_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_GROUP_CHAR_CELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_GROUP_DATE_CELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_GROUP_NUMBER_CELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_GROUP_RECORD_NUMBER . . . . . . . . . . . . . . . . . . . . . . . . GET_GROUP_ROW_COUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_GROUP_SELECTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_GROUP_SELECTION_COUNT . . . . . . . . . . . . . . . . . . . . . . . GET_ITEM_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_LIST_ELEMENT_COUNT . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_LIST_ELEMENT_LABEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_LIST_ELEMENT_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_LOV_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_MENU_ITEM_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_MESSAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_PARAMETER_ATTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_PARAMETER_LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_RADIO_BUTTON_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . GET_RECORD_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_RELATION_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_VIEW_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GET_WINDOW_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3 98 3 99 3 100 3 101 3 101 3 103 3 104 3 105 3 109 3 110 3 111 3 112 3 113 3 114 3 115 3 116 3 117 3 118 3 119 3 123 3 128 3 129 3 133 3 135 3 136 3 138 3 139 3 140 3 142 3 143 3 151 3 153 3 154 3 155 3 156 3 158 3 159 3 160 3 160 3 163 3 165 3 167 3 170

Contents

xiii

GO_BLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GO_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GO_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GO_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HIDE_MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HIDE_VIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HIDE_WINDOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HOST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ID_NULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMAGE_ZOOM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INSERT_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ISSUE_ROLLBACK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ISSUE_SAVEPOINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ITEM_ENABLED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LAST_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LIST_VALUES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LOCK_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LOGON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MESSAGE_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MOVE_WINDOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NAME_IN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NEW_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NEXT_BLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NEXT_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NEXT_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NEXT_KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NEXT_MENU_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NEXT_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NEXT_SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OPEN_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3 171 3 172 3 173 3 174 3 175 3 175 3 176 3 176 3 178 3 180 3 181 3 183 3 184 3 185 3 186 3 186 3 187 3 188 3 189 3 190 3 192 3 193 3 193 3 194 3 194 3 195 3 195 3 195 3 196 3 197 3 198 3 199 3 200 3 202 3 205 3 208 3 209 3 210 3 211 3 211 3 212 3 213 3 213

xiv

Forms Reference Manual

PASTE_REGION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PAUSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . POPULATE_GROUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . POPULATE_GROUP_WITH_QUERY . . . . . . . . . . . . . . . . . . . . . . POPULATE_LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . POST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PREVIOUS_BLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PREVIOUS_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PREVIOUS_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PREVIOUS_MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PREVIOUS_MENU_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PREVIOUS_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PRINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . QUERY_PARAMETER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . READ_IMAGE_FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . REDISPLAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . REPLACE_CONTENT_VIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . REPLACE_MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RESET_GROUP_SELECTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RESIZE_WINDOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RETRIEVE_LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RUN_PRODUCT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SCROLL_DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SCROLL_UP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SCROLL_VIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SELECT_ALL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SELECT_RECORDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_ALERT_BUTTON_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . SET_ALERT_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_APPLICATION_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . SET_BLOCK_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_CANVAS_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_FORM_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_GROUP_CHAR_CELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_GROUP_DATE_CELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_GROUP_NUMBER_CELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_GROUP_SELECTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_INPUT_FOCUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_ITEM_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_LOV_COLUMN_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . SET_LOV_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_MENU_ITEM_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_PARAMETER_ATTR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3 215 3 215 3 216 3 217 3 218 3 220 3 220 3 221 3 222 3 223 3 223 3 224 3 224 3 225 3 227 3 228 3 229 3 230 3 232 3 233 3 234 3 235 3 238 3 238 3 239 3 241 3 242 3 243 3 244 3 245 3 246 3 250 3 251 3 255 3 256 3 258 3 259 3 260 3 260 3 270 3 271 3 272 3 274

Contents

xv

SET_RADIO_BUTTON_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . SET_RECORD_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_RELATION_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_TIMER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_VIEW_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SET_WINDOW_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SHOW_ALERT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SHOW_BACKGROUND_MENU . . . . . . . . . . . . . . . . . . . . . . . . . . SHOW_EDITOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SHOW_KEYS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SHOW_LOV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SHOW_MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SHOW_VIEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SHOW_WINDOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYNCHRONIZE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TERMINATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . UNSET_GROUP_SELECTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . UP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . UPDATE_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . USER_EXIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VALIDATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VBX.FIRE_EVENT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VBX.GET_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VBX.GET_VALUE_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . VBX.INVOKE_METHOD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VBX.SET_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VBX.SET_VALUE_PROPERTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WHERE_DISPLAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WRITE_IMAGE_FILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 4 System Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . About System Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Date and Time System Default Values . . . . . . . . . . . . . . . . . . . Local Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uppercase Return Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . $$DATE$$ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . $$DATETIME$$ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . $$DBDATE$$ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . $$DBDATETIME$$ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . $$DBTIME$$ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . $$TIME$$ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.BLOCK_STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3 274 3 276 3 278 3 280 3 282 3 284 3 286 3 287 3 288 3 290 3 290 3 291 3 292 3 293 3 294 3 295 3 295 3 296 3 296 3 297 3 299 3 300 3 301 3 302 3 303 3 304 3 305 3 306 3 306 41 42 43 44 44 45 46 47 48 49 49 4 10

xvi

Forms Reference Manual

SYSTEM.COORDINATION_OPERATION . . . . . . . . . . . . . . . . . . SYSTEM.CURRENT_BLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.CURRENT_DATETIME . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.CURRENT_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.CURRENT_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.CURRENT_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.CURSOR_BLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.CURSOR_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.CURSOR_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.CURSOR_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.CUSTOM_ITEM_EVENT . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.CUSTOM_ITEM_EVENT_PARAMETERS . . . . . . . . . . . SYSTEM.DATE_THRESHOLD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.EFFECTIVE_DATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.EVENT_WINDOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.FORM_STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.LAST_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.LAST_QUERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.LAST_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.MASTER_BLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.MESSAGE_LEVEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.MOUSE_BUTTON_PRESSED . . . . . . . . . . . . . . . . . . . . . SYSTEM.MOUSE_BUTTON_SHIFT_STATE . . . . . . . . . . . . . . . . . SYSTEM.MOUSE_CANVAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.MOUSE_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.MOUSE_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.MOUSE_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.MOUSE_RECORD_OFFSET . . . . . . . . . . . . . . . . . . . . . . SYSTEM.MOUSE_X_POS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.MOUSE_Y_POS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.RECORD_STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.SUPPRESS_WORKING . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.TRIGGER_BLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.TRIGGER_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SYSTEM.TRIGGER_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 5 Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting and Modifying Properties . . . . . . . . . . . . . . . . . . . . . . . . . . Setting Properties Programmatically . . . . . . . . . . . . . . . . . . . . Reading the Property Descriptions . . . . . . . . . . . . . . . . . . . . . . . . .

4 11 4 13 4 14 4 15 4 15 4 16 4 16 4 17 4 18 4 19 4 20 4 20 4 21 4 22 4 23 4 24 4 24 4 25 4 27 4 27 4 28 4 28 4 29 4 30 4 31 4 31 4 32 4 33 4 33 4 34 4 34 4 35 4 36 4 36 4 37 4 38 51 52 53 53 54

Contents

xvii

Property Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Item Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Property Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Accelerator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Access Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Alert Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Alignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Application Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Auto Hint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AutoConfirm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AutoDisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AutoQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AutoRefresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AutoSkip (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . AutoSkip (LOV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Base Table (Block) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Base Table (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bevel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Block Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bottom Title (Editor) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bottom Title (Menu) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Button 1, Button 2, Button 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Calling_Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Canvas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Canvasview Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Case Insensitive Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Case Restriction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Character Cell WD/HT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check Box Other Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Checked . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Checked Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Closeable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Column Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Column Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Column Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Return Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Column Name (LOV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Column Name (Record Group) . . . . . . . . . . . . . . . . . . . . . . . . . . . . Column Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Column Specification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Column Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

55 5 17 5 20 5 21 5 21 5 22 5 23 5 24 5 24 5 25 5 25 5 25 5 26 5 28 5 28 5 29 5 29 5 30 5 30 5 31 5 31 5 31 5 32 5 32 5 33 5 34 5 35 5 36 5 36 5 37 5 37 5 38 5 38 5 39 5 39 5 39 5 39 5 39 5 40 5 40 5 40 5 41 5 41

xviii

Forms Reference Manual

Column Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Column Title (LOV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Column Value (Record Group) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Comment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Compression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Connect_String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Console Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Coordinate Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Coordinate System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Coordination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Coordination_Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Copy Value from Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Current Record Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Current_Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Current_Form_Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Current_Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cursor Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cursor_Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data Type (Record Group) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Database_Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Datasource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default Alert Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default Font Scaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default Value (Form Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . Default Value (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default Value (Menu Substitution Parameter) . . . . . . . . . . . . . . . . Deferred . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defer_Required_Enforcement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Delete Allowed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Detail Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Direction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Direction (Alert) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Direction (Button) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Direction (Canvasview) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Direction (Check Box) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Direction (Form) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Direction (List Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5 41 5 41 5 42 5 42 5 42 5 42 5 43 5 44 5 44 5 44 5 45 5 45 5 45 5 47 5 48 5 49 5 49 5 50 5 51 5 52 5 52 5 54 5 55 5 60 5 60 5 61 5 61 5 62 5 62 5 63 5 63 5 65 5 65 5 65 5 66 5 66 5 67 5 70 5 70 5 70 5 71 5 71 5 71

Contents

xix

Direction (Radio Group) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Direction (Windows) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display Width (LOV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display w/o Privilege . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display X Position, Display Y Position . . . . . . . . . . . . . . . . . . . . . . Displayed (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Displayed (Canvasview) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Displayed (Menu Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display_Height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display_Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Editor X Position, Editor Y Position . . . . . . . . . . . . . . . . . . . . . . . . . Enabled (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enabled (Menu Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enterable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Execution Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . File_Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fire in Enter Query Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . First Navigation Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . First_Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . First_Detail_Relation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . First_Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . First_Master_Relation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fixed Length(Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fixed Length (Menu Substitution Parameter) . . . . . . . . . . . . . . . . Fixed Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Format Mask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Form_Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Group_Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hint (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hint (Menu Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Hint (Menu Substitution Parameter) . . . . . . . . . . . . . . . . . . . . . . . . Horizontal MDI Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Horizontal Scroll Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Horizontal Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Icon Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Icon Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Iconic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Iconifiable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5 71 5 71 5 72 5 72 5 73 5 73 5 74 5 74 5 75 5 75 5 76 5 76 5 77 5 77 5 78 5 79 5 79 5 80 5 81 5 82 5 83 5 83 5 84 5 84 5 85 5 86 5 86 5 87 5 88 5 94 5 94 5 95 5 95 5 96 5 96 5 97 5 97 5 98 5 99 5 100 5 100 5 101 5 101

xx

Forms Reference Manual

In Menu/Block Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inherit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Initial Keyboard State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Insert Allowed (Block) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Insert Allowed (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Item Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Items Displayed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Item_Is_Valid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Join Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Keep Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Key Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Label (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Label (Menu Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Label (Menu Substitution Parameter) . . . . . . . . . . . . . . . . . . . . . . . Last_Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Last_Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Length (Record Group) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . List Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . List Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . List Item Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . List Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Lock Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Locking Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Long List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LOV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LOV for Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LOV Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LOV Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Magic Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Master Deletes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Maximum Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Maximum Length (Form Parameter) . . . . . . . . . . . . . . . . . . . . . . . . Maximum Length (Menu Substitution Parameter) . . . . . . . . . . . . Menu Item Radio Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Item Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Item Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Module Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Menu Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mirror Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5 102 5 102 5 103 5 103 5 104 5 105 5 106 5 106 5 107 5 108 5 109 5 110 5 110 5 111 5 111 5 112 5 112 5 112 5 112 5 112 5 113 5 113 5 114 5 115 5 116 5 116 5 118 5 119 5 120 5 121 5 122 5 123 5 124 5 124 5 125 5 125 5 126 5 128 5 129 5 129 5 130 5 130 5 131

Contents

xxi

Modal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Module_NLS_Lang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mouse Navigate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mouse Navigation Limit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Moveable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MultiLine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Navigable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Navigation Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Next Navigation Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Next Navigation Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NextBlock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . NextItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Next_Detail_Relation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Next_Master_Relation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OLE Activation Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OLE Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OLE Do In Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OLE Inplace Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OLE Popup Menu Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OLE Resize Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OLE Tenant Aspect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . OLE Tenant Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Operating_System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Optimizer_Hint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Order By . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Other Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parameter Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Prevent Masterless Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Previous Navigation Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Previous Navigation Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreviousBlock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PreviousItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Primary Key (Block) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Primary Key (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Query Allowed (Block) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Query Allowed (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Query Length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Query Only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Query_Hits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Query_Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5 132 5 133 5 134 5 135 5 135 5 136 5 136 5 138 5 139 5 140 5 140 5 141 5 142 5 142 5 142 5 143 5 144 5 145 5 146 5 147 5 150 5 150 5 151 5 152 5 152 5 153 5 154 5 154 5 155 5 155 5 156 5 157 5 158 5 158 5 159 5 159 5 160 5 160 5 161 5 162 5 162 5 163 5 164

xxii

Forms Reference Manual

Raise on Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Range High Value/Range Low Value . . . . . . . . . . . . . . . . . . . . . . . Reading Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Real Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Record Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Record Group Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Record Group Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Record Orientation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Records Buffered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Records Displayed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Records Fetched . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Records_to_Fetch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reference Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Remove on Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Rendered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Required (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Required (Menu Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Return Item (LOV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Savepoint Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Savepoint_Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Scroll Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Secure (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Secure (Menu Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Show Keys/Show Keys Description . . . . . . . . . . . . . . . . . . . . . . . . Show OLE Popup Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Show OLE Tenant Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Size (Canvasview) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Size (Editor) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Size (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Size (LOV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Size (Window) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sizing Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Space Between Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Starting Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Startup Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Status (Block) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Status (Record) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Subtitle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tearoff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Timer_Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Title (LOV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5 164 5 165 5 166 5 167 5 167 5 168 5 168 5 169 5 169 5 170 5 171 5 171 5 173 5 173 5 174 5 174 5 175 5 175 5 176 5 177 5 178 5 179 5 179 5 180 5 181 5 182 5 182 5 182 5 182 5 183 5 183 5 184 5 184 5 184 5 185 5 186 5 186 5 187 5 187 5 188 5 188 5 188 5 188

Contents

xxiii

Title (Menu) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Title (Window) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Top Title . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Top_Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transactional Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trigger Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trigger Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Trigger Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unchecked Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Update Allowed (Block) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Update Allowed (Item) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Update Changed Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Update_Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Update Only if NULL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Update_Permission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Use File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Use Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Use 3D Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Username . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . User_Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . User_NLS_Lang . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Validation Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VBX Control File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VBX Control Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VBX Control Value Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Vertical MDI Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Vertical Scroll Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Vertical Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . View Height, View Width . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . View Horizontal Scroll Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . View Vertical Scroll Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Visible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Visual Attribute Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Visual_Attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WHERE Clause/ORDER BY Clause . . . . . . . . . . . . . . . . . . . . . . . . Width/Height (WD, HT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Window_Handle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Window_State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Window Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5 189 5 189 5 189 5 190 5 190 5 191 5 191 5 192 5 192 5 193 5 194 5 195 5 196 5 197 5 198 5 199 5 201 5 201 5 202 5 202 5 203 5 203 5 204 5 205 5 205 5 206 5 206 5 207 5 208 5 208 5 209 5 210 5 210 5 211 5 211 5 213 5 216 5 217 5 218 5 218 5 219 5 220 5 221

xxiv

Forms Reference Manual

Wrap Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . X Position, Y Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LOV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . WINDOW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . X Position on Canvas, Y Position on Canvas . . . . . . . . . . . . . . . . . Zoomable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 6 Runform Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Starting/Exiting Runform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing the Status Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Navigating Around Your Form . . . . . . . . . . . . . . . . . . . . . . . . . Choosing Items and Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . Interacting with Form Items . . . . . . . . . . . . . . . . . . . . . . . . . . . Querying the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modifying the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the Default Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Invoking the Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Runform Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Oracle Forms Common Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . List of Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Normal Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Default Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Query Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enter Query Mode Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Validation Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . When Validation Occurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Status Checking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Item Validation States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Record Validation States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Standard Validation Checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . Commit Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Posting Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Processing Inserts, Updates, and Deletes . . . . . . . . . . . . . . . . When Commit Processing Occurs . . . . . . . . . . . . . . . . . . . . . . Changing Data During Commit Processing . . . . . . . . . . . . . .

5 222 5 222 5 223 5 223 5 223 5 224 5 224 61 62 62 62 63 63 64 66 6 10 6 11 6 14 6 14 6 15 6 16 6 16 6 16 6 16 71 72 75 76 76 76 77 77 79 7 10 7 11 7 11 7 11 7 13 7 14

Chapter 7

Contents

xxv

Replacing Default Commit Processing . . . . . . . . . . . . . . . . . . Locking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Methods for Locking Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . Failing to Obtain a Lock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . When Locks are Released . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Replacing Default Locking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 8 Processing Flowcharts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ABORT_QUERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . BLOCK_MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CALL_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CALL_INPUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check Block for Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check Block for Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check Item for Edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check Record Uniqueness . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Check Record for Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_BLOCK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_EOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CLEAR_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Close the Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . COMMIT_FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . COPY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . COUNT_QUERY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CREATE_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DEFAULT_VALUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DELETE_RECORD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DO_KEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DOWN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DUPLICATE_ITEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .