please dont rip this site Prev Next

DRAWITEMSTRUCT info  Overview  Group

The DRAWITEMSTRUCT structure provides information the owner window must have to determine how to paint an owner-drawn control or menu item. The owner window of the owner-drawn control or menu item receives a pointer to this structure as the lParam parameter of the WM_DRAWITEM message.

typedef struct tagDRAWITEMSTRUCT {  // dis 

    UINT  CtlType; 

    UINT  CtlID; 

    UINT  itemID; 

    UINT  itemAction; 

    UINT  itemState; 

    HWND  hwndItem; 

    HDC   hDC; 

    RECT  rcItem; 

    DWORD itemData; 

} DRAWITEMSTRUCT; 

 

Members

CtlType
Specifies the control type. This member can be one of the following values:

Value

Meaning

ODT_BUTTON

Owner-drawn button

ODT_COMBOBOX

Owner-drawn combo box

ODT_LISTBOX

Owner-drawn list box

ODT_LISTVIEW

List view control

ODT_MENU

Owner-drawn menu item

ODT_STATIC

Owner-drawn static control

ODT_TAB

Tab control

CtlID
Specifies the identifier of the combo box, list box, button, or static control. This member is not used for a menu item.
itemID
Specifies the menu item identifier for a menu item or the index of the item in a list box or combo box. For an empty list box or combo box, this member can be -1. This allows the application to draw only the focus rectangle at the coordinates specified by the rcItem member even though there are no items in the control. This indicates to the user whether the list box or combo box has the focus. How the bits are set in the itemAction member determines whether the rectangle is to be drawn as though the list box or combo box has the focus.
itemAction
Specifies the drawing action required. This member can be one or more of the following values:

Value

Meaning

ODA_DRAWENTIRE

The entire control needs to be drawn.

ODA_FOCUS

The control has lost or gained the keyboard focus. The itemState member should be checked to determine whether the control has the focus.

ODA_SELECT

The selection status has changed. The itemState member should be checked to determine the new selection state.

itemState
Specifies the visual state of the item after the current drawing action takes place. This member can be a combination of the following values:

Value

Meaning

ODS_CHECKED

The menu item is to be checked. This bit is used only in a menu.

ODS_COMBOBOXEDIT

The drawing takes place in the selection field (edit control) of an ownerdrawn combo box.

ODS_DEFAULT

The item is the default item.

ODS_DISABLED

The item is to be drawn as disabled.

ODS_FOCUS

The item has the keyboard focus.

ODS_GRAYED

The item is to be grayed. This bit is used only in a menu.

ODS_SELECTED

The menu item’s status is selected.

hwndItem
Identifies the control for combo boxes, list boxes, buttons, and static controls. For menus, this member identifies the menu containing the item.
hDC
Identifies a device context; this device context must be used when performing drawing operations on the control.
rcItem
Specifies a rectangle that defines the boundaries of the control to be drawn. This rectangle is in the device context specified by the hDC member. Windows automatically clips anything the owner window draws in the device context for combo boxes, list boxes, and buttons, but does not clip menu items. When drawing menu items, the owner window must not draw outside the boundaries of the rectangle defined by the rcItem member.
itemData
Specifies the application-defined 32-bit value associated with the menu item. For a control, this parameter specifies the value last assigned to the list box or combo box by the LB_SETITEMDATA or CB_SETITEMDATA message. If the list box or combo box has the LBS_HASSTRINGS or CBS_HASSTRINGS style, this value is initially zero. Otherwise, this value is initially the value that was passed to the list box or combo box in the lParam parameter of one of the following messages:

CB_ADDSTRING
CB_INSERTSTRING
LB_ADDSTRING
LB_INSERTSTRING

If ctlType is ODT_BUTTON or ODT_STATIC, itemData is zero.

See Also

CB_ADDSTRING, CB_INSERTSTRING, CB_SETITEMDATA, LB_ADDSTRING, LB_INSERTSTRING, LB_SETITEMDATA, WM_DRAWITEM 


file: /Techref/os/win/api/win32/struc/src/str04_8.htm, 8KB, , updated: 2000/4/7 11:20, local time: 2024/11/8 05:45,
TOP NEW HELP FIND: 
18.226.172.230:LOG IN
©2024 PLEASE DON'T RIP! THIS SITE CLOSES OCT 28, 2024 SO LONG AND THANKS FOR ALL THE FISH!

 ©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?
Please DO link to this page! Digg it! / MAKE!

<A HREF="http://linistepper.com/Techref/os/win/api/win32/struc/src/str04_8.htm"> DRAWITEMSTRUCT</A>

After you find an appropriate page, you are invited to your to this massmind site! (posts will be visible only to you before review) Just type a nice message (short messages are blocked as spam) in the box and press the Post button. (HTML welcomed, but not the <A tag: Instead, use the link box to link to another page. A tutorial is available Members can login to post directly, become page editors, and be credited for their posts.


Link? Put it here: 
if you want a response, please enter your email address: 
Attn spammers: All posts are reviewed before being made visible to anyone other than the poster.
Did you find what you needed?