Método IInkCustomStrokes::Remove (msinkaut.h)

Remove a coleção InkStrokes da coleção IInkCustomStrokes .

Sintaxe

HRESULT Remove(
  [in] VARIANT Identifier
);

Parâmetros

[in] Identifier

O nome ou índice da coleção de traços a serem removidos da coleção de traços personalizados.

Para obter mais informações sobre a estrutura VARIANT, consulte Usando a biblioteca COM.

Valor retornado

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_OUTOFMEMORY	Não é possível alocar memória para concluir a operação.
E_INK_EXCEPTION	Ocorreu uma exceção dentro do método .
E_INK_INCOMPATIBLE_OBJECT	Parâmetro de entrada inválido.
E_INK_MISMATCHED_INK_OBJECT	O objeto InkDisp da coleção InkStrokes e o objeto IInkStrokeDisp não correspondem.
E_FAIL	Ocorreu um erro não especificado.
DISP_E_TYPEMISMATCH	Uma variante inválida foi passada.

Comentários

Coleções IInkCustomStrokes são conjuntos de referências a dados de tinta e não são os dados reais em si. Esse método remove apenas a coleção de traços de uma instantâneo ou referência aos dados e não remove os dados reais de tinta. Para excluir a coleção dos dados de tinta reais, chame o método DeleteStrokes do objeto InkDisp .

O parâmetro Identifier pode ser um BSTR ou um LONG. Use um BSTR para o nome originalmente fornecido ao traço personalizado quando ele foi adicionado à coleção e use um long para o índice do traço personalizado na coleção. Para especificar o nome do traço personalizado ao usar a associação tardia, como quando você usa uma linguagem de script, você deve passar o argumento como um literal de cadeia de caracteres e não usar uma variável.

Para obter mais informações sobre o tipo de dados BSTR, consulte Usando a biblioteca COM.

Requisitos

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

Método DeleteStrokes

IInkCustomStrokes Interface

Classe InkDisp