WM_DRAWITEM (in Container Controls) - Parameters

id (USHORT)

Container control ID.

pOwnerItem (POWNERITEM)

Pointer to an OWNERITEM data structure.

The following list defines the OWNERITEM data structure fields as they apply to the container control. See OWNERITEM for the default field values.

hwnd (HWND)

Handle of the window in which ownerdraw will occur. The following is a list of the window handles that can be specified for ownerdraw:

• The container window handle of the icon, name, text, and tree views 
  The container title window handle
  
  The left or right window handles of the details view
  
  The left or right column heading windows of the details view.
  hps (HPS)
  Handle of the presentation space of the container window. For the details view that uses a split bar, the presentation space handle is either for the left or right window, depending upon the position of the column. If the details view does not have a split bar, the presentation space handle is for the left window.
  fsState (ULONG)
  Specifies emphasis flags. This state is not used by the container control because the application is responsible for drawing the emphasis states during ownerdraw.
  fsAttribute (ULONG)
  Attributes of the record as given in the flRecordAttr field in the RECORDCORE data structure.

  Note: If the CCS_MINIRECORDCORE style bit is specified when a container is created, then MINIRECORDCORE should be used instead of RECORDCORE and PMINIRECORDCORE should be used instead of PRECORDCORE in all applicable data structures and messages.

  fsStateOld (ULONG)
  Previous emphasis. This state is not used by the container control because the application is responsible for drawing the emphasis states during ownerdraw.
  fsAttributeOld (ULONG)
  Previous attribute. This state is not used by the container control because the application is responsible for drawing the emphasis states during ownerdraw.
  rclItem (RECTL)
  This is the bounding rectangle into which the container item is drawn.

  If the container item is an icon/text or bit-map/text pair, two WM_DRAWITEM messages are sent to the application. The first WM_DRAWITEM message contains the rectangle bounding the icon or bit map and the second contains the rectangle bounding the text.

  If the container item contains only text, or only an icon or bit map, only one WM_DRAWITEM message is sent. However, if the current view is the tree icon or tree text view and if the item is a parent item, the application will receive an additional WM_DRAWITEM (in Container Controls) message. The additional message is for the icon or bit map that indicates whether the parent item is expanded or collapsed.

  If the current view is the details view and the CFA_OWNER attribute is set, the rectangle's size is equal to the width of the column and the height of the tallest field in the container item. CFA_OWNER is an attribute of the FIELDINFO data structure's flData field.

  idItem (ULONG)
  Identifies the item being drawn. It can be one of the following:

  • CMA_CNRTITLE 
    CMA_ICON
    
    CMA_TEXT
    
    CMA_TREEICON.
    This field is not used for the details view and is set to 0.
  hItem (CNRDRAWITEMINFO)
  Pointer to a CNRDRAWITEMINFO structure.

  rc (BOOL)

  Item-drawn indicator.

  TRUE

  The owner draws the item, and so the container control does not draw it.
  FALSE
  If the owner does not draw the item, the owner returns this value and the container control draws the item.

  ---

  [Back: WM_DRAWITEM (in Container Controls) Return Value - rc]
  [Next: WM_DRAWITEM (in Container Controls) - Syntax]