VM_SETITEM Field - ulItemId

ulItemId (ULONG)

Item information.

This value depends on the VIA_* attribute set for the item.

• If the VIA_TEXT attribute is specified, the ulItemId field is as follows:

  pszItem (PSZ)

  Pointer to a null terminated string containing the text to be placed in the item. If NULL is passed in, the item is blank.
  
  If the VIA_BITMAP attribute is specified, the ulItemId field is as follows:

  hbmItem (HBITMAP)

  Handle to a bit map that is to be drawn in the item indicated by the param1 parameter. If NULLHANDLE is passed in, the item will be blank.
  
  If the VIA_ICON attribute is specified, the ulItemId field is as follows:

  hptItem (HPOINTER)

  Handle to the icon that is to be drawn in the item indicated by the param1 parameter. If NULLHANDLE is passed in, the item is blank.
  
  If the VIA_RGB attribute is specified, the ulItemId field is as follows:

  rgbItem (ULONG)

  Color value to be drawn in the item indicated by the param1 parameter. If an invalid value is passed in (a value greater than 0x00FFFFFF), the item is blank. Each color value is a 4-byte integer with a value of:

  (R * 65536) + (G * 256) + B
  

  where:

  R

  Red intensity value
  G
  Green intensity value
  B
  Blue intensity value.
  
  If the VIA_COLORINDEX attribute is specified, the ulItemId field is as follows:

  ulColorIndex (ULONG)

  Index of the color in the logical color table to be drawn in the item indicated by the param1 parameter.

  ---

  [Back: VM_SETITEM Field - usColumn]
  [Next: VM_SETITEM Return Value - rc]