Form.ActiveForm Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém o formulário que está ativo para este aplicativo.

public:
 static property System::Windows::Forms::Form ^ ActiveForm { System::Windows::Forms::Form ^ get(); };

public static System.Windows.Forms.Form ActiveForm { get; }

public static System.Windows.Forms.Form? ActiveForm { get; }

member this.ActiveForm : System.Windows.Forms.Form

Public Shared ReadOnly Property ActiveForm As Form

Valor da propriedade

Form

Um Form que representa o formulário ativo, ou null, se não houver nenhum formulário ativo.

Exemplos

O exemplo a seguir obtém o formulário ativo e desabilita todos os controles no formulário. O exemplo usa a Controls coleção do formulário para iterar por meio de cada controle no formulário e desabilitar os controles.

void DisableActiveFormControls()
{
   
   // Create an instance of a form and assign it the currently active form.
   Form^ currentForm = Form::ActiveForm;
   
   // Loop through all the controls on the active form.
   for ( int i = 0; i < currentForm->Controls->Count; i++ )
   {
      
      // Disable each control in the active form's control collection.
      currentForm->Controls[ i ]->Enabled = false;

   }
}

public void DisableActiveFormControls()
 {
    // Create an instance of a form and assign it the currently active form.
    Form currentForm = Form.ActiveForm;
    
    // Loop through all the controls on the active form.
    for (int i = 0; i < currentForm.Controls.Count; i++)
    {
       // Disable each control in the active form's control collection.
       currentForm.Controls[i].Enabled = false;
    }
 }

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

Comentários

Você pode usar esse método para obter uma referência ao formulário ativo atualmente para executar ações no formulário ou em seus controles.

Se o aplicativo for um aplicativo MDI (interface de vários documentos), use a ActiveMdiChild propriedade para obter o formulário filho MDI ativo no momento.

Confira também

• ActiveMdiChild