IAccessible::get_accSelection 메서드(oleacc.h)

아티클
03/05/2024

IAccessible::get_accSelection 메서드는 이 개체의 선택한 자식을 검색합니다. 선택을 지원하는 모든 개체는 이 속성을 지원해야 합니다.

구문

HRESULT get_accSelection(
  [out, retval] VARIANT *pvarChildren
);

매개 변수

[out, retval] pvarChildren

형식: VARIANT*

선택한 자식에 대한 정보를 수신하는 VARIANT 구조 체의 주소입니다. 다음 표에서는 pvarChildren에 반환된 정보를 설명합니다.

vt 멤버	값 멤버
VT_EMPTY	자식이 선택되지 않았습니다.
VT_DISPATCH	하나의 자식 개체가 선택되고 해당 IDispatch 인터페이스의 주소가 pdispVal 멤버에 설정됩니다.
VT_I4	lVal 에는 선택한 자식 요소의 자식 ID가 포함됩니다. lVal이 CHILDID_SELF 경우 이는 개체 자체가 선택되었음을 의미합니다.
VT_UNKNOWN	여러 자식 개체가 선택되고 punkVal 멤버에 IUnknown 인터페이스의 주소가 포함됩니다. 클라이언트는 선택한 개체를 열거하는 데 사용하는 IEnumVARIANT 인터페이스에 대해 이 인터페이스를 쿼리합니다.

반환 값

형식: HRESULT

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

성공하지 못하면 다음 테이블의 값 중 하나 또는 다른 표준 COM 오류 코드를 반환합니다. 서버는 이러한 값을 반환하지만 클라이언트는 항상 유효한 값을 포함하도록 출력 매개 변수를 검사 합니다. 자세한 내용은 IAccessible 반환 값 확인을 참조하세요.

오류	Description
DISP_E_MEMBERNOTFOUND	개체는 이 속성을 지원하지 않습니다.

설명

이 메서드는 IEnumVARIANT 인터페이스를 지원해야 합니다.

이 메서드는 pvarChildren 매개 변수에 대한 IDispatch 인터페이스 포인터 또는 자식 ID를 반환합니다. IDispatch 인터페이스 포인터 또는 자식 ID를 사용하는 방법에 대한 자세한 내용은 매개 변수에서 자식 ID를 사용하는 방법을 참조하세요.

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

참고: 이 메서드는 선택한 텍스트가 아닌 선택한 항목을 검색합니다.

서버 예제

다음 예제 코드는 사용자 지정 단일 선택 목록 상자에 대해 이 메서드를 구현할 수 있는 방법을 보여줍니다. 항목이 선택되지 않은 경우 GetSelectedIndex 메서드는 -1을 반환합니다.


// m_pControl is the control that returns this accessible object. 

HRESULT STDMETHODCALLTYPE AccServer::get_accSelection(VARIANT *pvarChildren)
{
    int childID = m_pControl->GetSelectedIndex() + 1; // Convert from 0-based. 
    if (childID <= 0)
    {
        pvarChildren->vt = VT_EMPTY;
    }
    else 
    {
        pvarChildren->vt = VT_I4;
        pvarChildren->lVal = childID;
    }
    return S_OK;
};

요구 사항

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