Form.ControlBox Propiedad

Definición

Obtiene o establece un valor que indica si se muestra un cuadro de control en la barra de título del formulario.

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

Valor de propiedad

true si el formulario muestra un cuadro de control en la esquina superior derecha del formulario; de lo contrario, false. De manera predeterminada, es true.

Ejemplos

En el ejemplo siguiente se usan las ControlBoxpropiedades , , FormBorderStyleMaximizeBox, MinimizeBoxy StartPosition para crear un formulario que no tenga ningún borde o cuadro subtítulo. El formulario creado en este ejemplo se podría usar para crear una pantalla de presentación para una aplicación. El ejemplo requiere que el método del ejemplo se defina en una clase de formulario y se llame cuando se inicialice el formulario.

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

Comentarios

Si la ControlBox propiedad se establece trueen , el cuadro de control se muestra en la esquina superior derecha de la barra subtítulo. El cuadro de control puede incluir botones minimizar, maximizar y ayudar, además de un botón de cierre. Para que la ControlBox propiedad tenga cualquier efecto, también debe establecer la propiedad del FormBorderStyle formulario en FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3Do FormBorderStyle.FixedDialog.

Si establece ControlBoxfalse en y también establece la Location propiedad , la Size propiedad del formulario no se actualiza para reflejar que el área que no es cliente del formulario se ha ocultado. Para corregir este problema, coloque el código que modifica la Location propiedad en el controlador de HandleCreated eventos.

Nota

Cuando se establece falseen , la ControlBox propiedad no tiene ningún efecto en un formulario secundario de interfaz de varios documentos (MDI) que se muestra maximizado en el momento de la creación.

Se aplica a

Consulte también