ITablet::CreateContext (método)

Artículo
06/13/2023

Crea un objeto de contexto que describe el dispositivo de tableta especificado.

Sintaxis

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
);

Parámetros

hWnd [in]

Ventana a la que se conectará el contexto de la tableta.

prcInput [in]

[in, unique]

Rectángulo de entrada de lápiz.

dwOptions [in]

Marcas que establecen opciones de contexto de tableta.

pTCS [in]

[in, unique]

Información detallada sobre el contexto de tableta que se va a crear.

cet [in]

Valor que habilita o deshabilita los mensajes de contexto que se envían a la ventana.

ppCtx [out]

Puntero al contexto de tableta recién creado.

pTcid [in, out]

Valor que identifica de forma única la tableta.

ppPD [in, out]

Puntero a información sobre los datos contenidos en cada paquete.

pSink [in]

Objeto ITabletEventSink donde se enviarán los mensajes de notificación.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
E_FAIL	Se ha producido un error no especificado.

Observaciones

Normalmente, una aplicación obtiene los valores predeterminados del método ITablet::GetDefaultContextSettings, modifica los valores para satisfacer sus necesidades y, a continuación, pasa la estructura de configuración modificada al método ITablet::CreateContext.

Nota

Debe implementar la interfaz ITabletEventSink al llamar al método ITablet::CreateContext.

El parámetro dwOptions es un conjunto de marcas de bits que describen las opciones de contexto. En la tabla siguiente se describen estas marcas.

Nombre de marca	Valor	Descripción
TCXO_MARGIN	0x00000001	Especifica que el contexto de entrada de la tableta tendrá un margen. El margen es un área fuera del área de entrada especificada donde los eventos se asignarán al borde del área de entrada. Esta característica facilita la entrada de puntos en el borde del contexto.
TCXO_PREHOOK	0x00000002	El prehook obtiene paquetes antes de contextos y posthooks normales. Obtienen paquetes en el orden de su creación.
TCXO_CURSOR_STATE	0x00000004	El TC devolverá paquetes incluso si el cursor está arriba. De forma predeterminada, un TC solo devolverá paquetes cuando el cursor esté inactivo.
TCXO_NO_CURSOR_DOWN	0x00000008	El TC no devolverá paquetes cuando el cursor esté inactivo.
TCXO_NON_INTEGRATED	0x00000010	El contexto no estará integrado.
TCXO_POSTHOOK	0x00000020	Los posthooks obtienen paquetes después de contextos de tableta normales, pero antes del contexto del sistema. Obtienen paquetes en el orden inverso de su creación.
TCXO_DONT_SHOW_CURSOR	0x00000080	El TC no establecerá la posición del cursor.
TCXO_DONT_VALIDATE_TCS	0x00000100	El TC no validará los GUID pasados en la configuración de contexto de tableta con las propiedades admitidas del dispositivo.
TCXO_ALLOW_FLICKS	0x00000400	El TC permitirá que se produzca la detección de parpadeos (de forma predeterminada, esto solo se permite en contextos del sistema) y el cliente obtendrá SE_FLICK eventos.
TCXO_ALLOW_FEEDBACK_TAPS	0x00000800	El TC permitirá que se muestren los comentarios de lápiz. De forma predeterminada, esto solo se permite en contextos del sistema.
TCXO_ALLOW_FEEDBACK_BARREL	0x00001000	El TC permitirá que se muestren los comentarios de lápiz. De forma predeterminada, esto solo se permite en contextos del sistema.
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	Todas las opciones de contexto de tableta definidas.
TCXO_HOOK	TCXO_PREHOOK \| TCXO_POSTHOOK	Combina la funcionalidad pre-hook y post-hook.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Biblioteca	Wisptis.exe

Vea también

ITablet (interfaz)
CONTEXT_ENABLE_TYPE (enumeración)
estructura de TABLET_CONTEXT_SETTINGS
Estructura de PACKET_DESCRIPTION
ITabletContextP (interfaz)
ITabletEventSink (Interfaz)

Compartir a través de