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

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 반환 값 확인을 참조하세요.

설명

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

개체의 기본 동작을 해당 값과 혼동하지 마세요. 자세한 내용은 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;
};

요구 사항

추가 정보

DefaultAction 속성

IAccessible

IAccessible::accDoDefaultAction

변형