Infragistics2.Win.UltraWinToolbars.v8.2
ToolDisplayStyle Enumeration
See Also   Example
Infragistics.Win.UltraWinToolbars Namespace : ToolDisplayStyle Enumeration

Enumerator used to specify the display style of a tool.

Syntax

Visual Basic (Declaration) 
Public Enum ToolDisplayStyle 
   Inherits Enum
C# 
public enum ToolDisplayStyle : Enum

Members

MemberDescription
Default The tool is displayed in a default style based on the resolution hierarchy.
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.

Remarks

Note: This enumeration does not affect tools that are placed on a RibbonGroup. The contents of a tool on a ribbon group are based upon the InstanceProps.PreferredSizeOnRibbon and InstanceProps.MinimumSizeOnRibbon.

Example

The following code creates 2 toolbars and a button tool. It adds an instance of the button tool to each toolbar. It then sets some shared properties on the tool which will affect both tool instances, and then sets some instance properties which just affects one of the instances.

Visual BasicCopy Code
Imports System.Diagnostics
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinToolbars

    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click

        ' ----------------------------------------------------------------------------
        ' Create 2 toolbars and add them to the UltraToolbarManager's toolbars collection.
        Me.UltraToolbarsManager1.Toolbars.AddToolbarRange(New String() {"MyToolbar1", "MyToolbar2"})


        ' ----------------------------------------------------------------------------
        ' Create a button tool and add it to both 'MyToolbar1' and 'MyToolbar2'.
        Dim buttonTool As New ButtonTool("MyButton")

        ' Always add new tools to the UltraToolbarManager's root tools collection
        ' before adding them to menus or toolbars.
        Me.UltraToolbarsManager1.Tools.Add(buttonTool)

        ' Add 1 instance of the tool to 'MyToolbar1' and 1 instance to 'MyToolbar2'.
        Me.UltraToolbarsManager1.Toolbars("MyToolbar1").Tools.AddTool("MyButton")
        Me.UltraToolbarsManager1.Toolbars("MyToolbar2").Tools.AddTool("MyButton")


        ' ----------------------------------------------------------------------------
        ' Change some properties on 'MyButton' that will affect both instances of the
        ' tool. To do this we access the tool's SharedProps object.
        Me.UltraToolbarsManager1.Tools("MyButton").SharedProps.DisplayStyle = ToolDisplayStyle.ImageAndText
        Me.UltraToolbarsManager1.Tools("MyButton").SharedProps.Caption = "Basic Caption"
        Me.UltraToolbarsManager1.Tools("MyButton").SharedProps.AppearancesSmall.Appearance.Image = Bitmap.FromHicon(SystemIcons.Information.Handle)


        ' ----------------------------------------------------------------------------
        ' Change some properties on the instance of 'MyButton' that resides on 'MyToolbar1'.
        ' To do this we get the instance of the tool in 'MyToolbar1' Tools collection
        ' and access its InstanceProps object.
        Me.UltraToolbarsManager1.Toolbars("MyToolbar1").Tools("MyButton").InstanceProps.Caption = "Special Caption"
        Me.UltraToolbarsManager1.Toolbars("MyToolbar1").Tools("MyButton").InstanceProps.IsFirstInGroup = True

    End Sub
C#Copy Code
using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinToolbars;

       private void button1_Click(object sender, System.EventArgs e)
       {

           // ----------------------------------------------------------------------------
           // Create 2 toolbars and add them to the UltraToolbarManager's toolbars collection.
           this.ultraToolbarsManager1.Toolbars.AddToolbarRange(new string [] {"MyToolbar1", "MyToolbar2"} );


           // ----------------------------------------------------------------------------
           // Create a button tool and add it to both 'MyToolbar1' and 'MyToolbar2'.
           ButtonTool buttonTool = new ButtonTool("MyButton");

               // Always add new tools to the UltraToolbarManager's root tools collection
               // before adding them to menus or toolbars.
               this.ultraToolbarsManager1.Tools.Add(buttonTool);

               // Add 1 instance of the tool to 'MyToolbar1' and 1 instance to 'MyToolbar2'.
               this.ultraToolbarsManager1.Toolbars["MyToolbar1"].Tools.AddTool("MyButton");
               this.ultraToolbarsManager1.Toolbars["MyToolbar2"].Tools.AddTool("MyButton");


           // ----------------------------------------------------------------------------
           // Change some properties on 'MyButton' that will affect both instances of the
           // tool.  To do this we access the tool's SharedProps object.
           this.ultraToolbarsManager1.Tools["MyButton"].SharedProps.DisplayStyle    = ToolDisplayStyle.ImageAndText;
           this.ultraToolbarsManager1.Tools["MyButton"].SharedProps.Caption        = "Basic Caption";
           this.ultraToolbarsManager1.Tools["MyButton"].SharedProps.AppearancesSmall.Appearance.Image = Bitmap.FromHicon(SystemIcons.Information.Handle);


           // ----------------------------------------------------------------------------
           // Change some properties on the instance of 'MyButton' that resides on 'MyToolbar1'.
           // To do this we get the instance of the tool in 'MyToolbar1' Tools collection
           // and access its InstanceProps object.
           this.ultraToolbarsManager1.Toolbars["MyToolbar1"].Tools["MyButton"].InstanceProps.Caption            = "Special Caption";
           this.ultraToolbarsManager1.Toolbars["MyToolbar1"].Tools["MyButton"].InstanceProps.IsFirstInGroup    = true;

       }

See Also