Form.ControlBox Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se uma caixa de controle é 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, setPublic Property ControlBox As BooleanValor 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 , , MinimizeBoxFormBorderStyleMaximizeBoxe StartPosition , para criar um formulário que não tem nenhuma borda ou caixa de legenda. 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 como true, a caixa de controle será exibida no canto superior direito da barra de legendas. A caixa de controle pode incluir botões de 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, ou FormBorderStyle.Fixed3DFormBorderStyle.FixedDialog.
Se você definir ControlBoxfalse 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 como false, a ControlBox propriedade não tem efeito em um formulário filho MDI (interface de vários documentos) exibido maximizado no momento da criação.
