ContextMenu.ProcessCmdKey(Message, Keys, Control) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Procesa una clave 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 -> boolProtected Friend Overridable Function ProcessCmdKey (ByRef msg As Message, keyData As Keys, control As Control) As BooleanParámetros
- msg
- Message
, Messagepasado por referencia, que representa el mensaje de ventana que se va a procesar.
- control
- Control
Control al que se aplica la clave de comando.
Devoluciones
true si el control procesó el carácter; de lo 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 accesos directos 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. Este método solo se llama 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 cuáles, si existen, las 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.