IInkDisp::NearestPoint-Methode (msinkaut.h)
Ruft den IInkStrokeDisp innerhalb des InkDisp-Objekts ab, das einem bekannten Punkt am nächsten ist, und gibt optional den Index des nächsten Punkts und den Abstand zum Strich vom angegebenen Punkt an.
Syntax
HRESULT NearestPoint(
[in] long X,
[in] long Y,
[in, out, optional] float *PointOnStroke,
[in, out, optional] float *DistanceFromPacket,
[out, retval] IInkStrokeDisp **Stroke
);
Parameter
[in] X
Die x- Position im Freihandbereich des Punkts.
[in] Y
Gibt die y- Position im Freihandbereich des Punkts an.
[in, out, optional] PointOnStroke
Optional. Ruft den Punkt in der Zeile des Strichs ab, der dem angegebenen Punkt innerhalb des InkDisp-Objekts am nächsten ist. Beispielsweise gibt der Wert 1,5 an, dass der Punkt auf halbem Weg zwischen dem ersten und dem zweiten Paket des Strichs liegt. Dieser Parameter kann NULL sein. Der Standardwert ist 0.
[in, out, optional] DistanceFromPacket
Optional. Ruft den Abstand zwischen dem angegebenen Punkt im Freihandbereich und dem nächsten Strich im InkDisp-Objekt ab. Dieser Parameter kann NULL sein. Der Standardwert ist 0.
[out, retval] Stroke
Wenn diese Methode zurückgibt, enthält IInkStrokeDisp , das einen Punkt enthält, der dem angegebenen Punkt im InkDisp-Objekt am nächsten ist. Wenn mehr als ein Strich einen Punkt enthält, der denselben Abstand zum angegebenen Punkt aufweist, ist der Wert dieses Ergebnisses beliebig.
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. |
|
Speichervorgang kann nicht zugeordnet werden. |
Hinweise
Der Ausgabepunktparameter wird als Gleitkommazahl definiert, da der Punkt auf der Linie des Strichs zwischen zwei physischen Koordinatenpunkten liegen kann. Verwenden Sie diesen Wert, um den Strich mit der Split-Methode aufzuteilen, oder runden Sie den Wert nach oben oder unten, um ein Paket im Strich zu indizieren.
Der parameter distanceFromPacket beschreibt den Abstand zwischen dem Punkt und dem Umschlag des Strichs. Dies ist der Abstand zwischen den beiden Punkten minus der halben Breite des Strichs.
Anforderungen
| 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 |