Compartilhar via

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

  • Artigo

Especifica o retângulo delimitador desse elemento.

Esta propriedade é somente para leitura.

Sintaxe

HRESULT get_BoundingRectangle(
  UiaRect *pRetVal
);

Parâmetros

pRetVal

Valor retornado

Nenhum

Comentários

O retângulo delimitador é definido pelo local do canto superior esquerdo na tela e pelas dimensões.

Nenhum recorte será necessário se o elemento estiver parcialmente obscurecido ou parcialmente fora da tela. A propriedade IsOffscreen deve ser definida para indicar se o retângulo está realmente visível.

Nem todos os pontos dentro do retângulo delimitador são necessariamente clicáveis.

Exemplos

A implementação de exemplo a seguir por um provedor de itens de lista calcula o retângulo delimitador para o item com base em sua altura e posição dentro da caixa de listagem que contém.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho uiautomationcore.h (inclua UIAutomation.h)

Confira também

Irawelementproviderfragment