Owner-Drawn Menus and the WM_DRAWITEM Message
Whenever the item must be drawn (for example, when it is first displayed or
when the user selects it), Windows sends the WM_DRAWITEM
message to the window procedure of the menu's owner window. This message
contains a pointer to a DRAWITEMSTRUCT
structure, which contains information about the item, including the item data
that an application may have assigned to it. In addition, DRAWITEMSTRUCT
contains flags that indicate the state of the item (such as whether it is
grayed or checked) as well as a bounding rectangle and a device context that the
application uses to draw the item.
An application must do the following while processing the WM_DRAWITEM message:
- Determine the type of drawing that is necessary. To do so, check the itemAction member of the DRAWITEMSTRUCT structure.
- Draw the menu item appropriately, using the bounding rectangle and device
context obtained from the DRAWITEMSTRUCT structure. The application must draw only within the bounding rectangle. For
performance reasons, Windows does not clip portions of the image that are drawn
outside the rectangle.
- Restore all GDI objects selected for the menu item's device context.
If the user selects the menu item, Windows sets the itemAction
member of the DRAWITEMSTRUCT
structure to the ODA_SELECT value and sets the ODS_SELECTED value in the itemState
member. This is an application's cue to redraw the menu item to indicate that
it is selected.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages
- Databases for Amazon shops developers
Amazon Categories Database
Browse Nodes Database