Member variable XbpToolBarButton():hotImage Foundation

The buttons in a XbpToolBar object can optionally display an alternate image when the user positions the mouse pointer over them. Normally, the system draws a frame around the tool button currently under the mouse pointer. However, the "hot" image displayed by a tool bar button can be changed through the <xHotImage> parameter to XbpToolBar:addItem(). To do this, the application assigns an instance of the XbpBitmap or XbpIcon classes. The object can be used to load images both from the application's resource as well as from disk. Alternatively, the :hotImage instance variable may be used to change the "hot" image after a tool bar button has been added to an XbpToolBar instance.

Note that changing an existing tool bar button's "hot" image is an expensive operation. Therefore, we recommend to use method XbpToolBar:addItem() to define a tool bar button's images.