ContextMenu.ProcessCmdKey(Message, Keys, Control) 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 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

Boolean

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:

Freigeben über