IInkStrokeDisp::GetRectangleIntersections-Methode (msinkaut.h)
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 in Freihandraumkoordinaten , das den Treffertestbereich beschreibt.
[out, retval] Intersections
Wenn diese Methode zurückgibt, enthält ein VARIANT-Array, das angibt, wo der Strich das Rechteck überschneidet. Die Anfangs-Gleitkommaindizes werden in den geraden Indizes gespeichert. Die gleitkommaenden Endindizes 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 |
|---|---|
|
Erfolg. |
|
Ein Parameter enthielt einen ungültigen Zeiger. |
|
Das Hilfsobjekt des Stroke-Handlers kann nicht zugeordnet werden. |
|
Unerwarteter Parameter oder Eigenschaftstyp. |
|
Innerhalb der -Methode ist eine Ausnahme aufgetreten. |
Hinweise
Diese Methode gibt ein Array zurück, das angibt, wo der Strich das angegebene Rechteck überschneidet. Jedes Segment des Strichs, das das Rechteck überschneidet, ist ein Indizespaar, das 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 beispielsweise ein Strich innerhalb des Testrechtecks beginnt, die Grenzen des Rechtecks verlässt, innerhalb zurückgibt und wieder verlässt, kann die GetRectangleIntersections-Methode {-1, 1.4, 5.5, 10.1} zurückgeben, um die beiden Segmente des Strichs zu beschreiben, die innerhalb des Rechtecks fallen.
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 |