Метод ITablet::CreateContext

Создает объект контекста, описывающий указанное устройство планшета.

Синтаксис

HRESULT CreateContext(
  [in]      HWND                    hWnd,
  [in]      RECT                    *prcInput,
  [in]      DWORD                   dwOptions,
  [in]      TABLET_CONTEXT_SETTINGS *pTCS,
  [in]      CONTEXT_ENABLE_TYPE     cet,
  [out]     ITabletContext          **ppCtx,
  [in, out] TABLET_CONTEXT_ID       *pTcid,
  [in, out] PACKET_DESCRIPTION      **ppPD,
  [in]      ITabletEventSink        *pSink
);

Параметры

hWnd [in]

Окно, к которому будет присоединен контекст планшета.

prcInput [in]

[in, unique]

Прямоугольник ввода рукописного ввода.

dwOptions [in]

Флаги, устанавливающие параметры контекста планшета.

pTCS [in]

[in, unique]

Подробные сведения о создаваемом контексте планшета.

cet [in]

Значение, которое включает или отключает отправку контекстных сообщений в окно.

ppCtx [out]

Указатель на созданный контекст планшета.

pTcid [in, out]

Значение, однозначно определяющее планшет.

ppPD [вход, выход]

Указатель на сведения о том, какие данные содержатся в каждом пакете.

pSink [in]

Объект ITabletEventSink , в который будут отправляться уведомления.

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

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Успешно.
E_FAIL	Произошла неизвестная ошибка.

Комментарии

Как правило, приложение получает значения по умолчанию из метода ITablet::GetDefaultContextSettings, изменяет значения в соответствии с потребностями, а затем передает измененную структуру параметров методу ITablet::CreateContext.

Примечание

При вызове метода ITablet::CreateContext необходимо реализовать интерфейс ITabletEventSink.

Параметр dwOptions — это набор битовых флагов, описывающих параметры контекста. В следующей таблице описаны эти флаги.

Имя флага	Значение	Описание
TCXO_MARGIN	0x00000001	Указывает, что входной контекст на планшете будет иметь поле. Поле — это область за пределами указанной области ввода, где события будут сопоставляться с краем области ввода. Эта функция упрощает ввод точек на границе контекста.
TCXO_PREHOOK	0x00000002	Prehook получает пакеты перед обычными контекстами и posthooks. Они получают пакеты в порядке их создания.
TCXO_CURSOR_STATE	0x00000004	TC будет возвращать пакеты, даже если курсор установлен. По умолчанию TC будет возвращать пакеты только при отключении курсора.
TCXO_NO_CURSOR_DOWN	0x00000008	TC не будет возвращать пакеты, когда курсор не работает.
TCXO_NON_INTEGRATED	0x00000010	Контекст будет неинтегрироваться.
TCXO_POSTHOOK	0x00000020	Posthooks получают пакеты после обычных контекстов планшета, но до системного контекста. Они получают пакеты в обратном порядке их создания.
TCXO_DONT_SHOW_CURSOR	0x00000080	TC не установит позицию курсора.
TCXO_DONT_VALIDATE_TCS	0x00000100	TC не будет проверять GUIDS, переданные в параметрах контекста планшета, на соответствие поддерживаемым свойствам устройства.
TCXO_ALLOW_FLICKS	0x00000400	TC позволит выполнять обнаружение щелчков (по умолчанию это разрешено только в системных контекстах), а клиент получит SE_FLICK событий.
TCXO_ALLOW_FEEDBACK_TAPS	0x00000800	TC позволит отображать обратную связь с пером. По умолчанию это разрешено только в системных контекстах.
TCXO_ALLOW_FEEDBACK_BARREL	0x00001000	TC позволит отображать обратную связь с пером. По умолчанию это разрешено только в системных контекстах.
TCXO_ALL	TCXO_MARGIN | TCXO_PREHOOK | TCXO_CURSOR_STATE | TCXO_NO_CURSOR_DOWN | TCXO_NON_INTEGRATED | TCXO_POSTHOOK | TCXO_DONT_SHOW_CURSOR | TCXO_DONT_VALIDATE_TCS	Все определенные параметры контекста планшета.
TCXO_HOOK	TCXO_PREHOOK | TCXO_POSTHOOK	Сочетает в себе функции предварительного перехватчика и после перехватчика.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Библиотека	Wisptis.exe

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

Интерфейс ITablet

Перечисление CONTEXT_ENABLE_TYPE

Структура TABLET_CONTEXT_SETTINGS

Структура PACKET_DESCRIPTION

Интерфейс ITabletContextP

Интерфейс ITabletEventSink