4D v14.3

FORM SCREENSHOT

Home

 
4D v14.3
FORM SCREENSHOT

FORM SCREENSHOT 


 

FORM SCREENSHOT ( {{aTable ;} formName ;} formPict {; pageNum} )  
Parameter Type   Description
aTable  Table in Form table
formName  Text in Name of form
formPict  Picture in Picture of form being executed if first parameter(s) omitted, or
Picture of form in Form editor if a form name is passed
pageNum  Longint in Form page number

The FORM SCREENSHOT command returns a form as a picture. This command accepts two different syntaxes: depending on the syntax used, you get either a picture of an executed form, or a picture of the form in the Form editor.

  • FORM SCREENSHOT ( formPict )
    This syntax gets the exact screenshot of the current page of the form being executed or loaded by means of the FORM LOAD command: the picture returned in the formPict parameter contains all the form's visible objects with the current field and variable values of the form, subform, and so on. The form is returned in full, without taking the size of the window that contains it into account.
    Note that this syntax only works with input forms.
  • FORM SCREENSHOT ( {aTable ;} formName ; formPict {; pageNum} )
    This syntax gets a screenshot of a form "template"
    as it is displayed in the Form editor. All visible objects are drawn like they are in the editor; the command takes inherited forms and objects placed on page 0 into account.
    If you want a screenshot for a table form, pass the form table in the aTable parameter and then pass its name as a string in formName. For a project form, pass the form name directly in formName.
    By default, the command returns a screenshot of page 1 of the form. If you only want a picture of page 0, or any other page of the form, pass the desired page number in the pageNum parameter. 

Note: Since the first two parameters of this command are optional, you cannot pass a function returning a pointer, such as Current form table-> or Table->, directly as an argument. Although this syntax would work in interpreted mode, it would be rejected during compilation, so instead you need to use an intermediate pointer variable in this case. For more information, refer to "Direct use of commands returning pointers".

 
PROPERTIES 

Product: 4D
Theme: Forms
Number: 940

 
HISTORY 

Created: 4D v12.2

 
SEE ALSO 

FORM LOAD

 
ARTICLE USAGE

4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)

Inherited from : FORM SCREENSHOT ( 4D v12.4)