IRawElementProviderFragment::get_BoundingRectangle 메서드(uiautomationcore.h)

이 요소의 경계 사각형을 지정합니다.

이 속성은 읽기 전용입니다.

구문

HRESULT get_BoundingRectangle(
  UiaRect *pRetVal
);

매개 변수

pRetVal

반환 값

없음

설명

경계 사각형은 화면의 왼쪽 위 모서리 위치와 차원에 의해 정의됩니다.

요소가 부분적으로 가려지거나 부분적으로 화면 을 벗어난 경우에는 클리핑이 필요하지 않습니다. 직사각형이 실제로 표시되는지 여부를 나타내도록 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
헤더	uiautomationcore.h(UIAutomation.h 포함)

추가 정보

IRawElementProviderFragment