CommandBarControls.Add Method

Creates a new CommandBarControl object and adds it to the collection of controls on the specified command bar.

Namespace:  Microsoft.Office.Core
Assembly:  office (in office.dll)

Syntax

'Declaration
Function Add ( _
    Type As Object, _
    Id As Object, _
    Parameter As Object, _
    Before As Object, _
    Temporary As Object _
) As CommandBarControl
'Usage
Dim instance As CommandBarControls
Dim Type As Object
Dim Id As Object
Dim Parameter As Object
Dim Before As Object
Dim Temporary As Object
Dim returnValue As CommandBarControl

returnValue = instance.Add(Type, Id, Parameter, _
    Before, Temporary)
CommandBarControl Add(
    Object Type,
    Object Id,
    Object Parameter,
    Object Before,
    Object Temporary
)

Parameters

  • Type
    Type: System.Object

    Optional Object. The type of control to be added to the specified command bar. Can be one of the following MsoControlType constants: msoControlButton, msoControlEdit, msoControlDropdown, msoControlComboBox, or msoControlPopup.

  • Id
    Type: System.Object

    Optional Object. An integer that specifies a built-in control. If the value of this argument is 1, or if this argument is omitted, a blank custom control of the specified type will be added to the command bar.

  • Parameter
    Type: System.Object

    Optional Object. For built-in controls, this argument is used by the container application to run the command. For custom controls, you can use this argument to send information to procedures, or you can use it to store information about the control (similar to a second Tag property value).

  • Before
    Type: System.Object

    Optional Object. A number that indicates the position of the new control on the command bar. The new control will be inserted before the control at this position. If this argument is omitted, the control is added at the end of the specified command bar.

  • Temporary
    Type: System.Object

    Optional Object. True to make the new control temporary. Temporary controls are automatically deleted when the container application is closed. The default value is False.

Return Value

Type: Microsoft.Office.Core.CommandBarControl

See Also

Reference

CommandBarControls Interface

CommandBarControls Members

Microsoft.Office.Core Namespace