ITextRangeProvider::GetBoundingRectangles-Methode (uiautomationcore.h)

Ruft für jede vollständig oder teilweise sichtbare Textzeile in einem Textbereich eine Auflistung von umgebenden Rechtecken ab.

Syntax

HRESULT GetBoundingRectangles(
  [out, retval] SAFEARRAY **pRetVal
);

Parameter

[out, retval] pRetVal

Typ: SAFEARRAY**

Empfängt einen Zeiger auf eine der folgenden Punkte.

  • Ein Array von umgebenden Rechtecken für jede vollständige oder unvollständige Textzeile in einem Textbereich.
  • Ein leeres Array für einen degenerierten Bereich.
  • Ein leeres Array für einen Textbereich mit Bildschirmkoordinaten, die vollständig außerhalb des Bildschirms liegen, sich durch einen Bildlauf außerhalb des sichtbaren Bereichs befinden oder von einem überlappenden Fenster verdeckt werden.
Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile uiautomationcore.h (include UIAutomation.h)

Weitere Informationen

Bewährte Methoden für die Verwendung sicherer Arrays

Konzept

ITextProvider

ITextRangeProvider

Referenz

Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter