usItemAttr (USHORT)

Item information.

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

• One of the following attributes can be set:

  VIA_BITMAP

  If this attribute is set, the item is a bit map. This is the default.
  VIA_COLORINDEX
  If this attribute is set, the item is an index into the logical color table.
  VIA_ICON
  If this attribute is set, the item is an icon.
  VIA_RGB
  If this attribute is set, the item is a color entry.
  VIA_TEXT
  If this attribute is set, the item is a text string.
  
  In addition, one or more of the following attributes can be set:

  VIA_DISABLED

  If this attribute is set, the item cannot be selected and is displayed with unavailable-state emphasis, if possible. Unavailable text items are always displayed with unavailable-state emphasis, according to CUA guidelines; for items displayed as color, bit maps, and icons, it is the application's responsibility to determine the best way to show that these items are unavailable, if possible.

  The selection cursor can be moved to an unavailable item by using either the keyboard navigation keys or a pointing device. This allows a user to press the F1 key to find out why that item cannot be selected.

  VIA_DRAGGABLE
  If this attribute is set, the item can be the source of a direct manipulation action.
  VIA_DROPONABLE
  If this attribute is set, the item can be the target of a direct manipulation action.
  VIA_OWNERDRAW
  If this attribute is set, a paint notification message is sent whenever this item needs painting.
  
  The following is returned if an error occurs:

  VMERR_INVALID_PARAMETERS

  The WinGetLastError function may return the following errors:

  • PMERR_INVALID_PARAMETERS
    
  • PMERR_PARAMETER_OUT_OF_RANGE.

  ---

  [Back] [Next]