Méthode IRawElementProviderFragment ::get_BoundingRectangle (uiautomationcore.h)

Article
03/06/2024

Spécifie le rectangle englobant de cet élément.

Cette propriété est en lecture seule.

Syntaxe

HRESULT get_BoundingRectangle(
  UiaRect *pRetVal
);

Paramètres

pRetVal

Valeur de retour

None

Remarques

Le rectangle englobant est défini par l’emplacement du coin supérieur gauche à l’écran et les dimensions.

Aucun découpage n’est nécessaire si l’élément est partiellement masqué ou partiellement hors écran. La propriété IsOffscreen doit être définie pour indiquer si le rectangle est réellement visible.

Tous les points du rectangle englobant ne sont pas nécessairement cliquables.

Exemples

L’exemple d’implémentation suivant par un fournisseur d’éléments de liste calcule le rectangle englobant de l’élément en fonction de sa hauteur et de sa position dans la zone de liste contenante.

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;
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	uiautomationcore.h (incluez UIAutomation.h)

Voir aussi

IRawElementProviderFragment

Share via