IDWriteTextLayout::HitTestTextPosition-Methode (dwrite.h)
Die Anwendung ruft diese Funktion auf, um die Pixelposition relativ zur oberen linken Seite des Layoutfelds unter Berücksichtigung der Textposition und der logischen Seite der Position abzurufen. Diese Funktion wird normalerweise als Teil der Caretpositionierung von Text verwendet, bei der das Caretzeichen an der Position gezeichnet wird, die der aktuellen Textbearbeitungsposition entspricht. Es kann auch als Möglichkeit verwendet werden, die Geometrie einer bestimmten Textposition bei der Benutzeroberflächenautomatisierung programmgesteuert abzurufen.
Syntax
HRESULT HitTestTextPosition(
UINT32 textPosition,
BOOL isTrailingHit,
[out] FLOAT *pointX,
[out] FLOAT *pointY,
[out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);
Parameter
textPosition
Typ: UINT32
Die Textposition, die zum Abrufen der Pixelposition verwendet wird.
isTrailingHit
Typ: BOOL
Ein boolesches Flag, das angibt, ob sich die Pixelposition an der führenden oder nachgestellten Seite der angegebenen Textposition befindet.
[out] pointX
Typ: FLOAT*
Wenn diese Methode zurückgibt, enthält die Ausgabepixelposition X relativ zur linken oberen Position des Layoutfelds.
[out] pointY
Typ: FLOAT*
Wenn diese Methode zurückgibt, enthält die Ausgabepixelposition Y relativ zur linken oberen Position des Layoutfelds.
[out] hitTestMetrics
Typ: DWRITE_HIT_TEST_METRICS*
Wenn diese Methode zurückgibt, enthält die Ausgabegeometrie, die die angegebene Textposition vollständig umschließt.
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 |