Form.ControlBox Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.