callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: fully break lines in examples

Browse Source 
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.
This commit is contained in:
William Jon McCann 2014-02-12 16:09:09 -05:00
parent 74c48203f0
commit 37a8ee6e95
25 changed files with 349 additions and 219 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
gtk/gtkaboutdialog.c
View File

@ -1654,7 +1654,8 @@ gtk_about_dialog_get_translator_credits (GtkAboutDialog *about)
* Using gettext(), a simple way to achieve that is to mark the * Using gettext(), a simple way to achieve that is to mark the
* string for translation: * string for translation:
* |[<!-- language="C" --> * |[<!-- 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 * 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 * purpose, since translators will already know the purpose of that msgid, and

4
gtk/gtkaccelgroup.h
View File

@ -56,8 +56,8 @@ G_BEGIN_DECLS
*/ */
typedef enum typedef enum
{ {
GTK_ACCEL_VISIBLE = 1 << 0, /* display in GtkAccelLabel? */ GTK_ACCEL_VISIBLE = 1 << 0,
GTK_ACCEL_LOCKED = 1 << 1, /* is it removable? */ GTK_ACCEL_LOCKED = 1 << 1,
GTK_ACCEL_MASK = 0x07 GTK_ACCEL_MASK = 0x07
} GtkAccelFlags; } GtkAccelFlags;

2
gtk/gtkactionable.c
View File

@ -56,7 +56,7 @@
* @get_action_name: virtual pointer for gtk_actionable_get_action_name() * @get_action_name: virtual pointer for gtk_actionable_get_action_name()
* @set_action_name: virtual pointer for gtk_actionable_set_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() * @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. * The interface vtable for #GtkActionable.
**/ **/

5
gtk/gtkapplicationwindow.c
View File

@ -93,8 +93,11 @@
* " </submenu>" * " </submenu>"
* " </menu>" * " </menu>"
* "</interface>"); * "</interface>");
*
* menubar = G_MENU_MODEL (gtk_builder_get_object (builder,
* "menubar"));
* gtk_application_set_menubar (G_APPLICATION (app), * gtk_application_set_menubar (G_APPLICATION (app),
* G_MENU_MODEL (gtk_builder_get_object (builder, "menubar"))); * menubar);
* g_object_unref (builder); * g_object_unref (builder);
* *
* ... * ...

38
gtk/gtkcontainer.c
View File

@ -109,21 +109,30 @@
* *
* |[<!-- language="C" --> * |[<!-- language="C" -->
* static void * 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) * if (i_am_in_height_for_width_mode)
* { * {
* gint min_width; * gint min_width;
* *
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget, &min_width, NULL); * GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget,
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_height_for_width (widget, min_width, * &min_width,
* min_height, nat_height); * NULL);
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_height_for_width
* (widget,
* min_width,
* min_height,
* nat_height);
* } * }
* else * else
* { * {
* ... many containers support both request modes, execute the real width-for-height * ... many containers support both request modes, execute the
* request here by returning the collective heights of all widgets that are * real width-for-height request here by returning the
* stacked vertically (or whatever is appropriate for this container) ... * collective heights of all widgets that are stacked
* vertically (or whatever is appropriate for this container)
* ...
* } * }
* } * }
* ]| * ]|
@ -133,17 +142,22 @@
* *
* |[<!-- language="C" --> * |[<!-- language="C" -->
* static void * static void
* foo_container_get_preferred_width_for_height (GtkWidget *widget, gint for_height, * foo_container_get_preferred_width_for_height (GtkWidget *widget,
* gint *min_width, gint *nat_width) * gint for_height,
* gint *min_width,
* gint *nat_width)
* { * {
* if (i_am_in_height_for_width_mode) * 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 * else
* { * {
* ... execute the real width-for-height request here based on the required width * ... execute the real width-for-height request here based on
* of the children collectively if the container were to be allocated the said height ... * the required width of the children collectively if the
* container were to be allocated the said height ...
* } * }
* } * }
* ]| * ]|

62
gtk/gtkdialog.c
View File

@ -100,32 +100,36 @@
* *
* An example for simple GtkDialog usage: * An example for simple GtkDialog usage:
* |[<!-- language="C" --> * |[<!-- 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 * void
* quick_message (gchar *message) * quick_message (GtkWindow *parent, gchar *message)
* { * {
* GtkWidget *dialog, *label, *content_area; * GtkWidget *dialog, *label, *content_area;
* GtkDialogFlags flags;
* *
* /&ast; Create the widgets &ast;/ * /&ast; Create the widgets &ast;/
* dialog = gtk_dialog_new_with_buttons ("Message", * flags = GTK_DIALOG_DESTROY_WITH_PARENT;
* main_application_window, * dialog = gtk_dialog_new_with_buttons ("Message",
* GTK_DIALOG_DESTROY_WITH_PARENT, * parent,
* _("_OK"), * flags,
* GTK_RESPONSE_NONE, * _("_OK"),
* NULL); * GTK_RESPONSE_NONE,
* content_area = gtk_dialog_get_content_area (GTK_DIALOG (dialog)); * NULL);
* label = gtk_label_new (message); * 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
* g_signal_connect_swapped (dialog, * responds &ast;/
* "response",
* G_CALLBACK (gtk_widget_destroy),
* dialog);
* *
* /&ast; Add the label, and show everything we’ve added to the dialog &ast;/ * g_signal_connect_swapped (dialog,
* "response",
* G_CALLBACK (gtk_widget_destroy),
* dialog);
* *
* gtk_container_add (GTK_CONTAINER (content_area), label); * /&ast; Add the label, and show everything we’ve added &ast;/
* gtk_widget_show_all (dialog); *
* gtk_container_add (GTK_CONTAINER (content_area), label);
* gtk_widget_show_all (dialog);
* } * }
* ]| * ]|
* *
@ -860,14 +864,16 @@ gtk_dialog_new_empty (const gchar *title,
* *
* Here’s a simple example: * Here’s a simple example:
* |[<!-- language="C" --> * |[<!-- language="C" -->
* GtkWidget *dialog = gtk_dialog_new_with_buttons ("My dialog", * GtkWidget *dialog;
* main_app_window, * GtkDialogFlags flags = GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT;
* GTK_DIALOG_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT, * dialog = gtk_dialog_new_with_buttons ("My dialog",
* _("_OK"), * main_app_window,
* GTK_RESPONSE_ACCEPT, * flags,
* _("_Cancel"), * _("_OK"),
* GTK_RESPONSE_REJECT, * GTK_RESPONSE_ACCEPT,
* NULL); * _("_Cancel"),
* GTK_RESPONSE_REJECT,
* NULL);
* ]| * ]|
* *
* Return value: a new #GtkDialog * Return value: a new #GtkDialog

6
gtk/gtkdnd.h
View File

@ -60,9 +60,9 @@ G_BEGIN_DECLS
* of the user for a drag destination site. * of the user for a drag destination site.
*/ */
typedef enum { typedef enum {
GTK_DEST_DEFAULT_MOTION = 1 << 0, /* respond to "drag_motion" */ GTK_DEST_DEFAULT_MOTION = 1 << 0,
GTK_DEST_DEFAULT_HIGHLIGHT = 1 << 1, /* auto-highlight */ GTK_DEST_DEFAULT_HIGHLIGHT = 1 << 1,
GTK_DEST_DEFAULT_DROP = 1 << 2, /* respond to "drag_drop" */ GTK_DEST_DEFAULT_DROP = 1 << 2,
GTK_DEST_DEFAULT_ALL = 0x07 GTK_DEST_DEFAULT_ALL = 0x07
} GtkDestDefaults; } GtkDestDefaults;

18
gtk/gtkentry.c
View File

@ -7737,7 +7737,9 @@ gtk_entry_get_overwrite_mode (GtkEntry *entry)
* This is equivalent to: * This is equivalent to:
* *
* |[<!-- language="C" --> * |[<!-- 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 * Return value: a pointer to the contents of the widget as a
@ -7759,7 +7761,7 @@ gtk_entry_get_text (GtkEntry *entry)
* @max: the maximum length of the entry, or 0 for no maximum. * @max: the maximum length of the entry, or 0 for no maximum.
* (other than the maximum length of entries.) The value passed in will * (other than the maximum length of entries.) The value passed in will
* be clamped to the range 0-65536. * be clamped to the range 0-65536.
* *
* Sets the maximum allowed length of the contents of the widget. If * Sets the maximum allowed length of the contents of the widget. If
* the current contents are longer than the given length, then they * the current contents are longer than the given length, then they
* will be truncated to fit. * will be truncated to fit.
@ -7767,7 +7769,9 @@ gtk_entry_get_text (GtkEntry *entry)
* This is equivalent to: * This is equivalent to:
* *
* |[<!-- language="C" --> * |[<!-- 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 void
@ -7788,7 +7792,9 @@ gtk_entry_set_max_length (GtkEntry *entry,
* This is equivalent to: * This is equivalent to:
* *
* |[<!-- language="C" --> * |[<!-- 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 * Return value: the maximum allowed number of characters
@ -7812,7 +7818,9 @@ gtk_entry_get_max_length (GtkEntry *entry)
* This is equivalent to: * This is equivalent to:
* *
* |[<!-- language="C" --> * |[<!-- 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 * Return value: the current number of characters

10
gtk/gtkenums.h
View File

@ -200,15 +200,13 @@ typedef enum
typedef enum typedef enum
{ {
GTK_DELETE_CHARS, GTK_DELETE_CHARS,
GTK_DELETE_WORD_ENDS, /* delete only the portion of the word to the GTK_DELETE_WORD_ENDS,
* left/right of cursor if we're in the middle
* of a word */
GTK_DELETE_WORDS, GTK_DELETE_WORDS,
GTK_DELETE_DISPLAY_LINES, GTK_DELETE_DISPLAY_LINES,
GTK_DELETE_DISPLAY_LINE_ENDS, GTK_DELETE_DISPLAY_LINE_ENDS,
GTK_DELETE_PARAGRAPH_ENDS, /* like C-k in Emacs (or its reverse) */ GTK_DELETE_PARAGRAPH_ENDS,
GTK_DELETE_PARAGRAPHS, /* C-k in pico, kill whole line */ GTK_DELETE_PARAGRAPHS,
GTK_DELETE_WHITESPACE /* M-\ in Emacs */ GTK_DELETE_WHITESPACE
} GtkDeleteType; } GtkDeleteType;
/* Focus movement types */ /* Focus movement types */

52
gtk/gtkfilechooserdialog.c
View File

@ -59,19 +59,24 @@
* *
* |[ * |[
* GtkWidget *dialog; * GtkWidget *dialog;
* GtkFileChooserAction action = GTK_FILE_CHOOSER_ACTION_OPEN;
* gint res;
* *
* dialog = gtk_file_chooser_dialog_new ("Open File", * dialog = gtk_file_chooser_dialog_new ("Open File",
* parent_window, * parent_window,
* GTK_FILE_CHOOSER_ACTION_OPEN, * action,
* _("_Cancel"), GTK_RESPONSE_CANCEL, * _("_Cancel"),
* _("_Open"), GTK_RESPONSE_ACCEPT, * GTK_RESPONSE_CANCEL,
* _("_Open"),
* GTK_RESPONSE_ACCEPT,
* NULL); * 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; * char *filename;
* * GtkFileChooser *chooser = GTK_FILE_CHOOSER (dialog);
* filename = gtk_file_chooser_get_filename (GTK_FILE_CHOOSER (dialog)); * filename = gtk_file_chooser_get_filename (chooser);
* open_file (filename); * open_file (filename);
* g_free (filename); * g_free (filename);
* } * }
@ -83,25 +88,35 @@
* *
* |[ * |[
* GtkWidget *dialog; * GtkWidget *dialog;
* GtkFileChooser *chooser;
* GtkFileChooserAction action = GTK_FILE_CHOOSER_ACTION_SAVE;
* gint res;
* *
* dialog = gtk_file_chooser_dialog_new ("Save File", * dialog = gtk_file_chooser_dialog_new ("Save File",
* parent_window, * parent_window,
* GTK_FILE_CHOOSER_ACTION_SAVE, * action,
* _("_Cancel"), GTK_RESPONSE_CANCEL, * _("_Cancel"),
* _("_Save"), GTK_RESPONSE_ACCEPT, * GTK_RESPONSE_CANCEL,
* _("_Save"),
* GTK_RESPONSE_ACCEPT,
* NULL); * 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) * 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 * 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; * char *filename;
* *
* filename = gtk_file_chooser_get_filename (GTK_FILE_CHOOSER (dialog)); * filename = gtk_file_chooser_get_filename (chooser);
* save_to_file (filename); * save_to_file (filename);
* g_free (filename); * g_free (filename);
* } * }
@ -143,12 +158,15 @@
* *
* |[ * |[
* GtkWidget *dialog; * GtkWidget *dialog;
* GtkFileChooserAction action = GTK_FILE_CHOOSER_ACTION_OPEN;
* *
* dialog = gtk_file_chooser_dialog_new ("Open File", * dialog = gtk_file_chooser_dialog_new ("Open File",
* parent_window, * parent_window,
* GTK_FILE_CHOOSER_ACTION_OPEN, * action,
* _("_Cancel"), GTK_RESPONSE_CANCEL, * _("_Cancel"),
* _("_Open"), GTK_RESPONSE_ACCEPT, * GTK_RESPONSE_CANCEL,
* _("_Open"),
* GTK_RESPONSE_ACCEPT,
* NULL); * NULL);
* ]| * ]|
* *

3
gtk/gtkframe.h
View File

@ -66,7 +66,8 @@ struct _GtkFrameClass
/*< public >*/ /*< public >*/
void (*compute_child_allocation) (GtkFrame *frame, GtkAllocation *allocation); void (*compute_child_allocation) (GtkFrame *frame,
GtkAllocation *allocation);
/*< private >*/ /*< private >*/

9
gtk/gtkimage.c
View File

@ -86,10 +86,11 @@
* g_print ("Event box clicked at coordinates %f,%f\n", * g_print ("Event box clicked at coordinates %f,%f\n",
* event->x, event->y); * event->x, event->y);
* *
* /&ast; Returning TRUE means we handled the event, so the signal * /&ast; Returning TRUE means we handled the event,
* &ast; emission should be stopped (don’t call any further * &ast; so the signal emission should be stopped
* &ast; callbacks that may be connected). Return FALSE * &ast; (don’t call any further callbacks that
* &ast; to continue invoking callbacks. * &ast; may be connected). Return FALSE to
* &ast; continue invoking callbacks.
* &ast;/ * &ast;/
* return TRUE; * return TRUE;
* } * }

33
gtk/gtkinfobar.c
View File

@ -75,27 +75,36 @@
* A simple example for using a GtkInfoBar: * A simple example for using a GtkInfoBar:
* |[<!-- language="C" --> * |[<!-- language="C" -->
* /&ast; set up info bar &ast;/ * /&ast; set up info bar &ast;/
* info_bar = gtk_info_bar_new (); * GtkWidget *widget;
* gtk_widget_set_no_show_all (info_bar, TRUE); * 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 (""); * message_label = gtk_label_new ("");
* gtk_widget_show (message_label); * gtk_widget_show (message_label);
* content_area = gtk_info_bar_get_content_area (GTK_INFO_BAR (info_bar)); * content_area = gtk_info_bar_get_content_area (bar);
* gtk_container_add (GTK_CONTAINER (content_area), message_label); * gtk_container_add (GTK_CONTAINER (content_area),
* gtk_info_bar_add_button (GTK_INFO_BAR (info_bar), * message_label);
* _("_OK"), GTK_RESPONSE_OK); * gtk_info_bar_add_button (bar,
* g_signal_connect (info_bar, "response", * _("_OK"),
* G_CALLBACK (gtk_widget_hide), NULL); * GTK_RESPONSE_OK);
* g_signal_connect (bar,
* "response",
* G_CALLBACK (gtk_widget_hide),
* NULL);
* gtk_grid_attach (GTK_GRID (grid), * gtk_grid_attach (GTK_GRID (grid),
* info_bar, * widget,
* 0, 2, 1, 1); * 0, 2, 1, 1);
* *
* /&ast; ... &ast;/ * /&ast; ... &ast;/
* *
* /&ast; show an error message &ast;/ * /&ast; show an error message &ast;/
* gtk_label_set_text (GTK_LABEL (message_label), error_message); * gtk_label_set_text (GTK_LABEL (message_label), message);
* gtk_info_bar_set_message_type (GTK_INFO_BAR (info_bar), * gtk_info_bar_set_message_type (bar,
* GTK_MESSAGE_ERROR); * GTK_MESSAGE_ERROR);
* gtk_widget_show (info_bar); * gtk_widget_show (bar);
* ]| * ]|
* *
* # GtkInfoBar as GtkBuildable * # GtkInfoBar as GtkBuildable

9
gtk/gtklabel.c
View File

@ -207,7 +207,11 @@
* An example looks like this: * An example looks like this:
* *
* |[<!-- language="C" --> * |[<!-- 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 * 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 * external data, you may need to escape it with g_markup_escape_text() or
* g_markup_printf_escaped(): * g_markup_printf_escaped():
* |[<!-- language="C" --> * |[<!-- language="C" -->
* const char *format = "<span style=\"italic\">\%s</span>";
* char *markup; * 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); * gtk_label_set_markup (GTK_LABEL (label), markup);
* g_free (markup); * g_free (markup);
* ]| * ]|

30
gtk/gtklevelbar.c
View File

@ -40,19 +40,25 @@
* static GtkWidget * * static GtkWidget *
* create_level_bar (void) * 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 *<!---->/ * /<!---->* 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); *
* 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 * /<!---->* This adds a new offset to the bar; the application will
* * be able to change its color by using the following selector, * be able to change its color by using the following selector,
* * either by adding it to its CSS file or using * either by adding it to its CSS file or using
* * gtk_css_provider_load_from_data() and gtk_style_context_add_provider() * gtk_css_provider_load_from_data() and
* * * gtk_style_context_add_provider()
*
* * .level-bar.fill-block.level-my-offset { * * .level-bar.fill-block.level-my-offset {
* * background-color: green; * * background-color: green;
* * border-style: solid; * * border-style: solid;
@ -60,10 +66,10 @@
* * border-style: 1px; * * 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;
* } * }
* ]| * ]|
* *

4
gtk/gtkliststore.c
View File

@ -87,8 +87,8 @@
* COLUMN_BOOLEAN, FALSE, * COLUMN_BOOLEAN, FALSE,
* -1); * -1);
* *
* /&ast; As the store will keep a copy of the string internally, * /&ast; As the store will keep a copy of
* &ast; we free some_data. * &ast; the string internally, we free some_data.
* &ast;/ * &ast;/
* g_free (some_data); * g_free (some_data);
* } * }

21
gtk/gtkmain.c
View File

@ -59,7 +59,8 @@
* int * int
* main (int argc, char **argv) * 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;/ * /&ast; Initialize the widget set &ast;/
@ -74,7 +75,8 @@
* /&ast; Show the application window &ast;/ * /&ast; Show the application window &ast;/
* gtk_widget_show_all (mainwin); * 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 (); * gtk_main ();
* *
* /&ast; The user lost interest &ast;/ * /&ast; The user lost interest &ast;/
@ -1811,18 +1813,23 @@ gtk_main_do_event (GdkEvent *event)
* main (int argc, char **argv) * main (int argc, char **argv)
* { * {
* GtkWidget *win, *but; * GtkWidget *win, *but;
* const char *text = "Close yourself. I mean it!";
* *
* gtk_init (&argc, &argv); * gtk_init (&argc, &argv);
* *
* win = gtk_window_new (GTK_WINDOW_TOPLEVEL); * win = gtk_window_new (GTK_WINDOW_TOPLEVEL);
* g_signal_connect (win, "delete-event", * g_signal_connect (win,
* G_CALLBACK (gtk_true), NULL); * "delete-event",
* G_CALLBACK (gtk_true),
* NULL);
* g_signal_connect (win, "destroy", * 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_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_container_add (GTK_CONTAINER (win), but);
* *
* gtk_widget_show_all (win); * gtk_widget_show_all (win);

32
gtk/gtkmessagedialog.c
View File

@ -60,12 +60,14 @@
* *
* An example for using a modal dialog: * An example for using a modal dialog:
* |[<!-- language="C" --> * |[<!-- language="C" -->
* dialog = gtk_message_dialog_new (main_application_window, * GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT;
* GTK_DIALOG_DESTROY_WITH_PARENT, * dialog = gtk_message_dialog_new (parent_window,
* flags,
* GTK_MESSAGE_ERROR, * GTK_MESSAGE_ERROR,
* GTK_BUTTONS_CLOSE, * GTK_BUTTONS_CLOSE,
* "Error loading file '%s': %s", * "Error reading “%s”: %s",
* filename, g_strerror (errno)); * filename,
* g_strerror (errno));
* gtk_dialog_run (GTK_DIALOG (dialog)); * gtk_dialog_run (GTK_DIALOG (dialog));
* gtk_widget_destroy (dialog); * gtk_widget_destroy (dialog);
* ]| * ]|
@ -74,14 +76,18 @@
* *
* An example for a non-modal dialog: * An example for a non-modal dialog:
* |[<!-- language="C" --> * |[<!-- language="C" -->
* dialog = gtk_message_dialog_new (main_application_window, * GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT;
* GTK_DIALOG_DESTROY_WITH_PARENT, * dialog = gtk_message_dialog_new (parent_window,
* flags,
* GTK_MESSAGE_ERROR, * GTK_MESSAGE_ERROR,
* GTK_BUTTONS_CLOSE, * GTK_BUTTONS_CLOSE,
* "Error loading file '%s': %s", * "Error reading “%s”: %s",
* filename, g_strerror (errno)); * 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_signal_connect_swapped (dialog, "response",
* G_CALLBACK (gtk_widget_destroy), * G_CALLBACK (gtk_widget_destroy),
* dialog); * dialog);
@ -608,8 +614,9 @@ gtk_message_dialog_new (GtkWindow *parent,
* argument. * argument.
* |[<!-- language="C" --> * |[<!-- language="C" -->
* GtkWidget *dialog; * GtkWidget *dialog;
* dialog = gtk_message_dialog_new (main_application_window, * GtkDialogFlags flags = GTK_DIALOG_DESTROY_WITH_PARENT;
* GTK_DIALOG_DESTROY_WITH_PARENT, * dialog = gtk_message_dialog_new (parent_window,
* flags,
* GTK_MESSAGE_ERROR, * GTK_MESSAGE_ERROR,
* GTK_BUTTONS_CLOSE, * GTK_BUTTONS_CLOSE,
* NULL); * NULL);
@ -799,7 +806,8 @@ gtk_message_dialog_format_secondary_text (GtkMessageDialog *message_dialog,
* gchar *msg; * gchar *msg;
* *
* msg = g_markup_printf_escaped (message_format, ...); * 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); * g_free (msg);
* ]| * ]|
* *

22
gtk/gtknotebook.c
View File

@ -8397,23 +8397,25 @@ gtk_notebook_get_tab_detachable (GtkNotebook *notebook,
* widget that corresponds to the dropped tab. * widget that corresponds to the dropped tab.
* |[<!-- language="C" --> * |[<!-- language="C" -->
* static void * static void
* on_drop_zone_drag_data_received (GtkWidget *widget, * on_drag_data_received (GtkWidget *widget,
* GdkDragContext *context, * GdkDragContext *context,
* gint x, * gint x,
* gint y, * gint y,
* GtkSelectionData *selection_data, * GtkSelectionData *data,
* guint info, * guint info,
* guint time, * guint time,
* gpointer user_data) * gpointer user_data)
* { * {
* GtkWidget *notebook; * GtkWidget *notebook;
* GtkWidget **child; * GtkWidget **child;
* GtkContainer *container;
* *
* notebook = gtk_drag_get_source_widget (context); * 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); * process_widget (*child);
* gtk_container_remove (GTK_CONTAINER (notebook), *child); * container = GTK_CONTAINER (notebook);
* gtk_container_remove (container, *child);
* } * }
* ]| * ]|
* *

13
gtk/gtkrecentchooserdialog.c
View File

@ -51,18 +51,23 @@
* *
* |[<!-- language="C" --> * |[<!-- language="C" -->
* GtkWidget *dialog; * GtkWidget *dialog;
* gint res;
* *
* dialog = gtk_recent_chooser_dialog_new ("Recent Documents", * dialog = gtk_recent_chooser_dialog_new ("Recent Documents",
* parent_window, * parent_window,
* _("_Cancel"), GTK_RESPONSE_CANCEL, * _("_Cancel"),
* _("_Open"), GTK_RESPONSE_ACCEPT, * GTK_RESPONSE_CANCEL,
* _("_Open"),
* GTK_RESPONSE_ACCEPT,
* NULL); * 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; * 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)); * open_file (gtk_recent_info_get_uri (info));
* gtk_recent_info_unref (info); * gtk_recent_info_unref (info);
* } * }

15
gtk/gtksearchbar.c
View File

@ -165,15 +165,18 @@ preedit_changed_cb (GtkEntry *entry,
* *
* |[<!-- language="C" --> * |[<!-- language="C" -->
* static gboolean * static gboolean
* window_key_press_event_cb (GtkWidget *widget, * on_key_press_event (GtkWidget *widget,
* GdkEvent *event, * GdkEvent *event,
* gpointer user_data) * 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_signal_connect (window,
* G_CALLBACK (window_key_press_event_cb), search_bar); * "key-press-event",
* G_CALLBACK (on_key_press_event),
* search_bar);
* ]| * ]|
* *
* Return value: %GDK_EVENT_STOP if the key press event resulted * Return value: %GDK_EVENT_STOP if the key press event resulted

28
gtk/gtktogglebutton.c
View File

@ -63,23 +63,33 @@
* |[<!-- language="C" --> * |[<!-- language="C" -->
* void make_toggles (void) { * void make_toggles (void) {
* GtkWidget *dialog, *toggle1, *toggle2; * GtkWidget *dialog, *toggle1, *toggle2;
* GtkWidget *content_area;
* const char *text;
* *
* dialog = gtk_dialog_new (); * dialog = gtk_dialog_new (text);
* toggle1 = gtk_toggle_button_new_with_label ("Hi, i’m a toggle button."); * 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;/ * /&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_signal_connect (toggle1, "toggled",
* G_CALLBACK (output_state), NULL); * G_CALLBACK (output_state),
* gtk_box_pack_start (GTK_BOX (GTK_DIALOG (dialog)->action_area), * NULL);
* gtk_box_pack_start (GTK_BOX (content_area),
* toggle1, FALSE, FALSE, 2); * toggle1, FALSE, FALSE, 2);
* *
* toggle2 = gtk_toggle_button_new_with_label ("Hi, i’m another toggle button."); * text = "Hi, i’m a toggle button.";
* gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle2), FALSE); * toggle2 = gtk_toggle_button_new_with_label (text);
* gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle2),
* FALSE);
* g_signal_connect (toggle2, "toggled", * g_signal_connect (toggle2, "toggled",
* G_CALLBACK (output_state), NULL); * G_CALLBACK (output_state),
* gtk_box_pack_start (GTK_BOX (GTK_DIALOG (dialog)->action_area), * NULL);
* gtk_box_pack_start (GTK_BOX (content_area),
* toggle2, FALSE, FALSE, 2); * toggle2, FALSE, FALSE, 2);
* *
* gtk_widget_show_all (dialog); * gtk_widget_show_all (dialog);

41
gtk/gtktreemodel.c
View File

@ -116,13 +116,16 @@
* ## Acquiring a #GtkTreeIter-struct * ## Acquiring a #GtkTreeIter-struct
* *
* |[<!-- language="C" --> * |[<!-- 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; * GtkTreePath *path;
* GtkTreeIter iter; * GtkTreeIter iter;
* GtkTreeIter parent_iter; * GtkTreeIter parent_iter;
* *
* /&ast; get the iterator from a string &ast;/ * /&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;/ * /&ast; get the iterator from a path &ast;/
* path = gtk_tree_path_new_from_string ("3:2:5"); * path = gtk_tree_path_new_from_string ("3:2:5");
@ -130,11 +133,14 @@
* gtk_tree_path_free (path); * gtk_tree_path_free (path);
* *
* /&ast; walk the tree to find the iterator &ast;/ * /&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; * 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; * 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);
* ]| * ]|
* *
* This second example shows a quick way of iterating through a list * This second example shows a quick way of iterating through a list
@ -161,22 +167,26 @@
* gint row_count = 0; * gint row_count = 0;
* *
* /&ast; make a new list_store &ast;/ * /&ast; make a new list_store &ast;/
* list_store = gtk_list_store_new (N_COLUMNS, G_TYPE_STRING, G_TYPE_INT); * list_store = gtk_list_store_new (N_COLUMNS,
* G_TYPE_STRING,
* G_TYPE_INT);
* *
* /&ast; Fill the list store with data &ast;/ * /&ast; Fill the list store with data &ast;/
* populate_model (list_store); * populate_model (list_store);
* *
* /&ast; Get the first iter in the list, check it is valid and walk * /&ast; Get the first iter in the list, check it is
* &ast; through the list, reading each row. &ast;/ * valid and walk through the list, reading each row.
* for (valid = gtk_tree_model_get_iter_first (list_store, &iter); * &ast;/
* valid; *
* valid = gtk_tree_model_iter_next (list_store, &iter)) * valid = gtk_tree_model_get_iter_first (list_store,
* &iter);
* while (valid)
* { * {
* gchar *str_data; * gchar *str_data;
* gint int_data; * gint int_data;
* *
* /&ast; Make sure you terminate calls to gtk_tree_model_get() * /&ast; Make sure you terminate calls to
* &ast; with a “-1” value * &ast; gtk_tree_model_get() with a “-1” value
* &ast;/ * &ast;/
* gtk_tree_model_get (list_store, &iter, * gtk_tree_model_get (list_store, &iter,
* STRING_COLUMN, &str_data, * STRING_COLUMN, &str_data,
@ -184,9 +194,12 @@
* -1); * -1);
* *
* /&ast; Do something with the data &ast;/ * /&ast; Do something with the data &ast;/
* g_print ("Row %d: (%s,%d)\n", row_count, str_data, int_data); * g_print ("Row %d: (%s,%d)\n",
* row_count, str_data, int_data);
* g_free (str_data); * g_free (str_data);
* *
* valid = gtk_tree_model_iter_next (list_store,
* &iter);
* row_count++; * row_count++;
* } * }
* ]| * ]|

69
gtk/gtkwidget.c
View File

@ -156,20 +156,28 @@
* *
* |[<!-- language="C" --> * |[<!-- language="C" -->
* static void * static void
* foo_widget_get_preferred_height (GtkWidget *widget, gint *min_height, gint *nat_height) * foo_widget_get_preferred_height (GtkWidget *widget,
* gint *min_height,
* gint *nat_height)
* { * {
* if (i_am_in_height_for_width_mode) * if (i_am_in_height_for_width_mode)
* { * {
* gint min_width; * gint min_width;
* *
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget, &min_width, NULL); * GTK_WIDGET_GET_CLASS (widget)->get_preferred_width (widget,
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_height_for_width (widget, min_width, * &min_width,
* min_height, nat_height); * NULL);
* GTK_WIDGET_GET_CLASS (widget)->get_preferred_height_for_width
* (widget,
* min_width,
* min_height,
* nat_height);
* } * }
* else * else
* { * {
* ... some widgets do both. For instance, if a GtkLabel is rotated to 90 degrees * ... some widgets do both. For instance, if a GtkLabel is
* it will return the minimum and natural height for the rotated label here. * rotated to 90 degrees it will return the minimum and
* natural height for the rotated label here.
* } * }
* } * }
* ]| * ]|
@ -178,18 +186,22 @@
* the minimum and natural width: * the minimum and natural width:
* |[<!-- language="C" --> * |[<!-- language="C" -->
* static void * static void
* foo_widget_get_preferred_width_for_height (GtkWidget *widget, gint for_height, * foo_widget_get_preferred_width_for_height (GtkWidget *widget,
* gint *min_width, gint *nat_width) * gint for_height,
* gint *min_width,
* gint *nat_width)
* { * {
* if (i_am_in_height_for_width_mode) * 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 * else
* { * {
* ... again if a widget is sometimes operating in width-for-height mode * ... again if a widget is sometimes operating in
* (like a rotated GtkLabel) it can go ahead and do its real width for * width-for-height mode (like a rotated GtkLabel) it can go
* height calculation here. * ahead and do its real width for height calculation here.
* } * }
* } * }
* ]| * ]|
@ -201,8 +213,9 @@
* be careful to call its virtual methods directly, like this: * be careful to call its virtual methods directly, like this:
* *
* |[<!-- language="C" --> * |[<!-- language="C" -->
* GTK_WIDGET_GET_CLASS(widget)-&gt;get_preferred_width (widget), * GTK_WIDGET_GET_CLASS(widget)->get_preferred_width (widget,
* &min, &natural); * &min,
* &natural);
* ]| * ]|
* *
* It will not work to use the wrapper functions, such as * It will not work to use the wrapper functions, such as
@ -2952,7 +2965,8 @@ G_GNUC_END_IGNORE_DEPRECATIONS
* gdk_drag_status (context, 0, time); * gdk_drag_status (context, 0, time);
* else * else
* { * {
* private_data->pending_status = gdk_drag_context_get_suggested_action (context); * private_data->pending_status
* = gdk_drag_context_get_suggested_action (context);
* gtk_drag_get_data (widget, context, target, time); * gtk_drag_get_data (widget, context, target, time);
* } * }
* *
@ -2974,16 +2988,18 @@ G_GNUC_END_IGNORE_DEPRECATIONS
* { * {
* private_data->suggested_action = 0; * private_data->suggested_action = 0;
* *
* /&ast; We are getting this data due to a request in drag_motion, * /&ast; We are getting this data due to a request in
* * rather than due to a request in drag_drop, so we are just * drag_motion, rather than due to a request in drag_drop,
* * supposed to call gdk_drag_status(), not actually paste in * so we are just supposed to call gdk_drag_status(), not
* * the data. * actually paste in the data. &ast;/
* &ast;/ *
* str = gtk_selection_data_get_text (selection_data); * str = gtk_selection_data_get_text (selection_data);
* if (!data_is_acceptable (str)) * if (!data_is_acceptable (str))
* gdk_drag_status (context, 0, time); * gdk_drag_status (context, 0, time);
* else * else
* gdk_drag_status (context, private_data->suggested_action, time); * gdk_drag_status (context,
* private_data->suggested_action,
* time);
* } * }
* else * else
* { * {
@ -11097,17 +11113,6 @@ gtk_widget_get_composite_name (GtkWidget *widget)
* see gtk_container_foreach() vs. gtk_container_forall()), but e.g. GUI * see gtk_container_foreach() vs. gtk_container_forall()), but e.g. GUI
* builders might want to treat them in a different way. * builders might want to treat them in a different way.
* *
* Here is a simple example:
* |[<!-- language="C" -->
* gtk_widget_push_composite_child ();
* scrolled_window->hscrollbar = gtk_scrollbar_new (GTK_ORIENTATION_HORIZONTAL, hadjustment);
* gtk_widget_set_composite_name (scrolled_window->hscrollbar, "hscrollbar");
* gtk_widget_pop_composite_child ();
* gtk_widget_set_parent (scrolled_window->hscrollbar,
* GTK_WIDGET (scrolled_window));
* g_object_ref (scrolled_window->hscrollbar);
* ]|
*
* Deprecated: 3.10: This API never really worked well and was mostly unused, now * Deprecated: 3.10: This API never really worked well and was mostly unused, now
* we have a more complete mechanism for composite children, see gtk_widget_class_set_template(). * we have a more complete mechanism for composite children, see gtk_widget_class_set_template().
**/ **/

39
gtk/gtkwindow.c
View File

@ -11367,7 +11367,7 @@ gtk_XParseGeometry (const char *string,
* gtk_window_parse_geometry: * gtk_window_parse_geometry:
* @window: a #GtkWindow * @window: a #GtkWindow
* @geometry: geometry string * @geometry: geometry string
* *
* Parses a standard X Window System geometry string - see the * Parses a standard X Window System geometry string - see the
* manual page for X (type “man X”) for details on this. * manual page for X (type “man X”) for details on this.
* gtk_window_parse_geometry() does work on all GTK+ ports * gtk_window_parse_geometry() does work on all GTK+ ports
@ -11390,46 +11390,53 @@ gtk_XParseGeometry (const char *string,
* on the window. * on the window.
* |[<!-- language="C" --> * |[<!-- language="C" -->
* #include <gtk/gtk.h> * #include <gtk/gtk.h>
* *
* static void * static void
* fill_with_content (GtkWidget *vbox) * fill_with_content (GtkWidget *vbox)
* { * {
* /&ast; fill with content... &ast;/ * /&ast; fill with content... &ast;/
* } * }
* *
* int * int
* main (int argc, char *argv[]) * main (int argc, char *argv[])
* { * {
* GtkWidget *window, *vbox; * GtkWidget *window, *vbox;
* GdkGeometry size_hints = { * GdkGeometry size_hints = {
* 100, 50, 0, 0, 100, 50, 10, 10, 0.0, 0.0, GDK_GRAVITY_NORTH_WEST * 100, 50, 0, 0, 100, 50, 10,
* 10, 0.0, 0.0, GDK_GRAVITY_NORTH_WEST
* }; * };
* *
* gtk_init (&argc, &argv); * gtk_init (&argc, &argv);
* *
* window = gtk_window_new (GTK_WINDOW_TOPLEVEL); * window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
* vbox = gtk_box_new (GTK_ORIENTATION_VERTICAL, FALSE, 0); * vbox = gtk_box_new (GTK_ORIENTATION_VERTICAL,
* * FALSE, 0);
*
* gtk_container_add (GTK_CONTAINER (window), vbox); * gtk_container_add (GTK_CONTAINER (window), vbox);
* fill_with_content (vbox); * fill_with_content (vbox);
* gtk_widget_show_all (vbox); * gtk_widget_show_all (vbox);
* *
* gtk_window_set_geometry_hints (GTK_WINDOW (window), * gtk_window_set_geometry_hints (GTK_WINDOW (window),
* window, * window,
* &size_hints, * &size_hints,
* GDK_HINT_MIN_SIZE | * GDK_HINT_MIN_SIZE |
* GDK_HINT_BASE_SIZE | * GDK_HINT_BASE_SIZE |
* GDK_HINT_RESIZE_INC); * GDK_HINT_RESIZE_INC);
* *
* if (argc > 1) * if (argc > 1)
* { * {
* if (!gtk_window_parse_geometry (GTK_WINDOW (window), argv[1])) * gboolean res;
* fprintf (stderr, "Failed to parse “%s”\n", argv[1]); * res = gtk_window_parse_geometry (GTK_WINDOW (window),
* argv[1]);
* if (! res)
* fprintf (stderr,
* "Failed to parse “%s”\n",
* argv[1]);
* } * }
* *
* gtk_widget_show_all (window); * gtk_widget_show_all (window);
* gtk_main (); * gtk_main ();
* *
* return 0; * return 0;
* } * }
* ]| * ]|