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 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, 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 , 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.
