AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-13 04:10:13 +00:00
Code Issues Projects Releases Wiki Activity

Merge branch 'ebassi/for-master' into 'master'

Browse Source 
Various documentation fixes

See merge request GNOME/gtk!2900
This commit is contained in:
Emmanuele Bassi 2020-12-02 13:40:25 +00:00
commit 2fcd0e21bd
24 changed files with 323 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/reference/gdk/meson.build
View File

@ -16,6 +16,7 @@ private_headers = [
'gdkdisplayprivate.h',
'gdkdndprivate.h',
'gdkdragprivate.h',
'gdkdragsurfaceprivate.h',
'gdkdrawcontextprivate.h',
'gdkdropprivate.h',
'gdkeventsprivate.h',
@ -37,6 +38,7 @@ private_headers = [
'gdksurfaceprivate.h',
'gdktextureprivate.h',
'gdktoplevelprivate.h',
'gdktoplevelsizeprivate.h',
'gdkvulkancontextprivate.h',
'keyname-table.h',
'x11/gdkprivate-x11.h',

14
docs/reference/gtk/meson.build
View File

@ -146,6 +146,7 @@ private_headers = [
'gtkimageprivate.h',
'gtkimcontextsimpleprivate.h',
'gtkimmoduleprivate.h',
'gtkintl.h',
'gtkkineticscrollingprivate.h',
'gtklabelprivate.h',
'gtklistbaseprivate.h',
@ -183,6 +184,10 @@ private_headers = [
'gtkrendernodepaintableprivate.h',
'gtkroundedboxprivate.h',
'gtkscalerprivate.h',
'gtksearchengine.h',
'gtksearchenginemodel.h',
'gtksearchenginequartz.h',
'gtksearchenginetracker3.h',
'gtksearchentryprivate.h',
'gtksettingsprivate.h',
'gtkshortcutcontrollerprivate.h',
@ -222,8 +227,12 @@ private_headers = [
'gtkwin32drawprivate.h',
'gtkwin32themeprivate.h',
'gtkwindowprivate.h',
'gtk-text-input-client-protocol.h',
'roaring.h',
'text-input-unstable-v3-client-protocol.h',
'a11y',
'inspector',
'roaring',
]
images = [
@ -471,6 +480,7 @@ if get_option('gtk_doc')
],
mkdb_args: [
'--default-includes=gtk/gtk.h',
'--ignore-files=' + ' '.join(private_headers),
],
fixxref_args: [
'--html-dir=@0@'.format(docpath),

7
gdk/gdkcontentprovider.h
View File

@ -49,6 +49,12 @@ struct _GdkContentProvider
GObject parent;
};
/**
* GdkContentProviderClass:
* @content_changed: Signal class closure for #GdkContentProvider::content-changed
*
* Class structure for #GdkContentProvider.
*/
struct _GdkContentProviderClass
{
GObjectClass parent_class;
@ -56,6 +62,7 @@ struct _GdkContentProviderClass
/* signals */
void (* content_changed) (GdkContentProvider *provider);
/*< private >*/
/* vfuncs */
void (* attach_clipboard) (GdkContentProvider *provider,
GdkClipboard *clipboard);

5
gdk/gdkdevicetool.h
View File

@ -32,6 +32,11 @@ G_BEGIN_DECLS
#define GDK_DEVICE_TOOL(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GDK_TYPE_DEVICE_TOOL, GdkDeviceTool))
#define GDK_IS_DEVICE_TOOL(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), GDK_TYPE_DEVICE_TOOL))
/**
* GdkDeviceTool:
*
* A physical tool associated to a #GdkDevice.
*/
typedef struct _GdkDeviceTool GdkDeviceTool;
/**

5
gdk/gdkgltexture.h
View File

@ -33,6 +33,11 @@ G_BEGIN_DECLS
#define GDK_GL_TEXTURE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GDK_TYPE_GL_TEXTURE, GdkGLTexture))
#define GDK_IS_GL_TEXTURE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GDK_TYPE_GL_TEXTURE))
/**
* GdkGLTexture:
*
* A #GdkTexture representing a GL texture object.
*/
typedef struct _GdkGLTexture GdkGLTexture;
typedef struct _GdkGLTextureClass GdkGLTextureClass;

5
gdk/gdkmemorytexture.h
View File

@ -94,6 +94,11 @@ typedef enum {
#define GDK_MEMORY_TEXTURE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GDK_TYPE_MEMORY_TEXTURE, GdkMemoryTexture))
#define GDK_IS_MEMORY_TEXTURE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GDK_TYPE_MEMORY_TEXTURE))
/**
* GdkMemoryTexture:
*
* A #GdkTexture representing image data in memory.
*/
typedef struct _GdkMemoryTexture GdkMemoryTexture;
typedef struct _GdkMemoryTextureClass GdkMemoryTextureClass;

17
gdk/gdkpaintable.h
View File

@ -31,6 +31,11 @@ G_BEGIN_DECLS
#define GDK_TYPE_PAINTABLE (gdk_paintable_get_type ())
/**
* GdkPaintable:
*
* Interface for paintable objects.
*/
GDK_AVAILABLE_IN_ALL
G_DECLARE_INTERFACE (GdkPaintable, gdk_paintable, GDK, PAINTABLE, GObject)
@ -74,11 +79,13 @@ typedef enum {
* this function should return the aspect ratio computed from those.
*
* The list of functions that can be implemented for the #GdkPaintable interface.
* Note that apart from the first function, no function is mandatory to implement,
* though it is a good idea to implement #GdkPaintableInterface.get_current_image()
* for non-static paintables and #GdkPaintableInterface.get_flags() if the image
* is not dynamic as the default implementation returns no flags and that will
* make the implementation likely quite slow.
*
* Note that apart from the #GdkPaintableInterface.snapshot() function, no virtual
* function of this interface is mandatory to implement, though it is a good idea
* to implement #GdkPaintableInterface.get_current_image() for non-static paintables
* and #GdkPaintableInterface.get_flags() if the image is not dynamic as the default
* implementation returns no flags and that will make the implementation likely
* quite slow.
*/
struct _GdkPaintableInterface
{

5
gdk/gdkpopup.h
View File

@ -31,6 +31,11 @@ G_BEGIN_DECLS
#define GDK_TYPE_POPUP (gdk_popup_get_type ())
/**
* GdkPopup:
*
* Interface for popup surfaces.
*/
GDK_AVAILABLE_IN_ALL
G_DECLARE_INTERFACE (GdkPopup, gdk_popup, GDK, POPUP, GObject)

8
gdk/gdksnapshot.h
View File

@ -29,7 +29,13 @@
G_BEGIN_DECLS
typedef struct _GdkSnapshotClass GdkSnapshotClass;
/**
* GdkSnapshot:
*
* Base type for snapshot operations.
*/
typedef struct _GdkSnapshotClass GdkSnapshotClass;
#define GDK_TYPE_SNAPSHOT (gdk_snapshot_get_type ())

6
gdk/gdktoplevel.h
View File

@ -120,6 +120,11 @@ typedef enum
#define GDK_TYPE_TOPLEVEL (gdk_toplevel_get_type ())
/**
* GdkToplevel:
*
* An interface for top level surfaces.
*/
GDK_AVAILABLE_IN_ALL
G_DECLARE_INTERFACE (GdkToplevel, gdk_toplevel, GDK, TOPLEVEL, GObject)
@ -198,7 +203,6 @@ void gdk_toplevel_begin_move (GdkToplevel *toplevel,
double y,
guint32 timestamp);
G_END_DECLS
#endif /* __GDK_TOPLEVEL_H__ */

2
gdk/gdktoplevellayout.h
View File

@ -30,7 +30,7 @@
G_BEGIN_DECLS
/**
* GdkTopLevelLayout:
* GdkToplevelLayout:
*
* Struct containing information for gdk_toplevel_present()
*/

10
gsk/gskglshader.h
View File

@ -32,10 +32,20 @@ G_BEGIN_DECLS
#define GSK_TYPE_SHADER_ARGS_BUILDER (gsk_shader_args_builder_get_type ())
/**
* GskShaderArgsBuilder:
*
* An object to build the uniforms data for a #GskGLShader.
*/
typedef struct _GskShaderArgsBuilder GskShaderArgsBuilder;
#define GSK_TYPE_GL_SHADER (gsk_gl_shader_get_type ())
/**
* GskGLShader:
*
* An object representing a GL shader program.
*/
GDK_AVAILABLE_IN_ALL
G_DECLARE_FINAL_TYPE (GskGLShader, gsk_gl_shader, GSK, GL_SHADER, GObject)

6
gsk/gskrenderer.h
View File

@ -33,6 +33,12 @@ G_BEGIN_DECLS
#define GSK_RENDERER(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GSK_TYPE_RENDERER, GskRenderer))
#define GSK_IS_RENDERER(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GSK_TYPE_RENDERER))
/**
* GskRenderer:
*
* Base type for the object managing the rendering pipeline
* for a #GdkSurface.
*/
typedef struct _GskRendererClass GskRendererClass;
GDK_AVAILABLE_IN_ALL

26
gsk/gskrendernode.h
View File

@ -40,12 +40,28 @@ typedef struct _GskRenderNode GskRenderNode;
typedef struct _GskColorStop GskColorStop;
typedef struct _GskShadow GskShadow;
/**
* GskColorStop:
* @offset: the offset of the color stop
* @color: the color at the given offset
*
* A color stop in a gradient node.
*/
struct _GskColorStop
{
float offset;
GdkRGBA color;
};
/**
* GskShadow:
* @color: the color of the shadow
* @dx: the horizontal offset of the shadow
* @dy: the vertical offset of the shadow
* @radius: the radius of the shadow
*
* The shadow parameters in a shadow node.
*/
struct _GskShadow
{
GdkRGBA color;
@ -56,6 +72,16 @@ struct _GskShadow
typedef struct _GskParseLocation GskParseLocation;
/**
* GskParseLocation:
* @bytes: the offset of the location in the parse buffer, as bytes
* @chars: the offset of the location in the parse buffer, as characters
* @lines: the line of the location in the parse buffer
* @line_bytes: the position in the line, as bytes
* @line_chars: the position in the line, as characters
*
* A location in a parse buffer.
*/
struct _GskParseLocation
{
gsize bytes;

123
gsk/gskrendernodeimpl.c
View File

@ -51,6 +51,11 @@ rectangle_init_from_graphene (cairo_rectangle_int_t *cairo,
/*** GSK_COLOR_NODE ***/
/**
* GskColorNode:
*
* A render node for a solid color.
*/
struct _GskColorNode
{
GskRenderNode render_node;
@ -134,6 +139,17 @@ gsk_color_node_new (const GdkRGBA *rgba,
/*** GSK_LINEAR_GRADIENT_NODE ***/
/**
* GskRepeatingLinearGradientNode:
*
* A render node for a repeating linear gradient.
*/
/**
* GskLinearGradientNode:
*
* A render node for a linear gradient.
*/
struct _GskLinearGradientNode
{
GskRenderNode render_node;
@ -392,6 +408,17 @@ gsk_linear_gradient_node_get_color_stops (GskRenderNode *node,
/*** GSK_RADIAL_GRADIENT_NODE ***/
/**
* GskRepeatingRadialGradientNode:
*
* A render node for a repeating radial gradient.
*/
/**
* GskRadialGradientNode:
*
* A render node for a radial gradient.
*/
struct _GskRadialGradientNode
{
GskRenderNode render_node;
@ -743,6 +770,11 @@ gsk_radial_gradient_node_get_end (GskRenderNode *node)
/*** GSK_BORDER_NODE ***/
/**
* GskBorderNode:
*
* A render node for a border.
*/
struct _GskBorderNode
{
GskRenderNode render_node;
@ -1027,6 +1059,11 @@ gsk_border_node_get_uniform (GskRenderNode *self)
/*** GSK_TEXTURE_NODE ***/
/**
* GskTextureNode:
*
* A render node for a #GdkTexture.
*/
struct _GskTextureNode
{
GskRenderNode render_node;
@ -1138,6 +1175,11 @@ gsk_texture_node_new (GdkTexture *texture,
/*** GSK_INSET_SHADOW_NODE ***/
/**
* GskInsetShadowNode:
*
* A render node for an inset shadow.
*/
struct _GskInsetShadowNode
{
GskRenderNode render_node;
@ -1697,6 +1739,11 @@ gsk_inset_shadow_node_get_blur_radius (GskRenderNode *node)
/*** GSK_OUTSET_SHADOW_NODE ***/
/**
* GskOutsetShadowNode:
*
* A render node for an outset shadow.
*/
struct _GskOutsetShadowNode
{
GskRenderNode render_node;
@ -2006,6 +2053,11 @@ gsk_outset_shadow_node_get_blur_radius (GskRenderNode *node)
/*** GSK_CAIRO_NODE ***/
/**
* GskCairoNode:
*
* A render node for a Cairo surface.
*/
struct _GskCairoNode
{
GskRenderNode render_node;
@ -2137,6 +2189,11 @@ gsk_cairo_node_get_draw_context (GskRenderNode *node)
/**** GSK_CONTAINER_NODE ***/
/**
* GskContainerNode:
*
* A render node that can contain other render nodes.
*/
struct _GskContainerNode
{
GskRenderNode render_node;
@ -2324,6 +2381,11 @@ gsk_container_node_get_child (GskRenderNode *node,
/*** GSK_TRANSFORM_NODE ***/
/**
* GskTransformNode:
*
* A render node applying a #GskTransform to its single child node.
*/
struct _GskTransformNode
{
GskRenderNode render_node;
@ -2517,6 +2579,11 @@ gsk_transform_node_get_transform (GskRenderNode *node)
/*** GSK_OPACITY_NODE ***/
/**
* GskOpacityNode:
*
* A render node controlling the opacity of its single child node.
*/
struct _GskOpacityNode
{
GskRenderNode render_node;
@ -2640,6 +2707,11 @@ gsk_opacity_node_get_opacity (GskRenderNode *node)
/*** GSK_COLOR_MATRIX_NODE ***/
/**
* GskColorMatrixNode:
*
* A render node controlling the color matrix of its single child node.
*/
struct _GskColorMatrixNode
{
GskRenderNode render_node;
@ -2861,6 +2933,11 @@ gsk_color_matrix_node_get_color_offset (GskRenderNode *node)
/*** GSK_REPEAT_NODE ***/
/**
* GskRepeatNode:
*
* A render node repeating its single child node.
*/
struct _GskRepeatNode
{
GskRenderNode render_node;
@ -2993,6 +3070,11 @@ gsk_repeat_node_get_child_bounds (GskRenderNode *node)
/*** GSK_CLIP_NODE ***/
/**
* GskClipNode:
*
* A render node applying a rectangular clip to its single child node.
*/
struct _GskClipNode
{
GskRenderNode render_node;
@ -3123,6 +3205,11 @@ gsk_clip_node_get_clip (GskRenderNode *node)
/*** GSK_ROUNDED_CLIP_NODE ***/
/**
* GskRoundedClipNode:
*
* A render node applying a rounded rectangle clip to its single child.
*/
struct _GskRoundedClipNode
{
GskRenderNode render_node;
@ -3253,6 +3340,11 @@ gsk_rounded_clip_node_get_clip (GskRenderNode *node)
/*** GSK_SHADOW_NODE ***/
/**
* GskShadowNode:
*
* A render node drawing one or more shadows behind its single child node.
*/
struct _GskShadowNode
{
GskRenderNode render_node;
@ -3492,6 +3584,11 @@ gsk_shadow_node_get_n_shadows (GskRenderNode *node)
/*** GSK_BLEND_NODE ***/
/**
* GskBlendNode:
*
* A render node applying a blending function between its two child nodes.
*/
struct _GskBlendNode
{
GskRenderNode render_node;
@ -3684,6 +3781,11 @@ gsk_blend_node_get_blend_mode (GskRenderNode *node)
/*** GSK_CROSS_FADE_NODE ***/
/**
* GskCrossFadeNode:
*
* A render node cross fading between two child nodes.
*/
struct _GskCrossFadeNode
{
GskRenderNode render_node;
@ -3833,6 +3935,11 @@ gsk_cross_fade_node_get_progress (GskRenderNode *node)
/*** GSK_TEXT_NODE ***/
/**
* GskTextNode:
*
* A render node drawing a set of glyphs.
*/
struct _GskTextNode
{
GskRenderNode render_node;
@ -4098,6 +4205,11 @@ gsk_text_node_get_offset (GskRenderNode *node)
/*** GSK_BLUR_NODE ***/
/**
* GskBlurNode:
*
* A render node applying a blur effect to its single child.
*/
struct _GskBlurNode
{
GskRenderNode render_node;
@ -4410,6 +4522,12 @@ gsk_blur_node_get_radius (GskRenderNode *node)
/*** GSK_DEBUG_NODE ***/
/**
* GskDebugNode:
*
* A render node that emits a debugging message when drawing its
* child node.
*/
struct _GskDebugNode
{
GskRenderNode render_node;
@ -4530,6 +4648,11 @@ gsk_debug_node_get_message (GskRenderNode *node)
/*** GSK_GL_SHADER_NODE ***/
/**
* GskGLShaderNode:
*
* A render node using a GL shader when drawing its children nodes.
*/
struct _GskGLShaderNode
{
GskRenderNode render_node;

7
gtk/gtkappchooserbutton.c
View File

@ -715,6 +715,13 @@ gtk_app_chooser_button_class_init (GtkAppChooserButtonClass *klass)
G_PARAM_READWRITE|G_PARAM_CONSTRUCT|G_PARAM_STATIC_STRINGS|G_PARAM_EXPLICIT_NOTIFY);
g_object_class_install_properties (oclass, NUM_PROPERTIES, properties);
/**
* GtkAppChooserButton::changed:
* @self: the object which received the signal
*
* Emitted when the active application on the #GtkAppChooserButton
* changes.
*/
signals[SIGNAL_CHANGED] =
g_signal_new (I_("changed"),
G_OBJECT_CLASS_TYPE (klass),

6
gtk/gtkassistant.c
View File

@ -560,6 +560,12 @@ gtk_assistant_class_init (GtkAssistantClass *class)
NULL,
G_TYPE_NONE, 0);
/**
* GtkAssistant::escape
* @assistant: the #GtkAssistant
*
* The action signal for the Escape binding.
*/
signals[ESCAPE] =
g_signal_new_class_handler (I_("escape"),
G_TYPE_FROM_CLASS (gobject_class),

1
gtk/gtkbitset.h
View File

@ -143,6 +143,7 @@ typedef struct _GtkBitsetIter GtkBitsetIter;
struct _GtkBitsetIter
{
/*< private >*/
gpointer private_data[10];
};

12
gtk/gtkbuildable.h
View File

@ -39,6 +39,15 @@ typedef struct _GtkBuildableIface GtkBuildableIface;
typedef struct _GtkBuildableParseContext GtkBuildableParseContext;
typedef struct _GtkBuildableParser GtkBuildableParser;
/**
* GtkBuildableParser:
* @start_element: function called for open elements
* @end_element: function called for close elements
* @text: function called for character data
* @error: function called on error
*
* A sub-parser for #GtkBuildable implementations.
*/
struct _GtkBuildableParser
{
/* Called for open tags <foo bar="baz"> */
@ -70,6 +79,7 @@ struct _GtkBuildableParser
GError *error,
gpointer user_data);
/*< private >*/
gpointer padding[4];
};
@ -158,7 +168,7 @@ struct _GtkBuildableIface
* @builder: a #GtkBuilder used to construct this object
* @child: (nullable): child object or %NULL for non-child tags
* @tagname: name of tag
* @parser: (out): a #GMarkupParser to fill in
* @parser: (out): a #GtkBuildableParser to fill in
* @data: (out): return location for user data that will be passed in
* to parser functions
*

2
gtk/gtkbuilderscope.h
View File

@ -44,7 +44,7 @@ G_DECLARE_INTERFACE (GtkBuilderScope, gtk_builder_scope, GTK, BUILDER_SCOPE, GOb
* values and raise a %GTK_BUILDER_ERROR_INVALID_ATTRIBUTE error when they
* encounter one.
*/
typedef enum {
typedef enum { /*< prefix=GTK_BUILDER_CLOSURE >*/
GTK_BUILDER_CLOSURE_SWAPPED = (1 << 0)
} GtkBuilderClosureFlags;

39
gtk/gtkcenterlayout.c
View File

@ -563,6 +563,8 @@ void
gtk_center_layout_set_orientation (GtkCenterLayout *self,
GtkOrientation orientation)
{
g_return_if_fail (GTK_IS_CENTER_LAYOUT (self));
if (orientation != self->orientation)
{
self->orientation = orientation;
@ -581,6 +583,8 @@ gtk_center_layout_set_orientation (GtkCenterLayout *self,
GtkOrientation
gtk_center_layout_get_orientation (GtkCenterLayout *self)
{
g_return_val_if_fail (GTK_IS_CENTER_LAYOUT (self), GTK_ORIENTATION_HORIZONTAL);
return self->orientation;
}
@ -595,6 +599,8 @@ void
gtk_center_layout_set_baseline_position (GtkCenterLayout *self,
GtkBaselinePosition baseline_position)
{
g_return_if_fail (GTK_IS_CENTER_LAYOUT (self));
if (baseline_position != self->baseline_pos)
{
self->baseline_pos = baseline_position;
@ -613,13 +619,15 @@ gtk_center_layout_set_baseline_position (GtkCenterLayout *self,
GtkBaselinePosition
gtk_center_layout_get_baseline_position (GtkCenterLayout *self)
{
g_return_val_if_fail (GTK_IS_CENTER_LAYOUT (self), GTK_BASELINE_POSITION_TOP);
return self->baseline_pos;
}
/**
* gtk_center_layout_set_start_widget:
* @self: a #GtkCenterLayout
* @widget (nullable): the new start widget
* @widget: (nullable): the new start widget
*
* Sets the new start widget of @self.
*
@ -629,7 +637,14 @@ void
gtk_center_layout_set_start_widget (GtkCenterLayout *self,
GtkWidget *widget)
{
g_return_if_fail (GTK_IS_CENTER_LAYOUT (self));
g_return_if_fail (widget == NULL || GTK_IS_WIDGET (widget));
if (self->start_widget == widget)
return;
self->start_widget = widget;
gtk_layout_manager_layout_changed (GTK_LAYOUT_MANAGER (self));
}
/**
@ -643,13 +658,15 @@ gtk_center_layout_set_start_widget (GtkCenterLayout *self,
GtkWidget *
gtk_center_layout_get_start_widget (GtkCenterLayout *self)
{
g_return_val_if_fail (GTK_IS_CENTER_LAYOUT (self), NULL);
return self->start_widget;
}
/**
* gtk_center_layout_set_center_widget:
* @self: a #GtkCenterLayout
* @widget (nullable): the new center widget
* @widget: (nullable): the new center widget
*
* Sets the new center widget of @self.
*
@ -659,7 +676,14 @@ void
gtk_center_layout_set_center_widget (GtkCenterLayout *self,
GtkWidget *widget)
{
g_return_if_fail (GTK_IS_CENTER_LAYOUT (self));
g_return_if_fail (widget == NULL || GTK_IS_WIDGET (widget));
if (self->center_widget == widget)
return;
self->center_widget = widget;
gtk_layout_manager_layout_changed (GTK_LAYOUT_MANAGER (self));
}
/**
@ -673,6 +697,8 @@ gtk_center_layout_set_center_widget (GtkCenterLayout *self,
GtkWidget *
gtk_center_layout_get_center_widget (GtkCenterLayout *self)
{
g_return_val_if_fail (GTK_IS_CENTER_LAYOUT (self), NULL);
return self->center_widget;
}
@ -689,7 +715,14 @@ void
gtk_center_layout_set_end_widget (GtkCenterLayout *self,
GtkWidget *widget)
{
g_return_if_fail (GTK_IS_CENTER_LAYOUT (self));
g_return_if_fail (widget == NULL || GTK_IS_WIDGET (widget));
if (self->end_widget == widget)
return;
self->end_widget = widget;
gtk_layout_manager_layout_changed (GTK_LAYOUT_MANAGER (self));
}
/**
@ -703,5 +736,7 @@ gtk_center_layout_set_end_widget (GtkCenterLayout *self,
GtkWidget *
gtk_center_layout_get_end_widget (GtkCenterLayout *self)
{
g_return_val_if_fail (GTK_IS_CENTER_LAYOUT (self), NULL);
return self->end_widget;
}

11
gtk/gtkexpression.h
View File

@ -154,6 +154,12 @@ GtkExpression * gtk_cclosure_expression_new (GType
/* GObject integration, so we can use GtkBuilder */
/**
* GTK_VALUE_HOLDS_EXPRESSION:
* @value: a #GValue
*
* Evaluates to %TRUE if @value was initialized with %GTK_TYPE_EXPRESSION.
*/
#define GTK_VALUE_HOLDS_EXPRESSION(value) (G_VALUE_HOLDS ((value), GTK_TYPE_EXPRESSION))
GDK_AVAILABLE_IN_ALL
@ -171,6 +177,11 @@ GtkExpression * gtk_value_dup_expression (const GValue *value);
#define GTK_PARAM_SPEC_EXPRESSION(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_PARAM_SPEC_EXPRESSION, GtkParamSpecExpression))
#define GTK_IS_PARAM_SPEC_EXPRESSION(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_PARAM_SPEC_EXPRESSION))
/**
* GtkParamSpecExpression:
*
* A #GParamSpec for properties holding a #GtkExpression.
*/
typedef struct {
/*< private >*/
GParamSpec parent_instance;

9
gtk/gtktexttagtable.c
View File

@ -126,6 +126,8 @@ gtk_text_tag_table_class_init (GtkTextTagTableClass *klass)
* @texttagtable: the object which received the signal.
* @tag: the changed tag.
* @size_changed: whether the change affects the #GtkTextView layout.
*
* Emitted every time a tag in the #GtkTextTagTable changes.
*/
signals[TAG_CHANGED] =
g_signal_new (I_("tag-changed"),
@ -146,6 +148,8 @@ gtk_text_tag_table_class_init (GtkTextTagTableClass *klass)
* GtkTextTagTable::tag-added:
* @texttagtable: the object which received the signal.
* @tag: the added tag.
*
* Emitted every time a new tag is added in the #GtkTextTagTable.
*/
signals[TAG_ADDED] =
g_signal_new (I_("tag-added"),
@ -162,6 +166,11 @@ gtk_text_tag_table_class_init (GtkTextTagTableClass *klass)
* GtkTextTagTable::tag-removed:
* @texttagtable: the object which received the signal.
* @tag: the removed tag.
*
* Emitted every time a tag is removed from the #GtkTextTagTable.
*
* The @tag is still valid by the time the signal is emitted, but
* it is not associated with a tag table any more.
*/
signals[TAG_REMOVED] =
g_signal_new (I_("tag-removed"),

9
gtk/gtktexttagtable.h
View File

@ -37,6 +37,9 @@ G_BEGIN_DECLS
* GtkTextTagTableForeach:
* @tag: the #GtkTextTag
* @data: (closure): data passed to gtk_text_tag_table_foreach()
*
* A function used with gtk_text_tag_table_foreach(), to iterate over every
* #GtkTextTag inside a #GtkTextTagTable.
*/
typedef void (* GtkTextTagTableForeach) (GtkTextTag *tag, gpointer data);
@ -44,6 +47,12 @@ typedef void (* GtkTextTagTableForeach) (GtkTextTag *tag, gpointer data);
#define GTK_TEXT_TAG_TABLE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_TEXT_TAG_TABLE, GtkTextTagTable))
#define GTK_IS_TEXT_TAG_TABLE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TEXT_TAG_TABLE))
/**
* GtkTextTagTable:
*
* An object holding all the #GtkTextTag instances for a #GtkTextBuffer.
*/
GDK_AVAILABLE_IN_ALL
GType gtk_text_tag_table_get_type (void) G_GNUC_CONST;