XfceTitledDialog: Libxfce4ui Reference Manual

XfceTitledDialog

XfceTitledDialog — A titled dialog window

Stability Level

Stable, unless otherwise indicated

Functions

GtkWidget *	xfce_titled_dialog_new ()
GtkWidget *	xfce_titled_dialog_new_with_buttons ()
GtkWidget *	xfce_titled_dialog_new_with_mixed_buttons ()
const gchar *	xfce_titled_dialog_get_subtitle ()
void	xfce_titled_dialog_set_subtitle ()

Properties

gchar *

subtitle

Read / Write

Types and Values

struct

XfceTitledDialog

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkContainer
                    ╰── GtkBin
                        ╰── GtkWindow
                            ╰── GtkDialog
                                ╰── XfceTitledDialog

Implemented Interfaces

XfceTitledDialog implements AtkImplementorIface and GtkBuildable.

Includes

#include <libxfce4ui/libxfce4ui.h>

Description

XfceTitledDialog is a titled dialog window supporting an optional subtitle and mixed or pixbuf buttons.

Functions

xfce_titled_dialog_new ()

GtkWidget *
xfce_titled_dialog_new (void);

Allocates a new XfceTitledDialog instance.

Returns

the newly allocated XfceTitledDialog.

xfce_titled_dialog_new_with_buttons ()

GtkWidget *
xfce_titled_dialog_new_with_buttons (const gchar *title,
                                     GtkWindow *parent,
                                     GtkDialogFlags flags,
                                     const gchar *first_button_text,
                                     ...);

See the documentation of gtk_dialog_new_with_buttons() for details about the parameters and the returned dialog.

Parameters

title	title of the dialog, or `NULL`.	[allow-none]
parent	transient parent window of the dialog, or `NULL`.	[allow-none]
flags	from GtkDialogFlags.
first_button_text	stock ID or text to go in first, or `NULL`.	[allow-none]
...	response ID for the first button, then additional buttons, ending with `NULL`.

Returns

the newly allocated XfceTitledDialog.

xfce_titled_dialog_new_with_mixed_buttons ()

GtkWidget *
xfce_titled_dialog_new_with_mixed_buttons
                               (const gchar *title,
                                GtkWindow *parent,
                                GtkDialogFlags flags,
                                const gchar *first_button_icon_name,
                                const gchar *first_button_text,
                                ...);

Creates an XfceTitledDialog using xfce_gtk_button_new_mixed. This allows the buttons to use an optional named or stock icon.

Parameters

title	title of the dialog, or `NULL`.	[allow-none]
parent	transient parent window of the dialog, or `NULL`.	[allow-none]
flags	from GtkDialogFlags.
first_button_icon_name	icon name to go in first, or "" for no icon.
first_button_text	text to go in first, or `NULL`.	[allow-none]
...	response ID for the first button, then additional buttons, ending with `NULL`.

Returns

the newly allocated XfceTitledDialog.

Since: 4.14

xfce_titled_dialog_get_subtitle ()

const gchar *
xfce_titled_dialog_get_subtitle (XfceTitledDialog *titled_dialog);

Returns the subtitle of the titled_dialog , or NULL if no subtitle is displayed in the titled_dialog .

Parameters

titled_dialog

a XfceTitledDialog.

Returns

the subtitle of titled_dialog , or NULL.

xfce_titled_dialog_set_subtitle ()

void
xfce_titled_dialog_set_subtitle (XfceTitledDialog *titled_dialog,
                                 const gchar *subtitle);

Sets the subtitle displayed by titled_dialog to subtitle ; if subtitle is NULL no subtitle will be displayed by the titled_dialog .

Parameters

titled_dialog	a XfceTitledDialog.
subtitle	the new subtitle for the `titled_dialog` , or `NULL`.

Types and Values

struct XfceTitledDialog

struct XfceTitledDialog;

An opaque struct with only private fields.

Property Details

The `“subtitle”` property

  “subtitle”                 gchar *

The subtitle displayed below the main dialog title.

Flags: Read / Write

Default value: NULL