+2002-11-28 Matthias Clasen <maclas@gmx.de>
+
+ * gdk/gdkdisplay.c:
+ * gdk/gdkdisplaymanager.c:
+ * gdk/gdk.c:
+ * gdk/gdkdraw.c:
+ * gdk/gdkevents.c:
+ * gdk/gdkrgb.c:
+ * gdk/gdkscreen.c:
+ * gdk/gdkwindow.c:
+ * gdk/x11/gdkcolor-x11.c:
+ * gdk/x11/gdkcursor-x11.c:
+ * gdk/x11/gdkdisplay-x11.c:
+ * gdk/x11/gdkdnd-x11.c:
+ * gdk/x11/gdkevents-x11.c:
+ * gdk/x11/gdkfont-x11.c:
+ * gdk/x11/gdkgc-x11.c:
+ * gdk/x11/gdkinput.c:
+ * gdk/x11/gdkkeys-x11.c:
+ * gdk/x11/gdkpango-x11.c:
+ * gdk/x11/gdkpixmap-x11.c:
+ * gdk/x11/gdkproperty-x11.c:
+ * gdk/x11/gdkscreen-x11.c:
+ * gdk/x11/gdkselection-x11.c:
+ * gdk/x11/gdkvisual-x11.c:
+ * gdk/x11/gdkwindow-x11.c:
+ * gdk/x11/gdkxid.c:
+ * gtk/gtkclipboard.c:
+ * gtk/gtkcolorsel.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkinvisible.c:
+ * gtk/gtkliststore.c:
+ * gtk/gtkmenu.c:
+ * gtk/gtkmenushell.c:
+ * gtk/gtknotebook.c:
+ * gtk/gtkplug.c:
+ * gtk/gtkselection.c:
+ * gtk/gtksettings.c:
+ * gtk/gtktreemodel.c:
+ * gtk/gtktreemodelsort.c:
+ * gtk/gtktreeselection.c:
+ * gtk/gtktreestore.c:
+ * gtk/gtktreeview.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkwindow.c: Document 2.2 API additions. I'm not
+ going to list all individual functions here; if you want to see
+ the list, grep for "Since: 2.2".
+
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
2002-11-25 Matthias Clasen <maclas@gmx.de>
- * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
+ * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>
+2002-11-28 Matthias Clasen <maclas@gmx.de>
+
+ * gdk/gdkdisplay.c:
+ * gdk/gdkdisplaymanager.c:
+ * gdk/gdk.c:
+ * gdk/gdkdraw.c:
+ * gdk/gdkevents.c:
+ * gdk/gdkrgb.c:
+ * gdk/gdkscreen.c:
+ * gdk/gdkwindow.c:
+ * gdk/x11/gdkcolor-x11.c:
+ * gdk/x11/gdkcursor-x11.c:
+ * gdk/x11/gdkdisplay-x11.c:
+ * gdk/x11/gdkdnd-x11.c:
+ * gdk/x11/gdkevents-x11.c:
+ * gdk/x11/gdkfont-x11.c:
+ * gdk/x11/gdkgc-x11.c:
+ * gdk/x11/gdkinput.c:
+ * gdk/x11/gdkkeys-x11.c:
+ * gdk/x11/gdkpango-x11.c:
+ * gdk/x11/gdkpixmap-x11.c:
+ * gdk/x11/gdkproperty-x11.c:
+ * gdk/x11/gdkscreen-x11.c:
+ * gdk/x11/gdkselection-x11.c:
+ * gdk/x11/gdkvisual-x11.c:
+ * gdk/x11/gdkwindow-x11.c:
+ * gdk/x11/gdkxid.c:
+ * gtk/gtkclipboard.c:
+ * gtk/gtkcolorsel.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkinvisible.c:
+ * gtk/gtkliststore.c:
+ * gtk/gtkmenu.c:
+ * gtk/gtkmenushell.c:
+ * gtk/gtknotebook.c:
+ * gtk/gtkplug.c:
+ * gtk/gtkselection.c:
+ * gtk/gtksettings.c:
+ * gtk/gtktreemodel.c:
+ * gtk/gtktreemodelsort.c:
+ * gtk/gtktreeselection.c:
+ * gtk/gtktreestore.c:
+ * gtk/gtktreeview.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkwindow.c: Document 2.2 API additions. I'm not
+ going to list all individual functions here; if you want to see
+ the list, grep for "Since: 2.2".
+
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
2002-11-25 Matthias Clasen <maclas@gmx.de>
- * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
+ * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>
+2002-11-28 Matthias Clasen <maclas@gmx.de>
+
+ * gdk/gdkdisplay.c:
+ * gdk/gdkdisplaymanager.c:
+ * gdk/gdk.c:
+ * gdk/gdkdraw.c:
+ * gdk/gdkevents.c:
+ * gdk/gdkrgb.c:
+ * gdk/gdkscreen.c:
+ * gdk/gdkwindow.c:
+ * gdk/x11/gdkcolor-x11.c:
+ * gdk/x11/gdkcursor-x11.c:
+ * gdk/x11/gdkdisplay-x11.c:
+ * gdk/x11/gdkdnd-x11.c:
+ * gdk/x11/gdkevents-x11.c:
+ * gdk/x11/gdkfont-x11.c:
+ * gdk/x11/gdkgc-x11.c:
+ * gdk/x11/gdkinput.c:
+ * gdk/x11/gdkkeys-x11.c:
+ * gdk/x11/gdkpango-x11.c:
+ * gdk/x11/gdkpixmap-x11.c:
+ * gdk/x11/gdkproperty-x11.c:
+ * gdk/x11/gdkscreen-x11.c:
+ * gdk/x11/gdkselection-x11.c:
+ * gdk/x11/gdkvisual-x11.c:
+ * gdk/x11/gdkwindow-x11.c:
+ * gdk/x11/gdkxid.c:
+ * gtk/gtkclipboard.c:
+ * gtk/gtkcolorsel.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkinvisible.c:
+ * gtk/gtkliststore.c:
+ * gtk/gtkmenu.c:
+ * gtk/gtkmenushell.c:
+ * gtk/gtknotebook.c:
+ * gtk/gtkplug.c:
+ * gtk/gtkselection.c:
+ * gtk/gtksettings.c:
+ * gtk/gtktreemodel.c:
+ * gtk/gtktreemodelsort.c:
+ * gtk/gtktreeselection.c:
+ * gtk/gtktreestore.c:
+ * gtk/gtktreeview.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkwindow.c: Document 2.2 API additions. I'm not
+ going to list all individual functions here; if you want to see
+ the list, grep for "Since: 2.2".
+
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
2002-11-25 Matthias Clasen <maclas@gmx.de>
- * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
+ * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>
+2002-11-28 Matthias Clasen <maclas@gmx.de>
+
+ * gdk/gdkdisplay.c:
+ * gdk/gdkdisplaymanager.c:
+ * gdk/gdk.c:
+ * gdk/gdkdraw.c:
+ * gdk/gdkevents.c:
+ * gdk/gdkrgb.c:
+ * gdk/gdkscreen.c:
+ * gdk/gdkwindow.c:
+ * gdk/x11/gdkcolor-x11.c:
+ * gdk/x11/gdkcursor-x11.c:
+ * gdk/x11/gdkdisplay-x11.c:
+ * gdk/x11/gdkdnd-x11.c:
+ * gdk/x11/gdkevents-x11.c:
+ * gdk/x11/gdkfont-x11.c:
+ * gdk/x11/gdkgc-x11.c:
+ * gdk/x11/gdkinput.c:
+ * gdk/x11/gdkkeys-x11.c:
+ * gdk/x11/gdkpango-x11.c:
+ * gdk/x11/gdkpixmap-x11.c:
+ * gdk/x11/gdkproperty-x11.c:
+ * gdk/x11/gdkscreen-x11.c:
+ * gdk/x11/gdkselection-x11.c:
+ * gdk/x11/gdkvisual-x11.c:
+ * gdk/x11/gdkwindow-x11.c:
+ * gdk/x11/gdkxid.c:
+ * gtk/gtkclipboard.c:
+ * gtk/gtkcolorsel.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkinvisible.c:
+ * gtk/gtkliststore.c:
+ * gtk/gtkmenu.c:
+ * gtk/gtkmenushell.c:
+ * gtk/gtknotebook.c:
+ * gtk/gtkplug.c:
+ * gtk/gtkselection.c:
+ * gtk/gtksettings.c:
+ * gtk/gtktreemodel.c:
+ * gtk/gtktreemodelsort.c:
+ * gtk/gtktreeselection.c:
+ * gtk/gtktreestore.c:
+ * gtk/gtktreeview.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkwindow.c: Document 2.2 API additions. I'm not
+ going to list all individual functions here; if you want to see
+ the list, grep for "Since: 2.2".
+
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
2002-11-25 Matthias Clasen <maclas@gmx.de>
- * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
+ * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>
+2002-11-28 Matthias Clasen <maclas@gmx.de>
+
+ * gdk/gdkdisplay.c:
+ * gdk/gdkdisplaymanager.c:
+ * gdk/gdk.c:
+ * gdk/gdkdraw.c:
+ * gdk/gdkevents.c:
+ * gdk/gdkrgb.c:
+ * gdk/gdkscreen.c:
+ * gdk/gdkwindow.c:
+ * gdk/x11/gdkcolor-x11.c:
+ * gdk/x11/gdkcursor-x11.c:
+ * gdk/x11/gdkdisplay-x11.c:
+ * gdk/x11/gdkdnd-x11.c:
+ * gdk/x11/gdkevents-x11.c:
+ * gdk/x11/gdkfont-x11.c:
+ * gdk/x11/gdkgc-x11.c:
+ * gdk/x11/gdkinput.c:
+ * gdk/x11/gdkkeys-x11.c:
+ * gdk/x11/gdkpango-x11.c:
+ * gdk/x11/gdkpixmap-x11.c:
+ * gdk/x11/gdkproperty-x11.c:
+ * gdk/x11/gdkscreen-x11.c:
+ * gdk/x11/gdkselection-x11.c:
+ * gdk/x11/gdkvisual-x11.c:
+ * gdk/x11/gdkwindow-x11.c:
+ * gdk/x11/gdkxid.c:
+ * gtk/gtkclipboard.c:
+ * gtk/gtkcolorsel.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkinvisible.c:
+ * gtk/gtkliststore.c:
+ * gtk/gtkmenu.c:
+ * gtk/gtkmenushell.c:
+ * gtk/gtknotebook.c:
+ * gtk/gtkplug.c:
+ * gtk/gtkselection.c:
+ * gtk/gtksettings.c:
+ * gtk/gtktreemodel.c:
+ * gtk/gtktreemodelsort.c:
+ * gtk/gtktreeselection.c:
+ * gtk/gtktreestore.c:
+ * gtk/gtktreeview.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkwindow.c: Document 2.2 API additions. I'm not
+ going to list all individual functions here; if you want to see
+ the list, grep for "Since: 2.2".
+
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
2002-11-25 Matthias Clasen <maclas@gmx.de>
- * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
+ * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>
+2002-11-28 Matthias Clasen <maclas@gmx.de>
+
+ * gdk/gdkdisplay.c:
+ * gdk/gdkdisplaymanager.c:
+ * gdk/gdk.c:
+ * gdk/gdkdraw.c:
+ * gdk/gdkevents.c:
+ * gdk/gdkrgb.c:
+ * gdk/gdkscreen.c:
+ * gdk/gdkwindow.c:
+ * gdk/x11/gdkcolor-x11.c:
+ * gdk/x11/gdkcursor-x11.c:
+ * gdk/x11/gdkdisplay-x11.c:
+ * gdk/x11/gdkdnd-x11.c:
+ * gdk/x11/gdkevents-x11.c:
+ * gdk/x11/gdkfont-x11.c:
+ * gdk/x11/gdkgc-x11.c:
+ * gdk/x11/gdkinput.c:
+ * gdk/x11/gdkkeys-x11.c:
+ * gdk/x11/gdkpango-x11.c:
+ * gdk/x11/gdkpixmap-x11.c:
+ * gdk/x11/gdkproperty-x11.c:
+ * gdk/x11/gdkscreen-x11.c:
+ * gdk/x11/gdkselection-x11.c:
+ * gdk/x11/gdkvisual-x11.c:
+ * gdk/x11/gdkwindow-x11.c:
+ * gdk/x11/gdkxid.c:
+ * gtk/gtkclipboard.c:
+ * gtk/gtkcolorsel.c:
+ * gtk/gtkiconfactory.c:
+ * gtk/gtkinvisible.c:
+ * gtk/gtkliststore.c:
+ * gtk/gtkmenu.c:
+ * gtk/gtkmenushell.c:
+ * gtk/gtknotebook.c:
+ * gtk/gtkplug.c:
+ * gtk/gtkselection.c:
+ * gtk/gtksettings.c:
+ * gtk/gtktreemodel.c:
+ * gtk/gtktreemodelsort.c:
+ * gtk/gtktreeselection.c:
+ * gtk/gtktreestore.c:
+ * gtk/gtktreeview.c:
+ * gtk/gtktreeviewcolumn.c:
+ * gtk/gtkwidget.c:
+ * gtk/gtkwindow.c: Document 2.2 API additions. I'm not
+ going to list all individual functions here; if you want to see
+ the list, grep for "Since: 2.2".
+
Tue Nov 26 13:07:56 2002 HideToshi Tajima <hidetoshi.tajima@sun.com>
* modules/input/gtkimcontextxim.c
2002-11-25 Matthias Clasen <maclas@gmx.de>
- * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
+ * docs/tutorial/gtk-tut.sgml: Fix the ftp download url.
Mon Nov 25 19:10:54 2002 Soeren Sandmann <sandmann@daimi.au.dk>
@str:
@Returns:
+<!-- ##### FUNCTION gtk_list_store_move ##### -->
+<para>
+
+</para>
+
+@store:
+@iter:
+@position:
+
<!-- ##### FUNCTION gtk_list_store_new_with_types ##### -->
<para>
@tree_model:
@iter:
+<!-- ##### FUNCTION gtk_tree_store_move ##### -->
+<para>
+
+</para>
+
+@tree_store:
+@iter:
+@position:
+
<!-- ##### FUNCTION gtk_tree_store_new_with_types ##### -->
<para>
@GTK_CELL_RENDERER_PRELIT: The mouse is hovering over the cell.
@GTK_CELL_RENDERER_INSENSITIVE: The cell is drawn in an insensitive manner
@GTK_CELL_RENDERER_SORTED: The cell is in a sorted row
+@GTK_CELL_RENDERER_FOCUSED:
<!-- ##### ENUM GtkCellRendererMode ##### -->
<para>
</para>
+<!-- ##### ARG GtkCellRendererToggle:inconsistent ##### -->
+<para>
+
+</para>
+
<!-- ##### ARG GtkCellRendererToggle:radio ##### -->
<para>
@b:
-<!-- ##### FUNCTION gtk_list_store_move ##### -->
-<para>
-
-</para>
-
-@store:
-@iter:
-@position:
-
-
@b:
-<!-- ##### FUNCTION gtk_tree_store_move ##### -->
+<!-- ##### FUNCTION gtk_tree_store_move_before ##### -->
+<para>
+
+</para>
+
+@tree_store:
+@iter:
+@position:
+
+
+<!-- ##### FUNCTION gtk_tree_store_move_after ##### -->
<para>
</para>
@arg1:
@arg2:
@arg3:
+@Returns:
<!-- ##### SIGNAL GtkTreeView::move-cursor ##### -->
<para>
</para>
@treeview: the object which received the signal.
+@Returns:
<!-- ##### SIGNAL GtkTreeView::select-cursor-parent ##### -->
<para>
</para>
@treeview: the object which received the signal.
+@Returns:
<!-- ##### SIGNAL GtkTreeView::select-cursor-row ##### -->
<para>
@treeview: the object which received the signal.
@arg1:
+@Returns:
<!-- ##### SIGNAL GtkTreeView::set-scroll-adjustments ##### -->
<para>
</para>
@treeview: the object which received the signal.
+@Returns:
<!-- ##### SIGNAL GtkTreeView::test-collapse-row ##### -->
<para>
</para>
@treeview: the object which received the signal.
+@Returns:
<!-- ##### SIGNAL GtkTreeView::unselect-all ##### -->
<para>
</para>
@treeview: the object which received the signal.
+@Returns:
<!-- ##### ARG GtkTreeView:enable-search ##### -->
<para>
@Returns:
+<!-- ##### FUNCTION gtk_window_set_auto_startup_notification ##### -->
+<para>
+
+</para>
+
+@setting:
+
+
<!-- ##### FUNCTION gtk_decorated_window_init ##### -->
<para>
+2002-11-28 Matthias Clasen <maclas@gmx.de>
+
+ * gdk-pixbuf/gdk-pixbuf-io.c:
+ * gdk-pixbuf/gdk-pixbuf-loader.c:
+ * gdk-pixbuf/gdk-pixbuf.c: Document 2.2 API additions. I'm not
+ going to list all individual functions here; if you want to see
+ the list, grep for "Since: 2.2".
+
Fri Nov 8 19:06:07 2002 Owen Taylor <otaylor@redhat.com>
* Makefile.am (gdk-pixbuf.loaders): Make gdk-pixbuf.loaders
* Returns the name of the format.
*
* Return value: the name of the format.
+ *
+ * Since: 2.2
*/
gchar *
gdk_pixbuf_format_get_name (GdkPixbufFormat *format)
* Returns a description of the format.
*
* Return value: a description of the format.
+ *
+ * Since: 2.2
*/
gchar *
gdk_pixbuf_format_get_description (GdkPixbufFormat *format)
* Returns the mime types supported by the format.
*
* Return value: a %NULL-terminated array of mime types.
+ *
+ * Since: 2.2
*/
gchar **
gdk_pixbuf_format_get_mime_types (GdkPixbufFormat *format)
* gdk_pixbuf_format_get_extensions:
* @format: a #GdkPixbufFormat
*
- * Returns the filename extensions typically used for files in the given format.
+ * Returns the filename extensions typically used for files in the
+ * given format.
*
* Return value: a %NULL-terminated array of filename extensions.
+ *
+ * Since: 2.2
*/
gchar **
gdk_pixbuf_format_get_extensions (GdkPixbufFormat *format)
* Returns whether pixbufs can be saved in the given format.
*
* Return value: whether pixbufs can be saved in the given format.
+ *
+ * Since: 2.2
*/
gboolean
gdk_pixbuf_format_is_writable (GdkPixbufFormat *format)
* image formats. The list should be freed when it is no longer needed,
* but the structures themselves are owned by #GdkPixbuf and should not be
* freed.
+ *
+ * Since: 2.2
*/
GSList *
gdk_pixbuf_get_formats (void)
*
* Attempts to set the desired image size are ignored after the
* emission of the ::size_prepared signal.
+ *
+ * Since: 2.2
*/
void
gdk_pixbuf_loader_set_size (GdkPixbufLoader *loader,
*
* Returns: A #GdkPixbufFormat or %NULL. The return value is owned
* by GdkPixbuf and should not be freed.
+ *
+ * Since: 2.2
*/
GdkPixbufFormat *
gdk_pixbuf_loader_get_format (GdkPixbufLoader *loader)
* ignored and %FALSE is returned.
*
* Return value: %TRUE on success.
+ *
+ * Since: 2.2
**/
gboolean
gdk_pixbuf_set_option (GdkPixbuf *pixbuf,
*
* You shouldn't call this function explicitely if you are using
* gtk_init(), gtk_init_check(), gdk_init(), or gdk_init_check().
+ *
+ * Since: 2.2
**/
void
gdk_parse_args (int *argc,
*
* Returns: the display name, if specified explicitely, otherwise %NULL
* this string is owned by GTK+ and must not be modified or freed.
+ *
+ * Since: 2.2
*/
G_CONST_RETURN gchar *
gdk_get_display_arg_name (void)
*
* Closes the connection windowing system for the given display,
* and cleans up associated resources.
+ *
+ * Since: 2.2
*/
void
gdk_display_close (GdkDisplay *display)
*
* Return value: the next #GdkEvent to be processed, or %NULL if no events
* are pending. The returned #GdkEvent should be freed with gdk_event_free().
+ *
+ * Since: 2.2
**/
GdkEvent*
gdk_display_get_event (GdkDisplay *display)
* not get more events from the windowing system. It only checks the events
* that have already been moved to the GDK event queue.)
*
- * Return value: a copy of the first #GdkEvent on the event queue, or %NULL if no
- * events are in the queue. The returned #GdkEvent should be freed with
+ * Return value: a copy of the first #GdkEvent on the event queue, or %NULL
+ * if no events are in the queue. The returned #GdkEvent should be freed with
* gdk_event_free().
+ *
+ * Since: 2.2
**/
GdkEvent*
gdk_display_peek_event (GdkDisplay *display)
*
* Appends a copy of the given event onto the front of the event
* queue for @display.
+ *
+ * Since: 2.2
**/
void
gdk_display_put_event (GdkDisplay *display,
/**
* gdk_pointer_ungrab:
- * @time_: a timestamp from a #GdkEvent, or %GDK_CURRENT_TIME if no timestamp is
- * available.
+ * @time_: a timestamp from a #GdkEvent, or %GDK_CURRENT_TIME if no
+ * timestamp is available.
*
* Ungrabs the pointer, if it is grabbed by this application.
**/
*
* Return value: the core pointer device; this is owned by the
* display and should not be freed.
+ *
+ * Since: 2.2
**/
GdkDevice *
gdk_display_get_core_pointer (GdkDisplay *display)
*
* Gets the current location of the pointer and the current modifier
* mask for a given display.
+ *
+ * Since: 2.2
**/
void
gdk_display_get_pointer (GdkDisplay *display,
* another application).
*
* Returns: the window under the mouse pointer, or %NULL
+ *
+ * Since: 2.2
**/
GdkWindow *
gdk_display_get_window_at_pointer (GdkDisplay *display,
* reason to use this facility.
*
* Return value: the previous pointer hook table
+ *
+ * Since: 2.2
**/
GdkDisplayPointerHooks *
gdk_display_set_pointer_hooks (GdkDisplay *display,
*
* Returns the global #GdkDisplayManager singleton; gdk_parse_pargs(),
* gdk_init(), or gdk_init_check() must have been called first.
+ *
+ * Since: 2.2
**/
GdkDisplayManager*
gdk_display_manager_get (void)
*
* Returns: a #GdkDisplay, or %NULL if there is no default
* display.
+ *
+ * Since: 2.2
*/
GdkDisplay *
gdk_display_manager_get_default_display (GdkDisplayManager *display_manager)
*
* Returns: a #GdkDisplay, or %NULL if there is no default
* display.
+ *
+ * Since: 2.2
*/
GdkDisplay *
gdk_display_get_default (void)
* gdk_display_get_default ()).
*
* Returns: a #GdkScreen, or %NULL if there is no default display.
+ *
+ * Since: 2.2
*/
GdkScreen *
gdk_screen_get_default (void)
* @display: a #GdkDisplay
*
* Sets @display as the default display.
+ *
+ * Since: 2.2
**/
void
gdk_display_manager_set_default_display (GdkDisplayManager *display_manager,
*
* Return value: a newly allocated #GSList of #GdkDisplay objects.
* Free this list with g_slist_free() when you are done with it.
+ *
+ * Since: 2.2
**/
GSList *
gdk_display_manager_list_displays (GdkDisplayManager *display_manager)
* Gets the #GdkScreen associated with a #GdkDrawable.
*
* Return value: the #GdkScreen associated with @drawable
+ *
+ * Since: 2.2
**/
GdkScreen*
gdk_drawable_get_screen(GdkDrawable *drawable)
* Gets the #GdkDisplay associated with a #GdkDrawable.
*
* Return value: the #GdkDisplay associated with @drawable
+ *
+ * Since: 2.2
**/
GdkDisplay*
gdk_drawable_get_display (GdkDrawable *drawable)
* @dest_y: Destination Y coordinate within drawable.
* @width: Width of region to render, in pixels, or -1 to use pixbuf width.
* @height: Height of region to render, in pixels, or -1 to use pixbuf height.
- * @dither: Dithering mode for GdkRGB.
+ * @dither: Dithering mode for #GdkRGB.
* @x_dither: X offset for dither.
* @y_dither: Y offset for dither.
*
* Renders a rectangular portion of a pixbuf to a drawable. The destination
* drawable must have a colormap. All windows have a colormap, however, pixmaps
- * only have colormap by default if they were created with a non-NULL window argument.
- * Otherwise a colormap must be set on them with gdk_drawable_set_colormap.
+ * only have colormap by default if they were created with a non-%NULL window
+ * argument. Otherwise a colormap must be set on them with
+ * gdk_drawable_set_colormap().
+ *
+ * On older X servers, rendering pixbufs with an alpha channel involves round
+ * trips to the X server, and may be somewhat slow.
*
- * On older X servers, rendering pixbufs with an alpha channel involves round trips
- * to the X server, and may be somewhat slow.
+ * Since: 2.2
**/
void
gdk_draw_pixbuf (GdkDrawable *drawable,
*
* Return value: a newly-allocated #GdkEvent. The returned #GdkEvent
* should be freed with gdk_event_free().
+ *
+ * Since: 2.2
**/
GdkEvent*
gdk_event_new (GdkEventType type)
* Sets the screen for @event to @screen. The event must
* have been allocated by GTK+, for instance, by
* gdk_event_copy().
+ *
+ * Since: 2.2
**/
void
gdk_event_set_screen (GdkEvent *event,
* @event: a #GdkEvent
*
* Returns the screen for the event. The screen is
- * typically the screen for event->any.window, but
+ * typically the screen for <literal>event->any.window</literal>, but
* for events such as mouse events, it is the screen
* where the the pointer was when the event occurs -
* that is, the screen which has the root window
- * to which event->motion.x_root and
- * event->motion.y_root are relative.
+ * to which <literal>event->motion.x_root</literal> and
+ * <literal>event->motion.y_root</literal> are relative.
*
* Return value: the screen for the event
+ *
+ * Since: 2.2
**/
GdkScreen *
gdk_event_get_screen (GdkEvent *event)
* Sets the double click time (two clicks within this time interval
* count as a double click and result in a #GDK_2BUTTON_PRESS event).
* Applications should NOT set this, it is a global user-configured setting.
+ *
+ * Since: 2.2
**/
void
gdk_display_set_double_click_time (GdkDisplay *display,
/**
* gdk_screen_get_rgb_colormap:
- * @screen : a #GdkScreen.
+ * @screen: a #GdkScreen.
*
* Gets the preferred colormap for rendering image data on @screen.
* Not a very useful function; historically, GDK could only render RGB
* call this function.
*
* Return value: the preferred colormap
+ *
+ * Since: 2.2
**/
GdkColormap *
gdk_screen_get_rgb_colormap (GdkScreen *screen)
/**
* gdk_screen_get_rgb_visual:
- * @screen : a #GdkScreen
+ * @screen: a #GdkScreen
*
* Gets a "preferred visual" chosen by GdkRGB for rendering image data
* on @screen. In previous versions of
* drawables with any visual.
*
* Return value: The #GdkVisual chosen by GdkRGB.
+ *
+ * Since: 2.2
**/
GdkVisual *
gdk_screen_get_rgb_visual (GdkScreen *screen)
/**
* gdk_screen_get_monitor_at_point:
- * @screen : a #GdkScreen.
- * @x : the x coordinate in the virtual screen.
- * @y : the y coordinate in the virtual screen.
+ * @screen: a #GdkScreen.
+ * @x: the x coordinate in the virtual screen.
+ * @y: the y coordinate in the virtual screen.
*
* Returns the monitor number in which the point (@x,@y) is located.
*
* Returns: the monitor number in which the point (@x,@y) belong, or
* -1 if the point is not in any monitor.
+ *
+ * Since: 2.2
**/
gint
gdk_screen_get_monitor_at_point (GdkScreen *screen,
* @window: a #GdkWindow
* @returns: the monitor number in which most of @window is located.
*
- * Returns the number of the monitor in which the largest area of the bounding rectangle
- * of @window resides.
+ * Returns the number of the monitor in which the largest area of the
+ * bounding rectangle of @window resides.
+ *
+ * Since: 2.2
**/
gint
gdk_screen_get_monitor_at_window (GdkScreen *screen,
*
* Returns the width of the default screen in pixels.
*
- * Return value: the width of the default screen in pixels.
+ * Return value: the width of the default screen in pixels.
**/
gint
gdk_screen_width (void)
/**
* gdk_screen_get_toplevel_windows:
- * @screen : The #GdkScreen where the toplevels are located.
+ * @screen: The #GdkScreen where the toplevels are located.
*
* Obtains a list of all toplevel windows known to GDK on the screen @screen.
* A toplevel window is a child of the root window (see
* its elements need not be freed.
*
* Return value: list of toplevel windows, free with g_list_free()
+ *
+ * Since: 2.2
**/
GList *
gdk_screen_get_toplevel_windows (GdkScreen *screen)
* Gets the system's default colormap for @screen
*
* Returns: the default colormap for @screen.
+ *
+ * Since: 2.2
*/
GdkColormap *
gdk_screen_get_system_colormap (GdkScreen *screen)
* with gdk_x11_colormap_foreign_new(), unref'ing the last
* reference to the object will only free the #GdkColoramp
* object and not call XFreeColormap()
+ *
+ * Since: 2.2
**/
GdkColormap *
gdk_x11_colormap_foreign_new (GdkVisual *visual,
* Gets the screen for which this colormap was created.
*
* Return value: the screen for which this colormap was created.
+ *
+ * Since: 2.2
**/
GdkScreen *
gdk_colormap_get_screen (GdkColormap *cmap)
* a cursor with no pixels in it.
*
* Return value: a new #GdkCursor
+ *
+ * Since: 2.2
**/
GdkCursor*
gdk_cursor_new_for_display (GdkDisplay *display,
/**
* gdk_cursor_get_display:
- * @cursor : a #GdkCursor.
+ * @cursor: a #GdkCursor.
+ *
+ * Returns the display on which the #GdkCursor is defined.
*
- * Returns the display on which the GdkCursor is defined
+ * Returns: the #GdkDisplay associated to @cursor
*
- * Returns : the #GdkDisplay associated to @cursor
+ * Since: 2.2
*/
GdkDisplay *
* could not be opened.
*
* Opens a display.
+ *
+ * Since: 2.2
*/
GdkDisplay *
gdk_display_open (const gchar *display_name)
*
* Returns: a string representing the display name. This string is owned
* by GDK and should not be modified or freed.
+ *
+ * Since: 2.2
*/
G_CONST_RETURN gchar *
gdk_display_get_name (GdkDisplay * display)
* Gets the number of screen managed by the @display.
*
* Returns: number of screens.
+ *
+ * Since: 2.2
*/
gint
gdk_display_get_n_screens (GdkDisplay * display)
* @screen_num: the screen number
*
* Returns a screen object for one of the screens of the display.
- *
+ *
* Returns: the #GdkScreen object
+ *
+ * Since: 2.2
*/
GdkScreen *
gdk_display_get_screen (GdkDisplay * display, gint screen_num)
* Get the default #GdkScreen for @display.
*
* Returns: the default #GdkScreen object for @display
+ *
+ * Since: 2.2
*/
GdkScreen *
gdk_display_get_default_screen (GdkDisplay * display)
/**
* gdk_display_pointer_ungrab:
- * @display : a #GdkDisplay.
+ * @display: a #GdkDisplay.
* @time_: a timestap (e.g. GDK_CURRENT_TIME).
*
* Release any pointer grab.
+ *
+ * Since: 2.2
*/
void
gdk_display_pointer_ungrab (GdkDisplay *display,
}
/**
- * gdk_display_pointer_is_grabbed :
- * @display : a #GdkDisplay
+ * gdk_display_pointer_is_grabbed:
+ * @display: a #GdkDisplay
*
* Test if the pointer is grabbed.
*
- * Returns : TRUE if an active X pointer grab is in effect
+ * Returns: %TRUE if an active X pointer grab is in effect
+ *
+ * Since: 2.2
*/
gboolean
gdk_display_pointer_is_grabbed (GdkDisplay * display)
/**
* gdk_display_keyboard_ungrab:
- * @display : a #GdkDisplay.
- * @time_ : a timestap (e.g #GDK_CURRENT_TIME).
+ * @display: a #GdkDisplay.
+ * @time_: a timestap (e.g #GDK_CURRENT_TIME).
*
* Release any keyboard grab
+ *
+ * Since: 2.2
*/
void
gdk_display_keyboard_ungrab (GdkDisplay *display,
*
* Emits a short beep on @display
*
+ * Since: 2.2
*/
void
gdk_display_beep (GdkDisplay * display)
}
/**
- * gdk_display_sync :
- * @display : a #GdkDisplay
+ * gdk_display_sync:
+ * @display: a #GdkDisplay
*
* Flushes any requests queued for the windowing system and waits until all
* requests have been handled. This is often used for making sure that the
* display is synchronized with the current state of the program. Calling
* gdk_display_sync() before gdk_error_trap_pop() makes sure that any errors
- * generated from earlier requests are handled before the error trap is removed.
+ * generated from earlier requests are handled before the error trap is
+ * removed.
*
* This is most useful for X11. On windowing systems where requests are
* handled synchronously, this function will do nothing.
+ *
+ * Since: 2.2
*/
void
gdk_display_sync (GdkDisplay * display)
* To ungrab the display again, use gdk_x11_display_ungrab().
*
* gdk_x11_display_grab()/gdk_x11_display_ungrab() calls can be nested.
+ *
+ * Since: 2.2
**/
void
gdk_x11_display_grab (GdkDisplay * display)
*
* Ungrab @display after it has been grabbed with
* gdk_x11_display_grab().
+ *
+ * Since: 2.2
**/
void
gdk_x11_display_ungrab (GdkDisplay * display)
* Find the #GdkDisplay corresponding to @display, if any exists.
*
* Return value: the #GdkDisplay, if found, otherwise %NULL.
+ *
+ * Since: 2.2
**/
GdkDisplay *
gdk_x11_lookup_xdisplay (Display *xdisplay)
* @returns: an X display.
*
* Returns the X display of a #GdkDisplay.
+ *
+ * Since: 2.2
*/
Display *
gdk_x11_display_get_xdisplay (GdkDisplay *display)
* windows.
*
* GTK+ will call this function automatically after opening the first
- * #GtkWindow unless
- * gtk_window_set_auto_startup_notification() is called to disable
- * that feature.
+ * #GtkWindow unless gtk_window_set_auto_startup_notification() is called
+ * to disable that feature.
+ *
+ * Since: 2.2
**/
void
gdk_notify_startup_complete (void)
* support Drag and Drop.
*
* Finds out the DND protocol supported by a window.
+ *
+ * Since: 2.2
*/
guint32
gdk_drag_get_protocol_for_display (GdkDisplay *display,
*
* This function is called by the drag source to obtain the
* @dest_window and @protocol parameters for gdk_drag_motion().
+ *
+ * Since: 2.2
**/
void
gdk_drag_find_window_for_screen (GdkDragContext *context,
*
* Adds a filter to be called when X ClientMessage events are received.
*
+ * Since: 2.2
**/
void
gdk_display_add_client_message_filter (GdkDisplay *display,
}
/**
- * gdk_event_send_client_message_for_display :
- * @display : the #GdkDisplay for the window where the message is to be sent.
- * @event : the #GdkEvent to send, which should be a #GdkEventClient.
- * @winid : the window to send the X ClientMessage event to.
+ * gdk_event_send_client_message_for_display:
+ * @display: the #GdkDisplay for the window where the message is to be sent.
+ * @event: the #GdkEvent to send, which should be a #GdkEventClient.
+ * @winid: the window to send the X ClientMessage event to.
*
* Sends an X ClientMessage event to a given window.
*
* This could be used for communicating between different applications,
* though the amount of data is limited to 20 bytes.
*
- * Returns : non-zero on success.
+ * Returns: non-zero on success.
+ *
+ * Since: 2.2
*/
gboolean
gdk_event_send_client_message_for_display (GdkDisplay *display,
/**
* gdk_screen_broadcast_client_message:
- * @screen : the #GdkScreen where the event will be broadcasted.
- * @event : the #GdkEvent.
+ * @screen: the #GdkScreen where the event will be broadcasted.
+ * @event: the #GdkEvent.
*
* Sends an X ClientMessage event to all toplevel windows on @screen.
*
* as described in the Inter-Client Communication Conventions Manual (ICCCM).
* If no windows are found with the WM_STATE property set, the message is
* sent to all children of the root window.
+ *
+ * Since: 2.2
*/
void
* Return value: the name of the window manager screen @screen, or
* "unknown" if the window manager is unknown. The string is owned by GDK
* and should not be freed.
+ *
+ * Since: 2.2
**/
const char*
gdk_x11_screen_get_window_manager_name (GdkScreen *screen)
/**
* gdk_x11_screen_supports_net_wm_hint:
- * @screen : the relevant #GdkScreen.
+ * @screen: the relevant #GdkScreen.
* @property: a property atom.
*
* This function is specific to the X11 backend of GDK, and indicates
* whether the window manager supports a certain hint from the
* Extended Window Manager Hints Specification. You can find this
- * specification on http://www.freedesktop.org.
+ * specification on
+ * <ulink url="http://www.freedesktop.org">http://www.freedesktop.org</ulink>.
*
* When using this function, keep in mind that the window manager
* can change over time; so you shouldn't use this function in
* a window manager change.
*
* Return value: %TRUE if the window manager supports @property
+ *
+ * Since: 2.2
**/
gboolean
gdk_x11_screen_supports_net_wm_hint (GdkScreen *screen,
* FIXME needs a list of valid settings here, or a link to
* more information.
*
- * Returns : %TRUE if the setting existed and a value was stored
+ * Returns: %TRUE if the setting existed and a value was stored
* in @value, %FALSE otherwise.
+ *
+ * Since: 2.2
**/
gboolean
gdk_screen_get_setting (GdkScreen *screen,
*
* Returns the #GdkDisplay for @font.
*
- * Returns : the corresponding #GdkDisplay.
+ * Returns: the corresponding #GdkDisplay.
+ *
+ * Since: 2.2
**/
GdkDisplay*
gdk_font_get_display (GdkFont* font)
*
* The font may be newly loaded or looked up the font in a cache.
* You should make no assumptions about the initial reference count.
+ *
+ * Since: 2.2
*/
GdkFont *
gdk_font_load_for_display (GdkDisplay *display,
*
* Return value: the newly loaded font, or %NULL if the font
* cannot be loaded.
+ *
+ * Since: 2.2
*/
GdkFont *
gdk_font_from_description_for_display (GdkDisplay *display,
*
* The fontset may be newly loaded or looked up in a cache.
* You should make no assumptions about the initial reference count.
+ *
+ * Since: 2.2
*/
GdkFont *
gdk_fontset_load_for_display (GdkDisplay *display,
* Gets the #GdkScreen for which @gc was created
*
* Returns: the #GdkScreen for @gc.
+ *
+ * Since: 2.2
*/
GdkScreen *
gdk_gc_get_screen (GdkGC *gc)
/**
* gdk_display_list_devices:
- * @display : a #GdkDisplay
+ * @display: a #GdkDisplay
*
* Returns the list of available input devices attached to @display.
* The list is statically allocated and should not be freed.
*
* Return value: a list of #GdkDevice
+ *
+ * Since: 2.2
**/
GList *
gdk_display_list_devices (GdkDisplay *display)
* @returns: the #GdkKeymap attached to @display.
*
* Returns the #GdkKeymap attached to @display.
+ *
+ * Since: 2.2
**/
GdkKeymap*
gdk_keymap_get_for_display (GdkDisplay *display)
* the widget you intend to render text onto.
*
* Return value: a new #PangoContext for @screen
+ *
+ * Since: 2.2
**/
PangoContext *
gdk_pango_context_get_for_screen (GdkScreen *screen)
* @display: The #GdkDisplay where @anid is located.
* @anid: a native pixmap handle.
*
- * Wraps a native window in a #GdkPixmap.
+ * Wraps a native pixmap in a #GdkPixmap.
* This may fail if the pixmap has been destroyed.
*
* For example in the X backend, a native pixmap handle is an Xlib
*
* Return value: the newly-created #GdkPixmap wrapper for the
* native pixmap or %NULL if the pixmap has been destroyed.
+ *
+ * Since: 2.2
**/
GdkPixmap *
gdk_pixmap_foreign_new_for_display (GdkDisplay *display,
/**
* gdk_pixmap_lookup_for_display:
- * @display : the #GdkDisplay associated with @anid
+ * @display: the #GdkDisplay associated with @anid
* @anid: a native pixmap handle.
*
* Looks up the #GdkPixmap that wraps the given native pixmap handle.
* For example in the X backend, a native pixmap handle is an Xlib
* <type>XID</type>.
*
- * Return value: the #GdkWindow wrapper for the native window,
+ * Return value: the #GdkPixmap wrapper for the native pixmap,
* or %NULL if there is none.
+ *
+ * Since: 2.2
**/
GdkPixmap*
gdk_pixmap_lookup_for_display (GdkDisplay *display, GdkNativeWindow anid)
* with the same string value.
*
* Return value: the X atom corresponding to @atom.
+ *
+ * Since: 2.2
**/
Atom
gdk_x11_atom_to_xatom_for_display (GdkDisplay *display,
* #GdkAtom.
*
* Return value: the corresponding #GdkAtom.
+ *
+ * Since: 2.2
**/
GdkAtom
gdk_x11_xatom_to_atom_for_display (GdkDisplay *display,
*
* Returns the X atom for a #GdkDisplay corresponding to @atom_name.
* This function caches the result, so if called repeatedly it is much
- * faster than XInternAtom, which is a round trip to the server each time.
+ * faster than XInternAtom(), which is a round trip to the server each time.
*
* Return value: a X atom for a #GdkDisplay
+ *
+ * Since: 2.2
**/
Atom
gdk_x11_get_xatom_by_name_for_display (GdkDisplay *display,
/**
* gdk_x11_get_xatom_name_for_display:
- * @display : the #GdkDisplay where @xatom is defined
+ * @display: the #GdkDisplay where @xatom is defined
* @xatom: an X atom
*
* Returns the name of an X atom for its display. This
* XAtomName() and gdk_atom_name(), the result doesn't need to
* be freed.
*
- * Return value: name of the X atom; this string is owned by GTK+,
+ * Return value: name of the X atom; this string is owned by GDK,
* so it shouldn't be modifed or freed.
+ *
+ * Since: 2.2
**/
G_CONST_RETURN gchar *
gdk_x11_get_xatom_name_for_display (GdkDisplay *display,
* Gets the display to which the @screen belongs.
*
* Returns: the display to which @screen belongs
+ *
+ * Since: 2.2
**/
GdkDisplay *
gdk_screen_get_display (GdkScreen *screen)
* Gets the width of @screen in pixels
*
* Returns: the width of @screen in pixels.
+ *
+ * Since: 2.2
**/
gint
gdk_screen_get_width (GdkScreen *screen)
* Gets the height of @screen in pixels
*
* Returns: the height of @screen in pixels.
+ *
+ * Since: 2.2
**/
gint
gdk_screen_get_height (GdkScreen *screen)
* Note that on some X servers this value will not be correct.
*
* Returns: the width of @screen in pixels.
+ *
+ * Since: 2.2
**/
gint
gdk_screen_get_width_mm (GdkScreen *screen)
* Note that on some X servers this value will not be correct.
*
* Returns: the heigth of @screen in pixels.
+ *
+ * Since: 2.2
**/
gint
gdk_screen_get_height_mm (GdkScreen *screen)
* to which it belongs. (See gdk_screen_get_display())
*
* Returns: the index
+ *
+ * Since: 2.2
**/
gint
gdk_screen_get_number (GdkScreen *screen)
* Gets the root window of @screen.
*
* Returns: the root window
+ *
+ * Since: 2.2
**/
GdkWindow *
gdk_screen_get_root_window (GdkScreen *screen)
* Gets the default colormap for @screen.
*
* Returns: the default #GdkColormap.
+ *
+ * Since: 2.2
**/
GdkColormap *
gdk_screen_get_default_colormap (GdkScreen *screen)
* @colormap: a #GdkColormap
*
* Sets the default @colormap for @screen.
+ *
+ * Since: 2.2
**/
void
gdk_screen_set_default_colormap (GdkScreen *screen,
/**
* gdk_screen_get_n_monitors:
- * @screen : a #GdkScreen.
+ * @screen: a #GdkScreen.
*
* Returns the number of monitors being part of the virtual screen
*
* Returns: number of monitors part of the virtual screen or
* 0 if @screen is not in virtual screen mode.
+ *
+ * Since: 2.2
**/
gint
gdk_screen_get_n_monitors (GdkScreen *screen)
* Note that the virtual screen coordinates can be retrieved via
* gdk_screen_get_width() and gdk_screen_get_height().
*
+ * Since: 2.2
**/
void
gdk_screen_get_monitor_geometry (GdkScreen *screen,
* @returns: an Xlib <type>Screen*</type>
*
* Returns the screen of a #GdkScreen.
+ *
+ * Since: 2.2
*/
Screen *
gdk_x11_screen_get_xscreen (GdkScreen *screen)
* its display.
*
* Returns the index of a #GdkScreen.
+ *
+ * Since: 2.2
*/
int
gdk_x11_screen_get_screen_number (GdkScreen *screen)
* a #GdkDisplay with this screen as the default screen.
*
* Return value: a newly allocated string, free with g_free()
+ *
+ * Since: 2.2
**/
gchar *
gdk_screen_make_display_name (GdkScreen *screen)
}
/**
* gdk_selection_owner_set_for_display:
- * @display : the #GdkDisplay.
- * @owner : a GdkWindow or NULL to indicate that the the owner for
- * the given should be unset.
- * @selection : an atom identifying a selection.
- * @time_ : timestamp to use when setting the selection.
- * If this is older than the timestamp given last time the owner was
- * set for the given selection, the request will be ignored.
- * @send_event : if TRUE, and the new owner is different from the current
- * owner, the current owner will be sent a SelectionClear event.
+ * @display: the #GdkDisplay.
+ * @owner: a #GdkWindow or %NULL to indicate that the the owner for
+ * the given should be unset.
+ * @selection: an atom identifying a selection.
+ * @time_: timestamp to use when setting the selection.
+ * If this is older than the timestamp given last time the owner was
+ * set for the given selection, the request will be ignored.
+ * @send_event: if %TRUE, and the new owner is different from the current
+ * owner, the current owner will be sent a SelectionClear event.
*
* Sets the #GdkWindow @owner as the current owner of the selection @selection.
*
- * Returns : TRUE if the selection owner was succesfully changed to owner,
- * otherwise FALSE.
+ * Returns: %TRUE if the selection owner was successfully changed to owner,
+ * otherwise %FALSE.
+ *
+ * Since: 2.2
*/
gboolean
gdk_selection_owner_set_for_display (GdkDisplay *display,
}
/**
- * gdk_selection_owner_get_for_display :
- * @display : a #GdkDisplay.
- * @selection : an atom indentifying a selection.
+ * gdk_selection_owner_get_for_display:
+ * @display: a #GdkDisplay.
+ * @selection: an atom indentifying a selection.
*
* Determine the owner of the given selection.
*
* process if a foreign window was previously created for that
* window, but a new foreign window will never be created by this call.
*
- * Returns :if there is a selection owner for this window,
- * and it is a window known to the current process, the GdkWindow that owns
- * the selection, otherwise NULL.
+ * Returns: if there is a selection owner for this window, and it is a
+ * window known to the current process, the #GdkWindow that owns the
+ * selection, otherwise %NULL.
+ *
+ * Since: 2.2
*/
-
GdkWindow *
gdk_selection_owner_get_for_display (GdkDisplay *display,
GdkAtom selection)
/**
* gdk_selection_send_notify_for_display:
- * @display : the #GdkDisplay where @requestor is realized
- * @requestor : window to which to deliver response.
- * @selection : selection that was requested.
- * @target : target that was selected.
- * @property : property in which the selection owner stored the data,
- * or GDK_NONE to indicate that the request was rejected.
- * @time_ : timestamp.
+ * @display: the #GdkDisplay where @requestor is realized
+ * @requestor: window to which to deliver response.
+ * @selection: selection that was requested.
+ * @target: target that was selected.
+ * @property: property in which the selection owner stored the data,
+ * or %GDK_NONE to indicate that the request was rejected.
+ * @time_: timestamp.
*
* Send a response to SelectionRequest event.
+ *
+ * Since: 2.2
**/
void
gdk_selection_send_notify_for_display (GdkDisplay *display,
* gdk_text_property_to_text_list_for_display:
* @display: The #GdkDisplay where the encoding is defined.
* @encoding: an atom representing the encoding. The most
- * common values for this are STRING, or COMPOUND_TEXT.
- * This is value used as the type for the property.
+ * common values for this are STRING, or COMPOUND_TEXT.
+ * This is value used as the type for the property.
* @format: the format of the property.
* @text: The text data.
* @length: The number of items to transform.
* @list: location to store a terminated array of strings in
- * the encoding of the current locale. This array should be
- * freed using gdk_free_text_list().
+ * the encoding of the current locale. This array should be
+ * freed using gdk_free_text_list().
*
* Convert a text string from the encoding as it is stored
* in a property into an array of strings in the encoding of
- * the current local. (The elements of the array represent the
- * null-separated elements of the original text string.)
+ * the current locale. (The elements of the array represent the
+ * nul-separated elements of the original text string.)
*
- * Returns : the number of strings stored in list, or 0,
+ * Returns: the number of strings stored in list, or 0,
* if the conversion failed.
+ *
+ * Since: 2.2
*/
gint
gdk_text_property_to_text_list_for_display (GdkDisplay *display,
* @list: location to store the list of strings or %NULL. The
* list should be freed with g_strfreev().
*
- * Converts a text property in the giving encoding to
+ * Converts a text property in the given encoding to
* a list of UTF-8 strings.
*
* Return value: the number of strings in the resulting
* list.
+ *
+ * Since: 2.2
**/
gint
gdk_text_property_to_utf8_list_for_display (GdkDisplay *display,
/**
* gdk_string_to_compound_text_for_display:
- * @display : the #GdkDisplay where the encoding is defined.
- * @str : a null-terminated string.
+ * @display: the #GdkDisplay where the encoding is defined.
+ * @str: a nul-terminated string.
* @encoding: location to store the encoding atom
* (to be used as the type for the property).
* @format: location to store the format of the property
* Convert a string from the encoding of the current
* locale into a form suitable for storing in a window property.
*
- * Returns : 0 upon sucess, non-zero upon failure.
+ * Returns: 0 upon sucess, non-zero upon failure.
+ *
+ * Since: 2.2
**/
gint
gdk_string_to_compound_text_for_display (GdkDisplay *display,
*
* Return value: %TRUE if the conversion succeeded, otherwise
* %FALSE.
+ *
+ * Since: 2.2
**/
gboolean
gdk_utf8_to_compound_text_for_display (GdkDisplay *display,
/**
* gdk_screen_get_system_visual:
- * @screen : a #GdkScreen.
+ * @screen: a #GdkScreen.
*
* Get the system's default visual for @screen.
* This is the visual for the root window of the display.
* The return value should not be freed.
*
- * Return value: system visual
+ * Return value: the system visual
+ *
+ * Since: 2.2
**/
GdkVisual *
gdk_screen_get_system_visual (GdkScreen * screen)
/**
* gdk_screen_list_visuals:
- * @screen : the relevant #GdkScreen.
+ * @screen: the relevant #GdkScreen.
*
* Lists the available visuals for the specified @screen.
* A visual describes a hardware image data format.
*
* Call g_list_free() on the return value when you're finished with it.
*
- * Return value: a list of visuals; the list must be freed, but not its contents
+ * Return value: a list of visuals; the list must be freed, but not its
+ * contents
+ *
+ * Since: 2.2
**/
GList *
gdk_screen_list_visuals (GdkScreen *screen)
}
/**
- * gdk_x11_screen_lookup_visual
+ * gdk_x11_screen_lookup_visual:
* @screen: a #GdkScreen.
* @xvisualid: an X Visual ID.
*
*
* Returns: the #GdkVisual (owned by the screen object), or %NULL
* if the visual ID wasn't found.
+ *
+ * Since: 2.2
*/
GdkVisual *
gdk_x11_screen_lookup_visual (GdkScreen *screen,
* Gets the screen to which this visual belongs
*
* Return value: the screen to which this visual belongs.
+ *
+ * Since: 2.2
**/
GdkScreen *
gdk_visual_get_screen (GdkVisual *visual)
*
* Return value: the newly-created #GdkWindow wrapper for the
* native window or %NULL if the window has been destroyed.
+ *
+ * Since: 2.2
**/
GdkWindow *
gdk_window_foreign_new_for_display (GdkDisplay *display,
*
* Return value: the #GdkWindow wrapper for the native window,
* or %NULL if there is none.
+ *
+ * Since: 2.2
**/
GdkWindow *
gdk_window_lookup_for_display (GdkDisplay *display, GdkNativeWindow anid)
* function should NOT be called in addition, instead you should allow
* the window to be treated according to standard policy for its
* semantic type.
+ *
+ * Since: 2.2
**/
void
gdk_window_set_skip_taskbar_hint (GdkWindow *window,
* already fully describes the window, this function should NOT be
* called in addition, instead you should allow the window to be
* treated according to standard policy for its semantic type.
+ *
+ * Since: 2.2
**/
void
gdk_window_set_skip_pager_hint (GdkWindow *window,
* most standard window managers, and GDK makes a best effort to get
* it to happen.
*
+ * Since: 2.2
**/
void
gdk_window_fullscreen (GdkWindow *window)
* don't have a concept of "fullscreen"; so you can't rely on the
* unfullscreenification actually happening. But it will happen with
* most standard window managers, and GDK makes a best effort to get
- * it to happen.
- *
+ * it to happen.
+ *
+ * Since: 2.2
**/
void
gdk_window_unfullscreen (GdkWindow *window)
/**
* gdk_xid_table_lookup_for_display:
- * @display : the #GdkDisplay.
- * @xid : an X id.
+ * @display: the #GdkDisplay.
+ * @xid: an X id.
*
- * Returns the Gdk object associated with the given X id.
+ * Returns the GDK object associated with the given X id.
+ *
+ * Returns: a GDK object associated with the given X id.
*
- * Returns: an GdkObject associated with the given X id.
+ * Since: 2.2
*/
gpointer
gdk_xid_table_lookup_for_display (GdkDisplay *display,
* be created. Once a clipboard object has
* been created, it is persistent for all time and
* cannot be freed.
+ *
+ * Since: 2.2
**/
GtkClipboard *
gtk_clipboard_get_for_display (GdkDisplay *display, GdkAtom selection)
* Gets the #GdkDisplay associated with @clipboard
*
* Return value: the #GdkDisplay associated with @clipboard
+ *
+ * Since: 2.2
**/
GdkDisplay *
gtk_clipboard_get_display (GtkClipboard *clipboard)
* "gtk-color-palette" so all GtkColorSelection widgets will be modified.
*
* Return value: the previous change palette hook (that was replaced).
+ *
+ * Since: 2.2
**/
GtkColorSelectionChangePaletteWithScreenFunc
gtk_color_selection_set_change_palette_with_screen_hook (GtkColorSelectionChangePaletteWithScreenFunc func)
* the usual size.
*
* Return value: %TRUE if @size was a valid size
+ *
+ * Since: 2.2
**/
gboolean
gtk_icon_size_lookup_for_settings (GtkSettings *settings,
* Creates a new #GtkInvisible object for a specified screen
*
* Return value: a newly created #GtkInvisible object
+ *
+ * Since: 2.2
**/
GtkWidget*
gtk_invisible_new_for_screen (GdkScreen *screen)
* @screen: a #GdkScreen.
*
* Sets the #GdkScreen where the #GtkInvisible object will be displayed.
+ *
+ * Since: 2.2
**/
void
gtk_invisible_set_screen (GtkInvisible *invisible,
*
* Returns the #GdkScreen object associated with @invisible
*
- * Return value : the associated #GdkScreen.
+ * Return value: the associated #GdkScreen.
+ *
+ * Since: 2.2
**/
GdkScreen *
gtk_invisible_get_screen (GtkInvisible *invisible)
* Checks if the given iter is a valid iter for this #GtkListStore.
*
* Return value: %TRUE if the iter is valid, %FALSE if the iter is invalid.
+ *
+ * Since: 2.2
**/
gboolean
gtk_list_store_iter_is_valid (GtkListStore *list_store,
*
* Reorders @store to follow the order indicated by @new_order. Note that
* this function only works with unsorted stores.
+ *
+ * Since: 2.2
**/
void
gtk_list_store_reorder (GtkListStore *store,
*
* Swaps @a and @b in @store. Note that this function only works with
* unsorted stores.
+ *
+ * Since: 2.2
**/
void
gtk_list_store_swap (GtkListStore *store,
* Moves @iter in @store to the position before @position. Note that this
* function only works with unsorted stores. If @position is %NULL, @iter
* will be moved to the end of the list.
+ *
+ * Since: 2.2
**/
void
gtk_list_store_move_before (GtkListStore *store,
* gtk_list_store_move_after:
* @store: A #GtkListStore.
* @iter: A #GtkTreeIter.
- * @position: A #GtkTreeIter, or %NULL.
+ * @position: A #GtkTreeIter or %NULL.
*
* Moves @iter in @store to the position after @position. Note that this
* function only works with unsorted stores. If @position is %NULL, @iter
* will be moved to the start of the list.
+ *
+ * Since: 2.2
**/
void
gtk_list_store_move_after (GtkListStore *store,
* determined by the widget the menu is attached to.
*
* Sets the #GdkScreen on which the menu will be displayed.
+ *
+ * Since: 2.2
**/
void
gtk_menu_set_screen (GtkMenu *menu,
* Select the first visible or selectable child of the menu shell;
* don't select tearoff items unless the only item is a tearoff
* item.
+ *
+ * Since: 2.2
**/
void
gtk_menu_shell_select_first (GtkMenuShell *menu_shell,
* Gets the number of pages in a notebook.
*
* Return value: the number of pages in the notebook.
+ *
+ * Since: 2.2
**/
gint
gtk_notebook_get_n_pages (GtkNotebook *notebook)
* Finish the initialization of @plug for a given #GtkSocket identified by
* @socket_id which is currently displayed on @display.
* This function will generally only be used by classes deriving from #GtkPlug.
+ *
+ * Since: 2.2
**/
void
gtk_plug_construct_for_display (GtkPlug *plug,
* Create a new plug widget inside the #GtkSocket identified by socket_id.
*
* Return value: the new #GtkPlug widget.
+ *
+ * Since: 2.2
*/
GtkWidget*
gtk_plug_new_for_display (GdkDisplay *display,
* if @widget is %NULL, release ownership of the selection.
*
* Return value: TRUE if the operation succeeded
+ *
+ * Since: 2.2
*/
gboolean
gtk_selection_owner_set_for_display (GdkDisplay *display,
* be deprecated in future versions of GTK+.
*
* Return value: %TRUE if the event was handled, otherwise false
+ *
+ * Since: 2.2
**/
gboolean
gtk_selection_clear (GtkWidget *widget,
* Gets the #GtkSettings object for @screen, creating it if necessary.
*
* Return value: a #GtkSettings object.
+ *
+ * Since: 2.2
*/
GtkSettings*
gtk_settings_get_for_screen (GdkScreen *screen)
* Creates a new path with @first_index and @varargs as indices.
*
* Return value: A newly created GtkTreePath.
+ *
+ * Since: 2.2
**/
GtkTreePath *
gtk_tree_path_new_from_indices (gint first_index,
* acceptable return value for this string.
*
* Return value: A newly-allocated string. Must be freed with g_free().
+ *
+ * Since: 2.2
**/
gchar *
gtk_tree_model_get_string_from_iter (GtkTreeModel *tree_model,
}
+/**
+ * gtk_tree_row_reference_copy:
+ * @reference: a #GtkTreeRowReference
+ *
+ * Copies a #GtkTreeRowReference.
+ *
+ * Return value: a copy of @reference.
+ *
+ * Since: 2.2
+ **/
GtkTreeRowReference *
gtk_tree_row_reference_copy (GtkTreeRowReference *reference)
{
* Checks if the given iter is a valid iter for this #GtkTreeModelSort.
*
* Return value: %TRUE if the iter is valid, %FALSE if the iter is invalid.
+ *
+ * Since: 2.2
**/
gboolean
gtk_tree_model_sort_iter_is_valid (GtkTreeModelSort *tree_model_sort,
* </programlisting></informalexample>
*
* Return value: A #GList containing a #GtkTreePath for each selected row.
+ *
+ * Since: 2.2
**/
GList *
gtk_tree_selection_get_selected_rows (GtkTreeSelection *selection,
* Returns the number of rows that have been selected in @tree.
*
* Return value: The number of rows selected.
+ *
+ * Since: 2.2
**/
gint
gtk_tree_selection_count_selected_rows (GtkTreeSelection *selection)
*
* Unselects a range of nodes, determined by @start_path and @end_path
* inclusive.
+ *
+ * Since: 2.2
**/
void
gtk_tree_selection_unselect_range (GtkTreeSelection *selection,
* Checks if the given iter is a valid iter for this #GtkTreeStore.
*
* Return value: %TRUE if the iter is valid, %FALSE if the iter is invalid.
+ *
+ * Since: 2.2
**/
gboolean
gtk_tree_store_iter_is_valid (GtkTreeStore *tree_store,
* Reorders the children of @parent in @tree_store to follow the order
* indicated by @new_order. Note that this function only works with
* unsorted stores.
+ *
+ * Since: 2.2
**/
void
gtk_tree_store_reorder (GtkTreeStore *tree_store,
*
* Swaps @a and @b in the same level of @tree_store. Note that this function
* only works with unsorted stores.
+ *
+ * Since: 2.2
**/
void
gtk_tree_store_swap (GtkTreeStore *tree_store,
* @position should be in the same level. Note that this function only
* works with unsorted stores. If @position is %NULL, @iter will be
* moved to the end of the level.
+ *
+ * Since: 2.2
**/
void
gtk_tree_store_move_before (GtkTreeStore *tree_store,
* @position should be in the same level. Note that this function only
* works with unsorted stores. If @position is %NULL, @iter will be moved
* to the start of the level.
+ *
+ * Since: 2.2
**/
void
gtk_tree_store_move_after (GtkTreeStore *tree_store,
*
* Expands the row at @path. This will also expand all parent rows of
* @path as necessary.
+ *
+ * Since: 2.2
**/
void
gtk_tree_view_expand_to_path (GtkTreeView *tree_view,
* @gtk_widget_grab_focus (@tree_view) in order to give keyboard focus to the
* widget. Please note that editing can only happen when the widget is
* realized.
+ *
+ * Since: 2.2
**/
void
gtk_tree_view_set_cursor_on_cell (GtkTreeView *tree_view,
*
* Sets the current keyboard focus to be at @cell, if the column contains
* 2 or more editable and activatable cells.
+ *
+ * Since: 2.2
**/
void
gtk_tree_view_column_focus_cell (GtkTreeViewColumn *tree_column,
* free those resources when the widget is unrealized.
*
* Return value: the #GdkScreen for the toplevel for this widget.
+ *
+ * Since: 2.2
**/
GdkScreen*
gtk_widget_get_screen (GtkWidget *widget)
*
* Return value: %TRUE if there is a #GdkScreen associcated
* with the widget.
+ *
+ * Since: 2.2
**/
gboolean
gtk_widget_has_screen (GtkWidget *widget)
* free those resources when the widget is unrealized.
*
* Return value: the #GdkDisplay for the toplevel for this widget.
+ *
+ * Since: 2.2
**/
GdkDisplay*
gtk_widget_get_display (GtkWidget *widget)
* and you should free those resources when the widget is unrealized.
*
* Return value: the #GdkWindow root window for the toplevel for this widget.
+ *
+ * Since: 2.2
**/
GdkWindow*
gtk_widget_get_root_window (GtkWidget *widget)
* style property with that name.
*
* Finds a style property of a widget class by name.
+ *
+ * Since: 2.2
*/
GParamSpec*
gtk_widget_class_find_style_property (GtkWidgetClass *klass,
* @returns: an newly allocated array of #GParamSpec*. The array must be freed with g_free().
*
* Returns all style properties of a widget class.
+ *
+ * Since: 2.2
*/
GParamSpec**
gtk_widget_class_list_style_properties (GtkWidgetClass *klass,
* clipboard already exists, a new one will
* be created. Once a clipboard object has
* been created, it is persistent for all time.
+ *
+ * Since: 2.2
**/
GtkClipboard *
gtk_widget_get_clipboard (GtkWidget *widget, GdkAtom selection)
* Windows may set a hint asking the desktop environment not to display
* the window in the task bar. This function toggles this hint.
*
+ * Since: 2.2
**/
void
gtk_window_set_skip_taskbar_hint (GtkWindow *window,
* Gets the value set by gtk_window_set_skip_taskbar_hint()
*
* Return value: %TRUE if window shouldn't be in taskbar
+ *
+ * Since: 2.2
**/
gboolean
gtk_window_get_skip_taskbar_hint (GtkWindow *window)
* switcher that displays a thumbnail representation of the windows
* on the screen.)
*
+ * Since: 2.2
**/
void
gtk_window_set_skip_pager_hint (GtkWindow *window,
* Gets the value set by gtk_window_set_skip_pager_hint().
*
* Return value: %TRUE if window shouldn't be in pager
+ *
+ * Since: 2.2
**/
gboolean
gtk_window_get_skip_pager_hint (GtkWindow *window)
* with a pixbuf created by loading the image from @filename.
*
* Returns: %TRUE if setting the icon succeeded.
+ *
+ * Since: 2.2
**/
gboolean
gtk_window_set_icon_from_file (GtkWindow *window,
* on disk. Warns on failure if @err is %NULL.
*
* Returns: %TRUE if setting the icon succeeded.
+ *
+ * Since: 2.2
**/
gboolean
gtk_window_set_default_icon_from_file (const gchar *filename,
* You can track the fullscreen state via the "window_state_event" signal
* on #GtkWidget.
*
+ * Since: 2.2
**/
void
gtk_window_fullscreen (GtkWindow *window)
* You can track the fullscreen state via the "window_state_event" signal
* on #GtkWidget.
*
+ * Since: 2.2
**/
void
gtk_window_unfullscreen (GtkWindow *window)
* Sets the #GdkScreen where the @window is displayed; if
* the window is already mapped, it will be unmapped, and
* then remapped on the new screen.
+ *
+ * Since: 2.2
*/
void
gtk_window_set_screen (GtkWindow *window,
* Returns the #GdkScreen associated with @window.
*
* Return value: a #GdkScreen.
+ *
+ * Since: 2.2
*/
GdkScreen*
gtk_window_get_screen (GtkWindow *window)
* temporarily, show your splash screen, then re-enable it so that
* showing the main window would automatically result in notification.
*
+ * Since: 2.2
**/
void
gtk_window_set_auto_startup_notification (gboolean setting)