GtkMessageDialog: GTK+ 2 Reference Manual

GtkMessageDialog

Functions

GtkWidget *	gtk_message_dialog_new ()
GtkWidget *	gtk_message_dialog_new_with_markup ()
void	gtk_message_dialog_set_markup ()
void	gtk_message_dialog_set_image ()
GtkWidget *	gtk_message_dialog_get_image ()
GtkWidget *	gtk_message_dialog_get_message_area ()
void	gtk_message_dialog_format_secondary_text ()
void	gtk_message_dialog_format_secondary_markup ()

Properties

GtkButtonsType	buttons	Write / Construct Only
GtkWidget *	image	Read / Write
GtkWidget *	message-area	Read
GtkMessageType	message-type	Read / Write / Construct
gchar *	secondary-text	Read / Write
gboolean	secondary-use-markup	Read / Write
gchar *	text	Read / Write
gboolean	use-markup	Read / Write

Style Properties

gint	message-border	Read
gboolean	use-separator	Read

Types and Values

struct	GtkMessageDialog
enum	GtkMessageType
enum	GtkButtonsType

Object Hierarchy

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

Implemented Interfaces

GtkMessageDialog implements AtkImplementorIface and GtkBuildable.

Includes

#include <gtk/gtk.h>

Description

Functions

gtk_message_dialog_new ()

GtkWidget *
gtk_message_dialog_new (GtkWindow *parent,
                        GtkDialogFlags flags,
                        GtkMessageType type,
                        GtkButtonsType buttons,
                        const gchar *message_format,
                        ...);

gtk_message_dialog_new_with_markup ()

GtkWidget *
gtk_message_dialog_new_with_markup (GtkWindow *parent,
                                    GtkDialogFlags flags,
                                    GtkMessageType type,
                                    GtkButtonsType buttons,
                                    const gchar *message_format,
                                    ...);

Since: 2.4

gtk_message_dialog_set_markup ()

void
gtk_message_dialog_set_markup (GtkMessageDialog *message_dialog,
                               const gchar *str);

Since: 2.4

gtk_message_dialog_set_image ()

void
gtk_message_dialog_set_image (GtkMessageDialog *dialog,
                              GtkWidget *image);

Since: 2.10

gtk_message_dialog_get_image ()

GtkWidget *
gtk_message_dialog_get_image (GtkMessageDialog *dialog);

Since: 2.14

gtk_message_dialog_get_message_area ()

GtkWidget *
gtk_message_dialog_get_message_area (GtkMessageDialog *message_dialog);

Since: 2.22

gtk_message_dialog_format_secondary_text ()

void
gtk_message_dialog_format_secondary_text
                               (GtkMessageDialog *message_dialog,
                                const gchar *message_format,
                                ...);

Since: 2.6

gtk_message_dialog_format_secondary_markup ()

void
gtk_message_dialog_format_secondary_markup
                               (GtkMessageDialog *message_dialog,
                                const gchar *message_format,
                                ...);

Since: 2.6

Types and Values

struct GtkMessageDialog

struct GtkMessageDialog;

enum GtkMessageType

Members

GTK_MESSAGE_INFO
GTK_MESSAGE_WARNING
GTK_MESSAGE_QUESTION
GTK_MESSAGE_ERROR
GTK_MESSAGE_OTHER

enum GtkButtonsType

Members

GTK_BUTTONS_NONE
GTK_BUTTONS_OK
GTK_BUTTONS_CLOSE
GTK_BUTTONS_CANCEL
GTK_BUTTONS_YES_NO
GTK_BUTTONS_OK_CANCEL

Property Details

The `“buttons”` property

  “buttons”                  GtkButtonsType

The buttons shown in the message dialog.

Flags: Write / Construct Only

Default value: GTK_BUTTONS_NONE

The `“image”` property

  “image”                    GtkWidget *

The image.

Flags: Read / Write

Since: 2.10

The `“message-area”` property

  “message-area”             GtkWidget *

GtkVBox that holds the dialog's primary and secondary labels.

Flags: Read

Since: 2.22

The `“message-type”` property

  “message-type”             GtkMessageType

The type of message.

Flags: Read / Write / Construct

Default value: GTK_MESSAGE_INFO

The `“secondary-text”` property

  “secondary-text”           gchar *

The secondary text of the message dialog.

Flags: Read / Write

Default value: NULL

Since: 2.10

The `“secondary-use-markup”` property

  “secondary-use-markup”     gboolean

The secondary text includes Pango markup.

Flags: Read / Write

Default value: FALSE

Since: 2.10

The `“text”` property

  “text”                     gchar *

The primary text of the message dialog.

Flags: Read / Write

Default value: ""

Since: 2.10

The `“use-markup”` property

  “use-markup”               gboolean

The primary text of the title includes Pango markup.

Flags: Read / Write

Default value: FALSE

Since: 2.10

Style Property Details

The `“message-border”` style property

  “message-border”           gint

Width of border around the label and image in the message dialog.

Flags: Read

Allowed values: >= 0

Default value: 12

The `“use-separator”` style property

  “use-separator”            gboolean

Whether to put a separator between the message dialog's text and the buttons.

GtkMessageDialog:use-separator has been deprecated since version 2.22 and should not be used in newly-written code.

This style property will be removed in GTK+ 3

Flags: Read

Default value: FALSE

Since: 2.4