ControlBox Property

Form.ControlBox Property

Gets or sets a value indicating whether a control box is displayed in the caption bar of the form.

[Visual Basic]
Public Property ControlBox As Boolean
[C#]
public bool ControlBox {get; set;}
[C++]
public: __property bool get_ControlBox();
public: __property void set_ControlBox(bool);
[JScript]
public function get ControlBox() : Boolean;
public function set ControlBox(Boolean);

Property Value

true if the form displays a control box in the upper left corner of the form; otherwise, false. The default is true.

Remarks

If the ControlBox property is set to true, the control box is displayed in the upper-left corner of the caption bar. The control box is where the user can click to access the system menu.

Note   If your form does not display a control box, the form is not able to close using the ALT+F4 keyboard combination.
Note   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.

Example

[Visual Basic, C#, C++] 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. The form created in this example could be used to create a splash screen for an application. The example assumes that the example's method is defined in a form class and called when the form is being initialized.

[Visual Basic] 
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

[C#] 
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;
 }
 

[C++] 
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;
 }
 

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

Form Class | Form Members | System.Windows.Forms Namespace | MaximizeBox | MinimizeBox

Show:
© 2016 Microsoft