The OnControlAddIn(Index : Integer;Data : Text) trigger notifies your application once the hosting control fires any event. The events being fired depends on the hosting control which usually is specified by the AssemblyQualifiedName call in the Caption property.

In order to handle the OnControlAddin trigger of the Control-AddIn in the NAV's page you have to:

• Open the NAV's page that hosts the Control-AddIn, in design mode
• Go to the field that hosts the Control-AddIn
• Right-Click the field, and choose "C/AL Code"
• Locate the "OnControlAddIn(Index : Integer;Data : Text)" for the field
• Add the Message(Data) as in the following sample:

  Name - OnControlAddIn(Index : Integer;Data : Text)
    MESSAGE(Data);

• Save and Close the page
• Run the Page, and click the Control-AddIn, and so the message box "Click" is displayed.

The HostEvent event notifies your application once the hosting control ( Host ) fires an event. The HostEvents property of the NAVHost control specifies the list of events that the control should handle. The AsString property of the NAVHostEvent object gives a brief description of the event that occurred including the event's name, identifier and its list of arguments. Each control that the NAVHost host provides its own events, so for what events the hosting control supports consult its documentation. The Version property specifies the NAVHost control's version, which includes the DEMO if you are running the trial version of the control.

Use the following properties to identify/filter the event:

• Name, Indicates the name of the event.
• ID, Indicates the identifier of the event. The ID property may give different values for different versions of hosting control, so you must check for compatibility, so it is not guaranteed that the ID will be unique for any version of the hosting control.
• HostEvents property specifies the list of events to be handled through the control's Event event, else all events are handled ( missing or not set ).

Use the following properties to access the arguments of the event:

• AsString, Gives a brief description of the event including its arguments.
• Arguments, gives a NAVObjectTemplate object, whose Item or Template properties can be used to access the event's argument using the x-script language.