Metodo IUIAutomationTextPattern::RangeFromPoint (uiautomationclient.h)

Articolo
08/26/2023

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

Sintassi

HRESULT RangeFromPoint(
  [in]          POINT                  pt,
  [out, retval] IUIAutomationTextRange **range
);

Parametri

[in] pt

Tipo: POINT

Struttura che contiene la posizione, nelle coordinate dello schermo.

[out, retval] range

Tipo: IUIAutomationTextRange**

Riceve un puntatore all'intervallo di testo degenerato più vicino alla posizione specificata.

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 esegue il wrapping di un oggetto figlio se le coordinate dello schermo si trovano nelle coordinate di un'immagine, un collegamento ipertestuale, un foglio di calcolo di Microsoft Excel o un altro oggetto incorporato.

Poiché il testo nascosto non viene ignorato, questo metodo recupera un intervallo degenerato dal testo visibile più vicino alle coordinate specificate.

L'implementazione di RangeFromPoint in Windows Internet Explorer 9 non restituisce il risultato previsto. I client devono invece:

Chiamare il metodo GetVisibleRanges per recuperare una matrice di intervalli di testo visibili.
Per ogni intervallo di testo nella matrice, chiamare IUIAutomationTextRange::GetBoundingRectangles per recuperare i rettangoli di delimitazione.
Controllare i rettangoli di selezione per trovare l'intervallo di testo che occupa le coordinate dello schermo specifiche.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationclient.h (includere UIAutomation.h)

Vedi anche

IUIAutomationTextPattern

Automazione interfaccia utente supporto per il contenuto testuale

Condividi tramite