Método IInkDisp::D eleteStrokes (msinkaut.h)

Exclui uma coleção InkStrokes da coleção Strokes do objeto InkDisp .

Sintaxe

HRESULT DeleteStrokes(
  [in, optional] IInkStrokes *Strokes
);

Parâmetros

[in, optional] Strokes

Opcional. Especifica a coleção de traços a serem excluídos do objeto InkDisp . O valor padrão é NULL.

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_OUTOFMEMORY
Não é possível alocar memória usada para executar a operação.
E_FAIL
Ocorreu um erro não especificado.
E_INK_MISMATCHED_INK_OBJECT
O objeto InkDisp dos traços deve corresponder ao objeto InkDisp conhecido.
E_INK_EXCEPTION
Ocorreu uma exceção dentro do método .
E_UNEXPECTED
Parâmetro inesperado ou tipo de propriedade.

Comentários

Esse método exclui todos os traços no objeto InkDisp se nenhuma coleção InkStrokes for passada. Para excluir apenas um traço de cada vez, chame o método DeleteStroke .

O objeto InkDisp renumera os índices dos traços restantes no objeto InkDisp se os traços excluídos não cairem no final da coleção de traços do objeto InkDisp .

Nota O conteúdo de uma coleção InkStrokes torna-se inválido quando os traços contidos na coleção são excluídos do objeto InkDisp .
 
DeleteStrokes pode resultar em um erro se chamado enquanto o usuário está ativamente colocando tinta.

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

Método DeleteStroke

Iinkdisp

Classe InkDisp

Coleção InkStrokes