4D Doc Center : FORM SCREENSHOT

4D v13.4

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 the form currently being executed, 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: 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.