Control.ProcessCmdKey(Message, Keys) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Verarbeitet eine Befehlstaste.

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

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.

Gibt zurück

Boolean

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

Hinweise

Diese Methode wird während der Vorverarbeitung von Nachrichten aufgerufen, um Befehlstasten zu behandeln. Befehlstasten sind Tasten, die immer Vorrang vor regulären Eingabetasten haben. Beispiele für Befehlstasten sind Tastenkombinationen und Menüverknüpfungen. Die Methode muss zurückgegeben true werden, um anzugeben, dass sie die Befehlstaste verarbeitet hat, oder false um anzugeben, dass es sich bei der Taste nicht um eine Befehlstaste handelt. Diese Methode wird nur aufgerufen, wenn das Steuerelement in einer Windows Forms Anwendung oder als ActiveX-Steuerelement gehostet wird.

Die ProcessCmdKey Methode bestimmt zuerst, ob das Steuerelement über ein ContextMenuSteuerelement verfügt, und wenn ja, kann die ContextMenu Befehlstaste verarbeitet werden. Wenn die Befehlstaste keine Menüverknüpfung ist und das Steuerelement über ein übergeordnetes ProcessCmdKey Element verfügt, wird die Taste an die Methode des übergeordneten Elements übergeben. Der Nettoeffekt besteht darin, dass Befehlstasten in der Steuerelementhierarchie "blasen" sind. Neben der Taste, die der Benutzer gedrückt hat, gibt die Schlüsseldaten auch an, welche, falls vorhanden, Modifizierertasten gleichzeitig mit der Taste gedrückt wurden. Modifizierertasten umfassen DIE UMSCHALT-, STRG- und ALT-TASTEN.

Hinweise für Vererber

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

Gilt für