Creating and Settings Up Event Handler

Event handler is a Fore unit. Event handler provides a possibility to set actions when a particular event occurs enhancing functionalities of the workspace.

Creating Event Handler Automatically

To create an event handler, select the Event Handler > Create > Create Fore Unit item on the Home ribbon tab.

An event handler can also be created in the Event Handling dialog box. Select the Event Handler > Setup item on the Home ribbon tab. In the dialog box that opens select the Create > Create Fore Unit item.

After executing those actions, the standard dialog box to select object in object navigator opens:

Created unit or assembly contain ready structure where there are all events for workspace:

Class EventsClass: WorkspaceEvents
    Public Sub OnBeforeOpenWorkspace(WorkspaceArgs: IUiWorkspaceCancelEventArgs);
    Begin
    End Sub OnBeforeOpenWorkspace;

    Public Sub OnBeforePrintWorkspace(WorkspaceArgs: IUiWorkspaceCancelEventArgs);
    Begin
    End Sub OnBeforePrintWorkspace;

    Public Sub OnAfterPrintWorkspace(WorkspaceArgs: IUiWorkspaceEventArgs);
    Begin
    End Sub OnAfterPrintWorkspace;

    Public Sub OnBeforeExportWorkspace(WorkspaceArgs: IUiWorkspaceExportCancelEventArgs);
    Begin
    End Sub OnBeforeExportWorkspace;

    Public Sub OnAfterExportWorkspace(WorkspaceArgs: IUiWorkspaceExportEventArgs);
    Begin
    End Sub OnAfterExportWorkspace;

    Public Sub OnBeforeSaveWorkspace(WorkspaceArgs: IUiWorkspaceCancelEventArgs);
    Begin
    End Sub OnBeforeSaveWorkspace;

    Public Sub OnBeforeCreateShape(WorkspaceArgs: IUiWorkspaceShapeCancelEventArgs);
    Begin
    End Sub OnBeforeCreateShape;

    Public Sub OnAfterCreateShape(WorkspaceArgs: IUiWorkspaceShapeEventArgs);
    Begin
    End Sub OnAfterCreateShape;

    Public Sub OnBeforeDeleteShape(WorkspaceArgs: IUiWorkspaceShapeCancelEventArgs);
    Begin
    End Sub OnBeforeDeleteShape;

    Public Sub OnAfterDeleteShape(WorkspaceArgs: IUiWorkspaceShapeEventArgs);
    Begin
    End Sub OnAfterDeleteShape;

End Class EventsClass;

Connecting Event Handler

To connect event handler, select the Event Handler > Set Up item on the Home ribbon tab:

In the dialog box that opens select unit and class where an event handler is located:

To set up and edit events in the development environment, click the Open in the Development Environment button.

Example of Unit

Executing the example requires that the unit contains the Eventclass class. Add links to the Ui and Workspace system assemblies.

Class EventsClass: WorkspaceEvents
    Public Sub OnBeforeOpenWorkspace(Args: IUiWorkspaceCancelEventArgs);
    Begin
        Winapplication.InformationBox("Message before opening workspace");
        Args.Cancel := False;
    End Sub OnBeforeOpenWorkspace;
End Class EventsClass;

As a result of event handler work, the specific message is displayed before opening the workspace.