QGIS/python/gui/auto_generated/qgsmessagebaritem.sip.in
Nyall Dawson 13951b2be4 Make it easier to use the correct timeout for messages in message bars,
and ensure that correct timeouts are used for all created messages
2020-11-22 04:58:42 +10:00

198 lines
6.6 KiB
Plaintext

/************************************************************************
* This file has been generated automatically from *
* *
* src/gui/qgsmessagebaritem.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
************************************************************************/
class QgsMessageBarItem : QWidget
{
%Docstring
Represents an item shown within a QgsMessageBar widget.
QgsMessageBarItem represents a single item (or message) which can be shown in a QgsMessageBar widget.
%End
%TypeHeaderCode
#include "qgsmessagebaritem.h"
%End
public:
QgsMessageBarItem( const QString &text, Qgis::MessageLevel level = Qgis::Info, int duration = 0, QWidget *parent /TransferThis/ = 0 );
%Docstring
Constructor for QgsMessageBarItem, containing a message with the specified ``text`` to be displayed on the bar.
The ``level`` argument specifies the desired message level (severity) of the message, which controls
how the message bar is styled when the item is displayed.
The optional ``duration`` argument can be used to specify the message timeout in seconds. If ``duration``
is set to 0, then the message must be manually dismissed by the user. Since QGIS 3.18, a duration of -1 indicates that
the default timeout for the message ``level`` should be used.
%End
QgsMessageBarItem( const QString &title, const QString &text, Qgis::MessageLevel level = Qgis::Info, int duration = 0, QWidget *parent /TransferThis/ = 0 );
%Docstring
Constructor for QgsMessageBarItem, containing a ``title`` and message with the specified ``text`` to be displayed on the bar.
The ``level`` argument specifies the desired message level (severity) of the message, which controls
how the message bar is styled when the item is displayed.
The optional ``duration`` argument can be used to specify the message timeout in seconds. If ``duration``
is set to 0, then the message must be manually dismissed by the user. Since QGIS 3.18, a duration of -1 indicates that
the default timeout for the message ``level`` should be used.
%End
QgsMessageBarItem( const QString &title, const QString &text, QWidget *widget, Qgis::MessageLevel level = Qgis::Info, int duration = 0, QWidget *parent /TransferThis/ = 0 );
%Docstring
Constructor for QgsMessageBarItem, containing a ``title``, message with the specified ``text``, and a custom ``widget`` to be displayed on the bar.
The ``level`` argument specifies the desired message level (severity) of the message, which controls
how the message bar is styled when the item is displayed.
The optional ``duration`` argument can be used to specify the message timeout in seconds. If ``duration``
is set to 0, then the message must be manually dismissed by the user. Since QGIS 3.18, a duration of -1 indicates that
the default timeout for the message ``level`` should be used.
%End
QgsMessageBarItem( QWidget *widget, Qgis::MessageLevel level = Qgis::Info, int duration = 0, QWidget *parent /TransferThis/ = 0 );
%Docstring
Constructor for QgsMessageBarItem, containing a custom ``widget`` to be displayed on the bar.
The ``level`` argument specifies the desired message level (severity) of the message, which controls
how the message bar is styled when the item is displayed.
The optional ``duration`` argument can be used to specify the message timeout in seconds. If ``duration``
is set to 0, then the message must be manually dismissed by the user. Since QGIS 3.18, a duration of -1 indicates that
the default timeout for the message ``level`` should be used.
%End
QgsMessageBarItem *setText( const QString &text );
%Docstring
Sets the message ``text`` to show in the item.
.. seealso:: :py:func:`text`
%End
QString text() const;
%Docstring
Returns the text for the message.
.. seealso:: :py:func:`setText`
%End
QgsMessageBarItem *setTitle( const QString &title );
%Docstring
Sets the ``title`` for in the item.
.. seealso:: :py:func:`title`
%End
QString title() const;
%Docstring
Returns the title for the message.
.. seealso:: :py:func:`setTitle`
%End
QgsMessageBarItem *setLevel( Qgis::MessageLevel level );
%Docstring
Sets the message ``level`` for the item, which controls how the message bar is styled
when the item is displayed.
.. seealso:: :py:func:`level`
%End
Qgis::MessageLevel level() const;
%Docstring
Returns the message level for the message.
.. seealso:: :py:func:`setLevel`
%End
QgsMessageBarItem *setWidget( QWidget *widget );
%Docstring
Sets a custom ``widget`` to show in the item.
.. seealso:: :py:func:`widget`
%End
QWidget *widget() const;
%Docstring
Returns the widget for the message.
.. seealso:: :py:func:`setWidget`
%End
QgsMessageBarItem *setIcon( const QIcon &icon );
%Docstring
Sets the ``icon`` associated with the message.
.. seealso:: :py:func:`icon`
%End
QIcon icon() const;
%Docstring
Returns the icon for the message.
.. seealso:: :py:func:`setIcon`
%End
QgsMessageBarItem *setDuration( int duration );
%Docstring
Sets the ``duration`` (in seconds) to show the message for. If ``duration``
is 0 then the message will not automatically timeout and instead must be
manually dismissed by the user.
.. seealso:: :py:func:`duration`
%End
int duration() const;
%Docstring
Returns the duration (in seconds) of the message.
If the duration is 0 then the message will not automatically timeout and instead must be
manually dismissed by the user.
.. seealso:: :py:func:`setDuration`
%End
QString getStyleSheet();
%Docstring
Returns the styleSheet which should be used to style a QgsMessageBar object when
this item is displayed.
%End
public slots:
void dismiss();
%Docstring
Dismisses the item, removing it from the message bar and deleting
it. Calling this on items which have not been added to a message bar
has no effect.
.. versionadded:: 3.4
%End
signals:
void styleChanged( const QString &styleSheet );
%Docstring
Emitted when the item's message level has changed and the message bar style
will need to be updated as a result.
%End
};
/************************************************************************
* This file has been generated automatically from *
* *
* src/gui/qgsmessagebaritem.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.pl again *
************************************************************************/