Form.ControlBox Form.ControlBox Form.ControlBox Form.ControlBox Property

Definition

Ruft einen Wert ab, der angibt, ob auf der Beschriftungsleiste des Formulars ein Systemmenüfeld angezeigt wird, oder legt diesen Wert fest.Gets or sets a value indicating whether a control box is displayed in the caption bar of the form.

public:
 property bool ControlBox { bool get(); void set(bool value); };
public bool ControlBox { get; set; }
member this.ControlBox : bool with get, set
Public Property ControlBox As Boolean

Eigenschaftswert

true, wenn das Formular in der oberen rechten Ecke des Formulars ein Steuerelement Feld anzeigt. falseandernfalls.true if the form displays a control box in the upper-right corner of the form; otherwise, false. Die Standardeinstellung ist true.The default is true.

Beispiele

Im folgenden Beispiel wird die ControlBox- FormBorderStyleEigenschaft MaximizeBox, MinimizeBoxdie- StartPosition Eigenschaft und die-Eigenschaft verwendet, um ein Formular zu erstellen, das keine Rahmen-oder Beschriftungs Felder aufweist.The following example uses the ControlBox, FormBorderStyle, MaximizeBox, MinimizeBox, and StartPosition properties to create a form that does not have any border or caption box. Das in diesem Beispiel erstellte Formular könnte verwendet werden, um einen Begrüßungsbildschirm für eine Anwendung zu erstellen.The form created in this example could be used to create a splash screen for an application. Das Beispiel setzt voraus, dass die-Methode des-Beispiels in einer Formular Klasse definiert und aufgerufen wird, wenn das Formular initialisiert wird.The example requires that the example's method is defined in a form class and called when the form is being initialized.

public:
   void CreateMyBorderlessWindow()
   {
      this->FormBorderStyle = ::FormBorderStyle::None;
      this->MaximizeBox = false;
      this->MinimizeBox = false;
      this->StartPosition = FormStartPosition::CenterScreen;
      // Remove the control box so the form will only display client area.
      this->ControlBox = false;
   }
public void CreateMyBorderlessWindow()
 {
    this.FormBorderStyle = FormBorderStyle.None;
    this.MaximizeBox = false;
    this.MinimizeBox = false;
    this.StartPosition = FormStartPosition.CenterScreen;
    // Remove the control box so the form will only display client area.
    this.ControlBox = false;
 }
 
Public Sub CreateMyBorderlesWindow()
    FormBorderStyle = FormBorderStyle.None
    MaximizeBox = False
    MinimizeBox = False
    StartPosition = FormStartPosition.CenterScreen
    ' Remove the control box so the form will only display client area.
    ControlBox = False
End Sub

Hinweise

Wenn die ControlBox -Eigenschaft auf truefestgelegt ist, wird das Kontrollkästchen in der oberen rechten Ecke der Titelleiste angezeigt.If the ControlBox property is set to true, the control box is displayed in the upper-right corner of the caption bar. Die Kontrollkästchen können neben der Schaltfläche schließen auch die Schaltflächen Minimieren, maximieren und Hilfe enthalten.The control box can include minimize, maximize, and help buttons in addition to a close button. Damit die ControlBox -Eigenschaft eine beliebige Auswirkung hat, müssen Sie auch die- FormBorderStyle Eigenschaft des Formulars FormBorderStyle.FixedSingleauf FormBorderStyle.Sizable, FormBorderStyle.Fixed3D, oder FormBorderStyle.FixedDialogfestlegen.For the ControlBox property to have any effect, you must also set the form's FormBorderStyle property to FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3D, or FormBorderStyle.FixedDialog.

Wenn Sie auf ControlBox false festlegen und auch die Location -Eigenschaft festlegen, Size wird die-Eigenschaft des Formulars nicht aktualisiert, um widerzuspiegeln, dass der nicht-Client Bereich des Formulars ausgeblendet wurde.If you set ControlBox to false and also set the Location property, the Size property of the form is not updated to reflect that the non-client area of the form has been hidden. Um dieses Problem zu beheben, fügen Sie den Code, Location der die- HandleCreated Eigenschaft ändert, in den-Ereignishandler ein.To fix this problem, put the code that alters the Location property in the HandleCreated event handler.

Hinweis

Wenn diese Eigenschaft falseauf fest ControlBox gelegt ist, hat die-Eigenschaft keine Auswirkung auf ein untergeordnetes MDI-Formular (Multiple Document Interface), das zum Zeitpunkt der Erstellung maximiert angezeigt wird.When set to false, the ControlBox property has no effect on a Multiple-document interface (MDI) child form that is displayed maximized at time of creation.

Gilt für:

Siehe auch