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 Microsoft Benutzeroberflächenautomatisierung Clientzugriff auf einen Bereich von fortlaufendem Text in einem Textcontainer zu unterstützen, der ITextProvider implementiert.
public interface class ITextRangeProvider/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(2216756065, 27874, 20612, 191, 59, 40, 175, 166, 233, 133, 31)]
struct ITextRangeProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.Guid(2216756065, 27874, 20612, 191, 59, 40, 175, 166, 233, 133, 31)]
public interface ITextRangeProviderPublic Interface ITextRangeProvider- Abgeleitet
- Attribute
Hinweise
Weitere Informationen zu diesem Muster finden Sie unter Text- und TextRange-Steuerelementmuster.
ITextProvider, ITextProvider2 und ITextRangeProvider werden nicht von vorhandenen Windows-Runtime Automatisierungspeers mithilfe dieser Definition der Schnittstelle implementiert. Die textmodelle, die von Windows-Runtime Textsteuerelementen wie TextBox und RichTextBlock unterstützt werden, implementieren einige dieser Muster, jedoch auf einer systemeigenen 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
| Name | Beschreibung |
|---|---|
| AddToSelection() |
Fügt der Auflistung von hervorgehobenem Text in einem Textcontainer hinzu, der mehrere nicht zusammenhängende 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 Textbereichsuntermenge zurück, die die angegebene Attribut-ID und den Attributwert aufweist. |
| FindText(String, Boolean, Boolean) |
Gibt eine Textbereichsuntermenge zurück, die den angegebenen Text enthält. |
| GetAttributeValue(Int32) |
Ruft den Wert der angegebenen Attribut-ID im Textbereich ab. |
| GetBoundingRectangles(Double[]) |
Ruft eine Auflistung von umgebenden Rechtecke für jede vollständig oder teilweise sichtbare Textzeile in einem Textbereich 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 Nur-Text des Bereichs ab. |
| Move(TextUnit, Int32) |
Verschiebt den Textbereich in die angegebene 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 angegebene Anzahl von Texteinheiten innerhalb des Dokumentbereichs. |
| RemoveFromSelection() |
Aus der Auflistung hervorgehobener Text in einem Textcontainer, der mehrere nicht zusammenhängende Auswahlen unterstützt, entfernt einen hervorgehobenen Textabschnitt, der den Textbereichsendpunkten des Aufrufers entspricht. |
| ScrollIntoView(Boolean) |
Bewirkt, dass das Textsteuerelement vertikal scrollt, bis der Textbereich im Viewport sichtbar ist. |
| Select() |
Hebt Text im Textsteuerelement hervor, der den Anfangs- und Endendpunkten des Textbereichs entspricht. |