Freigeben über


ITextProvider::RangeFromChild-Methode (uiautomationcore.h)

Ruft einen Textbereich ab, der das angegebene untergeordnete Element einschließt (z. B. ein Bild, link oder ein anderes eingebettetes Objekt).

Syntax

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

Parameter

[in] childElement

Typ: IRawElementProviderSimple*

Der Benutzeroberflächenautomatisierung Anbieter des angegebenen untergeordneten Elements.

[out, retval] pRetVal

Typ: ITextRangeProvider**

Der Textbereich, der das untergeordnete Element einschließt.

Dieser Bereich schließt den Inhalt des untergeordneten Elements vollständig ein, sodass:

  1. ITextRangeProvider::GetEnclosingElement gibt das untergeordnete Element selbst oder den innersten Nachfolger des untergeordneten Elements zurück, das denselben Textbereich wie das untergeordnete Element verwendet.
  2. ITextRangeProvider::GetChildren gibt untergeordnete Elemente des Elements von (1) zurück, die vollständig innerhalb des Bereichs eingeschlossen sind.
  3. Beide Endpunkte des Bereichs befinden sich an den Grenzen des untergeordneten Elements.

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.

Hinweis

E_INVALIDARG wird zurückgegeben, wenn childElement kein Abstamm eines ITextProvider ist oder nicht von einem gültigen Textbereich eingeschlossen wird.

Hinweise

Jedes mit ITextRangeProvider::GetChildren abgerufene Element verfügt außerdem ü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

Anforderung Wert
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

Übersicht über ITextProvider, ITextRangeProvider, ITextRangeProvider::GetEnclosingElement, ITextRangeProvider::GetChildren, Benutzeroberflächenautomatisierung Providers