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

Функция ImmAssociateContextEx (imm.h)

  • Статья

Изменяет связь между контекстом метода ввода и указанным окном или его дочерними элементами.

Синтаксис

BOOL ImmAssociateContextEx(
  [in] HWND  unnamedParam1,
  [in] HIMC  unnamedParam2,
  [in] DWORD unnamedParam3
);

Параметры

[in] unnamedParam1

Дескриптор к окну для связи с контекстом входных данных.

[in] unnamedParam2

Дескриптор в контексте метода ввода.

[in] unnamedParam3

Флаги, указывающие тип связи между окном и контекстом метода ввода. Этот параметр может иметь одно из следующих значений.

Значение Значение
IACE_CHILDREN
 Свяжите контекст метода ввода только с дочерними окнами указанного окна.
IACE_DEFAULT
 Восстановите контекст метода ввода по умолчанию для окна.
IACE_IGNORENOCONTEXT
 Не свяжите контекст метода ввода с окнами, которые не связаны ни с каким контекстом метода ввода.

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

Возвращает значение TRUE в случае успешного выполнения или false в противном случае.

Комментарии

Если приложение вызывает эту функцию с IACE_CHILDREN, операционная система связывает указанный контекст метода ввода с дочерними окнами окна, на которые указывает hWnd. Он связывает контекст метода ввода только с дочерними окнами потока, создающего hWnd. Все дочерние окна, созданные после вызова этой функции, не будут затронуты. Вместо этого с ним будет связан контекст метода ввода по умолчанию.

Если приложение вызывает эту функцию с IACE_DEFAULT, операционная система восстанавливает контекст метода ввода по умолчанию для окна. В этом случае параметр hIMC игнорируется.

Требования

   
Минимальная версия клиента Windows XP [только для классических приложений], установленная поддержка восточноазиатских языков.
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header imm.h (включая Immdev.h, Windows.h)
Библиотека Imm32.lib
DLL Imm32.dll

См. также раздел

Диспетчер методов ввода

Функции диспетчера входных методов