IInkStrokeDisp::FindIntersections-Methode (msinkaut.h)

Ruft die Punkte ab, an denen dieses IInkStrokeDisp -Objekt andere IInkStrokeDisp -Objekte in einer bekannten InkStrokes -Auflistung überschneidet.

Syntax

HRESULT FindIntersections(
  [in]          IInkStrokes *Strokes,
  [out, retval] VARIANT     *Intersections
);

Parameter

[in] Strokes

Die bekannte Auflistung von Strichen, die zum Berechnen der Punkte verwendet werden, in denen dieser Strich Striche in der Auflistung überschneidet. Wenn NULL, verwenden Sie alle Striche im InkDisp-Objekt .

Hinweis Die bekannte Auflistung von Strichen muss aus demselben InkDisp-Objekt stammen wie der Strich, der auf Schnittpunkt getestet wird. Wenn es nicht aus demselben InkDisp-Objekt stammt, wird E_INK_MISMATCHED_INK_OBJECT zurückgegeben (siehe "HRESULT-Wert" unten). Die FindIntersections-Methode ist die einzige Tablet PC-Anwendungsprogrammierschnittstelle (API), die erfordert, dass die bekannte Auflistung von Strichen aus demselben InkDisp-Objekt stammt.
 

[out, retval] Intersections

Wenn diese Methode zurückgegeben wird, enthält ein Array von Gleitkommaindexwerten, die die Positionen angeben, an denen sich dieser Strich in einer bekannten Auflistung von Strichen überschneidet.

Ein Gleitkommaindex ist ein Float-Wert, der eine Position zwischen zwei Punkten im Strich darstellt. Beispiel: Wenn 0,0 der erste Punkt im Strich ist und 1,0 der zweite Punkt im Strich ist, ist 0,5 halbwegs zwischen den ersten und zweiten Punkten. Ebenso stellt ein Gleitkommaindexwert von 37,25 eine Position dar, die 25 Prozent entlang der Linie zwischen den Punkten 37 und 38 des Strichs liegt.

Weitere Informationen zur VARIANT-Struktur finden Sie unter Verwenden der COM-Bibliothek.

Zurückgegebener Wert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK
Erfolg.
E_POINTER
Ein Parameter enthielt einen ungültigen Zeiger.
E_OUTOFMEMORY
Ein IInkStrokeDisp-Handle-Hilfsobjekt kann nicht zugeordnet werden.
E_UNEXPECTED
Unerwarteter Parameter oder Eigenschaftentyp.
E_INK_EXCEPTION
In der Methode ist eine Ausnahme aufgetreten.
E_INK_INCOMPATIBLE_OBJECT
Der Strichparameter verweist nicht auf ein kompatibles InkDisp-Objekt .
E_INK_MISMATCHED_INK_OBJECT
Das InkDisp-Objekt der InkStrokes-Auflistung und dieses IInkStrokeDisp-Objekt stimmen nicht überein.

Bemerkungen

Diese Methode kann nur die Schnittpunkte bestimmen.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP Tablet PC Edition [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Windows
Header msinkaut.h

Siehe auch

GetRectangleIntersections-Methode

IInkStrokeDisp-Schnittstelle

InkStrokes-Auflistung