Programmatically change the properties of a UIToolControl

Last Published: April 25, 2020


This article shows how to change the caption for a UIToolControl using VBA and ArcObjects.


  1. Start ArcMap.
  2. Open the Visual Basic Editor.

    In ArcMap, select Tools > Macros > Visual Basic Editor.

  3. In the Project Explorer window, expand Project.mxt and select ArcMap Objects > ThisDocument. Right-click and select View Code.
    [O-Image] Visual Basic Project  Explorer
    Code in ThisDocument module will only run in the current map document. To store the code in all your map documents, open the Normal.mxt ThisDocument code module.

  4. Copy the following into the code module.

    Sub ChangeToolProperties()
    Dim pCommandItem As ICommandItem
    Dim pApp As IApplication
    Set pApp = Application
    Set pCommandItem = Project.ThisDocument.CommandBars.Find("Project.UIToolControl1")

    ' Change the tool's caption
    pCommandItem.Style = esriCommandStyleTextOnly
    pCommandItem.Caption = "My Tool"

    ' Refresh the command
    End Sub

  5. Close the Visual Basic Editor.
  6. Run the code.

    A. Click Tools > Macros > Macros to display the Macros dialog box.
    B. Select a macro and click Run.

Article ID:000004951

  • ArcMap 8 x

Get help from ArcGIS experts

Contact technical support

Download the Esri Support App

Go to download options

Discover more on this topic