# Disabled and Hot Images

> [HTML Version](disabledandhotimages.htm)

_Added October 2013_

Note: These are the release notes that accompanied the introduction of new button attributes to improve rendering of disabled and hot images:

ImgDis=<rop>\{,<suffix>\}

ImgHot=<rop>\{,<suffix>\}

The _rop_ parameter (short for Rendering OPtion) determines the algorithm used when automatically rendering the button images in the disabled (gray) or hot (highlighted) states. Set _rop_ to 0, or omit the clause entirely, for the default effect applied by Windows, or set it to 1 for an alternate effect applied by A-Shell.

The optional suffix clause may be used to specify separate images for the disabled and/or hot version of each button. A-Shell will look for image files matching the base image, with the specified suffix. For example:

Img=clickme.png~ImgDis=0,\_d

In the above case, the file clickme.png will supply the normal image. A-Shell will look for clickme\_d.png for an alternate image to use when the button is in the disabled state. If the clickme\_d.png file is not present, the disabled version will use the same base image as the enabled version, with the standard Windows disabled/gray effect.

Note: _rop_ option 1 requires GDIPlus, which is activated automatically for 32 bpp images; see _toolbarattribute_ ImgSiz=w,h,bpp. Otherwise you must explicitly specify the MBF2\_GDIPLUS option in the AUI\_CONTROL ctype2 parameter when creating the toolbar.