WM_DRAWITEM

This message is sent to the owner window of an owner-drawn button or menu when a visual aspect of the button or menu has changed.

At a Glance

Header file: Winuser.h
Windows CE versions: 1.0 and later

Syntax

WM_DRAWITEM idCtl = (UINT) wParam;
lpdis = (LPDRAWITEMSTRUCT) lParam;

Parameters

idCtl

Identifier of the control that sent the WM_DRAWITEM message. If the message was sent by a menu, this parameter is zero.

lpdis

Long pointer to a DRAWITEMSTRUCT structure containing information about the item to be drawn and the type of drawing required.

Return Values

An application should return TRUE if it processes this message.

Default Action

The DefWindowProc function draws the focus rectangle for an owner-drawn list box item.

Remarks

In the case of a menu item, the receiver of this message is responsible for erasing the background if necessary.

In Windows CE version 2.0, the hDC member of the DRAWITEMSTRUCT structure pointed to by the lParam is initialized to the grayed or highlighted status of the current item.

The itemAction member of the DRAWITEMSTRUCT structure specifies the drawing operation that an application should perform.

Before returning from processing this message, an application should ensure that the device context identified by the hDC member of the DRAWITEMSTRUCT structure is in the default state.

See Also

DRAWITEMSTRUCT