Value Set Control Styles

Value set control window styles are set when a value set window is created.

• Set one of the following styles when creating a value set control window. You can override these styles by specifying VIA_BITMAP, VIA_ICON, VIA_TEXT, VIA_RGB, or VIA_COLORINDEX attributes for individual value set items.

  VS_BITMAP

  The attribute for each value set item is set to the VIA_BITMAP value set item attribute, which means the value set treats each item as a bit map unless otherwise specified. This is the default. The following picture provides an example of a value set with bit maps.
  VS _ ICON
  TheattributeforeachvaluesetitemissettotheVIA _ ICONvaluesetitemattribute ,whichmeansthevaluesettreatseachitemasaniconunlessotherwisespecified .Thefollowingpictureprovidesanexampleofavaluesetwithicons .
  VS_TEXT
  The attribute for each value set item is set to the VIA_TEXT value set item attribute, which means the value set treats each item as a text string unless otherwise specified. The following picture provides an example of a value set with text strings.
  VS _ RGB
  TheattributeforeachvaluesetitemissettotheVIA _ RGBvaluesetitemattribute ,whichmeansthevaluesettreatseachitemasaRGBcolorvalueunlessotherwisespecified .Thisstyleismostoftenusedwhenyouneedtocreatenewcolors .ThepicturefollowingthedefinitionofVS _ COLORINDEXprovidesanexampleofavaluesetwithcolors .
  VS _ COLORINDEX
  TheattributeforeachvaluesetitemissettotheVIA _ COLORINDEXvaluesetitemattribute ,whichmeansthevaluesettreatseachitemasanindexintothelogicalcolortableunlessotherwisespecified .Thisstyleismostoftenusedwhenthecolorscurrentlyavailableareadequate .Thefollowingpictureprovidesanexampleofavaluesetwithcolors .
  
  Specify one or more of the following optional window styles, if desired, by using an OR operator (|) to combine them with the style specified from the preceding list:

  VS_BORDER

  The value set draws a thin border around itself to delineate the control. The following picture provides an example of a value set with a border.
  VS _ ITEMBORDER
  Thevaluesetdrawsathinborderaroundeachitemtodelineateitfromotheritems .

  Note: The VS_ITEMBORDER style is useful for items that are hard to see, such as faint colors or patterns. The following picture provides an example of a value set with item borders.

  VS _ RIGHTTOLEFT
  Thevaluesetinterpretscolumnorientationasright - to - left ,insteadofthedefaultleft - to - rightarrangement .Thismeanscolumnsarenumberedfromright - to - leftwiththerightmostcolumnbeing1andcountingupasyoumoveleft .Homeistherightmostcolumnandendistheleftmostcolumn .

  There is no visible difference between a value set ordered left-to-right and a value set ordered right-to-left. Therefore, if your application uses multiple value sets, the ordering of the items should be consistent in each value set to avoid confusing the user.

  Note: The VS_RIGHTTOLEFT style is used on creation of the control. Changing this style after creation causes unexpected results.

  VS_SCALEBITMAPS
  The value set automatically scales bit maps to the size of the cell. If this style is not used, each bit map is centered in its cell. Also, if the cell is smaller than the bit map, the bit map is clipped to the size of the cell.
  VS_OWNERDRAW
  The application is notified whenever the background of the value set window is to be painted.

  ---

  [Back: Value Set Control Window Processing]
  [Next: Value Set Control Data]