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

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

Синтаксис

HRESULT SetInputScopes(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] PWSTR            *ppszPhraseList,
  [in] UINT             cPhrases,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

Параметры

[in] hwnd

Окно для установки область.

[in] pInputScopes

Указатель на массив входных областей. Может иметь значение NULL. Если значение не равно NULL, все области ввода в массиве задаются как входные область окна с равным весом. Используйте IS_DEFAULT, чтобы также принимать все остальные области ввода.

[in] cInputScopes

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

[in] ppszPhraseList

Указатель на массив указателей на фразы, завершаемые значением NULL. Может иметь значение NULL.

[in] cPhrases

Число указателей, на которые указывает **ppszPhraseList, который представляет количество фраз.

[in] pszRegExp

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

[in] pszSRGS

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

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

Значение	Значение
S_OK	Метод выполнен успешно.

Комментарии

Вызов этого метода заменяет все область, связанные с окном.

Этот API работает, только если окно (параметр hwnd) и вызывающий поток находятся в одном потоке. Если вы вызываете этот API для окна другого потока, он завершается сбоем с E_INVALIDARG.

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

Требования

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