Metodo ITextProvider::RangeFromPoint (uiautomationcore.h)

Restituisce l'intervallo di testo degenerato (vuoto) più vicino alle coordinate dello schermo specificate.

Sintassi

HRESULT RangeFromPoint(
  [in]          UiaPoint           point,
  [out, retval] ITextRangeProvider **pRetVal
);

Parametri

[in] point

Tipo: UiaPoint

Percorso nelle coordinate dello schermo.

[out, retval] pRetVal

Tipo: ITextRangeProvider**

Riceve un puntatore all'intervallo di testo degenerato (vuoto) più vicino alla posizione specificata. Questo parametro viene passato non inizializzato.

Valore restituito

Tipo: HRESULT

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

Commenti

Viene restituito un intervallo di testo che racchiude un oggetto figlio se le coordinate dello schermo si trovano all'interno delle coordinate di un'immagine, di un collegamento ipertestuale o di un altro oggetto incorporato.

Poiché il testo nascosto non viene ignorato da ITextProvider::RangeFromPoint, viene restituito un intervallo degenerato dal testo visibile più vicino al punto specificato.

La proprietà non restituisce mai NULL.

Requisiti

Vedi anche

Informazioni concettuali

ITextProvider

ITextRangeProvider

Riferimento

Cenni preliminari sui provider di automazione interfaccia utente