IInkDisp::HitTestCircle-Methode (msinkaut.h)
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 |
|---|---|
|
Erfolg. |
|
Ein Parameter enthielt einen ungültigen Zeiger. |
|
Innerhalb der -Methode ist eine Ausnahme aufgetreten. |
|
Ungültiger Anzeigehandle. |
|
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