ITextProvider2 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.
Erweitert die ITextProvider-Schnittstelle , damit Microsoft-Benutzeroberflächenautomatisierungsanbieter Textinhalte verfügbar machen können, die das Ziel einer Anmerkung oder Auswahl sind. Implementieren Sie diese Schnittstelle, um die Funktionen zu unterstützen, die ein Automatisierungsclient mit einem GetPattern-Aufruf und PatternInterface.Text2 anfordert.
public interface class ITextProvider2 : ITextProvider/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(3743238332, 1159, 20095, 157, 94, 240, 158, 119, 228, 18, 70)]
struct ITextProvider2 : ITextProvider[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(3743238332, 1159, 20095, 157, 94, 240, 158, 119, 228, 18, 70)]
public interface ITextProvider2 : ITextProviderPublic Interface ITextProvider2
Implements ITextProvider- Attribute
- Implementiert
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.
Das ITextProvider2-Muster verfügt nicht über eine Windows-Runtime Eigenschaftsbezeichnerklasse.
Schnittstellenvererbung
ITextProvider2 erbt ITextProvider. Typen, die ITextProvider2 implementieren, implementieren auch die Schnittstellenmember von ITextProvider.
Eigenschaften
| DocumentRange |
Ruft einen Textbereich ab, der den Haupttext eines Dokuments umschließt. (Geerbt von ITextProvider) |
| SupportedTextSelection |
Ruft einen Wert ab, der angibt, ob ein Textanbieter die Auswahl unterstützt, und wenn dies der Fall ist, den Unterstützten Auswahltyp. (Geerbt von ITextProvider) |
Methoden
| GetCaretRange(Boolean) |
Ruft einen Textbereich der Länge Null an der Position des Carets ab, das zum textbasierten Steuerelement gehört. |
| GetSelection() |
Ruft eine Auflistung nicht zusammenhängender Textbereiche ab, die der aktuellen Textauswahl oder -auswahl zugeordnet sind. (Geerbt von ITextProvider) |
| 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. (Geerbt von ITextProvider) |
| RangeFromAnnotation(IRawElementProviderSimple) |
Macht einen Textbereich verfügbar, der den Text enthält, der das Ziel der Anmerkung ist, die dem angegebenen Anmerkungselement zugeordnet ist. |
| RangeFromChild(IRawElementProviderSimple) |
Ruft einen Textbereich ab, der ein untergeordnetes Element umschließt, z. B. ein Bild, ein Link oder ein anderes eingebettetes Objekt. (Geerbt von ITextProvider) |
| RangeFromPoint(Point) |
Ruft einen Textbereich aus der Nähe einer Bildschirmkoordinate ab. (Geerbt von ITextProvider) |