Compartilhar via


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