IDWriteTextLayout::HitTestPoint-Methode (dwrite.h)
Die Anwendung ruft diese Funktion auf und übergibt eine bestimmte Pixelposition relativ zur linken oberen Position des Layoutfelds und ruft die Informationen zu den entsprechenden Treffertestmetriken der Textzeichenfolge ab, in der der Treffertest aufgetreten ist. Wenn sich die angegebene Pixelposition außerhalb der Textzeichenfolge befindet, legt die Funktion den Ausgabewert *isInside auf FALSE fest.
Syntax
HRESULT HitTestPoint(
FLOAT pointX,
FLOAT pointY,
[out] BOOL *isTrailingHit,
[out] BOOL *isInside,
[out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);
Parameter
pointX
Typ: FLOAT
Die Zu testde Pixelposition X relativ zur linken oberen Position des Layoutfelds.
pointY
Typ: FLOAT
Die zu testde Pixelposition Y relativ zur linken oberen Position des Layoutfelds.
[out] isTrailingHit
Typ: BOOL*
Ein Ausgabeflag, das angibt, ob sich die Treffertestposition an der führenden oder nachgestellten Seite des Zeichens befindet. Wenn der Ausgabewert *isInside auf FALSE festgelegt ist, wird dieser Wert gemäß dem Ausgabewert hitTestMetrics-textPosition> so festgelegt, dass er den Rand darstellt, der dem Treffertestspeicherort am nächsten ist.
[out] isInside
Typ: BOOL*
Ein Ausgabeflag, das angibt, ob sich der Treffertestspeicherort innerhalb der Textzeichenfolge befindet. Bei FALSE wird die Position zurückgegeben, die dem Textrand am nächsten ist.
[out] hitTestMetrics
Typ: DWRITE_HIT_TEST_METRICS*
Die Ausgabegeometrie, die den Treffertestort vollständig umschließt. Wenn der Ausgabewert *isInside auf FALSE festgelegt ist, stellt diese Struktur die Geometrie dar, die den Rand umschließt, der der Treffertestposition am nächsten ist.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | dwrite.h |
| Bibliothek | Dwrite.lib |
| DLL | Dwrite.dll |