CreateStdAccessibleProxyW function

Creates an accessible object that has the properties and methods of the specified class of system-provided user interface element.

Syntax

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

Parameters

hwnd

Type: HWND

Window handle of the system-provided user interface element (a control) for which an accessible object is created.

pClassName

Type: LPCTSTR

Pointer to a null-terminated string of the class name of a system-provided user interface element for which an accessible object is created. The window class name is one of the common controls (defined in Comctl32.dll), predefined controls (defined in User32.dll), or window elements.

idObject

Type: LONG

Object ID. This value is usually OBJID_CLIENT, which is one of the object identifier constants, but it may be another object identifier.

riid

Type: REFIID

Reference identifier of the interface requested. This value is one of the following: IID_IAccessible, IID_IDispatch, IID_IEnumVARIANT, or IID_IUnknown.

ppvObject

Type: void**

Address of a pointer variable that receives the address of the specified interface.

Return Value

Type: STDAPI

If successful, returns S_OK.

If not successful, returns a standard COM error code.

Remarks

Server applications call this function when they contain a custom control that is similar to a system-provided control. Server applications can call CreateStdAccessibleProxy to override the IAccessible methods and properties as required to match their custom controls. Alternatively, server developers can use Dynamic Annotation to override specific properties without having to use difficult subclassing techniques that were required with CreateStdAccessibleProxy. Server developers should still use CreateStdAccessibleProxy for structural changes, such as hiding a child element or creating a placeholder child element. This approach saves server developers the work of fully implementing all of the IAccessible properties and methods.

This function is similar to CreateStdAccessibleObject, except that CreateStdAccessibleObject always uses the class name associated with the hwnd whereas CreateStdAccessibleProxy allows you to specify the class name as a parameter.

Use CreateStdAccessibleProxy to create an accessible object for a user interface element that is superclassed. When a user interface element is superclassed, an application creates a custom control with a window class name different from the predefined control on which it is based. Because the class name associated with the hwnd parameter is the superclass window class name, specify the base class name (the system class name on which the superclassed control is based) in pszClassName.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header oleacc.h
Library Oleacc.lib
DLL Oleacc.dll
Redistributable Active Accessibility 1.3 RDK on Windows NT 4.0 with SP6 and later and Windows 95

See Also

Appendix A: Supported User Interface Elements Reference

CreateStdAccessibleObject

IDispatch

Shortcuts for Exposing Custom User Interface Elements