IInkDisp::HitTestCircle-Methode (msinkaut.h)

Artikel
03/04/2024

Ruft die InkStrokes-Auflistung ab, die sich entweder vollständig innerhalb eines bekannten Kreises befindet oder sich überschneiden.

Syntax

HRESULT HitTestCircle(
  [in]          long        X,
  [in]          long        Y,
  [in]          float       radius,
  [out, retval] IInkStrokes **Strokes
);

Parameter

[in] X

Die x-Position der Mitte des Treffertestkreises in Freihandraumeinheiten.

[in] Y

Die y-Position der Mitte des Treffertestkreises in Freihandraumeinheiten.

[in] radius

Der Radius des Kreises, der im Treffertest in Freihandraumeinheiten verwendet werden soll.

[out, retval] Strokes

Wenn diese Methode zurückgibt, enthält die Auflistung von Strichen, die sich entweder vollständig innerhalb oder durch den angegebenen Kreis überschneiden.

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.
E_UNEXPECTED	Unerwarteter Parameter oder Eigenschaftstyp.

Hinweise

Wenn ein Strich den Kreis überschneidet, wird der vollständige Strich zurückgegeben.

Die Methode berechnet die Schnittmenge unter Berücksichtigung des vollständigen Satz von Zeichnungsattributen, die für den Strich gelten, einschließlich der vollen Stiftbreite, der Zierglättung (falls vorhanden) und der Form der Stiftspitze.

Nachdem eine Rotations- oder Schertransformation für einen Strich oder eine Sammlung von Strichen ausgeführt wurde, sind die transformierten x- und y- Koordinaten nicht mehr konzentrisch mit den ursprünglichen Koordinaten. Aus diesem Fall sollte das radius Argument nicht aus den x- Koordinaten oder y- berechnet werden.

Um zu bestimmen, welche Punkte eines bekannten Strichs den Testbereich überschneiden, rufen Sie die HitTest-Methode des IInkStrokeDisp-Objekts auf.

Die Anwendung muss immer einen Zielzeiger für die resultierende Sammlung von Strichen übergeben. Wenn keine Überschneidungen vorhanden sind, weist die Auflistung eine Anzahl von 0 auf.

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-Sammlung

Freigeben über