Freigeben über


ContextMenu.ProcessCmdKey(Message, Keys, Control) Methode

Definition

Verarbeitet eine Befehlstaste.

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

Parameter

msg
Message

Eine als Verweis übergebene Message, die die zu verarbeitende Fenstermeldung darstellt.

keyData
Keys

Einer der Keys-Werte, die die zu verarbeitende Taste darstellen.

control
Control

Das Steuerelement, auf das die Befehlstaste angewendet wird.

Gibt zurück

true, wenn das Zeichen vom Steuerelement verarbeitet wurde, andernfalls false.

Hinweise

Diese Methode wird während der Nachrichtenvorverarbeitung aufgerufen, um Befehlsschlüssel zu verarbeiten. Befehlstasten sind Schlüssel, die immer Vorrang vor regulären Eingabetasten haben. Beispiele für Befehlstasten sind Beschleuniger und Menüverknüpfungen. Die -Methode muss zurückgegeben true werden, um anzugeben, dass sie die Befehlstaste verarbeitet hat, oder false um anzugeben, dass der Schlüssel keine Befehlstaste ist. Diese Methode wird nur aufgerufen, wenn das Steuerelement in einer Windows Forms-Anwendung oder als ActiveX-Steuerelement gehostet wird.

Die ProcessCmdKey -Methode bestimmt zunächst, ob das -Steuerelement über einen ContextMenuverfügt, und wenn ja, ermöglicht die ContextMenu Verarbeitung der Befehlstaste. Wenn die Befehlstaste keine Menüverknüpfung ist und das Steuerelement über ein übergeordnetes Element verfügt, wird der Schlüssel an die -Methode des übergeordneten ProcessCmdKey Elements übergeben. Der Nettoeffekt besteht darin, dass Befehlstasten in der Steuerungshierarchie "aufgeblasen" werden. Zusätzlich zur Taste, die der Benutzer gedrückt hat, geben die Schlüsseldaten auch an, welche Modifizierertasten ggf. gleichzeitig mit der Taste gedrückt wurden. Modifizierertasten umfassen die UMSCHALT-, STRG- und ALT-TASTEN.

Hinweise für Vererber

Beim Überschreiben der ProcessCmdKey(Message, Keys) -Methode in einer abgeleiteten Klasse sollte ein Steuerelement zurückgegeben true werden, um anzugeben, dass der Schlüssel verarbeitet wurde. Für Schlüssel, die nicht vom -Steuerelement verarbeitet werden, sollte das Ergebnis des Aufrufs ProcessCmdKey(Message, Keys) der -Methode der Basisklasse zurückgegeben werden. Steuerelemente müssen diese Methode nur selten außer Kraft setzen.

Gilt für: