Form.ControlBox Propriedade

Definição

Recebe ou define um valor que indica se uma caixa de controlo é exibida na barra de legendas 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 de Propriedade

true se o formulário mostrar uma caixa de controlo no canto superior direito do formulário; caso contrário, false. A predefinição é true.

Exemplos

O exemplo seguinte usa as ControlBoxpropriedades , FormBorderStyle, MaximizeBox, MinimizeBox, e StartPosition para criar um formulário que não tem qualquer borda ou caixa de legenda. O formulário criado neste exemplo pode ser usado para criar um ecrã de abertura para uma aplicação. O exemplo exige que o método do exemplo seja definido numa classe de formulário e chamado quando o formulário está a ser 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

Observações

Se a ControlBox propriedade estiver definida para true, a caixa de controlo é exibida no canto superior direito da barra de legendas. A caixa de controlo pode incluir botões de minimizar, maximizar e ajudar, além de um botão de fechar. Para que a ControlBox propriedade tenha algum efeito, deve também definir a propriedade do FormBorderStyle formulário para FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3D, ou FormBorderStyle.FixedDialog.

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

Note

Quando definida para false, a ControlBox propriedade não tem efeito numa forma de filho de interface de múltiplos documentos (MDI) que é exibida como maximizada no momento da criação.

Aplica-se a

Ver também