IUIAutomationTextRange-Schnittstelle (uiautomationclient.h)

Ermöglicht den Zugriff auf eine Spanne von fortlaufendem Text in einem Container, der die IUIAutomationTextPattern-Schnittstelle unterstützt. Clientanwendungen können die IUIAutomationTextRange-Schnittstelle verwenden, um eingebettete Objekte aus der Textspanne auszuwählen, zu vergleichen und abzurufen. Die Schnittstelle verwendet zwei Endpunkte, um zu trennen, wo die Textspanne beginnt und endet. Nicht zusammenhängende Textspannen werden durch eine IUIAutomationTextRangeArray-Schnittstelle dargestellt.

Vererbung

Die IUIAutomationTextRange-Schnittstelle erbt von der IUnknown-Schnittstelle . IUIAutomationTextRange verfügt auch über die folgenden Membertypen:

Methoden

Die IUIAutomationTextRange-Schnittstelle verfügt über diese Methoden.

IUIAutomationTextRange::AddToSelection Fügt den Textbereich der Auflistung ausgewählter Textbereiche in einem Steuerelement hinzu, das mehrere, nicht zusammenhängende Spannen des ausgewählten Texts unterstützt. (IUIAutomationTextRange.AddToSelection)
IUIAutomationTextRange::Clone Ruft eine neue IUIAutomationTextRange ab, die mit dem Original identisch ist und alle Eigenschaften des Originals erbt.
IUIAutomationTextRange::Compare Ruft einen Wert ab, der angibt, ob dieser Textbereich dieselben Endpunkte wie ein anderer Textbereich aufweist. (IUIAutomationTextRange.Compare)
IUIAutomationTextRange::CompareEndpoints Ruft einen Wert ab, der angibt, ob der Start- oder Endpunkt dieses Textbereichs mit dem Start- oder Endpunkt eines anderen Textbereichs identisch ist.
IUIAutomationTextRange::ExpandToEnclosingUnit Normalisiert den Textbereich um die angegebene Texteinheit. Der Bereich wird erweitert, wenn er kleiner als die angegebene Einheit ist, oder verkürzt, wenn er länger als die angegebene Einheit ist. (IUIAutomationTextRange.ExpandToEnclosingUnit)
IUIAutomationTextRange::FindAttribute Ruft eine Textbereichsteilmenge ab, die über den angegebenen Textattributewert verfügt.
IUIAutomationTextRange::FindText Ruft eine Textbereichsteilmenge ab, die den angegebenen Text enthält.
IUIAutomationTextRange::GetAttributeValue Ruft den Wert des angegebenen Textattributes über den gesamten Textbereich ab.
IUIAutomationTextRange::GetBoundingRectangles Ruft für jede vollständig oder teilweise sichtbare Textzeile in einem Textbereich eine Auflistung von umgebenden Rechtecken ab. (IUIAutomationTextRange.GetBoundingRectangles)
IUIAutomationTextRange::GetChildren Ruft eine Auflistung aller eingebetteten Objekte ab, die innerhalb des Textbereichs liegen. (IUIAutomationTextRange.GetChildren)
IUIAutomationTextRange::GetEnclosingElement Gibt das innerste Ui Automation-Element zurück, das den Textbereich einschließt.
IUIAutomationTextRange::GetText Gibt den reinen Text des Textbereichs zurück.
IUIAutomationTextRange::Move Verschiebt den Textbereich um die angegebene Anzahl von Texteinheiten vorwärts oder rückwärts.
IUIAutomationTextRange::MoveEndpointByRange Verschiebt einen Endpunkt des aktuellen Textbereichs auf den angegebenen Endpunkt eines zweiten Textbereichs. (IUIAutomationTextRange.MoveEndpointByRange)
IUIAutomationTextRange::MoveEndpointByUnit Verschiebt einen Endpunkt des Textbereichs um die festgelegte Anzahl von Texteinheiten innerhalb des Dokumentbereichs.
IUIAutomationTextRange::RemoveFromSelection Entfernt den Textbereich aus einer vorhandenen Auflistung von ausgewähltem Text in einem Textcontainer, der mehrere, nicht zusammenhängende Auswahlen unterstützt.
IUIAutomationTextRange::ScrollIntoView Bewirkt, dass das Textsteuerelement so lange scrollt, bis der Textbereich im Viewport sichtbar ist.
IUIAutomationTextRange::Select Wählt die Textspanne aus, die diesem Textbereich entspricht, und entfernt jede vorherige Auswahl. (IUIAutomationTextRange.Select)

Anforderungen

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

Steuerelementmusterschnittstellen für Clients

Unterstützung der Benutzeroberflächenautomatisierung für Textinhalte

Verwenden von Textbereichen