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 |
|---|---|
|
Erfolg. |
|
Ein Parameter enthielt einen ungültigen Zeiger. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
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