IInkStrokeDisp::NearestPoint-Methode (msinkaut.h)

Sucht die Position auf dem Strich, der einem bekannten Punkt am nächsten ist, und gibt den Abstand des Punkts vom Strich zurück. Alles befindet sich in Freihandraumkoordinaten.

Syntax

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

Parameter

[in] X

Die x-Position im Freihandbereich des zu testenden Punkts.

[in] Y

Die y-Position im Freihandbereich des zu testenden Punkts.

[in, out, optional] Distance

Optional. Der Abstand vom Punkt zum Strich. Dieser Parameter kann NULL sein. Der Standardwert ist 0.

[out, retval] Point

Wenn diese Methode zurückgibt, enthält den Gleitkommaindexwert, der die nächstgelegene Position auf dem Strich darstellt.

Ein Gleitkommaindex ist ein Gleitkommawert, der eine Position zwischen zwei Punkten im Strich darstellt. Beispiel: Wenn 0,0 der erste Punkt im Strich und 1,0 der zweite Punkt im Strich ist, liegt 0,5 auf halbem Weg zwischen dem ersten und dem zweiten Punkt. Auf ähnliche Weise stellt ein Gleitkommaindexwert von 37,25 eine Position dar, die auf der Linie zwischen Punkt 37 und 38 des Strichs 25 Prozent beträgt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.

Hinweise

Der Abstandsparameter beschreibt den Abstand vom Punkt zum Umschlag des Strichs. Dies ist der Abstand zwischen den beiden Punkten abzüglich der hälften Breite des Strichs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll

Weitere Informationen

GetRectangleIntersections-Methode

HitTest(Point, Single)-Methode

IInkStrokeDisp-Schnittstelle

NearestPoint-Methode [InkDisp-Klasse]