IInkStrokeDisp::FindIntersections-Methode (msinkaut.h)

Artikel
08/25/2023

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

Syntax

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

Parameter

[in] Strokes

Die bekannte Auflistung von Strichen, die verwendet werden, um die Punkte zu berechnen, an 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 die Striche, die auf Schnittpunkte getestet werden. Wenn es sich nicht um dasselbe InkDisp-Objekt handelt, wird E_INK_MISMATCHED_INK_OBJECT zurückgegeben (siehe "HRESULT-Wert" unten). Die FindIntersections-Methode ist die einzige Anwendungsprogrammierschnittstelle (API), die erfordert, dass die bekannte Auflistung von Strichen aus demselben InkDisp-Objekt stammt.

[out, retval] Intersections

Wenn diese Methode zurückgibt, enthält ein Array von Gleitkommaindexwerten, die die Positionen angeben, an denen dieser Strich Striche innerhalb einer bekannten Auflistung von Strichen überschneidet.

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.

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

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_OUTOFMEMORY	Ein IInkStrokeDisp-Handle-Hilfsobjekt kann nicht zugeordnet werden.
E_UNEXPECTED	Unerwarteter Parameter oder Eigenschaftstyp.
E_INK_EXCEPTION	Innerhalb 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.

Hinweise

Diese Methode kann nur die Schnittpunkte bestimmen.

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

Weitere Informationen

GetRectangleIntersections-Methode

IInkStrokeDisp-Schnittstelle

InkStrokes-Sammlung

Freigeben über