Compartilhar via


Método IInkStrokeDisp::Clip (msinkaut.h)

Remove partes de um objeto IInkStrokeDisp ou da coleção InkStrokes que estão fora de um retângulo.

Sintaxe

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

Parâmetros

[in] Rectangle

Especifica o retângulo fora do qual o traço ou os traços são recortados. O retângulo é especificado nas coordenadas de espaço à tinta.

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.
REGDB_CLASSNOTREG
O objeto InkDisp não está registrado.
E_INVALIDARG
Retângulo de clipe inválido.
E_INK_EXCEPTION
Ocorreu uma exceção dentro do método .
E_FAIL
Ocorreu um erro não especificado.

Comentários

Para um objeto InkDisp , todos os traços interseccionados pelo retângulo são divididos nos pontos de interseção. Todas as partes de traços fora do retângulo são removidas do objeto InkDisp . O método pode adicionar novos pontos a um traço no ponto em que o traço cruza o retângulo. Depois de chamar o método Clip em um objeto InkDisp , as IDs dos traços na coleção de traços do objeto InkDisp têm a garantia de serem exclusivas, mas não têm garantia de preservar outras informações.

Esse método não leva em conta a largura da caneta ao recortar. Ele corta apenas os dados reais de tinta ou traço.

Para um objeto IInkStrokeDisp ou uma coleção InkStrokes , o método Clip atualiza o objeto InkDisp pai. Sempre que a tinta é removida de um objeto InkDisp , quaisquer objetos IInkStrokeDisp ou coleções InkStrokes definidas para esse objeto InkDisp podem ser invalidadas.

Para obter mais informações sobre dados de tinta, consulte Dados do Ink.

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 HitTest(Rectangle, Single)

IInkStrokeDisp Interface

Classe InkRectangle