TextRange_ExpandToEnclosingUnit-Funktion (uiautomationcoreapi.h)

Artikel
03/06/2024

Hinweis Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen (Component Object Model) von Microsoft Benutzeroberflächenautomatisierung verwenden.

Erweitert den Textbereich auf eine größere oder kleinere Einheit, z. B. Zeichen, Word, Zeile oder Seite.

Syntax

HRESULT TextRange_ExpandToEnclosingUnit(
  [in] HUIATEXTRANGE hobj,
  [in] TextUnit      unit
);

Parameter

[in] hobj

Typ: HUIATEXTRANGE

Ein Textbereichsobjekt.

[in] unit

Typ: TextUnit

Die Einheit, auf die der Anbieter den Textbereich erweitern muss.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn erfolgreich oder andernfalls ein Fehlerwert vorhanden ist.

Hinweise

Wenn der Bereich bereits eine integrale Zahl der angegebenen Einheiten ist, bleibt er unverändert.

Wenn sich der Startendpunkt nicht an einer TextUnit-Grenze befindet, wird er rückwärts verschoben, bis er sich an einer Grenze befindet. Wenn sich der Endendpunkt anschließend nicht an einer Grenze befindet oder sich an der gleichen Grenze wie der Startendpunkt befindet, wird der Endendpunkt nach vorne verschoben, bis er sich an einer Grenze befindet.

Hinweis Es ist üblich, dass eine Sprachausgabe ein vollständiges Wort, einen ganzen Absatz usw. an der Einfügemarke oder einer beliebigen virtuellen Cursorposition vorliest.

TextRange_ExpandToEnclosingUnit berücksichtigt sowohl ausgeblendeten als auch sichtbaren Text. Der Benutzeroberflächenautomatisierungsclient kann das attribut is-hidden (Text_IsHidden_Attribute_GUID) auf Textsichtbarkeit überprüfen.

TextRange_ExpandToEnclosingUnit wird standardmäßig bis zur nächsten unterstützten TextUnit festgelegt, wenn die angegebene TextUnit vom Steuerelement nicht unterstützt wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcoreapi.h
Bibliothek	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Freigeben über