BButton¶

Constructor and Destructor¶

BButton()

BButton::BButton(BRect frame, const char *name, const char *label, BMessage *message, uint32 resizingMode = B_FOLLOW_LEFT | B_FOLLOW_TOP, uint32 flags = B_WILL_DRAW | B_NAVIGABLE)
BButton::BButton(BMessage *archive)

Initializes the BButton by passing all arguments to the BControl constructor. BControl initializes the button’s label and assigns it a model message that identifies the action that should be carried out when the button is invoked.

The frame, name, resizingMode, and flags arguments are the same as those declared for the BView class and are passed up the inheritance hierarchy to the BView constructor without change.

When the button is attached to a window, it will be resized to its preferred height; the height of BButton’s frame rectangle will exactly accommodate the button border and label, given the BButton’s current font.

~BButton()

virtual BButton::~BButton()

Does nothing; a BButton has no data to free.

Hook Functions¶

AttachedToWindow()

virtual void BButton::AttachedToWindow()

Augments the BControl version of this function to tell the BWindow that the button is the default button, if MakeDefault() has already been called.

KeyDown()

virtual void BButton::KeyDown(const char *bytes, int32 numBytes)

Augments the inherited version of KeyDown() to respond to messages reporting that the user pressed the Enter key or the space bar. Its response is to:

Momentarily highlight the button and change its value.
Call Invoke() to deliver a copy of the model BMessage to the target receiver.

The BButton gets KeyDown() function calls when it’s the focus view for the active window (which results when the user navigates to it) and also when it’s the default button for the window and the character the user types is B_ENTER.

MakeDefault()

virtual void BButton::MakeDefault(bool flag)

MakeDefault() makes the BButton the default button for its window when flag is true, and removes that status when flag is false. The default button is the button the user can operate by striking the Enter key when the window is the active window.

A window can have only one default button at a time. Setting a new default button, therefore, may deprive another button of that status. When MakeDefault() is called with an argument of true, it generates a MakeDefault() call with an argument of false for previous default button. Both buttons are redisplayed so that the user can see which one is currently the default.

The default button can also be set by calling BWindow’s SetDefaultButton() function. That function makes sure that the button that’s forced to give up default status and the button that obtains it are both notified through MakeDefault() function calls.

MakeDefault() is therefore a hook function that can be augmented to take note each time the default status of the button changes. It’s called once for each change in status, no matter which function initiated the change.

MouseDown()

virtual void BButton::MouseDown(BPoint point)

Overrides the BView version of MouseDown() to track the cursor while the user holds the mouse button down. As the cursor moves in and out of the button, the BButton’s value is reset accordingly. The SetValue() virtual function is called to make the change each time.

If the cursor is inside the BButton’s bounds rectangle when the user releases the mouse button, this function posts a copy of the model message so that it will be dispatched to the target object.

Member Functions¶

Archive()

virtual BButton::Archive(BMessage *archive, bool deep = true) const

Stores the BButton in the BMessage archive.

See also: BArchivable::Archive(), Instantiate() static function

Draw()

virtual void BButton::Draw(BRect updateRect)

Draws the button and labels it. If the BButton’s value is anything but 0, the button is highlighted. If it’s disabled, it drawn in muted shades of gray. Otherwise, it’s drawn in its ordinary, enabled, unhighlighted state.

GetPreferredSize()

virtual void BButton::GetPreferredSize(float *width, float *height)

Calculates how big the button needs to be to display its label in the current font, and writes the results into the variables that the width and height arguments refer to. ResizeToPreferred(), defined in the BView class, resizes a view’s frame rectangle to the preferred size, keeping its left and top sides constant. A button is automatically resized to its preferred height (but not to its preferred width) by AttachedToWindow().

IsDefault()

bool BButton::IsDefault() const

IsDefault() returns whether the BButton is currently the default button.

SetLabel()

virtual void BButton::SetLabel(const char *string)

Overrides the BControl version of this function to make sure that calculations based on the width of the label won’t assume cached results for the previous label.

Static Functions¶

Instantiate()

static BArchivable *BButton::Instantiate(BMessage *archive)

Returns a new BButton object, allocated by new and created with the version of the constructor that takes a BMessage archive. However, if the archive message doesn’t contain data for a BButton object, this function returns NULL.

Archived Fields¶

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

Field	Type code	Description
_default	`B_BOOL_TYPE`	Exists and is true if the button is the default.