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

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

Voir aussi

IRawElementProviderFragment