Método ITablet::CreateContext
Cria um objeto de contexto que descreve o dispositivo tablet especificado.
Sintaxe
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]
-
A janela à qual o contexto do tablet será anexado.
-
prcInput [in]
-
[in, unique]
O retângulo de entrada à tinta.
-
dwOptions [in]
-
Sinalizadores que definem opções de contexto de tablet.
-
pTCS [in]
-
[in, unique]
Informações detalhadas sobre o contexto do tablet a ser criado.
-
cet [in]
-
Valor que habilita ou desabilita mensagens de contexto que estão sendo enviadas para a janela.
-
ppCtx [out]
-
Um ponteiro para o contexto de tablet recém-criado.
-
pTcid [in, out]
-
Valor que identifica exclusivamente o tablet.
-
ppPD [in, out]
-
Ponteiro para informações sobre quais dados estão contidos em cada pacote.
-
pSink [in]
-
O objeto ITabletEventSink para o qual as mensagens de notificação serão enviadas.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
Êxito. |
|
Ocorreu um erro não especificado. |
Comentários
Normalmente, um aplicativo obtém os valores padrão do Método ITablet::GetDefaultContextSettings, modifica valores para atender às suas necessidades e passa a estrutura de configurações modificada para o Método ITablet::CreateContext.
Observação
Você deve implementar a interface ITabletEventSink ao chamar o método ITablet::CreateContext.
O parâmetro dwOptions é um conjunto de sinalizadores de bits que descrevem as opções de contexto. A tabela a seguir descreve esses sinalizadores.
| Nome do Sinalizador | Valor | Descrição |
|---|---|---|
| TCXO_MARGIN |
0x00000001 |
Especifica que o contexto de entrada no tablet terá uma margem. A margem é uma área fora da área de entrada especificada em que os eventos serão mapeados para a borda da área de entrada. Esse recurso facilita a entrada de pontos na borda do contexto. |
| TCXO_PREHOOK |
0x00000002 |
O prehook obtém pacotes antes de contextos regulares e posthooks. Eles obtêm pacotes na ordem de criação. |
| TCXO_CURSOR_STATE |
0x00000004 |
O TC retornará pacotes mesmo se o cursor estiver em mente. Por padrão, um TC só retornará pacotes quando o cursor estiver inativo. |
| TCXO_NO_CURSOR_DOWN |
0x00000008 |
O TC não retornará pacotes quando o cursor estiver inativo. |
| TCXO_NON_INTEGRATED |
0x00000010 |
O contexto não será integrado. |
| TCXO_POSTHOOK |
0x00000020 |
Os posthooks obtêm pacotes após contextos regulares de tablet, mas antes do contexto do sistema. Eles obtêm pacotes na ordem inversa de sua criação. |
| TCXO_DONT_SHOW_CURSOR |
0x00000080 |
O TC não definirá a posição do cursor. |
| TCXO_DONT_VALIDATE_TCS |
0x00000100 |
O TC não validará o GUIDS passado nas configurações de contexto do tablet em relação às propriedades com suporte do dispositivo. |
| TCXO_ALLOW_FLICKS |
0x00000400 |
O TC permitirá que a detecção de movimento ocorra (por padrão, isso só é permitido em contextos do sistema) e o cliente obterá SE_FLICK eventos. |
| TCXO_ALLOW_FEEDBACK_TAPS |
0x00000800 |
O TC permitirá que os comentários da caneta sejam mostrados. Por padrão, isso só é permitido em contextos do sistema. |
| TCXO_ALLOW_FEEDBACK_BARREL |
0x00001000 |
O TC permitirá que os comentários da caneta sejam mostrados. Por padrão, isso só é permitido em contextos do 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 as opções de contexto de tablet definidas. |
| TCXO_HOOK |
TCXO_PREHOOK | TCXO_POSTHOOK |
Combina a funcionalidade de pré-gancho e pós-gancho. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP Tablet PC Edition [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Nenhum compatível |
| Biblioteca |
|