Xfce Titled Dialog: Libxfce4ui Reference Manual

Xfce Titled Dialog

Xfce Titled Dialog — A GtkDialog with heading.

Functions

GtkWidget *	xfce_titled_dialog_new ()
GtkWidget *	xfce_titled_dialog_new_with_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

The XfceTitledDialog is a normal GtkDialog with a heading. The icon and title used in the heading are the same as the dialog title and icon See gtk_window_set_icon_name().

To give the user more detailed information about the use of the dialog, an optional subtitle and be set using xfce_titled_dialog_set_subtitle().

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`.
parent	transient parent window of the dialog, or `NULL`.
flags	from GtkDialogFlags.
first_button_text	stock ID or text to go in first, or `NULL`.
...	response ID for the first button, then additional buttons, ending with `NULL`.

Returns

the newly allocated XfceTitledDialog.

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;

Structure for the XfceTitledDialog.

Property Details

The `“subtitle”` property

  “subtitle”                 gchar *

The subtitle displayed below the main dialog title.

Flags: Read / Write

Default value: NULL