Control.ProcessCmdKey(Message, Keys) 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 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 -> boolProtected Overridable Function ProcessCmdKey (ByRef msg As Message, keyData As Keys) As BooleanParámetros
- msg
- Message
Message que se pasa por referencia y que representa el mensaje de ventana que se va a procesar.
Devoluciones
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.