DOCUMENT:Q161156  21-MAR-1997  [vbwin]
TITLE   :HOWTO: Create A Default Event for a UserControl
PRODUCT :Microsoft Visual Basic for Windows
PROD/VER:5.0
OPER/SYS:WINDOWS
KEYWORDS:kbusage vb5all vb5howto VBKBCtrl_VBKBStd kbhowto

======================================================================
------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Visual Basic Control Creation Edition for Windows,
   version 5.0
 - Microsoft Visual Basic Enterprise Edition for Windows,
   version 5.0
------------------------------------------------------------------------

SUMMARY
=======

You can create default events for your User Controls. A default event is
the event selected when you double-click on the control in Design Mode. For
example, when you double-click on a CommandButton, the code window creates
a Sub-procedure for Command_Click. Therefore, click is the default event
for the CommandButton. This article will explain how to create a default
event for a User Control that you create.

MORE INFORMATION
================

To create a default event, first you must create the event by doing the
following:

1. From the Tools menu, select "Add Procedure."

2. In the "Add Procedure" dialog box, enter the Event name, and check the
   Event option in the Type frame.

3. Click the OK button.

NOTE: You must use the RaiseEvent command to actually trigger your event
while the User Control is in use. Creating an event simply creates an
event: it does not add any code that causes the event to occur.

After the event is created, follow these steps to make the event the
default event:

1. From the Tools menu, select "Procedure Attributes."

2. In the "Procedure Attributes" dialog box, select the event name you
   previously entered.

3. Add a Description, if desired, and select the "Advanced>>" button.

4. Select the "User Interface Default" checkbox in the Attributes frame.

When using the User Control in a Visual Basic form, double-clicking on the
Control will create a procedure for the Event you specified.

You can only have one default Event for each Control. Therefore, you can
only select the "User Interface Default" checkbox for one event. If you
select this checkbox for another event, it will ask you if you want to make
the newly-selected event the Default event.

REFERENCES
==========

For additional information on the User Control, please see the following
article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q161208
   TITLE     : How to Create a Default Property for a UserControl
======================================================================
Keywords            : kbusage vb5all vb5howto VBKBCtrl_VBKBStd kbhowto
Version             : 5.0
Platform            : WINDOWS
Issue type          : kbhowto

=============================================================================

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.

Copyright Microsoft Corporation 1997.