Form.Modal Eigenschap

Definitie

Naamruimte:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Bron:

Form.cs

Hiermee wordt een waarde opgehaald die aangeeft of dit formulier modaal wordt weergegeven.

public:
 property bool Modal { bool get(); };

[System.ComponentModel.Browsable(false)]
public bool Modal { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Modal : bool

Public ReadOnly Property Modal As Boolean

Waarde van eigenschap

Boolean

true indien het formulier modaal wordt weergegeven; anders, false.

Kenmerken

BrowsableAttribute

Voorbeelden

In het volgende voorbeeld wordt de Modal eigenschap gebruikt om te bepalen of een formulier wordt weergegeven als een modaal formulier. Als dit niet het FormBorderStyleTopLevel en eigenschappen zijn gewijzigd om het formulier een formulier op het hoogste niveau met een rand van het hulpmiddelvenster te maken.

private:
   void ShowMyNonModalForm()
   {
      Form^ myForm = gcnew Form;
      myForm->Text = "My Form";
      myForm->SetBounds( 10, 10, 200, 200 );
      myForm->Show();

      // Determine if the form is modal.
      if ( !myForm->Modal )
      {
         // Change borderstyle and make it not a top level window.
         myForm->FormBorderStyle = ::FormBorderStyle::FixedToolWindow;
         myForm->TopLevel = false;
      }
   }

private void ShowMyNonModalForm()
{
    Form myForm = new Form();
    myForm.Text = "My Form";
    myForm.SetBounds(10,10,200,200);

    myForm.Show();
    // Determine if the form is modal.
    if (!myForm.Modal)
    {
        // Change borderstyle and make it not a top level window.
        myForm.FormBorderStyle = FormBorderStyle.FixedToolWindow;
        myForm.TopLevel = false;
    }
}

Private Sub ShowMyNonModalForm()
    Dim myForm As New Form()
    myForm.Text = "My Form"
    myForm.SetBounds(10, 10, 200, 200)

    myForm.Show()
    ' Determine if the form is modal.
    If myForm.Modal = False Then
        ' Change borderstyle and make it not a top level window.
        myForm.FormBorderStyle = FormBorderStyle.FixedToolWindow
        myForm.TopLevel = False
    End If
End Sub

Opmerkingen

Wanneer een formulier modaal wordt weergegeven, kan er geen invoer (toetsenbord of muisklik) optreden, behalve voor objecten in het modale formulier. Het programma moet een modaal formulier verbergen of sluiten (meestal in reactie op een bepaalde gebruikersactie) voordat invoer naar een ander formulier kan optreden. Formulieren die modaal worden weergegeven, worden meestal gebruikt als dialoogvensters in een toepassing.

U kunt deze eigenschap gebruiken om te bepalen of een formulier dat u hebt verkregen van een methode of eigenschap modaal is weergegeven.

Als u een formulier modaal wilt weergeven, gebruikt u de ShowDialog methode.

Zie ook

• ShowDialog()