Condividi tramite


Metodo ITextProvider::RangeFromChild (uiautomationcore.h)

Recupera un intervallo di testo che racchiude l'elemento figlio specificato, ad esempio un'immagine, un collegamento ipertestuale o un altro oggetto incorporato.

Sintassi

HRESULT RangeFromChild(
  [in]          IRawElementProviderSimple *childElement,
  [out, retval] ITextRangeProvider        **pRetVal
);

Parametri

[in] childElement

Tipo: IRawElementProviderSimple*

Provider Automazione interfaccia utente dell'elemento figlio specificato.

[out, retval] pRetVal

Tipo: ITextRangeProvider**

Intervallo di testo che racchiude l'elemento figlio.

Questo intervallo racchiude completamente il contenuto dell'elemento figlio in modo che:

  1. ITextRangeProvider::GetEnclosingElement restituisce l'elemento figlio stesso o il discendente più interno dell'elemento figlio che condivide lo stesso intervallo di testo dell'elemento figlio
  2. ITextRangeProvider::GetChildren restituisce elementi figlio dell'elemento da (1) completamente racchiusi all'interno dell'intervallo
  3. Entrambi gli endpoint dell'intervallo si trovano ai limiti dell'elemento figlio

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 .

Nota

E_INVALIDARG viene restituito se childElement non è un discendente di un ITextProvider o non è racchiuso in un intervallo di testo valido.

Commenti

Ogni elemento recuperato con ITextRangeProvider::GetChildren ha anche un intervallo di testo valido che può essere recuperato tramite RangeFromChild. Include tutti gli elementi nell'albero Automazione interfaccia utente tra ITextProvider e l'elemento figlio.

Esempio

  1. Questo esempio mostra un flusso di testo che contiene un collegamento immagine. Il collegamento è un elemento figlio dell'immagine, ma entrambi si estendono sullo stesso intervallo di testo e vengono esposti come oggetti incorporati all'interno del flusso di testo.

    Hello <Image Link> World

  2. Questo esempio mostra un flusso di testo che contiene una tabella a due celle circondata da testo.

    Testo iniziale

    Cella tabella 1Cella tabella 2

    Testo finale

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione uiautomationcore.h (includere UIAutomation.h)

Vedi anche

ITextProvider, ITextRangeProvider, ITextRangeProvider::GetEnclosingElement, ITextRangeProvider::GetChildren, Automazione interfaccia utente Provider panoramica