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.

Nota

L'elemento contenitore può estendersi più del semplice 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

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 (include UIAutomation.h)

Vedi anche

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