IRawElementProviderFragment::get_BoundingRectangle-Methode (uiautomationcore.h)
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) |