4D Doc Center : FORM SCREENSHOT

Home

4D v14.3

FORM SCREENSHOT


FORM SCREENSHOT ( {{aTable ;} formName ;} formPict {; pageNum} )

Parameter	Type	Description
aTable	Table	Form table
formName	Text	Name of form
formPict	Picture	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	Form page number

Description

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".