Property Grid

The property grid allows editing the various properties of the tools and CommandBars. The tree view (3) or the list of command (4) is kept up to date with any property changes.

Customization Dialog : Properties Grid

The command property can be changed by clicking on the button displayed when selecting the command property. This will display the following dialog:

By default the command type is set to Macro. The uses a special command class to invoke the entered single PML command. This enables the PML developer to use the interactive customization tool to create their own menus and commandbars without needing to write C# command classes.

Changing the command type to "Core Command" will change the dialog to:

Here a list of the currently loaded CAF Command objects is displayed for selection.

Command Tool Properties

The following properties can be set for all Command Tools:

• ApplicationContext

  • Currently unused

• Arguments

  • List of arguments supplied to the Command

• Caption

  • Text to display on CommandBar

• Command

  • Command to run (see above)

• DisplayStyle

  • Determines how the tool is displayed on the CommandBar

    • Default- The tool is displayed in a default style.

    • DefaultForToolType - The tool is displayed based on the default for the tools type and its location.

    • TextOnlyAlways - The tool is always displayed as text only.

    • TextOnlyInMenus - The Tool is displayed as a graphic when located on a Toolbar, and displayed as text when located on a Menu.

    • ImageAndText - The tool is displayed using its assigned image and text. This setting is ignored when the item is on a top-level menu.

    • ImageOnlyOnToolbars - The Tool is displayed as a graphic when located on a Toolbar, and displayed as image and text when located on a Menu.

• Icon

  • Icon to display on CommandBar

• KeyTip

  • Tip is shown on the ribbon when the Alt key is pressed, aids quick navigation

• Name

  • Unique name for this tool

• Shortcut

  • Shortcut key to activate this tool

• Tooltip

  • Plain tool-tip text to display on mouse-over

• TooltipFormattedText

  • Formatted tool-tip text to display on mouse-over

• TooltipTitle

  • Title for tool-tip

The following properties are available on some Command Tools:

• AutoComplete

  • Sets whether the edit portion is automatically updated to match an item in the list as new characters are typed.

• Control

  • Control embedded in container

• Editable

  • Sets if the text is editable by the user

• MaxLength

  • Maximum number of characters the user is allowed to enter

• Password

  • Display text in password mode (hidden)

• ValueList

  • List of values to display

• Width

  • Tool width on the CommandBar