Formulário

Form : Object

Parâmetro	Tipo		Descrição
Resultado	Object	←	Form data of the current form

História

Release	Mudanças
20 R8	Form class support

Descrição

The Form command returns the object associated with the current form (instantiated from the formData parameter or the user class assigned in the Form editor).The Form command returns the object associated with the current form (instantiated from the formData parameter or the user class assigned in the Form editor).The Form command returns the object associated with the current form (instantiated from the formData parameter or the user class assigned in the Form editor).The Form command returns the object associated with the current form (instantiated from the formData parameter or the user class assigned in the Form editor).The Form command returns the object associated with the current form (instantiated from the formData parameter or the user class assigned in the Form editor).The Form command returns the object associated with the current form (instantiated from the formData parameter or the user class assigned in the Form editor).The Form command returns the object associated with the current form (instantiated from the formData parameter or the user class assigned in the Form editor). 4D automatically associates an object to the current form in the following cases:

• o formulário atual foi carregado por um dos comandos DIALOG, Print form ou FORM LOAD,
• the current form is a subform,
• a table form is currently displayed on screen.

Comandos (DIALOG...)

If the current form is being displayed or loaded by a call to the DIALOG, Print form, or FORM LOAD commands, Form returns either:

• the formData object passed as parameter to this command, if any,
• ou, um objeto instanciado da classe de usuário associada ao formulário, se houver,
• or, an empty object.

Subformulário

If the current form is a subform, the returned object depends on the parent container variable:

• Form returns the object associated with the table form displayed on screen.
  Form returns the object associated with the table form displayed on screen.
  In the context of an input form displayed from an output form (i.e. after a double-click on a record), the returned object contains the following property:

 (OBJECT Get pointer(Object subform container))->  

• If the variable associated to the parent container has not been typed as an object, Form returns an empty object, maintained by 4D in the subform context.

For more information, please refer to the Page subforms section.

Table form

Form returns the object associated with the table form displayed on screen.
Form returns the object associated with the table form displayed on screen.
In the context of an input form displayed from an output form (i.e. after a double-click on a record), the returned object contains the following property: Form returns the object associated with the table form displayed on screen.
In the context of an input form displayed from an output form (i.e. after a double-click on a record), the returned object contains the following property:

Propriedade	Tipo	Description
parentForm	object	Form object of the parent output form

Exemplo

In a form displaying the record of a person, a "Check children" button opens a dialog to verify/modify the names and ages of their children:

Note: The "Children" object field is represented only to show its structure for this example.

In the verification form, you have assigned some Form object properties to inputs:

Here is the code for the "Check children" button:

 var $win;$n;$i : Integer
 var $save : Boolean
 ARRAY OBJECT($children;0)
 OB GET ARRAY([Person]Children;"children";$children) //get the children collection
 $save:=False //initialize the save variable
 
 $n:=Size of array($children)
 If($n>0)
    $win:=Open form window("Edit_Children";Movable form dialog box)
    SET WINDOW TITLE("Check children for "+[Person]Name)
    For($i;1;$n) //for each child
       DIALOG("Edit_Children";$children{$i}) //displays dialog filled with values
       If(OK=1) //the user clicked OK
          $save:=True
       End if
    End for
    If($save=True)
       [Person]Children:=[Person]Children //forces object field update
    End if
    CLOSE WINDOW($win)
 Else
    ALERT("No child to check.")
 End if

The form displays information for each child:

If values are edited and the OK button is clicked, the field is updated (the parent record must be saved afterwards).

Veja também

DIALOG

Propriedades

Command number	1466
Thread safe	✗