BPictureButton

Derived from: BControl > BView > BHandler > BArchivable

Declared in: be/interface/PictureButton.h

Library: libbe.so

Allocation: Constructor only

Summary

A BPictureButton draws a button that displays an image (a BPicture object) rather than a text label. A BPictureButton can be either a one-state or a two-state control:

• One-state. Acts like a normal BButton: The value is B_CONTROL_ON while the object is being pressed and B_CONTROL_OFF otherwise. The images for these two states should be different; by convention, the "on" image is a highlighted version of the "off" image. If the button can be disabled, it needs an additional "disabled" image.

• Two-state. Acts like a checkbox: Its value switches between B_CONTROL_ON and B_CONTROL_OFF every time the user presses (and releases) the button. If the button can be disabled, it needs two additional "disabled" images: One for disabled-while-on and the other for disabled-while-off.

Constructor and Destructor

BPictureButton()

Creates a new BPictureButton. The off and an on images correspond to the object's B_CONTROL_OFF and B_CONTROL_ON values; the behavior argument sets the object to be a one-state (B_ONE_STATE_BUTTON) or two-state (B_TWO_STATE_BUTTON) control, as explained in the class description. The other arguments are inherited from the BView and BControl constructors. The object's initial value is B_CONTROL_OFF.

If the BPictureButton can be disabled, it needs additional "disabled" images, as set through SetDisabledOff() and SetDisabledOn().

The BPictureButton copies all BPictures that are passed to it. It's the caller's responsibility to free the BPicture objects that are passed as arguments.

~BPictureButton()

Deletes the object and its data.

Static Functions

Instantiate() see BArchivable::Instantiate()

Member Functions

31106: head1: \xa5 Archived Fields

Archive(), see

Behavior() see SetBehavior()

DisabledOff(), DisabledOn(), EnabledOff(), EnabledOn() see SetEnabledOff()

Draw() (implementation detail) see BView::Draw()

KeyDown() (implementation detail) see BControl::KeyDown()

BControl::MouseDown()

SetBehavior(), Behavior()

These functions set and return whether the BPictureButton is a one-state (B_ONE_STATE_BUTTON) or a two-state (B_TWO_STATE_BUTTON) control. A one-state object acts like a normal button: It's on while the user is pressing it, and off otherwise. A two-state object switches to the opposite state each time the user presses and release the button.

SetEnabledOff(), SetEnabledOn(), SetDisabledOff(), SetDisabledOn(), EnabledOff(), EnabledOn(), DisabledOff(), DisabledOn

These pairs of functions set and return one of the four images the BPictureButton displays: enabled-and-on, enabled-and-off, disabled-and-on, and disabled-and-off, respectively. If this is a one-state object, the disabled-and-on image needn't be set since a disabled one-state control can never be on.

The BPicture-retrieving functions return NULL if the requested image hasn't been set.

The BPictureButton copies all BPictures that are passed to it. It's the caller's responsibility to free the BPicture objects that are passed as arguments.

Archived Fields

The Archive() function adds the following fields to its BMessage argument:

See also: BArchivable::Archive()