Control.ProcessCmdKey(Message, Keys) 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:
virtual bool ProcessCmdKey(System::Windows::Forms::Message % msg, System::Windows::Forms::Keys keyData);protected virtual bool ProcessCmdKey (ref System.Windows.Forms.Message msg, System.Windows.Forms.Keys keyData);abstract member ProcessCmdKey : Message * System.Windows.Forms.Keys -> bool
override this.ProcessCmdKey : Message * System.Windows.Forms.Keys -> boolProtected Overridable Function ProcessCmdKey (ByRef msg As Message, keyData As Keys) As BooleanParâmetros
- msg
- Message
Um Message, passado por referência, que representa a mensagem de janela a ser processada.
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 chaves de entrada regulares. Exemplos de teclas 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 ActiveX.
O ProcessCmdKey método primeiro determina se o controle tem um ContextMenue, em caso afirmativo, permite que o ContextMenu processe a chave de comando. Se a tecla de comando não for um atalho de menu e o controle tiver um pai, a chave será passada para o método pai ProcessCmdKey . 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 teclas modificadoras foram pressionadas ao mesmo tempo que a tecla. As teclas 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 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.
