Metodo IDWriteTextLayout::HitTestTextPosition (dwrite.h)

Articolo
03/05/2024

L'applicazione chiama questa funzione per ottenere la posizione in pixel rispetto all'angolo superiore sinistro della casella di layout in base alla posizione del testo e al lato logico della posizione. Questa funzione viene in genere utilizzata come parte del posizionamento del cursore del testo in cui il cursore viene disegnato nella posizione corrispondente alla posizione di modifica del testo corrente. Può anche essere usato come metodo per ottenere la geometria di una posizione di testo specifica nell'automazione dell'interfaccia utente a livello di codice.

Sintassi

HRESULT HitTestTextPosition(
        UINT32                  textPosition,
        BOOL                    isTrailingHit,
  [out] FLOAT                   *pointX,
  [out] FLOAT                   *pointY,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

Parametri

textPosition

Tipo: UINT32

Posizione di testo usata per ottenere la posizione del pixel.

isTrailingHit

Tipo: BOOL

Flag booleano che indica se la posizione del pixel è iniziale o finale della posizione del testo specificata.

[out] pointX

Tipo: FLOAT*

Quando termina, questo metodo contiene la posizione del pixel di output X, rispetto alla posizione superiore sinistra della casella di layout.

[out] pointY

Tipo: FLOAT*

Quando termina, questo metodo contiene la posizione del pixel di output Y, rispetto alla posizione superiore sinistra della casella di layout.

[out] hitTestMetrics

Tipo: DWRITE_HIT_TEST_METRICS*

Quando termina, questo metodo contiene la geometria di output che racchiude completamente la posizione di testo specificata.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	dwrite.h
Libreria	Dwrite.lib
DLL	Dwrite.dll

Vedi anche

IDWriteTextLayout

Condividi tramite