IInkDisp::HitTestWithLasso-Methode (msinkaut.h)

Artikel
03/04/2024

Ruft die Striche innerhalb eines Polylinienauswahlbereichs ab.

Syntax

HRESULT HitTestWithLasso(
  [in]                VARIANT     Points,
  [in]                float       IntersectPercent,
  [in, out, optional] VARIANT     *LassoPoints,
  [out, retval]       IInkStrokes **Strokes
);

Parameter

[in] Points

Die Punkte, die im Auswahltool zum Auswählen der Striche verwendet werden. Der Auswahlbereich ist der Bereich innerhalb der Auswahlgrenze, in dem sich die Grenze zuerst überschneidet. Wenn sich die Grenze nicht überschneidet, fügt die -Methode einen Punkt am Ende des Arrays hinzu, um eine gerade Linie vom ersten Punkt bis zum letzten Punkt zu erstellen. Wenn die Grenze eine gerade Linie ist (kein Bereich innerhalb der Markierungsgrenze), werden keine Striche ausgewählt.

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

[in] IntersectPercent

Der Prozentsatz der Strichpunkte, der im Auswahltool enthalten sein muss, um den Strich in die resultierende Auflistung von Strichen einzuschließen. Wenn null (0) ist, werden alle Striche, die im Auswahltool enthalten sind oder vom Auswahltool überschneiden, in die resultierende Auflistung von Strichen eingeschlossen. Bei 100 werden nur Striche, die vollständig im Auswahltool enthalten sind, in der Auflistung enthalten. Striche, die das Auswahltool überschneiden, werden in die Auflistung aufgenommen, wenn der Prozentsatz der Punkte in den Strichen, die im Auswahltool enthalten sind, größer als oder gleich dem prozentsatz %Intersect ist. Anteilsprozentsätze werden aufgerundet.

[in, out, optional] LassoPoints

Optional. Ruft den bestimmten Teil des Auswahltools ab, der für die Auswahl verwendet wird. Da ein Benutzer viele verschiedene Arten von Auswahltools zeichnen kann, von denen sich einige mehrfach überlappen, kann dies nützlich sein, um zu veranschaulichen, welcher Teil des Auswahltools für die Auswahl verwendet wurde. Der Standardwert ist ein NULL-Zeiger , was bedeutet, dass keine Informationen zurückgegeben werden.

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

[out, retval] Strokes

Wenn diese Methode zurückgibt, enthält einen Zeiger auf die Auflistung von Strichen, aus denen die Freihandeingabe besteht.

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_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_INVALIDARG	Ungültiges Anzeigehandle.
E_OUTOFMEMORY	Speichervorgang kann nicht zugeordnet werden.

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

Weitere Informationen

HitTest(Point, Single)-Methode

HitTest(Rectangle, Single)-Methode

IInkDisp

InkDisp-Klasse

InkStrokes-Auflistung

Freigeben über