IInkDisp::HitTestWithRectangle-Methode (msinkaut.h)

Artikel
08/24/2023

Ruft die Striche ab, die in einem angegebenen Rechteck enthalten sind.

Syntax

HRESULT HitTestWithRectangle(
  [in]          IInkRectangle *SelectionRectangle,
  [in]          float         IntersectPercent,
  [out, retval] IInkStrokes   **Strokes
);

Parameter

[in] SelectionRectangle

Das Auswahlrechteck vom Typ InkRectangle in Freihandraumkoordinaten.

[in] IntersectPercent

Der float- oder single percentage-Wert, der bestimmt, welche Striche in der Auflistung enthalten sind. Striche, die das Rechteck überschneiden, sind in der Auflistung enthalten, wenn der Prozentsatz der Punkte in diesen Strichen, die im Rechteck enthalten sind, größer oder gleich dem IntersectPercent-Prozentsatz ist.

[out, retval] Strokes

Wenn diese Methode zurückgibt, enthält einen Zeiger auf die Auflistung von Strichen, aus denen die Freihandfarbe 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ültiger Anzeigehandle.

Hinweise

Um zu bestimmen, welche Punkte eines bekannten Strichs den Testbereich überschneiden, rufen Sie die GetRectangleIntersections-Methode des IInkStrokeDisp-Objekts auf, die die Punkte abruft, an denen ein Strich ein bekanntes Rechteck überschneidet.

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(Point[], Single)-Methode

IInkDisp

InkDisp-Klasse

InkStrokes-Sammlung

Freigeben über