IInkDisp::HitTestWithRectangle-Methode (msinkaut.h)

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