ITextProvider 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 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 AutomationPeer.GetPattern-Aufruf und PatternInterface.Text anfordert.
public interface class ITextProvider/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(937942246, 65146, 22183, 164, 122, 148, 98, 135, 44, 103, 239)]
struct ITextProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.Guid(937942246, 65146, 22183, 164, 122, 148, 98, 135, 44, 103, 239)]
public interface ITextProviderPublic Interface ITextProvider- 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 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. |