Skip to main content

Add Toolbar Command

Command: The element adds a command to the toolbar. Because toolbar configurations depend on the startup profile, you need to specify here which profiles should be affected by this change. The affected menu command has to be included in the respective plug-in.

Tip

The PlugIn and ProfileChange components have to be defined earlier in the sequence.

Parameter

Description

Command

Type GUID of the command which is added to the toolbar

InsertionPath

Path of the toolbar to which the command is added

If this toolbar path does not exist yet, then it will be created automatically. A dollar sign ($) can be prepended to the entry so that a localized string of the string table is used.

InsertionPosition

  • Where: Position where the command will be added within the toolbar defined in InsertionPath:

    Last: The new command is added at the last position or on the toolbar.

    First: The new command is added at the first position on the toolbar.

    Before: The new command is added before the command defined below Command. If this command is not defined, then the new command is added at the first position on the toolbar.

    After: The new command is added after the command defined below Command. If this command is not defined, then the new command is added at the last position on the toolbar.

  • Command: This parameter contains the GUID type of the existing command for which the new command should be added. This parameter is necessary when the Where parameter is set to Before or After. It is not necessary when the Where element is set to anything else.

BeginGroup

_cds_icon_checked.png: A separator element is added before the new toolbar element.

Default value: "not enabled" (_cds_icon_option_deactivated.png)

Annotation

Additional comment or information about this element

This information is visible only within the Package Designer.

Requirement: At least version Package Manager 3.5.4.0