Form.ControlBox Form.ControlBox Form.ControlBox Form.ControlBox Property

Definición

Obtiene o establece un valor que indica si se muestra un cuadro de control en la barra de título del formulario.Gets or sets a value indicating whether a control box is displayed in the caption bar of the 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

Valor de propiedad

trueSi el formulario muestra un cuadro de control en la esquina superior derecha del formulario; en caso falsecontrario,.true if the form displays a control box in the upper-right corner of the form; otherwise, false. De manera predeterminada, es true.The default is true.

Ejemplos

En el ejemplo siguiente se ControlBoxusan FormBorderStylelas MaximizeBoxpropiedades MinimizeBox,, StartPosition , y para crear un formulario que no tiene ningún borde o cuadro de título.The following example uses the ControlBox, FormBorderStyle, MaximizeBox, MinimizeBox, and StartPosition properties to create a form that does not have any border or caption box. El formulario creado en este ejemplo se puede usar para crear una pantalla de presentación para una aplicación.The form created in this example could be used to create a splash screen for an application. En el ejemplo se requiere que el método del ejemplo esté definido en una clase de formulario y que se llame al inicializar el formulario.The example requires that the example's method is defined in a form class and called when the form is being initialized.

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 'CreateMyBorderlesWindow

Comentarios

Si la ControlBox propiedad está establecida en true, el cuadro de control se muestra en la esquina superior derecha de la barra de título.If the ControlBox property is set to true, the control box is displayed in the upper-right corner of the caption bar. El cuadro de control puede incluir los botones minimizar, maximizar y ayuda además de un botón Cerrar.The control box can include minimize, maximize, and help buttons in addition to a close button. Para que ControlBox la propiedad tenga algún efecto, también debe establecer la propiedad del FormBorderStyle formulario en FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3Do FormBorderStyle.FixedDialog.For the ControlBox property to have any effect, you must also set the form's FormBorderStyle property to FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3D, or FormBorderStyle.FixedDialog.

Si establece ControlBox en false y también establece la Location propiedad, la Size propiedad del formulario no se actualiza para reflejar que se ha ocultado el área no cliente del formulario.If you set ControlBox to false and also set the Location property, the Size property of the form is not updated to reflect that the non-client area of the form has been hidden. Para corregir este problema, coloque el código que modifica la Location propiedad en el HandleCreated controlador de eventos.To fix this problem, put the code that alters the Location property in the HandleCreated event handler.

Nota

Cuando se establece falseen, ControlBox la propiedad no tiene ningún efecto en un formulario MDI (interfaz de múltiples documentos) secundario que se muestra maximizada en el momento de la creación.When set to false, the ControlBox property has no effect on a Multiple-document interface (MDI) child form that is displayed maximized at time of creation.

Se aplica a

Consulte también: