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 Microsoft Benutzeroberflächenautomatisierung Clientzugriff 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 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.
Die Microsoft Benutzeroberflächenautomatisierung Schnittstellen innerhalb der Windows-Runtime-API sind vorhanden, sodass benutzerdefinierte Steuerelementautoren das Automatisierungsmuster in einem benutzerdefinierten Steuerelement unterstützen und ihre Automatisierungsunterstützung mithilfe der gleichen Windows-Runtime verwalteten oder C++-API implementieren können, wie sie zum Definieren der Steuerelementlogik oder einer anderen Automatisierungsunterstützung verwenden.
Das ITextProvider-Muster verfügt nicht über eine Windows-Runtime Eigenschaftsbezeichnerklasse.
Eigenschaften
| Name | Beschreibung |
|---|---|
| DocumentRange |
Ruft einen Textbereich ab, der den Haupttext eines Dokuments einschließt. |
| SupportedTextSelection |
Ruft einen Wert ab, der angibt, ob ein Textanbieter die Auswahl unterstützt, und wenn dies der Fall ist, den Typ der auswahl, die unterstützt wird. |
Methoden
| Name | Beschreibung |
|---|---|
| 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 einschließt, z. B. ein Bild, einen Hyperlink oder ein anderes eingebettetes Objekt. |
| RangeFromPoint(Point) |
Ruft einen Textbereich aus der Nähe einer Bildschirmkoordinate ab. |