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

Localiza os pontos em que um objeto IInkStrokeDisp cruza um determinado retângulo.

Sintaxe

HRESULT GetRectangleIntersections(
  [in]          IInkRectangle *Rectangle,
  [out, retval] VARIANT       *Intersections
);

Parâmetros

[in] Rectangle

O retângulo nas coordenadas de espaço à tinta , que descreve a área de teste de ocorrência.

[out, retval] Intersections

Quando esse método retorna, contém uma matriz VARIANT que indica onde o traço cruza o retângulo. Os índices de ponto flutuante inicial são armazenados nos índices par. Os índices de ponto flutuante final são armazenados nos índices ímpares. O primeiro par de índices representa a primeira interseção.

Para obter mais informações sobre a estrutura VARIANT, consulte Usando a biblioteca COM.

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 o objeto auxiliar do manipulador stroke.
E_UNEXPECTED	Parâmetro inesperado ou tipo de propriedade.
E_INK_EXCEPTION	Ocorreu uma exceção dentro do método .

Comentários

Esse método retorna uma matriz que indica onde o traço cruza o retângulo especificado. Cada segmento do traço que cruza o retângulo é um par de índices, alternando com um índice inicial seguido por um índice final.

Se o traço começar dentro do retângulo de teste, o primeiro índice será definido como -1. Se o traço terminar dentro do retângulo de teste, o último índice será definido como -1. Se o traço estiver totalmente fora do retângulo de teste, uma matriz vazia será retornada. Por exemplo, se um traço começar dentro do retângulo de teste, deixar os limites do retângulo, retornar dentro e sair novamente, o método GetRectangleIntersections poderá retornar {-1, 1.4, 5.5, 10.1} para descrever os dois segmentos do traço que estão caindo dentro do retângulo.

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 Clip

Método FindIntersections

IInkStrokeDisp Interface