The syntax for the SetProperty event is different than for other ControlEvents In place of the name of the event one puts the property in square brackets: [property_name]. The argument is the new value of the property. To unset the property, the argument must be {}. This is necessary, because the argument is a primary key in the table and so cannot be null. The argument will be formatted using the FormatText method, therefore the argument can contain any expression that the FormatText method can handle. The property values are evaluated at the moment of the ControlEvent.

This event can be published by a PushButton Control, CheckBox Control, or a SelectionTree control. This event should be authored into the ControlEvent table.

This ControlEvent requires the user interface to be run at the full UI level. This event will not work with a reduced UI or basic UI. For information, see User Interface Levels.

Published By

This ControlEvent is published by the installer.

Argument

The new value of the property. {} for null.

Action on Subscribers

None.

Typical Use

A PushButton control on a dialog box linked to this event so it changes a property when the button is pushed.

Send comments about this topic to Microsoft

Build date: 8/13/2009