Freigeben über


ITextRangeProvider::GetChildren-Methode (uiautomationcore.h)

Ruft eine Auflistung aller Elemente ab, die (teilweise oder vollständig) im angegebenen Textbereich enthalten sind und untergeordnete Elemente des einschließenden Elements für den angegebenen Textbereich sind.

Syntax

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

Parameter

[out, retval] pRetVal

Typ: SAFEARRAY**

Ein Array von Zeigern auf die IRawElementProviderSimple-Schnittstellen für alle untergeordneten Elemente, die vom Textbereich eingeschlossen werden (sortiert nach dem Startendpunkt ihrer Bereiche).

Wenn der Textbereich keine untergeordneten Elemente enthält, wird eine leere Auflistung zurückgegeben.

Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Jedes mit ITextRangeProvider::GetChildren abgerufene Element verfügt über einen gültigen Textbereich, der über RangeFromChild abgerufen werden kann. Dies schließt alle Elemente in der Benutzeroberflächenautomatisierung-Struktur zwischen dem ITextProvider und dem untergeordneten Element ein.

Beispiele

  1. Dieses Beispiel zeigt einen Textstream, der einen Bildlink enthält. Der Link ist ein untergeordnetes Element des Bilds, aber beide umfassen denselben Textbereich und werden als eingebettete Objekte im Textstream verfügbar gemacht.

    Hello <Image Link> World

  2. Dieses Beispiel zeigt einen Textstream, der eine zweizellige Tabelle enthält, die von Text umgeben ist.

    Text starten

    Tabellenzelle 1Tabellenzelle 2

    Text beenden

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile uiautomationcore.h (include UIAutomation.h)

Weitere Informationen

ITextProvider, ITextRangeProvider, GetEnclosingElement, ITextProvider::RangeFromChild, Benutzeroberflächenautomatisierung Providers Overview, Best Practices for Using Safe Arrays