Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

ACC2000: How to Use the CreateControl() and CreateReportControl() Functions


View products that this article applies to.

This article was previously published under Q210595
Advanced: Requires expert coding, interoperability, and multiuser skills.

This article applies to a Microsoft Access database (.mdb) and to a Microsoft Access project (.adp).

↑ Back to the top


Summary

This article discusses the Microsoft Access functions CreateControl() and CreateReportControl(). If you want to write your own form wizards or report wizards, you can use these functions to create controls on a form or report that is open in Design view.

↑ Back to the top


More information

The CreateControl() and CreateReportControl() functions require two arguments: the name of the form or report as a string value, and a numeric code that represents the control type.

Both CreateControl() and CreateReportControl() return a control object value. Therefore, you define a control variable first, and then you set the control variable equal to the function name.

For example, the following procedure creates a form, and then adds a command button to the form:
Dim MyForm As Form, MyControl As Control
Set MyForm = CreateForm()
Set MyControl = CreateControl(MyForm.Name, 104)
				
When the procedure is finished, you can modify the properties of the new control by using the control variable that you defined. For example, you can change the control's Width and Caption properties with these statements:
MyControl.Width = 2000
MyControl.Caption = "&Sum All Records"
				
For controls that are frequently associated with a field in a table or query, you can modify the Control Source property to bind the control to the field.

By default, some controls are created with their Height and Width properties set to zero to make them invisible. Also by default, controls appear in the upper-left corner of the form. You can adjust the size and position of a control immediately after you create it by changing the control's properties. For example, the following code creates, sizes, and moves a text box by changing the properties:
Set MyControl = CreateControl(MyForm.Name, 109)
With MyControl
   .Width = 1500
   .Height = 200
   .Top = 440
   .Left = 200
End With
				
In addition to the form name and the code for the type of control, you can also specify the form or report section in which you want Microsoft Access to place the control.

↑ Back to the top


References

For more information about using Visual Basic code to create a control, in the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type createcontrol, createreportcontrol methods in the Office Assistant or the Answer Wizard, and then click Search to view the topic.

↑ Back to the top


Keywords: KB210595, kbprogramming, kbinfo, kbhowto

↑ Back to the top

Article Info
Article ID : 210595
Revision : 4
Created on : 7/16/2004
Published on : 7/16/2004
Exists online : False
Views : 356