Share via


CommandBarButton.Id Property

Office Developer Reference

Gets the ID for a built-in CommandBarButton control. Read-only.

Aa432912.vs_note(en-us,office.12).gif  Note
The use of CommandBars in some Microsoft Office applications has been superseded by the new Ribbon user interface. For more information, search help for the keyword "Ribbon."

Syntax

expression.Id

expression   Required. A variable that represents a CommandBarButton object.

Remarks

A control's ID determines the built-in action for that control. The value of the Id property for all custom controls is 1.

Example

This example changes the button face of the first control on the command bar named "Custom2" if the button's ID value is less than 25.

Visual Basic for Applications
  Set ctrl = CommandBars("Custom").Controls(1)
With ctrl
    If .Id < 25 Then
        .FaceId = 17
        .Tag = "Changed control"
    End If
End With

The following example changes the caption of every control on the toolbar named "Standard" to the current value of the Id property for that control.

Visual Basic for Applications
  For Each ctl In CommandBars("Standard").Controls
    ctl.Caption = CStr(ctl.Id)
Next ctl

See Also