Control.ProcessCmdKey(Message, Keys) Metoda

Definicja

Przetwarza klucz polecenia.Processes a command key.

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

A Message , przez odwołanie, które reprezentuje komunikat okna do przetworzenia.A Message, passed by reference, that represents the window message to process.

keyData
Keys

Jedna z Keys wartości reprezentujących klucz do przetworzenia.One of the Keys values that represents the key to process.

Zwraca

Boolean

true Jeśli znak został przetworzony przez formant; w przeciwnym razie false .true if the character was processed by the control; otherwise, false.

Uwagi

Ta metoda jest wywoływana podczas przetwarzania wstępnego komunikatów w celu obsługi kluczy poleceń.This method is called during message preprocessing to handle command keys. Klucze poleceń to klucze, które zawsze mają pierwszeństwo przed zwykłymi kluczami wejściowymi.Command keys are keys that always take precedence over regular input keys. Przykłady kluczy poleceń zawierają akceleratory i skróty menu.Examples of command keys include accelerators and menu shortcuts. Metoda musi zostać zwrócona true , aby wskazać, że przetworzył klucz polecenia, lub false Aby wskazać, że klucz nie jest kluczem polecenia.The method must return true to indicate that it has processed the command key, or false to indicate that the key is not a command key. Ta metoda jest wywoływana tylko wtedy, gdy kontrolka jest hostowana w aplikacji Windows Forms lub jako Kontrolka ActiveX.This method is only called when the control is hosted in a Windows Forms application or as an ActiveX control.

ProcessCmdKeyMetoda najpierw określa, czy kontrolka ma ContextMenu , i jeśli tak, umożliwia ContextMenu przetworzenie klucza polecenia.The ProcessCmdKey method first determines whether the control has a ContextMenu, and if so, enables the ContextMenu to process the command key. Jeśli klucz polecenia nie jest skrótem menu, a kontrolka ma element nadrzędny, ten klucz jest przesyłany do metody elementu nadrzędnego ProcessCmdKey .If the command key is not a menu shortcut and the control has a parent, the key is passed to the parent's ProcessCmdKey method. Efektem netto jest to, że klucze poleceń są "bąbelkowe" w hierarchii formantów.The net effect is that command keys are "bubbled" up the control hierarchy. Oprócz klawisza naciśniętego przez użytkownika, dane klucza wskazują również, które klucze modyfikatorów zostały naciśnięte w tym samym czasie co klucz.In addition to the key the user pressed, the key data also indicates which, if any, modifier keys were pressed at the same time as the key. Klawisze modyfikujące obejmują klawisze SHIFT, CTRL i ALT.Modifier keys include the SHIFT, CTRL, and ALT keys.

Uwagi dotyczące dziedziczenia

Podczas zastępowania ProcessCmdKey(Message, Keys) metody w klasie pochodnej formant powinien powrócić, true Aby wskazać, że przetworzył klucz.When overriding the ProcessCmdKey(Message, Keys) method in a derived class, a control should return true to indicate that it has processed the key. W przypadku kluczy, które nie są przetwarzane przez formant, należy zwrócić wynik wywołania metody klasy bazowej ProcessCmdKey(Message, Keys) .For keys that are not processed by the control, the result of calling the base class's ProcessCmdKey(Message, Keys) method should be returned. Kontrolki będą rzadko, jeśli kiedykolwiek trzeba przesłonić tę metodę.Controls will seldom, if ever, need to override this method.

Dotyczy