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 |
|---|---|
|
Êxito. |
|
Um parâmetro continha um ponteiro inválido. |
|
O objeto InkDisp não está registrado. |
|
Retângulo de clipe inválido. |
|
Ocorreu uma exceção dentro do método . |
|
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 |