Form.ActiveForm Eigenschaft

Definition

Ruft das momentan aktive Formular für diese Anwendung ab.

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

Eigenschaftswert

Form

Ein Form-Objekt, das das momentan aktive Formular darstellt, oder null, wenn es kein aktives Formular gibt.

Beispiele

Im folgenden Beispiel wird das aktive Formular aufgerufen und alle Steuerelemente im Formular deaktiviert. Im Beispiel wird die Controls Auflistung des Formulars verwendet, um jedes Steuerelement im Formular durchlaufen und die Steuerelemente zu deaktivieren.

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

Hinweise

Sie können diese Methode verwenden, um einen Verweis auf das aktuell aktive Formular abzurufen, um Aktionen für das Formular oder dessen Steuerelemente auszuführen.

Wenn Ihre Anwendung eine MDI-Anwendung (Multiple-Document Interface, MDI) ist, verwenden Sie die ActiveMdiChild Eigenschaft, um das aktuell aktive MDI-untergeordnete Formular abzurufen.

Gilt für

Siehe auch