Export (0) Print
Expand All

Form.ActiveForm Property

Gets the currently active form for this application.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

Public Shared ReadOnly Property ActiveForm As Form

Property Value

Type: System.Windows.Forms.Form
A Form that represents the currently active form, or Nothing if there is no active form.

You can use this method to obtain a reference to the currently active form to perform actions on the form or its controls.

If your application is a multiple-document interface (MDI) application, use the ActiveMdiChild property to obtain the currently active MDI child form.

The following code example gets the active form and disables all the controls on the form. The example uses the Controls collection of the form to iterate through each control on the form and disable the controls.

Public Sub DisableActiveFormControls()
    ' Create an instance of a form and assign it the currently active form. 
    Dim currentForm As Form = Form.ActiveForm

    ' Loop through all the controls on the active form. 
    Dim i As Integer 
    For i = 0 To currentForm.Controls.Count - 1
        ' Disable each control in the active form's control collection.
        currentForm.Controls(i).Enabled = False 
    Next i
End Sub 'DisableActiveFormControls

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft