Control.ProcessCmdKey(Message, Keys) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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 -> bool

Protected Overridable Function ProcessCmdKey (ByRef msg As Message, keyData As Keys) 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.

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