StelButton Class Reference

A Button Graphicsitem for use in Stellarium's graphic widgets. More...

#include <StelGuiItems.hpp>

Public Types
enum	{ ButtonStateOff = 0, ButtonStateOn = 1, ButtonStateNoChange = 2 }
	Button states. More...

Public Slots
void	setChecked (int b)
	set whether the button is checked More...
void	setChecked (bool b)

Signals
void	toggled (bool)
	Triggered when the button state changes. More...
void	triggered ()
	Triggered when the button state changes. More...
void	hoverChanged (bool b)
	Emitted when the hover state change. More...

Public Member Functions
	StelButton (QGraphicsItem *parent, const QPixmap &pixOn, const QPixmap &pixOff, const QPixmap &pixHover=QPixmap(), QAction *action=NULL, bool noBackground=false)
	Constructor. More...
	StelButton (QGraphicsItem *parent, const QPixmap &pixOn, const QPixmap &pixOff, const QPixmap &pixNoChange, const QPixmap &pixHover=QPixmap(), QAction *action=NULL, bool noBackground=false, bool isTristate=true)
	Constructor. More...
int	isChecked () const
	Get whether the button is checked. More...
int	getButtonPixmapWidth () const
	Get the width of the button image. More...
void	setOpacity (double v)
	Set the button opacity. More...
void	setRedMode (bool b)
	Activate red mode for this button, i.e. will reduce the non red color component of the icon. More...
void	setBackgroundPixmap (const QPixmap &newBackground)
	Set the background pixmap of the button. More...

Static Public Member Functions
static QPixmap	makeRed (const QPixmap &p)
	Transform the pixmap so that it look red for night vision mode. More...

Protected Member Functions
virtual void	mousePressEvent (QGraphicsSceneMouseEvent *event)
virtual void	hoverEnterEvent (QGraphicsSceneHoverEvent *event)
virtual void	hoverLeaveEvent (QGraphicsSceneHoverEvent *event)
virtual void	mouseReleaseEvent (QGraphicsSceneMouseEvent *event)

Detailed Description

A Button Graphicsitem for use in Stellarium's graphic widgets.

Definition at line 57 of file StelGuiItems.hpp.

Member Enumeration Documentation

anonymous enum

Button states.

Definition at line 86 of file StelGuiItems.hpp.

Constructor & Destructor Documentation

StelButton::StelButton	(	QGraphicsItem *	parent,
		const QPixmap &	pixOn,
		const QPixmap &	pixOff,
		const QPixmap &	pixHover = QPixmap(),
		QAction *	action = NULL,
		bool	noBackground = false
	)

Constructor.

Parameters

parent	the parent item
pixOn	the pixmap to display when the button is toggled
pixOff	the pixmap to display when the button is not toggled
pixHover	a pixmap slowly blended when mouse is over the button
action	the associated action. Connections are automatically done with the signals if relevant.
noBackground	define whether the button background image have to be used

StelButton::StelButton	(	QGraphicsItem *	parent,
		const QPixmap &	pixOn,
		const QPixmap &	pixOff,
		const QPixmap &	pixNoChange,
		const QPixmap &	pixHover = QPixmap(),
		QAction *	action = NULL,
		bool	noBackground = false,
		bool	isTristate = true
	)

Constructor.

Parameters

parent	the parent item
pixOn	the pixmap to display when the button is toggled
pixOff	the pixmap to display when the button is not toggled
pixNoChange	the pixmap to display when the button state of a tristate is not changed
pixHover	a pixmap slowly blended when mouse is over the button
action	the associated action. Connections are automatically done with the signals if relevant.
noBackground	define whether the button background image have to be used
isTristate	define whether the button is a tristate or an on/off button

Member Function Documentation

int StelButton::getButtonPixmapWidth ( ) const

inline

Get the width of the button image.

The width is based on pixOn.

Definition at line 93 of file StelGuiItems.hpp.

void StelButton::hoverChanged ( bool  b )

signal

Emitted when the hover state change.

Parameters

b	true if the mouse entered the button

int StelButton::isChecked ( ) const

inline

Get whether the button is checked.

Definition at line 89 of file StelGuiItems.hpp.

static QPixmap StelButton::makeRed ( const QPixmap &  p )

static

Transform the pixmap so that it look red for night vision mode.

void StelButton::setBackgroundPixmap

(

const QPixmap &

newBackground

)

Set the background pixmap of the button.

A variant for night vision mode (pixBackgroundRed) is automatically generated from the new background.

void StelButton::setChecked ( int  b )

slot

set whether the button is checked

void StelButton::setOpacity ( double  v )

inline

Set the button opacity.

Definition at line 96 of file StelGuiItems.hpp.

void StelButton::setRedMode ( bool  b )

inline

Activate red mode for this button, i.e. will reduce the non red color component of the icon.

Definition at line 99 of file StelGuiItems.hpp.

void StelButton::toggled ( bool  )

signal

Triggered when the button state changes.

void StelButton::triggered ( )

signal

Triggered when the button state changes.

---

The documentation for this class was generated from the following file:

• gui/StelGuiItems.hpp