Form.ControlBox Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob auf der Beschriftungsleiste des Formulars ein Systemmenüfeld angezeigt wird, oder legt diesen Wert fest.

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

Boolean

true , wenn das Formular ein Steuerelementfeld in der oberen rechten Ecke des Formulars anzeigt; falseandernfalls . Der Standardwert ist true.

Beispiele

Im folgenden Beispiel werden die ControlBoxEigenschaften , FormBorderStyle, MaximizeBox, MinimizeBoxund StartPosition verwendet, um ein Formular ohne Rahmen oder Untertitel Feld zu erstellen. Das in diesem Beispiel erstellte Formular kann verwendet werden, um einen Begrüßungsbildschirm für eine Anwendung zu erstellen. Das Beispiel erfordert, dass die -Methode des Beispiels in einer Formularklasse definiert und aufgerufen wird, wenn das Formular initialisiert wird.

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 Steuerelement in der oberen rechten Ecke der Untertitel leiste angezeigt. Das Steuerelement kann neben einer Schaltfläche zum Schließen auch Schaltflächen "Minimieren", "Maximieren" und "Hilfe" enthalten. Damit die ControlBox -Eigenschaft eine Auswirkung hat, müssen Sie auch die -Eigenschaft des Formulars FormBorderStyle auf FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3Doder FormBorderStyle.FixedDialogfestlegen.

Wenn Sie auf false festlegen ControlBox und auch die Location -Eigenschaft festlegen, wird die Size Eigenschaft des Formulars nicht aktualisiert, um anzuzeigen, dass der nicht clientbezogene Bereich des Formulars ausgeblendet wurde. Um dieses Problem zu beheben, fügen Sie den Code, der die Location Eigenschaft ändert, im HandleCreated Ereignishandler ein.

Hinweis

Bei Festlegung auf falsehat die ControlBox Eigenschaft keine Auswirkungen auf ein untergeordnetes MDI-Formular (Multiple-Document Interface), das zum Zeitpunkt der Erstellung maximiert angezeigt wird.

Weitere Informationen

• MaximizeBox
• MinimizeBox
• ShowIcon
• FormBorderStyle
• WindowState