diff options
32 files changed, 230 insertions, 4835 deletions
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 82615e1de..6a8a9e096 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,14 @@ +Sat Mar 3 17:20:53 2001 Owen Taylor <otaylor@redhat.com> + + * */Makefile.am (scan-build.stamp): You can't use + + as a metacharacter for basic regular expressions. + (This was the "all objects disappear") + + * gdk/gdk-sections.txt gdk-pixbuf/gdk-pixbuf-sections.txt + + * */*-unused.sgml: Remove a lot of empty stuff. (No + point in saving old docs when there aren't any.) + 2001-02-20 Havoc Pennington <hp@pobox.com> * gdk/tmpl/rgb.sgml: fix these docs to reflect the current state diff --git a/docs/reference/gdk-pixbuf/Makefile.am b/docs/reference/gdk-pixbuf/Makefile.am index 1afdcd297..4f6d32d06 100644 --- a/docs/reference/gdk-pixbuf/Makefile.am +++ b/docs/reference/gdk-pixbuf/Makefile.am @@ -94,7 +94,7 @@ SCANOBJ_FILES = \ scan-build.stamp: $(HFILE_GLOB) @echo '*** Scanning header files ***' cd $(srcdir) && ( \ - if grep -l '^.+$$' $(DOC_MODULE).types > /dev/null ; then \ + if grep -l '^..*$$' $(DOC_MODULE).types > /dev/null ; then \ CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj --module=$(DOC_MODULE) ; \ else \ for i in $(SCANOBJ_FILES) ; do \ diff --git a/docs/reference/gdk-pixbuf/gdk-pixbuf-sections.txt b/docs/reference/gdk-pixbuf/gdk-pixbuf-sections.txt index 3bb6f1318..84ad93745 100644 --- a/docs/reference/gdk-pixbuf/gdk-pixbuf-sections.txt +++ b/docs/reference/gdk-pixbuf/gdk-pixbuf-sections.txt @@ -138,14 +138,12 @@ gdk_pixbuf_loader_get_type <SECTION> <TITLE>Module Interface</TITLE> <FILE>module_interface</FILE> +ModuleFillVtableFunc ModulePreparedNotifyFunc ModuleUpdatedNotifyFunc ModuleFrameDoneNotifyFunc ModuleAnimationDoneNotifyFunc GdkPixbufModule -_gdk_pixbuf_get_module -_gdk_pixbuf_get_named_module -_gdk_pixbuf_load_module </SECTION> <SECTION> diff --git a/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml b/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml index a13ef4e4a..910ccef35 100644 --- a/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml +++ b/docs/reference/gdk-pixbuf/tmpl/gdk-pixbuf-unused.sgml @@ -22,26 +22,6 @@ Getting parts of a drawable's image data into a pixbuf. Drawables to Pixbufs -<!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gdk-pixbuf-io.sgml:Title ##### --> -gdk-pixbuf-io - - <!-- ##### SECTION ./tmpl/gnome-canvas-pixbuf.sgml:Long_Description ##### --> <para> This canvas item displays #GdkPixbuf images. It handles full @@ -385,18 +365,6 @@ XlibRGB @obj: A GTK+ object. -<!-- ##### STRUCT GdkPixbufAnimationClass ##### --> -<para> - -</para> - - -<!-- ##### STRUCT GdkPixbufClass ##### --> -<para> - -</para> - - <!-- ##### USER_FUNCTION GdkPixbufLastUnref ##### --> <para> A function of this type can be used to override the default @@ -584,179 +552,3 @@ End: </para> -<!-- ##### FUNCTION gdk_pixbuf_finalize ##### --> -<para> - -</para> - -@pixbuf: <!-- -Local variables: -mode: sgml -sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "") -End: ---> - -<!-- ##### FUNCTION gdk_pixbuf_get_format ##### --> -<para> - -</para> - -@pixbuf: -@Returns: - -<!-- ##### FUNCTION gdk_pixbuf_get_from_drawable ##### --> -<para> - -</para> - -@dest: -@src: -@cmap: -@src_x: -@src_y: -@dest_x: -@dest_y: -@width: -@height: -@Returns: <!-- -Local variables: -mode: sgml -sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "") -End: ---> - -<!-- ##### FUNCTION _gdk_pixbuf_get_module ##### --> -<para> - -</para> - -@buffer: -@size: -@filename: -@error: -@Returns: - -<!-- ##### FUNCTION _gdk_pixbuf_get_named_module ##### --> -<para> - -</para> - -@name: -@error: -@Returns: - -<!-- ##### FUNCTION gdk_pixbuf_init ##### --> -<para> - -</para> - - -<!-- ##### FUNCTION _gdk_pixbuf_load_module ##### --> -<para> - -</para> - -@image_module: -@error: -@Returns: - -<!-- ##### FUNCTION gdk_pixbuf_new_from_art_pixbuf ##### --> -<para> - -</para> - -@art_pixbuf: -@Returns: - -<!-- ##### FUNCTION gdk_pixbuf_postinit ##### --> -<para> - -</para> - -@app: -@modinfo: - -<!-- ##### FUNCTION gdk_pixbuf_preinit ##### --> -<para> - -</para> - -@app: -@modinfo: - -<!-- ##### FUNCTION gdk_pixbuf_render_pixmap_and_mask ##### --> -<para> - -</para> - -@pixbuf: -@pixmap_return: -@mask_return: -@alpha_threshold: <!-- -Local variables: -mode: sgml -sgml-parent-document: ("../gdk-pixbuf.sgml" "book" "refsect2" "") -End: ---> - -<!-- ##### FUNCTION gdk_pixbuf_render_threshold_alpha ##### --> -<para> - -</para> - -@pixbuf: -@bitmap: -@src_x: -@src_y: -@dest_x: -@dest_y: -@width: -@height: -@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_set_last_unref_handler ##### --> -<para> - -</para> - -@pixbuf: -@last_unref_fn: -@last_unref_fn_data: - diff --git a/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml b/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml index 9b4271431..563fabb57 100644 --- a/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml +++ b/docs/reference/gdk-pixbuf/tmpl/module_interface.sgml @@ -14,6 +14,14 @@ Module Interface </para> +<!-- ##### USER_FUNCTION ModuleFillVtableFunc ##### --> +<para> + +</para> + +@module: + + <!-- ##### USER_FUNCTION ModulePreparedNotifyFunc ##### --> <para> diff --git a/docs/reference/gdk/Makefile.am b/docs/reference/gdk/Makefile.am index a26415303..60c8e1e5d 100644 --- a/docs/reference/gdk/Makefile.am +++ b/docs/reference/gdk/Makefile.am @@ -85,7 +85,7 @@ SCANOBJ_FILES = \ scan-build.stamp: $(HFILE_GLOB) @echo '*** Scanning header files ***' cd $(srcdir) && ( \ - if grep -l '^.+$$' $(DOC_MODULE).types > /dev/null ; then \ + if grep -l '^..*$$' $(DOC_MODULE).types > /dev/null ; then \ CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj --module=$(DOC_MODULE) ; \ else \ for i in $(SCANOBJ_FILES) ; do \ diff --git a/docs/reference/gdk/gdk-sections.txt b/docs/reference/gdk/gdk-sections.txt index 975b105f7..437fa094f 100644 --- a/docs/reference/gdk/gdk-sections.txt +++ b/docs/reference/gdk/gdk-sections.txt @@ -392,8 +392,14 @@ gdk_window_show gdk_window_hide gdk_window_is_visible gdk_window_is_viewable +gdk_window_get_state gdk_window_withdraw gdk_window_iconify +gdk_window_deiconify +gdk_window_stick +gdk_window_unstick +gdk_window_maximize +gdk_window_unmaximize gdk_window_move gdk_window_resize gdk_window_move_resize @@ -405,6 +411,7 @@ gdk_window_clear_area_e gdk_window_copy_area gdk_window_raise gdk_window_lower +gdk_window_focus gdk_window_register_dnd <SUBSECTION> @@ -431,6 +438,7 @@ GdkFilterFunc GdkFilterReturn GdkXEvent gdk_window_shape_combine_mask +gdk_window_shape_combine_region gdk_window_set_child_shapes gdk_window_merge_child_shapes gdk_window_set_static_gravities @@ -592,6 +600,7 @@ gdk_region_destroy <SUBSECTION> gdk_region_get_clipbox +gdk_region_get_rectangles gdk_region_empty gdk_region_equal gdk_region_point_in @@ -751,6 +760,7 @@ GdkEventDND GdkEventProximity GdkEventClient GdkEventNoExpose +GdkEventWindowState <SUBSECTION> GdkScrollDirection @@ -758,6 +768,7 @@ GdkVisibilityState GdkCrossingMode GdkNotifyType GdkPropertyState +GdkWindowState </SECTION> <SECTION> @@ -856,6 +867,7 @@ gdk_window_lookup gdk_pixmap_lookup gdk_font_lookup gdk_x11_get_server_time +gdk_net_wm_supports <SUBSECTION Private> GDK_TYPE_GC_X11 diff --git a/docs/reference/gdk/tmpl/event_structs.sgml b/docs/reference/gdk/tmpl/event_structs.sgml index a6d41967c..98f0b6afb 100644 --- a/docs/reference/gdk/tmpl/event_structs.sgml +++ b/docs/reference/gdk/tmpl/event_structs.sgml @@ -344,6 +344,17 @@ FIXME: add more here. @window: the window which received the event. @send_event: TRUE if the event was sent explicitly (e.g. using XSendEvent). +<!-- ##### STRUCT GdkEventWindowState ##### --> +<para> + +</para> + +@type: +@window: +@send_event: +@changed_mask: +@new_window_state: + <!-- ##### ENUM GdkScrollDirection ##### --> <para> @@ -392,3 +403,13 @@ Specifies the type of a property change for a #GdkEventProperty. @GDK_PROPERTY_NEW_VALUE: the property value wan changed. @GDK_PROPERTY_DELETE: the property was deleted. +<!-- ##### ENUM GdkWindowState ##### --> +<para> + +</para> + +@GDK_WINDOW_STATE_WITHDRAWN: +@GDK_WINDOW_STATE_ICONIFIED: +@GDK_WINDOW_STATE_MAXIMIZED: +@GDK_WINDOW_STATE_STICKY: + diff --git a/docs/reference/gdk/tmpl/events.sgml b/docs/reference/gdk/tmpl/events.sgml index 117f6f8ce..9e2edc7d8 100644 --- a/docs/reference/gdk/tmpl/events.sgml +++ b/docs/reference/gdk/tmpl/events.sgml @@ -82,6 +82,7 @@ has changed. @GDK_NO_EXPOSE: indicates that the source region was completely available when parts of a drawable were copied. This is not very useful. @GDK_SCROLL: +@GDK_WINDOW_STATE: <!-- ##### ENUM GdkEventMask ##### --> <para> diff --git a/docs/reference/gdk/tmpl/gdk-unused.sgml b/docs/reference/gdk/tmpl/gdk-unused.sgml index 0f2eda516..5a2f9d954 100644 --- a/docs/reference/gdk/tmpl/gdk-unused.sgml +++ b/docs/reference/gdk/tmpl/gdk-unused.sgml @@ -1,122 +1,3 @@ -<!-- ##### SECTION ./tmpl/color_contexts.sgml:Long_Description ##### --> -<para> -The #GdkColorContext type is used for allocating groups of colors. -</para> -<para> -It is now deprecated in favor of the gdk_colormap_*() functions described in -the <link linkend="gdk-Colormaps-and-Colors">Colormaps and Colors</link> -section. -</para> - - -<!-- ##### SECTION ./tmpl/color_contexts.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/color_contexts.sgml:Short_Description ##### --> -routines for allocating colors (deprecated). - - -<!-- ##### SECTION ./tmpl/color_contexts.sgml:Title ##### --> -Color Contexts - - -<!-- ##### SECTION ./tmpl/gdkkeys.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gdkkeys.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gdkkeys.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gdkkeys.sgml:Title ##### --> -Keyboard Handling - - -<!-- ##### SECTION ./tmpl/gdkregion.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gdkregion.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gdkregion.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gdkregion.sgml:Title ##### --> -Points, Rectangles and Regions - - -<!-- ##### SECTION ./tmpl/input_methods.sgml.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/input_methods.sgml.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/input_methods.sgml.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/input_methods.sgml.sgml:Title ##### --> -Pango Interaction - - -<!-- ##### SECTION ./tmpl/regions2.sgml:Long_Description ##### --> -<para> -GDK provides the #GdkPoint, #GdkRectangle and #GdkRegion data types for -representing pixels and sets of pixels on the screen. -</para> -<para> -#GdkPoint is a simple structure containing an x and y coordinate of a point. -</para> -<para> -#GdkRectangle is a structure holding the position and size of a rectangle. -The intersection of two rectangles can be computed with -gdk_rectangle_intersect(). To find the union of two rectangles use -gdk_rectangle_union(). -</para> -<para> -#GdkRegion is an opaque data type holding a set of arbitrary pixels, and is -usually used for clipping graphical operations (see gdk_gc_set_clip_region()). -</para> - - -<!-- ##### SECTION ./tmpl/regions2.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/regions2.sgml:Short_Description ##### --> -simple graphical data types. - - -<!-- ##### SECTION ./tmpl/regions2.sgml:Title ##### --> -Points, Rectangles and Regions - - <!-- ##### MACRO GDK_CORE_POINTER ##### --> <para> This macro contains an integer value representing @@ -124,48 +5,6 @@ the device ID for the core pointer device. </para> -<!-- ##### STRUCT GdkColorContext ##### --> -<para> - -</para> - -@visual: -@colormap: -@num_colors: -@max_colors: -@num_allocated: -@mode: -@need_to_free_colormap: -@std_cmap_atom: -@clut: -@cmap: -@color_hash: -@palette: -@num_palette: -@fast_dither: - -<!-- ##### STRUCT GdkColorContextDither ##### --> -<para> - -</para> - -@fast_rgb: -@fast_err: -@fast_erg: -@fast_erb: - -<!-- ##### ENUM GdkColorContextMode ##### --> -<para> - -</para> - -@GDK_CC_MODE_UNDEFINED: -@GDK_CC_MODE_BW: -@GDK_CC_MODE_STD_CMAP: -@GDK_CC_MODE_TRUE: -@GDK_CC_MODE_MY_GRAY: -@GDK_CC_MODE_PALETTE: - <!-- ##### STRUCT GdkDeviceInfo ##### --> <para> The #GdkDeviceInfo structure contains information about a @@ -198,137 +37,6 @@ device. It has the following fields: @GDK_PIXBUF_ALPHA_BILEVEL: @GDK_PIXBUF_ALPHA_FULL: -<!-- ##### FUNCTION gdk_color_context_add_palette ##### --> -<para> - -</para> - -@cc: -@palette: -@num_palette: -@Returns: - -<!-- ##### FUNCTION gdk_color_context_free ##### --> -<para> - -</para> - -@cc: - -<!-- ##### FUNCTION gdk_color_context_free_dither ##### --> -<para> - -</para> - -@cc: - -<!-- ##### FUNCTION gdk_color_context_get_index_from_palette ##### --> -<para> - -</para> - -@cc: -@red: -@green: -@blue: -@failed: -@Returns: - -<!-- ##### FUNCTION gdk_color_context_get_pixel ##### --> -<para> - -</para> - -@cc: -@red: -@green: -@blue: -@failed: -@Returns: - -<!-- ##### FUNCTION gdk_color_context_get_pixel_from_palette ##### --> -<para> - -</para> - -@cc: -@red: -@green: -@blue: -@failed: -@Returns: - -<!-- ##### FUNCTION gdk_color_context_get_pixels ##### --> -<para> - -</para> - -@cc: -@reds: -@greens: -@blues: -@ncolors: -@colors: -@nallocated: - -<!-- ##### FUNCTION gdk_color_context_get_pixels_incremental ##### --> -<para> - -</para> - -@cc: -@reds: -@greens: -@blues: -@ncolors: -@used: -@colors: -@nallocated: - -<!-- ##### FUNCTION gdk_color_context_init_dither ##### --> -<para> - -</para> - -@cc: - -<!-- ##### FUNCTION gdk_color_context_new ##### --> -<para> - -</para> - -@visual: -@colormap: -@Returns: - -<!-- ##### FUNCTION gdk_color_context_new_mono ##### --> -<para> - -</para> - -@visual: -@colormap: -@Returns: - -<!-- ##### FUNCTION gdk_color_context_query_color ##### --> -<para> - -</para> - -@cc: -@color: -@Returns: - -<!-- ##### FUNCTION gdk_color_context_query_colors ##### --> -<para> - -</para> - -@cc: -@colors: -@num_colors: -@Returns: - <!-- ##### FUNCTION gdk_input_list_devices ##### --> <para> Lists all available input devices, along with their @@ -411,59 +119,4 @@ they will be ignored. @ytilt: location to store current tilt in the y direction. @mask: location to store the current modifier state. -<!-- ##### FUNCTION gdk_key_repeat_disable ##### --> -<para> -Disables the keyboard auto-repeat mode. -This should be used with care as it may affect other applications. -</para> - - -<!-- ##### FUNCTION gdk_key_repeat_restore ##### --> -<para> -Restores the keyboard auto-repeat mode to its state when the application was -started. -</para> - - -<!-- ##### FUNCTION gdk_regions_intersect ##### --> -<para> -Returns the intersection of two regions. -</para> - -@source1: a #GdkRegion. -@source2: a #GdkRegion. -@Returns: the intersection of @source1 and @source2. - -<!-- ##### FUNCTION gdk_regions_subtract ##### --> -<para> -Subtracts one region from another. -The result is a region containing all the pixels which are in @source1, but -which are not in @source2. -</para> - -@source1: a #GdkRegion. -@source2: a #GdkRegion to subtract from @source1. -@Returns: @source1 - @source2. - -<!-- ##### FUNCTION gdk_regions_union ##### --> -<para> -Returns the union of two regions. -This is all pixels in either of @source1 or @source2. -</para> - -@source1: a #GdkRegion. -@source2: a #GdkRegion. -@Returns: the union of @source1 and @source2. - -<!-- ##### FUNCTION gdk_regions_xor ##### --> -<para> -Returns the difference between the union and the intersection of two regions. -This is a region containing the pixels that are in one of the source regions, -but which are not in both. -</para> - -@source1: a #GdkRegion. -@source2: a #GdkRegion. -@Returns: the difference between the union and the intersection of @source1 -and @source2. diff --git a/docs/reference/gdk/tmpl/pango_interaction.sgml b/docs/reference/gdk/tmpl/pango_interaction.sgml index ffd0fda54..8ecda464a 100644 --- a/docs/reference/gdk/tmpl/pango_interaction.sgml +++ b/docs/reference/gdk/tmpl/pango_interaction.sgml @@ -61,7 +61,7 @@ Pango Interaction </para> -@bitmap: +@stipple: @Returns: diff --git a/docs/reference/gdk/tmpl/regions.sgml b/docs/reference/gdk/tmpl/regions.sgml index 68f897cc5..77b197f74 100644 --- a/docs/reference/gdk/tmpl/regions.sgml +++ b/docs/reference/gdk/tmpl/regions.sgml @@ -151,6 +151,16 @@ Returns the smallest rectangle which includes the entire #GdkRegion. @rectangle: returns the smallest rectangle which includes all of @region. +<!-- ##### FUNCTION gdk_region_get_rectangles ##### --> +<para> + +</para> + +@region: +@rectangles: +@n_rectangles: + + <!-- ##### FUNCTION gdk_region_empty ##### --> <para> Returns TRUE if the #GdkRegion is empty. @@ -225,49 +235,58 @@ Positive values shrink the region. Negative values expand it. <!-- ##### FUNCTION gdk_region_union_with_rect ##### --> <para> -Returns the union of a region and a rectangle. +Sets the area of @region to the union of the areas of @region and +@rect. The resulting area is the set of pixels contained in +either @region or @rect. + </para> @region: a #GdkRegion. @rect: a #GdkRectangle. -<!-- # Unused Parameters # --> -@Returns: the union of @region and @rect. <!-- ##### FUNCTION gdk_region_intersect ##### --> <para> - +Sets the area of @source1 to the intersection of the areas of @source1 +and @source2. The resulting area is the set of pixels contained in +both @source1 and @source2. </para> -@source1: -@source2: +@source1: a #GdkRegion +@source2: a #GdkRegion <!-- ##### FUNCTION gdk_region_union ##### --> <para> +Sets the area of @source1 to the union of the areas of @source1 and +@source2. The resulting area is the set of pixels contained in +either @source1 or @source2. </para> -@source1: -@source2: +@source1: a #GdkRegion +@source2: a #GdkRegion <!-- ##### FUNCTION gdk_region_subtract ##### --> <para> - +Subtracts the area of @source2 from the area @source1. The resulting +area is the set of pixels contained in @source1 but not in @source2. </para> -@source1: -@source2: +@source1: a #GdkRegion +@source2: a #GdkRegion <!-- ##### FUNCTION gdk_region_xor ##### --> <para> - +Sets the area of @source1 to the exclusive-OR of the areas of @source1 +and @source2. The resulting area is the set of pixels contained in one +or the other of the two sources but not in both. </para> -@source1: -@source2: +@source1: a #GdkRegion +@source2: a #GdkRegion <!-- ##### STRUCT GdkSpan ##### --> diff --git a/docs/reference/gdk/tmpl/rgb.sgml b/docs/reference/gdk/tmpl/rgb.sgml index a62e96e84..f7c8d5b91 100644 --- a/docs/reference/gdk/tmpl/rgb.sgml +++ b/docs/reference/gdk/tmpl/rgb.sgml @@ -119,6 +119,7 @@ This function no longer does anything at all. It's completely useless </para> + <!-- ##### FUNCTION gdk_draw_rgb_image ##### --> <para> Draws an RGB image in the drawable. This is the core GdkRgb diff --git a/docs/reference/gdk/tmpl/windows.sgml b/docs/reference/gdk/tmpl/windows.sgml index ab6096ba2..a28540f9e 100644 --- a/docs/reference/gdk/tmpl/windows.sgml +++ b/docs/reference/gdk/tmpl/windows.sgml @@ -212,6 +212,15 @@ Windows @Returns: +<!-- ##### FUNCTION gdk_window_get_state ##### --> +<para> + +</para> + +@window: +@Returns: + + <!-- ##### FUNCTION gdk_window_withdraw ##### --> <para> @@ -228,6 +237,46 @@ Windows @window: +<!-- ##### FUNCTION gdk_window_deiconify ##### --> +<para> + +</para> + +@window: + + +<!-- ##### FUNCTION gdk_window_stick ##### --> +<para> + +</para> + +@window: + + +<!-- ##### FUNCTION gdk_window_unstick ##### --> +<para> + +</para> + +@window: + + +<!-- ##### FUNCTION gdk_window_maximize ##### --> +<para> + +</para> + +@window: + + +<!-- ##### FUNCTION gdk_window_unmaximize ##### --> +<para> + +</para> + +@window: + + <!-- ##### FUNCTION gdk_window_move ##### --> <para> @@ -348,6 +397,15 @@ Windows @window: +<!-- ##### FUNCTION gdk_window_focus ##### --> +<para> + +</para> + +@window: +@timestamp: + + <!-- ##### FUNCTION gdk_window_register_dnd ##### --> <para> @@ -526,6 +584,17 @@ Windows @offset_y: +<!-- ##### FUNCTION gdk_window_shape_combine_region ##### --> +<para> + +</para> + +@window: +@shape_region: +@offset_x: +@offset_y: + + <!-- ##### FUNCTION gdk_window_set_child_shapes ##### --> <para> diff --git a/docs/reference/gdk/tmpl/x_interaction.sgml b/docs/reference/gdk/tmpl/x_interaction.sgml index 740f3911c..710277fbc 100644 --- a/docs/reference/gdk/tmpl/x_interaction.sgml +++ b/docs/reference/gdk/tmpl/x_interaction.sgml @@ -304,3 +304,12 @@ X Window System Interaction @Returns: +<!-- ##### FUNCTION gdk_net_wm_supports ##### --> +<para> + +</para> + +@property: +@Returns: + + diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am index 8e73da65a..1a32ae549 100644 --- a/docs/reference/gtk/Makefile.am +++ b/docs/reference/gtk/Makefile.am @@ -121,7 +121,7 @@ SCANOBJ_FILES = \ scan-build.stamp: $(HFILE_GLOB) @echo '*** Scanning header files ***' cd $(srcdir) && ( \ - if grep -l '^.+$$' $(DOC_MODULE).types > /dev/null ; then \ + if grep -l '^..*$$' $(DOC_MODULE).types > /dev/null ; then \ CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj --module=$(DOC_MODULE) ; \ else \ for i in $(SCANOBJ_FILES) ; do \ diff --git a/docs/reference/gtk/tmpl/gtk-unused.sgml b/docs/reference/gtk/tmpl/gtk-unused.sgml index 88a292bb4..e3fb5dcba 100644 --- a/docs/reference/gtk/tmpl/gtk-unused.sgml +++ b/docs/reference/gtk/tmpl/gtk-unused.sgml @@ -1,548 +1,15 @@ -<!-- ##### SECTION ./tmpl/gtkaccelgroup.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkaccelgroup.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkaccelgroup.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkaccelgroup.sgml:Title ##### --> -Keyboard Accelerators - - -<!-- ##### SECTION ./tmpl/gtkarg.sgml:Long_Description ##### --> -<para> -All the functions in here are marked a Non-public. -We describe it anyway because it is occasionally useful -to understand how the work is done. -</para> -<para> -Arguments are a way of describing a named parameter to a function. -They have two important roles within gtk+: -<itemizedlist> -<listitem> -<para> -they describe <wordasword>object properties</wordasword>. -This means that they present an interface to get and set a named-type -for any type of object in a consistent way. -(All the relevant functions to do this start with gtk_object_set -or gtk_object_get). -</para> -</listitem> -<listitem> -<para> -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(). -However if you are writing a function to emit or create an arbitrary -signal, you must use gtk_signal_emitv() or gtk_signal_newv(). -</para> -</listitem> -</itemizedlist> -</para> - - -<!-- ##### SECTION ./tmpl/gtkarg.sgml:See_Also ##### --> -<para> -#GtkObject. -</para> - - -<!-- ##### SECTION ./tmpl/gtkarg.sgml:Short_Description ##### --> -Utility function to manipulate lists of named, typed arguments. - - -<!-- ##### SECTION ./tmpl/gtkarg.sgml:Title ##### --> -Implementation of Object Properties - - -<!-- ##### SECTION ./tmpl/gtkbindings.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkbindings.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkbindings.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkbindings.sgml:Title ##### --> -Bindings - - -<!-- ##### SECTION ./tmpl/gtkcellrenderer.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkcellrenderer.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkcellrenderer.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkcellrenderer.sgml:Title ##### --> -GtkCellRenderer - - -<!-- ##### SECTION ./tmpl/gtkcellrendererpixbuf.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkcellrendererpixbuf.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkcellrendererpixbuf.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkcellrendererpixbuf.sgml:Title ##### --> -GtkCellRendererPixbuf - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertext.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertext.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertext.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertext.sgml:Title ##### --> -GtkCellRendererText - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertextpixbuf.sgml:Title ##### --> -GtkCellRendererTextPixbuf - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertoggle.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertoggle.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertoggle.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkcellrenderertoggle.sgml:Title ##### --> -GtkCellRendererToggle - - -<!-- ##### SECTION ./tmpl/gtkclipboard.sgml:Long_Description ##### --> - <para> - The #GtkClipboard object represents a clipboard of data shared - between different processes or between different widgets in - the same process. Each clipboard is identified by a name encoded as a - #GdkAtom. (Conversion to and from strings can be done with - gdk_atom_intern() and gdk_atom_name().) The default clipboard - corresponds to the CLIPBOARD atom; another commonly used clipboard - is the PRIMARY clipboard, which, in X, traditionally contains - the currently selected text. - </para> - <para> - To support having a number of different formats on the clipboard - at the same time, the clipboard mechanism allows providing - callbacks instead of the actual data. When you set the contents - of the clipboard, you can either supply the data directly (via - functions like gtk_clipboard_set_text()), or you can supply a - callback to be called at a later time when the data is needed (via - gtk_clipboard_set_with_data() or gtk_clipboard_set_with_owner().) - Providing a callback also avoids having to make copies of the data - when it is not needed. - </para> - <para> - gtk_clipboard_set_with_data() and gtk_clipboard_set_with_owner() - are quite similar; the choice between the two depends mostly on - which is more convenient in a particular situation. - The former is most useful when you want to have a blob of data - with callbacks to convert it into the various data types that you - advertise. When the @clear_func you provided is called, you - simply free the data blob. The latter is more useful when the - contents of clipboard reflect the internal state of a @GObject - (As an example, for the PRIMARY clipboard, when an entry widget - provides the clipboard's contents the contents are simply the - text within the selected region.) If the contents change, the - entry widget can call gtk_clipboard_set_with_owner() to update - the timestamp for clipboard ownership, without having to worry - about @clear_func being called. - </para> - <para> - Requesting the data from the clipboard is essentially - asynchronous. If the contents of the clipboard are provided within - the same process, then a direct function call will be made to - retrieve the data, but if they are provided by another process, - then the data needs to be retrieved from the other process, which - may take some time. To avoid blocking the user interface, the call - to request the selection, gtk_clipboard_request_contents() takes a - callback that will be called when the contents are received (or - when the request fails.) If you don't want to deal with providing - a separate callback, you can also use gtk_clipboard_wait_for_contents(). - What this does is run the Glib main loop recursively waiting for - the contents. This can simplify the code flow, but you still have - to be aware that other callbacks in your program can be called - while this recursive mainloop is running. - </para> - <para> - Along with the functions to get the clipboard contents as an - arbitrary data chunk, there are also functions to retrieve - it as text, gtk_clipboard_request_text() and - gtk_clipboard_wait_for_text(). These functions take care of - determining which formats are advertised by the clipboard - provider, asking for the clipboard in the best available format - and converting the results into the UTF-8 encoding. (The standard - form for representing strings in GTK+.) - </para> - - -<!-- ##### SECTION ./tmpl/gtkclipboard.sgml:See_Also ##### --> -<para> -<variablelist> - -<varlistentry> -<term>#GtkSelection</term> -<listitem><para>@GtkClipboard provides a high-level wrapper around the - lower level routines that deal with X selections. It is - also possibly to directly manipulate the X selections, - though it is seldom necessary to do so.</para></listitem> -</varlistentry> - -</variablelist> -</para> - - -<!-- ##### SECTION ./tmpl/gtkclipboard.sgml:Short_Description ##### --> -Storing data on Clipboards. - - -<!-- ##### SECTION ./tmpl/gtkclipboard.sgml:Title ##### --> -Clipboards - - -<!-- ##### SECTION ./tmpl/gtkdebug.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkdebug.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkdebug.sgml:Short_Description ##### --> - - - <!-- ##### SECTION ./tmpl/gtkdebug.sgml:Title ##### --> Debugging -<!-- ##### SECTION ./tmpl/gtkdnd.sgml:Long_Description ##### --> -<para> -GTK+ has a rich set of functions for doing inter-process -communication via the drag-and-drop metaphore. GTK+ -can do drag and drop (DND) via multiple protocols. -The currently supported protocols are the Xdnd and -Motif protocols. - -As well as the functions listed here, applications -may need to use some facilities provided for -<link linkend="gtk-Selections">Selections</link>. -Also, the Drag and Drop API makes use of signals -in the #GtkWidget class. -</para> - - -<!-- ##### SECTION ./tmpl/gtkdnd.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkdnd.sgml:Short_Description ##### --> -Functions for controlling drag and drop handling. - - -<!-- ##### SECTION ./tmpl/gtkdnd.sgml:Title ##### --> -Drag and Drop - - -<!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Short_Description ##### --> - - - <!-- ##### SECTION ./tmpl/gtkenums.sgml.sgml:Title ##### --> gtkenums.sgml -<!-- ##### SECTION ./tmpl/gtkenums.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkenums.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkenums.sgml:Short_Description ##### --> -Public enumerated types used throughout GTK+. - - -<!-- ##### SECTION ./tmpl/gtkenums.sgml:Title ##### --> -Standard Enumerations - - -<!-- ##### SECTION ./tmpl/gtkfeatures.sgml:Long_Description ##### --> -<para> -This section describes the variables and functions available to test the -version of the GTK+ library in use. -FIXME: probably merge with other general stuff. -</para> - - -<!-- ##### SECTION ./tmpl/gtkfeatures.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkfeatures.sgml:Short_Description ##### --> -variables and functions to check the GTK+ version. - - -<!-- ##### SECTION ./tmpl/gtkfeatures.sgml:Title ##### --> -Version Information - - -<!-- ##### SECTION ./tmpl/gtkgc.sgml:Long_Description ##### --> -<para> -These functions provide access to a shared pool of #GdkGC objects. -When a new #GdkGC is needed, gtk_gc_get() is called with the required depth, -colormap and #GdkGCValues. If a #GdkGC with the required properties already -exists then that is returned. If not, a new #GdkGC is created. -When the #GdkGC is no longer needed, gtk_gc_release() is called. -</para> - - -<!-- ##### SECTION ./tmpl/gtkgc.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkgc.sgml:Short_Description ##### --> -provides access to a shared pool of #GdkGC objects. - - -<!-- ##### SECTION ./tmpl/gtkgc.sgml:Title ##### --> -Graphics Contexts - - -<!-- ##### SECTION ./tmpl/gtkiconfactory.sgml:Long_Description ##### --> -<para> - An icon factory manages a collection of #GtkIconSet; a #GtkIconSet manages a - set of variants of a particular icon (i.e. a #GtkIconSet contains variants for - different sizes and widget states). Icons in an icon factory are named by a - stock ID, which is a simple string identifying the icon. Each #GtkStyle has a - list of #GtkIconFactory derived from the current theme; those icon factories - are consulted first when searching for an icon. If the theme doesn't set a - particular icon, GTK+ looks for the icon in a list of default icon factories, - maintained by gtk_icon_factory_add_default() and - gtk_icon_factory_remove_default(). Applications with icons should add a default - icon factory with their icons, which will allow themes to override the icons - for the application. -</para> - -<para> -To display an icon, always use gtk_style_lookup_icon_set() on the widget that -will display the icon, or the convenience function -gtk_widget_render_icon(). These functions take the theme into account when -looking up the icon to use for a given stock ID. -</para> - - -<!-- ##### SECTION ./tmpl/gtkiconfactory.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkiconfactory.sgml:Short_Description ##### --> - -Manipulating stock icons - - -<!-- ##### SECTION ./tmpl/gtkiconfactory.sgml:Title ##### --> -Themeable Stock Images - - -<!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Short_Description ##### --> - - - <!-- ##### SECTION ./tmpl/gtkimcontextsimple.sgml:Title ##### --> GtkIMContextSimple -<!-- ##### SECTION ./tmpl/gtkliststore.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkliststore.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkliststore.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkliststore.sgml:Title ##### --> -GtkListStore - - -<!-- ##### SECTION ./tmpl/gtkmain.sgml:Long_Description ##### --> -<para> -GTK uses an event oriented programming model. While conventional C programs -have control over the program flow all the time this does not apply to -applications written using GTK. Instead you set up some objects and -register some functions (<quote>callbacks</quote>) to be called whenever -some event occurs and give control to the GTK mainloop (e.g. by calling -gtk_main). -</para> - -<example> -<title> Typical <function>main</function> function for a GTK application</title> -<programlisting> -int -main (int argc, char **argv) -{ - /* Initialize i18n support */ - gtk_set_locale (); - - /* Initialize the widget set */ - gtk_init (&argc, &argv); - - /* Create the main window */ - mainwin = gtk_window_new (GTK_WINDOW_TOPLEVEL); - - /* Set up our GUI elements */ - ... - - /* Show the application window */ - gtk_widget_showall (mainwin); - - /* Let the user interact with our application */ - gtk_main (); - - /* The user lost interest */ - gtk_exit (0); -} -</programlisting> -</example> - - -<!-- ##### SECTION ./tmpl/gtkmain.sgml:See_Also ##### --> -<para> -</para> - - -<!-- ##### SECTION ./tmpl/gtkmain.sgml:Short_Description ##### --> -Mainloop and event handling - - -<!-- ##### SECTION ./tmpl/gtkmain.sgml:Title ##### --> -General - - <!-- ##### SECTION ./tmpl/gtkmarshal.sgml:Long_Description ##### --> <refsect2> <title>What are Signal Marshallers?</title> @@ -631,1144 +98,10 @@ Functions to adapt C structures to native calling convention. Signal Marshallers -<!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkmenufactory.sgml:Title ##### --> -Menu Factory - - -<!-- ##### SECTION ./tmpl/gtkprivate.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkprivate.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkprivate.sgml:Short_Description ##### --> - - - <!-- ##### SECTION ./tmpl/gtkprivate.sgml:Title ##### --> Private Information -<!-- ##### SECTION ./tmpl/gtkrc.sgml:Long_Description ##### --> -<para> -GTK+ provides resource file mechanism for configuring -various aspects of the operation of a GTK+ program -at runtime. -</para> - -<refsect2><title>Default files</title> -<para> -An application can cause GTK+ to parse a specific RC -file by calling gtk_rc_parse(). In addition to this, -certain files will be read at the end of gtk_init(). -Unless modified, the files looked for will be <filename>.gtkrc</filename> -in the users home directory, and -<filename>$localstatedir/gtk/gtkrc</filename> -(<literal>$localstatedir</literal> defaults to -<filename>/usr/local/etc</filename>). -</para> -<para> -The set of these <firstterm>default</firstterm> files -can be retrieved with gtk_rc_get_default_files() -and modified with gtk_rc_add_default_file() and -gtk_rc_set_default_files(). -</para> -<para> -For each default file, in addition to the file itself, -GTK+ will look for a locale-specific file that will -be parsed in addition to the main file. For instance, -if <literal>LANG</literal> is set to <literal>ja_JP.ujis</literal>, -when loading the default file <filename>~/.gtkrc</filename> -then GTK+ looks for <filename>~/.gtkrc.ja_JP.ujis</filename>, -<filename>~/.gtkrc.ja_JP</filename>, and -<filename>~/.gtkrc.ja</filename>, and parses the -first one it finds. -</para> -</refsect2> - -<refsect2><title>Pathnames and patterns</title> -<para> -A resource file defines a number of styles and key bindings and -attaches them to particular widgets. The attachment is done -by the <literal>widget</literal>, <literal>widget_class</literal>, -and <literal>class</literal> declarations. As an example -of such a statement: -<programlisting> -widget "mywindow.*.GtkEntry" style "my-entry-class" -</programlisting> -attaches the style <literal>"my-entry-class"</literal> -to all widgets whose <firstterm>widget class</firstterm> -matches the <firstterm>pattern</firstterm> -<literal>"mywindow.*.GtkEntry"</literal>. -</para> -<para> -The patterns here are given in the standard shell glob -syntax. The <literal>"?"</literal> wildcard matches -any character, while <literal>"*"</literal> matches -zero or more of any character. The three types of -matching are against the widget path, the -<firstterm>class path</firstterm> and the class -heirarchy. Both the widget and the class paths consists of a -<literal>"."</literal> separated list of all the -parents of the widget and the widget itself from -outermost to innermost. The difference is that in -the widget path, the name assigned by -<function>gtk_widget_set_name()</function> is used -if present, otherwise the class name of the widget, while -for the widget path, the class name is always used. -</para> -<para> -So, if you have a <classname>GtkEntry</classname> named -<literal>"myentry"</literal>, inside of a of a window -named <literal>"mywindow"</literal>, then the -widget path is: -<programlisting> -"mwindow.GtkHBox.myentry" -</programlisting> -while the class path is: -<programlisting> -"GtkWindow.GtkHBox.GtkEntry" -</programlisting> -</para> -<para> -Matching against class is a little different. The pattern -match is done against all class names in the widgets -class heirarchy (not the layout heirarchy) in sequence, so the -pattern: -<programlisting> -class "GtkButton" style "my-style" -</programlisting> -will match not just <classname>GtkButton</classname> widgets, -but also <classname>GtkToggleButton</classname> and -<classname>GtkCheckButton</classname> widgets, since -those classes derive from <classname>GtkButton</classname>. -</para> -</refsect2> - -<refsect2><title>Toplevel declarations</title> -<para> -An RC file is a text file which is composed of a sequence -of declarations. '#' characters delimit comments and -the portion of a line after a '#' is ignored when parsing -an RC file. -</para> - -<para> -The possible toplevel declarations are: - -<variablelist> - <varlistentry> - <term><literal>binding <replaceable>name</replaceable> - { ... }</literal></term> - <listitem> - <para>Declare a binding set</para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>class <replaceable>pattern</replaceable> - [ style | binding [ : <replaceable>priority</replaceable> ]] - <replaceable>name</replaceable></literal></term> - <listitem> - <para>Specify a style or binding set for a particular - branch of the inheritance heirarchy.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>include <replaceable>filename</replaceable></literal></term> - <listitem> - <para>Parse another file at this point</para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>module_path <replaceable>path></replaceable></literal></term> - <listitem> - <para>Sets a path (a list of directories separated - by colons) that will be searched for theme engines referenced in - RC files.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>pixmap_path <replaceable>path></replaceable></literal></term> - <listitem> - <para>Sets a path (a list of directories separated - by colons) that will be searched for pixmaps referenced in - RC files.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>style <replaceable>name</replaceable> [ = - <replaceable>parent</replaceable> ] { ... }</literal></term> - <listitem> - <para>Declare a style</para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>widget <replaceable>pattern</replaceable> - [ style | binding [ : <replaceable>priority</replaceable> ]] - <replaceable>name</replaceable></literal></term> - <listitem> - <para>Specify a style or binding set for a particular - group of widgets by matching on the widget pathname.</para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>widget_class <replaceable>pattern</replaceable> - [ style | binding [ : <replaceable>priority</replaceable> ]] - <replaceable>name</replaceable></literal></term> - <listitem> - <para>Specify a style or binding set for a particular - group of widgets by matching on the class pathname.</para> - </listitem> - </varlistentry> -</variablelist> -</para> -</refsect2> - -<refsect2><title>Styles</title> -<para> -A RC style is specified by a <literal>style</literal> -declaration in a RC file, and then bound to widgets -with a <literal>widget</literal>, <literal>widget_class</literal>, -or <literal>class</literal> declaration. All styles -applying to a particular widget are composited together -with <literal>widget</literal> declarations overriding -<literal>widget_class</literal> declarations which, in -turn, override <literal>widget</literal> declarations. -Within each type of declaration, later declarations override -earlier ones. -</para> - -<para> -Within a <literal>style</literal> declaration, the possible -elements are: - -<variablelist> - <varlistentry> - <term><literal>bg[<replaceable>state</replaceable>] = - <replaceable>color</replaceable></literal></term> - <listitem> - <para> - Set color used for the background of most widgets. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>fg[<replaceable>state</replaceable>] = - <replaceable>color</replaceable></literal></term> - <listitem> - <para> - Set color used for the foreground of most widgets. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>base[<replaceable>state</replaceable>] = - <replaceable>color</replaceable></literal></term> - <listitem> - <para> - Set color used for the background of widgets displaying - editable text. This color is used for the background - of, among others, #GtkText, #GtkEntry, #GtkList, and #GtkClist. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>text[<replaceable>state</replaceable>] = - <replaceable>color</replaceable></literal></term> - <listitem> - <para> - Set color used for foreground of widgets using - <literal>base</literal> for the background color. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>bg_text[<replaceable>state</replaceable>] = - <replaceable>color</replaceable></literal></term> - <listitem> - <para> - Set a background pixmap to be used in place of - the <literal>bg</literal> color (or for #GtkText, - in place of the <literal>base</literal> color. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>font = <replaceable>font</replaceable></literal></term> - <listitem> - <para> - Set the font for a widget. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>fontset = <replaceable>font</replaceable></literal></term> - <listitem> - <para> - Set the fontset for a widget. Overrides any - <literal>font</literal> declarations. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>stock[<replaceable>"stock-id"</replaceable>] = { <replaceable>icon source specifications</replaceable> }</literal></term> - <listitem> - <para> - Defines the icon for a stock item. - </para> - </listitem> - </varlistentry> -</variablelist> -</para> -<para> -The colors and background pixmaps are specified as a function of the -state of the widget. The states are: - -<variablelist> - <varlistentry> - <term><literal>NORMAL</literal></term> - <listitem> - <para> - A color used for a widget in its normal state - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>ACTIVE</literal></term> - <listitem> - <para> - A variant of the <literal>NORMAL</literal> color used when the - widget is in the %GTK_STATE_ACTIVE state, and also for - the trough of a ScrollBar, tabs of a NoteBook - other than the current tab and similar areas. - Frequently, this should be a darker variant - of the <literal>NORMAL</literal> color. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>PRELIGHT</literal></term> - <listitem> - <para> - A color used for widgets in the %GTK_STATE_PRELIGHT state. This - state is the used for Buttons and MenuItems - that have the mouse cursor over them, and for - their children. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>SELECTED</literal></term> - <listitem> - <para> - A color used to highlight data selected by the user. - for instance, the selected ListItems in a List widget, and the - selection in an Editable widget. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><literal>INSENSITIVE</literal></term> - <listitem> - <para> - A color used for the background of widgets that have - been set insensitive with gtk_widget_set_sensitive() - </para> - </listitem> - </varlistentry> -</variablelist> -</para> - -<para> -Colors can be specified as a string <literal>"&hash;rrrrggggbbbb"</literal>, -<literal>"&hash;rrrgggbbb"</literal>, <literal>"&hash;rrggbb"</literal>, -or <literal>"&hash;rgb"</literal>, where <literal>r</literal> -<literal>g</literal>, and <literal>b</literal> are -hex digits, or they can be specified as a triplet of floats -<literal>{ <replaceable>r</replaceable>, <replaceable>g</replaceable>, -<replaceable>b</replaceable>}</literal>. -</para> - -<para> -In a <literal>stock</literal> definition, icon sources are specified as a -4-tuple of image filename, text direction, widget state, and size, in that -order. Each icon source specifies an image filename to use with a given -direction, state, and size. The <literal>*</literal> character can be used as a -wildcard, and if direction/state/size are omitted they default to -<literal>*</literal>. So for example, the following specifies different icons to -use for left-to-right and right-to-left languages: -<programlisting> -stock["my-stock-item"] = -{ - { "itemltr.png", LTR, *, * }, - { "itemrtl.png", RTL, *, * } -} -</programlisting> -This could be abbreviated as follows: -<programlisting> -stock["my-stock-item"] = -{ - { "itemltr.png", LTR }, - { "itemrtl.png", RTL } -} -</programlisting> -</para> - -<para> -You can specify custom icons for specific sizes, as follows: -<programlisting> -stock["my-stock-item"] = -{ - { "itemmenusize.png", *, *, "gtk-menu" }, - { "itemtoolbarsize.png", *, *, "gtk-large-toolbar" } - { "itemgeneric.png" } /* implicit *, *, * as a fallback */ -} -</programlisting> -The sizes that come with GTK+ itself are <literal>"gtk-menu"</literal>, -<literal>"gtk-small-toolbar"</literal>, <literal>"gtk-large-toolbar"</literal>, -<literal>"gtk-button"</literal>, <literal>"gtk-dialog"</literal>. Applications -can define other sizes. -</para> - -<para> -It's also possible to use custom icons for a given state, for example: -You can specify custom icons for specific sizes, as follows: -<programlisting> -stock["my-stock-item"] = -{ - { "itemprelight.png", *, PRELIGHT }, - { "iteminsensitive.png", *, INSENSITIVE }, - { "itemgeneric.png" } /* implicit *, *, * as a fallback */ -} -</programlisting> -</para> - -<para> -When selecting an icon source to use, GTK+ will consider text direction most -important, state second, and size third. It will select the best match based on -those criteria. If an attribute matches exactly (e.g. you specified -<literal>PRELIGHT</literal> or specified the size), GTK+ won't modify the image; -if the attribute matches with a wildcard, GTK+ will scale or modify the image to -match the state and size the user requested. -</para> - -</refsect2> - -<refsect2><title>Key bindings</title> -<para> -Key bindings allow the user to specify actions to be -taken on particular key presses. The form of a binding -set declaration is: -</para> - -<programlisting> -binding <replaceable>name</replaceable> { - bind <replaceable>key</replaceable> { - <replaceable>signalname</replaceable> (<replaceable>param</replaceable>, ...) - ... - } - ... -} -</programlisting> - -<para> -<replaceable>key</replaceable> is a string consisting of a -series of modifiers followed by the name of a key. The -modifiers can be: -<simplelist> -<member><literal><alt></literal></member> -<member><literal><control></literal></member> -<member><literal><mod1></literal></member> -<member><literal><mod2></literal></member> -<member><literal><mod3></literal></member> -<member><literal><mod4></literal></member> -<member><literal><mod5></literal></member> -<member><literal><release></literal></member> -<member><literal><shft></literal></member> -<member><literal><shift></literal></member> -</simplelist> -<literal><shft></literal> is an alias for -<literal><shift></literal> and -<literal><alt></literal> is an alias for -<literal><mod1></literal>. -</para> - -<para> -The action that is bound to the key is a sequence -of signal names (strings) followed by parameters for -each signal. The signals must be action signals. -(See gtk_signal_new()). Each parameter can be -a float, integer, string, or unquoted string -representing an enumeration value. The types of -the parameters specified must match the types of the -parameters of the signal. -</para> - -<para> -Binding sets are connected to widgets in the -same manner as styles, with one addition. -A priority can be specified for each pattern, -and within each type of pattern, binding sets -override other binding sets first by priority, -and only then by order of specification. (Later -overrides earlier). The priorities that can -be specified are (highest to lowest): -<simplelist> -<member><literal>HIGHEST</literal></member> -<member><literal>RC</literal></member> -<member><literal>APPLICATION</literal></member> -<member><literal>GTK</literal></member> -<member><literal>LOWEST</literal></member> -</simplelist> -<literal>RC</literal> is the default for bindings -read from an RC file, <literal>APPLICATION</literal> -should be used for bindings an application sets -up, and <literal>GTK</literal> is used for bindings -that GTK+ creates internally. -</para> -</refsect2> - - -<!-- ##### SECTION ./tmpl/gtkrc.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkrc.sgml:Short_Description ##### --> -Routines for handling resource files - - -<!-- ##### SECTION ./tmpl/gtkrc.sgml:Title ##### --> -Resource Files - - -<!-- ##### SECTION ./tmpl/gtkselection.sgml:Long_Description ##### --> - -<para> -The selection mechanism provides the basis for different types -of IPC between processes. In particular, drag and drop and -#GtkClipboard work via selections. You will very seldom or -never need to use most of the functions in this section directly; -#GtkClipboard provides a nicer interface to the same functionality. -</para> -<para> -Some of the datatypes defined this section are used in -the #GtkClipboard and drag-and-drop API's as well. The -#GtkTargetEntry structure and #GtkTargetList objects represent -lists of data types that are supported when sending or -receiving data. The #GtkSelectionData object is used to -store a chunk of data along with the data type and other -associated information. -</para> - - -<!-- ##### SECTION ./tmpl/gtkselection.sgml:See_Also ##### --> -<para> -<variablelist> - -<varlistentry> -<term>#GtkWidget</term> -<listitem><para>Much of the operation of selections happens via - signals for #GtkWidget. In particular, if you are - using the functions in this section, you may need - to pay attention to ::selection_get, - ::selection_received, and :selection_clear_event - signals.</para></listitem> -</varlistentry> - -</variablelist> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkselection.sgml:Short_Description ##### --> -Functions for handling inter-process communication via selections. - - -<!-- ##### SECTION ./tmpl/gtkselection.sgml:Title ##### --> -Selections - - -<!-- ##### SECTION ./tmpl/gtksignal.sgml:Long_Description ##### --> -<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 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_return_value__parameter_list() -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 ./tmpl/gtksignal.sgml:See_Also ##### --> -<para> -<variablelist> - -<varlistentry> -<term>#GtkObject</term> -<listitem><para>The base class for things which emit signals.</para></listitem> -</varlistentry> - -</variablelist> -</para> - - -<!-- ##### SECTION ./tmpl/gtksignal.sgml:Short_Description ##### --> -Object methods and callbacks. - - -<!-- ##### SECTION ./tmpl/gtksignal.sgml:Title ##### --> -Signals - - -<!-- ##### SECTION ./tmpl/gtkstock.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkstock.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkstock.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkstock.sgml:Title ##### --> -Stock Items - - -<!-- ##### SECTION ./tmpl/gtkstyle.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkstyle.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkstyle.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkstyle.sgml:Title ##### --> -Styles - - -<!-- ##### SECTION ./tmpl/gtkthemes.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkthemes.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkthemes.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkthemes.sgml:Title ##### --> -Themes - - -<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtktreemodelsimple.sgml:Title ##### --> -GtkModelSimple - - -<!-- ##### SECTION ./tmpl/gtktreeview.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtktreeview.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtktreeview.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtktreeview.sgml:Title ##### --> -GtkTreeView - - -<!-- ##### SECTION ./tmpl/gtktypeutils.sgml:Long_Description ##### --> -<para> -Gtk's type system is extensible. Because of that, types have to be -managed at runtime. -</para> - - -<!-- ##### SECTION ./tmpl/gtktypeutils.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtktypeutils.sgml:Short_Description ##### --> -Handle run-time type creation. - - -<!-- ##### SECTION ./tmpl/gtktypeutils.sgml:Title ##### --> -Types - - -<!-- ##### SECTION ./tmpl/gtkvbbox.sgml:Long_Description ##### --> -<para> -A button box should be used to provide a consistent layout of buttons -throughout your application. There is one default layout and a default -spacing value that are persistant across all #VButtonBox widgets. -</para> -<para> -The layout/spacing can then be altered by the programmer, or if desired, by -the user to alter the 'feel' of a program to a small degree. -</para> -<para> -A #VButtonBox is created with gtk_vbutton_box_new(). Buttons are packed into -a button box the same way as any other box, using gtk_box_pack_start() or -gtk_box_pack_end(). -</para> -<para> -The default spacing between buttons can be set with -gtk_vbutton_box_set_spacing_default() and queried with -gtk_vbutton_box_get_spacing_default(). -</para> -<para> -The arrangement and layout of the buttons can be changed using -gtk_vbutton_box_set_layout_default() and queried with -gtk_vbutton_box_get_layout_default(). -</para> - - -<!-- ##### SECTION ./tmpl/gtkvbbox.sgml:See_Also ##### --> -<para> -<variablelist> -<varlistentry> -<term>#GtkBox</term> -<listitem><para>Used to pack widgets into button boxes.</para></listitem> -</varlistentry><varlistentry> -<term>#GtkButtonBox</term> -<listitem><para>Provides functions for controlling button boxes.</para></listitem> -</varlistentry> -<varlistentry> -<term>#GtkHButtonBox</term> -<listitem><para>Pack buttons horizontally.</para></listitem> -</varlistentry> -</variablelist> -</para> - - -<!-- ##### SECTION ./tmpl/gtkvbbox.sgml:Short_Description ##### --> -a container for arranging buttons vertically. - - -<!-- ##### SECTION ./tmpl/gtkvbbox.sgml:Title ##### --> -GtkVButtonBox - - -<!-- ##### SECTION ./tmpl/gtkvbox.sgml:Long_Description ##### --> -<para> -GtkVBox is a container that organizes child widgets into a single column. -</para> - -<para> -Use the #GtkBox packing interface to determine the arrangement, -spacing, height, and alignment of GtkVBox children. -</para> - -<para> -All children are allocated the same width. -</para> - - -<!-- ##### SECTION ./tmpl/gtkvbox.sgml:See_Also ##### --> -<para> -<variablelist> - -<varlistentry> -<term>#GtkHBox</term> -<listitem><para>a sister class that organizes widgets into a row.</para></listitem> -</varlistentry> - -</variablelist> -</para> - - -<!-- ##### SECTION ./tmpl/gtkvbox.sgml:Short_Description ##### --> -vertical container box - - -<!-- ##### SECTION ./tmpl/gtkvbox.sgml:Title ##### --> -GtkVBox - - -<!-- ##### SECTION ./tmpl/gtkviewport.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkviewport.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkviewport.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkviewport.sgml:Title ##### --> -GtkViewport - - -<!-- ##### SECTION ./tmpl/gtkvpaned.sgml:Long_Description ##### --> -<para> -The VPaned widget is a container widget with two -children arranged vertically. The division between -the two panes is adjustable by the user by dragging -a handle. See #GtkPaned for details. -</para> - - -<!-- ##### SECTION ./tmpl/gtkvpaned.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkvpaned.sgml:Short_Description ##### --> -A container with two panes arranged vertically. - - -<!-- ##### SECTION ./tmpl/gtkvpaned.sgml:Title ##### --> -GtkVPaned - - -<!-- ##### SECTION ./tmpl/gtkvruler.sgml:Long_Description ##### --> -<para> - NOTE this widget is considered too specialized/little-used for - GTK+, and will in the future be moved to some other package. If - your application needs this widget, feel free to use it, as the - widget does work and is useful in some applications; it's just not - of general interest. However, we are not accepting new features for - the widget, and it will eventually move out of the GTK+ - distribution. -</para> -<para> -The VRuler widget is a widget arranged vertically creating a ruler that is -utilized around other widgets such as a text widget. The ruler is used to show -the location of the mouse on the window and to show the size of the window in -specified units. The available units of measurement are GTK_PIXELS, GTK_INCHES -and GTK_CENTIMETERS. GTK_PIXELS is the default. -rulers. -</para> - - -<!-- ##### SECTION ./tmpl/gtkvruler.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkvruler.sgml:Short_Description ##### --> -A vertical ruler. - - -<!-- ##### SECTION ./tmpl/gtkvruler.sgml:Title ##### --> -GtkVRuler - - -<!-- ##### SECTION ./tmpl/gtkvscale.sgml:Long_Description ##### --> -<para> -The #GtkVScale widget is used to allow the user to select a value using -a vertical slider. -A #GtkAdjustment is used to set the initial value, the lower -and upper bounds, and the step and page increments. -</para> -<para> -The position to show the current value, and the number of decimal places -shown can be set using the parent #GtkScale class's functions. -</para> - - -<!-- ##### SECTION ./tmpl/gtkvscale.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkvscale.sgml:Short_Description ##### --> -a vertical slider widget for selecting a value from a range. - - -<!-- ##### SECTION ./tmpl/gtkvscale.sgml:Title ##### --> -GtkVScale - - -<!-- ##### SECTION ./tmpl/gtkvscrollbar.sgml:Long_Description ##### --> -<para> -The VScrollbar widget is a widget arranged vertically creating a scroll bar. See -#GtkScrollbar for details on scrollbars. #GtkAdjustment pointers may be added to -handle the adjustment of the scrollbars or it may be left NULL in which case one -will be created you. See #GtkAdjustment for details. -</para> - - -<!-- ##### SECTION ./tmpl/gtkvscrollbar.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkvscrollbar.sgml:Short_Description ##### --> -A vertical scrollbar - - -<!-- ##### SECTION ./tmpl/gtkvscrollbar.sgml:Title ##### --> -GtkVScrollbar - - -<!-- ##### SECTION ./tmpl/gtkvseparator.sgml:Long_Description ##### --> -<para> -The #GtkVSeparator widget is a vertical separator, used to group the -widgets within a window. It displays a vertical line with a shadow to -make it appear sunken into the interface. -</para> - - -<!-- ##### SECTION ./tmpl/gtkvseparator.sgml:See_Also ##### --> -<para> -<variablelist> -<varlistentry> -<term>#GtkHSeparator</term> -<listitem><para>a horizontal separator.</para></listitem> -</varlistentry> -</variablelist> -</para> - - -<!-- ##### SECTION ./tmpl/gtkvseparator.sgml:Short_Description ##### --> -a vertical separator. - - -<!-- ##### SECTION ./tmpl/gtkvseparator.sgml:Title ##### --> -GtkVSeparator - - -<!-- ##### SECTION ./tmpl/gtkwidget.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkwidget.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkwidget.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkwidget.sgml:Title ##### --> -GtkWidget - - -<!-- ##### SECTION ./tmpl/gtkwindow.sgml:Long_Description ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkwindow.sgml:See_Also ##### --> -<para> - -</para> - - -<!-- ##### SECTION ./tmpl/gtkwindow.sgml:Short_Description ##### --> - - - -<!-- ##### SECTION ./tmpl/gtkwindow.sgml:Title ##### --> -GtkWindow - - <!-- ##### MACRO GTK_CLIST_CHILD_HAS_FOCUS ##### --> <para> A macro to check whether a child widget of the CList @@ -1777,27 +110,6 @@ has the focus. @clist: The #GtkCList widget to check. -<!-- ##### MACRO GTK_CONTAINER_RESIZE_PENDING ##### --> -<para> - -</para> - -@obj: - -<!-- ##### MACRO GTK_MAX_COMPOSE_LEN ##### --> -<para> - -</para> - - -<!-- ##### MACRO GTK_NOTE ##### --> -<para> - -</para> - -@type: -@action: - <!-- ##### MACRO GTK_OBJECT_CONSTRUCTED ##### --> <para> Test whether a GtkObject's arguments have been prepared. @@ -1819,29 +131,6 @@ Get the array of signals defined for this object. @obj: the object to fetch the signals from. -<!-- ##### MACRO GTK_PRIVATE_FLAGS ##### --> -<para> - -</para> - -@wid: - -<!-- ##### MACRO GTK_PRIVATE_SET_FLAG ##### --> -<para> - -</para> - -@wid: -@flag: - -<!-- ##### MACRO GTK_PRIVATE_UNSET_FLAG ##### --> -<para> - -</para> - -@wid: -@flag: - <!-- ##### MACRO GTK_TREE_SELECTION ##### --> <para> A macro that returns a GList that contains the selection of the root tree of @obj. @@ -1928,81 +217,6 @@ Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN @a: -<!-- ##### MACRO GTK_WIDGET_HAS_SHAPE_MASK ##### --> -<para> - -</para> - -@obj: - -<!-- ##### MACRO GTK_WIDGET_IN_REPARENT ##### --> -<para> - -</para> - -@obj: - -<!-- ##### MACRO GTK_WIDGET_IS_OFFSCREEN ##### --> -<para> - -</para> - -@obj: - -<!-- ##### MACRO GTK_WIDGET_LEAVE_PENDING ##### --> -<para> - -</para> - -@obj: - -<!-- ##### MACRO GTK_WIDGET_REDRAW_PENDING ##### --> -<para> - -</para> - -@obj: - -<!-- ##### MACRO GTK_WIDGET_RESIZE_NEEDED ##### --> -<para> - -</para> - -@obj: - -<!-- ##### MACRO GTK_WIDGET_USER_STYLE ##### --> -<para> - -</para> - -@obj: - -<!-- ##### ENUM GtkCellRendererType ##### --> -<para> - -</para> - -@GTK_CELL_RENDERER_SELECTED: -@GTK_CELL_RENDERER_PRELIT: -@GTK_CELL_RENDERER_INSENSITIVE: - -<!-- ##### ENUM GtkDebugFlag ##### --> -<para> - -</para> - -@GTK_DEBUG_OBJECTS: -@GTK_DEBUG_MISC: -@GTK_DEBUG_SIGNALS: -@GTK_DEBUG_DND: -@GTK_DEBUG_PLUGSOCKET: - -<!-- ##### STRUCT GtkDialogButton ##### --> -<para> -Deprecated. -</para> - - <!-- ##### SIGNAL GtkEditable::activate ##### --> <para> Indicates that the user has activated the widget @@ -2215,67 +429,6 @@ gtk_font_selection_set_filter(). @tentative_match: @tentative_match_len: -<!-- ##### STRUCT GtkLabelWord ##### --> -<para>
-Internal to #GtkLabel.
-</para> - - -<!-- ##### USER_FUNCTION GtkMenuCallback ##### --> -<para> - -</para> - -@widget: -@user_data: - -<!-- ##### STRUCT GtkMenuEntry ##### --> -<para> - -</para> - -@path: -@accelerator: -@callback: -@callback_data: -@widget: - -<!-- ##### STRUCT GtkMenuFactory ##### --> -<para> - -</para> - -@path: -@type: -@accel_group: -@widget: -@subfactories: - -<!-- ##### ENUM GtkMenuFactoryType ##### --> -<para> - -</para> - -@GTK_MENU_FACTORY_MENU: -@GTK_MENU_FACTORY_MENU_BAR: -@GTK_MENU_FACTORY_OPTION_MENU: - -<!-- ##### STRUCT GtkMenuPath ##### --> -<para> - -</para> - -@path: -@widget: - -<!-- ##### STRUCT GtkModelSimple ##### --> -<para> - -</para> - -@parent: -@stamp: - <!-- ##### ARG GtkObject:object-signal ##### --> <para> Setting this with a GtkType of GTK_TYPE_SIGNAL connects @@ -2391,34 +544,6 @@ Holds the data for a statusbar message. <structfield>text</structfield> holds th @context_id: @message_id: -<!-- ##### STRUCT GtkTextBTree ##### --> -<para> - -</para> - - -<!-- ##### SIGNAL GtkTextBuffer::delete-text ##### --> -<para> - -</para> - -@textbuffer: the object which received the signal. -@arg1: -@arg2: -@arg3: - -<!-- ##### STRUCT GtkTextTabArray ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkTextTag:font-set ##### --> -<para> - -</para> - - <!-- ##### ARG GtkTextTag:justify ##### --> <para> A #GtkJustification for the text. This is only used when the tag is @@ -2426,12 +551,6 @@ applied to the first character in a paragraph. </para> -<!-- ##### ARG GtkTextTag:justify-set ##### --> -<para> - -</para> - - <!-- ##### ARG GtkTextTag:left-wrapped-line-margin ##### --> <para> Pixel width of the left margin of the text for lines after the first @@ -2452,413 +571,6 @@ produce superscript and subscript. </para> -<!-- ##### ARG GtkTextTag:offset-set ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkTextTag:overstrike ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkTextTag:overstrike-set ##### --> -<para> - -</para> - - -<!-- ##### SIGNAL GtkTextView::copy-text ##### --> -<para> - -</para> - -@textview: the object which received the signal. - -<!-- ##### SIGNAL GtkTextView::cut-text ##### --> -<para> - -</para> - -@textview: the object which received the signal. - -<!-- ##### SIGNAL GtkTextView::delete ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: -@arg2: - -<!-- ##### SIGNAL GtkTextView::delete-at-cursor ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: -@arg2: - -<!-- ##### SIGNAL GtkTextView::delete-text ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: -@arg2: - -<!-- ##### SIGNAL GtkTextView::insert ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: - -<!-- ##### SIGNAL GtkTextView::move ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: -@arg2: -@arg3: - -<!-- ##### SIGNAL GtkTextView::move-insert ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: -@arg2: -@arg3: - -<!-- ##### SIGNAL GtkTextView::paste-text ##### --> -<para> - -</para> - -@textview: the object which received the signal. - -<!-- ##### SIGNAL GtkTextView::scroll-text ##### --> -<para> - -</para> - -@textview: the object which received the signal. -@arg1: - -<!-- ##### ENUM GtkTextViewDeleteType ##### --> -<para> - -</para> - -@GTK_TEXT_DELETE_CHAR: -@GTK_TEXT_DELETE_HALF_WORD: -@GTK_TEXT_DELETE_WHOLE_WORD: -@GTK_TEXT_DELETE_HALF_WRAPPED_LINE: -@GTK_TEXT_DELETE_WHOLE_WRAPPED_LINE: -@GTK_TEXT_DELETE_HALF_LINE: -@GTK_TEXT_DELETE_WHOLE_LINE: -@GTK_TEXT_DELETE_WHITESPACE: -@GTK_TEXT_DELETE_WHITESPACE_LEAVE_ONE: - -<!-- ##### ENUM GtkTextViewMovementStep ##### --> -<para> - -</para> - -@GTK_TEXT_MOVEMENT_CHAR: -@GTK_TEXT_MOVEMENT_POSITIONS: -@GTK_TEXT_MOVEMENT_WORD: -@GTK_TEXT_MOVEMENT_WRAPPED_LINE: -@GTK_TEXT_MOVEMENT_LINE: -@GTK_TEXT_MOVEMENT_LINE_ENDS: -@GTK_TEXT_MOVEMENT_BUFFER_ENDS: - -<!-- ##### ENUM GtkTextViewScrollType ##### --> -<para> - -</para> - -@GTK_TEXT_SCROLL_TO_TOP: -@GTK_TEXT_SCROLL_TO_BOTTOM: -@GTK_TEXT_SCROLL_PAGE_DOWN: -@GTK_TEXT_SCROLL_PAGE_UP: - -<!-- ##### STRUCT GtkThemeEngine ##### --> -<para> - -</para> - - -<!-- ##### ENUM GtkTreeSelectionType ##### --> -<para> - -</para> - -@GTK_TREE_SELECTION_SINGLE: -@GTK_TREE_SELECTION_MULTI: - -<!-- ##### ENUM GtkTreeViewColumnType ##### --> -<para> - -</para> - -@GTK_TREE_VIEW_COLUMN_RESIZEABLE: -@GTK_TREE_VIEW_COLUMN_AUTOSIZE: -@GTK_TREE_VIEW_COLUMN_FIXED: - -<!-- ##### STRUCT GtkTreeViewPrivate ##### --> -<para> - -</para> - -@model: -@flags: -@tree: -@tab_offset: -@button_pressed_node: -@button_pressed_tree: -@children: -@width: -@height: -@hadjustment: -@vadjustment: -@bin_window: -@header_window: -@anchor: -@cursor: -@cursor_drag: -@xor_gc: -@drag_pos: -@x_drag: -@prelight_node: -@prelight_tree: -@prelight_offset: -@selection: -@columns: -@column: -@header_height: - -<!-- ##### STRUCT GtkTypeQuery ##### --> -<para> -A structure used to return values from @gtk_type_query. -</para> - -@type: -@type_name: -@object_size: -@class_size: - -<!-- ##### ARG GtkVScale:adjustment ##### --> -<para> -the #GtkAdjustment which sets the range of the scale. -</para> - - -<!-- ##### ARG GtkVScrollbar:adjustment ##### --> -<para> - -</para> - - -<!-- ##### SIGNAL GtkViewport::set-scroll-adjustments ##### --> -<para> - -</para> - -@viewport: the object which received the signal. -@arg1: -@arg2: - -<!-- ##### ARG GtkViewport:hadjustment ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkViewport:shadow-type ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkViewport:vadjustment ##### --> -<para> - -</para> - - -<!-- ##### SIGNAL GtkWidget::add-accelerator ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@accel_signal_id: -@accel_group: -@accel_key: -@accel_mods: -@accel_flags: - -<!-- ##### SIGNAL GtkWidget::button-press-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::button-release-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::client-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::configure-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::debug-msg ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@message: - -<!-- ##### SIGNAL GtkWidget::delete-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::destroy-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::direction-changed ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@arg1: - -<!-- ##### SIGNAL GtkWidget::drag-begin ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@drag_context: - -<!-- ##### SIGNAL GtkWidget::drag-data-delete ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@drag_context: - -<!-- ##### SIGNAL GtkWidget::drag-data-get ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@drag_context: -@data: -@info: -@time: - -<!-- ##### SIGNAL GtkWidget::drag-data-received ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@drag_context: -@x: -@y: -@data: -@info: -@time: - -<!-- ##### SIGNAL GtkWidget::drag-drop ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@drag_context: -@x: -@y: -@time: -@Returns: - -<!-- ##### SIGNAL GtkWidget::drag-end ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@drag_context: - -<!-- ##### SIGNAL GtkWidget::drag-leave ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@drag_context: -@time: - -<!-- ##### SIGNAL GtkWidget::drag-motion ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@drag_context: -@x: -@y: -@time: -@Returns: - <!-- ##### SIGNAL GtkWidget::draw ##### --> <para> @@ -2881,509 +593,6 @@ the #GtkAdjustment which sets the range of the scale. @widget: the object which received the signal. -<!-- ##### SIGNAL GtkWidget::enter-notify-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::expose-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::focus-in-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::focus-out-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::grab-focus ##### --> -<para> - -</para> - -@widget: the object which received the signal. - -<!-- ##### SIGNAL GtkWidget::hide ##### --> -<para> - -</para> - -@widget: the object which received the signal. - -<!-- ##### SIGNAL GtkWidget::key-press-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::key-release-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::leave-notify-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::map ##### --> -<para> - -</para> - -@widget: the object which received the signal. - -<!-- ##### SIGNAL GtkWidget::map-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::motion-notify-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::no-expose-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::parent-set ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@old_parent: - -<!-- ##### SIGNAL GtkWidget::property-notify-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::proximity-in-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::proximity-out-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::realize ##### --> -<para> - -</para> - -@widget: the object which received the signal. - -<!-- ##### SIGNAL GtkWidget::remove-accelerator ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@accel_group: -@accel_key: -@accel_mods: - -<!-- ##### SIGNAL GtkWidget::scroll-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::selection-clear-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::selection-get ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@data: -@info: -@time: - -<!-- ##### SIGNAL GtkWidget::selection-notify-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::selection-received ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@data: -@time: - -<!-- ##### SIGNAL GtkWidget::selection-request-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::show ##### --> -<para> - -</para> - -@widget: the object which received the signal. - -<!-- ##### SIGNAL GtkWidget::size-allocate ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@allocation: - -<!-- ##### SIGNAL GtkWidget::size-request ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@requisition: - -<!-- ##### SIGNAL GtkWidget::state-changed ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@state: - -<!-- ##### SIGNAL GtkWidget::style-set ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@previous_style: - -<!-- ##### SIGNAL GtkWidget::unmap ##### --> -<para> - -</para> - -@widget: the object which received the signal. - -<!-- ##### SIGNAL GtkWidget::unmap-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWidget::unrealize ##### --> -<para> - -</para> - -@widget: the object which received the signal. - -<!-- ##### SIGNAL GtkWidget::visibility-notify-event ##### --> -<para> - -</para> - -@widget: the object which received the signal. -@event: -@Returns: - -<!-- ##### ARG GtkWidget:app-paintable ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:can-default ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:can-focus ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:composite-child ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:events ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:extension-events ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:has-default ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:has-focus ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:height ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:name ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:parent ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:receives-default ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:sensitive ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:style ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:visible ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:width ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:x ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWidget:y ##### --> -<para> - -</para> - - -<!-- ##### SIGNAL GtkWindow::frame-event ##### --> -<para> - -</para> - -@window: the object which received the signal. -@event: -@Returns: - -<!-- ##### SIGNAL GtkWindow::set-focus ##### --> -<para> - -</para> - -@window: the object which received the signal. -@widget: - -<!-- ##### ARG GtkWindow:allow-grow ##### --> -<para> -If the window can be resized to a larger size by the user. -</para> - - -<!-- ##### ARG GtkWindow:allow-shrink ##### --> -<para> -If the window can be resized to a smaller size by the user. -</para> - - -<!-- ##### ARG GtkWindow:auto-shrink ##### --> -<para> -If the window shrinks automatically when widgets within it shrink. -</para> - - -<!-- ##### ARG GtkWindow:default-height ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWindow:default-width ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWindow:destroy-with-parent ##### --> -<para> - -</para> - - -<!-- ##### ARG GtkWindow:modal ##### --> -<para> -If the window is modal, i.e. it grabs all GTK+ events. -</para> - - -<!-- ##### ARG GtkWindow:title ##### --> -<para> -The title of the window. -</para> - - -<!-- ##### ARG GtkWindow:type ##### --> -<para> -The type of the window. -</para> - - -<!-- ##### ARG GtkWindow:window-position ##### --> -<para> -The position of the window. -</para> - - -<!-- ##### FUNCTION gtk_accel_group_marshal_add ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_accel_group_marshal_remove ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - <!-- ##### FUNCTION gtk_clist_construct ##### --> <para> Initializes a previously allocated #GtkCList widget for use. This should not @@ -3409,27 +618,6 @@ the gtk_color_selection_get_color() function. @use_opacity: a boolean indicating whether the opacity selection is enabled. -<!-- ##### FUNCTION gtk_container_get_toplevels ##### --> -<para> - -</para> - -@Returns: - -<!-- ##### FUNCTION gtk_container_register_toplevel ##### --> -<para> - -</para> - -@container: - -<!-- ##### FUNCTION gtk_container_unregister_toplevel ##### --> -<para> - -</para> - -@container: - <!-- ##### FUNCTION gtk_ctree_construct ##### --> <para> This function is not usually used by users. @@ -3440,55 +628,6 @@ This function is not usually used by users. @tree_column: @titles: -<!-- ##### VARIABLE gtk_debug_flags ##### --> -<para> - -</para> - - -<!-- ##### FUNCTION gtk_draw_cross ##### --> -<para> - -</para> - -@style: -@window: -@state_type: -@shadow_type: -@x: -@y: -@width: -@height: - -<!-- ##### FUNCTION gtk_draw_oval ##### --> -<para> - -</para> - -@style: -@window: -@state_type: -@shadow_type: -@x: -@y: -@width: -@height: - -<!-- ##### FUNCTION gtk_draw_ramp ##### --> -<para> - -</para> - -@style: -@window: -@state_type: -@shadow_type: -@arrow_type: -@x: -@y: -@width: -@height: - <!-- ##### FUNCTION gtk_editable_changed ##### --> <para> Causes the "changed" signal to be emitted. @@ -3555,13 +694,6 @@ will be shown, or NULL to show all spacings. @charsets: a NULL-terminated array of strings containing charset names which will be shown, or NULL to show all charsets. -<!-- ##### FUNCTION gtk_icon_factory_get_type ##### --> -<para> - -</para> - -@Returns: - <!-- ##### FUNCTION gtk_identifier_get_type ##### --> <para> Get the type of GtkIdentifier. @@ -3569,545 +701,6 @@ Get the type of GtkIdentifier. @Returns: GtkType -- the enumerated type of something. -<!-- ##### FUNCTION gtk_im_context_simple_add_table ##### --> -<para> - -</para> - -@context_simple: -@data: -@max_seq_len: -@n_seqs: - -<!-- ##### FUNCTION gtk_im_context_simple_new ##### --> -<para> - -</para> - -@Returns: - -<!-- ##### FUNCTION gtk_marshal_BOOL__NONE ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_BOOL__POINTER ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_INT_INT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_INT_INT_INT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### MACRO gtk_marshal_BOOL__POINTER_INT_INT_UINT ##### --> -<para> - -</para> - - -<!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_POINTER_INT_INT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_BOOL__POINTER_POINTER_POINTER_POINTER ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### MACRO gtk_marshal_BOOL__POINTER_STRING_STRING_POINTER ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_ENUM__ENUM ##### --> -<para> - -</para> - - -<!-- ##### FUNCTION gtk_marshal_INT__INT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_INT__POINTER ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_INT__POINTER_CHAR_CHAR ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__BOOL ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### MACRO gtk_marshal_NONE__BOXED ##### --> -<para> - -</para> - - -<!-- ##### FUNCTION gtk_marshal_NONE__C_CALLBACK ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__C_CALLBACK_C_CALLBACK ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### MACRO gtk_marshal_NONE__ENUM ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__ENUM_FLOAT ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__ENUM_FLOAT_BOOL ##### --> -<para> - -</para> - - -<!-- ##### FUNCTION gtk_marshal_NONE__INT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__INT_FLOAT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__INT_FLOAT_BOOL ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__INT_INT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__INT_INT_POINTER ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__INT_POINTER ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__INT_POINTER_INT_INT_INT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__INT_POINTER_INT_INT_INT_POINTER ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__NONE ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### MACRO gtk_marshal_NONE__OBJECT ##### --> -<para> - -</para> - - -<!-- ##### FUNCTION gtk_marshal_NONE__POINTER ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT_INT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT_INT_POINTER_INT_INT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### MACRO gtk_marshal_NONE__POINTER_INT_INT_POINTER_UINT_UINT ##### --> -<para> - -</para> - - -<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_INT_POINTER ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_POINTER ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_POINTER_INT_INT ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### FUNCTION gtk_marshal_NONE__POINTER_POINTER_POINTER ##### --> -<para> - -</para> - -@object: -@func: -@func_data: -@args: - -<!-- ##### MACRO gtk_marshal_NONE__POINTER_POINTER_UINT_UINT ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__POINTER_STRING_STRING ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__POINTER_UINT ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__POINTER_UINT_ENUM ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__POINTER_UINT_UINT ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__STRING ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__STRING_INT_POINTER ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__UINT ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__UINT_POINTER_UINT_ENUM_ENUM_POINTER ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__UINT_POINTER_UINT_UINT_ENUM ##### --> -<para> - -</para> - - -<!-- ##### MACRO gtk_marshal_NONE__UINT_STRING ##### --> -<para> - -</para> - - -<!-- ##### FUNCTION gtk_menu_factory_add_entries ##### --> -<para> - -</para> - -@factory: -@entries: -@nentries: - -<!-- ##### FUNCTION gtk_menu_factory_add_subfactory ##### --> -<para> - -</para> - -@factory: -@subfactory: -@path: - -<!-- ##### FUNCTION gtk_menu_factory_destroy ##### --> -<para> - -</para> - -@factory: - -<!-- ##### FUNCTION gtk_menu_factory_find ##### --> -<para> - -</para> - -@factory: -@path: -@Returns: - -<!-- ##### FUNCTION gtk_menu_factory_new ##### --> -<para> - -</para> - -@type: -@Returns: - -<!-- ##### FUNCTION gtk_menu_factory_remove_entries ##### --> -<para> - -</para> - -@factory: -@entries: -@nentries: - -<!-- ##### FUNCTION gtk_menu_factory_remove_paths ##### --> -<para> - -</para> - -@factory: -@paths: -@npaths: - -<!-- ##### FUNCTION gtk_menu_factory_remove_subfactory ##### --> -<para> - -</para> - -@factory: -@subfactory: -@path: - -<!-- ##### FUNCTION gtk_model_simple_new ##### --> -<para> - -</para> - -@Returns: - -<!-- ##### FUNCTION gtk_model_simple_node_changed ##### --> -<para> - -</para> - -@simple: -@path: -@iter: - -<!-- ##### FUNCTION gtk_model_simple_node_child_toggled ##### --> -<para> - -</para> - -@simple: -@path: -@iter: - -<!-- ##### FUNCTION gtk_model_simple_node_deleted ##### --> -<para> - -</para> - -@simple: -@path: -@iter: - -<!-- ##### FUNCTION gtk_model_simple_node_inserted ##### --> -<para> - -</para> - -@simple: -@path: -@iter: - <!-- ##### FUNCTION gtk_object_arg_get ##### --> <para> Private function to get an argument and argument info from an object. @@ -4292,58 +885,6 @@ Set an array of arguments. @args: the desired values, as an array of #GtkArgs (which contain the names, types, and values of the arguments). -<!-- ##### FUNCTION gtk_paint_cross ##### --> -<para> - -</para> - -@style: -@window: -@state_type: -@shadow_type: -@area: -@widget: -@detail: -@x: -@y: -@width: -@height: - -<!-- ##### FUNCTION gtk_paint_oval ##### --> -<para> - -</para> - -@style: -@window: -@state_type: -@shadow_type: -@area: -@widget: -@detail: -@x: -@y: -@width: -@height: - -<!-- ##### FUNCTION gtk_paint_ramp ##### --> -<para> - -</para> - -@style: -@window: -@state_type: -@shadow_type: -@area: -@widget: -@detail: -@arrow_type: -@x: -@y: -@width: -@height: - <!-- ##### FUNCTION gtk_paned_compute_position ##### --> <para> Internal function used by #GtkHPaned and #GtkVPaned @@ -4475,241 +1016,6 @@ isn't a function pointer. May be NULL. @destroy_func: the function to invoke when each hook is destroyed. May be NULL. -<!-- ##### FUNCTION gtk_text_buffer_copy ##### --> -<para> - -</para> - -@buffer: -@time: - -<!-- ##### FUNCTION gtk_text_buffer_cut ##### --> -<para> - -</para> - -@buffer: -@time: -@interactive: -@default_editable: - -<!-- ##### FUNCTION gtk_text_buffer_find_regexp ##### --> -<para> - -</para> - -@buffer: -@regexp: -@start: -@end: -@Returns: - -<!-- ##### FUNCTION gtk_text_buffer_find_string ##### --> -<para> - -</para> - -@buffer: -@iter: -@str: -@start: -@end: -@Returns: - -<!-- ##### FUNCTION gtk_text_buffer_get_clipboard_contents ##### --> -<para> - -</para> - -@buffer: -@Returns: - -<!-- ##### FUNCTION gtk_text_buffer_get_tags ##### --> -<para> - -</para> - -@buffer: -@iter: -@Returns: - -<!-- ##### FUNCTION gtk_text_buffer_insert_pixmap ##### --> -<para> - -</para> - -@buffer: -@iter: -@pixmap: -@mask: - -<!-- ##### FUNCTION gtk_text_buffer_paste_primary_selection ##### --> -<para> - -</para> - -@buffer: -@override_location: -@time: -@interactive: -@default_editable: - -<!-- ##### FUNCTION gtk_text_buffer_set_clipboard_contents ##### --> -<para> - -</para> - -@buffer: -@text: - -<!-- ##### FUNCTION gtk_text_buffer_spew ##### --> -<para> - -</para> - -@buffer: - -<!-- ##### FUNCTION gtk_text_iter_forward_to_newline ##### --> -<para> - -</para> - -@iter: -@Returns: - -<!-- ##### FUNCTION gtk_text_iter_get_pixmap ##### --> -<para> - -</para> - -@iter: -@pixmap: -@mask: -@Returns: - -<!-- ##### FUNCTION gtk_text_iter_in_region ##### --> -<para> - -</para> - -@iter: -@start: -@end: -@Returns: - -<!-- ##### FUNCTION gtk_text_iter_next_char ##### --> -<para> - -</para> - -@iter: -@Returns: - -<!-- ##### FUNCTION gtk_text_iter_prev_char ##### --> -<para> - -</para> - -@iter: -@Returns: - -<!-- ##### FUNCTION gtk_text_mark_deleted ##### --> -<para> - -</para> - -@mark: -@Returns: - -<!-- ##### FUNCTION gtk_text_mark_is_visible ##### --> -<para> - -</para> - -@mark: -@Returns: - -<!-- ##### FUNCTION gtk_text_mark_ref ##### --> -<para> - -</para> - -@mark: -@Returns: - -<!-- ##### FUNCTION gtk_text_mark_unref ##### --> -<para> - -</para> - -@mark: - -<!-- ##### FUNCTION gtk_text_view_get_iter_at_pixel ##### --> -<para> - -</para> - -@text_view: -@iter: -@x: -@y: - -<!-- ##### FUNCTION gtk_theme_engine_create_rc_style ##### --> -<para> - -</para> - -@engine: -@Returns: - -<!-- ##### FUNCTION gtk_theme_engine_get ##### --> -<para> - -</para> - -@name: -@Returns: - -<!-- ##### FUNCTION gtk_theme_engine_ref ##### --> -<para> - -</para> - -@engine: - -<!-- ##### FUNCTION gtk_theme_engine_register_type ##### --> -<para> - -</para> - -@engine: -@parent_type: -@type_name: -@type_info: -@Returns: - -<!-- ##### FUNCTION gtk_theme_engine_unref ##### --> -<para> - -</para> - -@engine: - -<!-- ##### FUNCTION gtk_themes_exit ##### --> -<para> - -</para> - -@error_code: - -<!-- ##### FUNCTION gtk_themes_init ##### --> -<para> - -</para> - -@argc: -@argv: - <!-- ##### FUNCTION gtk_trace_referencing ##### --> <para> Private: print debugging information while doing a gtk_object_ref() or @@ -4722,179 +1028,6 @@ a gtk_object_unref(). @line: line number (used within macros). @do_ref: whether to reference or unreference. -<!-- ##### FUNCTION gtk_tree_model_sort_resort ##### --> -<para> - -</para> - -@tree_model_sort: - -<!-- ##### FUNCTION gtk_tree_model_sort_set_sort_col ##### --> -<para> - -</para> - -@tree_model_sort: -@sort_col: - -<!-- ##### FUNCTION gtk_tree_selection_new ##### --> -<para> - -</para> - -@Returns: - -<!-- ##### FUNCTION gtk_tree_selection_new_with_tree_view ##### --> -<para> - -</para> - -@tree_view: -@Returns: - -<!-- ##### FUNCTION gtk_tree_selection_set_tree_view ##### --> -<para> - -</para> - -@selection: -@tree_view: - -<!-- ##### FUNCTION gtk_tree_selection_set_type ##### --> -<para> - -</para> - -@selection: -@type: - -<!-- ##### FUNCTION gtk_tree_store_get_root_iter ##### --> -<para> - -</para> - -@tree_store: -@iter: - -<!-- ##### FUNCTION gtk_tree_store_getv ##### --> -<para> - -</para> - -@tree_store: -@iter: -@var_args: - -<!-- ##### FUNCTION gtk_tree_store_new_with_values ##### --> -<para> - -</para> - -@n_columns: -@Varargs: -@Returns: - -<!-- ##### FUNCTION gtk_tree_store_setv ##### --> -<para> - -</para> - -@tree_store: -@iter: -@var_args: - -<!-- ##### FUNCTION gtk_tree_view_column_get_col_type ##### --> -<para> - -</para> - -@tree_column: -@Returns: - -<!-- ##### FUNCTION gtk_tree_view_column_get_justification ##### --> -<para> - -</para> - -@tree_column: -@Returns: - -<!-- ##### FUNCTION gtk_tree_view_column_get_size ##### --> -<para> - -</para> - -@tree_column: -@Returns: - -<!-- ##### FUNCTION gtk_tree_view_column_get_title ##### --> -<para> - -</para> - -@tree_column: -@Returns: - -<!-- ##### FUNCTION gtk_tree_view_column_set_col_type ##### --> -<para> - -</para> - -@tree_column: -@type: - -<!-- ##### FUNCTION gtk_tree_view_column_set_header_active ##### --> -<para> - -</para> - -@tree_column: -@active: - -<!-- ##### FUNCTION gtk_tree_view_column_set_header_clickable ##### --> -<para> - -</para> - -@tree_column: -@active: - -<!-- ##### FUNCTION gtk_tree_view_column_set_justification ##### --> -<para> - -</para> - -@tree_column: -@justification: - -<!-- ##### FUNCTION gtk_tree_view_column_set_size ##### --> -<para> - -</para> - -@tree_column: -@size: -@width: - -<!-- ##### FUNCTION gtk_tree_view_move_to ##### --> -<para> - -</para> - -@tree_view: -@path: -@column: -@row_align: -@col_align: - -<!-- ##### FUNCTION gtk_tree_view_set_headers_active ##### --> -<para> - -</para> - -@tree_view: -@active: - <!-- ##### FUNCTION gtk_type_check_class_cast ##### --> <para> Given a GtkTypeClass pointer @klass, and a GtkType @cast_type, make @@ -5009,115 +1142,3 @@ Set the varargs type for a fundamental type @foreign_type. fundamental type. @varargs_type: Must be a GtkType which is either structured or flag, or NONE. -<!-- ##### FUNCTION gtk_widget_get ##### --> -<para> - -</para> - -@widget: -@arg: - -<!-- ##### FUNCTION gtk_widget_getv ##### --> -<para> - -</para> - -@widget: -@nargs: -@args: - -<!-- ##### FUNCTION gtk_widget_newv ##### --> -<para> - -</para> - -@type: -@nargs: -@args: -@Returns: - -<!-- ##### MACRO gtk_widget_pop_visual ##### --> -<para> - -</para> - -@v: - -<!-- ##### MACRO gtk_widget_push_visual ##### --> -<para> - -</para> - -@v: -@visual: - -<!-- ##### FUNCTION gtk_widget_render_stock_icon ##### --> -<para> - -</para> - -@widget: -@stock_id: -@size: -@detail: -@Returns: - -<!-- ##### MACRO gtk_widget_set_default_visual ##### --> -<para> - -</para> - -@v: -@visual: - -<!-- ##### MACRO gtk_widget_set_visual ##### --> -<para> - -</para> - -@w: -@v: -@widget: -@visual: - -<!-- ##### FUNCTION gtk_widget_setv ##### --> -<para> - -</para> - -@widget: -@nargs: -@args: - -<!-- ##### FUNCTION gtk_window_add_embedded_xid ##### --> -<para> - -</para> - -@window: -@xid: - -<!-- ##### FUNCTION gtk_window_remove_embedded_xid ##### --> -<para> - -</para> - -@window: -@xid: - -<!-- ##### FUNCTION gtk_window_set_default ##### --> -<para> - -</para> - -@window: -@defaultw: - -<!-- ##### FUNCTION gtk_window_set_focus ##### --> -<para> - -</para> - -@window: -@focus: - diff --git a/docs/reference/gtk/tmpl/gtkcellrenderer.sgml b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml index cafd4fb01..fc0aa6075 100644 --- a/docs/reference/gtk/tmpl/gtkcellrenderer.sgml +++ b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml @@ -22,6 +22,7 @@ GtkCellRenderer @GTK_CELL_RENDERER_SELECTED: @GTK_CELL_RENDERER_PRELIT: @GTK_CELL_RENDERER_INSENSITIVE: +@GTK_CELL_RENDERER_SORTED: <!-- ##### STRUCT GtkCellRenderer ##### --> <para> diff --git a/docs/reference/gtk/tmpl/gtkcombo.sgml b/docs/reference/gtk/tmpl/gtkcombo.sgml index 7113bbe6e..0e115ea39 100644 --- a/docs/reference/gtk/tmpl/gtkcombo.sgml +++ b/docs/reference/gtk/tmpl/gtkcombo.sgml @@ -202,3 +202,18 @@ instead. @combo: a #GtkCombo. +<!-- ##### ARG GtkCombo:enable-arrow-keys ##### --> +<para> + +</para> + +<!-- ##### ARG GtkCombo:enable-arrows-always ##### --> +<para> + +</para> + +<!-- ##### ARG GtkCombo:case-sensitive ##### --> +<para> + +</para> + diff --git a/docs/reference/gtk/tmpl/gtkentry.sgml b/docs/reference/gtk/tmpl/gtkentry.sgml index 7e5111e1d..f5d0720a0 100644 --- a/docs/reference/gtk/tmpl/gtkentry.sgml +++ b/docs/reference/gtk/tmpl/gtkentry.sgml @@ -295,3 +295,8 @@ are visible or not. See gtk_entry_set_visibility(). </para> +<!-- ##### ARG GtkEntry:activates-default ##### --> +<para> + +</para> + diff --git a/docs/reference/gtk/tmpl/gtkenums.sgml b/docs/reference/gtk/tmpl/gtkenums.sgml index 162f9300b..00419b966 100644 --- a/docs/reference/gtk/tmpl/gtkenums.sgml +++ b/docs/reference/gtk/tmpl/gtkenums.sgml @@ -253,6 +253,14 @@ contains grayscale or red-green-blue data. @GTK_SCROLL_PAGE_BACKWARD: @GTK_SCROLL_PAGE_FORWARD: @GTK_SCROLL_JUMP: +@GTK_SCROLL_STEP_UP: +@GTK_SCROLL_STEP_DOWN: +@GTK_SCROLL_PAGE_UP: +@GTK_SCROLL_PAGE_DOWN: +@GTK_SCROLL_STEP_LEFT: +@GTK_SCROLL_STEP_RIGHT: +@GTK_SCROLL_PAGE_LEFT: +@GTK_SCROLL_PAGE_RIGHT: <!-- ##### ENUM GtkSelectionMode ##### --> <para> diff --git a/docs/reference/gtk/tmpl/gtkrange.sgml b/docs/reference/gtk/tmpl/gtkrange.sgml index 4445609d5..46e45cb64 100644 --- a/docs/reference/gtk/tmpl/gtkrange.sgml +++ b/docs/reference/gtk/tmpl/gtkrange.sgml @@ -47,134 +47,6 @@ GtkRange @adjustment: -<!-- ##### FUNCTION gtk_range_draw_background ##### --> -<para> - -</para> - -@range: - - -<!-- ##### FUNCTION gtk_range_draw_trough ##### --> -<para> - -</para> - -@range: - - -<!-- ##### FUNCTION gtk_range_draw_slider ##### --> -<para> - -</para> - -@range: - - -<!-- ##### FUNCTION gtk_range_draw_step_forw ##### --> -<para> - -</para> - -@range: - - -<!-- ##### FUNCTION gtk_range_draw_step_back ##### --> -<para> - -</para> - -@range: - - -<!-- ##### FUNCTION gtk_range_slider_update ##### --> -<para> - -</para> - -@range: - - -<!-- ##### FUNCTION gtk_range_trough_click ##### --> -<para> - -</para> - -@range: -@x: -@y: -@jump_perc: -@Returns: - - -<!-- ##### FUNCTION gtk_range_default_hslider_update ##### --> -<para> - -</para> - -@range: - - -<!-- ##### FUNCTION gtk_range_default_vslider_update ##### --> -<para> - -</para> - -@range: - - -<!-- ##### FUNCTION gtk_range_default_htrough_click ##### --> -<para> - -</para> - -@range: -@x: -@y: -@jump_perc: -@Returns: - - -<!-- ##### FUNCTION gtk_range_default_vtrough_click ##### --> -<para> - -</para> - -@range: -@x: -@y: -@jump_perc: -@Returns: - - -<!-- ##### FUNCTION gtk_range_default_hmotion ##### --> -<para> - -</para> - -@range: -@xdelta: -@ydelta: - - -<!-- ##### FUNCTION gtk_range_default_vmotion ##### --> -<para> - -</para> - -@range: -@xdelta: -@ydelta: - - -<!-- ##### FUNCTION gtk_range_clear_background ##### --> -<para> - -</para> - -@range: - - <!-- ##### ARG GtkRange:update-policy ##### --> <para> diff --git a/docs/reference/gtk/tmpl/gtksignal.sgml b/docs/reference/gtk/tmpl/gtksignal.sgml index 992da3880..c3696cb03 100644 --- a/docs/reference/gtk/tmpl/gtksignal.sgml +++ b/docs/reference/gtk/tmpl/gtksignal.sgml @@ -244,13 +244,6 @@ to the signal. @GTK_RUN_ACTION: @GTK_RUN_NO_HOOKS: -<!-- ##### MACRO gtk_signal_init ##### --> -<para> - -</para> - - - <!-- ##### FUNCTION gtk_signal_new ##### --> <para> Create a new signal type. (This is usually done in the diff --git a/docs/reference/gtk/tmpl/gtktextbuffer.sgml b/docs/reference/gtk/tmpl/gtktextbuffer.sgml index 980fb9c0f..c9db05262 100644 --- a/docs/reference/gtk/tmpl/gtktextbuffer.sgml +++ b/docs/reference/gtk/tmpl/gtktextbuffer.sgml @@ -455,15 +455,6 @@ types related to the text widget and how they work together. @anchor: -<!-- ##### FUNCTION gtk_text_buffer_get_last_iter ##### --> -<para> - -</para> - -@buffer: -@iter: - - <!-- ##### FUNCTION gtk_text_buffer_get_bounds ##### --> <para> @@ -474,15 +465,6 @@ types related to the text widget and how they work together. @end: -<!-- ##### FUNCTION gtk_text_buffer_modified ##### --> -<para> - -</para> - -@buffer: -@Returns: - - <!-- ##### FUNCTION gtk_text_buffer_set_modified ##### --> <para> @@ -609,6 +591,15 @@ types related to the text widget and how they work together. @textbuffer: the object which received the signal. +<!-- ##### SIGNAL GtkTextBuffer::insert-child-anchor ##### --> +<para> + +</para> + +@textbuffer: the object which received the signal. +@arg1: +@arg2: + <!-- ##### SIGNAL GtkTextBuffer::insert-pixbuf ##### --> <para> diff --git a/docs/reference/gtk/tmpl/gtktextiter.sgml b/docs/reference/gtk/tmpl/gtktextiter.sgml index 522ea9fda..faf5a099e 100644 --- a/docs/reference/gtk/tmpl/gtktextiter.sgml +++ b/docs/reference/gtk/tmpl/gtktextiter.sgml @@ -349,15 +349,6 @@ types related to the text widget and how they work together. @Returns: -<!-- ##### FUNCTION gtk_text_iter_is_last ##### --> -<para> - -</para> - -@iter: -@Returns: - - <!-- ##### FUNCTION gtk_text_iter_is_first ##### --> <para> diff --git a/docs/reference/gtk/tmpl/gtktexttag.sgml b/docs/reference/gtk/tmpl/gtktexttag.sgml index 939af5d93..a138f6333 100644 --- a/docs/reference/gtk/tmpl/gtktexttag.sgml +++ b/docs/reference/gtk/tmpl/gtktexttag.sgml @@ -407,11 +407,6 @@ applies to the first character in a paragraph. </para> -<!-- ##### ARG GtkTextTag:background-gdk-set ##### --> -<para> - -</para> - <!-- ##### ARG GtkTextTag:background-stipple-set ##### --> <para> @@ -422,11 +417,6 @@ applies to the first character in a paragraph. </para> -<!-- ##### ARG GtkTextTag:foreground-gdk-set ##### --> -<para> - -</para> - <!-- ##### ARG GtkTextTag:foreground-stipple-set ##### --> <para> diff --git a/docs/reference/gtk/tmpl/gtktreemodelsimple.sgml b/docs/reference/gtk/tmpl/gtktreemodelsimple.sgml index a3ae2da10..5b11ca658 100644 --- a/docs/reference/gtk/tmpl/gtktreemodelsimple.sgml +++ b/docs/reference/gtk/tmpl/gtktreemodelsimple.sgml @@ -14,59 +14,3 @@ GtkModelSimple </para> -<!-- ##### STRUCT GtkTreeModelSimple ##### --> -<para> - -</para> - -@parent: -@stamp: - -<!-- ##### FUNCTION gtk_tree_model_simple_new ##### --> -<para> - -</para> - -@Returns: - - -<!-- ##### FUNCTION gtk_tree_model_simple_changed ##### --> -<para> - -</para> - -@simple: -@path: -@iter: - - -<!-- ##### FUNCTION gtk_tree_model_simple_inserted ##### --> -<para> - -</para> - -@simple: -@path: -@iter: - - -<!-- ##### FUNCTION gtk_tree_model_simple_child_toggled ##### --> -<para> - -</para> - -@simple: -@path: -@iter: - - -<!-- ##### FUNCTION gtk_tree_model_simple_deleted ##### --> -<para> - -</para> - -@simple: -@path: -@iter: - - diff --git a/docs/reference/gtk/tmpl/gtktreeselection.sgml b/docs/reference/gtk/tmpl/gtktreeselection.sgml index eb6d2695c..9998d0055 100644 --- a/docs/reference/gtk/tmpl/gtktreeselection.sgml +++ b/docs/reference/gtk/tmpl/gtktreeselection.sgml @@ -61,6 +61,7 @@ GtkTreeSelection @selection: @func: @data: +@destroy: <!-- ##### FUNCTION gtk_tree_selection_get_user_data ##### --> diff --git a/docs/reference/gtk/tmpl/gtktreestore.sgml b/docs/reference/gtk/tmpl/gtktreestore.sgml index 03d90183a..541fab7d8 100644 --- a/docs/reference/gtk/tmpl/gtktreestore.sgml +++ b/docs/reference/gtk/tmpl/gtktreestore.sgml @@ -84,16 +84,6 @@ GtkTreeStore @Varargs: -<!-- ##### FUNCTION gtk_tree_store_get ##### --> -<para> - -</para> - -@tree_store: -@iter: -@Varargs: - - <!-- ##### FUNCTION gtk_tree_store_remove ##### --> <para> diff --git a/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml index 15a4ee127..d813c35ad 100644 --- a/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml +++ b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml @@ -38,8 +38,10 @@ GtkTreeViewColumn @width: @min_width: @max_width: +@displayed_width: @func: @func_data: +@destroy: @title: @cell: @attributes: @@ -59,18 +61,6 @@ GtkTreeViewColumn @GTK_TREE_VIEW_COLUMN_AUTOSIZE: @GTK_TREE_VIEW_COLUMN_FIXED: -<!-- ##### USER_FUNCTION GtkTreeViewColumnFunc ##### --> -<para> - -</para> - -@tree_column: -@tree_model: -@iter: -@data: -@Returns: - - <!-- ##### FUNCTION gtk_tree_view_column_new ##### --> <para> @@ -227,6 +217,15 @@ GtkTreeViewColumn @title: +<!-- ##### FUNCTION gtk_tree_view_column_get_title ##### --> +<para> + +</para> + +@tree_column: +@Returns: + + <!-- ##### FUNCTION gtk_tree_view_column_set_clickable ##### --> <para> diff --git a/docs/reference/gtk/tmpl/gtktypeutils.sgml b/docs/reference/gtk/tmpl/gtktypeutils.sgml index fb9ebab55..09743cfdd 100644 --- a/docs/reference/gtk/tmpl/gtktypeutils.sgml +++ b/docs/reference/gtk/tmpl/gtktypeutils.sgml @@ -546,6 +546,7 @@ nickname. Initialize the data structures associated with gtk types. </para> +@debug_flags: <!-- ##### FUNCTION gtk_type_unique ##### --> diff --git a/docs/reference/gtk/tmpl/gtkwidget.sgml b/docs/reference/gtk/tmpl/gtkwidget.sgml index 9180b2ede..b0fb70150 100644 --- a/docs/reference/gtk/tmpl/gtkwidget.sgml +++ b/docs/reference/gtk/tmpl/gtkwidget.sgml @@ -468,22 +468,6 @@ GtkWidget @area: -<!-- ##### FUNCTION gtk_widget_draw_focus ##### --> -<para> - -</para> - -@widget: - - -<!-- ##### FUNCTION gtk_widget_draw_default ##### --> -<para> - -</para> - -@widget: - - <!-- ##### FUNCTION gtk_widget_size_request ##### --> <para> @@ -1426,20 +1410,6 @@ GtkWidget @time: @Returns: -<!-- ##### SIGNAL GtkWidget::draw-default ##### --> -<para> - -</para> - -@widget: the object which received the signal. - -<!-- ##### SIGNAL GtkWidget::draw-focus ##### --> -<para> - -</para> - -@widget: the object which received the signal. - <!-- ##### SIGNAL GtkWidget::enter-notify-event ##### --> <para> @@ -1738,6 +1708,15 @@ GtkWidget @event: @Returns: +<!-- ##### SIGNAL GtkWidget::window-state-event ##### --> +<para> + +</para> + +@widget: the object which received the signal. +@event: +@Returns: + <!-- ##### ARG GtkWidget:name ##### --> <para> |