Member variable XbpToolBarButton():image Foundation

Specifies the image displayed by a tool bar button.

Attribute: EXPORTED
Data type: Object (NIL)

The image displayed by a tool bar button can be specified using the <xImage> parameter to XbpToolBar:addItem(). Alternatively, a button's :image instance variable may be used to change its image after it has already been added to a XbpToolBar instance.

In order to define the image to be displayed by a given tool button object, an 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.

Changing an existing tool bar button's image is an expensive operation. Therefore, it is recommended to define a tool bar button's images when adding the button to the tool bar object. See method XbpToolBar:addItem() for further information.


If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.