Table of contents
TOC
Collapse the table of content
Expand the table of content

CommandBarButton.FaceId Property (Office)

office 365 dev account|Last Updated: 6/12/2017
|
1 Contributor

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

Note The use of CommandBars in some Microsoft Office applications has been superseded by the new ribbon component of the Microsoft Office Fluent 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.

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

Concepts

CommandBarButton Object

Other resources

CommandBarButton Object Members

© 2018 Microsoft