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