Freigeben über


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