CreateForm Method

Microsoft Access Visual Basic

CreateForm Method

       
The CreateForm method creates a form and returns a Form object. 

CreateForm([database[, formtemplate]])

The CreateForm method has the following arguments.

Argument Description
database A string expression identifying the name of the database that contains the form template you want to use to create a form. If you want the current database, omit this argument. If you want to use an open library database, specify the library database with this argument.
formtemplate A string expression identifying the name of the form you want to use as a template to create a new form. If you omit this argument, Microsoft Access bases the new form on the template specified by the Forms/Reports tab of the Options dialog box, available by clicking Options on the Tools menu.

Remarks

You can use the CreateForm method when designing a wizard that creates a new form.

The CreateForm method opens a new, minimized form in form Design view.

If the name you use for the formtemplate argument isn't valid, Visual Basic uses the form template specified by the Form Template setting on the Forms/Reports tab of the Options dialog box.

The CreateForm method creates minimized forms and reports.

Example

This example creates a new form in the Northwind sample database based on the Customers form, and sets its RecordSource property to the Customers table. Run this code from the Northwind sample database.
Sub NewForm()
    Dim frm As Form
    
    ' Create form based on Customers form.
    Set frm = CreateForm( , "Customers")
    DoCmd.Restore
    ' Set RecordSource property to Customers table.
    frm.RecordSource = "Customers"
End Sub