Compartilhar via


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

Recupera o objeto IInkCursorButton no identificador de cadeia de caracteres ou índice especificado na coleção IInkCursorButtons .

Sintaxe

HRESULT Item(
  [in]          VARIANT          Identifier,
  [out, retval] IInkCursorButton **Button
);

Parâmetros

[in] Identifier

O índice baseado em zero ou o identificador BSTR do objeto IInkCursorButton a ser obtido.

Para obter mais informações sobre os tipos de dados VARIANT e BSTR, consulte Usando a biblioteca COM.

[out, retval] Button

Após o retorno, contém o objeto IInkCursorButton no índice especificado na coleção IInkCursorButtons .

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 inesperado ou tipo de propriedade.
REGDB_CLASSNOTREG
Tipo de objeto 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.

O método Item usa um argumento de entrada do tipo VARIANT. No entanto, o subtipo dessa variável deve ser inteiro ou cadeia de caracteres (BSTR). Isso significa que, quando você estiver usando uma associação tardia, como quando usa uma linguagem de script, deverá passar o argumento como um literal STRING e não usar uma variável.

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

IInkCursorButton Interface

IInkCursorButtons Interface