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

CommandBarButton.Click Event (Office)

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

Occurs when the user clicks a CommandBarButton object.

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."


expression. Click( Ctrl, CancelDefault )

expression A variable that represents a CommandBarButton object.


NameRequired/OptionalData TypeDescription
CtrlRequiredCommandBarButtonRepresents a CommandBar button
CancelDefaultRequiredBooleanIs False if the default behavior associated with the CommandBarButton controls occurs, unless it's canceled by another process or add-in.


The Click event is recognized by the CommandBarButton object. To return the Click event for a particular CommandBarButton control, use the WithEvents keyword to declare a variable, and then set the variable to the control.


The following example creates a command bar button on the File menu of the host application that enables the user to save a workbook as a comma-separated value file. (This example works in all applications, but the context of saving as CSV is applicable to Microsoft Excel.)

Private HostApp As Object 

Sub createAndSynch() 
    Dim iIndex As Integer 
    Dim iCount As Integer 
    Dim fBtnExists As Boolean 

    Dim obCmdBtn As Object 
    Dim btnSaveAsCSVHandler as new Class1 

    Set HostApp = Application 

    Dim barHelp As Office.CommandBar 
    Set barHelp = Application.CommandBars("File") 
    fBtnExists = False  
    iCount = barHelp.Controls.Count 
    For iIndex = 1 To iCount 
        If barHelp.Controls(iIndex).Caption = "Save As CSV (Comma Delimited)" Then fBtnExists = True  

    Dim btnSaveAsCSV As Office.CommandBarButton 
    If fBtnExists Then 
        Set btnSaveAsCSV = barHelp.Controls("Save As CSV (Comma Delimited)") 
        Set btnSaveAsCSV = barHelp.Controls.Add(msoControlButton) 
        btnSaveAsCSV.Caption = "Save As CSV (Comma Delimited)" 
    End If 

    btnSaveAsCSV.Tag = "btn1" 
    btnSaveAsCSVHandler.SyncButton btnSaveAsCSV 
End Sub

See also


CommandBarButton Object

Other resources

CommandBarButton Object Members

© 2018 Microsoft