ToolStripDropDownItem.ProcessCmdKey(Message, Keys) Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Processes a command key.

protected public:
 override bool ProcessCmdKey(System::Windows::Forms::Message % m, System::Windows::Forms::Keys keyData);

protected internal override bool ProcessCmdKey (ref System.Windows.Forms.Message m, System.Windows.Forms.Keys keyData);

override this.ProcessCmdKey : Message * System.Windows.Forms.Keys -> bool

Protected Friend Overrides Function ProcessCmdKey (ByRef m As Message, keyData As Keys) As Boolean

Parameters

m

Message

A Message, passed by reference, that represents the window message to process.

keyData

Keys

One of the Keys values that represents the key to process.

Returns

Boolean

false in all cases.

Remarks

This method is called during message preprocessing to handle command keys. Command keys are keys that always take precedence over regular input keys. Examples of command keys include accelerators and menu shortcuts. 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.

The ToolStripDropDownItem implementation of this method calls the ProcessCmdKey of the DropDown if there are items in the DropDownItems collection. Otherwise, this implementation calls the base class implementation.

Notes to Inheritors

When overriding the ProcessCmdKey(Message, Keys) method in a derived class, the method override should return true to indicate that it has processed the key. Derived classes will seldom, if ever, need to override this method.