OPTION bitmap buttons or icon button

CONTROL 4 - Icon Bitmap Button

1. Only an image without text;

2. An image with a text on the right side;

3. An image over a text field;

type:                      4

parent:                  panel

TAB file entry: 

opt,x,y,w,h,f,b,4,<text>:<action>
The text field allows to set the configuration to display (between single quotes) :

1. ONLY IMAGE : specifying only file name

‘ image.bmp‘ or ‘ image.ico‘

2. IMAGE AND TEXT ON THE RIGHT : specifying the file name before the text, separated by a special character #

‘ image.bmp#text‘ or ‘ image.ico#text ‘

3. IMAGE AND TEXT ON THE BOTTOM : specifying the file name before the text, separated by the special characters ##

‘ image.bmp##text‘ or ‘ image.ico##text ‘

The action is the command to take when selected.

values returned:
MN=panel number
BN=button number
ST=1 if set (True)
-1 if not set (False)

Button Notes

There is two  types of image that can be used for buttons in Windows that is the BMP bitmap format or Windows icon files. When designing a bitmap, there are two ways to proceed:

It is now also possible in V14 to use the icon format (*.ico) as the image for the button.  This means that it is necessary to set the file extension (*.bmp or *.ico) in the tab file to guide the  correct  format  selection,  but  if  no  extension  is  specified  the  bitmap  (.bmp)  is  the  default  format.  Eagle  will  automatically  select  the  appropriate  icon  format  (i.e  16x16,  32x32,  etc.) depending on the displayed button size.  from version 14.5 Vista multi image buttons are also supported in RIBBONs, Toolbars, etc..

See also

panel, options, UI Framework, Theme