View class for standard push buttons. More...

Inheritance diagram for MButtonView:

Collaboration diagram for MButtonView:

Public Member Functions
	MButtonView (MButton *controller)
virtual	~MButtonView ()
Protected Member Functions
virtual void	drawIcon (QPainter *painter, const QRectF &iconRect) const

Detailed Description

View class for standard push buttons.

Overview

MButtonView is used to visualize push buttons and toggle buttons. The view draws a fixed background and an icon, text or both on top of it. If the view is for a checkable button, it uses a different background and different text color for the checked state.

The outlook of button can be changed using the styling attributes defined in MButtonStyle and MWidgetStyle. MWidgetStyle::backgroundImage, MWidgetStyle::backgroundColor and MWidgetStyle::backgroundOpacity can be used to change appearance of the button itself. If background image is not defined then the background is drawn with solid color. The icon and text position and outlook can be changed through MButtonStyle. Following rules apply:

Only text is visible.
- Text can be freely positioned using MButtonStyle::verticalTextAlign, MButtonStyle::horizontalTextAlign, MButtonStyle::textMarginLeft, MButtonStyle::textMarginRight, MButtonStyle::textMarginTop and MButtonStyle::textMarginBottom attributes.
Only icon is visible.
- Icon can be freely positioned using MButtonStyle::iconSize and MButtonStyle::iconAlign attributes.
Text and icon are both visible.
- Space taken by the icon is calculated first and then the rest of available space is used for the text. The space taken by the text is adjustable with text margin attributes.
- If icon is aligned to left, then the text goes to right or if icon is aligned to top then the text goes automatically below that.

A button can be in one of the following functional states:

Enabled: default state. Button can be tapped to perform an action.
Disabled: tapping the button doesn't perform any action.
- Disabled state is not indicated in any specific way, button is shown normally (i.e. no dimming etc.)

Interactions

The Push Button does not support long press functionality, so it makes no difference how long the button is held down. If user presses a button and drags while it is in a pannable area, then button follows the finger and tactile feedback is cancel. When releasing the finger after panning, the button interaction is not activated.

Press down: Highlights the button.
Tap (button down + button up): Performs an action defined by application.
Tap down and drag finger out of the button and release finger: Cancels the button press.
Tap down and drag finger to scroll UI: Cancels the button press.

Open issues

There should be a informative banner telling why the button is disabled, unless the reason is very self evident.
The Button labels should follow the truncation rules of the Label widget.

See also:: MButton MButtonView MButtonStyle

Definition at line 105 of file views/mbuttonview.h.

Constructor & Destructor Documentation

MButtonView::MButtonView ( MButton * controller )

Constructs the view.

Parameters:

Pointer

to the controller.

Definition at line 369 of file mbuttonview.cpp.

                                            :
    MWidgetView(* new MButtonViewPrivate, controller)
{
    Q_D(MButtonView);
    d->label = new MLabel(controller);
    d->label->setParentItem(controller);
    d->label->setTextElide(true);
    d->label->setObjectName("ButtonLabel");
    d->label->setMinimumSize(0,0);

    d->styleModeChangeTimer = new QTimer(this);
    d->styleModeChangeTimer->setSingleShot(true);
    connect(d->styleModeChangeTimer, SIGNAL(timeout()), SLOT(_q_applyQueuedStyleModeChange()));
}

Here is the call graph for this function:

MButtonView::~MButtonView ( ) [virtual]

Destructs the view.

Definition at line 399 of file mbuttonview.cpp.

{
    Q_D(MButtonView);
    if (d->label) {
        delete d->label;
        d->label = 0;
    }
}

Member Function Documentation

void MButtonView::drawIcon	(	QPainter *	painter,
		const QRectF &	iconRect
	)			const `[protected, virtual]`

Draws the button icon (toggled or normal depending on the state of the button) into the given iconRect.

Definition at line 427 of file mbuttonview.cpp.

{
    if (model()->iconVisible()) {
        Q_D(const MButtonView);

        bool toggleState = d->toggleState();

        const QPixmap *pixmap = NULL;
        if (toggleState && d->toggledIcon)
            pixmap = d->toggledIcon->pixmap;
        else if (d->icon)
            pixmap = d->icon->pixmap;

        if (pixmap)
            painter->drawPixmap(iconRect, *pixmap, QRectF(pixmap->rect()));
    }
}