Form.ControlBox Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.