OFF98: How to Change the ToolTip for a Custom Toolbar

MORE INFORMATION

Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements. To change the ToolTip for a custom toolbar button, specify the toolbar (command bar), the custom toolbar control (a button in this example), and the ToolTip that you want to change or set. The example creates a toolbar button called "My Custom Button" on the Microsoft Excel Standard toolbar. This button is used in the Visual Basic for Applications example.

To use this example, follow these steps:

1. On the Excel Tools menu, click Customize.
2. Click the Commands tab. Click Macros in the Categories list. In the Commands list, click and hold the Custom Button and drag it to the Standard toolbar.
3. Click Modify Selection. On the Shortcut menu that appears, type My Custom Button in the Name box. Click Close in the Customize dialog box.

The following example macro changes the ToolTip for "My Custom Button" on the Excel Standard toolbar:

   Sub ChangeToolTip()

      With CommandBars("Standard")          ' The toolbar (command bar).
         With .Controls("My Custom Button") ' The custom control.
            .TooltipText = "My Custom Tip"  ' The ToolTip to change or set.
         End With
      End With

   End Sub
				

Note that you specify the name of the custom or existing toolbar (instead of Standard). To determine the name of an existing toolbar, point to Toolbars on the View menu. The name of the toolbar appears in the list that is displayed. Remember to type the name of the toolbar in the macro exactly as it appears on the list.

You must also specify the button index or name of the control you want to change. To determine the name of an existing custom control, follow these steps:

1. On the Tools menu, click Customize.
2. While the Customize dialog box is displayed, click to select the toolbar control.
3. On the Customize dialog box, click Modify Selection.
   
   The toolbar control name is listed in the Name box on the Modify Selection shortcut menu.