CommandBar.FindControl Method (Office)
Gets a CommandBarControl object that fits a specified criteria.
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 .FindControl(Type, Id, Tag, Visible, Recursive)
expression A variable that represents a CommandBar object.
Parameters
Name |
Required/Optional |
Data Type |
Description |
|---|---|---|---|
Type |
Optional |
Variant |
The type of control. |
Id |
Optional |
Variant |
The identifier of the control. |
Tag |
Optional |
Variant |
The tag value of the control. |
Visible |
Optional |
Variant |
True to include only visible command bar controls in the search. The default value is False. Visible command bars include all visible toolbars and any menus that are open at the time the FindControl method is executed. |
Recursive |
Optional |
Variant |
True to include the command bar and all of its pop-up subtoolbars in the search. This argument only applies to the CommandBar object. The default value is False. |
Return Value
CommandBarControl
Remarks
If the CommandBars collection contains two or more controls that fit the search criteria, FindControl returns the first control that's found. If no control that fits the criteria is found, FindControl returns Nothing.