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.

Owner: XfceTitledDialog

Flags: Read / Write

Default value: NULL