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

Localiza o local no traço mais próximo de um ponto conhecido e retorna a distância que o ponto está do traço. Tudo está nas coordenadas de espaço à tinta.

Sintaxe

HRESULT NearestPoint(
  [in]                long  X,
  [in]                long  Y,
  [in, out, optional] float *Distance,
  [out, retval]       float *Point
);

Parâmetros

[in] X

A posição x no espaço de tinta do ponto a ser testado.

[in] Y

A posição y no espaço de tinta do ponto a ser testado.

[in, out, optional] Distance

Opcional. A distância do ponto até o traço. Esse parâmetro pode ser NULL. O valor padrão é 0.

[out, retval] Point

Quando esse método é retornado, contém o valor do índice de ponto flutuante que representa o local mais próximo no traço.

Um índice de ponto flutuante é um valor flutuante que representa um local entre dois pontos no traço. Como exemplos, se 0.0 for o primeiro ponto no traço e 1,0 for o segundo ponto no traço, 0,5 estará na metade entre o primeiro e o segundo pontos. Da mesma forma, um valor de índice de ponto flutuante de 37,25 representa um local que é de 25% ao longo da linha entre os pontos 37 e 38 do traço.

Valor de retorno

Esse método pode retornar um desses valores.

Observações

O parâmetro de distância descreve a distância do ponto até o envelope do traço. Essa é a distância entre os dois pontos menos metade da largura do traço.

Requisitos

Consulte também

Método GetRectangleIntersections

Método HitTest(Point, Single)

IInkStrokeDisp Interface

Método NearestPoint [Classe InkDisp]