Control.ProcessCmdKey(Message, Keys) Metoda
Definicja
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.
Zwraca
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ę.