Export (0) Print
Expand All

CreateStdAccessibleObject function

Creates an accessible object with the methods and properties of the specified type of system-provided user interface element.

Syntax


STDAPI CreateStdAccessibleObject(
  _In_  HWND   hwnd,
  _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.

idObject [in]

Type: LONG

Object ID. This value is usually OBJID_CLIENT, but it may be another object identifier.

riidInterface [in]

Type: REFIID

Reference identifier of the requested interface. 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 UI object that is similar to a system-provided object. Server developers can call CreateStdAccessibleObject to override the IAccessible methods and properties as required to match their custom objects. Alternatively, server developers can use Dynamic Annotation to override specific properties without having to use difficult subclassing techniques that CreateStdAccessibleObject requires. Server developers should still use CreateStdAccessibleObject 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 CreateStdAccessibleProxy, except that CreateStdAccessibleProxy allows you to specify the class name as a parameter whereas CreateStdAccessibleObject uses the class name associated with the hwnd parameter.

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

See also

IDispatch
CreateStdAccessibleProxy
Shortcuts for Exposing Custom User Interface Elements

 

 

Community Additions

ADD
Show:
© 2015 Microsoft