qt-he-wrapper

qt-he-wrapper — A class for Qt-based software that contains static methods invoking various Hildon Extras dialogs.

Synopsis

QColor              QtHeWrapper::showHeSimpleColorDialog     (QWidget *parent = NULL,
                                                              const QColor &defaultColor = QColor(),
                                                              bool showAdvancedButton = true,
                                                              const QString &dialogTitle = "");
QColor              QtHeWrapper::showHeColorDialog           (QWidget *parent = NULL,
                                                              const QColor &defaultColor = QColor(),
                                                              const QString &dialogTitle = "");
void                QtHeWrapper::showHeAboutDialog           (QWidget *parent,
                                                              const QString &description,
                                                              const QString &copyright,
                                                              const QString &websiteUrl = "",
                                                              const QString &bugtrackerUrl = "",
                                                              const QString &donateUrl = "",
                                                              const QString &iconName = "",
                                                              const QString &appName = QApplication::applicationName(),
                                                              const QString &version = QApplication::applicationVersion());
QFont               QtHeWrapper::showHeFontDialog            (QWidget *parent = NULL,
                                                              const QFont &defaultFont = QFont(),
                                                              const QString &dialogTitle = "");

Description

A wrapper class for Hildon Extras. It is to be used from Qt-based software. It contains static methods invoking various Hildon Extras dialogs, providing an interoperability between Qt and Hildon. These methods have parameters to customize some characteristics of the displayed dialogs.

Details

QtHeWrapper::showHeSimpleColorDialog ()

QColor              QtHeWrapper::showHeSimpleColorDialog     (QWidget *parent = NULL,
                                                              const QColor &defaultColor = QColor(),
                                                              bool showAdvancedButton = true,
                                                              const QString &dialogTitle = "");

Displays a HeSimpleColorDialog and returns the user's chosen color as a QColor.

`parent` :	The parent of the dialog, or NULL if no parent is needed. (The default value is NULL.)
`defaultColor` :	The initial color to display in the dialog. No color is displayed initially if an invalid QColor instance is given. (The default value is an invalid QColor instance.)
`showAdvancedButton` :	True if the "Advanced" button should be shown, otherwise false. (The default value is true.)
`dialogTitle` :	The title to give the dialog. An empty string will cause the default title to be shown. (This is the default value.)
Returns :	The user's chosen color as a QColor, or the color specified in the defaultColor parameter if the user cancelled the dialog. On cancellation, if this parameter is not set, an invalid QColor instance is returned.

QtHeWrapper::showHeColorDialog ()

QColor              QtHeWrapper::showHeColorDialog           (QWidget *parent = NULL,
                                                              const QColor &defaultColor = QColor(),
                                                              const QString &dialogTitle = "");

Displays a HeColorDialog and returns the user's chosen color as a QColor.

`parent` :	The parent of the dialog, or NULL if no parent is needed. (The default value is NULL.)
`defaultColor` :	The initial color to display in the dialog. No color is displayed initially if an invalid QColor instance is given. (The default value is an invalid QColor instance.)
`dialogTitle` :	The title to give the dialog. An empty string will cause the default title to be shown. (This is the default value.)
Returns :	The user's chosen color as a QColor, or the color specified in the defaultColor parameter if the user cancelled the dialog. On cancellation, if this parameter is not set, an invalid QColor instance is returned.

QtHeWrapper::showHeAboutDialog ()

void                QtHeWrapper::showHeAboutDialog           (QWidget *parent,
                                                              const QString &description,
                                                              const QString &copyright,
                                                              const QString &websiteUrl = "",
                                                              const QString &bugtrackerUrl = "",
                                                              const QString &donateUrl = "",
                                                              const QString &iconName = "",
                                                              const QString &appName = QApplication::applicationName(),
                                                              const QString &version = QApplication::applicationVersion());

Displays a HeAboutDialog.

`parent` :	The parent of the dialog, or NULL if no parent is needed. (The default value is NULL.)
`description` :	The description to display.
`copyright` :	The copyright notice to display.
`websiteUrl` :	The URL that will be opened when the user clicks on the "Visit website" button. If an empty string is given, this button will not be shown.
`bugtrackerUrl` :	The URL that will be opened when the user clicks on the "Report bug" button. If an empty string is given, this button will not be shown.
`donateUrl` :	The URL that will be opened when the user clicks on the "Donate" button. If an empty string is given, this button will not be shown.
`iconName` :	The Gtk icon name (i.e. the name without extension of a .png file in /usr/pixmaps) that should be displayed in the dialog. If an empty string is given, no icon will be shown.
`appName` :	The application name to be displayed. (The default value is `QApplication::applicationName()`)
`version` :	The version to be displayed. (The default value is `QApplication::applicationVersion()`)

QtHeWrapper::showHeFontDialog ()

QFont               QtHeWrapper::showHeFontDialog            (QWidget *parent = NULL,
                                                              const QFont &defaultFont = QFont(),
                                                              const QString &dialogTitle = "");

Displays a HeFontDialog and returns the user's chosen font as a QFont.

`parent` :	The parent of the dialog, or NULL if no parent is needed. (The default value is NULL.)
`defaultFont` :	The initial font to display in the dialog. (The default value is the default font of the environment.)
`dialogTitle` :	The title to give the dialog. An empty string will cause the default title to be shown. (This is the default value.)
Returns :	The user's chosen font as a QFont, or the font specified in the defaultFont parameter if the user cancelled the dialog. On cancellation, if this parameter is not set, the default font of the environment is returned.

			hildon-extras Reference Manual
Top \| Description