IUIAutomationTextPattern::GetSelection-Methode (uiautomationclient.h)
Ruft eine Auflistung von Textbereichen ab, die den aktuell ausgewählten Text in einem textbasierten Steuerelement darstellt.
Syntax
HRESULT GetSelection(
[out, retval] IUIAutomationTextRangeArray **ranges
);
Parameter
[out, retval] ranges
Typ: IUIAutomationTextRangeArray**
Empfängt einen Zeiger auf die Auflistung von Textbereichen.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Wenn das Steuerelement die Auswahl mehrerer, nicht zusammenhängender Textspannen unterstützt, empfängt die Ranges-Auflistung einen Textbereich für jede ausgewählte Spanne.
Wenn das Steuerelement nur eine einzelne Spanne markierten Texts enthält, empfängt die Ranges-Auflistung einen einzelnen Textbereich.
Wenn das Steuerelement eine Texteinfügemarke enthält, aber kein Text ausgewählt ist, empfängt die Ranges-Auflistung einen entarteten (leeren) Textbereich an der Position der Texteinfügemarke.
Wenn das Steuerelement keine Texteinfügemarke enthält oder die Textauswahl nicht unterstützt, werden Bereiche auf NULL festgelegt.
Verwenden Sie die IUIAutomationTextPattern::SupportedTextSelection-Eigenschaft , um zu testen, ob ein Steuerelement die Textauswahl unterstützt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | uiautomationclient.h (include UIAutomation.h) |
Weitere Informationen
Benutzeroberflächenautomatisierung Unterstützung für Textinhalte