IRawElementProviderFragment::get_BoundingRectangle-Methode (uiautomationcore.h)

  • Artikel

Gibt das umgebende Rechteck dieses Elements an.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_BoundingRectangle(
  UiaRect *pRetVal
);

Parameter

pRetVal

Rückgabewert

Keine

Bemerkungen

Das umgebende Rechteck wird durch die Position der oberen linken Ecke auf dem Bildschirm und die Abmessungen definiert.

Wenn das Element teilweise verdeckt oder außerhalb des Bildschirms ist, ist kein Clipping erforderlich. Die IsOffscreen-Eigenschaft sollte festgelegt werden, um anzugeben, ob das Rechteck tatsächlich sichtbar ist.

Nicht alle Punkte innerhalb des umgebenden Rechtecks sind notwendigerweise klickbar.

Beispiele

Die folgende Beispielimplementierung durch einen Listenelementanbieter berechnet das begrenzungsbezogene Rechteck für das Element basierend auf seiner Höhe und Position im enthaltenden Listenfeld.

HRESULT STDMETHODCALLTYPE ListItemProvider::get_BoundingRectangle(UiaRect * pRetVal)
{
    if (pRetVal == NULL) return E_INVALIDARG;

    UiaRect parentRect;
    HRESULT hr = m_parentProvider->get_BoundingRectangle(&parentRect);
    pRetVal->left = parentRect.left;
    pRetVal->top = parentRect.top + (m_pParentControl->m_itemHeight * m_itemIndex);
    pRetVal->width = parentRect.width;
    pRetVal->height = m_pParentControl->m_itemHeight;
    return S_OK;
}

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 (uiAutomation.h einschließen)

Weitere Informationen

IRawElementProviderFragment