From eed0e982f57fd6551eff8c526b59925ca10fbad2 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sat, 31 May 2003 23:33:09 +0000 Subject: [PATCH] Add some hints and an example to the docs. (#98427) 2003-06-01 Matthias Clasen * gtk/gtkwindow.c (gtk_window_parse_geometry): Add some hints and an example to the docs. (#98427) --- ChangeLog | 5 +++++ ChangeLog.pre-2-10 | 5 +++++ ChangeLog.pre-2-4 | 5 +++++ ChangeLog.pre-2-6 | 5 +++++ ChangeLog.pre-2-8 | 5 +++++ gtk/gtkwindow.c | 45 +++++++++++++++++++++++++++++++++++++++++++++ 6 files changed, 70 insertions(+) diff --git a/ChangeLog b/ChangeLog index ec11e2003..84ebbda91 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2003-06-01 Matthias Clasen + + * gtk/gtkwindow.c (gtk_window_parse_geometry): Add some hints and + an example to the docs. (#98427) + 2003-05-30 Murray Cumming * gtk/gtkalignment.[h|c]: Added 4-sided padding as properties with diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index ec11e2003..84ebbda91 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,8 @@ +2003-06-01 Matthias Clasen + + * gtk/gtkwindow.c (gtk_window_parse_geometry): Add some hints and + an example to the docs. (#98427) + 2003-05-30 Murray Cumming * gtk/gtkalignment.[h|c]: Added 4-sided padding as properties with diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index ec11e2003..84ebbda91 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,8 @@ +2003-06-01 Matthias Clasen + + * gtk/gtkwindow.c (gtk_window_parse_geometry): Add some hints and + an example to the docs. (#98427) + 2003-05-30 Murray Cumming * gtk/gtkalignment.[h|c]: Added 4-sided padding as properties with diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index ec11e2003..84ebbda91 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,8 @@ +2003-06-01 Matthias Clasen + + * gtk/gtkwindow.c (gtk_window_parse_geometry): Add some hints and + an example to the docs. (#98427) + 2003-05-30 Murray Cumming * gtk/gtkalignment.[h|c]: Added 4-sided padding as properties with diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index ec11e2003..84ebbda91 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,8 @@ +2003-06-01 Matthias Clasen + + * gtk/gtkwindow.c (gtk_window_parse_geometry): Add some hints and + an example to the docs. (#98427) + 2003-05-30 Murray Cumming * gtk/gtkalignment.[h|c]: Added 4-sided padding as properties with diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c index 082299a0c..f587d6104 100644 --- a/gtk/gtkwindow.c +++ b/gtk/gtkwindow.c @@ -6504,7 +6504,52 @@ gtk_XParseGeometry (const char *string, * indicating to the window manager that the size/position of * the window was user-specified. This causes most window * managers to honor the geometry. + * + * Note that for gtk_window_parse_geometry() to work as expected, it has + * to be called when the window has its "final" size, i.e. after calling + * gtk_widget_show_all() on the contents and gtk_window_set_geometry_hints() + * on the window. * + * + * int + * main (int argc, char *argv[]) + * { + * GtkWidget *window, vbox; + * GdkGeometry size_hints; + * + * gtk_init (&argc, &argv); + * + * window = gtk_window_new (GTK_WINDOW_TOPLEVEL); + * vbox = gtk_vbox_new (FALSE, 0); + * + * gtk_container_add (GTK_CONTAINER (window), vbox); + * fill_with_content (vbox); + * gtk_widget_show_all (vbox); + * + * size_hints = { + * 100, 50, 0, 0, 100, 50, 10, 10, 0.0, 0.0, GDK_GRAVITY_NORTH_WEST + * }; + * + * gtk_window_set_geometry_hints (GTK_WINDOW (window), + * window, + * &size_hints, + * GDK_HINT_MIN_SIZE | + * GDK_HINT_BASE_SIZE | + * GDK_HINT_RESIZE_INC); + * + * if (argc > 1) + * { + * if (!gtk_window_parse_geometry (GTK_WINDOW (window), argv[1])) + * fprintf (stderr, "Failed to parse '%s'\n", argv[1]); + * } + * + * gtk_widget_show_all (window); + * gtk_main (); + * + * return 0; + * } + * + * * Return value: %TRUE if string was parsed successfully **/ gboolean -- 2.43.2