Freigeben über

ITextProvider Schnittstelle

  • Referenz

Definition

Namespace:
Windows.UI.Xaml.Automation.Provider
Bearbeiten

Macht Methoden und Eigenschaften verfügbar, um den Clientzugriff von Microsoft UI Automation auf Steuerelemente zu unterstützen, die Text enthalten. Implementieren Sie diese Schnittstelle, um die Funktionen zu unterstützen, die ein Automatisierungsclient mit einem GetPattern-Aufruf und PatternInterface.Text anfordert.

public interface class ITextProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(3680222367, 18439, 20266, 134, 120, 27, 19, 243, 198, 14, 34)]
struct ITextProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(3680222367, 18439, 20266, 134, 120, 27, 19, 243, 198, 14, 34)]
public interface ITextProvider
Public Interface ITextProvider
Abgeleitet
Attribute
ContractVersionAttribute GuidAttribute

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 Automatisierungspeer implementiert, die diese Definition der Schnittstelle verwenden. Die von Windows-Runtime Textsteuerelementen wie TextBox und RichTextBlock unterstützten Textmodelle implementieren einige dieser Muster, aber 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.

Die Microsoft-Benutzeroberflächenautomatisierungsschnittstellen innerhalb der Windows-Runtime-API sind vorhanden, sodass Autoren von benutzerdefinierten Steuerelementen das Automatisierungsmuster in einem benutzerdefinierten Steuerelement unterstützen und ihre Automatisierungsunterstützung mithilfe der gleichen Windows-Runtime verwalteten oder C++-API implementieren können, die sie zum Definieren von Steuerungslogik oder anderer Automatisierungsunterstützung verwenden.

Das ITextProvider-Muster verfügt nicht über eine Windows-Runtime Eigenschaftsbezeichnerklasse.

Eigenschaften

DocumentRange

Ruft einen Textbereich ab, der den Haupttext eines Dokuments umschließt.
SupportedTextSelection

Ruft einen Wert ab, der angibt, ob ein Textanbieter die Auswahl unterstützt, und wenn dies der Fall ist, den Unterstützten Auswahltyp.

Methoden

GetSelection()

Ruft eine Auflistung nicht zusammenhängender Textbereiche ab, die der aktuellen Textauswahl oder -auswahl zugeordnet sind.
GetVisibleRanges()

Ruft ein Array nicht zusammenhängender Textbereiche aus einem Textcontainer ab. Jeder Textbereich beginnt mit der ersten teilweise sichtbaren Zeile und endet mit der letzten teilweise sichtbaren Zeile.
RangeFromChild(IRawElementProviderSimple)

Ruft einen Textbereich ab, der ein untergeordnetes Element umschließt, z. B. ein Bild, ein Link oder ein anderes eingebettetes Objekt.
RangeFromPoint(Point)

Ruft einen Textbereich aus der Nähe einer Bildschirmkoordinate ab.

Gilt für:

Weitere Informationen