VM_QUERYITEMATTR - Parameters

usRow (USHORT)

Row index.

Row index of the item for which the attribute or attributes are queried. 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 item for which the attribute or attributes are queried. 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.

ulReserved (ULONG)

Reserved value, should be 0.

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: VM_QUERYITEMATTR Return Value - usItemAttr]
    [Next: VM_QUERYITEMATTR - Syntax]