Metodo ITextRangeProvider::GetEnclosingElement (uiautomationcore.h)

Restituisce l'elemento più interno che racchiude l'intervallo di testo specificato.

Sintassi

HRESULT GetEnclosingElement(
  [out, retval] IRawElementProviderSimple **pRetVal
);

Parametri

[out, retval] pRetVal

Tipo: IRawElementProviderSimple**

Provider Automazione interfaccia utente dell'elemento più interno che racchiude l'oggetto ITextRangeProvider specificato.

Se non viene trovato alcun elemento di inclusione, viene restituito l'elemento padre ITextProvider di ITextRangeProvider .

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

Esempi

1. Questo esempio mostra un flusso di testo che contiene un collegamento di 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 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, viene restituito 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 su Range1 non restituisce alcun figlio.
   • GetEnclosingElement nell'intervallo di testo per l'ITextProvider del flusso restituisce il provider.
   • GetChildren nell'intervallo di testo per ITextProvider del flusso restituisce solo l'immagine.

2. In questo esempio viene illustrato un flusso di testo contenente una tabella a due celle racchiusa in testo.

   Testo iniziale

   Cella tabella 1

   Cella tabella 2

   Fine testo

   • Caso 1: ITextProvider del flusso e l'intero intervallo di testo
     • ITextRangeProvider::GetEnclosingElement nell'intero intervallo di testo restituisce LTextProvider del flusso.
     • GetChildren restituisce tutti gli elementi figlio dell'ITextProvider del flusso, solo l'elemento table in questo caso.
   • Caso 2: Intervallo di testo ottenuto chiamando ITextProvider::RangeFromChild sull'elemento della tabella:
     • ITextRangeProvider::GetEnclosingElement restituisce l'elemento table.
     • ITextRangeProvider::GetChildren restituisce entrambe le celle della tabella.
   • Caso 3: Intervallo di testo che si estende sul contenuto visivo della cella Tabella 1 Cella 2:
     • ITextRangeProvider::GetEnclosingElement restituisce l'elemento table.
     • ITextRangeProvider::GetChildren restituisce entrambe le celle della tabella.
   • Caso 4: Intervallo di testo che si estende sulla parola Cella della cella di 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'inizio (tabella che la prima cella):
     • ITextRangeProvider::GetEnclosingElement restituisce il primo elemento della cella (l'elemento più interno con un intervallo che include l'intervallo degenerato).
     • ITextRangeProvider::GetChildren non restituisce alcun elemento.

Requisiti

Vedi anche

Panoramica dei provider ITextProvider, ITextRangeProvider, ITextRangeProvider::GetChildren, Automazione interfaccia utente Providers