IInkStrokeDisp::GetRectangleIntersections-Methode (msinkaut.h)

Artikel
03/05/2025

Sucht die Punkte, an denen ein IInkStrokeDisp -Objekt ein bestimmtes Rechteck überschneidet.

Syntax

HRESULT GetRectangleIntersections(
  [in]          IInkRectangle *Rectangle,
  [out, retval] VARIANT       *Intersections
);

Parameter

[in] Rectangle

Das Rechteck im Freihandraum Koordinaten, das den Treffertestbereich beschreibt.

[out, retval] Intersections

Wenn diese Methode zurückgegeben wird, enthält ein VARIANT-Array, das angibt, wo der Strich das Rechtecküberschneidet. Die Anfangs-Gleitkommaindizes werden in den geraden Indizes gespeichert. Die endenden Gleitkommaindizes werden in den ungeraden Indizes gespeichert. Das erste Indizespaar stellt die erste Schnittmenge dar.

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	Das Hilfsobjekt des Stroke-Handlers kann nicht zugewiesen werden.
E_UNEXPECTED	Unerwarteter Parameter oder Eigenschaftentyp.
E_INK_EXCEPTION	In der Methode ist eine Ausnahme aufgetreten.

Bemerkungen

Diese Methode gibt ein Array zurück, das angibt, wo der Strich das angegebene Rechteck überschneidet. Jedes Segment des Strichs, der das Rechteck überschneidet, ist ein Indizespaar, das sich mit einem Anfangsindex, gefolgt von einem Endindex, wechselt.

Wenn der Strich innerhalb des Testrechtecks beginnt, wird der erste Index auf -1 festgelegt. Wenn der Strich innerhalb des Testrechtecks endet, wird der letzte Index auf -1 festgelegt. Wenn sich der Strich vollständig außerhalb des Testrechtecks befindet, wird ein leeres Array zurückgegeben. Wenn z. B. ein Strich innerhalb des Testrechtecks beginnt, die Grenzen des Rechtecks hinterlässt, innerhalb zurückgibt und wieder verlässt, gibt die GetRectangleIntersections-Methode möglicherweise {-1, 1,4, 5.5, 10.1} zurück, um die beiden Segmente des Strichs zu beschreiben, der in das Rechteck fällt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP Tablet PC Edition [nur Desktop-Apps]
mindestens unterstützte Server-	Keine unterstützt
Zielplattform-	Fenster
Header-	msinkaut.h
Library	InkObj.dll

Siehe auch

Clip-Methode

FindIntersections-Methode

IInkStrokeDisp Interface

Freigeben über