ITextRangeProvider Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Macht Methoden und Eigenschaften verfügbar, um den Microsoft UI Automation-Clientzugriff auf eine Spanne von fortlaufendem Text in einem Textcontainer zu unterstützen, der ITextProvider implementiert.
public interface class ITextRangeProvider/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(41183373, 1769, 20326, 148, 70, 40, 165, 190, 152, 251, 208)]
struct ITextRangeProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(41183373, 1769, 20326, 148, 70, 40, 165, 190, 152, 251, 208)]
public interface ITextRangeProviderPublic Interface ITextRangeProvider- Abgeleitet
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Hinweise
Weitere Informationen zu diesem Muster finden Sie unter Text- und TextRange-Steuerelementmuster.
ITextProvider, ITextProvider2 und ITextRangeProvider werden nicht von vorhandenen Windows-Runtime Automatisierungs peers implementiert, die diese Definition der Schnittstelle verwenden. Die von Windows-Runtime Textsteuerelementen unterstützten Textmodelle wie TextBox und RichTextBlock implementieren einige dieser Muster, tun dies jedoch auf einer nativen Ebene, die nicht in den Windows-Runtime Definitionen der API-Oberfläche angezeigt wird. Weitere Informationen finden Sie in den Peerklassen für die verschiedenen Windows-Runtime Textsteuerelemente.
Das ITextRangeProvider-Muster verfügt nicht über eine Windows-Runtime Eigenschaftsbezeichnerklasse.
Methoden
| AddToSelection() |
Fügt der Auflistung hervorgehobenen Texts in einem Textcontainer hinzu, der mehrere disjoint-Auswahlen unterstützt. |
| Clone() |
Gibt einen neuen ITextRangeProvider zurück, der mit dem ursprünglichen ITextRangeProvider identisch ist und alle Eigenschaften des Originals erbt. |
| Compare(ITextRangeProvider) |
Gibt einen Wert zurück, der angibt, ob die Anfangs- und Endpunkte eines Textbereichs mit einem anderen Textbereich identisch sind. |
| CompareEndpoints(TextPatternRangeEndpoint, ITextRangeProvider, TextPatternRangeEndpoint) |
Gibt einen Wert zurück, der angibt, ob zwei Textbereiche identische Endpunkte aufweisen. |
| ExpandToEnclosingUnit(TextUnit) |
Erweitert den Textbereich auf die angegebene Texteinheit. |
| FindAttribute(Int32, Object, Boolean) |
Gibt eine Textbereichsteilmenge zurück, die über die angegebene Attribut-ID und den angegebenen Attributwert verfügt. |
| FindText(String, Boolean, Boolean) |
Gibt den Teil des Textbereichs zurück, der den angegebenen Text enthält. |
| GetAttributeValue(Int32) |
Ruft den Wert der angegebenen Attribut-ID im gesamten Textbereich ab. |
| GetBoundingRectangles(Double[]) |
Ruft für jede vollständig oder teilweise sichtbare Textzeile in einem Textbereich eine Auflistung von umgebenden Rechtecken ab. |
| GetChildren() |
Ruft eine Auflistung aller eingebetteten Objekte ab, die innerhalb des Textbereichs vorhanden sind. |
| GetEnclosingElement() |
Gibt das innerste Element zurück, das den Textbereich einschließt. |
| GetText(Int32) |
Ruft den reinen Text des Bereichs ab. |
| Move(TextUnit, Int32) |
Verschiebt den Textbereich um die festgelegte Anzahl von Texteinheiten. |
| MoveEndpointByRange(TextPatternRangeEndpoint, ITextRangeProvider, TextPatternRangeEndpoint) |
Verschiebt einen Endpunkt eines Textbereichs an den angegebenen Endpunkt eines zweiten Textbereichs. |
| MoveEndpointByUnit(TextPatternRangeEndpoint, TextUnit, Int32) |
Verschiebt einen Endpunkt des Textbereichs um die festgelegte Anzahl von Texteinheiten innerhalb des Dokumentbereichs. |
| RemoveFromSelection() |
Aus der Auflistung von hervorgehobenem Text in einem Textcontainer, der mehrere disjoint-Auswahlen unterstützt, entfernt ein hervorgehobener Textabschnitt, der den Textbereichsendpunkten des Aufrufers entspricht. |
| ScrollIntoView(Boolean) |
Bewirkt, dass im Textsteuerelement ein vertikaler Bildlauf durchgeführt wird, bis der Textbereich im Anzeigebereich sichtbar ist. |
| Select() |
Hebt Text im Textsteuerelement hervor, der den Anfangs- und Endpunkten des Textbereichs entspricht. |