다음을 통해 공유

CreateStdAccessibleProxyW 함수(oleacc.h)

  • 아티클

시스템에서 제공하는 사용자 인터페이스 요소의 지정된 클래스의 속성과 메서드가 있는 액세스 가능한 개체를 만듭니다.

구문

HRESULT CreateStdAccessibleProxyW(
  [in]  HWND    hwnd,
  [in]  LPCWSTR pClassName,
  [in]  LONG    idObject,
  [in]  REFIID  riid,
  [out] void    **ppvObject
);

매개 변수

[in] hwnd

형식: HWND

액세스 가능한 개체가 만들어지는 시스템 제공 사용자 인터페이스 요소(컨트롤)의 창 핸들입니다.

[in] pClassName

형식: LPCTSTR

액세스 가능한 개체가 만들어지는 시스템 제공 사용자 인터페이스 요소의 클래스 이름의 null로 끝나는 문자열에 대한 포인터입니다. 창 클래스 이름은 일반적인 컨트롤(Comctl32.dll 정의), 미리 정의된 컨트롤(User32.dll 정의됨) 또는 창 요소 중 하나입니다.

[in] idObject

형식: LONG

개체 ID입니다. 이 값은 일반적으로 개체 식별자 상수 중 하나인 OBJID_CLIENT 다른 개체 식별자일 수 있습니다.

[in] riid

형식: REFIID

요청된 인터페이스의 참조 식별자입니다. 이 값은 IID_IAccessible, IID_IDispatch, IID_IEnumVARIANT 또는 IID_IUnknown 중 하나입니다.

[out] ppvObject

형식: void**

지정된 인터페이스의 주소를 수신하는 포인터 변수의 주소입니다.

반환 값

형식: STDAPI

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

성공하지 못하면 표준 COM 오류 코드를 반환합니다.

설명

서버 애플리케이션은 시스템 제공 컨트롤과 유사한 사용자 지정 컨트롤을 포함하는 경우 이 함수를 호출합니다. 서버 애플리케이션은 CreateStdAccessibleProxy 를 호출하여 사용자 지정 컨트롤과 일치하는 데 필요한 IAccessible 메서드 및 속성을 재정의할 수 있습니다. 또는 서버 개발자는 동적 주석을 사용하여 CreateStdAccessibleProxy에 필요한 어려운 서브클래싱 기술을 사용하지 않고 특정 속성을 재정의할 수 있습니다. 서버 개발자는 자식 요소를 숨기거나 자리 표시자 자식 요소를 만드는 등의 구조적 변경에 CreateStdAccessibleProxy 를 계속 사용해야 합니다. 이 방법은 서버 개발자가 모든 IAccessible 속성 및 메서드를 완전히 구현하는 작업을 저장합니다.

이 함수는 CreateStdAccessibleObject와 유사하지만 CreateStdAccessibleObject 는 항상 hwnd 와 연결된 클래스 이름을 사용하는 반면 CreateStdAccessibleProxy 를 사용하면 클래스 이름을 매개 변수로 지정할 수 있습니다.

CreateStdAccessibleProxy를 사용하여 슈퍼클래싱되는 사용자 인터페이스 요소에 대한 액세스 가능한 개체를 만듭니다. 사용자 인터페이스 요소가 슈퍼클래스되는 경우 애플리케이션은 창 클래스 이름을 기반으로 하는 미리 정의된 컨트롤과 다른 사용자 지정 컨트롤을 만듭니다. hwnd 매개 변수와 연결된 클래스 이름은 superclass 창 클래스 이름이기 때문에 pszClassName에서 기본 클래스 이름(슈퍼 클래스 컨트롤의 기반이 되는 시스템 클래스 이름)을 지정합니다.

참고

oleacc.h 헤더는 CREATEStdAccessibleProxy를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

부록 A: 지원되는 사용자 인터페이스 요소 참조

CreateStdAccessibleObject

IDispatch

사용자 지정 사용자 인터페이스 요소를 노출하기 위한 바로 가기