CLOSE_FORM Built-in
Description
In a multiple-form application, closes the indicated form. When the indicated form is the current form, CLOSE_FORM is equivalent to EXIT_FORM.
Syntax
PROCEDURE CLOSE_FORM
(form_name VARCHAR2);
PROCEDURE CLOSE_FORM
(form_id FORMMODULE);
Built-in Type restricted procedure
Enter Query Mode no
Parameters
- form_name
-
- Specifies the name of the form to close as a VARCHAR2.
-
- form_id
-
- The unique ID that is assigned to the form dynamically when it is instantiated
at runtime. Use the FIND_FORM Built-in to an appropriately typed variable.
The data type of the form ID is FORMMODULE.
CLOSE_FORM Restrictions
- You cannot close a form that is currently disabled
as a result of having issued CALL_FORM to invoke a modal called form.
- You cannot close a form that has called you.
For example, if Form_A calls Form_B, then Form_B cannot close Form_A.
Example
Declare
FRM_NM FORMMODULE;
Begin
FRM_NM.ID := TO_NUMBER(:System.Last_Form);
CLOSE_FORM(FRM_NM);
End;