VM QUERYITEMATTR

This message queries the attribute or attributes of the item indicated by the values of the usRow and usColumn fields.

Syntax

param1
    USHORT usRow;    /* Row index. */
    USHORT usColumn; /* Column index. */

param2
    ULONG  ulReserved; /* Reserved value, should be 0. */

Parameters

usRow (USHORT) - input

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) - input

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) - input

Reserved value, should be 0.

Returns

usItemAttr (USHORT) - returns

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.

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

Remarks

The application uses this message to query the specific attribute or attributes of a value set item.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it other than to return 0.