Siemens.Collaboration.Net.TiaPortal.AddIn.Extensions 17.0.1685432472

TIA Add-In Extensions

Includes

Siemens Collaboration Add-In Extensions provide extensions for Siemens Engineering types to help you write cleaner and more efficient code.

Installation

• install package Siemens.Collaboration.Net.TiaPortal.AddIn.Extensions and select a matching version (17.* = TIA Portal V17, 18.* = TIA Portal V18)
• reload and build the project

Dependencies

By installing this package, the following package is automatically installed and must not be installed individually.

TIA Add-In Openness References

All Siemens.Engineering.AddIn assemblies are referenced automatically. Please see README for further documentation.

Examples

Messages and Dialogs

Open message box in foreground

var result = AddInMessageBox.Show("Successfully imported all files", "Import done", MessageBoxButton.OK, MessageBoxImage.Information);

Open dialog in foreground

var result = myDialog.ShowDialogInForeground();

Context Menu Item

Catch an exception before an add-in is crashing and handle it in a handler

protected override void BuildContextMenuItems(ContextMenuAddInRoot addInRootSubmenu)
{
    addInRootSubmenu.Items.AddActionItem<IEngineeringObject>("Item 1", ClickDelegate, UpdateStatusDelegate, OnError);
}

/// <summary>
/// Handle errors
/// </summary>
/// <param name="exception">Unhandled exception when executing add-in</param>
private void OnError(Exception exception)
{
    // Show error message
    AddInMessageBox.Show(exception.ToString(), "Error", MessageBoxButton.OK, MessageBoxImage.Error);

    // Write error to file
    //File.WriteAllText("...", exception.ToString());
}

TIA Portal Openness Extensions

Most are available as well. Please see README for further documentation.