Language Reference Guide : Events : Properties Event
 
Share this page          
Properties Event
The Properties event is triggered for an active field when the user uses the secondary mouse button to click the field.
This event has the following syntax:
on properties [fieldname]
fieldname is optional if you specify the event in a field script.
The following attributes of the FrameExec class can be used in the Properties event block:
TriggerField
Specifies the field that the user was positioned over when clicking the secondary mouse button
OriginatorField
Specifies the field in the initial on properties statement
Use the CurFrame system variable to access these attributes. For more information, see FrameExec Class.
Usage: The Properties event is defined for all form fields, including the subform that is the frame's top form. This event is not defined for menu fields. If you specify this event in the frame script without a field name, the event is triggered when the user clicks the secondary mouse button on the form's background.
The Properties event block can only be used when the user clicks a single field. However, because you can specify the Properties event for a composite field, you can use it to detect secondary mouse button clicks on a composite field's background.
For example, to display help messages when a user clicks anywhere on a table field, either on the background of the table field or on a child field of the table field, you can specify:
on properties tblfield,
on childproperties tblfield =
begin
    callframe generic_help(field = 'tblfield');
end
More information:
OriginatorField Attribute
TriggerField Attribute