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