GET FORM PARAMETER

version 2004.4

GET FORM PARAMETER ({table; }form; selector; value)

The GET FORM PARAMETER command can be used to get the current value of a parameter of the form indicated by table and form.

selector indicates the parameter of the form whose value you want to find out. You can use the following constant, found in the "Form Parameters" theme:

When you use the NonInverted Objects constant as selector, the command returns, in value, the actual display mode of the form in Custom Menus mode under Windows. This parameter is used when applications are displayed using "right-to-left" languages. For more information about the support of right-to-left languages, please refer to the Design Reference manual of 4th Dimension.

• If value returns 0, the form objects are inverted,

• If value returns 1, the form objects are not inverted.

If the command is not called within the context of the Custom Menus mode under Windows, it always returns 1.

Keep in mind that the actual inversion of form objects will depend on a combination of several parameters: the values of the "Inversion of objects in Custom Menus mode" preference, the value of the "Do not invert objects" form option and the system on which the database is running. The following table specifies the value returned by the GET FORM PARAMETER command depending on the various combinations of these parameters:

Preferences:	Form property:	Right-to-left	Value returned by
"Inversion of objects	"Do not invert	Display under	GET FORM PARAMETER
in Custom Menus	objects"	Windows
mode" (1)

No	X	X	1
		X	1
	X		1
			1
Automatic	X	X	1
		X	0
	X		1
			1
Yes	X	X	1
		X	0
	X		1
			0

(1) This preference can also be set or read using the SET DATABASE PARAMETER and Get database parameter commands.

Get database parameter, GET FORM PROPERTIES, SET DATABASE PARAMETER.