Share via

Metodo IRawElementProviderFragment::get_BoundingRectangle (uiautomationcore.h)

  • Articolo

Specifica il rettangolo di associazione di questo elemento.

Questa proprietà è di sola lettura.

Sintassi

HRESULT get_BoundingRectangle(
  UiaRect *pRetVal
);

Parametri

pRetVal

Valore restituito

nessuno

Osservazioni

Il rettangolo di selezione è definito dalla posizione dell'angolo superiore sinistro sullo schermo e dalle dimensioni.

Nessun ritaglio è necessario se l'elemento è parzialmente oscurato o parzialmente fuori schermo. La proprietà IsOffscreen deve essere impostata per indicare se il rettangolo è effettivamente visibile.

Non tutti i punti all'interno del rettangolo di selezione sono necessariamente cliccabili.

Esempio

L'implementazione di esempio seguente da parte di un provider di elementi di elenco calcola il rettangolo di selezione per l'elemento in base all'altezza e alla posizione all'interno della casella di riepilogo contenente.

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

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione uiautomationcore.h (includere UIAutomation.h)

Vedi anche

IRawElementProviderFragment