Metodo IDWriteTextLayout::HitTestPoint (dwrite.h)

Articolo
02/27/2024

L'applicazione chiama questa funzione passando una posizione in pixel specifica rispetto alla posizione superiore sinistra della casella di layout e ottiene le informazioni sulle metriche hit test corrispondenti della stringa di testo in cui si è verificato l'hit test. Quando la posizione in pixel specificata si trova all'esterno della stringa di testo, la funzione imposta il valore di output *isInside su FALSE.

Sintassi

HRESULT HitTestPoint(
        FLOAT                   pointX,
        FLOAT                   pointY,
  [out] BOOL                    *isTrailingHit,
  [out] BOOL                    *isInside,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

Parametri

pointX

Tipo: FLOAT

Posizione in pixel X per l'hit test, rispetto alla posizione superiore sinistra della casella di layout.

pointY

Tipo: FLOAT

Posizione in pixel Y per l'hit test, rispetto alla posizione superiore sinistra della casella di layout.

[out] isTrailingHit

Tipo: BOOL*

Flag di output che indica se la posizione di hit test si trova all'inizio o al lato finale del carattere. Quando il valore di output *isInside è impostato su FALSE, questo valore viene impostato in base al valore di output hitTestMetrics-textPosition> per rappresentare il bordo più vicino alla posizione di hit test.

[out] isInside

Tipo: BOOL*

Flag di output che indica se la posizione di hit test si trova all'interno della stringa di testo. Se FALSE, viene restituita la posizione più vicina al bordo del testo.

[out] hitTestMetrics

Tipo: DWRITE_HIT_TEST_METRICS*

Geometria di output che racchiude completamente la posizione di hit test. Quando il valore di output *isInside è impostato su FALSE, questa struttura rappresenta la geometria che racchiude il bordo più vicino alla posizione di hit test.

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