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

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

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

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

Параметры

msg
Message

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

keyData
Keys

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

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

Boolean

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

Комментарии

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

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

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

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

Применяется к