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 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