Compartilhar via


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 em coordenadas de espaço à tinta , que descreve a área de teste de ocorrência.

[out, retval] Intersections

Quando esse método é retornado, 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 pares. 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.

Valor de retorno

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

Observações

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 suportado Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo compatível Nenhum compatível
da Plataforma de Destino Windows
Header msinkaut.h

Consulte também

Método Clip

Método FindIntersections

IInkStrokeDisp Interface