ContextMenu.ProcessCmdKey(Message, Keys, Control) Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

ContextMenu.cs

Обрабатывает ключ команды.

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

Параметры

msg

Message

, Messageпереданный по ссылке, представляющий сообщение окна для обработки.

keyData

Keys

Одно из Keys значений, представляющих ключ для обработки.

control

Control

Элемент управления, к которому применяется ключ команды.

Возвращаемое значение

Boolean

Значение в противном случае .

Комментарии

Этот метод вызывается во время предварительной обработки сообщения для обработки ключей команд. Ключи команд — это ключи, которые всегда имеют приоритет над обычными входным ключами. Примерами клавиш команд являются акселераторы и сочетания клавиш меню. Метод должен вернуться true , чтобы указать, что он обработал ключ команды или false указать, что ключ не является ключом команды. Этот метод вызывается только в том случае, если элемент управления размещается в приложении Windows Forms или в качестве элемента activeX.

Метод ProcessCmdKey сначала определяет, имеет ContextMenuли элемент управления элемент управления и, если да, позволяет ContextMenu обрабатывать ключ команды. Если клавиша команды не является контекстным меню и элемент управления имеет родительский элемент, ключ передается методу родительского элемента ProcessCmdKey . Чистый эффект заключается в том, что ключи команд "пузырьки" вверх по иерархии элементов управления. Помимо нажатия клавиши, данные ключа также указывают, какие, если таковые есть, клавиши модификатора были нажаты одновременно с ключом. Клавиши-модификаторы включают клавиши SHIFT, CTRL и ALT.

Примечания для тех, кто наследует этот метод

При переопределении ProcessCmdKey(Message, Keys) метода в производном классе элемент управления должен вернуться true , чтобы указать, что он обработал ключ. Для ключей, которые не обрабатываются элементом управления, необходимо вернуть результат вызова метода базового класса ProcessCmdKey(Message, Keys) . Элементы управления редко переопределяют этот метод.