Constructor
Gtk.MessageDialog.new_with_markup
Declaration [src]
GtkWidget*
gtk_message_dialog_new_with_markup (
GtkWindow* parent,
GtkDialogFlags flags,
GtkMessageType type,
GtkButtonsType buttons,
const char* message_format,
...
)
Description [src]
Creates a new message dialog.
This is a simple dialog with some text that is marked up with
Pango markup. 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);
Parameters
parent |
GtkWindow |
transient parent, or |
|
Can be NULL | |
Ownership is not transferred to the callee | |
flags |
GtkDialogFlags |
flags |
|
type |
GtkMessageType |
type of message |
|
buttons |
GtkButtonsType |
set of buttons to use |
|
message_format |
const char* |
|
|
Can be NULL | |
Ownership is not transferred to the callee | |
The string is a NUL terminated UTF-8 string | |
... |
|
arguments for |
Return value
Returns: GtkWidget |
|
a new |
|
Ownership is not transferred to the caller |