Metodo ITextRangeProvider::GetChildren (uiautomationcore.h)

Recupera una raccolta di tutti gli elementi contenuti (parzialmente o completamente) all'interno dell'intervallo di testo specificato e sono elementi figlio dell'elemento di inclusione per l'intervallo di testo specificato.

Sintassi

HRESULT GetChildren(
  [out, retval] SAFEARRAY **pRetVal
);

Parametri

[out, retval] pRetVal

Tipo: SAFEARRAY**

Matrice di puntatori alle interfacce IRawElementProviderSimple per tutti gli elementi figlio racchiusi nell'intervallo di testo (ordinati dall'endpoint Start degli intervalli).

Se l'intervallo di testo non include elementi figlio, viene restituita una raccolta vuota.

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

Ogni elemento recuperato con ITextRangeProvider::GetChildren ha 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

   • Sia l'immagine che il collegamento sono discendenti anche dell'ITextProvider del flusso e possono essere specificati come childElement in una chiamata a ITextProvider::RangeFromChild.
   • Chiamando ITextRangeProvider::RangeFromChild, usando l'immagine o il collegamento, restituisce lo stesso intervallo di testo (Range1).
   • GetChildren non restituisce il collegamento.
   • GetEnclosingElement non restituisce l'immagine per un intervallo di testo.
   • GetEnclosingElement in Range1 restituisce il collegamento.
   • GetChildren on Range1 non restituisce figli.
   • GetEnclosingElement nell'intervallo di testo per ITextProvider del flusso restituisce il provider.
   • GetChildren nell'intervallo di testo per ITextProvider del flusso restituisce solo l'immagine.

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

   Testo iniziale

   Cella tabella 1

   Cella tabella 2

   Testo finale

   • Case 1: ITextProvider del flusso e l'intero intervallo di testo
     • ITextRangeProvider::GetEnclosingElement nell'intero intervallo di testo restituisce ITextProvider del flusso.
     • GetChildren restituisce tutti gli elementi figlio dell'ITextProvider del flusso, solo l'elemento della tabella in questo caso.
   • Case 2: Intervallo di testo ottenuto chiamando ITextProvider::RangeFromChild nell'elemento della tabella:
     • ITextRangeProvider::GetEnclosingElement restituisce l'elemento della tabella.
     • ITextRangeProvider::GetChildren restituisce entrambe le celle della tabella.
   • Case 3: Intervallo di testo che estende il contenuto visivo della cella Tabella 1 Cella 1 Cella 2:
     • ITextRangeProvider::GetEnclosingElement restituisce l'elemento della tabella.
     • ITextRangeProvider::GetChildren restituisce entrambe le celle della tabella.
   • Case 4: Intervallo di testo che si estende sulla parola Cella della cella tabella 1:
     • ITextRangeProvider::GetEnclosingElement restituisce il primo elemento della cella.
     • ITextRangeProvider::GetChildren non restituisce alcun elemento.
   • Caso 5: intervallo di testo degenerato (vuoto) che rappresenta sia l'avvio (tabella e prima cella):
     • ITextRangeProvider::GetEnclosingElement restituisce il primo elemento cella (l'elemento più interno con un intervallo che include l'intervallo degenerato).
     • ITextRangeProvider::GetChildren non restituisce alcun elemento.

Requisiti

Vedi anche

ITextProvider, ITextRangeProvider, GetEnclosingElement, ITextProvider::RangeFromChild, panoramica dei provider di Automazione interfaccia utente, procedure consigliate per l'uso di matrici sicure