XL97: Problems When you use Macro to Add Control to UserForm

ID: Q157319

The information in this article applies to:

Microsoft Excel 97 for Windows

SYMPTOMS

In Microsoft Excel 97, you may have difficulty adding a control to a UserForm programmatically. For example, if you run the following macro code

   Sub Add_Control_Test()

       Set y = UserForm1.Controls.Add("Forms.CheckBox.1","MyControl",true)

   End Sub

you will not receive an error, but the checkbox control is not added to the UserForm.

CAUSE

The aforementioned macro will not add the control to the UserForm because this syntax for the Add method only applies during run-time. That means you have to include this macro code in an event procedure tied to the UserForm.

RESOLUTION

Microsoft provides programming examples 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. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft Support professionals can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific needs. If you have limited programming experience, you may want to contact the Microsoft fee-based consulting line at (800) 936-5200. For more information about the support options available from Microsoft, please see the following page on the World Wide Web:

   http://www.microsoft.com/support/supportnet/refguide/

If you want use the above macro to add a check box control to a UserForm during run time, do the following:

1. Open a new Microsoft Excel workbook.

2. In the Visual Basic Editor, insert a new UserForm.

3. With the UserForm active, click Code on the View menu.

4. Click the Procedure drop-down in the UserForm1(Code) window and

   select Initialize in the drop-down list.

   The cursor will now be blinking in the middle of a UserForm_Initialize()
   subroutine.

5. Add code to this subroutine so it resembles the following:

   Private Sub UserForm_Initialize()

       Set y = UserForm1.Controls.Add("Forms.CheckBox.1","MyControl",True)

   End Sub

   To verify that the check box control called "MyControl" was added during
   run time, add another on event procedure to the UserForm you inserted in
   step 2.

6. Click the Procedure drop-down in the UserForm1(Code) window and

   select AddControl in the drop-down list.

7. Add code to this subroutine so it resembles the following:

   Private Sub UserForm_AddControl(ByVal Control As MSForms.Control)

       UserForm1.Controls(CheckBox1).Caption = "test"

   End Sub

8. Click the UserForm window to activate the UserForm.

9. Press the F5 key to run the UserForm.

The UserForm will appear in run time with a single check box displayed (the caption on this check box will be "test", without quotation marks).

NOTE: When you dismiss the UserForm, the check box will not remain on the UserForm.

To programmatically add a control to a UserForm so that it becomes part of the UserForm, you must add it during Design Time. To programmatically add a control during Design Time, do the following:

1. Working with the same project from above, click Module on the Insert

   menu to add a module sheet to the project.

2. In the new module sheet, enter the following code:

      Sub Design_time_control()

          Set x = Application.VBE.ActiveVBProject.VBComponents. _
              Item("UserForm1").Designer. _
              Controls.Add("Forms.CheckBox.1", "MyCheckbox", True)

          x.Caption = "test"

      End Sub

3. Place your cursor somewhere within the code you entered in Step 2.

4. Press the F5 key to run the macro.

Your UserForm will have a check box added to it and the caption on the check box will be "test", without quotation marks.

STATUS

Microsoft has confirmed this to be a problem in Microsoft Excel 97 for Windows.

REFERENCES

For more information about adding controls to UserForms programmatically, follow these steps:

1. Insert a UserForm into your project.

2. Click Code on the View menu.

3. On a blank line on the UserForm(code) window type "Add", without

   quotation marks.

4. Highlight the word "Add" you typed in Step 3 and press F1.

The Add Method screen of the Microsoft Forms Reference will appear.

Additional query words: XL97 vbe vba

Keywords          : kbprg kbdta kbdtacode xlvbainfo KbVBA 
Version           : WINDOWS:97
Platform          : WINDOWS
Issue type        : kbhowto

Last Reviewed: May 17, 1999