CreateStdAccessibleProxy function

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

Syntax


STDAPI CreateStdAccessibleProxy(
  _In_  HWND    hwnd,
  _In_  LPCTSTR pszClassName,
  _In_  LONG    idObject,
  _In_  REFIID  riidInterface,
  _Out_ void    **ppvObject
);

Parameters

hwnd [in]

Type: HWND

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

pszClassName [in]

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 [in]

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.

riidInterface [in]

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 [out]

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]

Redistributable

Active Accessibility 1.3 RDK on Windows NT 4.0 with SP6 and later and Windows 95

Header

Oleacc.h

Library

Oleacc.lib

DLL

Oleacc.dll

Unicode and ANSI names

CreateStdAccessibleProxyW (Unicode) and CreateStdAccessibleProxyA (ANSI)

See also

Appendix A: Supported User Interface Elements Reference
CreateStdAccessibleObject
IDispatch
Shortcuts for Exposing Custom User Interface Elements

 

 

Show: