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

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Procesa una tecla 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

Message que se pasa por referencia y que representa el mensaje de ventana que se va a procesar.

keyData

Keys

Uno de los valores de Keys que representa la tecla que se va a procesar.

control

Control

Control al que se aplica la tecla de comando.

Devoluciones

Boolean

true si el control procesó el carácter; en caso contrario, false.

Comentarios

Se llama a este método durante el preprocesamiento del mensaje para controlar las claves de comando. Las claves de comando son claves que siempre tienen prioridad sobre las claves de entrada normales. Entre los ejemplos de teclas de comando se incluyen aceleradores y métodos abreviados de menú. El método debe volver true para indicar que ha procesado la clave de comando o false para indicar que la clave no es una clave de comando. Solo se llama a este método cuando el control se hospeda en una aplicación de Windows Forms o como un control ActiveX.

El ProcessCmdKey método determina primero si el control tiene un ContextMenuy, si es así, permite ContextMenu que procese la clave de comando. Si la tecla de comando no es un acceso directo de menú y el control tiene un elemento primario, la clave se pasa al método del ProcessCmdKey elemento primario. El efecto neto es que las teclas de comando se "propagan" hacia arriba en la jerarquía de controles. Además de la tecla presionada por el usuario, los datos de la tecla también indican qué teclas modificadoras se presionaron al mismo tiempo que la tecla. Las teclas modificadoras incluyen las teclas MAYÚS, CTRL y ALT.

Notas a los desarrolladores de herederos

Al invalidar el ProcessCmdKey(Message, Keys) método en una clase derivada, un control debe devolver true para indicar que ha procesado la clave. Para las claves que el control no procesa, se debe devolver el resultado de llamar al método de ProcessCmdKey(Message, Keys) la clase base. Los controles rara vez, si alguna vez, necesitan invalidar este método.