Commit 37a8ee6e authored by William Jon McCann's avatar William Jon McCann

docs: fully break lines in examples

Try to do a better job of keeping example content
from being too wide. It is often rendered as <pre>
text so the only time we can wrap it is in the source.

It is best to full break lines at all punctuation and
to try to keep the width under 70 chars or so.
parent 74c48203
......@@ -1654,7 +1654,8 @@ gtk_about_dialog_get_translator_credits (GtkAboutDialog *about)
* Using gettext(), a simple way to achieve that is to mark the
* string for translation:
* |[<!-- language="C" -->
* gtk_about_dialog_set_translator_credits (about, _("translator-credits"));
* gtk_about_dialog_set_translator_credits (about,
* _("translator-credits"));
* ]|
* It is a good idea to use the customary msgid “translator-credits” for this
* purpose, since translators will already know the purpose of that msgid, and
......
......@@ -56,8 +56,8 @@ G_BEGIN_DECLS
*/
typedef enum
{
GTK_ACCEL_VISIBLE = 1 << 0, /* display in GtkAccelLabel? */
GTK_ACCEL_LOCKED = 1 << 1, /* is it removable? */
GTK_ACCEL_VISIBLE = 1 << 0,
GTK_ACCEL_LOCKED = 1 << 1,
GTK_ACCEL_MASK = 0x07
} GtkAccelFlags;
......
......@@ -56,7 +56,7 @@
* @get_action_name: virtual pointer for gtk_actionable_get_action_name()
* @set_action_name: virtual pointer for gtk_actionable_set_action_name()
* @get_action_target_value: virtual pointer for gtk_actionable_get_action_target_value()
* @set_action_target_value: virtual pointer for gtk_actionable_set_action_target_value
* @set_action_target_value: virtual pointer for gtk_actionable_set_action_target_value()
*
* The interface vtable for #GtkActionable.
**/
......
......@@ -93,8 +93,11 @@
* " </submenu>"
* " </menu>"
* "</interface>");
*
* menubar = G_MENU_MODEL (gtk_builder_get_object (builder,
* "menubar"));
* gtk_application_set_menubar (G_APPLICATION (app),
* G_MENU_MODEL (gtk_builder_get_object (builder, "menubar")));
* menubar);
* g_object_unref (builder);
*
* ...
......
......@@ -109,21 +109,30 @@
*
* |[<!-- language="C" -->
* static void
* foo_container_get_preferred_height (GtkWidget *widget, gint *min_height, gint *nat_height)
* foo_container_get_preferred_height (GtkWidget *widget,
* gint *min_height,
* gint *nat_height)
* {
* if (i_am_in_height_for_width_mode)
* {
* gint min_width;
*
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget, &min_width, NULL);
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_height_for_width (widget, min_width,
* min_height, nat_height);
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget,
* &min_width,
* NULL);
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_height_for_width
* (widget,
* min_width,
* min_height,
* nat_height);
* }
* else
* {
* ... many containers support both request modes, execute the real width-for-height
* request here by returning the collective heights of all widgets that are
* stacked vertically (or whatever is appropriate for this container) ...
* ... many containers support both request modes, execute the
* real width-for-height request here by returning the
* collective heights of all widgets that are stacked
* vertically (or whatever is appropriate for this container)
* ...
* }
* }
* ]|
......@@ -133,17 +142,22 @@
*
* |[<!-- language="C" -->
* static void
* foo_container_get_preferred_width_for_height (GtkWidget *widget, gint for_height,
* gint *min_width, gint *nat_width)
* foo_container_get_preferred_width_for_height (GtkWidget *widget,
* gint for_height,
* gint *min_width,
* gint *nat_width)
* {
* if (i_am_in_height_for_width_mode)
* {
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget, min_width, nat_width);
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget,
* min_width,
* nat_width);
* }
* else
* {
* ... execute the real width-for-height request here based on the required width
* of the children collectively if the container were to be allocated the said height ...
* ... execute the real width-for-height request here based on
* the required width of the children collectively if the
* container were to be allocated the said height ...
* }
* }
* ]|
......
......@@ -100,29 +100,33 @@
*
* An example for simple GtkDialog usage:
* |[<!-- language="C" -->
* /&ast; Function to open a dialog box displaying the message provided. &ast;/
* /&ast; Function to open a dialog box with a message &ast;/
* void
* quick_message (gchar *message)
* quick_message (GtkWindow *parent, gchar *message)
* {
* GtkWidget *dialog, *label, *content_area;
* GtkDialogFlags flags;
*
* /&ast; Create the widgets &ast;/
* flags = GTK_DIALOG_DESTROY_WITH_PARENT;
* dialog = gtk_dialog_new_with_buttons ("Message",
* main_application_window,
* GTK_DIALOG_DESTROY_WITH_PARENT,
* parent,
* flags,
* _("_OK"),
* GTK_RESPONSE_NONE,
* NULL);
* content_area = gtk_dialog_get_content_area (GTK_DIALOG (dialog));
* label = gtk_label_new (message);
*
* /&ast; Ensure that the dialog box is destroyed when the user responds &ast;/
* /&ast; Ensure that the dialog box is destroyed when the user
* responds &ast;/
*
* g_signal_connect_swapped (dialog,
* "response",
* G_CALLBACK (gtk_widget_destroy),
* dialog);
*
* /&ast; Add the label, and show everything we’ve added to the dialog &ast;/
* /&ast; Add the label, and show everything we’ve added &ast;/
*
* gtk_container_add (GTK_CONTAINER (content_area), label);
* gtk_widget_show_all (dialog);
......@@ -860,9 +864,11 @@ gtk_dialog_new_empty (const gchar *title,
*
* Here’s a simple example:
* |[<!-- language="C" -->
* GtkWidget *dialog = gtk_dialog_new_with_buttons ("My dialog",
* GtkWidget *dialog;
* GtkDialogFlags flags = GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT;
* dialog = gtk_dialog_new_with_buttons ("My dialog",
* main_app_window,
* GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT,
* flags,
* _("_OK"),
* GTK_RESPONSE_ACCEPT,
* _("_Cancel"),
......
......@@ -60,9 +60,9 @@ G_BEGIN_DECLS
* of the user for a drag destination site.
*/
typedef enum {
GTK_DEST_DEFAULT_MOTION = 1 << 0, /* respond to "drag_motion" */
GTK_DEST_DEFAULT_HIGHLIGHT = 1 << 1, /* auto-highlight */
GTK_DEST_DEFAULT_DROP = 1 << 2, /* respond to "drag_drop" */
GTK_DEST_DEFAULT_MOTION = 1 << 0,
GTK_DEST_DEFAULT_HIGHLIGHT = 1 << 1,
GTK_DEST_DEFAULT_DROP = 1 << 2,
GTK_DEST_DEFAULT_ALL = 0x07
} GtkDestDefaults;
......
......@@ -7737,7 +7737,9 @@ gtk_entry_get_overwrite_mode (GtkEntry *entry)
* This is equivalent to:
*
* |[<!-- language="C" -->
* gtk_entry_buffer_get_text (gtk_entry_get_buffer (entry));
* GtkEntryBuffer *buffer;
* buffer = gtk_entry_get_buffer (entry);
* gtk_entry_buffer_get_text (buffer);
* ]|
*
* Return value: a pointer to the contents of the widget as a
......@@ -7767,7 +7769,9 @@ gtk_entry_get_text (GtkEntry *entry)
* This is equivalent to:
*
* |[<!-- language="C" -->
* gtk_entry_buffer_set_max_length (gtk_entry_get_buffer (entry), max);
* GtkEntryBuffer *buffer;
* buffer = gtk_entry_get_buffer (entry);
* gtk_entry_buffer_set_max_length (buffer, max);
* ]|
**/
void
......@@ -7788,7 +7792,9 @@ gtk_entry_set_max_length (GtkEntry *entry,
* This is equivalent to:
*
* |[<!-- language="C" -->
* gtk_entry_buffer_get_max_length (gtk_entry_get_buffer (entry));
* GtkEntryBuffer *buffer;
* buffer = gtk_entry_get_buffer (entry);
* gtk_entry_buffer_get_max_length (buffer);
* ]|
*
* Return value: the maximum allowed number of characters
......@@ -7812,7 +7818,9 @@ gtk_entry_get_max_length (GtkEntry *entry)
* This is equivalent to:
*
* |[<!-- language="C" -->
* gtk_entry_buffer_get_length (gtk_entry_get_buffer (entry));
* GtkEntryBuffer *buffer;
* buffer = gtk_entry_get_buffer (entry);
* gtk_entry_buffer_get_length (buffer);
* ]|
*
* Return value: the current number of characters
......
......@@ -200,15 +200,13 @@ typedef enum
typedef enum
{
GTK_DELETE_CHARS,
GTK_DELETE_WORD_ENDS, /* delete only the portion of the word to the
* left/right of cursor if we're in the middle
* of a word */
GTK_DELETE_WORD_ENDS,
GTK_DELETE_WORDS,
GTK_DELETE_DISPLAY_LINES,
GTK_DELETE_DISPLAY_LINE_ENDS,
GTK_DELETE_PARAGRAPH_ENDS, /* like C-k in Emacs (or its reverse) */
GTK_DELETE_PARAGRAPHS, /* C-k in pico, kill whole line */
GTK_DELETE_WHITESPACE /* M-\ in Emacs */
GTK_DELETE_PARAGRAPH_ENDS,
GTK_DELETE_PARAGRAPHS,
GTK_DELETE_WHITESPACE
} GtkDeleteType;
/* Focus movement types */
......
......@@ -59,19 +59,24 @@
*
* |[
* GtkWidget *dialog;
* GtkFileChooserAction action = GTK_FILE_CHOOSER_ACTION_OPEN;
* gint res;
*
* dialog = gtk_file_chooser_dialog_new ("Open File",
* parent_window,
* GTK_FILE_CHOOSER_ACTION_OPEN,
* _("_Cancel"), GTK_RESPONSE_CANCEL,
* _("_Open"), GTK_RESPONSE_ACCEPT,
* action,
* _("_Cancel"),
* GTK_RESPONSE_CANCEL,
* _("_Open"),
* GTK_RESPONSE_ACCEPT,
* NULL);
*
* if (gtk_dialog_run (GTK_DIALOG (dialog)) == GTK_RESPONSE_ACCEPT)
* res = gtk_dialog_run (GTK_DIALOG (dialog));
* if (res == GTK_RESPONSE_ACCEPT)
* {
* char *filename;
*
* filename = gtk_file_chooser_get_filename (GTK_FILE_CHOOSER (dialog));
* GtkFileChooser *chooser = GTK_FILE_CHOOSER (dialog);
* filename = gtk_file_chooser_get_filename (chooser);
* open_file (filename);
* g_free (filename);
* }
......@@ -83,25 +88,35 @@
*
* |[
* GtkWidget *dialog;
* GtkFileChooser *chooser;
* GtkFileChooserAction action = GTK_FILE_CHOOSER_ACTION_SAVE;
* gint res;
*
* dialog = gtk_file_chooser_dialog_new ("Save File",
* parent_window,
* GTK_FILE_CHOOSER_ACTION_SAVE,
* _("_Cancel"), GTK_RESPONSE_CANCEL,
* _("_Save"), GTK_RESPONSE_ACCEPT,
* action,
* _("_Cancel"),
* GTK_RESPONSE_CANCEL,
* _("_Save"),
* GTK_RESPONSE_ACCEPT,
* NULL);
* gtk_file_chooser_set_do_overwrite_confirmation (GTK_FILE_CHOOSER (dialog), TRUE);
* chooser = GTK_FILE_CHOOSER (dialog);
*
* gtk_file_chooser_set_do_overwrite_confirmation (chooser, TRUE);
*
* if (user_edited_a_new_document)
* gtk_file_chooser_set_current_name (GTK_FILE_CHOOSER (dialog), "Untitled document");
* gtk_file_chooser_set_current_name (chooser,
* _("Untitled document"));
* else
* gtk_file_chooser_set_filename (GTK_FILE_CHOOSER (dialog), filename_for_existing_document);
* gtk_file_chooser_set_filename (chooser,
* existing_filename);
*
* if (gtk_dialog_run (GTK_DIALOG (dialog)) == GTK_RESPONSE_ACCEPT)
* res = gtk_dialog_run (GTK_DIALOG (dialog));
* if (res == GTK_RESPONSE_ACCEPT)
* {
* char *filename;
*
* filename = gtk_file_chooser_get_filename (GTK_FILE_CHOOSER (dialog));
* filename = gtk_file_chooser_get_filename (chooser);
* save_to_file (filename);
* g_free (filename);
* }
......@@ -143,12 +158,15 @@
*
* |[
* GtkWidget *dialog;
* GtkFileChooserAction action = GTK_FILE_CHOOSER_ACTION_OPEN;
*
* dialog = gtk_file_chooser_dialog_new ("Open File",
* parent_window,
* GTK_FILE_CHOOSER_ACTION_OPEN,
* _("_Cancel"), GTK_RESPONSE_CANCEL,
* _("_Open"), GTK_RESPONSE_ACCEPT,
* action,
* _("_Cancel"),
* GTK_RESPONSE_CANCEL,
* _("_Open"),
* GTK_RESPONSE_ACCEPT,
* NULL);
* ]|
*
......
......@@ -66,7 +66,8 @@ struct _GtkFrameClass
/*< public >*/
void (*compute_child_allocation) (GtkFrame *frame, GtkAllocation *allocation);
void (*compute_child_allocation) (GtkFrame *frame,
GtkAllocation *allocation);
/*< private >*/
......
......@@ -86,10 +86,11 @@
* g_print ("Event box clicked at coordinates %f,%f\n",
* event->x, event->y);
*
* /&ast; Returning TRUE means we handled the event, so the signal
* &ast; emission should be stopped (don’t call any further
* &ast; callbacks that may be connected). Return FALSE
* &ast; to continue invoking callbacks.
* /&ast; Returning TRUE means we handled the event,
* &ast; so the signal emission should be stopped
* &ast; (don’t call any further callbacks that
* &ast; may be connected). Return FALSE to
* &ast; continue invoking callbacks.
* &ast;/
* return TRUE;
* }
......
......@@ -75,27 +75,36 @@
* A simple example for using a GtkInfoBar:
* |[<!-- language="C" -->
* /&ast; set up info bar &ast;/
* info_bar = gtk_info_bar_new ();
* gtk_widget_set_no_show_all (info_bar, TRUE);
* GtkWidget *widget;
* GtkInfoBar *bar;
*
* widget = gtk_info_bar_new ();
* bar = GTK_INFO_BAR (bar);
*
* gtk_widget_set_no_show_all (widget, TRUE);
* message_label = gtk_label_new ("");
* gtk_widget_show (message_label);
* content_area = gtk_info_bar_get_content_area (GTK_INFO_BAR (info_bar));
* gtk_container_add (GTK_CONTAINER (content_area), message_label);
* gtk_info_bar_add_button (GTK_INFO_BAR (info_bar),
* _("_OK"), GTK_RESPONSE_OK);
* g_signal_connect (info_bar, "response",
* G_CALLBACK (gtk_widget_hide), NULL);
* content_area = gtk_info_bar_get_content_area (bar);
* gtk_container_add (GTK_CONTAINER (content_area),
* message_label);
* gtk_info_bar_add_button (bar,
* _("_OK"),
* GTK_RESPONSE_OK);
* g_signal_connect (bar,
* "response",
* G_CALLBACK (gtk_widget_hide),
* NULL);
* gtk_grid_attach (GTK_GRID (grid),
* info_bar,
* widget,
* 0, 2, 1, 1);
*
* /&ast; ... &ast;/
*
* /&ast; show an error message &ast;/
* gtk_label_set_text (GTK_LABEL (message_label), error_message);
* gtk_info_bar_set_message_type (GTK_INFO_BAR (info_bar),
* gtk_label_set_text (GTK_LABEL (message_label), message);
* gtk_info_bar_set_message_type (bar,
* GTK_MESSAGE_ERROR);
* gtk_widget_show (info_bar);
* gtk_widget_show (bar);
* ]|
*
* # GtkInfoBar as GtkBuildable
......
......@@ -207,7 +207,11 @@
* An example looks like this:
*
* |[<!-- language="C" -->
* gtk_label_set_markup (label, "Go to the <a href=\"http://www.gtk.org title="&lt;i&gt;Our&lt;/i&gt; website\">GTK+ website</a> for more...");
* const gchar *text =
* "Go to the"
* "<a href=\"http://www.gtk.org title="&lt;i&gt;Our&lt;/i&gt; website\">"
* "GTK+ website</a> for more...";
* gtk_label_set_markup (label, text);
* ]|
*
* It is possible to implement custom handling for links and their tooltips with
......@@ -2601,9 +2605,10 @@ gtk_label_set_markup_internal (GtkLabel *label,
* external data, you may need to escape it with g_markup_escape_text() or
* g_markup_printf_escaped():
* |[<!-- language="C" -->
* const char *format = "<span style=\"italic\">\%s</span>";
* char *markup;
*
* markup = g_markup_printf_escaped ("<span style=\"italic\">\%s</span>", str);
* markup = g_markup_printf_escaped (format, str);
* gtk_label_set_markup (GTK_LABEL (label), markup);
* g_free (markup);
* ]|
......
......@@ -40,19 +40,25 @@
* static GtkWidget *
* create_level_bar (void)
* {
* GtkWidget *level_bar;
* GtkWidget *widget;
* GtkLevelBar *bar;
*
* level_bar = gtk_level_bar_new ();
* widget = gtk_level_bar_new ();
* bar = GTK_LEVEL_BAR (widget);
*
* /<!---->* This changes the value of the default low offset *<!---->/
* gtk_level_bar_add_offset_value (GTK_LEVEL_BAR (level_bar),
* GTK_LEVEL_BAR_OFFSET_LOW, 0.10);
* /<!---->* This changes the value of the default low offset
* *<!---->/
*
* gtk_level_bar_add_offset_value (bar,
* GTK_LEVEL_BAR_OFFSET_LOW,
* 0.10);
*
* /<!---->* This adds a new offset to the bar; the application will
* * be able to change its color by using the following selector,
* * either by adding it to its CSS file or using
* * gtk_css_provider_load_from_data() and gtk_style_context_add_provider()
* *
* be able to change its color by using the following selector,
* either by adding it to its CSS file or using
* gtk_css_provider_load_from_data() and
* gtk_style_context_add_provider()
*
* * .level-bar.fill-block.level-my-offset {
* * background-color: green;
* * border-style: solid;
......@@ -60,10 +66,10 @@
* * border-style: 1px;
* * }
* *<!---->/
* gtk_level_bar_add_offset_value (GTK_LEVEL_BAR (level_bar),
* "my-offset", 0.60);
*
* return level_bar;
* gtk_level_bar_add_offset_value (bar, "my-offset", 0.60);
*
* return widget;
* }
* ]|
*
......
......@@ -87,8 +87,8 @@
* COLUMN_BOOLEAN, FALSE,
* -1);
*
* /&ast; As the store will keep a copy of the string internally,
* &ast; we free some_data.
* /&ast; As the store will keep a copy of
* &ast; the string internally, we free some_data.
* &ast;/
* g_free (some_data);
* }
......
......@@ -59,7 +59,8 @@
* int
* main (int argc, char **argv)
* {
* /&ast; Initialize i18n support with bindtextdomain(), etc. &ast;/
* /&ast; Initialize i18n support with
* bindtextdomain(), etc. &ast;/
* ...
*
* /&ast; Initialize the widget set &ast;/
......@@ -74,7 +75,8 @@
* /&ast; Show the application window &ast;/
* gtk_widget_show_all (mainwin);
*
* /&ast; Enter the main event loop, and wait for user interaction &ast;/
* /&ast; Enter the main event loop, and
* wait for user interaction &ast;/
* gtk_main ();
*
* /&ast; The user lost interest &ast;/
......@@ -1811,18 +1813,23 @@ gtk_main_do_event (GdkEvent *event)
* main (int argc, char **argv)
* {
* GtkWidget *win, *but;
* const char *text = "Close yourself. I mean it!";
*
* gtk_init (&argc, &argv);
*
* win = gtk_window_new (GTK_WINDOW_TOPLEVEL);
* g_signal_connect (win, "delete-event",
* G_CALLBACK (gtk_true), NULL);
* g_signal_connect (win,
* "delete-event",
* G_CALLBACK (gtk_true),
* NULL);
* g_signal_connect (win, "destroy",
* G_CALLBACK (gtk_main_quit), NULL);
* G_CALLBACK (gtk_main_quit),
* NULL);
*
* but = gtk_button_new_with_label ("Close yourself. I mean it!");
* but = gtk_button_new_with_label (text);
* g_signal_connect_swapped (but, "clicked",
* G_CALLBACK (gtk_object_destroy), win);
* G_CALLBACK (gtk_object_destroy),
* win);
* gtk_container_add (GTK_CONTAINER (win), but);
*
* gtk_widget_show_all (win);
......
......@@ -60,12 +60,14 @@
*
* An example for using a modal dialog:
* |[<!-- language="C" -->
* dialog = gtk_message_dialog_new (main_application_window,
* GTK_DIALOG_DESTROY_WITH_PARENT,
* GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT;
* dialog = gtk_message_dialog_new (parent_window,
* flags,
* GTK_MESSAGE_ERROR,
* GTK_BUTTONS_CLOSE,
* "Error loading file '%s': %s",
* filename, g_strerror (errno));
* "Error reading “%s”: %s",
* filename,
* g_strerror (errno));
* gtk_dialog_run (GTK_DIALOG (dialog));
* gtk_widget_destroy (dialog);
* ]|
......@@ -74,14 +76,18 @@
*
* An example for a non-modal dialog:
* |[<!-- language="C" -->
* dialog = gtk_message_dialog_new (main_application_window,
* GTK_DIALOG_DESTROY_WITH_PARENT,
* GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT;
* dialog = gtk_message_dialog_new (parent_window,
* flags,
* GTK_MESSAGE_ERROR,
* GTK_BUTTONS_CLOSE,
* "Error loading file '%s': %s",
* filename, g_strerror (errno));
* "Error reading “%s”: %s",
* filename,
* g_strerror (errno));
*
* /&ast; Destroy the dialog when the user responds to it
* (e.g. clicks a button) &ast;/
*
* /&ast; Destroy the dialog when the user responds to it (e.g. clicks a button) &ast;/
* g_signal_connect_swapped (dialog, "response",
* G_CALLBACK (gtk_widget_destroy),
* dialog);
......@@ -608,8 +614,9 @@ gtk_message_dialog_new (GtkWindow *parent,
* argument.
* |[<!-- language="C" -->
* GtkWidget *dialog;
* dialog = gtk_message_dialog_new (main_application_window,
* GTK_DIALOG_DESTROY_WITH_PARENT,
* GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT;
* dialog = gtk_message_dialog_new (parent_window,
* flags,
* GTK_MESSAGE_ERROR,
* GTK_BUTTONS_CLOSE,
* NULL);
......@@ -799,7 +806,8 @@ gtk_message_dialog_format_secondary_text (GtkMessageDialog *message_dialog,
* gchar *msg;
*
* msg = g_markup_printf_escaped (message_format, ...);
* gtk_message_dialog_format_secondary_markup (message_dialog, "%s", msg);
* gtk_message_dialog_format_secondary_markup (message_dialog,
* "%s", msg);
* g_free (msg);
* ]|
*
......
......@@ -8397,23 +8397,25 @@ gtk_notebook_get_tab_detachable (GtkNotebook *notebook,
* widget that corresponds to the dropped tab.
* |[<!-- language="C" -->
* static void
* on_drop_zone_drag_data_received (GtkWidget *widget,
* on_drag_data_received (GtkWidget *widget,
* GdkDragContext *context,
* gint x,
* gint y,
* GtkSelectionData *selection_data,
* GtkSelectionData *data,
* guint info,
* guint time,
* gpointer user_data)
* {
* GtkWidget *notebook;
* GtkWidget **child;
* GtkContainer *container;
*
* notebook = gtk_drag_get_source_widget (context);
* child = (void*) gtk_selection_data_get_data (selection_data);
* child = (void*) gtk_selection_data_get_data (data);
*
* process_widget (*child);
* gtk_container_remove (GTK_CONTAINER (notebook), *child);
* container = GTK_CONTAINER (notebook);
* gtk_container_remove (container, *child);
* }
* ]|
*
......
......@@ -51,18 +51,23 @@
*
* |[<!-- language="C" -->
* GtkWidget *dialog;
* gint res;
*
* dialog = gtk_recent_chooser_dialog_new ("Recent Documents",
* parent_window,
* _("_Cancel"), GTK_RESPONSE_CANCEL,
* _("_Open"), GTK_RESPONSE_ACCEPT,
* _("_Cancel"),
* GTK_RESPONSE_CANCEL,
* _("_Open"),
* GTK_RESPONSE_ACCEPT,
* NULL);
*
* if (gtk_dialog_run (GTK_DIALOG (dialog)) == GTK_RESPONSE_ACCEPT)
* res = gtk_dialog_run (GTK_DIALOG (dialog));
* if (res == GTK_RESPONSE_ACCEPT)
* {
* GtkRecentInfo *info;
* GtkRecentChooser *chooser = GTK_RECENT_CHOOSER (dialog);
*
* info = gtk_recent_chooser_get_current_item (GTK_RECENT_CHOOSER (dialog));
* info = gtk_recent_chooser_get_current_item (chooser);
* open_file (gtk_recent_info_get_uri (info));
* gtk_recent_info_unref (info);
* }
......
......@@ -165,15 +165,18 @@ preedit_changed_cb (GtkEntry *entry,
*
* |[<!-- language="C" -->
* static gboolean
* window_key_press_event_cb (GtkWidget *widget,
* on_key_press_event (GtkWidget *widget,
* GdkEvent *event,
* gpointer user_data)
* {
* return gtk_search_bar_handle_event (GTK_SEARCH_BAR (user_data), event);
* GtkSearchBar *bar = GTK_SEARCH_BAR (user_data);
* return gtk_search_bar_handle_event (bar, event);
* }
*
* g_signal_connect (window, "key-press-event",
* G_CALLBACK (window_key_press_event_cb), search_bar);
* g_signal_connect (window,
* "key-press-event",
* G_CALLBACK (on_key_press_event),
* search_bar);
* ]|
*
* Return value: %GDK_EVENT_STOP if the key press event resulted
......
......@@ -63,23 +63,33 @@
* |[<!-- language="C" -->
* void make_toggles (void) {
* GtkWidget *dialog, *toggle1, *toggle2;
* GtkWidget *content_area;
* const char *text;
*
* dialog = gtk_dialog_new ();
* toggle1 = gtk_toggle_button_new_with_label ("Hi, i’m a toggle button.");
* dialog = gtk_dialog_new (text);
* content_area = gtk_dialog_get_content_area ();
*
* text = "Hi, i’m a toggle button.";
* toggle1 = gtk_toggle_button_new_with_label (text);
*
* /&ast; Makes this toggle button invisible &ast;/
* gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle1), TRUE);
* gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle1),
* TRUE);
*
* g_signal_connect (toggle1, "toggled",
* G_CALLBACK (output_state), NULL);
* gtk_box_pack_start (GTK_BOX (GTK_DIALOG (dialog)->action_area),
* G_CALLBACK (output_state),
* NULL);
* gtk_box_pack_start (GTK_BOX (content_area),
* toggle1, FALSE, FALSE, 2);
*
* toggle2 = gtk_toggle_button_new_with_label ("Hi, i’m another toggle button.");
* gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle2), FALSE);
* text = "Hi, i’m a toggle button.";
* toggle2 = gtk_toggle_button_new_with_label (text);
* gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle2),
* FALSE);
* g_signal_connect (toggle2, "toggled",
* G_CALLBACK (output_state), NULL);
* gtk_box_pack_start (GTK_BOX (GTK_DIALOG (dialog)->action_area),
* G_CALLBACK (output_state),
* NULL);
* gtk_box_pack_start (GTK_BOX (content_area),
* toggle2, FALSE, FALSE, 2);
*
* gtk_widget_show_all (dialog);
......
......@@ -116,13 +116,16 @@
* ## Acquiring a #GtkTreeIter-struct
*
* |[<!-- language="C" -->
* /&ast; Three ways of getting the iter pointing to the location &ast;/
* /&ast; Three ways of getting the iter pointing to the
* location &ast;/
* GtkTreePath *path;
* GtkTreeIter iter;
* GtkTreeIter parent_iter;
*
* /&ast; get the iterator from a string &ast;/
* gtk_tree_model_get_iter_from_string (model, &iter, "3:2:5");
* gtk_tree_model_get_iter_from_string (model,
* &iter,
* "3:2:5");
*
* /&ast; get the iterator from a path &ast;/
* path = gtk_tree_path_new_from_string ("3:2:5");
......@@ -130,11 +133,14 @@
* gtk_tree_path_free (path);
*
* /&ast; walk the tree to find the iterator &ast;/
* gtk_tree_model_iter_nth_child (model, &iter, NULL, 3);
* gtk_tree_model_iter_nth_child (model, &iter,
* NULL, 3);
* parent_iter = iter;
* gtk_tree_model_iter_nth_child (model, &iter, &parent_iter, 2);
* gtk_tree_model_iter_nth_child (model, &iter,
* &parent_iter, 2);
* parent_iter = iter;
* gtk_tree_model_iter_nth_child (model, &iter, &parent_iter, 5);
* gtk_tree_model_iter_nth_child (model, &iter,
* &parent_iter, 5);