Constructor

GtkMessageDialognew_with_markup

since: 2.4

Declaration [src]

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

Description [src]

Creates a new message dialog, which is a simple dialog with some text that is marked up with the [Pango text markup language][PangoMarkupFormat]. When the user clicks a button a “response” signal is emitted with response IDs from GtkResponseType. See GtkDialog for more details.

Special XML characters in the printf() arguments passed to this function will automatically be escaped as necessary. (See g_markup_printf_escaped() for how this is implemented.) Usually this is what you want, but if you have an existing Pango markup string that you want to use literally as the label, then you need to use gtk_message_dialog_set_markup() instead, since you can’t pass the markup string either as the format (it might contain “%” characters) or as a string argument.

 GtkWidget *dialog;
 GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT;
 dialog = gtk_message_dialog_new (parent_window,
                                  flags,
                                  GTK_MESSAGE_ERROR,
                                  GTK_BUTTONS_CLOSE,
                                  NULL);
 gtk_message_dialog_set_markup (GTK_MESSAGE_DIALOG (dialog),
                                markup);

Available since: 2.4

This constructor is not directly available to language bindings.

Parameters

parent

Type: GtkWindow

Transient parent, or NULL for none.

The argument can be NULL.
The data is owned by the caller of the function.
flags

Type: GtkDialogFlags

Flags.

type

Type: GtkMessageType

Type of message.

buttons

Type: GtkButtonsType

Set of buttons to use.

message_format

Type: const gchar*

Printf()-style format string, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
...

Type: 

Arguments for message_format.

Return value

Type: GtkWidget

A new GtkMessageDialog.

The data is owned by the called function.