Edit

Share via

Object Identifiers (Winuser.h)

  • Article

This topic describes the Microsoft Active Accessibility object identifiers, 32-bit values that identify categories of accessible objects within a window. Microsoft Active Accessibility servers and Microsoft UI Automation providers use the object identifiers to determine the object to which a WM_GETOBJECT message request refers.

Clients receive these values in their WinEventProc callback function and use them to identify parts of a window. Servers use these values to identify the corresponding parts of a window when calling NotifyWinEvent or when responding to the WM_GETOBJECT message.

Servers can define custom object IDs to identify other categories of objects within their applications. Custom object IDs must be assigned positive values because Microsoft Active Accessibility reserves zero and all negative values for the following standard object identifiers.

The following constants are defined in winuser.h:

Constant Description
OBJID_ALERT
 An alert that is associated with a window or an application. System provided message boxes are the only UI elements that send events with this object identifier. Server applications cannot use the AccessibleObjectFromX functions with this object identifier. This is a known issue with Microsoft Active Accessibility.
OBJID_CARET
 The text insertion bar (caret) in the window.
OBJID_CLIENT
 The window's client area. In most cases, the operating system controls the frame elements and the client object contains all elements that are controlled by the application. Servers only process the WM_GETOBJECT messages in which the lParam is OBJID_CLIENT, OBJID_WINDOW, or a custom object identifier.
OBJID_CURSOR
 The mouse pointer. There is only one mouse pointer in the system, and it is not a child of any window.
OBJID_HSCROLL
 The window's horizontal scroll bar.
OBJID_NATIVEOM
 In response to this object identifier, third-party applications can expose their own object model. Third-party applications can return any COM interface in response to this object identifier.
OBJID_MENU
 The window's menu bar.
OBJID_QUERYCLASSNAMEIDX
 An object identifier that Oleacc.dll uses internally. For more information, see Appendix F: Object Identifier Values for OBJID_QUERYCLASSNAMEIDX.
OBJID_SIZEGRIP
 The window's size grip: an optional frame component located at the lower-right corner of the window frame.
OBJID_SOUND
 A sound object. Sound objects do not have screen locations or children, but they do have name and state attributes. They are children of the application that is playing the sound.
OBJID_SYSMENU
 The window's system menu.
OBJID_TITLEBAR
 The window's title bar.
OBJID_VSCROLL
 The window's vertical scroll bar.
OBJID_WINDOW
 The window itself rather than a child object.

Requirements

Requirement Value
Header
Winuser.h (include Windows.h)