Partager via


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

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