Compartilhar via


ContextMenu.ProcessCmdKey(Message, Keys, Control) Método

Definição

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 -> bool
Protected Friend Overridable Function ProcessCmdKey (ByRef msg As Message, keyData As Keys, control As Control) As Boolean

Parâmetros

msg
Message

Um Message, passado por referência, que representa a mensagem de janela a ser processada.

keyData
Keys

Um dos valores Keys que representa a chave a ser processada.

control
Control

O controle ao qual a chave de comando se aplica.

Retornos

Boolean

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.

Aplica-se a