XL97: How to Assign a Macro to an ActiveX Worksheet Control

 Last reviewed: February 27, 1998
Article ID: Q157416
The information in this article applies to:
  • Microsoft Excel 97 for Windows

SUMMARY

In Microsoft Excel 97, there is no menu command that allows you to assign a macro to an ActiveX control that is on a worksheet. This article provides an example that demonstrates how to create an ActiveX control and assign a macro to the control.

NOTE: If you drag the control to the worksheet from the Forms toolbar, you can right-click the control and click Assign Macro on the shortcut menu.

MORE INFORMATION

Microsoft provides examples of Visual Basic for Applications procedures for illustration only, without warranty either expressed or implied, including, but not limited to the implied warranties of merchantability and/or fitness for a particular purpose. The Visual Basic procedures in this article are provided 'as is' and Microsoft does not guarantee that they can be used in all situations. While Microsoft support engineers can help explain the functionality of a particular macro, they will not modify these examples to provide added functionality, nor will they help you construct macros to meet your specific needs. If you have limited programming experience, you may want to consult one of the Microsoft Solution Providers. Solution Providers offer a wide range of fee-based services, including creating custom macros. For more information about Microsoft Solution Providers, call Microsoft Customer Information Service at (800) 426-9400.

Creating an ActiveX Control with an Assigned Macro

To add an ActiveX control to your worksheet and assign a macro to it, do the following:

  1. Open a new workbook in Microsoft Excel.

  2. If the Control Toolbox toolbar is not visible, point to Toolbars on the View menu, and then click Control Toolbox.

  3. Click the Command Button control on the Control Toolbox toolbar and draw a command button anywhere on the worksheet.

At this point, you are in design mode, which is the time during which no code is running. This is the mode in which you can make changes to the properties of the ActiveX control on the worksheet. To verify that you are in design mode, point to (do not click) Design Mode on the Control Toolbox toolbar. If the ToolTip for this button is "Exit Design Mode," then you are in design mode. If the ToolTip for this button is "Design Mode," then you are not in design mode. If this is the case, click the button.

  1. On the Control Toolbox toolbar, click View Code.

This step starts the Visual Basic Editor and places the cursor in a new module sheet with the following code: 

   Private Sub CommandButton1_Click()

   End Sub

  • Modify the macro so that it looks like the following example: 

       Private Sub CommandButton1_Click()

      MsgBox "hello"

   End Sub

  • On the File menu, click "Close and Return to Microsoft Excel."

    You are still in design mode.

    1. Click Exit Design Mode on the Control Toolbox toolbar.

    2. Click the command button you placed on the worksheet in Step 3.

    A message box that displays "hello" appears.

    1. Click OK.

    Modifying the Control to Start the Macro When Other Events Occur

    You can change the behavior of ActiveX controls such that the control starts the macro when events, other than the Click event, occur. For example, you can start the sample macro when you move the cursor over the control instead of clicking it. To do this for the control you created in the previous section, do the following:

    1. Click Design Mode on the Control Toolbox toolbar.

    2. If it is not selected, click the command button you created in step 3 in the previous section

    3. Click View Code on the Control Toolbox toolbar.

    This step activates the Visual Basic Editor. The cursor is on the macro you created in the previous section.

    1. In the Procedure list, click MouseMove.

    2. Modify the macro such that it looks like the following example: 

            Private Sub CommandButton1_MouseMove _

                (ByVal Button As Integer, ByVal Shift As Integer, _
          ByVal X as Single, ByVal Y as Single)

          MsgBox "mouse moved over button"

      End Sub


    3. On the File menu, click "Close and Return to Microsoft Excel."

      

    You are still in design mode.


    1. Click Exit Design Mode on the Control Toolbox toolbar.


    2. Move the pointer over the command button on the worksheet.

      

    A message box that displays "mouse moved over button" appears.


    1. Click OK.

      

    REFERENCES
    
 

    
For more information about ActiveX controls, click the Index tab in
Microsoft Visual Basic Help, type the following text

    

       Toolbox


    and then double-click the selected text to go to the "Toolbox" topic.

    

	
	
    		• 
	
    

    

    






    

    

	
    


    


Additional query words: XL97
    
Keywords          : kbcode kbprg xlvbahowto xlvbainfo
    
Version           : WINDOWS:97
    
Platform          : WINDOWS
    

    
    

    

    
THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

    

    

    
	
	Last reviewed:  February 27, 1998
	
    
	© 1998 Microsoft Corporation. All rights reserved. Terms of Use.