Event Mappings

<< Click to Display Table of Contents >>

RayPack > 8.0 > User Guide > PackDesigner > MSI / MST / RPP Based Projects > Advanced Mode > User Interface > Editing the Properties of a Control 

Event Mappings

Event mapping are used to bind a certain Installer event to a property / behavior of an MSI control.

The Properties dialog lets you define the combination of an event and its arguments for all MSI controls.

 

Event
One of the predefined names recognized by Windows Installer, or a name of the Windows Installer property surrounded by square brackets.
 
The list of accepted mappings is available on MSDN website:
https://msdn.microsoft.com/pl-pl/library/aa368036(v=vs.85).aspx

 

Argument
This is a string-based argument that is passed along with the event. Most of the events require a specific value to be present.

Adding a New Mapping

To add a new event mapping, click on the Add... button. A new row will be added automatically.

Editing an Event

To edit an existing event mappping, focus the cell to be edited and press F2 or click it for a second time using the left mouse button. Some fields are validated by RayPack. For example, RayPack prevents entering an empty string into the Event column to preserve internal MSI consistency. Any validation errors are shown inline. If you want to cancel editing and restore the previous value, press ESC while the validation error is being shown in the cell.

 

papercliper

Note:

Due to the Windows Installer limitations, some combinations of values may produce same MSI Primary Keys. When the changes are saved (by pressing either OK or APPLY button) RayPack will merge the event mappings definition and ensure that they do not break the internal consistency of the package.

 

Deleting an Event Mapping

To delete an existing event mapping, focus the row belonging to the mapping, and press the button Remove selected.