ContextMenu.ProcessCmdKey(Message, Keys, Control) Método
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.
Processa uma chave de comando.
protected public:
virtual bool ProcessCmdKey(System::Windows::Forms::Message % msg, System::Windows::Forms::Keys keyData, System::Windows::Forms::Control ^ control);protected internal virtual bool ProcessCmdKey (ref System.Windows.Forms.Message msg, System.Windows.Forms.Keys keyData, System.Windows.Forms.Control control);override this.ProcessCmdKey : Message * System.Windows.Forms.Keys * System.Windows.Forms.Control -> boolProtected Friend Overridable Function ProcessCmdKey (ByRef msg As Message, keyData As Keys, control As Control) As BooleanParâmetros
- msg
- Message
Um Message, passado por referência, que representa a mensagem de janela a ser processada.
- control
- Control
O controle ao qual a chave de comando se aplica.
Retornos
true se o caractere foi processado pelo controle; caso contrário, false.
Comentários
Esse método é chamado durante o pré-processamento de mensagens para manipular chaves de comando. As chaves de comando são chaves que sempre têm precedência sobre as chaves de entrada regulares. Exemplos de chaves de comando incluem aceleradores e atalhos de menu. O método deve retornar true para indicar que processou a chave de comando ou false para indicar que a chave não é uma chave de comando. Esse método só é chamado quando o controle é hospedado em um aplicativo Windows Forms ou como um controle de ActiveX.
O ProcessCmdKey método primeiro determina se o controle tem um ContextMenue, em caso afirmativamente, permite ContextMenu processar a chave de comando. Se a chave de comando não for um atalho de menu e o controle tiver um pai, a chave será passada para o método do ProcessCmdKey pai. O efeito líquido é que as chaves de comando são "borbulhadas" na hierarquia de controle. Além da tecla pressionada pelo usuário, os dados da tecla também indicam quais, se houver, teclas modificadoras foram pressionadas ao mesmo tempo que a tecla. As chaves modificadoras incluem as teclas SHIFT, CTRL e ALT.
Notas aos Herdeiros
Ao substituir o ProcessCmdKey(Message, Keys) método em uma classe derivada, um controle deve retornar true para indicar que ele processou a chave. Para chaves que não são processadas pelo controle, o resultado da chamada do método da ProcessCmdKey(Message, Keys) classe base deve ser retornado. Os controles raramente precisarão substituir esse método.