Form.ControlBox Свойство

Определение

Возвращает или задает значение, указывающее, отображается ли кнопка оконного меню в строке заголовка формы.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

Значение свойства

true, если в форме отображается поле элемента управления в правом верхнем углу формы; в противном случае false.true if the form displays a control box in the upper-right corner of the form; otherwise, false. Значение по умолчанию — true.The default is true.

Примеры

В следующем примере используются свойства ControlBox, FormBorderStyle, MaximizeBox, MinimizeBox и StartPosition для создания формы, не имеющей границ или поля заголовка.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 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

Комментарии

Если свойство ControlBox имеет значение true, поле элемента управления отображается в правом верхнем углу строки заголовка.If the ControlBox property is set to true, the control box is displayed in the upper-right corner of the caption bar. Окно элемента управления может содержать кнопки сворачивания, развернуть и Справка в дополнение к кнопке Закрыть.The control box can include minimize, maximize, and help buttons in addition to a close button. Чтобы свойство ControlBox действовало, необходимо также задать для свойства формы FormBorderStyle значение FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3D или 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.

Если задать для ControlBox значение false, а также задать свойство Location, то свойство формы Size не будет Обновлено, чтобы отразить, что неклиентская область формы была скрыта.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. Чтобы устранить эту проблему, добавьте код, который изменяет свойство Location в обработчике событий HandleCreated.To fix this problem, put the code that alters the Location property in the HandleCreated event handler.

Примечание

Если задано значение false, свойство ControlBox не оказывает влияния на дочернюю форму многодокументного интерфейса (MDI), которая отображается в режиме, развернутой во время создания.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.

Применяется к

Дополнительно