Freigeben über


Form.ControlBox Eigenschaft

Definition

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Steuerelementfeld in der Beschriftungsleiste des Formulars angezeigt wird.

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

truewenn das Formular ein Steuerelementfeld in der oberen rechten Ecke des Formulars anzeigt; andernfalls . false Der Standardwert lautet true.

Beispiele

Im folgenden Beispiel werden die ControlBoxEigenschaften , FormBorderStyle, , MaximizeBoxMinimizeBoxund StartPosition die Eigenschaften verwendet, um ein Formular zu erstellen, das kein Rahmen- oder Beschriftungsfeld enthält. 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 true festgelegt ist, wird das Steuerelementfeld in der oberen rechten Ecke der Beschriftungsleiste angezeigt. Das Steuerelementfeld kann neben einer Schaltfläche zum Schließen minimiert, maximiert und unterstützt werden. Damit die ControlBox Eigenschaft auswirkungen kann, müssen Sie auch die Eigenschaft des Formulars FormBorderStyle auf FormBorderStyle.FixedSingle, , FormBorderStyle.Sizable, FormBorderStyle.Fixed3Doder .FormBorderStyle.FixedDialog

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

Hinweis

Wenn diese Eigenschaft auf false festgelegt ist, hat die ControlBox Eigenschaft keine Auswirkungen auf ein untergeordnetes MDI-Formular (Multiple-Document Interface), das zum Zeitpunkt der Erstellung maximiert angezeigt wird.

Gilt für:

Weitere Informationen