Blame docs/reference/gtk/html/GtkDialog.html

Packit Service fb6fa5
Packit Service fb6fa5
<html>
Packit Service fb6fa5
<head>
Packit Service fb6fa5
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit Service fb6fa5
<title>GtkDialog: GTK+ 2 Reference Manual</title>
Packit Service fb6fa5
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
Packit Service fb6fa5
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
Packit Service fb6fa5
<link rel="up" href="WindowWidgets.html" title="Windows">
Packit Service fb6fa5
<link rel="prev" href="WindowWidgets.html" title="Windows">
Packit Service fb6fa5
<link rel="next" href="GtkInvisible.html" title="GtkInvisible">
Packit Service fb6fa5
<meta name="generator" content="GTK-Doc V1.26.1 (XML mode)">
Packit Service fb6fa5
<link rel="stylesheet" href="style.css" type="text/css">
Packit Service fb6fa5
</head>
Packit Service fb6fa5
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Top  | 
Packit Service fb6fa5
                  Description  | 
Packit Service fb6fa5
                  Object Hierarchy  | 
Packit Service fb6fa5
                  Implemented Interfaces  | 
Packit Service fb6fa5
                  Properties  | 
Packit Service fb6fa5
                  Style Properties  | 
Packit Service fb6fa5
                  Signals
Packit Service fb6fa5
Packit Service fb6fa5
Home
Packit Service fb6fa5
Up
Packit Service fb6fa5
Prev
Packit Service fb6fa5
Next
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GtkDialog

Packit Service fb6fa5

GtkDialog

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Functions

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_new ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_new_with_buttons ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gint
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_run ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_response ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_add_button ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_add_buttons ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_add_action_widget ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gboolean
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_get_has_separator ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_set_default_response ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_set_has_separator ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_set_response_sensitive ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gint
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_get_response_for_widget ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_get_widget_for_response ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_get_action_area ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_get_content_area ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gboolean
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_alternative_dialog_button_order ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_set_alternative_button_order ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_dialog_set_alternative_button_order_from_array ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Properties

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gboolean
Packit Service fb6fa5
has-separator
Packit Service fb6fa5
Read / Write
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Style Properties

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gint
Packit Service fb6fa5
action-area-border
Packit Service fb6fa5
Read
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gint
Packit Service fb6fa5
button-spacing
Packit Service fb6fa5
Read
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gint
Packit Service fb6fa5
content-area-border
Packit Service fb6fa5
Read
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gint
Packit Service fb6fa5
content-area-spacing
Packit Service fb6fa5
Read
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Signals

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
close
Packit Service fb6fa5
Action
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
response
Packit Service fb6fa5
Run Last
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Types and Values

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
struct
Packit Service fb6fa5
GtkDialog
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
enum
Packit Service fb6fa5
GtkDialogFlags
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
enum
Packit Service fb6fa5
GtkResponseType
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Object Hierarchy

Packit Service fb6fa5
    GObject
Packit Service fb6fa5
    ╰── GInitiallyUnowned
Packit Service fb6fa5
        ╰── GtkObject
Packit Service fb6fa5
            ╰── GtkWidget
Packit Service fb6fa5
                ╰── GtkContainer
Packit Service fb6fa5
                    ╰── GtkBin
Packit Service fb6fa5
                        ╰── GtkWindow
Packit Service fb6fa5
                            ╰── GtkDialog
Packit Service fb6fa5
                                ├── GtkAboutDialog
Packit Service fb6fa5
                                ├── GtkColorSelectionDialog
Packit Service fb6fa5
                                ├── GtkFileChooserDialog
Packit Service fb6fa5
                                ├── GtkFileSelection
Packit Service fb6fa5
                                ├── GtkFontSelectionDialog
Packit Service fb6fa5
                                ├── GtkInputDialog
Packit Service fb6fa5
                                ├── GtkMessageDialog
Packit Service fb6fa5
                                ├── GtkPageSetupUnixDialog
Packit Service fb6fa5
                                ├── GtkPrintUnixDialog
Packit Service fb6fa5
                                ╰── GtkRecentChooserDialog
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Implemented Interfaces

Packit Service fb6fa5

Packit Service fb6fa5
GtkDialog implements
Packit Service fb6fa5
 AtkImplementorIface and  GtkBuildable.

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Includes

Packit Service fb6fa5
#include <gtk/gtk.h>
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Description

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Functions

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_new ()

Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
gtk_dialog_new (void);
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_new_with_buttons ()

Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
gtk_dialog_new_with_buttons (const gchar *title,
Packit Service fb6fa5
                             GtkWindow *parent,
Packit Service fb6fa5
                             GtkDialogFlags flags,
Packit Service fb6fa5
                             const gchar *first_button_text,
Packit Service fb6fa5
                             ...);
Packit Service fb6fa5

Creates a new GtkDialog with title title

Packit Service fb6fa5
 (or NULL for the default
Packit Service fb6fa5
title; see gtk_window_set_title()) and transient parent parent
Packit Service fb6fa5
 (or
Packit Service fb6fa5
NULL for none; see gtk_window_set_transient_for()). The flags
Packit Service fb6fa5
Packit Service fb6fa5
argument can be used to make the dialog modal (GTK_DIALOG_MODAL)
Packit Service fb6fa5
and/or to have it destroyed along with its transient parent
Packit Service fb6fa5
(GTK_DIALOG_DESTROY_WITH_PARENT). After flags
Packit Service fb6fa5
, button
Packit Service fb6fa5
text/response ID pairs should be listed, with a NULL pointer ending
Packit Service fb6fa5
the list. Button text can be either a stock ID such as
Packit Service fb6fa5
GTK_STOCK_OK, or some arbitrary text. A response ID can be
Packit Service fb6fa5
any positive number, or one of the values in the GtkResponseType
Packit Service fb6fa5
enumeration. If the user clicks one of these dialog buttons,
Packit Service fb6fa5
GtkDialog will emit the “response” signal with the corresponding
Packit Service fb6fa5
response ID. If a GtkDialog receives the “delete-event” signal, 
Packit Service fb6fa5
it will emit ::response with a response ID of GTK_RESPONSE_DELETE_EVENT.
Packit Service fb6fa5
However, destroying a dialog does not emit the ::response signal;
Packit Service fb6fa5
so be careful relying on ::response when using the 
Packit Service fb6fa5
GTK_DIALOG_DESTROY_WITH_PARENT flag. Buttons are from left to right,
Packit Service fb6fa5
so the first button in the list will be the leftmost button in the dialog.

Packit Service fb6fa5

Here's a simple example:

Packit Service fb6fa5
Packit Service fb6fa5
  
Packit Service fb6fa5
    
Packit Service fb6fa5
      
Packit Service fb6fa5
        
1
Packit Service fb6fa5
2
Packit Service fb6fa5
3
Packit Service fb6fa5
4
Packit Service fb6fa5
5
Packit Service fb6fa5
6
Packit Service fb6fa5
7
Packit Service fb6fa5
8
Packit Service fb6fa5
        
GtkWidget *dialog = gtk_dialog_new_with_buttons ("My dialog",
Packit Service fb6fa5
                                                 main_app_window,
Packit Service fb6fa5
                                                 GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
Packit Service fb6fa5
                                                 GTK_STOCK_OK,
Packit Service fb6fa5
                                                 GTK_RESPONSE_ACCEPT,
Packit Service fb6fa5
                                                 GTK_STOCK_CANCEL,
Packit Service fb6fa5
                                                 GTK_RESPONSE_REJECT,
Packit Service fb6fa5
                                                 NULL);
Packit Service fb6fa5
      
Packit Service fb6fa5
    
Packit Service fb6fa5
  
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

title

Packit Service fb6fa5

Title of the dialog, or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

parent

Packit Service fb6fa5

Transient parent of the dialog, or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

flags

Packit Service fb6fa5

from GtkDialogFlags

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

first_button_text

Packit Service fb6fa5

stock ID or text to go in first button, or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Varargs

Packit Service fb6fa5

response ID for first button, then additional buttons, ending with NULL

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

a new GtkDialog

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_run ()

Packit Service fb6fa5
gint
Packit Service fb6fa5
gtk_dialog_run (GtkDialog *dialog);
Packit Service fb6fa5

Blocks in a recursive main loop until the dialog

Packit Service fb6fa5
 either emits the
Packit Service fb6fa5
“response” signal, or is destroyed. If the dialog is 
Packit Service fb6fa5
destroyed during the call to gtk_dialog_run(), gtk_dialog_run() returns 
Packit Service fb6fa5
GTK_RESPONSE_NONE. Otherwise, it returns the response ID from the 
Packit Service fb6fa5
::response signal emission.

Packit Service fb6fa5

Before entering the recursive main loop, gtk_dialog_run() calls

Packit Service fb6fa5
gtk_widget_show() on the dialog for you. Note that you still
Packit Service fb6fa5
need to show any children of the dialog yourself.

Packit Service fb6fa5

During gtk_dialog_run(), the default behavior of “delete-event”

Packit Service fb6fa5
is disabled; if the dialog receives ::delete_event, it will not be
Packit Service fb6fa5
destroyed as windows usually are, and gtk_dialog_run() will return
Packit Service fb6fa5
GTK_RESPONSE_DELETE_EVENT. Also, during gtk_dialog_run() the dialog 
Packit Service fb6fa5
will be modal. You can force gtk_dialog_run() to return at any time by
Packit Service fb6fa5
calling gtk_dialog_response() to emit the ::response signal. Destroying 
Packit Service fb6fa5
the dialog during gtk_dialog_run() is a very bad idea, because your 
Packit Service fb6fa5
post-run code won't know whether the dialog was destroyed or not.

Packit Service fb6fa5

After gtk_dialog_run() returns, you are responsible for hiding or

Packit Service fb6fa5
destroying the dialog if you wish to do so.

Packit Service fb6fa5

Typical usage of this function might be:

Packit Service fb6fa5
Packit Service fb6fa5
  
Packit Service fb6fa5
    
Packit Service fb6fa5
      
Packit Service fb6fa5
        
1
Packit Service fb6fa5
2
Packit Service fb6fa5
3
Packit Service fb6fa5
4
Packit Service fb6fa5
5
Packit Service fb6fa5
6
Packit Service fb6fa5
7
Packit Service fb6fa5
8
Packit Service fb6fa5
9
Packit Service fb6fa5
10
Packit Service fb6fa5
11
Packit Service fb6fa5
        
gint result = gtk_dialog_run (GTK_DIALOG (dialog));
Packit Service fb6fa5
switch (result)
Packit Service fb6fa5
  {
Packit Service fb6fa5
    case GTK_RESPONSE_ACCEPT:
Packit Service fb6fa5
       do_application_specific_something ();
Packit Service fb6fa5
       break;
Packit Service fb6fa5
    default:
Packit Service fb6fa5
       do_nothing_since_dialog_was_cancelled ();
Packit Service fb6fa5
       break;
Packit Service fb6fa5
  }
Packit Service fb6fa5
gtk_widget_destroy (dialog);
Packit Service fb6fa5
      
Packit Service fb6fa5
    
Packit Service fb6fa5
  
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5

Note that even though the recursive main loop gives the effect of a

Packit Service fb6fa5
modal dialog (it prevents the user from interacting with other 
Packit Service fb6fa5
windows in the same window group while the dialog is run), callbacks 
Packit Service fb6fa5
such as timeouts, IO channel watches, DND drops, etc, will 
Packit Service fb6fa5
be triggered during a gtk_dialog_run() call.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

response ID

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_response ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_dialog_response (GtkDialog *dialog,
Packit Service fb6fa5
                     gint response_id);
Packit Service fb6fa5

Emits the “response” signal with the given response ID.

Packit Service fb6fa5
Used to indicate that the user has responded to the dialog in some way;
Packit Service fb6fa5
typically either you or gtk_dialog_run() will be monitoring the
Packit Service fb6fa5
::response signal and take appropriate action.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

response_id

Packit Service fb6fa5

response ID

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_add_button ()

Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
gtk_dialog_add_button (GtkDialog *dialog,
Packit Service fb6fa5
                       const gchar *button_text,
Packit Service fb6fa5
                       gint response_id);
Packit Service fb6fa5

Adds a button with the given text (or a stock button, if button_text

Packit Service fb6fa5
 is a
Packit Service fb6fa5
stock ID) and sets things up so that clicking the button will emit the
Packit Service fb6fa5
“response” signal with the given response_id
Packit Service fb6fa5
. The button is 
Packit Service fb6fa5
appended to the end of the dialog's action area. The button widget is 
Packit Service fb6fa5
returned, but usually you don't need it.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

button_text

Packit Service fb6fa5

text of button, or stock ID

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

response_id

Packit Service fb6fa5

response ID for the button

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

the button widget that was added.

Packit Service fb6fa5

[transfer none]

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_add_buttons ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_dialog_add_buttons (GtkDialog *dialog,
Packit Service fb6fa5
                        const gchar *first_button_text,
Packit Service fb6fa5
                        ...);
Packit Service fb6fa5

Adds more buttons, same as calling gtk_dialog_add_button()

Packit Service fb6fa5
repeatedly.  The variable argument list should be NULL-terminated
Packit Service fb6fa5
as with gtk_dialog_new_with_buttons(). Each button must have both
Packit Service fb6fa5
text and response ID.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

first_button_text

Packit Service fb6fa5

button text or stock ID

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Varargs

Packit Service fb6fa5

response ID for first button, then more text-response_id pairs

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_add_action_widget ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_dialog_add_action_widget (GtkDialog *dialog,
Packit Service fb6fa5
                              GtkWidget *child,
Packit Service fb6fa5
                              gint response_id);
Packit Service fb6fa5

Adds an activatable widget to the action area of a GtkDialog,

Packit Service fb6fa5
connecting a signal handler that will emit the “response” 
Packit Service fb6fa5
signal on the dialog when the widget is activated. The widget is 
Packit Service fb6fa5
appended to the end of the dialog's action area. If you want to add a
Packit Service fb6fa5
non-activatable widget, simply pack it into the action_area
Packit Service fb6fa5
 field 
Packit Service fb6fa5
of the GtkDialog struct.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

child

Packit Service fb6fa5

an activatable widget

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

response_id

Packit Service fb6fa5

response ID for child

Packit Service fb6fa5

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_get_has_separator ()

Packit Service fb6fa5
gboolean
Packit Service fb6fa5
gtk_dialog_get_has_separator (GtkDialog *dialog);
Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_get_has_separator has been deprecated since version 2.22 and should not be used in newly-written code.

Packit Service fb6fa5

This function will be removed in GTK+ 3

Packit Service fb6fa5
Packit Service fb6fa5

Accessor for whether the dialog has a separator.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

TRUE if the dialog has a separator

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_set_default_response ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_dialog_set_default_response (GtkDialog *dialog,
Packit Service fb6fa5
                                 gint response_id);
Packit Service fb6fa5

Sets the last widget in the dialog's action area with the given response_id

Packit Service fb6fa5
Packit Service fb6fa5
as the default widget for the dialog. Pressing "Enter" normally activates
Packit Service fb6fa5
the default widget.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

response_id

Packit Service fb6fa5

a response ID

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_set_has_separator ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_dialog_set_has_separator (GtkDialog *dialog,
Packit Service fb6fa5
                              gboolean setting);
Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_set_has_separator has been deprecated since version 2.22 and should not be used in newly-written code.

Packit Service fb6fa5

This function will be removed in GTK+ 3

Packit Service fb6fa5
Packit Service fb6fa5

Sets whether the dialog has a separator above the buttons.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

setting

Packit Service fb6fa5

TRUE to have a separator

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_set_response_sensitive ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_dialog_set_response_sensitive (GtkDialog *dialog,
Packit Service fb6fa5
                                   gint response_id,
Packit Service fb6fa5
                                   gboolean setting);
Packit Service fb6fa5

Calls gtk_widget_set_sensitive (widget, setting

Packit Service fb6fa5
) 
Packit Service fb6fa5
for each widget in the dialog's action area with the given response_id
Packit Service fb6fa5
.
Packit Service fb6fa5
A convenient way to sensitize/desensitize dialog buttons.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

response_id

Packit Service fb6fa5

a response ID

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

setting

Packit Service fb6fa5

TRUE for sensitive

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_get_response_for_widget ()

Packit Service fb6fa5
gint
Packit Service fb6fa5
gtk_dialog_get_response_for_widget (GtkDialog *dialog,
Packit Service fb6fa5
                                    GtkWidget *widget);
Packit Service fb6fa5

Gets the response id of a widget in the action area

Packit Service fb6fa5
of a dialog.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

widget

Packit Service fb6fa5

a widget in the action area of dialog

Packit Service fb6fa5

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

the response id of widget

Packit Service fb6fa5
, or GTK_RESPONSE_NONE
Packit Service fb6fa5
if widget
Packit Service fb6fa5
doesn't have a response id set.

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.8

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_get_widget_for_response ()

Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
gtk_dialog_get_widget_for_response (GtkDialog *dialog,
Packit Service fb6fa5
                                    gint response_id);
Packit Service fb6fa5

Gets the widget button that uses the given response ID in the action area

Packit Service fb6fa5
of a dialog.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

response_id

Packit Service fb6fa5

the response ID used by the dialog

Packit Service fb6fa5
widget

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

the widget

Packit Service fb6fa5
button that uses the given response_id
Packit Service fb6fa5
, or NULL. 

Packit Service fb6fa5

[transfer none]

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.20

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_get_action_area ()

Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
gtk_dialog_get_action_area (GtkDialog *dialog);
Packit Service fb6fa5

Returns the action area of dialog

Packit Service fb6fa5
.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

the action area.

Packit Service fb6fa5

[transfer none]

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.14

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_get_content_area ()

Packit Service fb6fa5
GtkWidget *
Packit Service fb6fa5
gtk_dialog_get_content_area (GtkDialog *dialog);
Packit Service fb6fa5

Returns the content area of dialog

Packit Service fb6fa5
.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

the content area GtkVBox.

Packit Service fb6fa5

[transfer none]

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.14

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_alternative_dialog_button_order ()

Packit Service fb6fa5
gboolean
Packit Service fb6fa5
gtk_alternative_dialog_button_order (GdkScreen *screen);
Packit Service fb6fa5

Returns TRUE if dialogs are expected to use an alternative

Packit Service fb6fa5
button order on the screen screen
Packit Service fb6fa5
. See
Packit Service fb6fa5
gtk_dialog_set_alternative_button_order() for more details
Packit Service fb6fa5
about alternative button order. 

Packit Service fb6fa5

If you need to use this function, you should probably connect

Packit Service fb6fa5
to the ::notify:gtk-alternative-button-order signal on the
Packit Service fb6fa5
GtkSettings object associated to screen
Packit Service fb6fa5
, in order to be 
Packit Service fb6fa5
notified if the button order setting changes.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

screen

Packit Service fb6fa5

a GdkScreen, or NULL to use the default screen.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

Whether the alternative button order should be used

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.6

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_set_alternative_button_order ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_dialog_set_alternative_button_order
Packit Service fb6fa5
                               (GtkDialog *dialog,
Packit Service fb6fa5
                                gint first_response_id,
Packit Service fb6fa5
                                ...);
Packit Service fb6fa5

Sets an alternative button order. If the

Packit Service fb6fa5
“gtk-alternative-button-order” setting is set to TRUE, 
Packit Service fb6fa5
the dialog buttons are reordered according to the order of the 
Packit Service fb6fa5
response ids passed to this function.

Packit Service fb6fa5

By default, GTK+ dialogs use the button order advocated by the Gnome

Packit Service fb6fa5
Human 
Packit Service fb6fa5
Interface Guidelines with the affirmative button at the far 
Packit Service fb6fa5

right, and the cancel button left of it. But the builtin GTK+ dialogs

Packit Service fb6fa5
and GtkMessageDialogs do provide an alternative button order,
Packit Service fb6fa5
which is more suitable on some platforms, e.g. Windows.

Packit Service fb6fa5

Use this function after adding all the buttons to your dialog, as the

Packit Service fb6fa5
following example shows:

Packit Service fb6fa5
Packit Service fb6fa5
  
Packit Service fb6fa5
    
Packit Service fb6fa5
      
Packit Service fb6fa5
        
1
Packit Service fb6fa5
2
Packit Service fb6fa5
3
Packit Service fb6fa5
4
Packit Service fb6fa5
5
Packit Service fb6fa5
6
Packit Service fb6fa5
7
Packit Service fb6fa5
8
Packit Service fb6fa5
9
Packit Service fb6fa5
10
Packit Service fb6fa5
11
Packit Service fb6fa5
12
Packit Service fb6fa5
13
Packit Service fb6fa5
14
Packit Service fb6fa5
15
Packit Service fb6fa5
16
Packit Service fb6fa5
17
Packit Service fb6fa5
18
Packit Service fb6fa5
19
Packit Service fb6fa5
        
cancel_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
Packit Service fb6fa5
                                       GTK_STOCK_CANCEL,
Packit Service fb6fa5
                                       GTK_RESPONSE_CANCEL);
Packit Service fb6fa5
 
Packit Service fb6fa5
ok_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
Packit Service fb6fa5
                                   GTK_STOCK_OK,
Packit Service fb6fa5
                                   GTK_RESPONSE_OK);
Packit Service fb6fa5
  
Packit Service fb6fa5
gtk_widget_grab_default (ok_button);
Packit Service fb6fa5
  
Packit Service fb6fa5
help_button = gtk_dialog_add_button (GTK_DIALOG (dialog),
Packit Service fb6fa5
                                     GTK_STOCK_HELP,
Packit Service fb6fa5
                                     GTK_RESPONSE_HELP);
Packit Service fb6fa5
 
Packit Service fb6fa5
gtk_dialog_set_alternative_button_order (GTK_DIALOG (dialog),
Packit Service fb6fa5
                                         GTK_RESPONSE_OK,
Packit Service fb6fa5
                                         GTK_RESPONSE_CANCEL,
Packit Service fb6fa5
                                         GTK_RESPONSE_HELP,
Packit Service fb6fa5
                                         -1);
Packit Service fb6fa5
      
Packit Service fb6fa5
    
Packit Service fb6fa5
  
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

first_response_id

Packit Service fb6fa5

a response id used by one dialog

Packit Service fb6fa5
's buttons

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Varargs

Packit Service fb6fa5

a list of more response ids of dialog

Packit Service fb6fa5
's buttons, terminated by -1

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.6

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_dialog_set_alternative_button_order_from_array ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_dialog_set_alternative_button_order_from_array
Packit Service fb6fa5
                               (GtkDialog *dialog,
Packit Service fb6fa5
                                gint n_params,
Packit Service fb6fa5
                                gint *new_order);
Packit Service fb6fa5

Sets an alternative button order. If the

Packit Service fb6fa5
“gtk-alternative-button-order” setting is set to TRUE, 
Packit Service fb6fa5
the dialog buttons are reordered according to the order of the 
Packit Service fb6fa5
response ids in new_order
Packit Service fb6fa5
.

Packit Service fb6fa5

See gtk_dialog_set_alternative_button_order() for more information.

Packit Service fb6fa5

This function is for use by language bindings.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

a GtkDialog

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

n_params

Packit Service fb6fa5

the number of response ids in new_order

Packit Service fb6fa5

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

new_order

Packit Service fb6fa5

an array of response ids of

Packit Service fb6fa5
dialog
Packit Service fb6fa5
's buttons. 

Packit Service fb6fa5
[array length=n_params]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.6

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Types and Values

Packit Service fb6fa5
Packit Service fb6fa5

struct GtkDialog

Packit Service fb6fa5
struct GtkDialog {
Packit Service fb6fa5
  GtkWidget *GSEAL (vbox);
Packit Service fb6fa5
  GtkWidget *GSEAL (action_area);
Packit Service fb6fa5
};
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

enum GtkDialogFlags

Packit Service fb6fa5
Packit Service fb6fa5

Members

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_DIALOG_MODAL

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_DIALOG_DESTROY_WITH_PARENT

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_DIALOG_NO_SEPARATOR

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

enum GtkResponseType

Packit Service fb6fa5
Packit Service fb6fa5

Members

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_RESPONSE_NONE

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_RESPONSE_REJECT

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_RESPONSE_ACCEPT

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_RESPONSE_DELETE_EVENT

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_RESPONSE_OK

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_RESPONSE_CANCEL

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_RESPONSE_CLOSE

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_RESPONSE_YES

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_RESPONSE_NO

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_RESPONSE_APPLY

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GTK_RESPONSE_HELP

Packit Service fb6fa5
 
Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Property Details

Packit Service fb6fa5
Packit Service fb6fa5

The “has-separator” property

Packit Service fb6fa5
  “has-separator”            gboolean
Packit Service fb6fa5

When TRUE, the dialog has a separator bar above its buttons.

Packit Service fb6fa5
Packit Service fb6fa5

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

Packit Service fb6fa5

This property will be removed in GTK+ 3.

Packit Service fb6fa5
Packit Service fb6fa5

Flags: Read / Write

Packit Service fb6fa5

Default value: FALSE

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Style Property Details

Packit Service fb6fa5
Packit Service fb6fa5

The “action-area-border” style property

Packit Service fb6fa5
  “action-area-border”       gint
Packit Service fb6fa5

Width of border around the button area at the bottom of the dialog.

Packit Service fb6fa5

Flags: Read

Packit Service fb6fa5

Allowed values: >= 0

Packit Service fb6fa5

Default value: 5

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

The “button-spacing” style property

Packit Service fb6fa5
  “button-spacing”           gint
Packit Service fb6fa5

Spacing between buttons.

Packit Service fb6fa5

Flags: Read

Packit Service fb6fa5

Allowed values: >= 0

Packit Service fb6fa5

Default value: 6

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

The “content-area-border” style property

Packit Service fb6fa5
  “content-area-border”      gint
Packit Service fb6fa5

Width of border around the main dialog area.

Packit Service fb6fa5

Flags: Read

Packit Service fb6fa5

Allowed values: >= 0

Packit Service fb6fa5

Default value: 2

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

The “content-area-spacing” style property

Packit Service fb6fa5
  “content-area-spacing”     gint
Packit Service fb6fa5

The default spacing used between elements of the

Packit Service fb6fa5
content area of the dialog, as returned by
Packit Service fb6fa5
gtk_dialog_get_content_area(), unless gtk_box_set_spacing()
Packit Service fb6fa5
was called on that widget directly.

Packit Service fb6fa5

Flags: Read

Packit Service fb6fa5

Allowed values: >= 0

Packit Service fb6fa5

Default value: 0

Packit Service fb6fa5

Since: 2.16

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Signal Details

Packit Service fb6fa5
Packit Service fb6fa5

The “close” signal

Packit Service fb6fa5
void
Packit Service fb6fa5
user_function (GtkDialog *dialog,
Packit Service fb6fa5
               gpointer   user_data)
Packit Service fb6fa5

The ::close signal is a

Packit Service fb6fa5
keybinding signal

which gets emitted when the user uses a keybinding to close

Packit Service fb6fa5
the dialog.

Packit Service fb6fa5

The default binding for this signal is the Escape key.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

user_data

Packit Service fb6fa5

user data set when the signal handler was connected.

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Flags: Action

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

The “response” signal

Packit Service fb6fa5
void
Packit Service fb6fa5
user_function (GtkDialog *dialog,
Packit Service fb6fa5
               gint       response_id,
Packit Service fb6fa5
               gpointer   user_data)
Packit Service fb6fa5

Emitted when an action widget is clicked, the dialog receives a

Packit Service fb6fa5
Packit Service fb6fa5
delete event, or the application programmer calls gtk_dialog_response().
Packit Service fb6fa5
Packit Service fb6fa5
On a delete event, the response ID is GTK_RESPONSE_DELETE_EVENT.
Packit Service fb6fa5
Packit Service fb6fa5
Otherwise, it depends on which action widget was clicked.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

dialog

Packit Service fb6fa5

the object on which the signal is emitted

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

response_id

Packit Service fb6fa5

the response ID

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

user_data

Packit Service fb6fa5

user data set when the signal handler was connected.

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Flags: Run Last

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Generated by GTK-Doc V1.26.1
Packit Service fb6fa5
</body>
Packit Service fb6fa5
</html>