ComponentOne Menus and Toolbars for WinForms
Design-Time Support / Command Smart Designer / Smart Designer Floating Toolbars / C1CommandMenu Toolbar
In This Topic
    C1CommandMenu Toolbar
    In This Topic

    The C1CommandMenu toolbar appears for the submenu items in the C1CommandMenu of the C1MainMenu and C1ToolBar controls.

    Exposing the C1CommandMenu Toolbar

    To expose the C1CommandMenu toolbar, select the C1CommandMenu item and its submenu items in the C1ToolBar or C1MainMenu control, and click on the open button, button, to open the floating C1CommandMenu toolbar like the following image:


    C1CommandMenu Toolbar

    C1CommandMenu Toolbar Buttons

    The C1CommandMenu toolbar consists of the following command buttons:

    Toolbar Button Description
    Add new command link Add new command link/command: Adds an empty command link and opens the Link to Command dialog box for you to create a new command/command link for the empty command.
    Edit command links Edit command links: Opens the C1CommandLink Collection Editor with the current command link in the Members list box for you to edit.
    Edit command properties Edit command properties: Opens the C1CommandMenu Command properties dialog box where you can modify the selected command's properties.
    Edit menu appearance Edit menu appearance: Opens the C1CommandMenu Appearance dialog box where you can modify the appearance properties for the selected command.
    Edit side caption properties Edit side caption properties: Opens the C1CommandMenu FormCaption properties dialog box where you can modify the properties for the side caption in the selected menu and its submenus.

    Insert command link

    Clicking on the Add new command link/command button adds an empty command link and opens the Link to Command dialog box for you to create a new command/command link for the empty command.

    Edit command links

    Clicking on the Edit command links button opens the C1CommandLink Collection Editor with the current command link in the Members list box for you to edit.

    Edit command properties

    Clicking on the Edit command properties button opens the C1CommandMenu Command properties dialog box where you can modify the selected command's properties.


    C1CommandMenu Command properties dialog box

    The following table defines the items included in the C1CommandMenu Command properties dialog box:

    Item Description
    General
    Text The Text textbox displays the text name that appears on the selected command. To rename the text name for the command, select the text in the Text textbox and type the desired text name.
    Show text as tooltip The Show text as Tooltip check box displays the value of the C1Command.Text property as the ToolTip when the check box is selected.
    Tooltip The Tooltip textbox displays ToolTip that appears on the selected command. If there is no ToolTip defined, then the ToolTip textbox is empty. To modify or create a ToolTip, enter text in the ToolTip textbox.
    Shortcut The Shortcut drop-down box displays a list of keys for you to select from to associate a keyboard shortcut with the selected command.
    Show shortcut The Show shortcut check box indicates whether the shortcut for the selected command will be shown. The C1Command.ShowShortCut is enabled by default.
    Category The Category drop-down list box displays the category for the selected command.
    C1ContextMenu The C1ContextMenu drop-down list box displays the name(s) of the C1ContextMenu(s) so you can easily select the C1ContexMenu you want to associate with the selected command.
    Image
    Icon The Icon drop-down list box opens an Open dialog box for you to locate the icon to attach to the selected command.
    Image The Image drop-down list box displays the current image attached to the selected command. Clicking on the drop-down arrow opens the Open dialog box where you can locate the image you would like to associate with the selected command.
    Image Index The Image index drop-down list box displays the index value of the command image.
    Behavior
    Visible The Visible check box indicates whether the selected command will be shown at run time. By default, the C1Command.Visible property is set to True.
    Enabled The Enabled check box indicates whether the selected command will be enabled at run time. By default, the C1Command.Enabled property is set to True.
    Pressed The Pressed check box indicates whether the selected command is pressed. By default, the C1Command.Pressed property is set to True.
    Show drop down arrow The Show drop down arrow check box indicates whether or not to show the drop down arrow when the selected command is in a toolbar.
    Checked The Checked check box indicates whether or not the command is checked.
    Auto-toggle checked state The Auto-toggle checked state check box indicates whether the C1Command.Checked property is toggled automatically when this command in invoked.
    Reset properties to default Selecting the Reset properties to default item resets the modified C1CommandMenu Command properties back to their default values.

    Edit menu appearance

    Clicking on the Edit menu appearance button opens the C1CommandMenu Appearance dialog box where you can modify the appearance properties for the selected command.

    Command menu

    The following table defines the items included in the C1CommandMenu Appearance properties dialog box:

    Item Description
    General
    Visual style The Visual style drop-down box contains the following items for you to select from to change the style of the menu control: Custom, System, Office2007Blue, Office2007Black, Office2007Silver, Office2003Blue, Office2003Olive, Office2003Silver, OfficeXP, Classic, and WindowsXP.
    Font The Font drop-down box opens the Font dialog box where you can modify the Font style properties for the menu.
    Colors
    Foreground The Foreground drop-down list box contains the Custom, System, and Web colors for you to select from to set the Foreground color for the menu control.
    Highlight (Foreground) The Highlight drop-down box contains the Custom, System, and Web colors for you to select from to set the text color of the highlighted item.
    Background The Background drop-down box contains the Custom, System, and Web colors for you to select from to set the base background color of the menu.
    Highlight (Background) The Highlight drop-down list box contains the Custom, System, and Web colors for you to select from to set the base back color of the highlighted item in the menu.
    Background Image
    Image The Image drop-down box opens an Open dialog box where you can apply the background image used for the command.
    Layout The Layout drop-down box opens a list of layout items (None, Tile, Center, Stretch, and Zoom) for you to select from that gets the background image layout for the menu.
    Menu behavior
    Close menu on item click When the Close menu on item click check box is selected, it closes the submenu item after it's clicked at run time.
    Show tooltips on items When the Show tooltips on items check box is selected, it displays the ToolTips on the menu items at run time.
    Hide rarely used items When the Hide rarely used items check box is selected, it hides the rarely used menu items at run time.
    Separate bar for check marks When the Separate bar for check marks check box is selected, it shows check marks instead of images in a separate bar.
    Large menu display When the Large menu display check box is selected, it determines the way the large menus (when all items cannot fit in one column) are displayed.
    Image bar width When the Image bar width check box is selected, it gets or sets the width of the image/check box bar in the menu. If set to 0, the width is calculated automatically.
    Reset properties to default Selecting the Reset properties to default item resets the modified C1CommandMenu appearance properties back to their default values.

    Edit side caption properties

    Clicking on the Edit side caption properties button opens the C1CommandMenu FormCaption properties dialog box where you can modify the properties for the side caption in the selected menu and its submenus.
    Command menu window

    The following table defines the items included in the C1CommandMenu FormCaption dialog box:

    Item Description
    Text
    Text The Text textbox displays the text name that appears in the side caption of the selected C1CommandMenu. To rename the text name for the side caption, select the text in the Text textbox and type the desired text name.
    Direction The Direction drop-down box displays a list box that contains different values (Default, Horizontal, VerticalLeft, VerticalRight) for the text direction in the SideCaption for you to select from.
    Font The Font drop-down box opens the Font dialog box where you can modify the Font style properties for the SideCaption.
    Alignment The Alignment drop-down box displays a list box that contains the text alignment options (near, far, or center) for you to select from to specify the text alignment in the SideCaption.
    Color The Color drop-down box displays custom, web, and system colors for you to select from to set the text color of the SideCaption.
    Text-image relation The Text-image relation drop-down box displays a list box that contains different values (TextAbove, TextBelow, TextOnLeft, TextOnRight) for the text layout in the SideCaption for you to select from.
    Appearance
    Image The Image gets or sets the image for the SideCaption.
    Image index The Image index gets or sets the index of the image for the SideCaption in the C1CommandHolder.ImageList.
    Icon The Icon drop-down box opens the Open dialog box where you can select the icon for the SideCaption.
    Bar width The Bar width gets or sets the width of the image/check box bar in the menu. If set to 0, the width is calculated automatically.
    Gradient
    From The From drop-down box opens the custom, web, and system colors for you to choose from to set the beginning color of the gradient for the SideCaption.
    To The To drop-down box opens the custom, web, and system colors for you to choose from to set the ending color of the gradient for the SideCaption.
    Direction The Direction drop-down box includes different gradient directions (horizontal, vertical, forward diagonal, or backward diagonal) for you to set the type of gradient direction in the SideCaption.
    Reset properties to default Selecting the Reset properties to default item resets the modified C1CommandMenu FormCaption properties back to their default values.
    See Also