Share via

Método IInkTablets::Item (msinkaut.h)

  • Artigo

Recupera o objeto IInkTablet no índice especificado dentro da coleção InkTablets .

Sintaxe

HRESULT Item(
  [in]          long       Index,
  [out, retval] IInkTablet **Tablet
);

Parâmetros

[in] Index

O índice baseado em zero do objeto IInkTablet a ser obtido.

[out, retval] Tablet

Quando este método retorna, contém um ponteiro para o objeto IInkTablet no índice especificado dentro da coleção InkTablets .

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
E_POINTER
 Um parâmetro continha um ponteiro inválido.
E_FAIL
 Ocorreu um erro não especificado.
CO_E_CLASSTRING
 Formato GUID inválido.
DISP_E_TYPEMISMATCH
 Um dos parâmetros não é um tipo VARIANT válido.
E_INVALIDARG
 Argumento inválido.
E_UNEXPECTED
 Parâmetro ou tipo de propriedade inesperado.
REGDB_CLASSNOTREG
 Objeto de tipo não registrado.
E_OUTOFMEMORY
 Não é possível alocar memória para concluir a operação.
E_INK_EXCEPTION
 Ocorreu uma exceção dentro do método .
TPC_E_RECOGNIZER_NOT_REGISTERED
 A chave do Registro de reconhecedores está corrompida ou seu ambiente não dá suporte ao reconhecimento de manuscrito.

Comentários

Ocorrerá um erro se o índice não corresponder a nenhum membro existente da coleção.

Nota Essa função pode ser reinserida quando chamada em determinados manipuladores de mensagens, causando resultados inesperados. Tome cuidado para evitar uma chamada reentrante ao lidar com qualquer uma das seguintes mensagens: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATEWM_PAINT; WM_SYSCOMMAND se wParam estiver definido como SC_HOTKEY ou SC_TASKLIST; e WM_SYSKEYDOWN (ao processar combinações de teclas Alt-Tab ou Alt-Esc). Esse é um problema com aplicativos de modelo de apartment de thread único.
 

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
Plataforma de Destino Windows
Cabeçalho msinkaut.h
Biblioteca InkObj.dll

Confira também

IInkTablet Interface

IInkTablets

Coleção InkTablets