Freigeben über


IUIAutomationTextRange::ExpandToEnclosingUnit-Methode (uiautomationclient.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 textUnit
);

Parameter

[in] textUnit

Typ: TextUnit

Die Texteinheit, z. B. Zeile oder Absatz.

Rückgabewert

Typ: HRESULT

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

Bemerkungen

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 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. Das folgende Diagramm zeigt, wie ExpandToEnclosingUnit einen Textbereich normalisiert, indem die Endpunkte des Bereichs verschoben werden.

Diagramm: Endpunkte vor und nach ExpandToEnclosingUnit

Diagramm: Endpunkte vor und nach ExpandToEnclosingUnit

ExpandToEnclosingUnit verwendet 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
  • Page
  • Dokument

ExpandToEnclosingUnit respektiert sowohl sichtbaren als auch ausgeblendeten Text.

Bereichsverhalten bei EinheitTextUnit::Format

TextUnit::Formatpositioniert als Einheitswert die Grenze eines Textbereichs, um den Bereich basierend auf freigegebenen Textattributen (oder -format) des Texts innerhalb des Bereichs zu erweitern oder zu verschieben. Die Format Texteinheit verschiebt oder erweitert jedoch keinen Textbereich über die Grenze eines eingebetteten Objekts, z. B. eines Bilds oder Links. Weitere Informationen finden Sie unter Benutzeroberflächenautomatisierung Texteinheiten oder Benutzeroberflächenautomatisierung Unterstützung für Textinhalte.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

IUIAutomationTextRange-Schnittstelle, Benutzeroberflächenautomatisierung Unterstützung für Textinhalte