AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

Merge branch 'gtk-2-90'

Browse Source 
Conflicts:
	gtk/gtkentry.h
This commit is contained in:
Matthias Clasen 2010-05-06 22:55:02 -04:00
commit 77d4d3cdae
448 changed files with 1182 additions and 64104 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
configure.in
View File

@ -337,7 +337,7 @@ if test "x$GCC" = "xyes"; then
fi
changequote([,])dnl
CPPFLAGS="$CPPFLAGS -DG_DISABLE_SINGLE_INCLUDES -DATK_DISABLE_SINGLE_INCLUDES -DGDK_PIXBUF_DISABLE_SINGLE_INCLUDES -DGTK_DISABLE_SINGLE_INCLUDES"
CPPFLAGS="$CPPFLAGS -DG_DISABLE_SINGLE_INCLUDES -DATK_DISABLE_SINGLE_INCLUDES"
# Ensure MSVC-compatible struct packing convention is used when
# compiling for Win32 with gcc.

44
docs/faq/gtk-faq.sgml
View File

@ -1137,8 +1137,7 @@ myapp --display=:1
| | | +GtkCombo
| | | `GtkStatusbar
| | `GtkVBox
| | +GtkColorSelection
| | `GtkGammaCurve
| | `GtkColorSelection
| +GtkButton
| | +GtkOptionMenu
| | `GtkToggleButton
@ -1160,7 +1159,6 @@ myapp --display=:1
| +GtkToolbar
| `GtkTree
+GtkDrawingArea
| `GtkCurve
+GtkEditable
| +GtkEntry
| | `GtkSpinButton
@ -1629,11 +1627,7 @@ int main(int argc, char *argv[])
g_signal_connect(G_OBJECT (window), "destroy",
G_CALLBACK(destroy), NULL);
#if (GTK_MAJOR_VERSION == 1) && (GTK_MINOR_VERSION == 0)
gtk_container_border_width(GTK_CONTAINER (window), 10);
#else
gtk_container_set_border_width(GTK_CONTAINER (window), 10);
#endif
/* add a button to do something useful */
button = gtk_button_new_with_label("Fork me!");
@ -1898,7 +1892,7 @@ not applied you'll have to use the
function. <literal>gtk_object_class_user_signal_new</literal> allows you
to add a new signal to a predefined GTK+ widget without any
modification of the GTK+ source code. The new signal can be
emited with <literal>gtk_signal_emit</literal> and can be
emited with <literal>g_signal_emit</literal> and can be
handled in the same way as other signals.</para>
<para>Tim Janik posted this code snippet:</para>
@ -1920,7 +1914,7 @@ gtk_widget_user_action (GtkWidget *widget,
{
g_return_if_fail (GTK_IS_WIDGET (widget));
gtk_signal_emit (GTK_OBJECT (widget), signal_user_action, act_data);
g_signal_emit (widget, signal_user_action, act_data);
}
</programlisting>
@ -2527,15 +2521,15 @@ using the following expression:</para>
<para>If you don't want the user to be able to modify the
content of this entry, you can use the
gtk_entry_set_editable() function:</para>
gtk_editable_set_editable() function:</para>
<programlisting role="C">
void gtk_entry_set_editable(GtkEntry *entry,
gboolean editable);
void gtk_editable_set_editable (GtkEditable *editable,
gboolean is_editable);
</programlisting>
<para>Set the editable parameter to FALSE to disable typing
<para>Set the is_editable parameter to FALSE to disable typing
into the entry.</para>
</sect1>
@ -2559,9 +2553,9 @@ into the entry.</para>
signal handler with</para>
<programlisting role="C">
gtk_signal_connect(GTK_COMBO(cb)->entry,
g_signal_connect(GTK_COMBO(cb)->entry,
"changed",
GTK_SIGNAL_FUNC(my_cb_change_handler),
G_CALLBACK(my_cb_change_handler),
NULL);
</programlisting>
@ -2629,8 +2623,8 @@ underlined, and the relevant accelerators are created.</para>
gtk_box_pack_start (GTK_BOX (vbox1), menubar1, FALSE, FALSE, 0);
file1 = gtk_menu_item_new_with_label ("");
tmp_key = gtk_label_parse_uline (GTK_LABEL (GTK_BIN (file1)->child),
_("_File"));
gtk_label_set_use_underline (GTK_LABEL (gtk_bin_get_child (GTK_BIN (file1))),
TRUE);
gtk_widget_add_accelerator (file1, "activate_item", accel_group,
tmp_key, GDK_MOD1_MASK, 0);
gtk_object_set_data (GTK_OBJECT (window1), "file1", file1);
@ -2643,8 +2637,8 @@ underlined, and the relevant accelerators are created.</para>
gtk_menu_item_set_submenu (GTK_MENU_ITEM (file1), file1_menu);
new1 = gtk_menu_item_new_with_label ("");
tmp_key = gtk_label_parse_uline (GTK_LABEL (GTK_BIN (new1)->child),
_("_New"));
gtk_label_set_use_underline (GTK_LABEL (gtk_bin_get_child (GTK_BIN (new1))),
TRUE);
gtk_widget_add_accelerator (new1, "activate_item", file1_menu_accels,
tmp_key, 0, 0);
gtk_object_set_data (GTK_OBJECT (window1), "new1", new1);
@ -2670,9 +2664,9 @@ GtkMenuItem with:</para>
/* do stuff with child */
if (GTK_IS_LABEL (child))
{
gchar *text;
const gchar *text;
gtk_label_get (GTK_LABEL (child), &amp;text);
text = gtk_label_get_text (GTK_LABEL (child));
g_print ("menu item text: %s\n", text);
}
}
@ -2864,8 +2858,8 @@ be:</para>
<programlisting role="C">
entry = gtk_entry_new();
gtk_signal_connect (GTK_OBJECT(entry), "activate",
GTK_SIGNAL_FUNC(entry_callback),
g_signal_connect (entry, "activate",
G_CALLBACK(entry_callback),
NULL);
</programlisting>
@ -3044,8 +3038,8 @@ main (int argc, char *argv[])
gtk_container_add (GTK_CONTAINER (window), text);
/* connect after everything else */
gtk_signal_connect_after (GTK_OBJECT(text), "button_press_event",
GTK_SIGNAL_FUNC (insert_bar), NULL);
g_signal_connect_after (text, "button_press_event",
G_CALLBACK (insert_bar), NULL);
gtk_widget_show_all(window);
gtk_main();

2
docs/refcounting.txt
View File

@ -197,7 +197,7 @@ GtkOptionMenu looks like this:
/* menu_item->ref_count == 1 and it is flagged as `floating'.
*/
gtk_menu_append (GTK_MENU (menu), menu_item);
gtk_menu_shell_append (GTK_MENU_SHELL (menu), menu_item);
/* menu_item->ref_count still == 1, but it is no longer `floating'.
*/

14
docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml
View File

@ -8,12 +8,6 @@
</para>
<!-- ##### SECTION ./tmpl/from-drawables.sgml:See_Also ##### -->
<para>
gdk_image_get().
</para>
<!-- ##### SECTION ./tmpl/from-drawables.sgml:Short_Description ##### -->
Getting parts of a drawable's image data into a pixbuf.
@ -221,14 +215,6 @@ GnomeCanvasPixbuf
and use that to draw the image onto a drawable.
</para>
<important>
<para>
Since these functions use GdkRGB for rendering, you must
initialize GdkRGB before using any of them. You can do this by
calling gdk_rgb_init() near the beginning of your program.
</para>
</important>
<!-- ##### SECTION ./tmpl/rendering.sgml:See_Also ##### -->
<para>

4
docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf.sgml
View File

@ -127,9 +127,7 @@ information on error domains and error codes.
<!-- ##### ENUM GdkPixbufAlphaMode ##### -->
<para>
These values can be passed to
gdk_pixbuf_render_to_drawable_alpha() to control how the alpha
channel of an image should be handled. This function can create a
This function can create a
bilevel clipping mask (black and white) and use it while painting
the image. In the future, when the X Window System gets an alpha
channel extension, it will be possible to do full alpha

31
docs/reference/gdk/gdk-sections.txt
View File

@ -258,11 +258,7 @@ gdk_pixmap_create_from_xpm
gdk_pixmap_colormap_create_from_xpm
gdk_pixmap_create_from_xpm_d
gdk_pixmap_colormap_create_from_xpm_d
gdk_pixmap_ref
gdk_pixmap_unref
GdkBitmap
gdk_bitmap_ref
gdk_bitmap_unref
<SUBSECTION Standard>
GDK_PIXMAP
@ -285,11 +281,6 @@ GdkPixmapObjectClass
GdkImage
gdk_image_new
GdkImageType
gdk_image_new_bitmap
gdk_image_get
gdk_image_ref
gdk_image_unref
gdk_image_destroy
gdk_image_get_colormap
gdk_image_set_colormap
@ -314,7 +305,6 @@ gdk_image_get_type
<SECTION>
<TITLE>GdkRGB</TITLE>
<FILE>rgb</FILE>
gdk_rgb_init
<SUBSECTION>
gdk_draw_rgb_image
@ -331,9 +321,6 @@ gdk_rgb_cmap_free
GdkRgbCmap
<SUBSECTION>
gdk_rgb_gc_set_foreground
gdk_rgb_gc_set_background
gdk_rgb_xpixel_from_rgb
gdk_rgb_find_color
<SUBSECTION>
@ -354,8 +341,6 @@ GDK_TYPE_RGB_DITHER
<TITLE>Pixbufs</TITLE>
<FILE>pixbufs</FILE>
gdk_pixbuf_render_threshold_alpha
gdk_pixbuf_render_to_drawable
gdk_pixbuf_render_to_drawable_alpha
gdk_pixbuf_render_pixmap_and_mask
gdk_pixbuf_render_pixmap_and_mask_for_colormap
gdk_pixbuf_get_from_drawable
@ -528,16 +513,12 @@ GdkFunction
gdk_gc_new
gdk_gc_new_with_values
gdk_gc_get_screen
gdk_gc_ref
gdk_gc_unref
gdk_gc_destroy
gdk_gc_set_values
gdk_gc_get_values
gdk_gc_set_foreground
gdk_gc_set_background
gdk_gc_set_rgb_fg_color
gdk_gc_set_rgb_bg_color
gdk_gc_set_font
gdk_gc_set_function
gdk_gc_set_fill
GdkFill
@ -600,8 +581,6 @@ gdk_visual_get_best
gdk_visual_get_best_with_depth
gdk_visual_get_best_with_type
gdk_visual_get_best_with_both
gdk_visual_ref
gdk_visual_unref
gdk_visual_get_screen
<SUBSECTION Standard>
@ -813,9 +792,6 @@ gdk_window_thaw_toplevel_updates_libgtk_only
<SECTION>
<TITLE>Selections</TITLE>
<FILE>selections</FILE>
GdkSelection
GdkSelectionType
GdkTarget
GDK_SELECTION_PRIMARY
GDK_SELECTION_SECONDARY
GDK_SELECTION_CLIPBOARD
@ -885,7 +861,6 @@ gdk_pango_renderer_set_stipple
gdk_pango_renderer_set_override_color
gdk_pango_context_get
gdk_pango_context_get_for_screen
gdk_pango_context_set_colormap
GdkPangoAttrEmbossed
GdkPangoAttrEmbossColor
GdkPangoAttrStipple
@ -1096,7 +1071,6 @@ GDK_PRIORITY_REDRAW
gdk_events_pending
gdk_event_peek
gdk_event_get
gdk_event_get_graphics_expose
gdk_event_put
gdk_event_new
gdk_event_copy
@ -1216,7 +1190,6 @@ gdk_cursor_get_type
gdk_input_add_full
GdkInputCondition
GdkInputFunction
GdkDestroyNotify
gdk_input_add
gdk_input_remove
@ -1234,14 +1207,12 @@ gdk_drag_context_new
gdk_drag_drop
gdk_drag_find_window
gdk_drag_find_window_for_screen
gdk_drag_context_ref
gdk_drag_begin
gdk_drag_motion
gdk_drop_finish
gdk_drag_get_protocol
gdk_drag_get_protocol_for_display
GdkDragProtocol
gdk_drag_context_unref
GdkDragContext
GdkDragAction
gdk_drag_status
@ -1359,8 +1330,6 @@ gdk_x11_get_xatom_name_for_display
gdk_display
GDK_HAVE_WCHAR_H
GDK_HAVE_WCTYPE_H
gdk_iswalnum
gdk_iswspace
</SECTION>
<SECTION>

9
docs/reference/gdk/tmpl/cursors.sgml
View File

@ -212,12 +212,3 @@ The standard cursors available.
</para>
@cursor:
<!-- ##### MACRO gdk_cursor_destroy ##### -->
<para>
Destroys a cursor, freeing any resources allocated for it.
</para>

14
docs/reference/gdk/tmpl/dnd.sgml
View File

@ -91,13 +91,6 @@ the GTK+ documentation for more information.
@protocol:
<!-- ##### FUNCTION gdk_drag_context_ref ##### -->
<para>
</para>
@context:
<!-- ##### FUNCTION gdk_drag_begin ##### -->
<para>
</para>
@ -166,13 +159,6 @@ which DND is done.
@GDK_DRAG_PROTO_OLE2: The complex OLE2 DND protocol (not implemented).
@GDK_DRAG_PROTO_LOCAL: Intra-application DND.
<!-- ##### FUNCTION gdk_drag_context_unref ##### -->
<para>
</para>
@context:
<!-- ##### STRUCT GdkDragContext ##### -->
<para>
A <structname>GdkDragContext</structname> holds information about a

8
docs/reference/gdk/tmpl/events.sgml
View File

@ -182,14 +182,6 @@ is given in the <link linkend="glib-The-Main-Event-Loop">GLib Main Loop</link>.
@Returns:
<!-- ##### FUNCTION gdk_event_get_graphics_expose ##### -->
<para>
</para>
@window:
@Returns:
<!-- ##### FUNCTION gdk_event_put ##### -->
<para>
</para>

36
docs/reference/gdk/tmpl/gcs.sgml
View File

@ -148,33 +148,6 @@ useful. For bitmaps, %GDK_AND and %GDK_OR are also useful.
@Returns:
<!-- ##### FUNCTION gdk_gc_ref ##### -->
<para>
</para>
@gc:
@Returns:
<!-- ##### FUNCTION gdk_gc_unref ##### -->
<para>
</para>
@gc:
<!-- ##### MACRO gdk_gc_destroy ##### -->
<para>
This function is obsolete and should not be used.
</para>
@Deprecated: Use g_object_unref() instead
<!-- # Unused Parameters # -->
@gc: a #GdkGC.
<!-- ##### FUNCTION gdk_gc_set_values ##### -->
<para>
@ -230,15 +203,6 @@ This function is obsolete and should not be used.
@color:
<!-- ##### FUNCTION gdk_gc_set_font ##### -->
<para>
</para>
@gc:
@font:
<!-- ##### FUNCTION gdk_gc_set_function ##### -->
<para>

52
docs/reference/gdk/tmpl/images.sgml
View File

@ -12,7 +12,6 @@ It has now been superceded to a large extent by the much more flexible
</para>
<para>
To create an empty #GdkImage use gdk_image_new().
To create a #GdkImage from bitmap data use gdk_image_new_bitmap().
To create an image from part of a #GdkWindow use gdk_drawable_get_image().
</para>
<para>
@ -25,7 +24,7 @@ the different formats that may be used.
To draw a #GdkImage in a #GdkWindow or #GdkPixmap use gdk_draw_image().
</para>
<para>
To destroy a #GdkImage use gdk_image_destroy().
To destroy a #GdkImage use g_object_unref().
</para>
<!-- ##### SECTION See_Also ##### -->
@ -105,55 +104,6 @@ is supported by the server.
@GDK_IMAGE_FASTEST: Specifies that %GDK_IMAGE_SHARED should be tried first,
and if that fails then %GDK_IMAGE_NORMAL will be used.
<!-- ##### FUNCTION gdk_image_new_bitmap ##### -->
<para>
</para>
@visual:
@data:
@width:
@height:
@Returns:
<!-- ##### FUNCTION gdk_image_get ##### -->
<para>
</para>
@drawable:
@x:
@y:
@width:
@height:
@Returns:
<!-- ##### FUNCTION gdk_image_ref ##### -->
<para>
</para>
@image:
@Returns:
<!-- ##### FUNCTION gdk_image_unref ##### -->
<para>
</para>
@image:
<!-- ##### MACRO gdk_image_destroy ##### -->
<para>
Destroys a #GdkImage, freeing any resources allocated for it.
</para>
<!-- # Unused Parameters # -->
@image: a #GdkImage.
<!-- ##### FUNCTION gdk_image_get_colormap ##### -->
<para>

10
docs/reference/gdk/tmpl/input.sgml
View File

@ -72,16 +72,6 @@ occurs.
@condition: the triggering condition.
<!-- ##### USER_FUNCTION GdkDestroyNotify ##### -->
<para>
A callback function called when a piece of user data is
no longer being stored by GDK. Will typically free the
structure or object that @data points to.
</para>
@data: the user data.
<!-- ##### FUNCTION gdk_input_add ##### -->

9
docs/reference/gdk/tmpl/pango_interaction.sgml
View File

@ -222,15 +222,6 @@ g_object_unref (gc);
@Returns:
<!-- ##### FUNCTION gdk_pango_context_set_colormap ##### -->
<para>
</para>
@context:
@colormap:
<!-- ##### STRUCT GdkPangoAttrEmbossed ##### -->
<para>
A Pango text attribute containing a embossed bitmap to be used when

40
docs/reference/gdk/tmpl/pixbufs.sgml
View File

@ -35,46 +35,6 @@ pixbufs, see the #GdkPixbuf API documentation.
@alpha_threshold:
<!-- ##### FUNCTION gdk_pixbuf_render_to_drawable ##### -->
<para>
</para>
@pixbuf:
@drawable:
@gc:
@src_x:
@src_y:
@dest_x:
@dest_y:
@width:
@height:
@dither:
@x_dither:
@y_dither:
<!-- ##### FUNCTION gdk_pixbuf_render_to_drawable_alpha ##### -->
<para>
</para>
@pixbuf:
@drawable:
@src_x:
@src_y:
@dest_x:
@dest_y:
@width:
@height:
@alpha_mode:
@alpha_threshold:
@dither:
@x_dither:
@y_dither:
<!-- ##### FUNCTION gdk_pixbuf_render_pixmap_and_mask ##### -->
<para>
</para>

32
docs/reference/gdk/tmpl/pixmaps.sgml
View File

@ -118,21 +118,6 @@ for the new pixmap. Can be %NULL, if the depth is given.
@Returns:
<!-- ##### MACRO gdk_pixmap_ref ##### -->
<para>
Deprecated equivalent of g_object_ref().
</para>
@Returns: @pixmap
<!-- ##### MACRO gdk_pixmap_unref ##### -->
<para>
Deprecated equivalent of g_object_unref().
</para>
<!-- ##### TYPEDEF GdkBitmap ##### -->
<para>
An opaque structure representing an offscreen drawable of depth
@ -140,20 +125,3 @@ An opaque structure representing an offscreen drawable of depth
#GdkWindow, can often be used interchangeably. The type #GdkDrawable
refers generically to any of these types.
</para>
<!-- ##### MACRO gdk_bitmap_ref ##### -->
<para>
Deprecated equivalent of g_object_ref().
</para>
@Returns: @pixmap
<!-- ##### MACRO gdk_bitmap_unref ##### -->
<para>
Deprecated equivalent of g_object_unref().
</para>

39
docs/reference/gdk/tmpl/rgb.sgml
View File

@ -125,14 +125,6 @@ colors.</para></listitem>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### FUNCTION gdk_rgb_init ##### -->
<para>
This function no longer does anything at all. It's completely useless
(and harmless).
</para>
<!-- ##### FUNCTION gdk_draw_rgb_image ##### -->
<para>
Draws an RGB image in the drawable. This is the core GdkRGB
@ -328,37 +320,6 @@ colors. This is used only for gdk_draw_indexed_image().
@colors: The colors, represented as 0xRRGGBB integer values.
@n_colors: The number of colors in the cmap.
<!-- ##### FUNCTION gdk_rgb_gc_set_foreground ##### -->
<para>
Sets the foreground color in @gc to the specified color (or the
closest approximation, in the case of limited visuals).
</para>
@gc: The #GdkGC to modify.
@rgb: The color, represented as a 0xRRGGBB integer value.
<!-- ##### FUNCTION gdk_rgb_gc_set_background ##### -->
<para>
Sets the background color in @gc to the specified color (or the
closest approximation, in the case of limited visuals).
</para>
@gc: The #GdkGC to modify.
@rgb: The color, represented as a 0xRRGGBB integer value.
<!-- ##### FUNCTION gdk_rgb_xpixel_from_rgb ##### -->
<para>
Finds the X pixel closest in color to the @rgb color specified. This
value may be used to set the <structfield>pixel</structfield> field of
a #GdkColor struct.
</para>
@rgb: The color, represented as a 0xRRGGBB integer value.
@Returns: The X pixel value.
<!-- ##### FUNCTION gdk_rgb_find_color ##### -->
<para>

30
docs/reference/gdk/tmpl/selections.sgml
View File

@ -50,36 +50,6 @@ to the X Inter-client Communication Conventions Manual
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### TYPEDEF GdkSelection ##### -->
<para>
The #GdkSelection enumeration contains predefined
atom values for several common selections.
</para>
<!-- ##### TYPEDEF GdkSelectionType ##### -->
<para>
The #GdkSelectionType enumeration contains predefined
atom values used to represent the types of data transferred
in response to a request for a target. See the
ICCCM for details about what data should be transferred
for each of these types. Other atoms can be used,
and the recommended practice for GTK+ is to to use mime
types for this purpose. However, supporting these types
may be useful for compatibility with older programs.
</para>
<!-- ##### TYPEDEF GdkTarget ##### -->
<para>
The #GdkTarget enumeration contains predefined atom values which are
used to describe possible targets for a selection. Other atoms can be
used, and the recommended practice for GTK+ is to to use mime types
for this purpose. However, supporting these types may be useful for
compatibility with older programs.
</para>
<!-- ##### MACRO GDK_SELECTION_PRIMARY ##### -->
<para>
A #GdkAtom representing the <literal>PRIMARY</literal> selection.

17
docs/reference/gdk/tmpl/visuals.sgml
View File

@ -234,23 +234,6 @@ in memory as 0x00, 0xcc, 0xee, 0xff.
@Returns:
<!-- ##### MACRO gdk_visual_ref ##### -->
<para>
Deprecated equivalent of g_object_ref().
</para>
@v: a #GdkVisual
@Returns: the same visual
<!-- ##### MACRO gdk_visual_unref ##### -->
<para>
Deprecated equivalent of g_object_unref().
</para>
@v: a #GdkVisual
<!-- ##### FUNCTION gdk_visual_get_screen ##### -->
<para>

2
docs/reference/gtk/glossary.xml
View File

@ -232,7 +232,7 @@
<para>
Widgets that don't own the GdkWindow on which they draw are
called <glossterm linkend="no-window">no-window widgets</glossterm>.
This can be tested with the GTK_WIDGET_NO_WINDOW() macro. Normally,
This can be tested with the gtk_widget_get_has_window() function. Normally,
these widgets draw on their parent's GdkWindow.
</para>

486
docs/reference/gtk/gtk-sections.txt
View File

@ -56,8 +56,6 @@ gtk_about_dialog_get_type
<TITLE>Keyboard Accelerators</TITLE>
GtkAccelGroup
gtk_accel_group_new
gtk_accel_group_ref
gtk_accel_group_unref
gtk_accel_group_connect
gtk_accel_group_connect_by_path
GtkAccelGroupActivate
@ -146,7 +144,6 @@ GTK_IS_ACCEL_LABEL_CLASS
GTK_ACCEL_LABEL_GET_CLASS
<SUBSECTION Private>
gtk_accel_label_get_type
gtk_accel_label_accelerator_width
</SECTION>
<SECTION>
@ -184,15 +181,11 @@ gtk_action_create_icon
gtk_action_create_menu_item
gtk_action_create_tool_item
gtk_action_create_menu
gtk_action_connect_proxy
gtk_action_disconnect_proxy
gtk_action_get_proxies
gtk_action_connect_accelerator
gtk_action_disconnect_accelerator
gtk_action_block_activate
gtk_action_unblock_activate
gtk_action_block_activate_from
gtk_action_unblock_activate_from
gtk_action_get_always_show_image
gtk_action_set_always_show_image
gtk_action_get_accel_path
@ -425,15 +418,9 @@ gtk_aspect_frame_get_type
<TITLE>GtkButtonBox</TITLE>
GtkButtonBox
GTK_BUTTONBOX_DEFAULT
gtk_button_box_get_spacing
gtk_button_box_get_layout
gtk_button_box_get_child_size
gtk_button_box_get_child_ipadding
gtk_button_box_get_child_secondary
gtk_button_box_set_spacing
gtk_button_box_set_layout
gtk_button_box_set_child_size
gtk_button_box_set_child_ipadding
gtk_button_box_set_child_secondary
<SUBSECTION Standard>
GTK_BUTTON_BOX
@ -657,10 +644,8 @@ GtkCheckMenuItem
gtk_check_menu_item_new
gtk_check_menu_item_new_with_label
gtk_check_menu_item_new_with_mnemonic
gtk_check_menu_item_set_state
gtk_check_menu_item_get_active
gtk_check_menu_item_set_active
gtk_check_menu_item_set_show_toggle
gtk_check_menu_item_toggled
gtk_check_menu_item_get_inconsistent
gtk_check_menu_item_set_inconsistent
@ -851,7 +836,6 @@ gtk_hsv_get_type
<TITLE>GtkColorSelection</TITLE>
GtkColorSelection
gtk_color_selection_new
gtk_color_selection_set_update_policy
gtk_color_selection_set_has_opacity_control
gtk_color_selection_get_has_opacity_control
gtk_color_selection_set_has_palette
@ -1000,7 +984,6 @@ gtk_combo_box_entry_get_type
GtkContainer
GTK_IS_RESIZE_CONTAINER
GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID
gtk_container_border_width
gtk_container_add
gtk_container_remove
gtk_container_add_with_properties
@ -1008,8 +991,6 @@ gtk_container_get_resize_mode
gtk_container_set_resize_mode
gtk_container_check_resize
gtk_container_foreach
gtk_container_foreach_full
gtk_container_children
gtk_container_get_children
gtk_container_set_reallocate_redraws
gtk_container_get_focus_child
@ -1047,126 +1028,6 @@ GTK_CONTAINER_GET_CLASS
gtk_container_get_type
</SECTION>
<SECTION>
<FILE>gtkctree</FILE>
<TITLE>GtkCTree</TITLE>
GtkCTree
GTK_CTREE_ROW
GTK_CTREE_NODE
GTK_CTREE_NODE_NEXT
GTK_CTREE_NODE_PREV
GTK_CTREE_FUNC
GtkCTreePos
GtkCTreeLineStyle
GtkCTreeExpanderStyle
GtkCTreeExpansionType
GtkCTreeFunc
GtkCTreeGNodeFunc
GtkCTreeCompareDragFunc
GtkCTreeRow
GtkCTreeNode
GTK_TYPE_CTREE_NODE
gtk_ctree_new_with_titles
gtk_ctree_new
gtk_ctree_insert_node
gtk_ctree_remove_node
gtk_ctree_insert_gnode
gtk_ctree_export_to_gnode
gtk_ctree_post_recursive
gtk_ctree_post_recursive_to_depth
gtk_ctree_pre_recursive
gtk_ctree_pre_recursive_to_depth
gtk_ctree_is_viewable
gtk_ctree_last
gtk_ctree_find_node_ptr
gtk_ctree_find
gtk_ctree_is_ancestor
gtk_ctree_find_by_row_data
gtk_ctree_find_all_by_row_data
gtk_ctree_find_by_row_data_custom
gtk_ctree_find_all_by_row_data_custom
gtk_ctree_is_hot_spot
gtk_ctree_move
gtk_ctree_expand
gtk_ctree_expand_recursive
gtk_ctree_expand_to_depth
gtk_ctree_collapse
gtk_ctree_collapse_recursive
gtk_ctree_collapse_to_depth
gtk_ctree_toggle_expansion
gtk_ctree_toggle_expansion_recursive
gtk_ctree_select
gtk_ctree_select_recursive
gtk_ctree_unselect
gtk_ctree_unselect_recursive
gtk_ctree_real_select_recursive
gtk_ctree_node_set_text
gtk_ctree_node_set_pixmap
gtk_ctree_node_set_pixtext
gtk_ctree_set_node_info
gtk_ctree_node_set_shift
gtk_ctree_node_set_selectable
gtk_ctree_node_get_selectable
gtk_ctree_node_get_cell_type
gtk_ctree_node_get_text
gtk_ctree_node_get_pixmap
gtk_ctree_node_get_pixtext
gtk_ctree_get_node_info
gtk_ctree_node_set_row_style
gtk_ctree_node_get_row_style
gtk_ctree_node_set_cell_style
gtk_ctree_node_get_cell_style
gtk_ctree_node_set_foreground
gtk_ctree_node_set_background
gtk_ctree_node_set_row_data
gtk_ctree_node_set_row_data_full
gtk_ctree_node_get_row_data
gtk_ctree_node_moveto
gtk_ctree_node_is_visible
gtk_ctree_set_indent
gtk_ctree_set_spacing
gtk_ctree_set_reorderable
gtk_ctree_set_line_style
gtk_ctree_set_expander_style
gtk_ctree_set_drag_compare_func
gtk_ctree_sort_node
gtk_ctree_sort_recursive
gtk_ctree_node_nth
gtk_ctree_set_show_stub
<SUBSECTION Standard>
GTK_CTREE
GTK_IS_CTREE
GTK_TYPE_CTREE
GTK_CTREE_CLASS
GTK_IS_CTREE_CLASS
GTK_CTREE_GET_CLASS
<SUBSECTION Private>
gtk_ctree_get_type
gtk_ctree_node_get_type
</SECTION>
<SECTION>
<FILE>gtkcurve</FILE>
<TITLE>GtkCurve</TITLE>
GtkCurve
gtk_curve_new
gtk_curve_reset
gtk_curve_set_gamma
gtk_curve_set_range
gtk_curve_get_vector
gtk_curve_set_vector
gtk_curve_set_curve_type
<SUBSECTION Standard>
GTK_CURVE
GTK_IS_CURVE
GTK_TYPE_CURVE
GTK_CURVE_CLASS
GTK_IS_CURVE_CLASS
GTK_CURVE_GET_CLASS
<SUBSECTION Private>
gtk_curve_get_type
</SECTION>
<SECTION>
<FILE>gtkdialog</FILE>
<TITLE>GtkDialog</TITLE>
@ -1249,44 +1110,20 @@ GTK_EDITABLE_GET_CLASS
gtk_editable_get_type
</SECTION>
<SECTION>
<FILE>gtkoldeditable</FILE>
<TITLE>GtkOldEditable</TITLE>
GtkOldEditable
GtkTextFunction
gtk_old_editable_claim_selection
gtk_old_editable_changed
<SUBSECTION Standard>
GTK_OLD_EDITABLE
GTK_IS_OLD_EDITABLE
GTK_TYPE_OLD_EDITABLE
GTK_OLD_EDITABLE_CLASS
GTK_IS_OLD_EDITABLE_CLASS
GTK_OLD_EDITABLE_GET_CLASS
<SUBSECTION Private>
gtk_old_editable_get_type
</SECTION>
<SECTION>
<FILE>gtkentry</FILE>
<TITLE>GtkEntry</TITLE>
GtkEntry
gtk_entry_new
gtk_entry_new_with_buffer
gtk_entry_new_with_max_length
gtk_entry_get_buffer
gtk_entry_set_buffer
gtk_entry_set_text
gtk_entry_append_text
gtk_entry_prepend_text
gtk_entry_set_position
gtk_entry_get_text
gtk_entry_get_text_length
gtk_entry_select_region
gtk_entry_set_visibility
gtk_entry_set_invisible_char
gtk_entry_unset_invisible_char
gtk_entry_set_editable
gtk_entry_set_max_length
gtk_entry_get_activates_default
gtk_entry_get_has_frame
@ -1591,7 +1428,6 @@ GtkFileChooserWidgetPrivate
<TITLE>GtkFileChooserButton</TITLE>
GtkFileChooserButton
gtk_file_chooser_button_new
gtk_file_chooser_button_new_with_backend
gtk_file_chooser_button_new_with_dialog
gtk_file_chooser_button_get_title
gtk_file_chooser_button_set_title
@ -1666,8 +1502,6 @@ GtkFixed
gtk_fixed_new
gtk_fixed_put
gtk_fixed_move
gtk_fixed_get_has_window
gtk_fixed_set_has_window
<SUBSECTION Standard>
GTK_FIXED
GTK_IS_FIXED
@ -1789,22 +1623,6 @@ GTK_FRAME_GET_CLASS
gtk_frame_get_type
</SECTION>
<SECTION>
<FILE>gtkgamma</FILE>
<TITLE>GtkGammaCurve</TITLE>
GtkGammaCurve
gtk_gamma_curve_new
<SUBSECTION Standard>
GTK_GAMMA_CURVE
GTK_IS_GAMMA_CURVE
GTK_TYPE_GAMMA_CURVE
GTK_GAMMA_CURVE_CLASS
GTK_IS_GAMMA_CURVE_CLASS
GTK_GAMMA_CURVE_GET_CLASS
<SUBSECTION Private>
gtk_gamma_curve_get_type
</SECTION>
<SECTION>
<FILE>gtkhandlebox</FILE>
<TITLE>GtkHandleBox</TITLE>
@ -1833,10 +1651,6 @@ gtk_handle_box_get_type
<TITLE>GtkHButtonBox</TITLE>
GtkHButtonBox
gtk_hbutton_box_new
gtk_hbutton_box_get_spacing_default
gtk_hbutton_box_get_layout_default
gtk_hbutton_box_set_spacing_default
gtk_hbutton_box_set_layout_default
<SUBSECTION Standard>
GTK_HBUTTON_BOX
GTK_IS_HBUTTON_BOX
@ -2173,22 +1987,6 @@ gtk_im_multicontext_get_type
GtkIMMulticontextPrivate
</SECTION>
<SECTION>
<FILE>gtkinputdialog</FILE>
<TITLE>GtkInputDialog</TITLE>
GtkInputDialog
gtk_input_dialog_new
<SUBSECTION Standard>
GTK_INPUT_DIALOG
GTK_IS_INPUT_DIALOG
GTK_TYPE_INPUT_DIALOG
GTK_INPUT_DIALOG_CLASS
GTK_IS_INPUT_DIALOG_CLASS
GTK_INPUT_DIALOG_GET_CLASS
<SUBSECTION Private>
gtk_input_dialog_get_type
</SECTION>
<SECTION>
<FILE>gtkinvisible</FILE>
<TITLE>GtkInvisible</TITLE>
@ -2286,7 +2084,6 @@ gtk_label_set_ellipsize
gtk_label_set_width_chars
gtk_label_set_max_width_chars
gtk_label_get
gtk_label_parse_uline
gtk_label_set_line_wrap
gtk_label_set_line_wrap_mode
gtk_label_set
@ -2452,9 +2249,6 @@ gtk_list_item_get_type
GtkMenu
gtk_menu_new
gtk_menu_set_screen
gtk_menu_append
gtk_menu_prepend
gtk_menu_insert
gtk_menu_reorder_child
gtk_menu_attach
gtk_menu_popup
@ -2825,39 +2619,16 @@ GTK_OFFSCREEN_WINDOW_GET_CLASS
gtk_offscreen_window_get_type
</SECTION>
<SECTION>
<FILE>gtkoptionmenu</FILE>
<TITLE>GtkOptionMenu</TITLE>
GtkOptionMenu
gtk_option_menu_new
gtk_option_menu_get_menu
gtk_option_menu_set_menu
gtk_option_menu_remove_menu
gtk_option_menu_set_history
gtk_option_menu_get_history
<SUBSECTION Standard>
GTK_OPTION_MENU
GTK_IS_OPTION_MENU
GTK_TYPE_OPTION_MENU
GTK_OPTION_MENU_CLASS
GTK_IS_OPTION_MENU_CLASS
GTK_OPTION_MENU_GET_CLASS
<SUBSECTION Private>
gtk_option_menu_get_type
</SECTION>
<SECTION>
<FILE>gtkpaned</FILE>
<TITLE>GtkPaned</TITLE>
GtkPaned
gtk_paned_add1
gtk_paned_add2
gtk_paned_gutter_size
gtk_paned_pack1
gtk_paned_pack2
gtk_paned_get_child1
gtk_paned_get_child2
gtk_paned_set_gutter_size
gtk_paned_set_position
gtk_paned_get_position
gtk_paned_get_handle_window
@ -2871,26 +2642,6 @@ GTK_PANED_GET_CLASS
<SUBSECTION Private>
gtk_paned_get_type
gtk_paned_compute_position
</SECTION>
<SECTION>
<FILE>gtkpixmap</FILE>
<TITLE>GtkPixmap</TITLE>
GtkPixmap
gtk_pixmap_new
gtk_pixmap_set
gtk_pixmap_get
gtk_pixmap_set_build_insensitive
<SUBSECTION Standard>
GTK_PIXMAP
GTK_IS_PIXMAP
GTK_TYPE_PIXMAP
GTK_PIXMAP_CLASS
GTK_IS_PIXMAP_CLASS
GTK_PIXMAP_GET_CLASS
<SUBSECTION Private>
gtk_pixmap_get_type
</SECTION>
<SECTION>
@ -3041,7 +2792,6 @@ gtk_radio_button_new_with_label
gtk_radio_button_new_with_label_from_widget
gtk_radio_button_new_with_mnemonic
gtk_radio_button_new_with_mnemonic_from_widget
gtk_radio_button_group
gtk_radio_button_set_group
gtk_radio_button_get_group
<SUBSECTION Standard>
@ -3762,37 +3512,6 @@ GTK_TEAROFF_MENU_ITEM_GET_CLASS
gtk_tearoff_menu_item_get_type
</SECTION>
<SECTION>
<FILE>gtktext</FILE>
<TITLE>GtkText</TITLE>
GtkText
GtkTextFont
GtkPropertyMark
gtk_text_new
gtk_text_set_editable
gtk_text_set_word_wrap
gtk_text_set_line_wrap
gtk_text_set_adjustments
gtk_text_set_point
gtk_text_get_point
gtk_text_get_length
gtk_text_freeze
gtk_text_thaw
gtk_text_insert
gtk_text_backward_delete
gtk_text_forward_delete
GTK_TEXT_INDEX
<SUBSECTION Standard>
GTK_TEXT
GTK_IS_TEXT
GTK_TYPE_TEXT
GTK_TEXT_CLASS
GTK_IS_TEXT_CLASS
GTK_TEXT_GET_CLASS
<SUBSECTION Private>
gtk_text_get_type
</SECTION>
<SECTION>
<FILE>gtktextbuffer</FILE>
<TITLE>GtkTextBuffer</TITLE>
@ -4209,7 +3928,6 @@ gtk_toggle_button_new_with_label
gtk_toggle_button_new_with_mnemonic
gtk_toggle_button_set_mode
gtk_toggle_button_get_mode
gtk_toggle_button_set_state
gtk_toggle_button_toggled
gtk_toggle_button_get_active
gtk_toggle_button_set_active
@ -4479,31 +4197,6 @@ gtk_toggle_tool_button_get_type
GtkToggleToolButtonPrivate
</SECTION>
<SECTION>
<FILE>gtktooltips</FILE>
<TITLE>GtkTooltips</TITLE>
GtkTooltips
GtkTooltipsData
gtk_tooltips_new
gtk_tooltips_enable
gtk_tooltips_disable
gtk_tooltips_set_delay
gtk_tooltips_set_tip
gtk_tooltips_data_get
gtk_tooltips_force_window
gtk_tooltips_get_info_from_tip_window
<SUBSECTION Standard>
GTK_TOOLTIPS
GTK_IS_TOOLTIPS
GTK_TYPE_TOOLTIPS
GTK_TOOLTIPS_CLASS
GTK_IS_TOOLTIPS_CLASS
GTK_TOOLTIPS_GET_CLASS
<SUBSECTION Private>
gtk_tooltips_get_type
</SECTION>
<SECTION>
<FILE>gtktoolitemgroup</FILE>
<TITLE>GtkToolItemGroup</TITLE>
@ -4601,64 +4294,6 @@ GTK_TOOLTIP
gtk_tooltip_get_type
</SECTION>
<SECTION>
<FILE>gtktree</FILE>
<TITLE>GtkTree</TITLE>
GtkTree
GTK_IS_ROOT_TREE
GTK_TREE_ROOT_TREE
GTK_TREE_SELECTION_OLD
GtkTreeViewMode
gtk_tree_new
gtk_tree_append
gtk_tree_prepend
gtk_tree_insert
gtk_tree_remove_items
gtk_tree_clear_items
gtk_tree_select_item
gtk_tree_unselect_item
gtk_tree_select_child
gtk_tree_unselect_child
gtk_tree_child_position
gtk_tree_set_selection_mode
gtk_tree_set_view_mode
gtk_tree_set_view_lines
gtk_tree_remove_item
<SUBSECTION Standard>
GTK_TREE
GTK_IS_TREE
GTK_TYPE_TREE
GTK_TREE_CLASS
GTK_IS_TREE_CLASS
GTK_TREE_GET_CLASS
<SUBSECTION Private>
gtk_tree_get_type
</SECTION>
<SECTION>
<FILE>gtktreeitem</FILE>
<TITLE>GtkTreeItem</TITLE>
GtkTreeItem
GTK_TREE_ITEM_SUBTREE
gtk_tree_item_new
gtk_tree_item_new_with_label
gtk_tree_item_set_subtree
gtk_tree_item_remove_subtree
gtk_tree_item_select
gtk_tree_item_deselect
gtk_tree_item_expand
gtk_tree_item_collapse
<SUBSECTION Standard>
GTK_TREE_ITEM
GTK_IS_TREE_ITEM
GTK_TYPE_TREE_ITEM
GTK_TREE_ITEM_CLASS
GTK_IS_TREE_ITEM_CLASS
GTK_TREE_ITEM_GET_CLASS
<SUBSECTION Private>
gtk_tree_item_get_type
</SECTION>
<SECTION>
<FILE>gtktreemodel</FILE>
<TITLE>GtkTreeModel</TITLE>
@ -4931,7 +4566,6 @@ gtk_tree_view_column_new_with_attributes
gtk_tree_view_column_pack_start
gtk_tree_view_column_pack_end
gtk_tree_view_column_clear
gtk_tree_view_column_get_cell_renderers
gtk_tree_view_column_add_attribute
gtk_tree_view_column_set_attributes
gtk_tree_view_column_set_cell_data_func
@ -5176,7 +4810,6 @@ gtk_cell_renderer_get_size
gtk_cell_renderer_render
gtk_cell_renderer_activate
gtk_cell_renderer_start_editing
gtk_cell_renderer_editing_canceled
gtk_cell_renderer_stop_editing
gtk_cell_renderer_get_fixed_size
gtk_cell_renderer_set_fixed_size
@ -5400,10 +5033,6 @@ gtk_list_store_get_type
<TITLE>GtkVButtonBox</TITLE>
GtkVButtonBox
gtk_vbutton_box_new
gtk_vbutton_box_get_spacing_default
gtk_vbutton_box_set_spacing_default
gtk_vbutton_box_get_layout_default
gtk_vbutton_box_set_layout_default
<SUBSECTION Standard>
GTK_VBUTTON_BOX
GTK_IS_VBUTTON_BOX
@ -5558,29 +5187,7 @@ gtk_vseparator_get_type
GtkWidget
GtkWidgetClass
GtkWidgetFlags
GTK_WIDGET_TYPE
GTK_WIDGET_STATE
GTK_WIDGET_SAVED_STATE
GTK_WIDGET_FLAGS
GTK_WIDGET_TOPLEVEL
GTK_WIDGET_NO_WINDOW
GTK_WIDGET_REALIZED
GTK_WIDGET_MAPPED
GTK_WIDGET_VISIBLE
GTK_WIDGET_DRAWABLE
GTK_WIDGET_SENSITIVE
GTK_WIDGET_PARENT_SENSITIVE
GTK_WIDGET_IS_SENSITIVE
GTK_WIDGET_CAN_FOCUS
GTK_WIDGET_HAS_FOCUS
GTK_WIDGET_CAN_DEFAULT
GTK_WIDGET_RECEIVES_DEFAULT
GTK_WIDGET_HAS_DEFAULT
GTK_WIDGET_HAS_GRAB
GTK_WIDGET_RC_STYLE
GTK_WIDGET_COMPOSITE_CHILD
GTK_WIDGET_APP_PAINTABLE
GTK_WIDGET_DOUBLE_BUFFERED
GTK_WIDGET_SET_FLAGS
GTK_WIDGET_UNSET_FLAGS
GtkCallback
@ -5609,7 +5216,6 @@ gtk_widget_unrealize
gtk_widget_queue_draw
gtk_widget_queue_resize
gtk_widget_queue_resize_no_redraw
gtk_widget_draw
gtk_widget_size_request
gtk_widget_get_child_requisition
gtk_widget_size_allocate
@ -5632,7 +5238,6 @@ gtk_widget_set_sensitive
gtk_widget_set_parent
gtk_widget_set_parent_window
gtk_widget_get_parent_window
gtk_widget_set_uposition
gtk_widget_set_usize
gtk_widget_set_events
gtk_widget_add_events
@ -5649,10 +5254,8 @@ gtk_widget_is_ancestor
gtk_widget_translate_coordinates
gtk_widget_hide_on_delete
gtk_widget_set_style
gtk_widget_set_rc_style
gtk_widget_ensure_style
gtk_widget_get_style
gtk_widget_restore_default_style
gtk_widget_reset_rc_styles
gtk_widget_push_colormap
gtk_widget_pop_colormap
@ -5719,19 +5322,14 @@ gtk_widget_get_root_window
gtk_widget_get_screen
gtk_widget_has_screen
gtk_widget_get_size_request
gtk_widget_pop_visual
gtk_widget_push_visual
gtk_widget_set_child_visible
gtk_widget_set_default_visual
gtk_widget_set_size_request
gtk_widget_set_visual
gtk_widget_thaw_child_notify
gtk_widget_set_no_show_all
gtk_widget_get_no_show_all
gtk_widget_list_mnemonic_labels
gtk_widget_add_mnemonic_label
gtk_widget_remove_mnemonic_label
gtk_widget_get_action
gtk_widget_is_composited
gtk_widget_error_bell
gtk_widget_keynav_failed
@ -5947,7 +5545,6 @@ gtk_init
gtk_init_check
gtk_init_with_args
gtk_get_option_group
gtk_exit
gtk_events_pending
gtk_main
gtk_main_level
@ -5977,28 +5574,7 @@ gtk_quit_remove
gtk_quit_remove_by_data
<SUBSECTION>
gtk_timeout_add_full
gtk_timeout_add
gtk_timeout_remove
<SUBSECTION>
gtk_idle_add
gtk_idle_add_priority
gtk_idle_add_full
gtk_idle_remove
gtk_idle_remove_by_data
<SUBSECTION>
gtk_input_add_full
gtk_input_remove
<SUBSECTION>
GTK_PRIORITY_REDRAW
GTK_PRIORITY_RESIZE
GTK_PRIORITY_HIGH
GTK_PRIORITY_INTERNAL
GTK_PRIORITY_DEFAULT
GTK_PRIORITY_LOW
<SUBSECTION>
gtk_key_snooper_install
@ -6068,27 +5644,6 @@ gtk_style_set_font
gtk_style_get_style_property
gtk_style_get_valist
gtk_style_get
gtk_draw_hline
gtk_draw_vline
gtk_draw_shadow
gtk_draw_polygon
gtk_draw_arrow
gtk_draw_diamond
gtk_draw_string
gtk_draw_box
gtk_draw_box_gap
gtk_draw_check
gtk_draw_extension
gtk_draw_flat_box
gtk_draw_focus
gtk_draw_handle
gtk_draw_option
gtk_draw_shadow_gap
gtk_draw_slider
gtk_draw_tab
gtk_draw_expander
gtk_draw_layout
gtk_draw_resize_grip
gtk_paint_arrow
gtk_paint_box
gtk_paint_box_gap
@ -6339,46 +5894,6 @@ gtk_drag_source_add_image_targets
gtk_drag_source_add_uri_targets
</SECTION>
<SECTION>
<FILE>gtksignal</FILE>
<TITLE>Signals</TITLE>
GTK_SIGNAL_OFFSET
GtkSignalRunType
gtk_signal_new
gtk_signal_newv
gtk_signal_lookup
gtk_signal_name
gtk_signal_emit
gtk_signal_emit_by_name
gtk_signal_emitv
gtk_signal_emitv_by_name
gtk_signal_emit_stop
gtk_signal_emit_stop_by_name
gtk_signal_connect
gtk_signal_connect_after
gtk_signal_connect_object
gtk_signal_connect_object_after
gtk_signal_connect_full
gtk_signal_connect_while_alive
gtk_signal_connect_object_while_alive
gtk_signal_disconnect
gtk_signal_disconnect_by_func
gtk_signal_disconnect_by_data
gtk_signal_handler_block
gtk_signal_handler_block_by_func
gtk_signal_handler_block_by_data
gtk_signal_handler_unblock
gtk_signal_handler_unblock_by_func
gtk_signal_handler_unblock_by_data
gtk_signal_handler_pending
gtk_signal_handler_pending_by_func
gtk_signal_default_marshaller
<SUBSECTION Private>
gtk_signal_compat_matched
</SECTION>
<SECTION>
<FILE>gtktypeutils</FILE>
<TITLE>Types</TITLE>
@ -6507,7 +6022,6 @@ GtkArrowType
GtkAttachOptions
GtkButtonBoxStyle
GtkCornerType
GtkCurveType
GtkDeleteType
GtkDirectionType
GtkExpanderStyle

9
docs/reference/gtk/gtk.types
View File

@ -44,8 +44,6 @@ gtk_combo_box_entry_get_type
gtk_combo_box_get_type
gtk_combo_get_type
gtk_container_get_type
gtk_ctree_get_type
gtk_curve_get_type
gtk_dialog_get_type
gtk_drawing_area_get_type
gtk_editable_get_type
@ -66,7 +64,6 @@ gtk_font_button_get_type
gtk_font_selection_dialog_get_type
gtk_font_selection_get_type
gtk_frame_get_type
gtk_gamma_curve_get_type
gtk_handle_box_get_type
gtk_hbox_get_type
gtk_hbutton_box_get_type
@ -85,7 +82,6 @@ gtk_im_context_get_type
gtk_im_context_simple_get_type
gtk_im_multicontext_get_type
gtk_info_bar_get_type
gtk_input_dialog_get_type
gtk_invisible_get_type
gtk_item_factory_get_type
gtk_item_get_type
@ -106,8 +102,6 @@ gtk_mount_operation_get_type
gtk_notebook_get_type
gtk_object_get_type
gtk_offscreen_window_get_type
gtk_old_editable_get_type
gtk_option_menu_get_type
gtk_orientable_get_type
gtk_page_setup_get_type
gtk_page_setup_unix_dialog_get_type
@ -172,11 +166,8 @@ gtk_tool_button_get_type
gtk_tool_item_get_type
gtk_tool_item_group_get_type
gtk_tool_palette_get_type
gtk_tooltips_get_type
gtk_tree_drag_dest_get_type
gtk_tree_drag_source_get_type
gtk_tree_get_type
gtk_tree_item_get_type
gtk_tree_model_filter_get_type
gtk_tree_model_get_type
gtk_tree_model_sort_get_type

2
docs/reference/gtk/objects_grouped.sgml
View File

@ -84,8 +84,6 @@
<link linkend="GtkImage">GtkImage</link>
<link linkend="GtkPixmap">GtkPixmap</link>
<link linkend="GtkPreview">GtkPreview</link>
<link linkend="GtkCurve">GtkCurve</link>
<link linkend="GtkGammaCurve">GtkGammaCurve</link>
<emphasis>Misc. Widgets</emphasis>
<link linkend="GtkArrow">GtkArrow</link>

163
docs/reference/gtk/tmpl/gtk-unused.sgml
View File

@ -22,9 +22,9 @@ or gtk_object_get).
they describe <wordasword>signal arguments</wordasword>.
This is a lot less often needed but still useful.
Usually if you are just emitting or creating a particular signal
it is more convenient to just use gtk_signal_emit() or gtk_signal_new().
it is more convenient to just use g_signal_emit() or g_signal_new().
However if you are writing a function to emit or create an arbitrary
signal, you must use gtk_signal_emitv() or gtk_signal_newv().
signal, you must use g_signal_emitv() or g_signal_newv().
</para>
</listitem>
</itemizedlist>
@ -133,7 +133,7 @@ gboolean sigfunc(gpointer,gint,gint,guint);
<refsect2>
<title>Writing Custom Marshals</title>
<para>
Marshals are primarily used as arguments to gtk_signal_new().
Marshals are primarily used as arguments to g_signal_new().
Sometimes, you may find that a marshaller you need isn't available
in the standard list. Then you have to write your own.
</para>
@ -1203,7 +1203,7 @@ and swapped when the signal handler is invoked.
This is useful for handlers that are primarily notifying
other objects and could just invoke an already existing function
if the parameters were swapped.
See gtk_signal_connect_object() for more details.
See g_signal_connect_swapped() for more details.
</para>
@ -1215,7 +1215,7 @@ and swapped when the signal handler is invoked,
and so that the handler is invoked after all others.
</para>
<para>
See gtk_signal_connect_object_after() for more details.
See g_signal_connect_data() for more details.
</para>
@ -2464,16 +2464,6 @@ is enabled.
@nargs:
@Returns:
<!-- ##### FUNCTION gtk_ctree_construct ##### -->
<para>
This function is not usually used by users.
</para>
@ctree:
@columns:
@tree_column:
@titles:
<!-- ##### FUNCTION gtk_decorated_window_calculate_frame_size ##### -->
<para>
@ -2899,14 +2889,14 @@ See the signal documentation for more general information.
@klass: the object class to define the signal for.
@name: the name of the signal.
@signal_flags: the default emission behavior for the signal.
See gtk_signal_new().
See g_signal_new().
@marshaller: a function that will take an array of GtkArgs
and invoke the appropriate handler with the normal calling
conventions.
@return_val: specify the return-value type for the signal
(or GTK_TYPE_NONE for no return-value).
@nparams: specify the number of parameters the signal
receives from the caller of gtk_signal_emit().
receives from the caller of g_signal_emit().
@Varargs: list of nparams #GtkTypes to pass to the signal handlers.
@Returns: the signal id. (See #GtkSignals)
@ -2919,7 +2909,7 @@ object.
@klass: the object class to define the signal for.
@name: the name of the signal.
@signal_flags: the default emission behavior for the signal.
See gtk_signal_new().
See g_signal_new().
@marshaller: takes a GtkObject, a #GtkSignalFunc, and an array
of arguments, and invokes the function using the appropriate
calling conventions. Usually just select a function
@ -2927,7 +2917,7 @@ out of gtkmarshal.h.
@return_val: specify the return-value type for the signal (possibly
#GTK_TYPE_NONE).
@nparams: specify the number of parameters the signal
receives from the caller of gtk_signal_emit().
receives from the caller of g_signal_emit().
@params: array of #GtkTypes the signal handlers for this signal
should have in their prototype (of length nparams).
@Returns: the signal id. (See #GtkSignals)
@ -3117,16 +3107,6 @@ the names, types, and values of the arguments).
@packer:
@spacing:
<!-- ##### FUNCTION gtk_paned_compute_position ##### -->
<para>
Internal function used by #GtkHPaned and #GtkVPaned
</para>
@paned:
@allocation:
@child1_req:
@child2_req:
<!-- ##### MACRO gtk_paned_handle_size ##### -->
<para>
Old name for gtk_paned_set_handle_size().
@ -3338,131 +3318,6 @@ Internal function.
@Returns:
<!-- ##### FUNCTION gtk_signal_add_emission_hook ##### -->
<para>
Add an emission hook for a type of signal, for any object.
</para>
@signal_id: the type of signal to hook for.
@hook_func: the function to invoke to handle the emission hook.
@data: the user data passed in to hook_func.
@Returns: the id (that you may pass as a parameter
to gtk_signal_remove_emission_hook()).
@i:
@h:
@d:
<!-- ##### FUNCTION gtk_signal_add_emission_hook_full ##### -->
<para>
Add an emission hook for a type of signal, for any object.
(with control of what happens when the hook is
destroyed).
</para>
@signal_id: the type of signal add the hook for.
@hook_func: the function to invoke to handle the hook.
@data: the user data passed in to hook_func.
@destroy: a function to invoke when the hook is destroyed,
to clean up any allocation done just for this
signal handler.
@Returns: the id (that you may pass as a parameter
to gtk_signal_remove_emission_hook()).
<!-- ##### FUNCTION gtk_signal_handler_pending_by_id ##### -->
<para>
Returns whether a connection id is valid (and optionally not blocked).
</para>
@object: the object to search for the desired handler.
@handler_id: the connection id.
@may_be_blocked: whether it is acceptable to return a blocked
handler.
@Returns: TRUE if the signal exists and wasn't blocked,
unless #may_be_blocked was specified. FALSE otherwise.
<!-- ##### FUNCTION gtk_signal_handlers_destroy ##### -->
<para>
Destroy all the signal handlers connected to an object.
This is done automatically when the object is destroyed.
</para>
<para>
This function is labeled private.
</para>
@object: the object whose signal handlers should be destroyed.
<!-- ##### FUNCTION gtk_signal_init ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_signal_n_emissions ##### -->
<para>
Find out the recursion depth of emissions for a particular type
of signal and object. (So it will
always return 0 or 1 if #GTK_RUN_NO_RECURSE is specified)
This is a way to avoid recursion: you can see if
you are currently running in that signal handler and emit it only
if you are.
</para>
<para>Another way to look at it is that this number increases
by one when #gtk_signal_emit(), et al, are called,
and decreases by one when #gtk_signal_emit() returns.
</para>
@object: the object with the signal handler.
@signal_id: the signal id.
@Returns: the recursion depth of emissions of this signal for this
object.
<!-- ##### FUNCTION gtk_signal_n_emissions_by_name ##### -->
<para>
Find out the recursion depth of emissions for a particular type
of signal and object. Just like gtk_signal_n_emissions()
except it will lookup the signal id for you.
</para>
@object: the object with the signal handler.
@name: the signal name.
@Returns: the recursion depth of emissions of this signal for this
object.
<!-- ##### FUNCTION gtk_signal_query ##### -->
<para>
Obtain information about a signal.
</para>
@signal_id: the signal type identifier.
@Returns: a pointer to a GtkSignalQuery structure
which contains all the information, or NULL.
The pointer is allocated just for you: you must g_free() it.
<!-- ##### FUNCTION gtk_signal_remove_emission_hook ##### -->
<para>
Delete an emission hook. (see gtk_signal_add_emission_hook())
</para>
@signal_id: the id of the signal type.
@hook_id: the id of the emission handler, returned by add_emission_hook().
@i:
@h:
<!-- ##### FUNCTION gtk_signal_set_funcs ##### -->
<para>
These set default functions to call when the user didn't
supply a function when connecting. (These are rarely
used, and probably only for language bindings)
</para>
<para>
By default, there are no such functions.
</para>
@marshal_func: the function to invoke on every handlers for which there
isn't a function pointer. May be NULL.
@destroy_func: the function to invoke when each hook is destroyed.
May be NULL.
<!-- ##### FUNCTION gtk_spin_button_set_shadow_type ##### -->
<para>
Creates a border around the arrows of a #GtkSpinButton. The type of border is determined by @shadow_type.

8
docs/reference/gtk/tmpl/gtkcellrenderer.sgml
View File

@ -245,14 +245,6 @@ it cannot be individually modified.
@Returns:
<!-- ##### FUNCTION gtk_cell_renderer_editing_canceled ##### -->
<para>
</para>
@cell:
<!-- ##### FUNCTION gtk_cell_renderer_stop_editing ##### -->
<para>

19
docs/reference/gtk/tmpl/gtkcheckmenuitem.sgml
View File

@ -102,14 +102,6 @@ Creates a new #GtkCheckMenuItem with a label.
@Returns:
<!-- ##### MACRO gtk_check_menu_item_set_state ##### -->
<para>
Sets the active state of the menu item's check box.
</para>
@Deprecated: Use gtk_check_menu_item_set_active() instead.
<!-- ##### FUNCTION gtk_check_menu_item_get_active ##### -->
<para>
@ -128,17 +120,6 @@ Sets the active state of the menu item's check box.
@is_active: boolean value indicating whether the check box is active.
<!-- ##### FUNCTION gtk_check_menu_item_set_show_toggle ##### -->
<para>
Controls whether the check box is shown at all times.
Normally the check box is shown only when it is active or while the
menu item is selected.
</para>
@menu_item: a #GtkCheckMenuItem.
@always: boolean value indicating whether to always show the check box.
<!-- ##### FUNCTION gtk_check_menu_item_toggled ##### -->
<para>
Emits the GtkCheckMenuItem::toggled signal.

31
docs/reference/gtk/tmpl/gtkcolorsel.sgml
View File

@ -64,37 +64,6 @@ according to its update policy.
@Returns:
<!-- ##### FUNCTION gtk_color_selection_set_update_policy ##### -->
<para>
Sets the policy controlling when the color_changed signals are emitted.
The available policies are:
<itemizedlist>
<listitem>
<para>
%GTK_UPDATE_CONTINUOUS - signals are sent continuously as the color
selection changes.
</para>
</listitem>
<listitem>
<para>
%GTK_UPDATE_DISCONTINUOUS - signals are sent only when the mouse
button is released.
</para>
</listitem>
<listitem>
<para>
%GTK_UPDATE_DELAYED - signals are sent when the mouse button is
released or when the mouse has been motionless for a period of
time.
</para>
</listitem>
</itemizedlist>
</para>
@colorsel: a #GtkColorSelection.
@policy: a #GtkUpdateType value indicating the desired policy.
<!-- ##### FUNCTION gtk_color_selection_set_has_opacity_control ##### -->
<para>

29
docs/reference/gtk/tmpl/gtkcontainer.sgml
View File

@ -219,14 +219,6 @@ properties in set_child_property() and get_child_property() implementations.
@pspec: the #GParamSpec of the property
<!-- ##### MACRO gtk_container_border_width ##### -->
<para>
Does the same as gtk_container_set_border_width().
</para>
@Deprecated: Use gtk_container_set_border_width() instead.
<!-- ##### FUNCTION gtk_container_add ##### -->
<para>
@ -292,27 +284,6 @@ Does the same as gtk_container_set_border_width().
@callback_data:
<!-- ##### FUNCTION gtk_container_foreach_full ##### -->
<para>
</para>
@container:
@callback:
@marshal:
@callback_data:
@notify:
@Deprecated: Use gtk_container_foreach() instead.
<!-- ##### MACRO gtk_container_children ##### -->
<para>
Does the same as gtk_container_get_children().
</para>
@Deprecated: Use gtk_container_get_children() instead.
<!-- ##### FUNCTION gtk_container_get_children ##### -->
<para>

1260
docs/reference/gtk/tmpl/gtkctree.sgml
View File

File diff suppressed because it is too large Load Diff

163
docs/reference/gtk/tmpl/gtkcurve.sgml
View File

@ -1,163 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkCurve
<!-- ##### SECTION Short_Description ##### -->
Allows direct editing of a curve
<!-- ##### SECTION Long_Description ##### -->
<para>
The #GtkCurve widget allows the user to edit a curve covering a range of
values. It is typically used to fine-tune color balances in graphics
applications like the Gimp.
</para>
<para>
The #GtkCurve widget has 3 modes of operation - spline, linear and free.
In spline mode the user places points on the curve which are automatically
connected together into a smooth curve. In linear mode the user places points
on the curve which are connected by straight lines. In free mode the user can
draw the points of the curve freely, and they are not connected at all.
</para>
<para>
As of GTK+ 2.20, #GtkCurve has been deprecated since it is too specialized.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
<variablelist>
<varlistentry>
<term>#GtkGammaCurve</term>
<listitem><para>a subclass for editing gamma curves.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkCurve ##### -->
<para>
The #GtkCurve-struct struct contains private data only, and
should be accessed using the functions below.
</para>
<!-- ##### SIGNAL GtkCurve::curve-type-changed ##### -->
<para>
Emitted when the curve type has been changed.
The curve type can be changed explicitly with a call to
gtk_curve_set_curve_type(). It is also changed as a side-effect of
calling gtk_curve_reset() or gtk_curve_set_gamma().
</para>
@curve: the object which received the signal.
<!-- ##### ARG GtkCurve:curve-type ##### -->
<para>
</para>
<!-- ##### ARG GtkCurve:max-x ##### -->
<para>
</para>
<!-- ##### ARG GtkCurve:max-y ##### -->
<para>
</para>
<!-- ##### ARG GtkCurve:min-x ##### -->
<para>
</para>
<!-- ##### ARG GtkCurve:min-y ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_curve_new ##### -->
<para>
Creates a new #GtkCurve.
</para>
@Returns: a new #GtkCurve.
@Deprecated: 2.20: Don't use this widget anymore.
<!-- ##### FUNCTION gtk_curve_reset ##### -->
<para>
Resets the curve to a straight line from the minimum x and y values to the
maximum x and y values (i.e. from the bottom-left to the top-right corners).
The curve type is not changed.
</para>
@curve: a #GtkCurve.
@Deprecated: 2.20: Don't use this widget anymore.
<!-- ##### FUNCTION gtk_curve_set_gamma ##### -->
<para>
Recomputes the entire curve using the given gamma value.
A gamma value of 1 results in a straight line. Values greater than 1 result
in a curve above the straight line. Values less than 1 result in a curve
below the straight line. The curve type is changed to %GTK_CURVE_TYPE_FREE.
FIXME: Needs a more precise definition of gamma.
</para>
@curve: a #GtkCurve.
@gamma_: the gamma value.
@Deprecated: 2.20: Don't use this widget anymore.
<!-- ##### FUNCTION gtk_curve_set_range ##### -->
<para>
Sets the minimum and maximum x and y values of the curve.
The curve is also reset with a call to gtk_curve_reset().
</para>
@curve: a #GtkCurve.
@min_x: the minimum x value.
@max_x: the maximum x value.
@min_y: the minimum y value.
@max_y: the maximum y value.
@Deprecated: 2.20: Don't use this widget anymore.
<!-- ##### FUNCTION gtk_curve_get_vector ##### -->
<para>
Returns a vector of points representing the curve.
</para>
@curve: a #GtkCurve.
@veclen: the number of points to calculate.
@vector: returns the points.
@Deprecated: 2.20: Don't use this widget anymore.
<!-- ##### FUNCTION gtk_curve_set_vector ##### -->
<para>
Sets the vector of points on the curve.
The curve type is set to %GTK_CURVE_TYPE_FREE.
</para>
@curve: a #GtkCurve.
@veclen: the number of points.
@vector: the points on the curve.
@Deprecated: 2.20: Don't use this widget anymore.
<!-- ##### FUNCTION gtk_curve_set_curve_type ##### -->
<para>
Sets the type of the curve. The curve will remain unchanged except when
changing from a free curve to a linear or spline curve, in which case the
curve will be changed as little as possible.
</para>
@curve: a #GtkCurve.
@type: the type of the curve.
@Deprecated: 2.20: Don't use this widget anymore.

54
docs/reference/gtk/tmpl/gtkentry.sgml
View File

@ -423,14 +423,6 @@ The #GtkEntry-struct struct contains only private data.
@Returns:
<!-- ##### FUNCTION gtk_entry_new_with_max_length ##### -->
<para>
</para>
@max:
@Returns:
<!-- ##### FUNCTION gtk_entry_get_buffer ##### -->
<para>
@ -458,33 +450,6 @@ The #GtkEntry-struct struct contains only private data.
@text:
<!-- ##### FUNCTION gtk_entry_append_text ##### -->
<para>
</para>
@entry:
@text:
<!-- ##### FUNCTION gtk_entry_prepend_text ##### -->
<para>
</para>
@entry:
@text:
<!-- ##### FUNCTION gtk_entry_set_position ##### -->
<para>
</para>
@entry:
@position:
<!-- ##### FUNCTION gtk_entry_get_text ##### -->
<para>
@ -503,16 +468,6 @@ The #GtkEntry-struct struct contains only private data.
@Returns:
<!-- ##### FUNCTION gtk_entry_select_region ##### -->
<para>
</para>
@entry:
@start:
@end:
<!-- ##### FUNCTION gtk_entry_set_visibility ##### -->
<para>
@ -539,15 +494,6 @@ The #GtkEntry-struct struct contains only private data.
@entry:
<!-- ##### FUNCTION gtk_entry_set_editable ##### -->
<para>
</para>
@entry:
@editable:
<!-- ##### FUNCTION gtk_entry_set_max_length ##### -->
<para>
</para>

9
docs/reference/gtk/tmpl/gtkenums.sgml
View File

@ -111,15 +111,6 @@ widget.
@GTK_CORNER_BOTTOM_RIGHT: Place the scrollbars on the top and left of the
widget.
<!-- ##### ENUM GtkCurveType ##### -->
<para>
</para>
@GTK_CURVE_TYPE_LINEAR:
@GTK_CURVE_TYPE_SPLINE:
@GTK_CURVE_TYPE_FREE:
<!-- ##### ENUM GtkDeleteType ##### -->
<para>

11
docs/reference/gtk/tmpl/gtkfilechooserbutton.sgml
View File

@ -94,17 +94,6 @@ This should not be accessed directly. Use the accessor functions below.
@Returns:
<!-- ##### FUNCTION gtk_file_chooser_button_new_with_backend ##### -->
<para>
</para>
@title:
@action:
@backend:
@Returns:
<!-- ##### FUNCTION gtk_file_chooser_button_new_with_dialog ##### -->
<para>

20
docs/reference/gtk/tmpl/gtkfixed.sgml
View File

@ -125,23 +125,3 @@ Moves a child of a #GtkFixed container to the given position.
@widget: the child widget.
@x: the horizontal position to move the widget to.
@y: the vertical position to move the widget to.
<!-- ##### FUNCTION gtk_fixed_get_has_window ##### -->
<para>
</para>
@fixed:
@Returns:
<!-- ##### FUNCTION gtk_fixed_set_has_window ##### -->
<para>
</para>
@fixed:
@has_window:

47
docs/reference/gtk/tmpl/gtkgamma.sgml
View File

@ -1,47 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkGammaCurve
<!-- ##### SECTION Short_Description ##### -->
A subclass of GtkCurve for editing gamma curves
<!-- ##### SECTION Long_Description ##### -->
<para>
The #GtkGammaCurve widget is a variant of #GtkCurve specifically for
editing gamma curves, which are used in graphics applications such as the
Gimp.
</para>
<para>
The #GtkGammaCurve widget shows a curve which the user can edit with the
mouse just like a #GtkCurve widget. On the right of the curve it also displays
5 buttons, 3 of which change between the 3 curve modes (spline, linear and
free), and the other 2 set the curve to a particular gamma value, or reset it
to a straight line.
</para>
<para>
As of GTK+ 2.20, #GtkGammaCurve has been deprecated since it is too specialized.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkGammaCurve ##### -->
<para>
The #GtkGammaCurve struct contains private data only, and
should be accessed using the functions below.
</para>
<!-- ##### FUNCTION gtk_gamma_curve_new ##### -->
<para>
Creates a new #GtkGammaCurve.
</para>
@Returns: a new #GtkGammaCurve.
@Deprecated: 2.20: Don't use this widget anymore.

36
docs/reference/gtk/tmpl/gtkhbbox.sgml
View File

@ -60,39 +60,3 @@ Creates a new horizontal button box.
</para>
@Returns: a new button box #GtkWidget.
<!-- ##### FUNCTION gtk_hbutton_box_get_spacing_default ##### -->
<para>
Retrieves the current default spacing for horizontal button boxes. This is the number of pixels
to be placed between the buttons when they are arranged.
</para>
@Returns: the default number of pixels between buttons.
<!-- ##### FUNCTION gtk_hbutton_box_get_layout_default ##### -->
<para>
Retrieves the current layout used to arrange buttons in button box widgets.
</para>
@Returns: the current #GtkButtonBoxStyle.
<!-- ##### FUNCTION gtk_hbutton_box_set_spacing_default ##### -->
<para>
Changes the default spacing that is placed between widgets in an
horizontal button box.
</para>
@spacing: an integer value.
<!-- ##### FUNCTION gtk_hbutton_box_set_layout_default ##### -->
<para>
Sets a new layout mode that will be used by all button boxes.
</para>
@layout: a new #GtkButtonBoxStyle.

75
docs/reference/gtk/tmpl/gtkinputdialog.sgml
View File

@ -1,75 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkInputDialog
<!-- ##### SECTION Short_Description ##### -->
Configure devices for the XInput extension
<!-- ##### SECTION Long_Description ##### -->
<para>
#GtkInputDialog displays a dialog which allows the user
to configure XInput extension devices. For each
device, they can control the mode of the device
(disabled, screen-relative, or window-relative),
the mapping of axes to coordinates, and the
mapping of the devices macro keys to key press
events.
</para>
<para>
#GtkInputDialog contains two buttons to which
the application can connect; one for closing
the dialog, and one for saving the changes.
No actions are bound to these by default.
The changes that the user makes take effect
immediately.
</para>
<para>
As of GTK+ 2.20, #GtkInputDialog has been deprecated since it is too specialized.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkInputDialog ##### -->
<para>
</para>
<!-- ##### SIGNAL GtkInputDialog::disable-device ##### -->
<para>
This signal is emitted when the user changes the
mode of a device from a #GDK_MODE_SCREEN or #GDK_MODE_WINDOW
to #GDK_MODE_ENABLED.
</para>
@inputdialog: the object which received the signal.
@deviceid: The ID of the newly disabled device.
<!-- # Unused Parameters # -->
@Deprecated: 2.20: Don't use this widget anymore.
<!-- ##### SIGNAL GtkInputDialog::enable-device ##### -->
<para>
This signal is emitted when the user changes the
mode of a device from #GDK_MODE_DISABLED to a
#GDK_MODE_SCREEN or #GDK_MODE_WINDOW.
</para>
@inputdialog: the object which received the signal.
@deviceid: The ID of the newly enabled device.
<!-- # Unused Parameters # -->
@Deprecated: 2.20: Don't use this widget anymore.
<!-- ##### FUNCTION gtk_input_dialog_new ##### -->
<para>
Creates a new #GtkInputDialog.
</para>
@Returns: the new #GtkInputDialog.
@Deprecated: 2.20: Don't use this widget anymore.

15
docs/reference/gtk/tmpl/gtklabel.sgml
View File

@ -448,21 +448,6 @@ must not write to it.
@Deprecated: Use gtk_label_get_text() instead.
<!-- ##### FUNCTION gtk_label_parse_uline ##### -->
<para>
Parses the given string for underscores and converts the next
character to an underlined character. The last character that
was underlined will have its lower-cased accelerator keyval returned (i.e.
&quot;_File&quot; would return the keyval for &quot;f&quot;. This is
probably only used within the GTK+ library itself for menu items and such.
</para>
@label: The #GtkLabel you want to affect.
@string: The string you want to parse for underlines.
@Returns: The lowercase keyval of the last character underlined.
@Deprecated: Use gtk_label_set_use_underline() instead.
<!-- ##### FUNCTION gtk_label_set_line_wrap ##### -->
<para>

191
docs/reference/gtk/tmpl/gtkmain.sgml
View File

@ -162,18 +162,6 @@ functions such as g_signal_connect().
@Returns:
<!-- ##### FUNCTION gtk_exit ##### -->
<para>
Terminates the program and returns the given exit code to the caller.
This function will shut down the GUI and free all resources allocated
for GTK+.
</para>
@error_code: Return value to pass to the caller. This is dependent on the
target system but at least on Unix systems %0 means success.
@Deprecated: Use the standard exit() function instead.
<!-- ##### FUNCTION gtk_events_pending ##### -->
<para>
Checks if any events are pending. This can be used to update the GUI
@ -485,191 +473,14 @@ Removes a quit handler identified by its @data field.
@data: The pointer passed as @data to gtk_quit_add() or gtk_quit_add_full().
<!-- ##### FUNCTION gtk_timeout_add_full ##### -->
<para>
Registers a function to be called periodically. The function will be called
repeatedly after @interval milliseconds until it returns %FALSE at which
point the timeout is destroyed and will not be called again.
</para>
@interval: The time between calls to the function, in milliseconds
(1/1000ths of a second.)
@function: The function to call periodically.
@marshal: The marshaller to use instead of the function (if non-%NULL).
@data: The data to pass to the function.
@destroy: Function to call when the timeout is destroyed or %NULL.
@Returns: A unique id for the event source.
@Deprecated: 2.4: Use g_timeout_add_full() instead.
<!-- ##### FUNCTION gtk_timeout_add ##### -->
<para>
Registers a function to be called periodically. The function will be called
repeatedly after @interval milliseconds until it returns %FALSE at which
point the timeout is destroyed and will not be called again.
</para>
@interval: The time between calls to the function, in milliseconds
(1/1000ths of a second.)
@function: The function to call periodically.
@data: The data to pass to the function.
@Returns: A unique id for the event source.
@Deprecated: 2.4: Use g_timeout_add() instead.
<!-- ##### FUNCTION gtk_timeout_remove ##### -->
<para>
Removes the given timeout destroying all information about it.
</para>
@timeout_handler_id: The identifier returned when installing the timeout.
@Deprecated: 2.4: Use g_source_remove() instead.
<!-- ##### FUNCTION gtk_idle_add ##### -->
<para>
Causes the mainloop to call the given function whenever no events with
higher priority are to be processed. The default priority is
%GTK_PRIORITY_DEFAULT, which is rather low.
</para>
@function: The function to call.
@data: The information to pass to the function.
@Returns: a unique handle for this registration.
@Deprecated: 2.4: Use g_idle_add() instead.
<!-- ##### FUNCTION gtk_idle_add_priority ##### -->
<para>
Like gtk_idle_add() this function allows you to have a function called
when the event loop is idle. The difference is that you can give a
priority different from %GTK_PRIORITY_DEFAULT to the idle function.
</para>
@priority: The priority which should not be above %G_PRIORITY_HIGH_IDLE.
Note that you will interfere with GTK+ if you use a priority above
%GTK_PRIORITY_RESIZE.
@function: The function to call.
@data: Data to pass to that function.
@Returns: A unique id for the event source.
@Deprecated: 2.4: Use g_idle_add_full() instead.
<!-- ##### FUNCTION gtk_idle_add_full ##### -->
<para>
Like gtk_idle_add() this function allows you to have a function called
when the event loop is idle. The difference is that you can give a
priority different from %GTK_PRIORITY_DEFAULT to the idle function.
</para>
@priority: The priority which should not be above %G_PRIORITY_HIGH_IDLE.
Note that you will interfere with GTK+ if you use a priority above
%GTK_PRIORITY_RESIZE.
@function: The function to call.
@marshal: The marshaller to use instead of the function (if non-%NULL).
@data: Data to pass to that function.
@destroy: Function to call when the timeout is destroyed or %NULL.
@Returns: A unique id for the event source.
@Deprecated: 2.4: Use g_idle_add_full() instead.
<!-- ##### FUNCTION gtk_idle_remove ##### -->
<para>
Removes the idle function with the given id.
</para>
@idle_handler_id: Identifies the idle function to remove.
@Deprecated: 2.4: Use g_source_remove() instead.
<!-- ##### FUNCTION gtk_idle_remove_by_data ##### -->
<para>
Removes the idle function identified by the user data.
</para>
@data: remove the idle function which was registered with this user data.
@Deprecated: 2.4: Use g_idle_remove_by_data() instead.
<!-- ##### FUNCTION gtk_input_add_full ##### -->
<para>
Registers a function to be called when a condition becomes true
on a file descriptor.
</para>
@source: a file descriptor.
@condition: the condition.
@function: The function to call.
@marshal: The marshaller to use instead of the function (if non-%NULL).
@data: callback data passed to @function.
@destroy: callback function to call with @data when the input
handler is removed, or %NULL.
@Returns: A unique id for the event source; to be used with gtk_input_remove().
@Deprecated: 2.4: Use g_io_add_watch_full() instead.
<!-- ##### FUNCTION gtk_input_remove ##### -->
<para>
Removes the function with the given id.
</para>
@input_handler_id: Identifies the function to remove.
@Deprecated: 2.4: Use g_source_remove() instead.
<!-- ##### MACRO GTK_PRIORITY_REDRAW ##### -->
<para>
Use this priority for redrawing related stuff. It is used internally by
GTK+ to do pending redraws. This priority is lower than %GTK_PRIORITY_RESIZE
to avoid redrawing a widget just before resizing (and therefore redrawing
it again).
</para>
@Deprecated: 2.4: This macro is deprecated. You should use %GDK_PRIORITY_REDRAW instead.
<!-- ##### MACRO GTK_PRIORITY_RESIZE ##### -->
<para>
Use this priority for resizing related stuff. It is used internally by
GTK+ to compute the sizes of widgets. This priority is higher than
%GTK_PRIORITY_REDRAW to avoid resizing a widget which was just redrawn.
%GDK_PRIORITY_REDRAW to avoid resizing a widget which was just redrawn.
</para>
<!-- ##### MACRO GTK_PRIORITY_HIGH ##### -->
<para>
Use this for high priority timeouts. This priority is never used inside
GTK+ so everything running at this priority will be running before anything
inside the toolkit.
</para>
@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_HIGH instead.
<!-- ##### MACRO GTK_PRIORITY_INTERNAL ##### -->
<para>
This priority is for GTK+ internal stuff. Don't use it in your applications.
</para>
<!-- ##### MACRO GTK_PRIORITY_DEFAULT ##### -->
<para>
Default priority for idle functions.
</para>
@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_DEFAULT_IDLE instead.
<!-- ##### MACRO GTK_PRIORITY_LOW ##### -->
<para>
Priority for very unimportant background tasks.
</para>
@Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_LOW instead.
<!-- ##### FUNCTION gtk_key_snooper_install ##### -->
<para>
Installs a key snooper function, which will get called on all key events

33
docs/reference/gtk/tmpl/gtkmenu.sgml
View File

@ -206,39 +206,6 @@ Creates a new #GtkMenu.
@screen:
<!-- ##### MACRO gtk_menu_append ##### -->
<para>
Adds a new #GtkMenuItem to the end of the menu's item list.
</para>
@menu: a #GtkMenu.
@child: The #GtkMenuItem to add.
@Deprecated: Use gtk_menu_shell_append() instead.
<!-- ##### MACRO gtk_menu_prepend ##### -->
<para>
Adds a new #GtkMenuItem to the beginning of the menu's item list.
</para>
@menu: a #GtkMenu.
@child: The #GtkMenuItem to add.
@Deprecated: Use gtk_menu_shell_prepend() instead.
<!-- ##### MACRO gtk_menu_insert ##### -->
<para>
Adds a new #GtkMenuItem to the menu's item list at the position
indicated by @position.
</para>
@menu: a #GtkMenu.
@child: The #GtkMenuItem to add.
@pos: The position in the item list where @child is added.
Positions are numbered from 0 to n-1.
@Deprecated: Use gtk_menu_shell_insert() instead.
<!-- ##### FUNCTION gtk_menu_reorder_child ##### -->
<para>
Moves a #GtkMenuItem to a new position within the #GtkMenu.

169
docs/reference/gtk/tmpl/gtkoldeditable.sgml
View File

@ -1,169 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkOldEditable
<!-- ##### SECTION Short_Description ##### -->
Base class for text-editing widgets
<!-- ##### SECTION Long_Description ##### -->
<para>
GtkOldEditable has been deprecated since GTK+ 2.0 and should not be used
in newly written code. Use the #GtkEditable interface instead.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkOldEditable ##### -->
<para>
</para>
@current_pos:
@selection_start_pos:
@selection_end_pos:
@has_selection:
<!-- ##### SIGNAL GtkOldEditable::activate ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
<!-- ##### SIGNAL GtkOldEditable::copy-clipboard ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
<!-- ##### SIGNAL GtkOldEditable::cut-clipboard ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
<!-- ##### SIGNAL GtkOldEditable::kill-char ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
@arg1:
<!-- ##### SIGNAL GtkOldEditable::kill-line ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
@arg1:
<!-- ##### SIGNAL GtkOldEditable::kill-word ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
@arg1:
<!-- ##### SIGNAL GtkOldEditable::move-cursor ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
@arg1:
@arg2:
<!-- ##### SIGNAL GtkOldEditable::move-page ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
@arg1:
@arg2:
<!-- ##### SIGNAL GtkOldEditable::move-to-column ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
@arg1:
<!-- ##### SIGNAL GtkOldEditable::move-to-row ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
@arg1:
<!-- ##### SIGNAL GtkOldEditable::move-word ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
@arg1:
<!-- ##### SIGNAL GtkOldEditable::paste-clipboard ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
<!-- ##### SIGNAL GtkOldEditable::set-editable ##### -->
<para>
</para>
@oldeditable: the object which received the signal.
@arg1:
<!-- ##### ARG GtkOldEditable:editable ##### -->
<para>
</para>
<!-- ##### ARG GtkOldEditable:text-position ##### -->
<para>
</para>
<!-- ##### USER_FUNCTION GtkTextFunction ##### -->
<para>
</para>
@editable:
@time_:
<!-- ##### FUNCTION gtk_old_editable_claim_selection ##### -->
<para>
</para>
@old_editable:
@claim:
@time_:
<!-- ##### FUNCTION gtk_old_editable_changed ##### -->
<para>
</para>
@old_editable:

124
docs/reference/gtk/tmpl/gtkoptionmenu.sgml
View File

@ -1,124 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkOptionMenu
<!-- ##### SECTION Short_Description ##### -->
A widget used to choose from a list of valid choices
<!-- ##### SECTION Long_Description ##### -->
<para>
A #GtkOptionMenu is a widget that allows the user to choose from a
list of valid choices. The #GtkOptionMenu displays the selected
choice. When activated the #GtkOptionMenu displays a popup #GtkMenu
which allows the user to make a new choice.
</para>
<para>
Using a #GtkOptionMenu is simple; build a #GtkMenu, by calling
gtk_menu_new(), then appending menu items to it with
gtk_menu_shell_append(). Set that menu on the option menu
with gtk_option_menu_set_menu(). Set the selected menu item with
gtk_option_menu_set_history(); connect to the "changed" signal on
the option menu; in the "changed" signal, check the new selected
menu item with gtk_option_menu_get_history().
</para>
<para>
As of GTK+ 2.4, #GtkOptionMenu has been deprecated in favor of #GtkComboBox.
</para>
<!-- ##### SECTION See_Also ##### -->
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkOptionMenu ##### -->
<para>
The #GtkOptionMenu-struct struct contains private data only, and
should be accessed using the functions below.
</para>
@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### SIGNAL GtkOptionMenu::changed ##### -->
<para>
</para>
@optionmenu: the object which received the signal.
<!-- ##### ARG GtkOptionMenu:menu ##### -->
<para>
</para>
<!-- ##### ARG GtkOptionMenu:indicator-size ##### -->
<para>
</para>
<!-- ##### ARG GtkOptionMenu:indicator-spacing ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_option_menu_new ##### -->
<para>
Creates a new #GtkOptionMenu.
</para>
@Returns: a new #GtkOptionMenu.
@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_option_menu_get_menu ##### -->
<para>
Returns the #GtkMenu associated with the #GtkOptionMenu.
</para>
@option_menu: a #GtkOptionMenu.
@Returns: the #GtkMenu associated with the #GtkOptionMenu.
@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_option_menu_set_menu ##### -->
<para>
Provides the #GtkMenu that is popped up to allow the user to choose
a new value. You should provide a simple menu avoiding the
use of tearoff menu items, submenus, and accelerators.
</para>
@option_menu: a #GtkOptionMenu.
@menu: the #GtkMenu to associate with the #GtkOptionMenu.
@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_option_menu_remove_menu ##### -->
<para>
Removes the menu from the option menu.
</para>
@option_menu: a #GtkOptionMenu.
@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_option_menu_set_history ##### -->
<para>
Selects the menu item specified by @index_ making it the newly
selected value for the option menu.
</para>
@option_menu: a #GtkOptionMenu.
@index_: the index of the menu item to select. Index values are from 0 to n-1.
@Deprecated: 2.4: Use #GtkComboBox instead.
<!-- ##### FUNCTION gtk_option_menu_get_history ##### -->
<para>
</para>
@option_menu:
@Returns:

19
docs/reference/gtk/tmpl/gtkpaned.sgml
View File

@ -191,15 +191,6 @@ parameters. This is equivalent to
@child: the child to add
<!-- ##### MACRO gtk_paned_gutter_size ##### -->
<para>
Old name for gtk_paned_set_gutter_size().
</para>
@p: a paned widget
@s: the width of the gutter in pixels
<!-- ##### FUNCTION gtk_paned_pack1 ##### -->
<para>
Adds a child to the top or left pane.
@ -240,16 +231,6 @@ Adds a child to the bottom or right pane.
@Returns:
<!-- ##### MACRO gtk_paned_set_gutter_size ##### -->
<para>
In older versions of GTK+, this function used to set the width of the
gutter (the area between the two panes). It does nothing now.
</para>
@p: a paned widget
@s: the width of the gutter in pixels
<!-- ##### FUNCTION gtk_paned_set_position ##### -->
<para>

83
docs/reference/gtk/tmpl/gtkpixmap.sgml
View File

@ -1,83 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkPixmap
<!-- ##### SECTION Short_Description ##### -->
A widget displaying a graphical image or icon
<!-- ##### SECTION Long_Description ##### -->
<para>
The #GtkPixmap widget displays a graphical image or icon.
The icon is typically created using gdk_pixmap_colormap_create_from_xpm()
or gdk_pixmap_colormap_create_from_xpm_d().
</para>
<para>
The pixels in a #GtkPixmap cannot be manipulated by the application after
creation, since under the X Window system the pixel data is stored on the
X server and so is not available to the client application.
If you want to create graphical images which can be manipulated by the
application, look at #GtkImage and #GdkRGB.
</para>
<para>
GtkPixmap has been deprecated since GTK+ 2.0 and should not be used
in newly written code. Use #GtkImage instead.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkPixmap ##### -->
<para>
The #GtkPixmap-struct struct contains private data only, and
should be accessed using the functions below.
</para>
<!-- ##### FUNCTION gtk_pixmap_new ##### -->
<para>
Creates a new #GtkPixmap, using the given GDK pixmap and mask.
</para>
@pixmap: a #GDKPixmap.
@mask: a #GDKBitmap which indicates which parts of the @pixmap should be
transparent.
@Returns: a new #GtkPixmap.
<!-- ##### FUNCTION gtk_pixmap_set ##### -->
<para>
Sets the #GdkPixmap and #GdkBitmap mask.
</para>
@pixmap: a #GtkPixmap.
@val: a #GdkPixmap.
@mask: a #GdkBitmap, which indicates which parts of the @pixmap should be
transparent. This can be NULL, in which case none of the @pixmap is
transparent.
<!-- ##### FUNCTION gtk_pixmap_get ##### -->
<para>
Gets the current #GdkPixmap and #GdkBitmap mask.
</para>
@pixmap: a #GtkPixmap.
@val: returns the current #GdkPixmap.
@mask: returns the current #GdkBitmap mask.
<!-- ##### FUNCTION gtk_pixmap_set_build_insensitive ##### -->
<para>
Sets wether an extra pixmap should be automatically created and used
when the pixmap is insensitive. The default value is %TRUE.
</para>
@pixmap: a #GtkPixmap.
@build: set to %TRUE if an extra pixmap should be automatically created to use
when the pixmap is insensitive.

7
docs/reference/gtk/tmpl/gtkradiobutton.sgml
View File

@ -176,13 +176,6 @@ as @radio_group_member.
@Returns:
<!-- ##### MACRO gtk_radio_button_group ##### -->
<para>
Deprecated compatibility macro. Use gtk_radio_button_get_group() instead.
</para>
<!-- ##### FUNCTION gtk_radio_button_set_group ##### -->
<para>
Sets a #GtkRadioButton's group. It should be noted that this does not change

759
docs/reference/gtk/tmpl/gtksignal.sgml
View File

@ -1,759 +0,0 @@
<!-- ##### SECTION Title ##### -->
Signals
<!-- ##### SECTION Short_Description ##### -->
Object methods and callbacks
<!-- ##### SECTION Long_Description ##### -->
<para>
The GTK+ signal system merely proxies the GLib signal system now. For future
usage, direct use of the <link linkend="gobject-Signals">GSignal</link> API is recommended, this avoids significant
performance hits where #GtkArg structures have to be converted into #GValue<!-- -->s.
</para>
<refsect2>
<title>What are signals?</title>
<para>
Signals are a way to get notification when something happens
and to customize object behavior according to the
user's needs.
Every <wordasword>signal</wordasword> is uniquely identified by a name,
"class_name::signal_name", where signal_name might be something like
"clicked" and class_name might be "GtkButton". Note that some other class
may also define a "clicked" callback, so long as it doesn't derive from
#GtkButton.
</para>
<para>
When they are created, they are also assigned a unique positive integer,
the signal id (1 is the first signal id- 0 is used to flag an error).
Each is also tied to an array of types that describes
the prototype of the function pointer(s) (handlers) you may
connect to the signal. Finally, every signal has
a default handler that is given by a function pointer
in its class structure: it is run by default whenever the
signal is emitted. (It is possible that a signal will
be emitted and a user-defined handler will prevent the default handler
from being run.)
</para>
<para>
Signals are used by everyone, but they are only
created on a per class basis -- so you should not call
call gtk_signal_new() unless you are writing
a new #GtkObject type. However, if you want to make a new signal
for an existing type, you may use gtk_object_class_user_signal_new()
to create a signal that doesn't correspond to a class's builtin
methods.
</para>
</refsect2>
<refsect2>
<title>How are signals used?</title>
<para>
There are two basic actions in the signal handling game.
If you want notification of an event, you must <emphasis>connect</emphasis>
a function pointer and a data pointer to that signal; the data pointer
will be passed as the last argument to the function (so long as you
are using the default marshalling functions).
You will receive a connection id, a unique positive integer
corresponding to that attachment.
</para>
<para>
Functions that want to notify the user of certain actions,
<emphasis>emit</emphasis> signals.
</para>
</refsect2>
<refsect2>
<title>Basic Terminology</title>
<variablelist>
<varlistentry>
<term>signal</term>
<listitem><para>A class method, e.g. GtkButton::clicked.
More precisely it is a unique class-branch/signal-name pair.
This means you may not define a signal handler for a class which
derives from #GtkButton that is called clicked,
but it is okay to share signals names if they are separate in
the class tree.
</para></listitem>
</varlistentry>
<varlistentry>
<term>default handler</term>
<listitem><para>The object's internal method which is invoked
when the signal is emitted.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>user-defined handler</term>
<listitem><para>A function pointer and data connected
to a signal (for a particular object).</para>
<para>There are really two types: those which are connected
normally, and those which are connected by one
of the connect_after functions. The connect_after handlers
are always run after the default handler.</para>
<para>Many toolkits refer to these as <wordasword>callbacks</wordasword>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>emission</term>
<listitem><para>the whole process of emitting a signal,
including the invocation of all
the different handler types mentioned above.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>signal id</term>
<listitem><para>The unique positive (nonzero) integer
used to identify a signal. It can be used instead of
a name to many functions for a slight performance
improvement.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>connection id</term>
<listitem><para>The unique positive (nonzero) integer
used to identify the connection of a user-defined handler
to a signal. Notice that it is allowed to connect the
same function-pointer/user-data pair twice, so
there is no guarantee that a function-pointer/user-data
maps to a unique connection id.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2><title>A brief note on how they work.</title>
<para>
The functions responsible for translating an array of #GtkArgs
to your C compiler's normal semantics are called Marshallers.
They are identified by
gtk_marshal_<replaceable>return_value</replaceable>__<replaceable>parameter_list</replaceable>()
for example a C function returning a gboolean and taking a gint
can be invoked by using gtk_marshal_BOOL__INT().
Not all possibly combinations of return/params are available,
of course, so if you are writing a #GtkObject with parameters
you might have to write a marshaller.
</para>
</refsect2>
<!-- ##### SECTION See_Also ##### -->
<para>
<variablelist>
<varlistentry>
<term>#GtkObject</term>
<listitem><para>The base class for things which emit signals.</para></listitem>
</varlistentry>
<varlistentry>
<term><link linkend="gobject-Signals">GSignal</link></term>
<listitem><para>The GLib signal system.</para></listitem>
</varlistentry>
</variablelist>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### MACRO GTK_SIGNAL_OFFSET ##### -->
<para>
Use in place of <function>offsetof()</function>, which is used if it exists.
</para>
<!-- ##### ENUM GtkSignalRunType ##### -->
<para>
These configure the signal's emission. They control
whether the signal can be emitted recursively on an object
and
whether to run the default method before or after the user-defined handlers.
</para>
<variablelist>
<varlistentry>
<term>GTK_RUN_FIRST</term>
<listitem><para>Run the default handler before the connected user-defined
handlers.
</para></listitem>
</varlistentry>
<varlistentry>
<term>GTK_RUN_LAST</term>
<listitem><para>Run the default handler after the connected
user-defined handlers.
(Handlers registered as "after" always run after the default handler though)
</para></listitem>
</varlistentry>
<varlistentry>
<term>GTK_RUN_BOTH</term>
<listitem><para>Run the default handler twice,
once before the user-defined handlers,
and
once after.
</para></listitem>
</varlistentry>
<varlistentry>
<term>GTK_RUN_NO_RECURSE</term>
<listitem><para>Whether to prevent a handler or hook
from reemitting the signal from within itself.
Attempts to
emit the signal while it is running will result in the signal
emission being restarted once it is done with the current processing.
</para><para>
You must be
careful to avoid having two handlers endlessly reemitting signals,
gtk_signal_n_emissions() can be helpful.
</para></listitem>
</varlistentry>
<varlistentry>
<term>GTK_RUN_ACTION</term>
<listitem><para>The signal is an action you can
invoke without any particular setup or cleanup.
The signal is treated no differently, but some
other code can determine if the signal is appropriate to
delegate to user control. For example, key binding sets
only allow bindings of ACTION signals to keystrokes.
</para></listitem>
</varlistentry>
<varlistentry>
<term>GTK_RUN_NO_HOOKS</term>
<listitem><para>This prevents the connection of emission hooks
to the signal.
</para></listitem>
</varlistentry>
</variablelist>
@GTK_RUN_FIRST:
@GTK_RUN_LAST:
@GTK_RUN_BOTH:
@GTK_RUN_NO_RECURSE:
@GTK_RUN_ACTION:
@GTK_RUN_NO_HOOKS:
<!-- ##### FUNCTION gtk_signal_new ##### -->
<para>
Creates a new signal type. (This is usually done in the
class initializer.)
</para>
@name: the event name for the signal, e.g. "clicked".
@signal_flags: a combination of #GTK_RUN flags
specifying detail of when the default handler is to be invoked.
You should at least specify #GTK_RUN_FIRST
or #GTK_RUN_LAST.
@object_type: the type of object this signal pertains to.
It will also pertain to derivers of this type automatically.
@function_offset: How many bytes the function pointer is in
the class structure for this type. Used to invoke a class
method generically.
@marshaller: the function to translate between an array
of GtkArgs and the native calling convention. Usually they
are identified just by the type of arguments they take:
for example, gtk_marshal_BOOL__STRING() describes a marshaller
which takes a string and returns a boolean value.
@return_val: the type of return value, or #GTK_TYPE_NONE for a signal
without a return value.
@n_args: the number of parameter the handlers may take.
@Varargs: a list of #GTK_TYPE_*, one for each parameter.
@Returns: the signal id.
@Deprecated: Use g_signal_new() instead.
<!-- ##### FUNCTION gtk_signal_newv ##### -->
<para>
Creates a new signal type. (This is usually done in a
class initializer.)
</para>
<para>
This function take the types as an array, instead of a list
following the arguments. Otherwise the same as gtk_signal_new().
</para>
@name: the name of the signal to create.
@signal_flags: see gtk_signal_new().
@object_type: the type of #GtkObject to associate the signal with.
@function_offset: how many bytes the function pointer is in
the class structure for this type.
@marshaller:
@return_val: the type of the return value, or #GTK_TYPE_NONE if
you don't want a return value.
@n_args: the number of parameters to the user-defined handlers.
@args: an array of #GtkType<!---->s, describing the prototype to
the callbacks.
@Returns: the signal id.
@Deprecated: Use g_signal_newv() instead.
<!-- ##### MACRO gtk_signal_lookup ##### -->
<para>
Given the name of the signal and the type of object it connects
to, get the signal's identifying integer. Emitting the signal
by number is somewhat faster than using the name each time.
</para>
<para>
It also tries the ancestors of the given type.
</para>
@name: the signal's name, e.g. clicked.
@object_type: the type that the signal operates on, e.g. #GTK_TYPE_BUTTON.
@Returns: the signal's identifying number, or 0 if no signal was found.
@Deprecated: Use g_signal_lookup() instead.
<!-- ##### MACRO gtk_signal_name ##### -->
<para>
Given the signal's identifier, finds its name.
</para>
<para>
Two different signals may have the same name, if they have differing types.
</para>
@signal_id: the signal's identifying number.
@Returns: the signal name, or %NULL if the signal number was invalid.
@Deprecated: Use g_signal_name() instead.
<!-- ##### FUNCTION gtk_signal_emit ##### -->
<para>
Emits a signal. This causes the default handler and user-defined
handlers to be run.
</para>
<para>
Here is what gtk_signal_emit() does:
</para>
<para>
1. Calls the default handler and the user-connected handlers.
The default handler will be called first if
#GTK_RUN_FIRST is set, and last if #GTK_RUN_LAST is set.
</para>
<para>
2. Calls all handlers connected with the "after" flag set.
</para>
@object: the object that emits the signal.
@signal_id: the signal identifier.
@Varargs: the parameters to the function, followed
by a pointer to the return type, if any.
@Deprecated: Use g_signal_emit() instead.
<!-- ##### FUNCTION gtk_signal_emit_by_name ##### -->
<para>
Emits a signal. This causes the default handler and user-connected
handlers to be run.
</para>
@object: the object that emits the signal.
@name: the name of the signal.
@Varargs: the parameters to the function, followed
by a pointer to the return type, if any.
@Deprecated: Use g_signal_emit_by_name() instead.
<!-- ##### FUNCTION gtk_signal_emitv ##### -->
<para>
Emits a signal. This causes the default handler and user-connected
handlers to be run. This differs from gtk_signal_emit() by taking
an array of GtkArgs instead of using C's varargs mechanism.
</para>
@object: the object to emit the signal to.
@signal_id: the signal identifier.
@args: an array of GtkArgs, one for each parameter,
followed by one which is a pointer to the return type.
@Deprecated: Use g_signal_emitv() instead.
<!-- ##### FUNCTION gtk_signal_emitv_by_name ##### -->
<para>
Emits a signal by name. This causes the default handler and user-connected
handlers to be run. This differs from gtk_signal_emit() by taking
an array of GtkArgs instead of using C's varargs mechanism.
</para>
@object: the object to emit the signal to.
@name: the name of the signal.
@args: an array of GtkArgs, one for each parameter,
followed by one which is a pointer to the return type.
@Deprecated: Use g_signal_emitv() and g_signal_lookup() instead.
<!-- ##### MACRO gtk_signal_emit_stop ##### -->
<para>
This function aborts a signal's current emission.
</para>
<para>
It will prevent the default method from running,
if the signal was #GTK_RUN_LAST and you connected
normally (i.e. without the "after" flag).
</para>
<para>
It will print a warning if used on a signal which
isn't being emitted.
</para>
@object: the object whose signal handlers you wish to stop.
@signal_id: the signal identifier, as returned by g_signal_lookup().
@Deprecated: Use g_signal_stop_emission() instead.
<!-- ##### FUNCTION gtk_signal_emit_stop_by_name ##### -->
<para>
This function aborts a signal's current emission.
</para>
<para>
It is just like gtk_signal_emit_stop()
except it will lookup the signal id for you.
</para>
@object: the object whose signal handlers you wish to stop.
@name: the name of the signal you wish to stop.
@Deprecated: Use g_signal_stop_emission_by_name() instead.
<!-- ##### MACRO gtk_signal_connect ##### -->
<para>
Attaches a function pointer and user data to a signal for
a particular object.
</para>
<para>
The #GtkSignalFunction takes a #GtkObject as its first parameter.
It will be the same object as the one you're connecting
the hook to. The @func_data will be passed as the last parameter
to the hook.
</para>
<para>
All else being equal, signal handlers are invoked in the order
connected (see gtk_signal_emit() for the other details of
which order things are called in).
</para>
<para>
Here is how one passes an integer as user data,
for when you just want to specify a constant int
as parameter to your function:
</para>
<informalexample>
<programlisting>
static void button_clicked_int (GtkButton* button, gpointer func_data)
{
g_print ("button pressed: &percnt;d\n", GPOINTER_TO_INT (func_data));
}
/* By calling this function, you will make the g_print above
* execute, printing the number passed as `to_print'. */
static void attach_print_signal (GtkButton* button, gint to_print)
{
gtk_signal_connect (GTK_OBJECT (button), "clicked",
GTK_SIGNAL_FUNC (button_clicked_int),
GINT_TO_POINTER (to_print));
}
</programlisting>
</informalexample>
@object: the object associated with the signal, e.g. if a button
is getting pressed, this is that button.
@name: name of the signal.
@func: function pointer to attach to the signal.
@func_data: value to pass as to your function (through the marshaller).
@Returns: the connection id.
@Deprecated: Use g_signal_connect() instead.
<!-- ##### MACRO gtk_signal_connect_after ##### -->
<para>
Attaches a function pointer and user data to a signal
so that this handler will be called after the other handlers.
</para>
@object: the object associated with the signal.
@name: name of the signal.
@func: function pointer to attach to the signal.
@func_data: value to pass as to your function (through the marshaller).
@Returns: the unique identifier for this attachment: the connection id.
@Deprecated: Use g_signal_connect_after() instead.
<!-- ##### MACRO gtk_signal_connect_object ##### -->
<para>
This function is for registering a callback that will
call another object's callback. That is,
instead of passing the object which is responsible
for the event as the first parameter of the callback,
it is switched with the user data (so the object which emits
the signal will be the last parameter, which is where the
user data usually is).
</para>
<para>
This is useful for passing a standard function in as a callback.
For example, if you wanted a button's press to gtk_widget_show()
some widget, you could write:
</para>
<informalexample>
<programlisting>
gtk_signal_connect_object (button, "clicked", gtk_widget_show, window);
</programlisting>
</informalexample>
@object: the object which emits the signal.
@name: the name of the signal.
@func: the function to callback.
@slot_object: the object to pass as the first parameter to func.
(Though it pretends to take an object, you can
really pass any gpointer as the #slot_object .)
@Returns: the connection id.
@Deprecated: Use g_signal_connect_swapped() instead.
<!-- ##### MACRO gtk_signal_connect_object_after ##### -->
<para>
Attaches a signal hook to a signal, passing in an alternate
object as the first parameter, and guaranteeing
that the default handler and all normal
handlers are called first.
</para>
@object: the object associated with the signal.
@name: name of the signal.
@func: function pointer to attach to the signal.
@slot_object: the object to pass as the first parameter to #func.
@Returns: the connection id.
@Deprecated: Use g_signal_connect_data() instead, passing
<literal>G_CONNECT_AFTER|G_CONNECT_SWAPPED</literal> as @connect_flags.
<!-- ##### FUNCTION gtk_signal_connect_full ##### -->
<para>
Attaches a function pointer and user data to a signal with
more control.
</para>
@object: the object which emits the signal. For example, a button
in the button press signal.
@name: the name of the signal.
@func: function pointer to attach to the signal.
@unsupported:
@data: the user data associated with the function.
@destroy_func: function to call when this particular hook is
disconnected.
@object_signal: whether this is an object signal-- basically an "object
signal" is one that wants its user_data and object fields switched,
which is useful for calling functions which operate on another
object primarily.
@after: whether to invoke the user-defined handler after the signal, or to let
the signal's default behavior preside (i.e. depending on #GTK_RUN_FIRST
and #GTK_RUN_LAST).
@Returns: the connection id.
@Deprecated: Use g_signal_connect_data() instead.
<!-- ##### FUNCTION gtk_signal_connect_while_alive ##### -->
<para>
Attaches a function pointer and another #GtkObject to a signal.
</para>
<para>
This function takes an object whose "destroy" signal
should be trapped.
That way, you don't have to clean up the
signal handler when you destroy the object.
It is a little less efficient though.
</para>
<para>
(Instead you may call gtk_signal_disconnect_by_data(), if you want
to explicitly delete all attachments to this object. This
is perhaps not recommended since it could be confused
with an integer masquerading as a pointer (through GINT_TO_POINTER()).)
</para>
@object: the object that emits the signal.
@name: name of the signal.
@func: function pointer to attach to the signal.
@func_data: pointer to pass to func.
@alive_object: object whose death should cause the handler connection
to be destroyed.
@Deprecated: Use g_signal_connect_object() instead.
<!-- ##### FUNCTION gtk_signal_connect_object_while_alive ##### -->
<para>
These signal connectors are for signals which refer to objects,
so they must not be called after the object is deleted.
</para>
<para>
Unlike gtk_signal_connect_while_alive(),
this swaps the object and user data, making it suitable for
use with functions which primarily operate on the user data.
</para>
<para>
This function acts just like gtk_signal_connect_object() except
it traps the "destroy" signal to prevent you from having to
clean up the handler.
</para>
@object: the object associated with the signal.
@name: name of the signal.
@func: function pointer to attach to the signal.
@alive_object: the user data, which must be an object, whose destruction
should signal the removal of this signal.
@Deprecated: Use g_signal_connect_object() instead, passing
<literal>G_CONNECT_SWAPPED</literal> as @connect_flags.
<!-- ##### MACRO gtk_signal_disconnect ##### -->
<para>
Destroys a user-defined handler connection.
</para>
@object: the object which the handler pertains to.
@handler_id: the connection id.
@Deprecated: Use g_signal_handler_disconnect() instead.
<!-- ##### MACRO gtk_signal_disconnect_by_func ##### -->
<para>
Destroys all connections for a particular object, with
the given function-pointer and user-data.
</para>
@object: the object which emits the signal.
@func: the function pointer to search for.
@data: the user data to search for.
@Deprecated: Use g_signal_handlers_disconnect_by_func() instead.
<!-- ##### MACRO gtk_signal_disconnect_by_data ##### -->
<para>
Destroys all connections for a particular object, with
the given user-data.
</para>
@object: the object which emits the signal.
@data: the user data to search for.
@Deprecated: Use g_signal_handlers_disconnect_matched() instead.
<!-- ##### MACRO gtk_signal_handler_block ##### -->
<para>
Prevents a user-defined handler from being invoked. All other
signal processing will go on as normal, but this particular
handler will ignore it.
</para>
@object: the object which emits the signal to block.
@handler_id: the connection id.
@Deprecated: Use g_signal_handler_block() instead.
<!-- ##### MACRO gtk_signal_handler_block_by_func ##### -->
<para>
Prevents a user-defined handler from being invoked, by reference to
the user-defined handler's function pointer and user data. (It may result in
multiple hooks being blocked, if you've called connect multiple times.)
</para>
@object: the object which emits the signal to block.
@func: the function pointer of the handler to block.
@data: the user data of the handler to block.
@Deprecated: Use g_signal_handlers_block_by_func() instead.
<!-- ##### MACRO gtk_signal_handler_block_by_data ##### -->
<para>
Prevents all user-defined handlers with a certain user data from being invoked.
</para>
@object: the object which emits the signal we want to block.
@data: the user data of the handlers to block.
@Deprecated: Use g_signal_handlers_block_matched() instead.
<!-- ##### MACRO gtk_signal_handler_unblock ##### -->
<para>
Undoes a block, by connection id. Note that undoing a block doesn't
necessarily make the hook callable, because if you block a
hook twice, you must unblock it twice.
</para>
@object: the object which emits the signal we want to unblock.
@handler_id: the emission handler identifier, as returned by
gtk_signal_connect(), etc.
@Deprecated: Use g_signal_handler_unblock() instead.
<!-- ##### MACRO gtk_signal_handler_unblock_by_func ##### -->
<para>
Undoes a block, by function pointer and data.
Note that undoing a block doesn't
necessarily make the hook callable, because if you block a
hook twice, you must unblock it twice.
</para>
@object: the object which emits the signal we want to unblock.
@func: the function pointer to search for.
@data: the user data to search for.
@Deprecated: Use g_signal_handlers_unblock_by_func() instead.
<!-- ##### MACRO gtk_signal_handler_unblock_by_data ##### -->
<para>
Undoes block(s), to all signals for a particular object
with a particular user-data pointer
</para>
@object: the object which emits the signal we want to unblock.
@data: the user data to search for.
@Deprecated: Use g_signal_handlers_unblock_matched() instead.
<!-- ##### MACRO gtk_signal_handler_pending ##### -->
<para>
Returns a connection id corresponding to a given signal id and object.
</para>
<para>
One example of when you might use this is when the arguments
to the signal are difficult to compute. A class implementor
may opt to not emit the signal if no one is attached anyway,
thus saving the cost of building the arguments.
</para>
@object: the object to search for the desired user-defined handler.
@signal_id: the number of the signal to search for.
@may_be_blocked: whether it is acceptable to return a blocked
handler.
@Returns: the connection id, if a connection was found. 0 otherwise.
@Deprecated: Use g_signal_has_handler_pending() instead.
<!-- ##### MACRO gtk_signal_handler_pending_by_func ##### -->
<para>
Returns a connection id corresponding to a given signal id, object, function
pointer and user data.
</para>
@object: the object to search for the desired handler.
@signal_id: the number of the signal to search for.
@may_be_blocked: whether it is acceptable to return a blocked
handler.
@func: the function pointer to search for.
@data: the user data to search for.
@Returns: the connection id, if a handler was found. 0 otherwise.
<!-- ##### MACRO gtk_signal_default_marshaller ##### -->
<para>
A marshaller that returns void and takes no extra parameters.
</para>

314
docs/reference/gtk/tmpl/gtkstyle.sgml
View File

@ -250,320 +250,6 @@ Does the same as gtk_style_apply_default_background().
@Varargs:
<!-- ##### FUNCTION gtk_draw_hline ##### -->
<para>
</para>
@style:
@window:
@state_type:
@x1:
@x2:
@y:
<!-- ##### FUNCTION gtk_draw_vline ##### -->
<para>
</para>
@style:
@window:
@state_type:
@y1_:
@y2_:
@x:
<!-- ##### FUNCTION gtk_draw_shadow ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
<!-- ##### FUNCTION gtk_draw_polygon ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@points:
@npoints:
@fill:
<!-- ##### FUNCTION gtk_draw_arrow ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@arrow_type:
@fill:
@x:
@y:
@width:
@height:
<!-- ##### FUNCTION gtk_draw_diamond ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
<!-- ##### FUNCTION gtk_draw_string ##### -->
<para>
</para>
@style:
@window:
@state_type:
@x:
@y:
@string:
<!-- ##### FUNCTION gtk_draw_box ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
<!-- ##### FUNCTION gtk_draw_box_gap ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
@gap_side:
@gap_x:
@gap_width:
<!-- ##### FUNCTION gtk_draw_check ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
<!-- ##### FUNCTION gtk_draw_extension ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
@gap_side:
<!-- ##### FUNCTION gtk_draw_flat_box ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
<!-- ##### FUNCTION gtk_draw_focus ##### -->
<para>
</para>
@style:
@window:
@x:
@y:
@width:
@height:
<!-- ##### FUNCTION gtk_draw_handle ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
@orientation:
<!-- ##### FUNCTION gtk_draw_option ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
<!-- ##### FUNCTION gtk_draw_shadow_gap ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
@gap_side:
@gap_x:
@gap_width:
<!-- ##### FUNCTION gtk_draw_slider ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
@orientation:
<!-- ##### FUNCTION gtk_draw_tab ##### -->
<para>
</para>
@style:
@window:
@state_type:
@shadow_type:
@x:
@y:
@width:
@height:
<!-- ##### FUNCTION gtk_draw_expander ##### -->
<para>
</para>
@style:
@window:
@state_type:
@x:
@y:
@expander_style:
<!-- ##### FUNCTION gtk_draw_layout ##### -->
<para>
</para>
@style:
@window:
@state_type:
@use_text:
@x:
@y:
@layout:
<!-- ##### FUNCTION gtk_draw_resize_grip ##### -->
<para>
</para>
@style:
@window:
@state_type:
@edge:
@x:
@y:
@width:
@height:
<!-- ##### FUNCTION gtk_paint_arrow ##### -->
<para>

238
docs/reference/gtk/tmpl/gtktext.sgml
View File

@ -1,238 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkText
<!-- ##### SECTION Short_Description ##### -->
A text widget
<!-- ##### SECTION Long_Description ##### -->
<para>
<warning>
<para>
#GtkText is deprecated and unsupported. It is known to be
buggy. To use it, you must define the symbol %GTK_ENABLE_BROKEN
prior to including the GTK+ header files. Use #GtkTextView instead.
</para>
</warning>
A #GtkText widget allows one to display any given text and manipulate it
by deleting from one point to another, selecting a region, and various
other functions as outlined below. It is inherited from #GtkEditable.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkText ##### -->
<para>
Most of the #GtkText-struct struct members should not be accessed directly.
Listed below are a few exceptions and how to use them.
</para>
<!-- ##### SIGNAL GtkText::set-scroll-adjustments ##### -->
<para>
</para>
@text: the object which received the signal.
@arg1:
@arg2:
<!-- ##### ARG GtkText:hadjustment ##### -->
<para>
Used by the #GtkText widget to keep track of the size of its horizontal
text.
</para>
<!-- ##### ARG GtkText:line-wrap ##### -->
<para>
Boolean value indicating whether line wrap is enabled or not.
</para>
<!-- ##### ARG GtkText:vadjustment ##### -->
<para>
Used by the #GtkText widget to keep track of the size of its vertical
text.
</para>
<!-- ##### ARG GtkText:word-wrap ##### -->
<para>
Boolean value indicated whether word wrap is enabled or not.
</para>
<!-- ##### STRUCT GtkTextFont ##### -->
<para>
Internal #GtkText data type.
<!-- Pretty sure.. declared in gtktext.c -->
</para>
<!-- ##### STRUCT GtkPropertyMark ##### -->
<para>
Internal #GtkText data type. Should not be accessed directly.
<!-- FIXME: unsure about this -->
</para>
@property:
@offset:
@index:
<!-- ##### FUNCTION gtk_text_new ##### -->
<para>
Creates a new #GtkText widget, initialized with the given pointers to
#GtkAdjustments. These pointers can be used to track the viewing position
of the #GtkText widget. Passing %NULL to either or both of them will make
the #GtkText create its own. You can set these later with the function
gtk_text_set_adjustment().
</para>
@hadj: horizontal adjustment.
@vadj: vertical adjustment.
@Returns: the new #GtkText widget.
<!-- ##### FUNCTION gtk_text_set_editable ##### -->
<para>
Sets whether the #GtkText widget can be edited by the user or not. This
still allows you the programmer to make changes with the various #GtkText
functions.
</para>
@text: the #GtkText widget
@editable: %TRUE makes it editable, %FALSE makes it immutable by the user
<!-- ##### FUNCTION gtk_text_set_word_wrap ##### -->
<para>
Sets whether the #GtkText widget wraps words down to the next line if it
can't be completed on the current line.
</para>
@text: the #GtkText widget
@word_wrap: %TRUE makes it word wrap, %FALSE disables word wrapping
<!-- ##### FUNCTION gtk_text_set_line_wrap ##### -->
<para>
Controls how #GtkText handles long lines of continuous text. If line wrap
is on, the line is broken when it reaches the extent of the #GtkText widget
viewing area and the rest is displayed on the next line. If it is not set,
the line continues regardless size of current viewing area. Similar to word
wrap but it disregards word boundaries.
</para>
@text: the #GtkText widget
@line_wrap: %TRUE turns line wrap on, %FALSE turns it off
<!-- ##### FUNCTION gtk_text_set_adjustments ##### -->
<para>
Allows you to set #GtkAdjustment pointers which in turn allows you to
keep track of the viewing position of the #GtkText widget.
</para>
@text: the #GtkText widget
@hadj: the horizontal adjustment
@vadj: the vertical adjustment
<!-- ##### FUNCTION gtk_text_set_point ##### -->
<para>
Sets the cursor at the given point. In this case a point constitutes
the number of characters from the extreme upper left corner of the #GtkText
widget.
</para>
@text: the #GtkText widget
@index: the number of characters from the upper left corner
<!-- ##### FUNCTION gtk_text_get_point ##### -->
<para>
Gets the current position of the cursor as the number of characters from
the upper left corner of the #GtkText widget.
</para>
@text: the #GtkText widget
@Returns: the number of characters from the upper left corner
<!-- ##### FUNCTION gtk_text_get_length ##### -->
<para>
Returns the length of the all the text contained within the #GtkText widget;
disregards current point position.
</para>
@text: the #GtkText widget
@Returns: the length of the text
<!-- ##### FUNCTION gtk_text_freeze ##### -->
<para>
Freezes the #GtkText widget which disallows redrawing of the widget until
it is thawed. This is useful if a large number of changes are going to
made to the text within the widget, reducing the amount of flicker seen
by the user.
</para>
@text: the #GtkText widget
<!-- ##### FUNCTION gtk_text_thaw ##### -->
<para>
Allows the #GtkText widget to be redrawn again by GTK.
</para>
@text: the #GtkText widget
<!-- ##### FUNCTION gtk_text_insert ##### -->
<para>
Inserts given text into the #GtkText widget with the given properties as
outlined below.
</para>
@text: the #GtkText widget
@font: the #GdkFont to use
@fore: the foreground color to insert with
@back: the background color to insert with
@chars: the actual text to be inserted
@length: the length of the text to be inserted, passing -1 makes it insert
all the text.
<!-- ##### FUNCTION gtk_text_backward_delete ##### -->
<para>
Deletes from the current point position backward the given number of
characters.
</para>
@text: the #GtkText widget
@nchars: the number of characters to delete
@Returns: %TRUE if the operation was successful, otherwise returns %FALSE
<!-- ##### FUNCTION gtk_text_forward_delete ##### -->
<para>
Deletes from the current point position forward the given number of
characters.
</para>
@text: the #GtkText widget
@nchars: the number of characters to delete
@Returns: %TRUE if the operation was successful, otherwise returns %FALSE
<!-- ##### MACRO GTK_TEXT_INDEX ##### -->
<para>
Returns the character at the given index within the #GtkText widget.
</para>
@t: the #GtkText widget
@index: the number of characters from the upper left corner

8
docs/reference/gtk/tmpl/gtktogglebutton.sgml
View File

@ -152,14 +152,6 @@ Creates a new toggle button with a text label.
@Returns:
<!-- ##### MACRO gtk_toggle_button_set_state ##### -->
<para>
This is a deprecated macro, and is only maintained for compatibility reasons.
</para>
@Deprecated: Use gtk_toggle_button_set_active() instead.
<!-- ##### FUNCTION gtk_toggle_button_toggled ##### -->
<para>
Emits the <link linkend="GtkToggleButton-toggled">toggled</link>

11
docs/reference/gtk/tmpl/gtktoolitem.sgml
View File

@ -108,17 +108,6 @@ GtkToolItem
@Returns:
<!-- ##### FUNCTION gtk_tool_item_set_tooltip ##### -->
<para>
</para>
@tool_item:
@tooltips:
@tip_text:
@tip_private:
<!-- ##### FUNCTION gtk_tool_item_set_tooltip_text ##### -->
<para>

191
docs/reference/gtk/tmpl/gtktooltips.sgml
View File

@ -1,191 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkTooltips
<!-- ##### SECTION Short_Description ##### -->
Add tips to your widgets
<!-- ##### SECTION Long_Description ##### -->
<para>
#GtkTooltips has been deprecated in GTK+ 2.12, in favor of the new
#GtkTooltip API.
</para>
<para>
Tooltips are the messages that appear next to a widget when the mouse pointer is held over it for a short amount of time. They are especially helpful for adding more verbose descriptions of things such as buttons in a toolbar.
</para>
<para>
An individual tooltip belongs to a group of tooltips. A group is created with a call to gtk_tooltips_new(). Every tooltip in the group can then be turned off with a call to gtk_tooltips_disable() and enabled with gtk_tooltips_enable().
</para>
<para>
The length of time the user must keep the mouse over a widget before the tip is shown, can be altered with gtk_tooltips_set_delay(). This is set on a 'per group of tooltips' basis.
</para>
<para>
To assign a tip to a particular #GtkWidget, gtk_tooltips_set_tip() is used.
</para>
<note>
<para>
Tooltips can only be set on widgets which have their own X window and
receive enter and leave events.
To check if a widget has its own window use GTK_WIDGET_NO_WINDOW().
To add a tooltip to a widget that doesn't have its own window, place the
widget inside a #GtkEventBox and add a tooltip to that instead.
</para>
</note>
<para>
The default appearance of all tooltips in a program is determined by the current GTK+ theme that the user has selected.
</para>
<para>
Information about the tooltip (if any) associated with an arbitrary widget can be retrieved using gtk_tooltips_data_get().
</para>
<para>
<example>
<title>Adding tooltips to buttons.</title>
<programlisting>
GtkWidget *load_button, *save_button, *hbox;
GtkTooltips *button_bar_tips;
button_bar_tips = gtk_tooltips_new (<!-- -->);
/* Create the buttons and pack them into a GtkHBox */
hbox = gtk_hbox_new (TRUE, 2);
load_button = gtk_button_new_with_label ("Load a file");
gtk_box_pack_start (GTK_BOX (hbox), load_button, TRUE, TRUE, 2);
gtk_widget_show (load_button);
save_button = gtk_button_new_with_label ("Save a file");
gtk_box_pack_start (GTK_BOX (hbox), save_button, TRUE, TRUE, 2);
gtk_widget_show (save_button);
gtk_widget_show (hbox);
/* Add the tips */
gtk_tooltips_set_tip (GTK_TOOLTIPS (button_bar_tips), load_button,
"Load a new document into this window",
"Requests the filename of a document.
This will then be loaded into the current
window, replacing the contents of whatever
is already loaded.");
gtk_tooltips_set_tip (GTK_TOOLTIPS (button_bar_tips), save_button,
"Saves the current document to a file",
"If you have saved the document previously,
then the new version will be saved over the
old one. Otherwise, you will be prompted for
a filename.");
</programlisting></example>
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
<variablelist>
<varlistentry>
<term>#GtkToolbar</term>
<listitem><para>Create groups of widgets with their own tooltips.</para></listitem>
</varlistentry>
<varlistentry>
<term>#GtkTipsQuery</term>
<listitem><para>Query tooltips to create context-sensitive help.</para></listitem>
</varlistentry>
</variablelist>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkTooltips ##### -->
<para>Holds information about a group of tooltips. Fields should be changed using the functions provided, rather than directly accessing the struct's members.
</para>
<!-- ##### STRUCT GtkTooltipsData ##### -->
<para>
<structfield>tooltips</structfield> is the #GtkTooltips group that this tooltip belongs to. <structfield>widget</structfield> is the #GtkWidget that this tooltip data is associated with. <structfield>tip_text</structfield> is a string containing the tooltip message itself.</para>
<para>
<structfield>tip_private</structfield> is a string that is not shown as the default tooltip. Instead, this message may be more informative and go towards forming a context-sensitive help system for your application. (FIXME: how to actually "switch on" private tips?)
</para>
@tooltips:
@widget:
@tip_text:
@tip_private:
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_new ##### -->
<para>
Creates an empty group of tooltips. This function initialises a #GtkTooltips structure. Without at least one such structure, you can not add tips to your application.
</para>
@Returns: a new #GtkTooltips group for you to use.
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_enable ##### -->
<para>
Allows the user to see your tooltips as they navigate your application.
</para>
@tooltips: a #GtkTooltips.
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_disable ##### -->
<para>
Causes all tooltips in @tooltips to become inactive. Any widgets that have tips associated with that group will no longer display their tips until they are enabled again with gtk_tooltips_enable().
</para>
@tooltips: a #GtkTooltips.
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_set_delay ##### -->
<para>
Sets the time between the user moving the mouse over a widget and the widget's tooltip appearing.
</para>
@tooltips: a #GtkTooltips.
@delay: an integer value representing milliseconds.
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_set_tip ##### -->
@tooltips:
@widget:
@tip_text:
@tip_private:
<!-- ##### FUNCTION gtk_tooltips_data_get ##### -->
<para>
Retrieves any #GtkTooltipsData previously associated with the given widget.
</para>
@widget: a #GtkWidget.
@Returns: a #GtkTooltipsData struct, or %NULL if the widget has no tooltip.
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_force_window ##### -->
<para>
Ensures that the window used for displaying the given @tooltips is created.
</para>
<para>
Applications should never have to call this function, since GTK+ takes
care of this.
</para>
@tooltips: a #GtkToolTips
@Deprecated: 2.12:
<!-- ##### FUNCTION gtk_tooltips_get_info_from_tip_window ##### -->
<para>
</para>
@tip_window:
@tooltips:
@current_widget:
@Returns:
@Deprecated: 2.12:

306
docs/reference/gtk/tmpl/gtktree.sgml
View File

@ -1,306 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkTree
<!-- ##### SECTION Short_Description ##### -->
A tree widget
<!-- ##### SECTION Long_Description ##### -->
<para>
<warning>
<para>
#GtkTree is deprecated and unsupported. It is known to be
buggy. To use it, you must define the symbol %GTK_ENABLE_BROKEN
prior to including the GTK+ header files. Use #GtkTreeView instead.
</para>
</warning>
The #GtkTree widget is a container that shows users a list of items, in a tree format complete with branches and leafnodes. Branches can be expanded to show their child items, or collapsed to hide them.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
#GtkTreeList for the items to put into a #GtkTree.
</para>
<para>
#GtkScrolledWindow for details on how to scroll around a #GtkTree.
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkTree ##### -->
<para>
<programlisting>
struct _GtkTree
{
GtkContainer container;
GList *children;
GtkTree* root_tree; /* owner of selection list */
GtkWidget* tree_owner;
GList *selection;
guint level;
guint indent_value;
guint current_indent;
guint selection_mode : 2;
guint view_mode : 1;
guint view_line : 1;
};
</programlisting>
</para>
<!-- ##### SIGNAL GtkTree::select-child ##### -->
<para>
This signal is emitted by @tree whenever @widget is about to be selected.
</para>
@tree: the object which received the signal.
@widget: The child that is about to be selected.
<!-- ##### SIGNAL GtkTree::selection-changed ##### -->
<para>
This signal is emitted by the root tree whenever the selection changes.
</para>
@tree: the object which received the signal.
<!-- ##### SIGNAL GtkTree::unselect-child ##### -->
<para>
This signal is emitted by @tree whenever @widget is about to be unselected.
</para>
@tree: the object which received the signal.
@widget: The child that is about to be unselected.
<!-- ##### MACRO GTK_IS_ROOT_TREE ##### -->
<para>
A macro that returns a boolean value which indicates if @obj is a root tree or not.
</para>
@obj: A pointer to the #GtkTree. @obj will accept any pointer, but if the pointer does not point to a #GtkTree, the results are undefined.
<!-- ##### MACRO GTK_TREE_ROOT_TREE ##### -->
<para>
A macro that returns the root tree of @obj.
</para>
<para>
If @obj is already a root tree, @obj is cast to #GtkTree and returned.
</para>
@obj: A pointer to the #GtkTree. @obj will accept any pointer, but if the pointer does not point to a #GtkTree, the results are undefined.
<!-- ##### MACRO GTK_TREE_SELECTION_OLD ##### -->
<para>
</para>
@obj:
<!-- ##### ENUM GtkTreeViewMode ##### -->
<para>
</para>
@GTK_TREE_VIEW_LINE:
@GTK_TREE_VIEW_ITEM:
<!-- ##### FUNCTION gtk_tree_new ##### -->
<para>
Creates a new #GtkTree.
</para>
@Returns: A pointer to the newly allocated widget.
<!-- ##### FUNCTION gtk_tree_append ##### -->
<para>
Adds the #GtkTreeItem in @tree_item to the end of the items in @tree.
</para>
@tree: A pointer to a #GtkTree.
@tree_item: A pointer to the #GtkWidget that is to be appended to the tree.
<!-- ##### FUNCTION gtk_tree_prepend ##### -->
<para>
Adds the #GtkTreeItem in @tree_item to the start of the items in @tree.
</para>
@tree: A pointer to a #GtkTree.
@tree_item: A pointer to the #GtkWidget that is to be prepended to the tree.
<!-- ##### FUNCTION gtk_tree_insert ##### -->
<para>
Adds the #GtkTreeItem in @tree_item to the list of items in @tree at the position indicated by @position.
</para>
@tree: A pointer to a #GtkTree.
@tree_item: A pointer to the #GtkWidget that is to be added to the tree.
@position: A #gint that indicates the position in the tree, that the @tree_item is to be added at.
<!-- ##### FUNCTION gtk_tree_remove_items ##### -->
<para>
Removes a list of items from the #GtkTree in @tree.
</para>
<para>
If only one item is to be removed from the #GtkTree, gtk_container_remove() can be used instead.
</para>
<para>
Removing an item from a #GtkTree dereferences the item, and thus usually destroys the item and any subtrees it may contain. If the item is not to be destroyed, use g_object_ref() before removing it.
</para>
@tree: A pointer to a #GtkTree.
@items: A pointer to a #GList that contains the items to be removed.
<!-- ##### FUNCTION gtk_tree_clear_items ##### -->
<para>
Removes the items at positions between @start and @end from the #GtkTree @tree.
</para>
<para>
Removing an item from a #GtkTree dereferences the item, and thus usually destroys the item and any subtrees it may contain. If the item is not to be destroyed, use g_object_ref() before removing it.
</para>
@tree: A pointer to a #GtkTree.
@start: A #gint.
@end: A #gint.
<!-- ##### FUNCTION gtk_tree_select_item ##### -->
<para>
Emits the #select_item signal for the child at position @item, and thus selects it (unless it is unselected in a signal handler).
</para>
@tree: A pointer to a #GtkTree.
@item: A #gint.
<!-- ##### FUNCTION gtk_tree_unselect_item ##### -->
<para>
Emits the #unselect_item for the child at position @item, and thus unselects it.
</para>
@tree: A pointer to a #GtkTree.
@item: A #gint.
<!-- ##### FUNCTION gtk_tree_select_child ##### -->
<para>
Emits the #select_item signal for the child @tree_item, and thus selects it (unless it is unselected in a signal handler).
</para>
@tree: A pointer to a #GtkTree.
@tree_item: A pointer to the #GtkWidget that is to be selected.
<!-- ##### FUNCTION gtk_tree_unselect_child ##### -->
<para>
Emits the #unselect_item signal for the child @tree_item, and thus unselects it.
</para>
@tree: A pointer to a #GtkTree.
@tree_item: A pointer to the #GtkWidget that is to be selected.
<!-- ##### FUNCTION gtk_tree_child_position ##### -->
<para>
Returns the position of @child in the #GtkTree @tree.
</para>
<para>
If @child is not a child of @tree, then -1 is returned.
</para>
@tree: A pointer to a #GtkTree.
@child: A pointer to a #GtkWidget.
@Returns: A #gint.
<!-- ##### FUNCTION gtk_tree_set_selection_mode ##### -->
<para>
Sets the selection mode for the #GtkTree @tree.
</para>
<para>
@mode can be one of
</para>
<itemizedlist>
<listitem>
<para>
%GTK_SELECTION_SINGLE for when only one item can be selected at a time.
</para>
</listitem>
<listitem>
<para>
%GTK_SELECTION_BROWSE for when one item must be selected.
</para>
</listitem>
<listitem>
<para>
%GTK_SELECTION_MULTIPLE for when many items can be selected at once.
</para>
</listitem>
<listitem>
<para>
%GTK_SELECTION_EXTENDED Reserved for later use.
</para>
</listitem>
</itemizedlist>
<para>
The selection mode is only defined for a root tree, as the root tree "owns" the selection.
</para>
<para>
The default mode is %GTK_SELECTION_SINGLE.
</para>
@tree: A pointer to a #GtkTree.
@mode: A #GtkSelectionMode.
<!-- ##### FUNCTION gtk_tree_set_view_mode ##### -->
<para>
Sets the 'viewmode' for the #GtkTree in @tree. The 'viewmode' defines how the tree looks when an item is selected.
</para>
<para>
@mode can be one of:
</para>
<itemizedlist>
<listitem>
<para>
%GTK_TREE_VIEW_LINE : When an item is selected the entire #GtkTreeItem is highlighted.
</para>
</listitem>
<listitem>
<para>
%GTK_TREE_VIEW_ITEM : When an item is selected only the selected item's child widget is highlighted.
</para>
</listitem>
</itemizedlist>
<para>
The default mode is %GTK_TREE_VIEW_LINE.
</para>
@tree: A pointer to a #GtkTree.
@mode: A #GtkTreeViewMode.
<!-- ##### FUNCTION gtk_tree_set_view_lines ##### -->
<para>
Sets whether or not the connecting lines between branches and children are drawn.
</para>
@tree: A pointer to a #GtkTree.
@flag: A #guint, indicating %TRUE, or %FALSE.
<!-- ##### FUNCTION gtk_tree_remove_item ##### -->
<para>
Removes the item @child from the #GtkTree @tree.
</para>
@tree: A pointer to a #GtkTree.
@child: A pointer to the #GtkWidget that is to be removed from the tree.

119
docs/reference/gtk/tmpl/gtktreeitem.sgml
View File

@ -1,119 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkTreeItem
<!-- ##### SECTION Short_Description ##### -->
The widget used for items in a GtkTree
<!-- ##### SECTION Long_Description ##### -->
<para>
<warning>
<para>
#GtkTree is deprecated and unsupported. It is known to be
buggy. To use it, you must define the symbol %GTK_ENABLE_BROKEN
prior to including the GTK+ header files. Use #GtkTreeView instead.
</para>
</warning>
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### STRUCT GtkTreeItem ##### -->
<para>
</para>
<!-- ##### SIGNAL GtkTreeItem::collapse ##### -->
<para>
</para>
@treeitem: the object which received the signal.
<!-- ##### SIGNAL GtkTreeItem::expand ##### -->
<para>
</para>
@treeitem: the object which received the signal.
<!-- ##### MACRO GTK_TREE_ITEM_SUBTREE ##### -->
<para>
</para>
@obj:
<!-- ##### FUNCTION gtk_tree_item_new ##### -->
<para>
</para>
@Returns:
<!-- ##### FUNCTION gtk_tree_item_new_with_label ##### -->
<para>
</para>
@label:
@Returns:
<!-- ##### FUNCTION gtk_tree_item_set_subtree ##### -->
<para>
</para>
@tree_item:
@subtree:
<!-- ##### FUNCTION gtk_tree_item_remove_subtree ##### -->
<para>
</para>
@tree_item:
<!-- ##### FUNCTION gtk_tree_item_select ##### -->
<para>
</para>
@tree_item:
<!-- ##### FUNCTION gtk_tree_item_deselect ##### -->
<para>
</para>
@tree_item:
<!-- ##### FUNCTION gtk_tree_item_expand ##### -->
<para>
</para>
@tree_item:
<!-- ##### FUNCTION gtk_tree_item_collapse ##### -->
<para>
</para>
@tree_item:

9
docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
View File

@ -199,15 +199,6 @@ calling gtk_tree_view_column_set_cell_data_func()
@tree_column:
<!-- ##### FUNCTION gtk_tree_view_column_get_cell_renderers ##### -->
<para>
</para>
@tree_column:
@Returns:
<!-- ##### FUNCTION gtk_tree_view_column_add_attribute ##### -->
<para>

88
docs/reference/gtk/tmpl/gtkwindow.sgml
View File

@ -257,86 +257,6 @@ window (synonymous with gtk_window_add_accel_group().
@wmclass_class:
<!-- ##### FUNCTION gtk_window_set_policy ##### -->
<para>
Changes how a toplevel window deals with its size request and user resize
attempts. There are really only two reasonable ways to call this function:
<orderedlist>
<listitem>
<para>
<literal>gtk_window_set_policy (GTK_WINDOW (window), FALSE, TRUE, FALSE)</literal>
means that the window is user-resizable.
</para>
</listitem>
<listitem>
<para>
<literal>gtk_window_set_policy (GTK_WINDOW (window), FALSE, FALSE, TRUE)</literal>
means that the window's size is program-controlled, and should simply match
the current size request of the window's children.
</para>
</listitem>
</orderedlist>
The first policy is the default, that is, by default windows are designed to
be resized by users.
</para>
<para>
The basic ugly truth of this function is that it should be simply:
<literal>
void gtk_window_set_resizable (GtkWindow* window, gboolean setting);
</literal>
...which is why GTK+ 2.0 introduces gtk_window_set_resizable(), which you
should use instead of gtk_window_set_policy().
</para>
<para>
If set to %TRUE, the @allow_grow parameter allows the user to expand the window
beyond the size request of its child widgets. If @allow_grow is %TRUE, be sure to
check that your child widgets work properly as the window is resized.
</para>
<para>
A toplevel window will always change size to ensure its child widgets receive
their requested size. This means that if you add child widgets, the toplevel
window will expand to contain them. However, normally the toplevel will not
shrink to fit the size request of its children if it's too large; the
@auto_shrink parameter causes the window to shrink when child widgets have too
much space. @auto_shrink is normally used with the second of the two window
policies mentioned above. That is, set @auto_shrink to %TRUE if you want the
window to have a fixed, always-optimal size determined by your program.
</para>
<para>
Note that @auto_shrink doesn't do anything if @allow_shrink and @allow_grow are
both set to %FALSE.
</para>
<para>
Neither of the two suggested window policies set the @allow_shrink parameter to
%TRUE. If @allow_shrink is %TRUE, the user can shrink the window so that its
children do not receive their full size request; this is basically a bad thing,
because most widgets will look wrong if this happens. Furthermore GTK+ has a
tendency to re-expand the window if size is recalculated for any reason. The
upshot is that @allow_shrink should always be set to %FALSE.
</para>
<para>
Sometimes when you think you want to use @allow_shrink, the real problem is that
some specific child widget is requesting too much space, so the user can't
shrink the window sufficiently. Perhaps you are calling gtk_widget_set_size_request()
on a child widget, and forcing its size request to be too large. Instead of
setting the child's usize, consider using gtk_window_set_default_size() so that
the child gets a larger allocation than it requests.
</para>
@window: the window
@allow_shrink: whether the user can shrink the window below its size request
@allow_grow: whether the user can grow the window larger than its size request
@auto_shrink: whether the window automatically snaps back to its size request
if it's larger
@Deprecated: Use gtk_window_set_resizable() instead.
<!-- ##### FUNCTION gtk_window_set_resizable ##### -->
<para>
@ -373,14 +293,6 @@ the child gets a larger allocation than it requests.
@accel_group:
<!-- ##### MACRO gtk_window_position ##### -->
<para>
Deprecated alias for gtk_window_set_position().
</para>
@Deprecated: Use gtk_window_set_position() instead.
<!-- ##### FUNCTION gtk_window_activate_focus ##### -->
<para>

11
docs/styles.txt
View File

@ -19,21 +19,10 @@ gtk_widget_set_style ()
This will override a previously set user style or
previously set rc styles.
gtk_widget_set_rc_style ()
Set GTK_RC_STYLE to indicate that an rc lookup has been performed.
If there is an rc style for a widget, set it and save the default style,
restore the default style otherwise.
This will override a previously set user style or rc style.
gtk_widget_reset_rc_styles ()
Descends through a widget hierarchy and sets the rc style
on all widgets that don't have a user style set.
gtk_widget_restore_default_style ()
Reset the widget's style to the default style, this is only useful if
the widgets default style had been saved by previous calls to
gtk_widget_set_style() or gtk_widget_set_rc_style().
gtk_widget_ensure_style ()
Ensure that the widget either has a user style set, or an rc lookup
has been performed.

5
docs/tools/shooter.c
View File

@ -205,7 +205,10 @@ int main (int argc, char **argv)
window = info->window->window;
gtk_widget_show_now (info->window);
gtk_widget_draw (info->window, &(info->window->allocation));
gtk_widget_queue_draw_area (info->window,
info->window->allocation.x, info->window->allocation.y,
info->window->allocation.width, info->window->allocation.height);
gdk_window_process_updates (info->window->window, TRUE);
while (gtk_events_pending ())
{

34
docs/tutorial/gtk-tut.sgml
View File

@ -2001,8 +2001,7 @@ GObject
| | | | `GtkVButtonBox
| | | +GtkVBox
| | | | +GtkColorSelection
| | | | +GtkFontSelection
| | | | `GtkGammaCurve
| | | | `GtkFontSelection
| | | `GtkHBox
| | | +GtkCombo
| | | `GtkStatusbar
@ -2022,7 +2021,6 @@ GObject
| | `GtkTreeView
| +GtkCalendar
| +GtkDrawingArea
| | `GtkCurve
| +GtkEditable
| | +GtkEntry
| | `GtkSpinButton
@ -5744,7 +5742,7 @@ static void calendar_select_font( GtkWidget *button,
calendar-&gt;font_dialog);
}
window = calendar-&gt;font_dialog;
if (!GTK_WIDGET_VISIBLE (window))
if (!gtk_widget_get_visible (window))
gtk_widget_show (window);
else
gtk_widget_destroy (window);
@ -6134,7 +6132,7 @@ gint main( gint argc,
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_window_set_title (GTK_WINDOW (window), "Color selection test");
gtk_window_set_policy (GTK_WINDOW (window), TRUE, TRUE, TRUE);
gtk_window_set_resizable ((GTK_WINDOW (window), TRUE);
/* Attach to the "delete" and "destroy" events so we can exit */
@ -6473,15 +6471,15 @@ the position specified by <literal>x</literal> and <literal>y</literal>.</para>
position.</para>
<programlisting role="C">
void gtk_fixed_set_has_window( GtkFixed *fixed,
void gtk_widget_set_has_window( GtkWidget *widget,
gboolean has_window );
gboolean gtk_fixed_get_has_window( GtkFixed *fixed );
gboolean gtk_widget_get_has_window( GtkWidget *widget );
</programlisting>
<para>Normally, Fixed widgets don't have their own X window. Since this is
different from the behaviour of Fixed widgets in earlier releases of GTK,
the function gtk_fixed_set_has_window() allows the creation of Fixed widgets
the function gtk_widget_set_has_window() allows the creation of Fixed widgets
<emphasis>with</emphasis> their own window. It has to be called before
realizing the widget.</para>
@ -7328,7 +7326,6 @@ static GtkWidget *create_bbox( gint horizontal,
/* Set the appearance of the Button Box */
gtk_button_box_set_layout (GTK_BUTTON_BOX (bbox), layout);
gtk_box_set_spacing (GTK_BOX (bbox), spacing);
/*gtk_button_box_set_child_size (GTK_BUTTON_BOX (bbox), child_w, child_h);*/
button = gtk_button_new_from_stock (GTK_STOCK_OK);
gtk_container_add (GTK_CONTAINER (bbox), button);
@ -9375,7 +9372,7 @@ What if you have a function which you want to be called when nothing
else is happening ?</para>
<programlisting role="C">
gint gtk_idle_add( GtkFunction function,
guint g_idle_add( GSourceFunc function,
gpointer data );
</programlisting>
@ -9383,12 +9380,12 @@ gint gtk_idle_add( GtkFunction function,
is happening.</para>
<programlisting role="C">
void gtk_idle_remove( gint tag );
void g_source_remove( guint tag );
</programlisting>
<para>I won't explain the meaning of the arguments as they follow very much
like the ones above. The function pointed to by the first argument to
gtk_idle_add will be called whenever the opportunity arises. As with
g_idle_add will be called whenever the opportunity arises. As with
the others, returning FALSE will stop the idle function from being
called.</para>
@ -9945,7 +9942,7 @@ protocols.</para>
<para>An application capable of GTK+ drag-and-drop first defines and sets up
the GTK+ widget(s) for drag-and-drop. Each widget can be a source
and/or destination for drag-and-drop. Note that these GTK+ widgets must have
an associated X Window, check using GTK_WIDGET_NO_WINDOW(widget)).</para>
an associated X Window, check using gtk_widget_get_has_window (widget).</para>
<para>Source widgets can send out drag data, thus allowing the user to drag
things off of them, while destination widgets can receive drag data.
@ -13965,17 +13962,6 @@ void GtkStatusbar::text-popped (GtkStatusbar *,
</sect1>
<!-- ----------------------------------------------------------------- -->
<sect1 id="sec-GtkCurve">
<title>GtkCurve</title>
<programlisting role="C">
void GtkCurve::curve-type-changed (GtkCurve *,
gpointer);
</programlisting>
</sect1>
<!-- ----------------------------------------------------------------- -->
<sect1 id="sec-GtkAdjustment">
<title>GtkAdjustment</title>

1
examples/buttonbox/buttonbox.c
View File

@ -26,7 +26,6 @@ static GtkWidget *create_bbox( gint horizontal,
/* Set the appearance of the Button Box */
gtk_button_box_set_layout (GTK_BUTTON_BOX (bbox), layout);
gtk_box_set_spacing (GTK_BOX (bbox), spacing);
/*gtk_button_box_set_child_size (GTK_BUTTON_BOX (bbox), child_w, child_h);*/
button = gtk_button_new_from_stock (GTK_STOCK_OK);
gtk_container_add (GTK_CONTAINER (bbox), button);

2
examples/colorsel/colorsel.c
View File

@ -90,7 +90,7 @@ gint main( gint argc,
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_window_set_title (GTK_WINDOW (window), "Color selection test");
gtk_window_set_policy (GTK_WINDOW (window), TRUE, TRUE, TRUE);
gtk_window_set_resizable (GTK_WINDOW (window), TRUE);
/* Attach to the "delete" and "destroy" events so we can exit */

8
examples/list/list.c
View File

@ -117,7 +117,7 @@ gint main( int argc,
*/
for (i = 0; i < 5; i++) {
GtkWidget *label;
gchar *string;
const gchar *string;
sprintf(buffer, "ListItemContainer with Label #%d", i);
label=gtk_label_new (buffer);
@ -126,7 +126,7 @@ gint main( int argc,
gtk_widget_show (label);
gtk_container_add (GTK_CONTAINER (gtklist), list_item);
gtk_widget_show (list_item);
gtk_label_get (GTK_LABEL (label), &string);
string = gtk_label_get_text (GTK_LABEL (label));
g_object_set_data (G_OBJECT (list_item), list_item_data_key, string);
}
/* Here, we are creating another 5 labels, this time
@ -193,9 +193,9 @@ void sigh_button_event( GtkWidget *gtklist,
/* Look for already imprisoned list items, we
* will put them back into the list.
* Remember to free the doubly linked list that
* gtk_container_children() returns
* gtk_container_get_children() returns
*/
dlist = gtk_container_children (GTK_CONTAINER (frame));
dlist = gtk_container_get_children (GTK_CONTAINER (frame));
free_list = dlist;
while (dlist) {
GtkWidget *list_item;

16
examples/text/Makefile
View File

@ -1,16 +0,0 @@
CC = gcc
#CFLAGS = -Wall \
# -DG_DISABLE_DEPRECATED \
# -DGDK_DISABLE_DEPRECATED \
# -DGDK_PIXBUF_DISABLE_DEPRECATED \
# -DGTK_DISABLE_DEPRECATED
CFLAGS =
text: text.c
$(CC) text.c -o text $(CFLAGS) `pkg-config gtk+-2.0 --cflags --libs`
clean:
rm -f *.o text

182
examples/text/text.c
View File

@ -1,182 +0,0 @@
#define GTK_ENABLE_BROKEN
#include "config.h"
#include <stdio.h>
#include <gtk/gtk.h>
void text_toggle_editable (GtkWidget *checkbutton,
GtkWidget *text)
{
gtk_text_set_editable (GTK_TEXT (text),
GTK_TOGGLE_BUTTON (checkbutton)->active);
}
void text_toggle_word_wrap (GtkWidget *checkbutton,
GtkWidget *text)
{
gtk_text_set_word_wrap (GTK_TEXT (text),
GTK_TOGGLE_BUTTON (checkbutton)->active);
}
void close_application( GtkWidget *widget,
gpointer data )
{
gtk_main_quit ();
}
int main( int argc,
char *argv[] )
{
GtkWidget *window;
GtkWidget *box1;
GtkWidget *box2;
GtkWidget *hbox;
GtkWidget *button;
GtkWidget *check;
GtkWidget *separator;
GtkWidget *table;
GtkWidget *vscrollbar;
GtkWidget *text;
GdkColormap *cmap;
GdkColor color;
GdkFont *fixed_font;
FILE *infile;
gtk_init (&argc, &argv);
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_widget_set_size_request (window, 600, 500);
gtk_window_set_policy (GTK_WINDOW (window), TRUE, TRUE, FALSE);
g_signal_connect (G_OBJECT (window), "destroy",
G_CALLBACK (close_application),
NULL);
gtk_window_set_title (GTK_WINDOW (window), "Text Widget Example");
gtk_container_set_border_width (GTK_CONTAINER (window), 0);
box1 = gtk_vbox_new (FALSE, 0);
gtk_container_add (GTK_CONTAINER (window), box1);
gtk_widget_show (box1);
box2 = gtk_vbox_new (FALSE, 10);
gtk_container_set_border_width (GTK_CONTAINER (box2), 10);
gtk_box_pack_start (GTK_BOX (box1), box2, TRUE, TRUE, 0);
gtk_widget_show (box2);
table = gtk_table_new (2, 2, FALSE);
gtk_table_set_row_spacing (GTK_TABLE (table), 0, 2);
gtk_table_set_col_spacing (GTK_TABLE (table), 0, 2);
gtk_box_pack_start (GTK_BOX (box2), table, TRUE, TRUE, 0);
gtk_widget_show (table);
/* Create the GtkText widget */
text = gtk_text_new (NULL, NULL);
gtk_text_set_editable (GTK_TEXT (text), TRUE);
gtk_table_attach (GTK_TABLE (table), text, 0, 1, 0, 1,
GTK_EXPAND | GTK_SHRINK | GTK_FILL,
GTK_EXPAND | GTK_SHRINK | GTK_FILL, 0, 0);
gtk_widget_show (text);
/* Add a vertical scrollbar to the GtkText widget */
vscrollbar = gtk_vscrollbar_new (GTK_TEXT (text)->vadj);
gtk_table_attach (GTK_TABLE (table), vscrollbar, 1, 2, 0, 1,
GTK_FILL, GTK_EXPAND | GTK_SHRINK | GTK_FILL, 0, 0);
gtk_widget_show (vscrollbar);
/* Get the system color map and allocate the color red */
cmap = gdk_colormap_get_system ();
color.red = 0xffff;
color.green = 0;
color.blue = 0;
if (!gdk_color_alloc (cmap, &color)) {
g_error ("couldn't allocate color");
}
/* Load a fixed font */
fixed_font = gdk_font_load ("-misc-fixed-medium-r-*-*-*-140-*-*-*-*-*-*");
/* Realizing a widget creates a window for it,
* ready for us to insert some text */
gtk_widget_realize (text);
/* Freeze the text widget, ready for multiple updates */
gtk_text_freeze (GTK_TEXT (text));
/* Insert some colored text */
gtk_text_insert (GTK_TEXT (text), NULL, &text->style->black, NULL,
"Supports ", -1);
gtk_text_insert (GTK_TEXT (text), NULL, &color, NULL,
"colored ", -1);
gtk_text_insert (GTK_TEXT (text), NULL, &text->style->black, NULL,
"text and different ", -1);
gtk_text_insert (GTK_TEXT (text), fixed_font, &text->style->black, NULL,
"fonts\n\n", -1);
/* Load the file text.c into the text window */
infile = fopen ("text.c", "r");
if (infile) {
char buffer[1024];
int nchars;
while (1)
{
nchars = fread (buffer, 1, 1024, infile);
gtk_text_insert (GTK_TEXT (text), fixed_font, NULL,
NULL, buffer, nchars);
if (nchars < 1024)
break;
}
fclose (infile);
}
/* Thaw the text widget, allowing the updates to become visible */
gtk_text_thaw (GTK_TEXT (text));
hbox = gtk_hbutton_box_new ();
gtk_box_pack_start (GTK_BOX (box2), hbox, FALSE, FALSE, 0);
gtk_widget_show (hbox);
check = gtk_check_button_new_with_label ("Editable");
gtk_box_pack_start (GTK_BOX (hbox), check, FALSE, FALSE, 0);
g_signal_connect (G_OBJECT (check), "toggled",
G_CALLBACK (text_toggle_editable), text);
gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (check), TRUE);
gtk_widget_show (check);
check = gtk_check_button_new_with_label ("Wrap Words");
gtk_box_pack_start (GTK_BOX (hbox), check, FALSE, TRUE, 0);
g_signal_connect (G_OBJECT (check), "toggled",
G_CALLBACK (text_toggle_word_wrap), text);
gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (check), FALSE);
gtk_widget_show (check);
separator = gtk_hseparator_new ();
gtk_box_pack_start (GTK_BOX (box1), separator, FALSE, TRUE, 0);
gtk_widget_show (separator);
box2 = gtk_vbox_new (FALSE, 10);
gtk_container_set_border_width (GTK_CONTAINER (box2), 10);
gtk_box_pack_start (GTK_BOX (box1), box2, FALSE, TRUE, 0);
gtk_widget_show (box2);
button = gtk_button_new_with_label ("close");
g_signal_connect (G_OBJECT (button), "clicked",
G_CALLBACK (close_application),
NULL);
gtk_box_pack_start (GTK_BOX (box2), button, TRUE, TRUE, 0);
gtk_widget_set_can_default (button, TRUE);
gtk_widget_grab_default (button);
gtk_widget_show (button);
gtk_widget_show (window);
gtk_main ();
return 0;
}

16
examples/tree/Makefile
View File

@ -1,16 +0,0 @@
CC = gcc
#CFLAGS = -Wall \
# -DG_DISABLE_DEPRECATED \
# -DGDK_DISABLE_DEPRECATED \
# -DGDK_PIXBUF_DISABLE_DEPRECATED \
# -DGTK_DISABLE_DEPRECATED
CFLAGS =
tree: tree.c
$(CC) tree.c -o tree $(CFLAGS) `pkg-config gtk+-2.0 --cflags --libs`
clean:
rm -f *.o tree

184
examples/tree/tree.c
View File

@ -1,184 +0,0 @@
#define GTK_ENABLE_BROKEN
#include "config.h"
#include <gtk/gtk.h>
/* for all the GtkItem:: and GtkTreeItem:: signals */
static void cb_itemsignal( GtkWidget *item,
gchar *signame )
{
gchar *name;
GtkLabel *label;
/* It's a Bin, so it has one child, which we know to be a
label, so get that */
label = GTK_LABEL (GTK_BIN (item)->child);
/* Get the text of the label */
gtk_label_get (label, &name);
/* Get the level of the tree which the item is in */
g_print ("%s called for item %s->%p, level %d\n", signame, name,
item, GTK_TREE (item->parent)->level);
}
/* Note that this is never called */
static void cb_unselect_child( GtkWidget *root_tree,
GtkWidget *child,
GtkWidget *subtree )
{
g_print ("unselect_child called for root tree %p, subtree %p, child %p\n",
root_tree, subtree, child);
}
/* Note that this is called every time the user clicks on an item,
whether it is already selected or not. */
static void cb_select_child (GtkWidget *root_tree, GtkWidget *child,
GtkWidget *subtree)
{
g_print ("select_child called for root tree %p, subtree %p, child %p\n",
root_tree, subtree, child);
}
static void cb_selection_changed( GtkWidget *tree )
{
GList *i;
g_print ("selection_change called for tree %p\n", tree);
g_print ("selected objects are:\n");
i = GTK_TREE_SELECTION_OLD (tree);
while (i) {
gchar *name;
GtkLabel *label;
GtkWidget *item;
/* Get a GtkWidget pointer from the list node */
item = GTK_WIDGET (i->data);
label = GTK_LABEL (GTK_BIN (item)->child);
gtk_label_get (label, &name);
g_print ("\t%s on level %d\n", name, GTK_TREE
(item->parent)->level);
i = i->next;
}
}
int main( int argc,
char *argv[] )
{
GtkWidget *window, *scrolled_win, *tree;
static gchar *itemnames[] = {"Foo", "Bar", "Baz", "Quux",
"Maurice"};
gint i;
gtk_init (&argc, &argv);
/* a generic toplevel window */
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
g_signal_connect (G_OBJECT (window), "delete_event",
G_CALLBACK (gtk_main_quit), NULL);
gtk_container_set_border_width (GTK_CONTAINER (window), 5);
/* A generic scrolled window */
scrolled_win = gtk_scrolled_window_new (NULL, NULL);
gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolled_win),
GTK_POLICY_AUTOMATIC,
GTK_POLICY_AUTOMATIC);
gtk_widget_set_size_request (scrolled_win, 150, 200);
gtk_container_add (GTK_CONTAINER (window), scrolled_win);
gtk_widget_show (scrolled_win);
/* Create the root tree */
tree = gtk_tree_new ();
g_print ("root tree is %p\n", tree);
/* connect all GtkTree:: signals */
g_signal_connect (G_OBJECT (tree), "select_child",
G_CALLBACK (cb_select_child), tree);
g_signal_connect (G_OBJECT (tree), "unselect_child",
G_CALLBACK (cb_unselect_child), tree);
g_signal_connect (G_OBJECT(tree), "selection_changed",
G_CALLBACK(cb_selection_changed), tree);
/* Add it to the scrolled window */
gtk_scrolled_window_add_with_viewport (GTK_SCROLLED_WINDOW (scrolled_win),
tree);
/* Set the selection mode */
gtk_tree_set_selection_mode (GTK_TREE (tree),
GTK_SELECTION_MULTIPLE);
/* Show it */
gtk_widget_show (tree);
for (i = 0; i < 5; i++){
GtkWidget *subtree, *item;
gint j;
/* Create a tree item */
item = gtk_tree_item_new_with_label (itemnames[i]);
/* Connect all GtkItem:: and GtkTreeItem:: signals */
g_signal_connect (G_OBJECT (item), "select",
G_CALLBACK (cb_itemsignal), "select");
g_signal_connect (G_OBJECT (item), "deselect",
G_CALLBACK (cb_itemsignal), "deselect");
g_signal_connect (G_OBJECT (item), "toggle",
G_CALLBACK (cb_itemsignal), "toggle");
g_signal_connect (G_OBJECT (item), "expand",
G_CALLBACK (cb_itemsignal), "expand");
g_signal_connect (G_OBJECT (item), "collapse",
G_CALLBACK (cb_itemsignal), "collapse");
/* Add it to the parent tree */
gtk_tree_append (GTK_TREE (tree), item);
/* Show it - this can be done at any time */
gtk_widget_show (item);
/* Create this item's subtree */
subtree = gtk_tree_new ();
g_print ("-> item %s->%p, subtree %p\n", itemnames[i], item,
subtree);
/* This is still necessary if you want these signals to be called
for the subtree's children. Note that selection_change will be
signalled for the root tree regardless. */
g_signal_connect (G_OBJECT (subtree), "select_child",
G_CALLBACK (cb_select_child), subtree);
g_signal_connect (G_OBJECT (subtree), "unselect_child",
G_CALLBACK (cb_unselect_child), subtree);
/* This has absolutely no effect, because it is completely ignored
in subtrees */
gtk_tree_set_selection_mode (GTK_TREE (subtree),
GTK_SELECTION_SINGLE);
/* Neither does this, but for a rather different reason - the
view_mode and view_line values of a tree are propagated to
subtrees when they are mapped. So, setting it later on would
actually have a (somewhat unpredictable) effect */
gtk_tree_set_view_mode (GTK_TREE (subtree), GTK_TREE_VIEW_ITEM);
/* Set this item's subtree - note that you cannot do this until
AFTER the item has been added to its parent tree! */
gtk_tree_item_set_subtree (GTK_TREE_ITEM (item), subtree);
for (j = 0; j < 5; j++){
GtkWidget *subitem;
/* Create a subtree item, in much the same way */
subitem = gtk_tree_item_new_with_label (itemnames[j]);
/* Connect all GtkItem:: and GtkTreeItem:: signals */
g_signal_connect (G_OBJECT (subitem), "select",
G_CALLBACK (cb_itemsignal), "select");
g_signal_connect (G_OBJECT (subitem), "deselect",
G_CALLBACK (cb_itemsignal), "deselect");
g_signal_connect (G_OBJECT (subitem), "toggle",
G_CALLBACK (cb_itemsignal), "toggle");
g_signal_connect (G_OBJECT (subitem), "expand",
G_CALLBACK (cb_itemsignal), "expand");
g_signal_connect (G_OBJECT (subitem), "collapse",
G_CALLBACK (cb_itemsignal), "collapse");
g_print ("-> -> item %s->%p\n", itemnames[j], subitem);
/* Add it to its parent tree */
gtk_tree_append (GTK_TREE (subtree), subitem);
/* Show it */
gtk_widget_show (subitem);
}
}
/* Show the window and loop endlessly */
gtk_widget_show (window);
gtk_main();
return 0;
}

30
gdk-pixbuf/gdk-pixbuf-animation.c
View File

@ -257,36 +257,6 @@ gdk_pixbuf_animation_new_from_file (const char *filename,
#endif
/**
* gdk_pixbuf_animation_ref:
* @animation: An animation.
*
* Adds a reference to an animation.
*
* Return value: The same as the @animation argument.
*
* Deprecated: 2.0: Use g_object_ref().
**/
GdkPixbufAnimation *
gdk_pixbuf_animation_ref (GdkPixbufAnimation *animation)
{
return (GdkPixbufAnimation*) g_object_ref (animation);
}
/**
* gdk_pixbuf_animation_unref:
* @animation: An animation.
*
* Removes a reference from an animation.
*
* Deprecated: 2.0: Use g_object_unref().
**/
void
gdk_pixbuf_animation_unref (GdkPixbufAnimation *animation)
{
g_object_unref (animation);
}
/**
* gdk_pixbuf_animation_is_static_image:
* @animation: a #GdkPixbufAnimation

7
gdk-pixbuf/gdk-pixbuf-animation.h
View File

@ -24,7 +24,7 @@
* Boston, MA 02111-1307, USA.
*/
#if defined(GDK_PIXBUF_DISABLE_SINGLE_INCLUDES) && !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#if !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#error "Only <gdk-pixbuf/gdk-pixbuf.h> can be included directly."
#endif
@ -58,11 +58,6 @@ GType gdk_pixbuf_animation_get_type (void) G_GNUC_CONST;
GdkPixbufAnimation *gdk_pixbuf_animation_new_from_file (const char *filename,
GError **error);
#ifndef GDK_PIXBUF_DISABLE_DEPRECATED
GdkPixbufAnimation *gdk_pixbuf_animation_ref (GdkPixbufAnimation *animation);
void gdk_pixbuf_animation_unref (GdkPixbufAnimation *animation);
#endif
int gdk_pixbuf_animation_get_width (GdkPixbufAnimation *animation);
int gdk_pixbuf_animation_get_height (GdkPixbufAnimation *animation);
gboolean gdk_pixbuf_animation_is_static_image (GdkPixbufAnimation *animation);

9
gdk-pixbuf/gdk-pixbuf-core.h
View File

@ -23,7 +23,7 @@
* Boston, MA 02111-1307, USA.
*/
#if defined(GDK_PIXBUF_DISABLE_SINGLE_INCLUDES) && !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#if !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#error "Only <gdk-pixbuf/gdk-pixbuf.h> can be included directly."
#endif
@ -84,13 +84,6 @@ GQuark gdk_pixbuf_error_quark (void);
GType gdk_pixbuf_get_type (void) G_GNUC_CONST;
/* Reference counting */
#ifndef GDK_PIXBUF_DISABLE_DEPRECATED
GdkPixbuf *gdk_pixbuf_ref (GdkPixbuf *pixbuf);
void gdk_pixbuf_unref (GdkPixbuf *pixbuf);
#endif
/* GdkPixbuf accessors */
GdkColorspace gdk_pixbuf_get_colorspace (const GdkPixbuf *pixbuf);

2
gdk-pixbuf/gdk-pixbuf-io.h
View File

@ -26,7 +26,7 @@
* Boston, MA 02111-1307, USA.
*/
#if defined(GDK_PIXBUF_DISABLE_SINGLE_INCLUDES) && !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#if !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#error "Only <gdk-pixbuf/gdk-pixbuf.h> can be included directly."
#endif

2
gdk-pixbuf/gdk-pixbuf-loader.h
View File

@ -23,7 +23,7 @@
* Boston, MA 02111-1307, USA.
*/
#if defined(GDK_PIXBUF_DISABLE_SINGLE_INCLUDES) && !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#if !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#error "Only <gdk-pixbuf/gdk-pixbuf.h> can be included directly."
#endif

2
gdk-pixbuf/gdk-pixbuf-simple-anim.h
View File

@ -21,7 +21,7 @@
* Boston, MA 02111-1307, USA.
*/
#if defined(GDK_PIXBUF_DISABLE_SINGLE_INCLUDES) && !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#if !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#error "Only <gdk-pixbuf/gdk-pixbuf.h> can be included directly."
#endif

2
gdk-pixbuf/gdk-pixbuf-transform.h
View File

@ -23,7 +23,7 @@
* Boston, MA 02111-1307, USA.
*/
#if defined(GDK_PIXBUF_DISABLE_SINGLE_INCLUDES) && !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#if !defined (GDK_PIXBUF_H_INSIDE) && !defined (GDK_PIXBUF_COMPILATION)
#error "Only <gdk-pixbuf/gdk-pixbuf.h> can be included directly."
#endif

33
gdk-pixbuf/gdk-pixbuf.c
View File

@ -181,39 +181,6 @@ gdk_pixbuf_finalize (GObject *object)
G_OBJECT_CLASS (gdk_pixbuf_parent_class)->finalize (object);
}
/**
* gdk_pixbuf_ref:
* @pixbuf: A pixbuf.
*
* Adds a reference to a pixbuf.
*
* Return value: The same as the @pixbuf argument.
*
* Deprecated: 2.0: Use g_object_ref().
**/
GdkPixbuf *
gdk_pixbuf_ref (GdkPixbuf *pixbuf)
{
return (GdkPixbuf *) g_object_ref (pixbuf);
}
/**
* gdk_pixbuf_unref:
* @pixbuf: A pixbuf.
*
* Removes a reference from a pixbuf.
*
* Deprecated: 2.0: Use g_object_unref().
**/
void
gdk_pixbuf_unref (GdkPixbuf *pixbuf)
{
g_object_unref (pixbuf);
}
/* Used as the destroy notification function for gdk_pixbuf_new() */
static void

8
gdk-pixbuf/gdk-pixbuf.symbols
View File

@ -15,10 +15,6 @@
#if IN_FILE(__GDK_PIXBUF_C__)
gdk_pixbuf_error_quark
gdk_pixbuf_get_type G_GNUC_CONST
#ifndef GDK_PIXBUF_DISABLE_DEPRECATED
gdk_pixbuf_ref
gdk_pixbuf_unref
#endif
gdk_pixbuf_new
gdk_pixbuf_get_bits_per_sample
gdk_pixbuf_get_colorspace
@ -118,10 +114,6 @@ gdk_pixbuf_animation_new_from_file PRIVATE
#ifdef G_OS_WIN32
gdk_pixbuf_animation_new_from_file_utf8
#endif
#ifndef GDK_PIXBUF_DISABLE_DEPRECATED
gdk_pixbuf_animation_ref
gdk_pixbuf_animation_unref
#endif
gdk_pixbuf_non_anim_new
gdk_pixbuf_non_anim_get_type G_GNUC_CONST
#endif

2
gdk-pixbuf/make-inline-pixbuf.c
View File

@ -219,7 +219,7 @@ main (int argc, char **argv)
output_pixbuf (outfile, ext_symbols, argv[i], pixbuf);
gdk_pixbuf_unref (pixbuf);
g_object_unref (pixbuf);
i += 2;
}

1
gdk/Makefile.am
View File

@ -84,7 +84,6 @@ gdk_public_h_sources = \
gdkevents.h \
gdkfont.h \
gdkgc.h \
gdki18n.h \
gdkimage.h \
gdkinput.h \
gdkkeys.h \

9
gdk/directfb/gdkdirectfb.h
View File

@ -68,15 +68,6 @@ extern gboolean gdk_directfb_monochrome_fonts;
void gdk_directfb_window_set_opacity (GdkWindow *window,
guchar opacity);
#ifndef GDK_DISABLE_DEPRECATED
GdkWindow * gdk_directfb_window_new (GdkWindow *parent,
GdkWindowAttr *attributes,
gint attributes_mask,
DFBWindowCapabilities window_caps,
DFBWindowOptions window_options,
DFBSurfaceCapabilities surface_caps);
#endif /* GDK_DISABLE_DEPRECATED */
GdkVisual * gdk_directfb_visual_by_format (DFBSurfacePixelFormat pixel_format);
IDirectFBWindow *gdk_directfb_window_lookup(GdkWindow *window);

12
gdk/directfb/gdkdnd-directfb.c
View File

@ -121,18 +121,6 @@ gdk_drag_context_new (void)
return g_object_new (gdk_drag_context_get_type (), NULL);
}
void
gdk_drag_context_ref (GdkDragContext *context)
{
g_object_ref (context);
}
void
gdk_drag_context_unref (GdkDragContext *context)
{
g_object_unref (context);
}
static GdkDragContext *
gdk_drag_context_find (gboolean is_source,
GdkWindow *source,

30
gdk/directfb/gdkevents-directfb.c
View File

@ -318,36 +318,6 @@ gdk_events_pending (void)
return _gdk_event_queue_find_first (display) ? TRUE : FALSE;
}
GdkEvent *
gdk_event_get_graphics_expose (GdkWindow *window)
{
GdkDisplay *display;
GList *list;
g_return_val_if_fail (GDK_IS_WINDOW (window), NULL);
display = gdk_drawable_get_display (GDK_DRAWABLE (window));
for (list = _gdk_event_queue_find_first (display); list; list = list->next)
{
GdkEvent *event = list->data;
if (event->type == GDK_EXPOSE && event->expose.window == window)
break;
}
if (list)
{
GdkEvent *retval = list->data;
_gdk_event_queue_remove_link (display, list);
g_list_free_1 (list);
return retval;
}
return NULL;
}
void
_gdk_events_queue (GdkDisplay *display)
{

36
gdk/directfb/gdkimage-directfb.c
View File

@ -131,40 +131,6 @@ _gdk_image_exit (void)
}
}
GdkImage *
gdk_image_new_bitmap (GdkVisual *visual,
gpointer data,
gint w,
gint h)
{
GdkImage *image;
GdkImageDirectFB *private;
image = g_object_new (gdk_image_get_type (), NULL);
private = image->windowing_data;
image->type = GDK_IMAGE_SHARED;
image->visual = visual;
image->width = w;
image->height = h;
image->depth = 1;
GDK_NOTE (MISC, g_print ("gdk_image_new_bitmap: %dx%d\n", w, h));
g_message ("not fully implemented %s", G_STRFUNC);
image->bpl = (w + 7) / 8;
image->mem = g_malloc (image->bpl * h);
#if G_BYTE_ORDER == G_BIG_ENDIAN
image->byte_order = GDK_MSB_FIRST;
#else
image->byte_order = GDK_LSB_FIRST;
#endif
image->bpp = 1;
return image;
}
void
_gdk_windowing_image_init (void)
{
@ -229,7 +195,7 @@ _gdk_image_new_for_depth (GdkScreen *screen,
if (ret)
{
DirectFBError( "IDirectFBSurface::Lock() for writing failed!\n", ret );
gdk_image_unref( image );
g_object_unref( image );
return NULL;
}

208
gdk/directfb/gdkwindow-directfb.c
View File

@ -356,214 +356,6 @@ _gdk_windowing_window_init (void)
gdk_drawable_set_colormap (GDK_DRAWABLE (_gdk_parent_root),gdk_colormap_get_system());
}
GdkWindow *
gdk_directfb_window_new (GdkWindow *parent,
GdkWindowAttr *attributes,
gint attributes_mask,
DFBWindowCapabilities window_caps,
DFBWindowOptions window_options,
DFBSurfaceCapabilities surface_caps)
{
GdkWindow *window;
GdkWindowObject *private;
GdkWindowObject *parent_private;
GdkWindowImplDirectFB *impl;
GdkWindowImplDirectFB *parent_impl;
GdkVisual *visual;
DFBWindowDescription desc;
gint x, y;
g_return_val_if_fail (attributes != NULL, NULL);
D_DEBUG_AT( GDKDFB_Window, "%s( %p )\n", G_STRFUNC, parent );
if (!parent || attributes->window_type != GDK_WINDOW_CHILD)
parent = _gdk_parent_root;
window = g_object_new (GDK_TYPE_WINDOW, NULL);
private = GDK_WINDOW_OBJECT (window);
private->impl = g_object_new (_gdk_window_impl_get_type (), NULL);
parent_private = GDK_WINDOW_OBJECT (parent);
parent_impl = GDK_WINDOW_IMPL_DIRECTFB (parent_private->impl);
private->parent = parent_private;
x = (attributes_mask & GDK_WA_X) ? attributes->x : 0;
y = (attributes_mask & GDK_WA_Y) ? attributes->y : 0;
gdk_window_set_events (window, attributes->event_mask | GDK_STRUCTURE_MASK);
impl = GDK_WINDOW_IMPL_DIRECTFB (private->impl);
impl->drawable.wrapper = GDK_DRAWABLE (window);
impl->gdkWindow = window;
private->x = x;
private->y = y;
_gdk_directfb_calc_abs (window);
impl->drawable.width = MAX (1, attributes->width);
impl->drawable.height = MAX (1, attributes->height);
private->window_type = attributes->window_type;
desc.flags = 0;
if (attributes_mask & GDK_WA_VISUAL)
visual = attributes->visual;
else
visual = gdk_drawable_get_visual (parent);
switch (attributes->wclass)
{
case GDK_INPUT_OUTPUT:
private->input_only = FALSE;
desc.flags |= DWDESC_PIXELFORMAT;
desc.pixelformat = ((GdkVisualDirectFB *) visual)->format;
if (DFB_PIXELFORMAT_HAS_ALPHA (desc.pixelformat))
{
desc.flags |= DWDESC_CAPS;
desc.caps = DWCAPS_ALPHACHANNEL;
}
break;
case GDK_INPUT_ONLY:
private->input_only = TRUE;
desc.flags |= DWDESC_CAPS;
desc.caps = DWCAPS_INPUTONLY;
break;
default:
g_warning ("gdk_window_new: unsupported window class\n");
_gdk_window_destroy (window, FALSE);
return NULL;
}
switch (private->window_type)
{
case GDK_WINDOW_TOPLEVEL:
case GDK_WINDOW_DIALOG:
case GDK_WINDOW_TEMP:
desc.flags |= ( DWDESC_WIDTH | DWDESC_HEIGHT |
DWDESC_POSX | DWDESC_POSY );
desc.posx = x;
desc.posy = y;
desc.width = impl->drawable.width;
desc.height = impl->drawable.height;
#if 0
if (window_caps)
{
if (! (desc.flags & DWDESC_CAPS))
{
desc.flags |= DWDESC_CAPS;
desc.caps = DWCAPS_NONE;
}
desc.caps |= window_caps;
}
if (surface_caps)
{
desc.flags |= DWDESC_SURFACE_CAPS;
desc.surface_caps = surface_caps;
}
#endif
if (!create_directfb_window (impl, &desc, window_options))
{
g_assert(0);
_gdk_window_destroy (window, FALSE);
return NULL;
}
if (desc.caps != DWCAPS_INPUTONLY)
{
impl->window->SetOpacity(impl->window, 0x00 );
}
break;
case GDK_WINDOW_CHILD:
impl->window=NULL;
if (!private->input_only && parent_impl->drawable.surface)
{
DFBRectangle rect =
{ x, y, impl->drawable.width, impl->drawable.height };
parent_impl->drawable.surface->GetSubSurface (parent_impl->drawable.surface,
&rect,
&impl->drawable.surface);
}
break;
default:
g_warning ("gdk_window_new: unsupported window type: %d",
private->window_type);
_gdk_window_destroy (window, FALSE);
return NULL;
}
if (impl->drawable.surface)
{
GdkColormap *colormap;
impl->drawable.surface->GetPixelFormat (impl->drawable.surface,
&impl->drawable.format);
private->depth = DFB_BITS_PER_PIXEL(impl->drawable.format);
if ((attributes_mask & GDK_WA_COLORMAP) && attributes->colormap)
{
colormap = attributes->colormap;
}
else
{
if (gdk_visual_get_system () == visual)
colormap = gdk_colormap_get_system ();
else
colormap =gdk_drawable_get_colormap (parent);
}
gdk_drawable_set_colormap (GDK_DRAWABLE (window), colormap);
}
else
{
impl->drawable.format = ((GdkVisualDirectFB *)visual)->format;
private->depth = visual->depth;
}
gdk_window_set_cursor (window, ((attributes_mask & GDK_WA_CURSOR) ?
(attributes->cursor) : NULL));
if (parent_private)
parent_private->children = g_list_prepend (parent_private->children,
window);
/* we hold a reference count on ourselves */
g_object_ref (window);
if (impl->window)
{
impl->window->GetID (impl->window, &impl->dfb_id);
gdk_directfb_window_id_table_insert (impl->dfb_id, window);
gdk_directfb_event_windows_add (window);
}
if (attributes_mask & GDK_WA_TYPE_HINT)
gdk_window_set_type_hint (window, attributes->type_hint);
return window;
}
void
_gdk_window_impl_new (GdkWindow *window,
GdkWindow *real_parent,

33
gdk/gdk.symbols
View File

@ -22,9 +22,6 @@
#if IN_HEADER(__GDK_EVENTS_H__)
#if IN_FILE(__GDK_EVENTS_X11_C__)
gdk_add_client_message_filter
#ifndef GDK_DISABLE_DEPRECATED
gdk_event_get_graphics_expose
#endif
gdk_events_pending
#endif
#endif
@ -511,10 +508,6 @@ gdk_drag_abort
gdk_drag_begin
gdk_drag_context_get_type G_GNUC_CONST
gdk_drag_context_new
#ifndef GDK_DISABLE_DEPRECATED
gdk_drag_context_ref
gdk_drag_context_unref
#endif
gdk_drag_drop
gdk_drag_drop_succeeded
gdk_drag_find_window_for_screen
@ -588,11 +581,6 @@ gdk_draw_layout_with_colors
gdk_gc_new
gdk_gc_get_type G_GNUC_CONST
gdk_gc_new_with_values
#ifndef GDK_DISABLE_DEPRECATED
gdk_gc_ref
gdk_gc_unref
gdk_gc_set_font
#endif
gdk_gc_get_values
gdk_gc_set_values
gdk_gc_set_foreground
@ -806,11 +794,6 @@ gdk_window_configure_finished
#if IN_HEADER(__GDK_IMAGE_H__)
#if IN_FILE(__GDK_IMAGE_C__)
#ifndef GDK_DISABLE_DEPRECATED
gdk_image_ref
gdk_image_unref
gdk_image_get
#endif
gdk_image_set_colormap
gdk_image_get_colormap
gdk_image_new
@ -819,9 +802,6 @@ gdk_image_new
#if IN_HEADER(__GDK_IMAGE_H__)
#if IN_FILE(__GDK_IMAGE_X11_C__)
#ifdef GDK_ENABLE_BROKEN
gdk_image_new_bitmap
#endif
gdk_image_get_pixel
gdk_image_put_pixel
gdk_image_get_type G_GNUC_CONST
@ -915,9 +895,6 @@ gdk_pango_attr_embossed_new
gdk_pango_attr_stipple_new
gdk_pango_context_get
gdk_pango_context_get_for_screen
#ifndef GDK_DISABLE_DEPRECATED
gdk_pango_context_set_colormap
#endif
gdk_pango_layout_get_clip_region
gdk_pango_layout_line_get_clip_region
gdk_pango_renderer_get_default
@ -942,10 +919,6 @@ gdk_pixbuf_get_from_image
gdk_pixbuf_render_pixmap_and_mask
gdk_pixbuf_render_pixmap_and_mask_for_colormap
gdk_pixbuf_render_threshold_alpha
#ifndef GDK_DISABLE_DEPRECATED
gdk_pixbuf_render_to_drawable
gdk_pixbuf_render_to_drawable_alpha
#endif
#endif
#endif
@ -1011,12 +984,6 @@ gdk_rgb_ditherable
gdk_rgb_find_color
gdk_rgb_get_colormap
gdk_rgb_get_visual
#ifndef GDK_DISABLE_DEPRECATED
gdk_rgb_init
gdk_rgb_xpixel_from_rgb G_GNUC_CONST
gdk_rgb_gc_set_background
gdk_rgb_gc_set_foreground
#endif
gdk_rgb_set_install
gdk_rgb_set_min_colors
gdk_rgb_set_verbose

2
gdk/gdkcairo.h
View File

@ -17,7 +17,7 @@
* Boston, MA 02111-1307, USA.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif

2
gdk/gdkcolor.h
View File

@ -24,7 +24,7 @@
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif

5
gdk/gdkcursor.h
View File

@ -24,7 +24,7 @@
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif
@ -158,9 +158,6 @@ GdkCursor* gdk_cursor_new_from_name (GdkDisplay *display,
const gchar *name);
GdkPixbuf* gdk_cursor_get_image (GdkCursor *cursor);
#ifndef GDK_DISABLE_DEPRECATED
#define gdk_cursor_destroy gdk_cursor_unref
#endif /* GDK_DISABLE_DEPRECATED */
G_END_DECLS

2
gdk/gdkdisplay.h
View File

@ -21,7 +21,7 @@
* Boston, MA 02111-1307, USA.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif

2
gdk/gdkdisplaymanager.h
View File

@ -24,7 +24,7 @@
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif

7
gdk/gdkdnd.h
View File

@ -24,7 +24,7 @@
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif
@ -107,11 +107,6 @@ struct _GdkDragContextClass {
GType gdk_drag_context_get_type (void) G_GNUC_CONST;
GdkDragContext * gdk_drag_context_new (void);
#ifndef GDK_DISABLE_DEPRECATED
void gdk_drag_context_ref (GdkDragContext *context);
void gdk_drag_context_unref (GdkDragContext *context);
#endif
/* Destination side */
void gdk_drag_status (GdkDragContext *context,

2
gdk/gdkdrawable.h
View File

@ -24,7 +24,7 @@
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif

2
gdk/gdkevents.c
View File

@ -511,7 +511,7 @@ gdk_event_copy (const GdkEvent *event)
* Frees a #GdkEvent, freeing or decrementing any resources associated with it.
* Note that this function should only be called with events returned from
* functions such as gdk_event_peek(), gdk_event_get(),
* gdk_event_get_graphics_expose() and gdk_event_copy() and gdk_event_new().
* gdk_event_get_graphics_expose(), gdk_event_copy() and gdk_event_new().
**/
void
gdk_event_free (GdkEvent *event)

5
gdk/gdkevents.h
View File

@ -24,7 +24,7 @@
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif
@ -519,9 +519,6 @@ gboolean gdk_events_pending (void);
GdkEvent* gdk_event_get (void);
GdkEvent* gdk_event_peek (void);
#ifndef GDK_DISABLE_DEPRECATED
GdkEvent* gdk_event_get_graphics_expose (GdkWindow *window);
#endif
void gdk_event_put (const GdkEvent *event);
GdkEvent* gdk_event_new (GdkEventType type);

53
gdk/gdkgc.c
View File

@ -222,36 +222,6 @@ gdk_gc_finalize (GObject *object)
G_OBJECT_CLASS (gdk_gc_parent_class)->finalize (object);
}
/**
* gdk_gc_ref:
* @gc: a #GdkGC
*
* Deprecated function; use g_object_ref() instead.
*
* Return value: the gc.
*
* Deprecated: 2.0: Use g_object_ref() instead.
**/
GdkGC *
gdk_gc_ref (GdkGC *gc)
{
return (GdkGC *) g_object_ref (gc);
}
/**
* gdk_gc_unref:
* @gc: a #GdkGC
*
* Decrement the reference count of @gc.
*
* Deprecated: 2.0: Use g_object_unref() instead.
**/
void
gdk_gc_unref (GdkGC *gc)
{
g_object_unref (gc);
}
/**
* gdk_gc_get_values:
* @gc: a #GdkGC.
@ -409,29 +379,6 @@ gdk_gc_set_background (GdkGC *gc,
gdk_gc_set_values (gc, &values, GDK_GC_BACKGROUND);
}
/**
* gdk_gc_set_font:
* @gc: a #GdkGC.
* @font: the new font.
*
* Sets the font for a graphics context. (Note that
* all text-drawing functions in GDK take a @font
* argument; the value set here is used when that
* argument is %NULL.)
**/
void
gdk_gc_set_font (GdkGC *gc,
GdkFont *font)
{
GdkGCValues values;
g_return_if_fail (GDK_IS_GC (gc));
g_return_if_fail (font != NULL);
values.font = font;
gdk_gc_set_values (gc, &values, GDK_GC_FONT);
}
/**
* gdk_gc_set_function:
* @gc: a #GdkGC.

14
gdk/gdkgc.h
View File

@ -24,7 +24,7 @@
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif
@ -226,11 +226,6 @@ GdkGC *gdk_gc_new_with_values (GdkDrawable *drawable,
GdkGCValues *values,
GdkGCValuesMask values_mask);
#ifndef GDK_DISABLE_DEPRECATED
GdkGC *gdk_gc_ref (GdkGC *gc);
void gdk_gc_unref (GdkGC *gc);
#endif
void gdk_gc_get_values (GdkGC *gc,
GdkGCValues *values);
void gdk_gc_set_values (GdkGC *gc,
@ -240,10 +235,6 @@ void gdk_gc_set_foreground (GdkGC *gc,
const GdkColor *color);
void gdk_gc_set_background (GdkGC *gc,
const GdkColor *color);
#ifndef GDK_DISABLE_DEPRECATED
void gdk_gc_set_font (GdkGC *gc,
GdkFont *font);
#endif /* GDK_DISABLE_DEPRECATED */
void gdk_gc_set_function (GdkGC *gc,
GdkFunction function);
void gdk_gc_set_fill (GdkGC *gc,
@ -293,9 +284,6 @@ void gdk_gc_set_rgb_bg_color (GdkGC *gc,
const GdkColor *color);
GdkScreen * gdk_gc_get_screen (GdkGC *gc);
#ifndef GDK_DISABLE_DEPRECATED
#define gdk_gc_destroy g_object_unref
#endif /* GDK_DISABLE_DEPRECATED */
G_END_DECLS

59
gdk/gdki18n.h
View File

@ -1,59 +0,0 @@
/* GDK - The GIMP Drawing Kit
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
/*
* Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
* file for a list of people on the GTK+ Team. See the ChangeLog
* files for a list of changes. These files are distributed with
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#ifndef __GDK_I18N_H__
#define __GDK_I18N_H__
#ifndef GDK_DISABLE_DEPRECATED
/* GDK uses "glib". (And so does GTK).
*/
#include <glib.h>
#include <gdkconfig.h>
/* international string support */
#include <stdlib.h>
#if !defined(GDK_HAVE_BROKEN_WCTYPE) && (defined(GDK_HAVE_WCTYPE_H) || defined(GDK_HAVE_WCHAR_H)) && !defined(X_LOCALE)
# ifdef GDK_HAVE_WCTYPE_H
# include <wctype.h>
# else
# ifdef GDK_HAVE_WCHAR_H
# include <wchar.h>
# endif
# endif
# define gdk_iswalnum(c) iswalnum(c)
# define gdk_iswspace(c) iswspace(c)
#else
# include <ctype.h>
# define gdk_iswalnum(c) ((wchar_t)(c) <= 0xFF && isalnum(c))
# define gdk_iswspace(c) ((wchar_t)(c) <= 0xFF && isspace(c))
#endif
#endif /* GDK_DISABLE_DEPRECATED */
#endif /* __GDK_I18N_H__ */

65
gdk/gdkimage.c
View File

@ -34,71 +34,6 @@
#include "gdkinternals.h" /* For scratch_image code */
#include "gdkalias.h"
/**
* gdk_image_ref:
* @image: a #GdkImage
*
* Deprecated function; use g_object_ref() instead.
*
* Return value: the image
*
* Deprecated: 2.0: Use g_object_ref() instead.
**/
GdkImage *
gdk_image_ref (GdkImage *image)
{
g_return_val_if_fail (GDK_IS_IMAGE (image), NULL);
return g_object_ref (image);
}
/**
* gdk_image_unref:
* @image: a #GdkImage
*
* Deprecated function; use g_object_unref() instead.
*
* Deprecated: 2.0: Use g_object_unref() instead.
**/
void
gdk_image_unref (GdkImage *image)
{
g_return_if_fail (GDK_IS_IMAGE (image));
g_object_unref (image);
}
/**
* gdk_image_get:
* @drawable: a #GdkDrawable
* @x: x coordinate in @window
* @y: y coordinate in @window
* @width: width of area in @window
* @height: height of area in @window
*
* This is a deprecated wrapper for gdk_drawable_get_image();
* gdk_drawable_get_image() should be used instead. Or even better: in
* most cases gdk_pixbuf_get_from_drawable() is the most convenient
* choice.
*
* Return value: a new #GdkImage or %NULL
**/
GdkImage*
gdk_image_get (GdkWindow *drawable,
gint x,
gint y,
gint width,
gint height)
{
g_return_val_if_fail (GDK_IS_DRAWABLE (drawable), NULL);
g_return_val_if_fail (x >= 0, NULL);
g_return_val_if_fail (y >= 0, NULL);
g_return_val_if_fail (width >= 0, NULL);
g_return_val_if_fail (height >= 0, NULL);
return gdk_drawable_get_image (drawable, x, y, width, height);
}
/**
* gdk_image_set_colormap:
* @image: a #GdkImage

24
gdk/gdkimage.h
View File

@ -24,7 +24,7 @@
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif
@ -97,17 +97,6 @@ GdkImage* gdk_image_new (GdkImageType type,
gint width,
gint height);
#ifndef GDK_DISABLE_DEPRECATED
GdkImage* gdk_image_get (GdkDrawable *drawable,
gint x,
gint y,
gint width,
gint height);
GdkImage * gdk_image_ref (GdkImage *image);
void gdk_image_unref (GdkImage *image);
#endif
void gdk_image_put_pixel (GdkImage *image,
gint x,
gint y,
@ -121,17 +110,6 @@ void gdk_image_set_colormap (GdkImage *image,
GdkColormap* gdk_image_get_colormap (GdkImage *image);
#ifdef GDK_ENABLE_BROKEN
GdkImage* gdk_image_new_bitmap (GdkVisual *visual,
gpointer data,
gint width,
gint height);
#endif /* GDK_ENABLE_BROKEN */
#ifndef GDK_DISABLE_DEPRECATED
#define gdk_image_destroy g_object_unref
#endif /* GDK_DISABLE_DEPRECATED */
G_END_DECLS
#endif /* __GDK_IMAGE_H__ */

2
gdk/gdkinput.h
View File

@ -24,7 +24,7 @@
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif

2
gdk/gdkkeys.h
View File

@ -24,7 +24,7 @@
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif

18
gdk/gdkpango.c
View File

@ -764,24 +764,6 @@ gdk_pango_renderer_set_override_color (GdkPangoRenderer *gdk_renderer,
priv->override_color_set[part] = FALSE;
}
/**
* gdk_pango_context_set_colormap:
* @context: a #PangoContext
* @colormap: a #GdkColormap
*
* This function used to set the colormap to be used for drawing with
* @context. The colormap is now always derived from the graphics
* context used for drawing, so calling this function is no longer
* necessary.
**/
void
gdk_pango_context_set_colormap (PangoContext *context,
GdkColormap *colormap)
{
g_return_if_fail (PANGO_IS_CONTEXT (context));
g_return_if_fail (colormap == NULL || GDK_IS_COLORMAP (colormap));
}
/* Gets a renderer to draw with, setting the properties of the
* renderer and activating it. Note that since we activate the
* renderer here, the implicit setting of the matrix that

6
gdk/gdkpango.h
View File

@ -17,7 +17,7 @@
* Boston, MA 02111-1307, USA.
*/
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif
@ -108,10 +108,6 @@ PangoContext *gdk_pango_context_get_for_screen (GdkScreen *screen);
#ifndef GDK_MULTIHEAD_SAFE
PangoContext *gdk_pango_context_get (void);
#endif
#ifndef GDK_DISABLE_DEPRECATED
void gdk_pango_context_set_colormap (PangoContext *context,
GdkColormap *colormap);
#endif
/* Get a clip region to draw only part of a layout or

91
gdk/gdkpixbuf-render.c
View File

@ -133,97 +133,6 @@ gdk_pixbuf_render_threshold_alpha (GdkPixbuf *pixbuf,
}
}
/**
* gdk_pixbuf_render_to_drawable:
* @pixbuf: A pixbuf.
* @drawable: Destination drawable.
* @gc: GC used for rendering.
* @src_x: Source X coordinate within pixbuf.
* @src_y: Source Y coordinate within pixbuf.
* @dest_x: Destination X coordinate within 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.
* @x_dither: X offset for dither.
* @y_dither: Y offset for dither.
*
* Renders a rectangular portion of a pixbuf to a drawable while using the
* specified GC. This is done using GdkRGB, so the specified drawable must have
* the GdkRGB visual and colormap. Note that this function will ignore the
* opacity information for images with an alpha channel; the GC must already
* have the clipping mask set if you want transparent regions to show through.
*
* For an explanation of dither offsets, see the GdkRGB documentation. In
* brief, the dither offset is important when re-rendering partial regions of an
* image to a rendered version of the full image, or for when the offsets to a
* base position change, as in scrolling. The dither matrix has to be shifted
* for consistent visual results. If you do not have any of these cases, the
* dither offsets can be both zero.
*
* Deprecated: 2.4: This function is obsolete. Use gdk_draw_pixbuf() instead.
**/
void
gdk_pixbuf_render_to_drawable (GdkPixbuf *pixbuf,
GdkDrawable *drawable,
GdkGC *gc,
int src_x, int src_y,
int dest_x, int dest_y,
int width, int height,
GdkRgbDither dither,
int x_dither, int y_dither)
{
gdk_draw_pixbuf (drawable, gc, pixbuf,
src_x, src_y, dest_x, dest_y, width, height,
dither, x_dither, y_dither);
}
/**
* gdk_pixbuf_render_to_drawable_alpha:
* @pixbuf: A pixbuf.
* @drawable: Destination drawable.
* @src_x: Source X coordinate within pixbuf.
* @src_y: Source Y coordinates within pixbuf.
* @dest_x: Destination X coordinate within 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.
* @alpha_mode: Ignored. Present for backwards compatibility.
* @alpha_threshold: Ignored. Present for backwards compatibility
* @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.
*
* On older X servers, rendering pixbufs with an alpha channel involves round trips
* to the X server, and may be somewhat slow.
*
* Deprecated: 2.4: This function is obsolete. Use gdk_draw_pixbuf() instead.
**/
void
gdk_pixbuf_render_to_drawable_alpha (GdkPixbuf *pixbuf,
GdkDrawable *drawable,
int src_x, int src_y,
int dest_x, int dest_y,
int width, int height,
GdkPixbufAlphaMode alpha_mode,
int alpha_threshold,
GdkRgbDither dither,
int x_dither, int y_dither)
{
gdk_draw_pixbuf (drawable, NULL, pixbuf,
src_x, src_y, dest_x, dest_y, width, height,
dither, x_dither, y_dither);
}
/**
* gdk_pixbuf_render_pixmap_and_mask:
* @pixbuf: A pixbuf.

Some files were not shown because too many files have changed in this diff Show More