Freigeben über


ITextRangeProvider::GetEnclosingElement-Methode (uiautomationcore.h)

Gibt das innerste Element zurück, das den angegebenen Textbereich umschließt.

Syntax

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

Parameter

[out, retval] pRetVal

Typ: IRawElementProviderSimple**

Der Benutzeroberflächenautomatisierung Anbieter des innersten Elements, das den angegebenen ITextRangeProvider umschließt.

Hinweis

Das einschließende Element kann mehr als nur den angegebenen ITextRangeProvider umfassen.

Wenn kein einschließendes Element gefunden wird, wird das übergeordnete ITextProvider-Element des ITextRangeProvider 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.

Bemerkungen

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 innerhalb des Textstreams verfügbar gemacht.

    Hello <Image Link> World

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

    Starttext

    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 (uiAutomation.h einschließen)

Weitere Informationen

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