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


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

Задает входной область для указанного окна.

Синтаксис

HRESULT SetInputScope(
  [in] HWND       hwnd,
  [in] InputScope inputscope
);

Параметры

[in] hwnd

Окно для настройки область.

[in] inputscope

Входная область, связанная с окном. Чтобы удалить связь входных область, передайте IS_DEFAULT этому параметру.

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

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

Комментарии

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

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

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

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

Примеры

[C++]

В следующем коде показано, как задать входной область для окна.


SetInputScope(hwnd, IS_EMAIL_USERNAME);

Требования

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