VM_SETITEMATTR - Parameters

usRow (USHORT)

Row index.

Row index of the value set item for which attributes are being specified. Rows have a value from 1 to the value of the usRowCount field. This value, which is the total number of rows in the value set, is specified in the VSCDATA data structure when the value set control is created.

usColumn (USHORT)

Column index.

Column index of the value set item for which attributes are being specified. Columns have a value from 1 to the value of the usColumnCount field. This value, which is the total number of columns in the value set, is specified in the VSCDATA data structure when the value set control is created.

usItemAttr (USHORT)

Item attributes.

Attribute or attributes of the item to be set or reset based on the value of the fSet field. These attributes can be as follows:

• 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.

  fSet (USHORT)

  Set or reset flag.

  TRUE

  Set the attribute of the indicated item.
  FALSE
  Turn off the attribute of the indicated item.

  rc (BOOL)

  Success indicator.

  TRUE

  Attribute or attributes were set successfully.
  FALSE
  An error occurred. The WinGetLastError function may return the following errors:
  
  PMERR_INVALID_PARAMETERS
  
  PMERR_PARAMETER_OUT_OF_RANGE.

  ---

  [Back: VM_SETITEMATTR Return Value - rc]
  [Next: VM_SETITEMATTR - Syntax]