This commit is contained in:
Matthias Clasen 2005-06-30 03:21:25 +00:00
parent 15fd38a033
commit 546e045ccf
12 changed files with 123 additions and 48 deletions

View File

@ -1,3 +1,17 @@
2005-06-29 Matthias Clasen <mclasen@redhat.com>
* gdk/tmpl/images.sgml:
* gdk/tmpl/dnd.sgml:
* gdk/tmpl/events.sgml:
* gdk/tmpl/windows.sgml:
* gdk/tmpl/visuals.sgml:
* gdk/tmpl/cairo_interaction.sgml:
* gdk/tmpl/event_structs.sgml:
* gdk/tmpl/input_devices.sgml:
* gtk/gtk-sections.txt:
* gtk/Makefile.am (IGNORE_HFILES):
* gtk/tmpl/gtkstock.sgml: Updates.
2005-06-28 Ross Burton <ross@burtonini.com>
* gtk/tmpl/gtkcomboboxentry.sgml: Clarify.

View File

@ -2,11 +2,21 @@
Cairo Interaction
<!-- ##### SECTION Short_Description ##### -->
Functions to support using Cairo
<!-- ##### SECTION Long_Description ##### -->
<para>
<link href="http://cairographics.org">Cairo</link> is a graphics
library that supports vector graphics and image compositing that
can be used with GDK. Since 2.8, GTK+ does most of its drawing
using Cairo.
</para>
<para>
GDK does not wrap the Cairo API, instead it allows to create Cairo
contexts which can be used to draw on GDK drawables. Additional
functions allow to convert GDK's rectangles and regions into
Cairo paths and to use pixbufs as sources for drawing operations.
</para>
<!-- ##### SECTION See_Also ##### -->

View File

@ -179,7 +179,7 @@ A <structname>GdkDragContext</structname> holds information about a
drag in progress. It is used on both source and destination sides.
</para>
@parent_instance:
@parent_instance: the parent instance
@protocol: the DND protocol which governs this drag.
@is_source: %TRUE if the context is used on the source side.
@source_window: the source of this drag.

View File

@ -429,15 +429,17 @@ only available if the X server supports the XFIXES extension.
Generated when a pointer or keyboard grab is broken. On X11, this happens
when the grab window becomes unviewable (i.e. it or one of its ancestors
is unmapped), or if the same application grabs the pointer or keyboard
again.
again. Note that implicit grabs (which are initiated by button presses)
can also cause #GdkEventGrabBroken events.
</para>
@type: the type of the event (%GDK_GRAB_BROKEN)
@type: the type of the event (%GDK_GRAB_BROKEN)
@window: the window which received the event, i.e. the window
that previously owned the grab
@send_event: %TRUE if the event was sent explicitly (e.g. using <function>XSendEvent</function>).
@keyboard: %TRUE if a keyboard grab was broken, %FALSE if a pointer
grab was broken
@implicit: %TRUE if the broken grab was implicit
@grab_window: If this event is caused by another grab in the same
application, @grab_window contains the new grab window. Otherwise
@grab_window id %NULL.
@ -492,7 +494,7 @@ full details of crossing event generation.
which are not ancestors of each other and the window is part of
the ancestor chain between one of these windows and their least
common ancestor.
@GDK_NOTIFY_UNKNOWN:
@GDK_NOTIFY_UNKNOWN: an unknown type of enter/leave event occurred.
<!-- ##### ENUM GdkPropertyState ##### -->
<para>

View File

@ -105,32 +105,33 @@ number of %GDK_MOTION_NOTIFY events received. Normally a %GDK_MOTION_NOTIFY
event is received each time the mouse moves. However, if the application
spends a lot of time processing the event (updating the display, for example),
it can easily lag behind the position of the mouse. When using the
%GDK_POINTER_MOTION_HINT_MASK the server will only send a single %GDK_MOTION_NOTIFY
event (which is marked as a hint) until the application asks for more, by calling
gdk_window_get_pointer().
%GDK_POINTER_MOTION_HINT_MASK the server will only send a single
%GDK_MOTION_NOTIFY event (which is marked as a hint) until the application
asks for more, by calling gdk_window_get_pointer().
</para>
@GDK_EXPOSURE_MASK:
@GDK_POINTER_MOTION_MASK:
@GDK_POINTER_MOTION_HINT_MASK:
@GDK_BUTTON_MOTION_MASK:
@GDK_BUTTON1_MOTION_MASK:
@GDK_BUTTON2_MOTION_MASK:
@GDK_BUTTON3_MOTION_MASK:
@GDK_BUTTON_PRESS_MASK:
@GDK_BUTTON_RELEASE_MASK:
@GDK_KEY_PRESS_MASK:
@GDK_KEY_RELEASE_MASK:
@GDK_ENTER_NOTIFY_MASK:
@GDK_LEAVE_NOTIFY_MASK:
@GDK_FOCUS_CHANGE_MASK:
@GDK_STRUCTURE_MASK:
@GDK_PROPERTY_CHANGE_MASK:
@GDK_VISIBILITY_NOTIFY_MASK:
@GDK_PROXIMITY_IN_MASK:
@GDK_PROXIMITY_OUT_MASK:
@GDK_SUBSTRUCTURE_MASK:
@GDK_SCROLL_MASK:
@GDK_EXPOSURE_MASK: receive expose events
@GDK_POINTER_MOTION_MASK: receive all pointer motion events
@GDK_POINTER_MOTION_HINT_MASK: see the explanation above
@GDK_BUTTON_MOTION_MASK: receive pointer motion events while any button is pressed
@GDK_BUTTON1_MOTION_MASK: receive pointer motion events while 1 button is pressed
@GDK_BUTTON2_MOTION_MASK: receive pointer motion events while 2 button is pressed
@GDK_BUTTON3_MOTION_MASK: receive pointer motion events while 3 button is pressed
@GDK_BUTTON_PRESS_MASK: receive button press events
@GDK_BUTTON_RELEASE_MASK: receive button release events
@GDK_KEY_PRESS_MASK: receive key press events
@GDK_KEY_RELEASE_MASK: receive key release events
@GDK_ENTER_NOTIFY_MASK: receive window enter events
@GDK_LEAVE_NOTIFY_MASK: receive window leave events
@GDK_FOCUS_CHANGE_MASK: receive focus change events
@GDK_STRUCTURE_MASK: receive events about window configuration change
@GDK_PROPERTY_CHANGE_MASK: receive property change events
@GDK_VISIBILITY_NOTIFY_MASK: receive visibility change events
@GDK_PROXIMITY_IN_MASK: receive proximity in events
@GDK_PROXIMITY_OUT_MASK: receive proximity out events
@GDK_SUBSTRUCTURE_MASK: receive events about window configuration changes of
child windows
@GDK_SCROLL_MASK: receive scroll events
@GDK_ALL_EVENTS_MASK: the combination of all the above event masks.
<!-- ##### MACRO GDK_CURRENT_TIME ##### -->

View File

@ -63,7 +63,7 @@ displays.
The #GdkImage struct contains information on the image and the pixel data.
</para>
@parent_instance:
@parent_instance: the parent instance
@type: the type of the image.
@visual: the visual.
@byte_order: the byte order.
@ -72,9 +72,9 @@ The #GdkImage struct contains information on the image and the pixel data.
@depth: the depth of the image, i.e. the number of bits per pixel.
@bpp: the number of bytes per pixel.
@bpl: the number of bytes per line of the image.
@bits_per_pixel:
@bits_per_pixel: the number of bits per pixel.
@mem: the pixel data.
@colormap:
@colormap: the #GdkColormap associated with the image
<!-- ##### FUNCTION gdk_image_new ##### -->
<para>

View File

@ -101,7 +101,7 @@ gdk_device_set_mode(), gdk_device_set_key() and gdk_device_set_axis_use()
to configure various aspects of the device.
</para>
@parent_instance:
@parent_instance: the parent instance
@name: the name of this device.
@source: the type of this device.
@mode: the mode of this device

View File

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

View File

@ -142,7 +142,6 @@ ratio.
@min_width: minimum width of window (or -1 to use requisition, with #GtkWindow only)
@min_height minimum height of window (or -1 to use requisition, with #GtkWindow only)
@min_height:
@max_width: maximum width of window (or -1 to use requisition, with #GtkWindow only)
@max_height: maximum height of window (or -1 to use requisition, with #GtkWindow only)
@base_width: allowed window widths are @base_width + @width_inc * N where N is any integer (-1 allowed with #GtkWindow)
@ -488,6 +487,17 @@ Deprecated equivalent of g_object_unref()
@dy:
<!-- ##### FUNCTION gdk_window_move_region ##### -->
<para>
</para>
@window:
@region:
@dx:
@dy:
<!-- ##### FUNCTION gdk_window_reparent ##### -->
<para>
@ -536,15 +546,18 @@ Deprecated equivalent of g_object_unref()
Deprecated equivalent to gdk_draw_drawable(), see that function for docs
</para>
@drawable:
@gc:
@x:
@y:
@source_drawable:
@source_x:
@source_y:
@width:
@height:
@drawable: a #GdkDrawable
@gc: a #GdkGC sharing the drawable's visual and colormap
@drawable: a #GdkDrawable
@x: X position in @drawable where the rectangle should be drawn
@y: Y position in @drawable where the rectangle should be drawn
@source_drawable: the source #GdkDrawable, which may be the same as @drawable
@source_x: X position in @src of rectangle to draw
@source_y: Y position in @src of rectangle to draw
@xdest: X position in @drawable where the rectangle should be drawn
@ydest: Y position in @drawable where the rectangle should be drawn
@width: width of rectangle to draw, or -1 for entire @src width
@height: height of rectangle to draw, or -1 for entire @src height
<!-- ##### FUNCTION gdk_window_raise ##### -->
@ -1172,7 +1185,7 @@ Like the X Window System, GDK supports 8 modifier keys and 5 mouse buttons.
@GDK_BUTTON5_MASK: the fifth mouse button.
@GDK_RELEASE_MASK: not used in GDK itself. GTK+ uses it to differentiate
between (keyval, modifiers) pairs from key press and release events.
@GDK_MODIFIER_MASK:
@GDK_MODIFIER_MASK: a mask covering all modifier types.
<!-- ##### FUNCTION gdk_window_get_parent ##### -->
<para>

View File

@ -45,6 +45,7 @@ IGNORE_HFILES= \
gtkintl.h \
gtkkeyhash.h \
gtkmarshal.h \
gtkmnemonichash.h \
gtkpathbar.h \
gtkprivate.h \
gtkrbtree.h \

View File

@ -448,6 +448,7 @@ GTK_CALENDAR_CLASS
GTK_IS_CALENDAR_CLASS
GTK_CALENDAR_GET_CLASS
<SUBSECTION Private>
GtkCalendarPrivate
gtk_calendar_get_type
</SECTION>
@ -1633,7 +1634,6 @@ gtk_hseparator_get_type
<FILE>gtkiconview</FILE>
<TITLE>GtkIconView</TITLE>
GtkIconView
GtkIconViewPrivate
GtkIconViewForeachFunc
gtk_icon_view_new
gtk_icon_view_new_with_model
@ -1676,6 +1676,7 @@ gtk_icon_view_item_activated
gtk_icon_view_scroll_to_path
gtk_icon_view_get_visible_range
<SUBSECTION Dnd>
GtkIconViewDropPosition
gtk_icon_view_enable_model_drag_source
gtk_icon_view_enable_model_drag_dest
gtk_icon_view_unset_model_drag_source
@ -1696,6 +1697,7 @@ GTK_TYPE_ICON_VIEW
GTK_ICON_VIEW
<SUBSECTION Private>
gtk_icon_view_get_type
GtkIconViewPrivate
</SECTION>
<SECTION>

View File

@ -466,6 +466,15 @@ The "Index" item.
<!-- ##### MACRO GTK_STOCK_INFO ##### -->
<para>
The "Info" item.
<inlinegraphic fileref="stock_info_24.png" format="PNG"></inlinegraphic>
</para>
@Since: 2.8
<!-- ##### MACRO GTK_STOCK_ITALIC ##### -->
<para>
The "Italic" item.
@ -880,3 +889,26 @@ The "Zoom Out" item.
<!-- ##### MACRO GTK_STOCK_FULLSCREEN ##### -->
<para>
The "Fullscreen" item.
<inlinegraphic fileref="stock_fullscreen_24.png" format="PNG"></inlinegraphic>
</para>
@Since: 2.8
<!-- ##### MACRO GTK_STOCK_LEAVE_FULLSCREEN ##### -->
<para>
The "Leave Fullscreen" item.
<inlinegraphic fileref="stock_leave_fullscreen_24.png" format="PNG"></inlinegraphic>
</para>
@Since: 2.8