Form.ControlBox Propriedade

Definição

Obtém ou define um valor que indica se uma caixa de controle é exibida na barra de legenda do formulário.

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 da propriedade

true se o formulário exibir uma caixa de controle no canto superior direito do formulário; caso contrário, false. O padrão é true.

Exemplos

O exemplo a seguir usa as ControlBoxpropriedades , FormBorderStyle, MinimizeBoxMaximizeBox, e StartPosition para criar um formulário que não tenha nenhuma borda ou legenda caixa. O formulário criado neste exemplo pode ser usado para criar uma tela inicial para um aplicativo. O exemplo requer que o método do exemplo seja definido em uma classe de formulário e chamado quando o formulário está sendo inicializado.

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

Comentários

Se a ControlBox propriedade estiver definida truecomo , a caixa de controle será exibida no canto superior direito da barra de legenda. A caixa de controle pode incluir botões minimizar, maximizar e ajudar, além de um botão fechar. Para que a ControlBox propriedade tenha qualquer efeito, você também deve definir a propriedade do FormBorderStyle formulário como FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3Dou FormBorderStyle.FixedDialog.

Se você definir ControlBox como false e também definir a Location propriedade , a Size propriedade do formulário não será atualizada para refletir que a área não cliente do formulário foi ocultada. Para corrigir esse problema, coloque o código que altera a Location propriedade no HandleCreated manipulador de eventos.

Observação

Quando definida falsecomo , a ControlBox propriedade não tem efeito em um formulário filho MDI (interface MDI) exibido maximizado no momento da criação.

Aplica-se a

Confira também