VM_SETMETRICS - Parameters

fMetric (USHORT)

Units of measurement.

Unit or units of measurement that are to be set for the value set control. This can be either of the following:

VMA_ITEMSIZE

If this message attribute is set, the width and height of each item is set using the values of the usItemWidth and usItemHeight parameters, respectively.
VMA_ITEMSPACING
If this message attribute is set, the horizontal and vertical spacing between each item is set using the values of the usHorzItemSpacing and usVertItemSpacing parameters, respectively.

ulItemId (ULONG)

Item information.

This value depends on the VMA_* attribute set for the message.

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

  usItemWidth (USHORT)

  Width to be set for each value set item, in pixels. The number of pixels specified cannot be less than 2.
  usItemHeight (USHORT)
  Height to be set for each value set item, in pixels. The number of pixels specified cannot be less than 2.
  
  If the VMA_ITEMSPACING attribute is specified, ulItemId field is as follows:

  usHorzItemSpacing (USHORT)

  Amount of horizontal space to be set between each value set item, in pixels. This number does not include the space needed for selected-state and target emphasis, and for the selection cursor, because the emphasis and cursor space is automatically set by the value set control. The default spacing is 0.
  usVertItemSpacing (USHORT)
  Amount of vertical space to be set between each value set item, in pixels. This number does not include the space needed for selected-state and target emphasis, and for the selection cursor, because the emphasis and cursor space is automatically set by the value set control. The default spacing is 0.

  rc (BOOL)

  Success indicator.

  TRUE

  Item size or spacing was successfully set.
  FALSE
  An error occurred. The WinGetLastError function may return the following errors:

  • PMERR_INVALID_PARAMETERS 
    PMERR_PARAMETER_OUT_OF_RANGE.

    ---

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