Form.ControlBox Свойство

Определение

Возвращает или задает значение, указывающее, отображается ли кнопка оконного меню в строке заголовка формы.

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.

Примеры

В следующем примере свойства , FormBorderStyle, MaximizeBox, MinimizeBoxи StartPosition используются ControlBoxдля создания формы без границы или поля подпись. Форму, созданную в этом примере, можно использовать для создания экрана-заставки для приложения. Для этого примера требуется, чтобы метод примера был определен в классе формы и вызывался при инициализации формы.

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, поле управления отображается в правом верхнем углу панели подпись. Поле управления может включать кнопки свернуть, развернуть и справку, а также кнопку закрытия. ControlBox Чтобы свойство могло иметь какое-либо действие, необходимо также задать свойству формы FormBorderStyle значение FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3Dили FormBorderStyle.FixedDialog.

Если задать ControlBox значение false , а также задать Location свойство , Size свойство формы не обновляется, чтобы отразить, что не клиентская область формы была скрыта. Чтобы устранить эту проблему, поместите код, изменяющий Location свойство, HandleCreated в обработчик событий.

Примечание

Если задано значение false, ControlBox свойство не влияет на дочернюю форму многодокументного интерфейса (MDI), которая отображается в развернутом виде во время создания.

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

См. также раздел