ITextRangeProvider::ExpandToEnclosingUnit-Methode (uiautomationcore.h)

Normalisiert den Textbereich durch die angegebene Texteinheit. Der Bereich wird erweitert, wenn er kleiner als die angegebene Einheit ist, oder gekürzt, wenn er länger als die angegebene Einheit ist.

Syntax

HRESULT ExpandToEnclosingUnit(
  [in] TextUnit unit
);

Parameter

[in] unit

Typ: TextUnit

Der Typ der Texteinheiten, z. B. Zeichen, Wort, Absatz usw.

Rückgabewert

Typ: HRESULT

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

Hinweise

Clientanwendungen wie Sprachausgaben verwenden diese Methode zum Abrufen des vollständigen Worts, Satzes oder Absatzes, der an der Einfügemarke oder der Caretposition vorhanden ist.

Trotz ihres Namens erweitert die ITextRangeProvider::ExpandToEnclosingUnit-Methode nicht unbedingt einen Textbereich. Stattdessen "normalisiert" es einen Textbereich, indem die Endpunkte so verschoben werden, dass der Bereich die angegebene Texteinheit umfasst. Der Bereich wird erweitert, wenn er kleiner als die angegebene Einheit ist, oder gekürzt, wenn er länger als die angegebene Einheit ist. Wenn der Bereich bereits eine exakte Menge der angegebenen Einheiten ist, bleibt er unverändert. Es ist wichtig, dass die ExpandToEnclosingUnit-Methode Textbereiche immer auf konsistente Weise normalisiert. Andernfalls wären andere Aspekte der Textbereichsbearbeitung nach Texteinheit unvorhersehbar. Das folgende Diagramm zeigt, wie ExpandToEnclosingUnit einen Textbereich normalisiert, indem die Endpunkte des Bereichs verschoben werden.

ExpandToEnclosingUnit standardmäßig die nächstgrößer unterstützte Texteinheit, wenn die angegebene Texteinheit vom Steuerelement nicht unterstützt wird. Die Reihenfolge, von der kleinsten Einheit bis zur größten, lautet wie folgt:

• Zeichen
• Format
• Word
• Linie
• Paragraph
• Seite
• Document

ExpandToEnclosingUnit respektiert sowohl sichtbaren als auch ausgeblendeten Text.

Bereichsverhalten bei EinheitTextUnit::Format

TextUnit::Format als Einheitswert positioniert die Grenze eines Textbereichs, um den Bereich basierend auf freigegebenen Textattributen (Format) des Texts innerhalb des Bereichs zu erweitern oder zu verschieben. Die Verwendung der Formattexteinheit sollte jedoch keinen Textbereich über die Grenze eines eingebetteten Objekts, z. B. eines Bilds oder Links, verschieben oder erweitern. Weitere Informationen finden Sie unter Texteinheiten für die Benutzeroberflächenautomatisierung oder Text- und TextRange-Steuerelementmuster.

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

Siehe auch

Konzept

ITextProvider

ITextRangeProvider

Referenz

Text- und TextRange-Steuerelementmuster

Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter