QGIS API Documentation  2.5.0-Master
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
Public Types | Public Slots | Signals | Public Member Functions | Static Public Member Functions | Protected Member Functions | List of all members
QgsMessageBar Class Reference

A bar for displaying non-blocking messages to the user. More...

#include <qgsmessagebar.h>

Inheritance diagram for QgsMessageBar:
Inheritance graph
[legend]

Public Types

enum  MessageLevel { INFO = 0, WARNING = 1, CRITICAL = 2 }
 

Public Slots

bool popWidget ()
 
bool clearWidgets ()
 

Signals

void widgetAdded (QgsMessageBarItem *item)
 emitted when a message widget is added to the bar More...
 
void widgetRemoved (QgsMessageBarItem *item)
 emitted when a message widget was removed from the bar More...
 

Public Member Functions

 QgsMessageBar (QWidget *parent=0)
 
 ~QgsMessageBar ()
 
void pushItem (QgsMessageBarItem *item)
 
QgsMessageBarItempushWidget (QWidget *widget, MessageLevel level=INFO, int duration=0)
 
bool popWidget (QgsMessageBarItem *item)
 
void pushMessage (const QString &text, MessageLevel level=INFO, int duration=0)
 convenience method for pushing a message to the bar More...
 
void pushMessage (const QString &title, const QString &text, MessageLevel level=INFO, int duration=0)
 convenience method for pushing a message with title to the bar More...
 

Static Public Member Functions

static QgsMessageBarItemcreateMessage (const QString &text, QWidget *parent=0)
 make out a widget containing a message to be displayed on the bar More...
 
static QgsMessageBarItemcreateMessage (const QString &title, const QString &text, QWidget *parent=0)
 make out a widget containing title and message to be displayed on the bar More...
 
static QgsMessageBarItemcreateMessage (QWidget *widget, QWidget *parent=0)
 make out a widget containing title and message to be displayed on the bar More...
 

Protected Member Functions

void mousePressEvent (QMouseEvent *e)
 

Detailed Description

A bar for displaying non-blocking messages to the user.

Constructor & Destructor Documentation

QgsMessageBar::QgsMessageBar ( QWidget *  parent = 0)
QgsMessageBar::~QgsMessageBar ( )

Member Function Documentation

bool QgsMessageBar::clearWidgets ( )
slot

remove all items from the bar's widget list

Returns
true if all items were removed, false otherwise
QgsMessageBarItem * QgsMessageBar::createMessage ( const QString &  text,
QWidget *  parent = 0 
)
static

make out a widget containing a message to be displayed on the bar

QgsMessageBarItem * QgsMessageBar::createMessage ( const QString &  title,
const QString &  text,
QWidget *  parent = 0 
)
static

make out a widget containing title and message to be displayed on the bar

QgsMessageBarItem * QgsMessageBar::createMessage ( QWidget *  widget,
QWidget *  parent = 0 
)
static

make out a widget containing title and message to be displayed on the bar

void QgsMessageBar::mousePressEvent ( QMouseEvent *  e)
protected
bool QgsMessageBar::popWidget ( QgsMessageBarItem item)

remove the passed widget from the bar (if previously added), then display the next one in the stack if any or hide the bar

Parameters
itemitem to remove
Returns
true if the widget was removed, false otherwise
bool QgsMessageBar::popWidget ( )
slot

remove the currently displayed widget from the bar and display the next in the stack if any or hide the bar

Returns
true if the widget was removed, false otherwise
void QgsMessageBar::pushItem ( QgsMessageBarItem item)

display a message item on the bar after hiding the currently visible one and putting it in a stack.

Parameters
itemitem to display
void QgsMessageBar::pushMessage ( const QString &  text,
MessageLevel  level = INFO,
int  duration = 0 
)
inline

convenience method for pushing a message to the bar

void QgsMessageBar::pushMessage ( const QString &  title,
const QString &  text,
QgsMessageBar::MessageLevel  level = INFO,
int  duration = 0 
)

convenience method for pushing a message with title to the bar

QgsMessageBarItem * QgsMessageBar::pushWidget ( QWidget *  widget,
QgsMessageBar::MessageLevel  level = INFO,
int  duration = 0 
)

display a widget as a message on the bar after hiding the currently visible one and putting it in a stack.

Parameters
widgetmessage widget to display
levelis QgsMessageBar::INFO, WARNING or CRITICAL
durationtimeout duration of message in seconds, 0 value indicates no timeout
void QgsMessageBar::widgetAdded ( QgsMessageBarItem item)
signal

emitted when a message widget is added to the bar

void QgsMessageBar::widgetRemoved ( QgsMessageBarItem item)
signal

emitted when a message widget was removed from the bar


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