This topic has not yet been rated - Rate this topic

ToolBar.ShowToolTips Property

.NET Framework 3.0

Gets or sets a value indicating whether the toolbar displays a ToolTip for each button.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

[LocalizableAttribute(true)] 
public bool ShowToolTips { get; set; }

/** @property */
public boolean get_ShowToolTips ()

/** @property */
public void set_ShowToolTips (boolean value)

JScript

public function get ShowToolTips () : boolean

public function set ShowToolTips (value : boolean)

XAML

Not applicable.

Property Value

true if the toolbar display a ToolTip for each button; otherwise, false. The default is false.

Remarks

To set the text displayed by the ToolTip, set the ToolTipText property of each ToolBarButton on the ToolBar. To cause the ToolTip to display as the user moves the mouse pointer over the toolbar button, set the ShowToolTips property to true.

Example

The following code example creates a ToolBar control, sets some of its common properties, and adds it to a Form. Delegates are also added to the ButtonClick and ButtonDropDown events. This example requires that a ToolBar named toolBar1 and an ImageList named imageList1 have been declared.

C++

private void AddToolBar()
{
   // Add a toolbar and set some of its properties.
   toolBar1 = new ToolBar();
   toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat;
   toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None;
   toolBar1.Buttons.Add(this.toolBarButton1);
   toolBar1.ButtonSize = new System.Drawing.Size(24, 24);
   toolBar1.Divider = true;
   toolBar1.DropDownArrows = true;
   toolBar1.ImageList = this.imageList1;
   toolBar1.ShowToolTips = true;
   toolBar1.Size = new System.Drawing.Size(292, 25);
   toolBar1.TabIndex = 0;
   toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right;
   toolBar1.Wrappable = false;
   
   // Add handlers for the ButtonClick and ButtonDropDown events.
   toolBar1.ButtonDropDown += 
     new ToolBarButtonClickEventHandler(toolBar1_ButtonDropDown);
   toolBar1.ButtonClick += 
     new ToolBarButtonClickEventHandler(toolBar1_ButtonClicked);

   // Add the toolbar to the form.
   this.Controls.Add(toolBar1);
}

private void AddToolBar()
{
    // Add a toolbar and set some of its properties.
    toolBar1 = new ToolBar();
    toolBar1.set_Appearance(System.Windows.Forms.ToolBarAppearance.Flat);
    toolBar1.set_BorderStyle(System.Windows.Forms.BorderStyle.None);
    toolBar1.get_Buttons().Add(this.toolBarButton1);
    toolBar1.set_ButtonSize(new System.Drawing.Size(24, 24));
    toolBar1.set_Divider(true);
    toolBar1.set_DropDownArrows(true);
    toolBar1.set_ImageList(this.imageList1);
    toolBar1.set_ShowToolTips(true);
    toolBar1.set_Size(new System.Drawing.Size(292, 25));
    toolBar1.set_TabIndex(0);
    toolBar1.set_TextAlign(System.Windows.Forms.ToolBarTextAlign.Right);
    toolBar1.set_Wrappable(false);
    // Add handlers for the ButtonClick and ButtonDropDown events.
    toolBar1.add_ButtonDropDown(new ToolBarButtonClickEventHandler
        (toolBar1_ButtonDropDown));
    toolBar1.add_ButtonClick(new ToolBarButtonClickEventHandler
        (toolBar1_ButtonClicked));
    // Add the toolbar to the form.
    this.get_Controls().Add(toolBar1);
} //AddToolBar

Platforms

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Reference

ToolBar Class
ToolBar Members
System.Windows.Forms Namespace
ToolTip
ToolBarButton

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD