AccessibleObjectFromPoint 함수(oleacc.h)

아티클
08/25/2023

화면의 지정된 지점에 표시되는 개체에 대한 IAccessible 인터페이스 포인터의 주소를 검색합니다.

구문

HRESULT AccessibleObjectFromPoint(
  [in]  POINT       ptScreen,
  [out] IAccessible **ppacc,
  [out] VARIANT     *pvarChild
);

매개 변수

[in] ptScreen

실제 화면 좌표에서 검사되는 점을 지정합니다.

[out] ppacc

개체의 IAccessible 인터페이스 주소를 수신하는 포인터 변수의 주소입니다.

[out] pvarChild

ppacc에서 반환되는 IAccessible 인터페이스 포인터가 지정된 지점에 표시되는 개체에 속하는지 또는 지정된 지점에 있는 요소의 부모에 속하는지 여부를 지정하는 VARIANT 구조체의 주소입니다. VARIANT의 vt 멤버는 항상 VT_I4. lVal 멤버가 CHILDID_SELF 경우 ppacc의 IAccessible 인터페이스 포인터는 해당 지점의 개체에 속합니다. lVal 멤버가 CHILDID_SELF 않으면 ppacc는 자식 요소의 부모 개체에 대한 IAccessible 인터페이스의 주소입니다. 클라이언트는 검색된 VARIANT 매개 변수에서 VariantClear를 호출해야 합니다.

반환 값

성공하면 S_OK를 반환합니다.

성공하지 못하면 다음 또는 다른 표준 COM 오류 코드 중 하나를 반환합니다.

반환 코드	설명
E_INVALIDARG	인수가 잘못된 경우.

설명

이 함수는 지정된 지점에서 개체 계층 구조에서 액세스 가능한 가장 낮은 수준의 개체를 검색합니다. 지점의 요소가 액세스 가능한 개체가 아니면(즉, IAccessible을 지원하지 않음) 함수는 부모 개체의 IAccessible 인터페이스를 검색합니다. 부모 개체는 IAccessible 인터페이스를 통해 자식 요소에 대한 정보를 제공해야 합니다. IAccessible::accHitTest를 호출하여 지정된 화면 좌표에서 자식 요소를 식별합니다.

다른 IAccessible 메서드 및 함수와 마찬가지로 클라이언트는 사용자 작업으로 인해 IAccessible 인터페이스 포인터에 대한 오류를 수신할 수 있습니다. 자세한 내용은 IAccessible 인터페이스 포인터에 대한 오류 수신을 참조하세요.

클라이언트 예제

다음 예제 함수는 화면의 지정된 지점에서 항목을 선택합니다. 단일 선택이 원한다고 가정합니다.


HRESULT SelectItemAtPoint(POINT point)
{
    VARIANT varItem;
    IAccessible* pAcc;
    HRESULT hr = AccessibleObjectFromPoint(point, &pAcc, &varItem);
    if ((hr == S_OK))
    {
        hr = pAcc->accSelect((SELFLAG_TAKEFOCUS | SELFLAG_TAKESELECTION), varItem);
        VariantClear(&varItem);
        pAcc->Release();
    }
    return hr;
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	oleacc.h
라이브러리	Oleacc.lib
DLL	Oleacc.dll
재배포 가능 파일	SP6 이상 및 Windows 95를 Windows NT 4.0의 활성 접근성 1.3 RDK