Please enable JavaScript to view this site.

A-Shell Consolidated Reference

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.