Share via

CommandBarButton.FaceId Property

  • Article
Office Developer Reference

Gets or sets the Id number for the face of a CommandBarButton control. Read/write.

Aa432268.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.FaceId

expression   A variable that represents a CommandBarButton object.

Remarks

The FaceId property dictates the look, not the function, of a command bar button. The Id property of the CommandBarControl object determines the function of the button.

The value of the FaceId property for a command bar button with a custom face is 0 (zero).

Example

This example adds a command bar button to a custom command bar. Clicking this button is equivalent to clicking the Open command on the File menu because the ID number is 23, yet the button has the same button face as the built-in Charting button.

Visual Basic for Applications 
  Set newBar = CommandBars.Add(Name:="Custom2", _
     Position:=msoBarTop, Temporary:=True)
newBar.Visible = True 
Set con = newBar.Controls.Add(Type:=msoControlButton, Id:=23)
con.FaceId = 17

See Also