Поделиться через

Функция SetInputScopes2 (inputscope.h)

  • Статья

Приложение должно вызвать SetInputScope с IS_DEFAULT перед уничтожением окна, чтобы очистить ссылку на интерфейс.

Синтаксис

HRESULT SetInputScopes2(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] IEnumString      *pEnumString,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

Параметры

[in] hwnd

Окно для настройки область. Этот вызов заменит все область, которые могли быть на hwnd ранее.

[in] pInputScopes

Указатель на массив входных областей. Может иметь значение NULL. Если значение не равно NULL, все области, содержащиеся в , будут заданы в качестве входных область hwnd с одинаковым весовым коэффициентом. Используйте IS_DEFAULT, чтобы принять все остальные входные данные (это параметр "Не принуживать").

[in] cInputScopes

Количество входных областей в pInputScopes. Должно быть равно нулю, если rgScopes имеет значение NULL, должно быть ненулевым, если pInputScopes не равно NULL.

[in] pEnumString

Указатель интерфейса IenumString списка фраз.

[in] pszRegExp

Указатель на строку с завершением NULL, описывающую распознаваемое регулярное выражение. Может иметь значение NULL.

[in] pszSRGS

Указатель на xml-строку, завершающуюся значением NULL, которая предоставляет указания и правила для распознавания речи, связанные с речью. Формат XML соответствует стандарту спецификации грамматики распознавания речи (SRGS), описанной в разделе http://www.w3.org/TR/speech-grammar. Может иметь значение NULL. $

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

Значение Значение
S_OK Входные область успешно заданы или удалены.

Комментарии

Приложение должно вызвать SetInputScope с IS_DEFAULT перед уничтожением окна, чтобы очистить ссылку на интерфейс.

При вызове этого метода в окне (параметр hwnd), не связанном с диспетчером документов, заинтересованным клиентам (например, сенсорной клавиатуре), которые могут захотеть реагировать на изменение область, не будут отправляться текстовые уведомления службы.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header inputscope.h
DLL Msctf.dll