Control.ProcessCmdKey(Message, Keys) Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Processa uma tecla 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 janela a processar.

keyData
Keys

Um dos Keys valores que representa a chave para o processo.

Devoluções

Boolean

true se o carácter foi processado pelo controlo; caso contrário, false.

Observações

Este método é chamado durante o pré-processamento de mensagens para tratar as chaves de comando. As teclas de comando são chaves que têm sempre prioridade sobre as teclas de entrada normais. Exemplos de teclas de comando incluem aceleradores e atalhos de menu. O método deve indicar true que processou a chave de comando, ou false indicar que a chave não é uma chave de comando. Este método só é chamado quando o controlo está alojado numa aplicação Windows Forms ou como controlo ActiveX.

O ProcessCmdKey método determina primeiro se o controlo tem um ContextMenu, e, 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 controlo tiver um pai, a chave é passada para o método do ProcessCmdKey pai. O efeito líquido é que as teclas de comando são "remontadas" na hierarquia de controlo. Além da tecla pressionada pelo utilizador, os dados da tecla também indicam quais, se algumas, teclas modificadoras foram pressionadas ao mesmo tempo que a tecla. As teclas modificadoras incluem as teclas SHIFT, CTRL e ALT.

Notas para Herdeiros

Ao sobrescrever o ProcessCmdKey(Message, Keys) método numa classe derivada, um controlo deve voltar true para indicar que processou a chave. Para chaves que não são processadas pelo controlo, o resultado de chamar o método da ProcessCmdKey(Message, Keys) classe base deve ser retornado. Os controlos raramente, se é que alguma vez, terão de sobrepor este método.

Aplica-se a