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

Weitere Informationen

Idwritetextlayout