Form.ActiveForm Propriété

Définition

Obtient le formulaire actuellement actif pour cette application.Gets the currently active form for this application.

public:
 static property System::Windows::Forms::Form ^ ActiveForm { System::Windows::Forms::Form ^ get(); };
public static System.Windows.Forms.Form ActiveForm { get; }
member this.ActiveForm : System.Windows.Forms.Form
Public Shared ReadOnly Property ActiveForm As Form

Valeur de propriété

Form représentant le formulaire actuellement actif, ou null si aucun formulaire n'est actif.A Form that represents the currently active form, or null if there is no active form.

Exemples

L’exemple suivant obtient le formulaire actif et désactive tous les contrôles du formulaire.The following example gets the active form and disables all the controls on the form. L’exemple utilise la collection Controls du formulaire pour itérer au sein de chaque contrôle sur le formulaire et désactiver les contrôles.The example uses the Controls collection of the form to iterate through each control on the form and disable the controls.

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

Remarques

Vous pouvez utiliser cette méthode pour obtenir une référence au formulaire actuellement actif afin d’effectuer des actions sur le formulaire ou ses contrôles.You can use this method to obtain a reference to the currently active form to perform actions on the form or its controls.

Si votre application est une application d’interface multidocument (MDI, multiple-document interface), utilisez la propriété ActiveMdiChild pour obtenir le formulaire enfant MDI actif.If your application is a multiple-document interface (MDI) application, use the ActiveMdiChild property to obtain the currently active MDI child form.

Sécurité

UIPermission
pour demander un formulaire.for requesting a form. Énumération associée : AllWindows.Associated enumeration: AllWindows.

S’applique à

Voir aussi