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

아티클
08/25/2023

IAccessible::get_accDefaultAction 메서드는 개체의 기본 동작을 나타내는 문자열을 검색합니다. 모든 개체마다 기본 작업이 있는 것은 아닙니다.

구문

HRESULT get_accDefaultAction(
  [in]          VARIANT varChild,
  [out, retval] BSTR    *pszDefaultAction
);

매개 변수

[in] varChild

형식: VARIANT

개체 또는 개체의 자식 요소 중 하나에서 검색된 기본 작업을 수행할지 여부를 지정합니다. 이 매개 변수는 CHILDID_SELF(개체에 대한 정보를 가져오기 위해) 또는 자식 ID(개체의 자식 요소에 대한 정보를 얻기 위해)입니다. VARIANT 구조를 초기화하는 방법에 대한 자세한 내용은 매개 변수에서 자식 ID를 사용하는 방법을 참조하세요.

[out, retval] pszDefaultAction

형식: BSTR*

지정된 개체의 기본 동작을 설명하는 지역화된 문자열을 수신하는 BSTR 의 주소입니다. 이 개체에 기본 동작이 없으면 값은 NULL입니다.

반환 값

형식: HRESULT

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

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

Error	설명
S_FALSE	지정된 개체에 기본 동작이 없습니다.
E_INVALIDARG	인수가 잘못된 경우.
DISP_E_MEMBERNOTFOUND	지정한 개체는 이 속성을 지원하지 않습니다.

설명

검색된 문자열은 개체가 결과적으로 수행하는 작업이 아니라 개체에서 수행되는 작업을 설명합니다. 예를 들어 문서를 인쇄하는 도구 모음 단추의 기본 동작은 "현재 문서 인쇄"가 아니라 "누르기"입니다.

개체의 기본 동작을 해당 값과 혼동하지 마세요. 자세한 내용은 DefaultAction 속성을 참조하세요.

작업을 수행하는 컨트롤만 이 메서드를 지원합니다.

서버 개발자에게 참고: 이 속성에서 반환된 문자열을 지역화합니다.

서버 예제

다음 예제 코드는 사용자 지정 목록 상자에 대해 이 메서드를 구현할 수 있는 방법을 보여줍니다. 간단히 하기 위해 문자열은 지역화되지 않습니다.


HRESULT STDMETHODCALLTYPE AccServer::get_accDefaultAction( 
    VARIANT varChild,
    BSTR *pszDefaultAction)
{
    if (varChild.vt != VT_I4)
    {
        *pszDefaultAction = NULL;
        return E_INVALIDARG;
    }
    if (varChild.lVal == CHILDID_SELF)
    {
        *pszDefaultAction = SysAllocString(L"None.");
    }
    else
    {
        *pszDefaultAction = SysAllocString(L"Double-click");
    }
    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