Metodo IDWriteTextLayout::HitTestPoint (dwrite.h)

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

Vedi anche

IDWriteTextLayout