Метод IRawElementProviderFragment::get_BoundingRectangle (uiautomationcore.h)

Статья
03/03/2024

Задает ограничивающий прямоугольник данного элемента.

Это свойство доступно только для чтения.

Синтаксис

HRESULT get_BoundingRectangle(
  UiaRect *pRetVal
);

Параметры

pRetVal

Возвращаемое значение

None

Remarks

Ограничивающий прямоугольник определяется расположением левого верхнего угла экрана и размерами.

Обрезка не требуется, если элемент частично скрыт или частично вне экрана. Свойство IsOffscreen должно быть задано, чтобы указать, является ли прямоугольник фактически видимым.

Не все точки в ограничивающем прямоугольнике обязательно доступны для щелчка.

Примеры

В следующем примере реализация поставщиком элементов списка вычисляет ограничивающий прямоугольник для элемента на основе его высоты и положения в пределах содержащегося списка.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	uiautomationcore.h (включая UIAutomation.h)

См. также раздел

IRawElementProviderFragment

Поделиться через