Control.ProcessCmdKey(Message, Keys) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przetwarza klucz polecenia.

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

Parametry

msg: Message

Element Message, przekazany przez odwołanie, który reprezentuje komunikat okna do przetworzenia.

keyData: Keys

Keys Jedna z wartości reprezentujących klucz do przetworzenia.

Zwraca

Boolean

true jeżeli znak został przetworzony przez kontrolkę; w przeciwnym razie , false.

Uwagi

Ta metoda jest wywoływana podczas wstępnego przetwarzania komunikatów w celu obsługi kluczy poleceń. Klucze poleceń to klucze, które zawsze mają pierwszeństwo przed zwykłymi kluczami wejściowymi. Przykładami kluczy poleceń są akceleratory i skróty menu. Metoda musi wrócić true , aby wskazać, że przetworzyła klucz polecenia lub false wskazać, że klucz nie jest kluczem polecenia. Ta metoda jest wywoływana tylko wtedy, gdy kontrolka jest hostowana w aplikacji Windows Forms lub jako kontrolka ActiveX.

Metoda ProcessCmdKey najpierw określa, czy kontrolka ma ContextMenuelement , a jeśli tak, umożliwia ContextMenu przetwarzanie klucza polecenia. Jeśli klucz polecenia nie jest skrótem menu, a kontrolka ma element nadrzędny, klucz jest przekazywany do metody elementu nadrzędnego ProcessCmdKey . Efekt netto polega na tym, że klucze poleceń są "bąbelkowe" w górę hierarchii sterowania. Oprócz klawisza naciśniętego przez użytkownika dane klucza wskazują również, które, jeśli istnieją, klawisze modyfikujące zostały wciśnięte w tym samym czasie co klawisz . Klawisze modyfikujące obejmują klawisze SHIFT, CTRL i ALT.

Uwagi dotyczące dziedziczenia

Podczas zastępowania ProcessCmdKey(Message, Keys) metody w klasie pochodnej kontrolka powinna wrócić true , aby wskazać, że przetworzyła klucz. W przypadku kluczy, które nie są przetwarzane przez kontrolkę, należy zwrócić wynik wywołania metody klasy ProcessCmdKey(Message, Keys) bazowej. Kontrolki rzadko, jeśli kiedykolwiek, muszą zastąpić tę metodę.

Dotyczy