$applproperties

Set the presentation properties of the application shell.

$applproperties({ PropertyList }) = PropertyValuesList

Example: $applproperties("backimage") = "backimage=@logo.jpg"

Parameters

Parameters
Parameter	Data Type	Description
PropertiesList	String	Associative list of application shell properties
PropertyValuesList	String	Associative list of application shell properties and their values

Properties set by $applproperties
Property	Technical Name	Description
Background Color (BackColor)	BackColor	Background color of the window.
Background Image (BackImage)	BackImage	Background image of the window.
Horizontal Alignment (Halign)	HAlign	Horizontal alignment of the background image.
Horizontal Scaling (Hscale)	HScale	Horizontal scaling of the background image.
Vertical Alignment (Valign)	VAlign	Vertical alignment of background image.
Vertical Scaling (Vscale)	VScale	Vertical scaling of background image.
Preserve Aspect Ratio (PreserveAspect)	PreserveAspect	Specify whether to preserve the aspect ratio of the background image at all times.
Message Line	MessageLine	Show or hide the message line at the bottom of the application window.

Return Values

Values of $procerror Commonly Returned Following $applproperties
Value	Error constant	Meaning
-1110	UPROCERR_TOPIC	Topic name not known. Invalid property specified.

Use

Use only in Application Shell and Form components.

Description

Property values set using $applproperties override those set in the initialization file with the Shell definition, or values set in the application shell definition.

Using $applproperties

vProps = ""
putitem/id vProps, "backimage","@logo.png"
putitem/id vProps, "PreserveAspect","true"
$applproperties() = vProps

History
Version	Change
9.1.02 N204	Introduced