Form.StartPosition Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

Form.cs

Ruft die Anfangsposition des Formulars zur Laufzeit ab oder legt diese fest.

C#

public System.Windows.Forms.FormStartPosition StartPosition { get; set; }

Eigenschaftswert

FormStartPosition

Eine FormStartPosition, die die Anfangsposition des Formulars darstellt.

Ausnahmen

InvalidEnumArgumentException

Der angegebene Wert liegt außerhalb des gültigen Wertebereichs.

Beispiele

Im folgenden Beispiel wird eine neue Instanz von erstellt Form und die ShowDialog -Methode aufgerufen, um das Formular als Dialogfeld anzuzeigen. Im Beispiel werden die FormBorderStyleEigenschaften , AcceptButton, CancelButtonund StartPosition festgelegt, um die Darstellung und Funktionalität des Formulars in ein Dialogfeld zu ändern. Im Beispiel wird auch die Add -Methode der -Auflistung des Formulars Controls verwendet, um zwei Button Steuerelemente hinzuzufügen. Im Beispiel wird die HelpButton -Eigenschaft verwendet, um eine Hilfeschaltfläche in der Beschriftungsleiste des Dialogfelds anzuzeigen.

C#

public void CreateMyForm()
 {
    // Create a new instance of the form.
    Form form1 = new Form();
    // Create two buttons to use as the accept and cancel buttons.
    Button button1 = new Button ();
    Button button2 = new Button ();
   
    // Set the text of button1 to "OK".
    button1.Text = "OK";
    // Set the position of the button on the form.
    button1.Location = new Point (10, 10);
    // Set the text of button2 to "Cancel".
    button2.Text = "Cancel";
    // Set the position of the button based on the location of button1.
    button2.Location
       = new Point (button1.Left, button1.Height + button1.Top + 10);
    // Set the caption bar text of the form.   
    form1.Text = "My Dialog Box";
    // Display a help button on the form.
    form1.HelpButton = true;
 
    // Define the border style of the form to a dialog box.
    form1.FormBorderStyle = FormBorderStyle.FixedDialog;
    // Set the accept button of the form to button1.
    form1.AcceptButton = button1;
    // Set the cancel button of the form to button2.
    form1.CancelButton = button2;
    // Set the start position of the form to the center of the screen.
    form1.StartPosition = FormStartPosition.CenterScreen;
    
    // Add button1 to the form.
    form1.Controls.Add(button1);
    // Add button2 to the form.
    form1.Controls.Add(button2);
    
    // Display the form as a modal dialog box.
    form1.ShowDialog();
 }

Hinweise

Mit dieser Eigenschaft können Sie die Anfangsposition des Formulars festlegen, wenn es zur Laufzeit angezeigt wird. Die Position des Formulars kann manuell angegeben werden, indem sie die Location -Eigenschaft festlegen oder den von Windows angegebenen Standardspeicherort verwenden. Sie können das Formular auch positionieren, um es in der Mitte des Bildschirms oder in der Mitte des übergeordneten Formulars für Formulare wie MDI-Formulare (Multiple-Document Interface) anzuzeigen.

Diese Eigenschaft sollte festgelegt werden, bevor das Formular angezeigt wird. Sie können diese Eigenschaft festlegen, bevor Sie die - oder ShowDialog -ShowMethode oder im Konstruktor Ihres Formulars aufrufen.

Gilt für:

Weitere Informationen

• FormStartPosition