[gtkmm] 2.19.4

From: Murray Cumming <murrayc src gnome org>
To: svn-commits-list gnome org
Cc:
Subject: [gtkmm] 2.19.4
Date: Tue, 26 Jan 2010 10:05:48 +0000 (UTC)
commit 9e64c61f4f304483383e0c9150e03df028498539
Author: Murray Cumming <murrayc murrayc com>
Date:   Tue Jan 26 11:05:28 2010 +0100

    2.19.4

 ChangeLog            |    2 +
 NEWS                 |   32 ++++
 configure.ac         |    4 +-
 gtk/src/gtk_docs.xml |  408 +++++++++++++++++++++++++++++++++++++-------------
 4 files changed, 338 insertions(+), 108 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 110689f..d0ffebe 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,5 @@
+2.19.4:
+
 2010-01-25  Murray Cumming  <murrayc murrayc com>
 
 	Range, StatusIcon: Added new methods.
diff --git a/NEWS b/NEWS
index fa295ec..22b338c 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,35 @@
+2.19.4 (unstable);
+
+Gtk:
+* Action: Added get/set_always_show_image() and property.
+* EntryBuffer: Added this class.
+* Entry:
+  - Use EntryBuffer in a constructor and get/set_buffer() and property.
+  - Added get_text_window() and get_icon_window().
+* FontSelection.hg:
+  - Added get_family() and get_face(), get_family_list(), get_face_list(), 
+  get_size_list().
+  - Reimplemented get_size_entry() and get_preview_entry() using new functions.
+* OffscreenWindow: Added this class.
+
+	* gtk/src/offscreenwindow.[hg|ccg]: Added this, wrapping 
+	GtkOffscreenWindow.
+	* gtk/gtkmm.h: Include offscreenwindow.h.
+	* gtk/src/window.hg: Added get/set_mnemonics_visible().
+	Added mnemonics, accept-focus, and focus-on-map properties.
+* PrintContext: Added get_hard_margins().
+* Range: Added get/set_slider_size_fixed(), get/set_min_slider_size(), 
+  get_slider_range(), get_range_rect().
+* ToolItememGroup: Added insert() with no position parameter and made 
+  get_item_position() const.
+* ToolPalette: set_drag_source(), add_drag_dest(): Add suitable default parameter values.
+* StatusIcon: Added set_name().
+* Widget: Added has_rc_style(), deprecating rc_style().
+* Window:
+  - Added get_icon_name() and icon_name property.
+  - Added get/set_mnemonics_visible() and property.
+  - Added accept-focus, and focus-on-map properties.
+
 2.19.2 (unstable):
 
 Gdk:
diff --git a/configure.ac b/configure.ac
index 591b1a1..d941835 100644
--- a/configure.ac
+++ b/configure.ac
@@ -15,7 +15,7 @@
 ## You should have received a copy of the GNU Lesser General Public License
 ## along with this library.  If not, see <http://www.gnu.org/licenses/>.
 
-AC_INIT([gtkmm], [2.19.2],
+AC_INIT([gtkmm], [2.19.4],
         [http://bugzilla.gnome.org/enter_bug.cgi?product=gtkmm],
         [gtkmm], [http://www.gtkmm.org/])
 AC_PREREQ([2.59])
@@ -56,7 +56,7 @@ AS_IF([test "x$enable_static" = xyes],
 AC_SUBST([ATKMM_MODULES], ['glibmm-2.4 >= 2.22 atk >= 1.12'])
 
 # gdkmm really does need GTK+, because part of Gdk::DragContext is in GTK+.
-AC_SUBST([GDKMM_MODULES], ['giomm-2.4 >= 2.22 pangomm-1.4 >= 2.26 gtk+-2.0 >= 2.19.2'])
+AC_SUBST([GDKMM_MODULES], ['giomm-2.4 >= 2.22 pangomm-1.4 >= 2.26 gtk+-2.0 >= 2.19.4'])
 
 AS_IF([test "x$gtkmm_host_windows" = xyes],
       [GTKMM_MODULES=$GDKMM_MODULES],
diff --git a/gtk/src/gtk_docs.xml b/gtk/src/gtk_docs.xml
index 28a4f57..0962444 100644
--- a/gtk/src/gtk_docs.xml
+++ b/gtk/src/gtk_docs.xml
@@ -4403,6 +4403,26 @@ Sets whether the entry has a beveled frame around it.
 <return></return>
 </function>
 
+<function name="gtk_color_button_set_alpha">
+<description>
+Sets the current opacity to be @alpha. 
+
+Since: 2.4
+
+</description>
+<parameters>
+<parameter name="color_button">
+<parameter_description> a #GtkColorButton.
+</parameter_description>
+</parameter>
+<parameter name="alpha">
+<parameter_description> an integer between 0 and 65535.
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_tree_model_filter_refilter">
 <description>
 Emits ::row_changed for each row in the child model, which causes
@@ -14460,25 +14480,27 @@ Return value: A #GtkTreeView
 </return>
 </function>
 
-<function name="gtk_assistant_set_page_title">
+<function name="gtk_range_get_slider_range">
 <description>
-Sets a title for @page. The title is displayed in the header
-area of the assistant when @page is the current page.
+This function returns sliders range along the long dimension,
+in widget-&gt;window coordinates.
 
-Since: 2.10
+This function is useful mainly for #GtkRange subclasses.
+
+Since: 2.20
 
 </description>
 <parameters>
-<parameter name="assistant">
-<parameter_description> a #GtkAssistant
+<parameter name="range">
+<parameter_description> a #GtkRange
 </parameter_description>
 </parameter>
-<parameter name="page">
-<parameter_description> a page of @assistant
+<parameter name="slider_start">
+<parameter_description> return location for the slider's start, or %NULL
 </parameter_description>
 </parameter>
-<parameter name="title">
-<parameter_description> the new title for @page
+<parameter name="slider_end">
+<parameter_description> return location for the slider's end, or %NULL
 </parameter_description>
 </parameter>
 </parameters>
@@ -15524,30 +15546,20 @@ mnemonic character
 </return>
 </function>
 
-<function name="gtk_print_context_set_hard_margins">
+<function name="gtk_drag_source_add_text_targets">
 <description>
-set the hard margins in pixel coordinates
+Add the text targets supported by #GtkSelection to
+the target list of the drag source.  The targets
+are added with @info = 0. If you need another value, 
+use gtk_target_list_add_text_targets() and
+gtk_drag_source_set_target_list().
+
+Since: 2.6
 
 </description>
 <parameters>
-<parameter name="context">
-<parameter_description> a #GtkPrintContext
-</parameter_description>
-</parameter>
-<parameter name="top">
-<parameter_description> top hardware printer margin
-</parameter_description>
-</parameter>
-<parameter name="bottom">
-<parameter_description> bottom hardware printer margin
-</parameter_description>
-</parameter>
-<parameter name="left">
-<parameter_description> left hardware printer margin
-</parameter_description>
-</parameter>
-<parameter name="right">
-<parameter_description> right hardware printer margin
+<parameter name="widget">
+<parameter_description> a #GtkWidget that's is a drag source
 </parameter_description>
 </parameter>
 </parameters>
@@ -19034,24 +19046,21 @@ e.g. use 1 to display 1.0, 2 to display 1.00, etc
 <return></return>
 </function>
 
-<function name="gtk_drag_source_add_text_targets">
+<function name="gtk_entry_get_text_window">
 <description>
-Add the text targets supported by #GtkSelection to
-the target list of the drag source.  The targets
-are added with @info = 0. If you need another value, 
-use gtk_target_list_add_text_targets() and
-gtk_drag_source_set_target_list().
-
-Since: 2.6
+Return value: the entry's text window.
 
 </description>
 <parameters>
-<parameter name="widget">
-<parameter_description> a #GtkWidget that's is a drag source
+<parameter name="entry">
+<parameter_description> a #GtkEntry
 </parameter_description>
 </parameter>
 </parameters>
-<return></return>
+<return> the entry's text window.
+
+Since: 2.20
+</return>
 </function>
 
 <function name="gtk_action_group_new">
@@ -19294,20 +19303,30 @@ Since: 2.2
 </return>
 </function>
 
-<function name="gtk_color_button_set_alpha">
+<function name="gtk_print_context_set_hard_margins">
 <description>
-Sets the current opacity to be @alpha. 
-
-Since: 2.4
+set the hard margins in pixel coordinates
 
 </description>
 <parameters>
-<parameter name="color_button">
-<parameter_description> a #GtkColorButton.
+<parameter name="context">
+<parameter_description> a #GtkPrintContext
 </parameter_description>
 </parameter>
-<parameter name="alpha">
-<parameter_description> an integer between 0 and 65535.
+<parameter name="top">
+<parameter_description> top hardware printer margin
+</parameter_description>
+</parameter>
+<parameter name="bottom">
+<parameter_description> bottom hardware printer margin
+</parameter_description>
+</parameter>
+<parameter name="left">
+<parameter_description> left hardware printer margin
+</parameter_description>
+</parameter>
+<parameter name="right">
+<parameter_description> right hardware printer margin
 </parameter_description>
 </parameter>
 </parameters>
@@ -20256,38 +20275,23 @@ Since: 2.6
 </return>
 </function>
 
-<function name="gtk_file_filter_add_custom">
+<function name="gtk_range_get_range_rect">
 <description>
-Adds rule to a filter that allows files based on a custom callback
-function. The bitfield @needed which is passed in provides information
-about what sorts of information that the filter function needs;
-this allows GTK+ to avoid retrieving expensive information when
-it isn't needed by the filter.
+This function returns the area that contains the range's trough
+and its steppers, in widget-&gt;window coordinates.
 
-Since: 2.4
+This function is useful mainly for #GtkRange subclasses.
+
+Since: 2.20
 
 </description>
 <parameters>
-<parameter name="filter">
-<parameter_description> a #GtkFileFilter
-</parameter_description>
-</parameter>
-<parameter name="needed">
-<parameter_description> bitfield of flags indicating the information that the custom
-filter function needs.
-</parameter_description>
-</parameter>
-<parameter name="func">
-<parameter_description> callback function; if the function returns %TRUE, then
-the file will be displayed.
-</parameter_description>
-</parameter>
-<parameter name="data">
-<parameter_description> data to pass to @func
+<parameter name="range">
+<parameter_description> a #GtkRange
 </parameter_description>
 </parameter>
-<parameter name="notify">
-<parameter_description> function to call to free @data when it is no longer needed.
+<parameter name="range_rect">
+<parameter_description> return location for the range rectangle
 </parameter_description>
 </parameter>
 </parameters>
@@ -23545,6 +23549,31 @@ Return value: (transfer none): the tab label
 </return>
 </function>
 
+<function name="gtk_item_factory_delete_entries">
+<description>
+Deletes the menu items which were created from the @entries by the given
+item factory.
+
+Deprecated: 2.4: Use #GtkUIManager instead.
+
+</description>
+<parameters>
+<parameter name="ifactory">
+<parameter_description> a #GtkItemFactory
+</parameter_description>
+</parameter>
+<parameter name="n_entries">
+<parameter_description> the length of @entries
+</parameter_description>
+</parameter>
+<parameter name="entries">
+<parameter_description> an array of #GtkItemFactoryEntry&lt;!-- --&gt;s 
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="_gtk_im_module_list">
 <description>
 List all available types of input method context
@@ -25456,6 +25485,29 @@ already.
 <return></return>
 </function>
 
+<function name="gtk_range_set_slider_size_fixed">
+<description>
+Sets whether the range's slider has a fixed size, or a size that
+depends on it's adjustment's page size.
+
+This function is useful mainly for #GtkRange subclasses.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="range">
+<parameter_description> a #GtkRange
+</parameter_description>
+</parameter>
+<parameter name="size_fixed">
+<parameter_description> %TRUE to make the slider size constant
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_icon_info_set_raw_coordinates">
 <description>
 Sets whether the coordinates returned by gtk_icon_info_get_embedded_rect()
@@ -27870,25 +27922,22 @@ button box.
 <return></return>
 </function>
 
-<function name="gtk_item_factory_delete_entries">
+<function name="gtk_range_set_min_slider_size">
 <description>
-Deletes the menu items which were created from the @entries by the given
-item factory.
+Sets the minimum size of the range's slider.
 
-Deprecated: 2.4: Use #GtkUIManager instead.
+This function is useful mainly for #GtkRange subclasses.
+
+Since: 2.20
 
 </description>
 <parameters>
-<parameter name="ifactory">
-<parameter_description> a #GtkItemFactory
-</parameter_description>
-</parameter>
-<parameter name="n_entries">
-<parameter_description> the length of @entries
+<parameter name="range">
+<parameter_description> a #GtkRange
 </parameter_description>
 </parameter>
-<parameter name="entries">
-<parameter_description> an array of #GtkItemFactoryEntry&lt;!-- --&gt;s 
+<parameter name="min_size">
+<parameter_description> The slider's minimum size
 </parameter_description>
 </parameter>
 </parameters>
@@ -33555,7 +33604,7 @@ you should use this function if you already have a file name to which the
 user may save; for example, when the user opens an existing file and then 
 does &lt;guimenuitem&gt;File/Save As...&lt;/guimenuitem&gt; on it.  If you don't have 
 a file name already &#8212; for example, if the user just created a new 
-file and is saving it for the first time, do not call this function.  
+file and is saving it for the first time, do not call this function.
 </description>
 <parameters>
 <parameter name="chooser">
@@ -36016,23 +36065,23 @@ Since: 2.4
 </return>
 </function>
 
-<function name="gtk_recent_manager_new">
+<function name="gtk_range_get_slider_size_fixed">
 <description>
-Creates a new recent manager object.  Recent manager objects are used to
-handle the list of recently used resources.  A #GtkRecentManager object
-monitors the recently used resources list, and emits the &quot;changed&quot; signal
-each time something inside the list changes.
+This function is useful mainly for #GtkRange subclasses.
 
-#GtkRecentManager objects are expensive: be sure to create them only when
-needed. You should use gtk_recent_manager_get_default() instead.
+See gtk_range_set_slider_size_fixed().
 
 
 </description>
 <parameters>
+<parameter name="range">
+<parameter_description> a #GtkRange
+</parameter_description>
+</parameter>
 </parameters>
-<return> A newly created #GtkRecentManager object.
+<return> whether the range's slider has a fixed size.
 
-Since: 2.10
+Since: 2.20
 </return>
 </function>
 
@@ -43741,6 +43790,27 @@ since the arrow is made insensitive if the menu is not set.
 <return></return>
 </function>
 
+<function name="gtk_entry_get_icon_window">
+<description>
+Return value: the entry's icon window at @icon_pos.
+
+</description>
+<parameters>
+<parameter name="entry">
+<parameter_description> A #GtkEntry
+</parameter_description>
+</parameter>
+<parameter name="icon_pos">
+<parameter_description> Icon position
+</parameter_description>
+</parameter>
+</parameters>
+<return> the entry's icon window at @icon_pos.
+
+Since: 2.20
+</return>
+</function>
+
 <function name="gtk_text_view_add_child_in_window">
 <description>
 Adds a child at fixed coordinates in one of the text widget's
@@ -44003,6 +44073,50 @@ Since: 2.4
 </return>
 </function>
 
+<function name="gtk_range_get_min_slider_size">
+<description>
+This function is useful mainly for #GtkRange subclasses.
+
+See gtk_range_set_min_slider_size().
+
+
+</description>
+<parameters>
+<parameter name="range">
+<parameter_description> a #GtkRange
+</parameter_description>
+</parameter>
+</parameters>
+<return> The minimum size of the range's slider.
+
+Since: 2.20
+</return>
+</function>
+
+<function name="gtk_tree_model_get_iter">
+<description>
+Sets @iter to a valid iterator pointing to @path.
+
+
+</description>
+<parameters>
+<parameter name="tree_model">
+<parameter_description> A #GtkTreeModel.
+</parameter_description>
+</parameter>
+<parameter name="iter">
+<parameter_description> The uninitialized #GtkTreeIter.
+</parameter_description>
+</parameter>
+<parameter name="path">
+<parameter_description> The #GtkTreePath.
+</parameter_description>
+</parameter>
+</parameters>
+<return> %TRUE, if @iter was set.
+</return>
+</function>
+
 <function name="gtk_accel_map_load">
 <description>
 Parses a file previously saved with gtk_accel_map_save() for
@@ -47741,6 +47855,31 @@ title.
 <return></return>
 </function>
 
+<function name="gtk_assistant_set_page_title">
+<description>
+Sets a title for @page. The title is displayed in the header
+area of the assistant when @page is the current page.
+
+Since: 2.10
+
+</description>
+<parameters>
+<parameter name="assistant">
+<parameter_description> a #GtkAssistant
+</parameter_description>
+</parameter>
+<parameter name="page">
+<parameter_description> a page of @assistant
+</parameter_description>
+</parameter>
+<parameter name="title">
+<parameter_description> the new title for @page
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_clipboard_wait_is_rich_text_available">
 <description>
 Test to see if there is rich text available to be pasted
@@ -48960,28 +49099,42 @@ views, since they depend on the contents of the #GtkTextBuffer.
 </return>
 </function>
 
-<function name="gtk_tree_model_get_iter">
+<function name="gtk_file_filter_add_custom">
 <description>
-Sets @iter to a valid iterator pointing to @path.
+Adds rule to a filter that allows files based on a custom callback
+function. The bitfield @needed which is passed in provides information
+about what sorts of information that the filter function needs;
+this allows GTK+ to avoid retrieving expensive information when
+it isn't needed by the filter.
 
+Since: 2.4
 
 </description>
 <parameters>
-<parameter name="tree_model">
-<parameter_description> A #GtkTreeModel.
+<parameter name="filter">
+<parameter_description> a #GtkFileFilter
 </parameter_description>
 </parameter>
-<parameter name="iter">
-<parameter_description> The uninitialized #GtkTreeIter.
+<parameter name="needed">
+<parameter_description> bitfield of flags indicating the information that the custom
+filter function needs.
 </parameter_description>
 </parameter>
-<parameter name="path">
-<parameter_description> The #GtkTreePath.
+<parameter name="func">
+<parameter_description> callback function; if the function returns %TRUE, then
+the file will be displayed.
+</parameter_description>
+</parameter>
+<parameter name="data">
+<parameter_description> data to pass to @func
+</parameter_description>
+</parameter>
+<parameter name="notify">
+<parameter_description> function to call to free @data when it is no longer needed.
 </parameter_description>
 </parameter>
 </parameters>
-<return> %TRUE, if @iter was set.
-</return>
+<return></return>
 </function>
 
 <function name="gtk_cell_layout_get_cells">
@@ -61478,6 +61631,29 @@ Since: 2.18
 </return>
 </function>
 
+<function name="gtk_status_icon_set_name">
+<description>
+Sets the name of this tray icon.
+This should be a string identifying this icon. It is may be
+used for sorting the icons in the tray and will not be shown to
+the user.
+
+Since: 2.20
+
+</description>
+<parameters>
+<parameter name="status_icon">
+<parameter_description> a #GtkStatusIcon
+</parameter_description>
+</parameter>
+<parameter name="name">
+<parameter_description> the name
+</parameter_description>
+</parameter>
+</parameters>
+<return></return>
+</function>
+
 <function name="gtk_icon_view_unset_model_drag_dest">
 <description>
 Undoes the effect of gtk_icon_view_enable_model_drag_dest(). Calling this
@@ -69612,6 +69788,26 @@ longer needed.
 </return>
 </function>
 
+<function name="gtk_recent_manager_new">
+<description>
+Creates a new recent manager object.  Recent manager objects are used to
+handle the list of recently used resources.  A #GtkRecentManager object
+monitors the recently used resources list, and emits the &quot;changed&quot; signal
+each time something inside the list changes.
+
+#GtkRecentManager objects are expensive: be sure to create them only when
+needed. You should use gtk_recent_manager_get_default() instead.
+
+
+</description>
+<parameters>
+</parameters>
+<return> A newly created #GtkRecentManager object.
+
+Since: 2.10
+</return>
+</function>
+
 <function name="gtk_icon_size_lookup_for_settings">
 <description>
 Obtains the pixel size of a semantic icon size, possibly
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]