Form.ControlBox Proprietà

Definizione

Ottiene o imposta un valore che indica se viene visualizzata una casella di controllo nella barra del titolo del 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

Valore della proprietà

true se il modulo visualizza una casella di controllo nell'angolo superiore destro del modulo; in caso contrario, false. Il valore predefinito è true.

Esempio

Nell'esempio seguente vengono usate le ControlBoxproprietà , , MinimizeBoxFormBorderStyleMaximizeBox, e StartPosition per creare un modulo che non ha alcun bordo o didascalia casella. Il modulo creato in questo esempio può essere usato per creare una schermata iniziale per un'applicazione. L'esempio richiede che il metodo dell'esempio sia definito in una classe form e chiamato quando il modulo viene inizializzato.

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

Commenti

Se la proprietà è impostata su true, la ControlBox casella di controllo viene visualizzata nell'angolo superiore destro della barra didascalia. La casella di controllo può includere pulsanti di riduzione, ingrandimento e guida oltre a un pulsante di chiusura. Affinché la proprietà abbia alcun effetto, è necessario impostare anche la ControlBox proprietà del FormBorderStyle modulo su FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3Do FormBorderStyle.FixedDialog.

Se si imposta e si imposta ControlBoxfalse anche la Location proprietà, la Size proprietà del modulo non viene aggiornata per riflettere che l'area non client del modulo è stata nascosta. Per risolvere questo problema, inserire il codice che modifica la Location proprietà nel HandleCreated gestore eventi.

Nota

Se impostato su false, la ControlBox proprietà non ha alcun effetto su un modulo figlio dell'interfaccia a più documenti (MDI) visualizzato ingrandito al momento della creazione.

Si applica a

Vedi anche