Control.ProcessCmdKey(Message, Keys) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Обрабатывает клавишу для команд.
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, который представляет сообщение окна для обработки.
Возвращаемое значение
Значение true
, если знак был обработан элементом управления; в противном случае — значение false
.
Комментарии
Этот метод вызывается во время предварительной обработки сообщений для обработки ключей команд. Ключи команд — это ключи, которые всегда имеют приоритет над обычными входным ключами. Примеры клавиш команд включают ускорители и сочетания клавиш меню. Метод должен вернуться true
, чтобы указать, что он обработал ключ команды или false
указывает, что ключ не является ключом команды. Этот метод вызывается только в том случае, если элемент управления размещается в приложении Windows Forms или в качестве элемента ActiveX.
Сначала ProcessCmdKey метод определяет, имеет ContextMenuли элемент управления и, если да, позволяет ContextMenu обработать ключ команды. Если клавиша команды не является контекстным меню и элемент управления имеет родительский элемент управления, ключ передается методу родительского ProcessCmdKey элемента. Чистый эффект заключается в том, что ключи команд "пузырьк" вверх по иерархии элементов управления. В дополнение к нажатию клавиши пользователь также указывает, какие, если таковые есть, клавиши-модификаторы были нажаты одновременно с ключом. Клавиши-модификаторы включают клавиши SHIFT, CTRL и ALT.
Примечания для тех, кто наследует этот метод
При переопределении ProcessCmdKey(Message, Keys) метода в производном классе элемент управления должен вернуться true
, чтобы указать, что он обработал ключ. Для ключей, которые не обрабатываются элементом управления, должен быть возвращен результат вызова метода базового класса ProcessCmdKey(Message, Keys) . Элементы управления редко переопределяют этот метод.