/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/gui/qgsmessagebar.h                                              *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.pl again   *
 ************************************************************************/






class QgsMessageBar: QFrame
{
%Docstring
 A bar for displaying non-blocking messages to the user.
%End

%TypeHeaderCode
#include "qgsmessagebar.h"
%End
  public:
    enum MessageLevel
    {
      INFO,
      WARNING,
      CRITICAL,
      SUCCESS
    };

    QgsMessageBar( QWidget *parent /TransferThis/ = 0 );

    void pushItem( QgsMessageBarItem *item /Transfer/ );
%Docstring
 Display a message item on the bar after hiding the currently visible one
 and putting it in a stack.
 The message bar will take ownership of the item.

 \param item Item to display
%End

    QgsMessageBarItem *pushWidget( QWidget *widget /Transfer/, MessageLevel level = INFO, int duration = 0 );
%Docstring
 Display a widget as a message on the bar after hiding the currently visible one
  and putting it in a stack.
 \param widget message widget to display
 \param level is QgsMessageBar.INFO, WARNING, CRITICAL or SUCCESS
 \param duration timeout duration of message in seconds, 0 value indicates no timeout
 :rtype: QgsMessageBarItem
%End

    bool popWidget( QgsMessageBarItem *item );
%Docstring
 Remove the passed widget from the bar (if previously added),
  then display the next one in the stack if any or hide the bar
  \param item item to remove
  :return: true if the widget was removed, false otherwise
 :rtype: bool
%End

    static QgsMessageBarItem *createMessage( const QString &text, QWidget *parent = 0 ) /Factory/;
%Docstring
make out a widget containing a message to be displayed on the bar
 :rtype: QgsMessageBarItem
%End
    static QgsMessageBarItem *createMessage( const QString &title, const QString &text, QWidget *parent = 0 ) /Factory/;
%Docstring
make out a widget containing title and message to be displayed on the bar
 :rtype: QgsMessageBarItem
%End
    static QgsMessageBarItem *createMessage( QWidget *widget, QWidget *parent = 0 ) /Factory/;
%Docstring
make out a widget containing title and message to be displayed on the bar
 :rtype: QgsMessageBarItem
%End

    void pushMessage( const QString &text, MessageLevel level = INFO, int duration = 5 );
%Docstring
convenience method for pushing a message to the bar
%End
    void pushMessage( const QString &title, const QString &text, MessageLevel level = INFO, int duration = 5 );
%Docstring
convenience method for pushing a message with title to the bar
%End

    QgsMessageBarItem *currentItem();
%Docstring
 :rtype: QgsMessageBarItem
%End

  signals:
    void widgetAdded( QgsMessageBarItem *item );
%Docstring
emitted when a message widget is added to the bar
%End

    void widgetRemoved( QgsMessageBarItem *item );
%Docstring
emitted when a message widget was removed from the bar
%End

  public slots:

    bool popWidget();
%Docstring
 Remove the currently displayed widget from the bar and
  display the next in the stack if any or hide the bar.
  :return: true if the widget was removed, false otherwise
 :rtype: bool
%End

    bool clearWidgets();
%Docstring
 Remove all items from the bar's widget list
  :return: true if all items were removed, false otherwise
 :rtype: bool
%End

    void pushSuccess( const QString &title, const QString &message );
%Docstring
 Pushes a success message with default timeout to the message bar
 \param title title string for message
 \param message The message to be displayed
.. versionadded:: 2.8
%End

    void pushInfo( const QString &title, const QString &message );
%Docstring
 Pushes a information message with default timeout to the message bar
 \param title title string for message
 \param message The message to be displayed
.. versionadded:: 2.8
%End

    void pushWarning( const QString &title, const QString &message );
%Docstring
 Pushes a warning with default timeout to the message bar
 \param title title string for message
 \param message The message to be displayed
.. versionadded:: 2.8
%End

    void pushCritical( const QString &title, const QString &message );
%Docstring
 Pushes a critical warning with default timeout to the message bar
 \param title title string for message
 \param message The message to be displayed
.. versionadded:: 2.8
%End

  protected:
    virtual void mousePressEvent( QMouseEvent *e );


};

/************************************************************************
 * This file has been generated automatically from                      *
 *                                                                      *
 * src/gui/qgsmessagebar.h                                              *
 *                                                                      *
 * Do not edit manually ! Edit header and run scripts/sipify.pl again   *
 ************************************************************************/