ITextProvider.GetVisibleRanges Methode

Definition

Ruft ein Array von nicht zusammenhängenden Textbereichen aus einem Textcontainer ab, wobei jeder Textbereich mit der ersten teilweise sichtbaren Zeile beginnt und mit dem Ende der letzten teilweise sichtbaren Zeile endet.Retrieves an array of disjoint text ranges from a text container where each text range begins with the first partially visible line through to the end of the last partially visible line.

public:
 cli::array <System::Windows::Automation::Provider::ITextRangeProvider ^> ^ GetVisibleRanges();
public System.Windows.Automation.Provider.ITextRangeProvider[] GetVisibleRanges ();
abstract member GetVisibleRanges : unit -> System.Windows.Automation.Provider.ITextRangeProvider[]
Public Function GetVisibleRanges () As ITextRangeProvider()

Gibt zurück

ITextRangeProvider[]

Die Auflistung sichtbarer Textbereiche innerhalb des Containers oder eines leeren Arrays.The collection of visible text ranges within the container or an empty array. Ein NULL-Verweis (Nothing in Visual Basic) wird nie zurückgegeben.A null reference (Nothing in Visual Basic) is never returned.

Hinweise

Benutzeroberflächenautomatisierungs-Anbieter sollten sicherstellen, dass Sie höchstens die Textbereiche zurückgeben, die im Container sichtbar sind.UI Automation providers should ensure that they return, at most, the text ranges that are visible within the container.

Zusammenhängende Textbereiche können auftreten, wenn der Inhalt eines Text Containers von einem überlappenden Fenster oder einem anderen Objekt verdeckt wird oder wenn für einen Text Container mit einem mehrspaltigen Layout eine oder mehrere Spalten teilweise aus der Ansicht entfernt wurden.Disjoint text ranges may occur when any content of a text container is obscured by an overlapping window or other object, or when a text container with a multi-column layout has one or more columns partially scrolled out of view.

Wenn kein Text sichtbar ist, wird ein degenerierter (leerer) Textbereich zurückgegeben.If no text is visible, a degenerate (empty) text range is returned. Dieser leere Bereich kann zurückgegeben werden, wenn der Text Container leer ist oder wenn der gesamte Text aus der Ansicht ausgescrollt wird.This empty range can be returned if the text container is empty or when all text is scrolled out of view.

Gilt für:

Siehe auch