Метод ITfKeystrokeMgr::P reserveKey (msctf.h)
Регистрирует сохраненный ключ.
Синтаксис
HRESULT PreserveKey(
[in] TfClientId tid,
[in] REFGUID rguid,
[in] const TF_PRESERVEDKEY *prekey,
[in] const WCHAR *pchDesc,
[in] ULONG cchDesc
);
Параметры
[in] tid
Содержит идентификатор клиента текстовой службы TSF. Это значение передается текстовой службе TSF в методе ITfTextInputProcessor::Activate .
[in] rguid
Содержит идентификатор GUID команды сохраненного ключа. Это значение передается в текстовый метод службы TSF ITfKeyEventSink::OnPreservedKey для идентификации сохраненного ключа при активации сохраненного ключа.
[in] prekey
Указатель на структуру TF_PRESERVEDKEY , указывающую сохраненный ключ. Элемент uVKey содержит код виртуального ключа, а элемент uModifiers определяет модификаторы сохраненного ключа.
[in] pchDesc
Указатель на строку Юникода, содержащую описание сохраненного ключа. Это значение не может иметь значение NULL , если параметр cchDesc не равен нулю.
[in] cchDesc
Указывает количество символов в pchDesc. Передайте ноль для этого параметра, если описание не требуется.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Значение | Описание |
|---|---|
|
Метод выполнен успешно. |
|
Сохраненный ключ регистрируется. |
|
Один или несколько параметров недопустимы. |
|
Произошла ошибка выделения памяти. |
|
Произошла неизвестная ошибка. |
Комментарии
Сохраненные клавиши регистрируются текстовыми службами TSF и предоставляют сочетания клавиш для стандартных команд, реализованных службой текста TSF.
Требования
| Минимальная версия клиента | Windows 2000 Профессиональная [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows 2000 Server [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | msctf.h |
| DLL | Msctf.dll |
| Распространяемые компоненты | TSF 1.0 в Windows 2000 Professional |
См. также раздел
ITfKeyEventSink::OnPreservedKey
ITfKeystrokeMgr::UnpreserveKey