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á em 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 à tinta do ponto a ser testado.

[in] Y

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

[in, out, optional] Distance

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

[out, retval] Point

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

Um índice de ponto flutuante é um valor float que representa um local em algum lugar 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 de 25% ao longo da linha entre os pontos 37 e 38 do traço.

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_FAIL	Ocorreu um erro não especificado.
E_INK_EXCEPTION	Ocorreu uma exceção dentro do método .

Comentários

O parâmetro distance 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

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 GetRectangleIntersections

Método HitTest(Point, Single)

IInkStrokeDisp Interface

Método NearestPoint [Classe InkDisp]