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

docs: Fix various broken links

Browse Source
This commit is contained in:
Bilal Elmoussaoui 2023-03-27 21:19:06 +02:00
parent 506206e1bd
commit d1c43b94ef
15 changed files with 81 additions and 81 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
gdk/gdkframeclock.c
View File

@ -48,7 +48,7 @@
* for the synchronization being implemented, the clock will process a frame and * for the synchronization being implemented, the clock will process a frame and
* emit signals for each phase that has been requested. (See the signals of the * emit signals for each phase that has been requested. (See the signals of the
* `GdkFrameClock` class for documentation of the phases. * `GdkFrameClock` class for documentation of the phases.
* %GDK_FRAME_CLOCK_PHASE_UPDATE and the [signal@GdkFrameClock::update] signal * %GDK_FRAME_CLOCK_PHASE_UPDATE and the [signal@Gdk.FrameClock::update] signal
* are most interesting for application writers, and are used to update the * are most interesting for application writers, and are used to update the
* animations, using the frame time given by [method@Gdk.FrameClock.get_frame_time]. * animations, using the frame time given by [method@Gdk.FrameClock.get_frame_time].
* *
@ -60,7 +60,7 @@
* are called at a “similar” time get the same value. This means that * are called at a “similar” time get the same value. This means that
* if different animations are timed by looking at the difference in * if different animations are timed by looking at the difference in
* time between an initial value from [method@Gdk.FrameClock.get_frame_time] * time between an initial value from [method@Gdk.FrameClock.get_frame_time]
* and the value inside the [signal@GdkFrameClock::update] signal of the clock, * and the value inside the [signal@Gdk.FrameClock::update] signal of the clock,
* they will stay exactly synchronized. * they will stay exactly synchronized.
*/ */

10
gdk/gdkpaintable.c
View File

@ -50,7 +50,7 @@ void gtk_snapshot_pop (GdkSnapshot
* to do, it is suggested that you scale your paintable ignoring any potential * to do, it is suggested that you scale your paintable ignoring any potential
* aspect ratio. * aspect ratio.
* *
* The contents that a `GdkPaintable` produces may depend on the [class@GdkSnapshot] * The contents that a `GdkPaintable` produces may depend on the [class@Gdk.Snapshot]
* passed to it. For example, paintables may decide to use more detailed images * passed to it. For example, paintables may decide to use more detailed images
* on higher resolution screens or when OpenGL is available. A `GdkPaintable` * on higher resolution screens or when OpenGL is available. A `GdkPaintable`
* will however always produce the same output for the same snapshot. * will however always produce the same output for the same snapshot.
@ -58,7 +58,7 @@ void gtk_snapshot_pop (GdkSnapshot
* A `GdkPaintable` may change its contents, meaning that it will now produce * A `GdkPaintable` may change its contents, meaning that it will now produce
* a different output with the same snapshot. Once that happens, it will call * a different output with the same snapshot. Once that happens, it will call
* [method@Gdk.Paintable.invalidate_contents] which will emit the * [method@Gdk.Paintable.invalidate_contents] which will emit the
* [signal@GdkPaintable::invalidate-contents] signal. If a paintable is known * [signal@Gdk.Paintable::invalidate-contents] signal. If a paintable is known
* to never change its contents, it will set the %GDK_PAINTABLE_STATIC_CONTENTS * to never change its contents, it will set the %GDK_PAINTABLE_STATIC_CONTENTS
* flag. If a consumer cannot deal with changing contents, it may call * flag. If a consumer cannot deal with changing contents, it may call
* [method@Gdk.Paintable.get_current_image] which will return a static * [method@Gdk.Paintable.get_current_image] which will return a static
@ -69,7 +69,7 @@ void gtk_snapshot_pop (GdkSnapshot
* can use this information to layout thepaintable appropriately. Just like the * can use this information to layout thepaintable appropriately. Just like the
* contents, the size of a paintable can change. A paintable will indicate this * contents, the size of a paintable can change. A paintable will indicate this
* by calling [method@Gdk.Paintable.invalidate_size] which will emit the * by calling [method@Gdk.Paintable.invalidate_size] which will emit the
* [signal@GdkPaintable::invalidate-size] signal. And just like for contents, * [signal@Gdk.Paintable::invalidate-size] signal. And just like for contents,
* if a paintable is known to never change its size, it will set the * if a paintable is known to never change its size, it will set the
* %GDK_PAINTABLE_STATIC_SIZE flag. * %GDK_PAINTABLE_STATIC_SIZE flag.
* *
@ -529,7 +529,7 @@ gdk_paintable_compute_concrete_size (GdkPaintable *paintable,
* the missing dimension is calculated from the present * the missing dimension is calculated from the present
* dimension and the intrinsic aspect ratio. * dimension and the intrinsic aspect ratio.
* Otherwise, the missing dimension is taken from the default * Otherwise, the missing dimension is taken from the default
* object size. * object size.
*/ */
if (image_width) if (image_width)
*concrete_width = image_width; *concrete_width = image_width;
@ -559,7 +559,7 @@ gdk_paintable_compute_concrete_size (GdkPaintable *paintable,
* dimensions, the missing dimension is taken from the object's intrinsic * dimensions, the missing dimension is taken from the object's intrinsic
* dimensions. * dimensions.
* Otherwise, the missing dimension of the concrete object size is taken * Otherwise, the missing dimension of the concrete object size is taken
* from the default object size. * from the default object size.
*/ */
if (specified_width) if (specified_width)
{ {

6
gdk/gdkpaintable.h
View File

@ -37,10 +37,10 @@ G_DECLARE_INTERFACE (GdkPaintable, gdk_paintable, GDK, PAINTABLE, GObject)
/** /**
* GdkPaintableFlags: * GdkPaintableFlags:
* @GDK_PAINTABLE_STATIC_SIZE: The size is immutable. * @GDK_PAINTABLE_STATIC_SIZE: The size is immutable.
* The [signal@GdkPaintable::invalidate-size] signal will never be * The [signal@Gdk.Paintable::invalidate-size] signal will never be
* emitted. * emitted.
* @GDK_PAINTABLE_STATIC_CONTENTS: The content is immutable. * @GDK_PAINTABLE_STATIC_CONTENTS: The content is immutable.
* The [signal@GdkPaintable::invalidate-contents] signal will never be * The [signal@Gdk.Paintable::invalidate-contents] signal will never be
* emitted. * emitted.
* *
* Flags about a paintable object. * Flags about a paintable object.
@ -97,7 +97,7 @@ struct _GdkPaintableInterface
double height); double height);
/* get the current contents in an immutable form (optional) */ /* get the current contents in an immutable form (optional) */
GdkPaintable * (* get_current_image) (GdkPaintable *paintable); GdkPaintable * (* get_current_image) (GdkPaintable *paintable);
/* get flags for potential optimizations (optional) */ /* get flags for potential optimizations (optional) */
GdkPaintableFlags (* get_flags) (GdkPaintable *paintable); GdkPaintableFlags (* get_flags) (GdkPaintable *paintable);
/* preferred width of paintable or 0 if it has no width (optional) */ /* preferred width of paintable or 0 if it has no width (optional) */

4
gdk/gdkpopup.c
View File

@ -31,7 +31,7 @@
* The `GdkPopup` is positioned relative to its parent surface. * The `GdkPopup` is positioned relative to its parent surface.
* *
* `GdkPopup`s are typically used to implement menus and similar popups. * `GdkPopup`s are typically used to implement menus and similar popups.
* They can be modal, which is indicated by the [property@GdkPopup:autohide] * They can be modal, which is indicated by the [property@Gdk.Popup:autohide]
* property. * property.
*/ */
@ -113,7 +113,7 @@ gdk_popup_default_init (GdkPopupInterface *iface)
* otherwise it will change position according to @layout. * otherwise it will change position according to @layout.
* *
* After calling this function, the result should be handled in response * After calling this function, the result should be handled in response
* to the [signal@GdkSurface::layout] signal being emitted. The resulting * to the [signal@Gdk.Surface::layout] signal being emitted. The resulting
* popup position can be queried using [method@Gdk.Popup.get_position_x], * popup position can be queried using [method@Gdk.Popup.get_position_x],
* [method@Gdk.Popup.get_position_y], and the resulting size will be sent as * [method@Gdk.Popup.get_position_y], and the resulting size will be sent as
* parameters in the layout signal. Use [method@Gdk.Popup.get_rect_anchor] * parameters in the layout signal. Use [method@Gdk.Popup.get_rect_anchor]

2
gtk/deprecated/gtkcellarea.c
View File

@ -235,7 +235,7 @@
* button events, however some customized derived areas can be implemented * button events, however some customized derived areas can be implemented
* who are interested in handling other events. Handling an event can * who are interested in handling other events. Handling an event can
* trigger the [`signal@Gtk.CellArea::focus-changed`] signal to fire; as well * trigger the [`signal@Gtk.CellArea::focus-changed`] signal to fire; as well
* as [`signal@GtkCellArea::add-editable`] in the case that an editable cell * as [`signal@Gtk.CellArea::add-editable`] in the case that an editable cell
* was clicked and needs to start editing. You can call * was clicked and needs to start editing. You can call
* [method@Gtk.CellArea.stop_editing] at any time to cancel any cell editing * [method@Gtk.CellArea.stop_editing] at any time to cancel any cell editing
* that is currently in progress. * that is currently in progress.

56
gtk/deprecated/gtkfontchooser.c
View File

@ -37,7 +37,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
* [class@Gtk.FontChooserWidget], [class@Gtk.FontChooserDialog] and * [class@Gtk.FontChooserWidget], [class@Gtk.FontChooserDialog] and
* [class@Gtk.FontButton]. * [class@Gtk.FontButton].
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
@ -60,7 +60,7 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* *
* The font description as a string, e.g. "Sans Italic 12". * The font description as a string, e.g. "Sans Italic 12".
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/ */
g_object_interface_install_property g_object_interface_install_property
(iface, (iface,
@ -73,7 +73,7 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* *
* The font description as a `PangoFontDescription`. * The font description as a `PangoFontDescription`.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/ */
g_object_interface_install_property g_object_interface_install_property
(iface, (iface,
@ -86,7 +86,7 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* *
* The string with which to preview the font. * The string with which to preview the font.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/ */
g_object_interface_install_property g_object_interface_install_property
(iface, (iface,
@ -99,7 +99,7 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* *
* Whether to show an entry to change the preview text. * Whether to show an entry to change the preview text.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/ */
g_object_interface_install_property g_object_interface_install_property
(iface, (iface,
@ -112,7 +112,7 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* *
* The level of granularity to offer for selecting fonts. * The level of granularity to offer for selecting fonts.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/ */
g_object_interface_install_property g_object_interface_install_property
(iface, (iface,
@ -131,7 +131,7 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* The format of the string is compatible with * The format of the string is compatible with
* CSS and with Pango attributes. * CSS and with Pango attributes.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/ */
g_object_interface_install_property g_object_interface_install_property
(iface, (iface,
@ -144,7 +144,7 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* *
* The language for which the font features were selected. * The language for which the font features were selected.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/ */
g_object_interface_install_property g_object_interface_install_property
(iface, (iface,
@ -163,7 +163,7 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* or an item is selected and the user presses one of the keys * or an item is selected and the user presses one of the keys
* Space, Shift+Space, Return or Enter. * Space, Shift+Space, Return or Enter.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] instead * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton] instead
*/ */
chooser_signals[SIGNAL_FONT_ACTIVATED] = chooser_signals[SIGNAL_FONT_ACTIVATED] =
g_signal_new (I_("font-activated"), g_signal_new (I_("font-activated"),
@ -189,7 +189,7 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface)
* Returns: (nullable) (transfer none): A `PangoFontFamily` representing the * Returns: (nullable) (transfer none): A `PangoFontFamily` representing the
* selected font family * selected font family
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
PangoFontFamily * PangoFontFamily *
@ -212,7 +212,7 @@ gtk_font_chooser_get_font_family (GtkFontChooser *fontchooser)
* Returns: (nullable) (transfer none): A `PangoFontFace` representing the * Returns: (nullable) (transfer none): A `PangoFontFace` representing the
* selected font group details * selected font group details
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
PangoFontFace * PangoFontFace *
@ -232,7 +232,7 @@ gtk_font_chooser_get_font_face (GtkFontChooser *fontchooser)
* Returns: A n integer representing the selected font size, * Returns: A n integer representing the selected font size,
* or -1 if no font size is selected. * or -1 if no font size is selected.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
int int
@ -261,7 +261,7 @@ gtk_font_chooser_get_font_size (GtkFontChooser *fontchooser)
* Returns: (nullable) (transfer full): A string with the name * Returns: (nullable) (transfer full): A string with the name
* of the current font * of the current font
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
char * char *
@ -284,7 +284,7 @@ gtk_font_chooser_get_font (GtkFontChooser *fontchooser)
* *
* Sets the currently-selected font. * Sets the currently-selected font.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
void void
@ -315,7 +315,7 @@ gtk_font_chooser_set_font (GtkFontChooser *fontchooser,
* Returns: (nullable) (transfer full): A `PangoFontDescription` for the * Returns: (nullable) (transfer full): A `PangoFontDescription` for the
* current font * current font
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
PangoFontDescription * PangoFontDescription *
@ -337,7 +337,7 @@ gtk_font_chooser_get_font_desc (GtkFontChooser *fontchooser)
* *
* Sets the currently-selected font from @font_desc. * Sets the currently-selected font from @font_desc.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
void void
@ -358,7 +358,7 @@ gtk_font_chooser_set_font_desc (GtkFontChooser *fontchooser,
* *
* Returns: (transfer full): the text displayed in the preview area * Returns: (transfer full): the text displayed in the preview area
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
char * char *
@ -382,7 +382,7 @@ gtk_font_chooser_get_preview_text (GtkFontChooser *fontchooser)
* *
* The @text is used to show how the selected font looks. * The @text is used to show how the selected font looks.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
void void
@ -403,7 +403,7 @@ gtk_font_chooser_set_preview_text (GtkFontChooser *fontchooser,
* *
* Returns: %TRUE if the preview entry is shown or %FALSE if it is hidden. * Returns: %TRUE if the preview entry is shown or %FALSE if it is hidden.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
gboolean gboolean
@ -425,7 +425,7 @@ gtk_font_chooser_get_show_preview_entry (GtkFontChooser *fontchooser)
* *
* Shows or hides the editable preview entry. * Shows or hides the editable preview entry.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
void void
@ -448,7 +448,7 @@ gtk_font_chooser_set_show_preview_entry (GtkFontChooser *fontchooser,
* Adds a filter function that decides which fonts to display * Adds a filter function that decides which fonts to display
* in the font chooser. * in the font chooser.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
void void
@ -505,7 +505,7 @@ _gtk_font_chooser_font_activated (GtkFontChooser *chooser,
* pango_context_set_font_map (context, fontmap); * pango_context_set_font_map (context, fontmap);
* ``` * ```
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
void void
@ -528,7 +528,7 @@ gtk_font_chooser_set_font_map (GtkFontChooser *fontchooser,
* *
* Returns: (nullable) (transfer full): a `PangoFontMap` * Returns: (nullable) (transfer full): a `PangoFontMap`
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
PangoFontMap * PangoFontMap *
@ -551,7 +551,7 @@ gtk_font_chooser_get_font_map (GtkFontChooser *fontchooser)
* *
* Sets the desired level of granularity for selecting fonts. * Sets the desired level of granularity for selecting fonts.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
void void
@ -571,7 +571,7 @@ gtk_font_chooser_set_level (GtkFontChooser *fontchooser,
* *
* Returns: the current granularity level * Returns: the current granularity level
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
GtkFontChooserLevel GtkFontChooserLevel
@ -598,7 +598,7 @@ gtk_font_chooser_get_level (GtkFontChooser *fontchooser)
* *
* Returns: the currently selected font features * Returns: the currently selected font features
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
char * char *
@ -621,7 +621,7 @@ gtk_font_chooser_get_font_features (GtkFontChooser *fontchooser)
* *
* Returns: the currently selected language * Returns: the currently selected language
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
char * char *
@ -643,7 +643,7 @@ gtk_font_chooser_get_language (GtkFontChooser *fontchooser)
* *
* Sets the language to use for font features. * Sets the language to use for font features.
* *
* Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@GtkFontDialogButton] * Deprecated: 4.10: Use [class@Gtk.FontDialog] and [class@Gtk.FontDialogButton]
* instead * instead
*/ */
void void

2
gtk/deprecated/gtkinfobar.c
View File

@ -126,7 +126,7 @@ G_GNUC_BEGIN_IGNORE_DEPRECATIONS
* style class applied. * style class applied.
* *
* Deprecated: 4.10: There is no replacement in GTK for an "info bar" widget; * Deprecated: 4.10: There is no replacement in GTK for an "info bar" widget;
* you can use [class@Gtk.Revealer] with a [class@GtkBox] containing a * you can use [class@Gtk.Revealer] with a [class@Gtk.Box] containing a
* [class@Gtk.Label] and an optional [class@Gtk.Button], according to * [class@Gtk.Label] and an optional [class@Gtk.Button], according to
* your application's design. * your application's design.
*/ */

2
gtk/gtkbuildable.h
View File

@ -105,7 +105,7 @@ struct _GtkBuildableParser
* @set_buildable_property: Sets a property of a buildable object. * @set_buildable_property: Sets a property of a buildable object.
* It is normally not necessary to implement this, g_object_set_property() * It is normally not necessary to implement this, g_object_set_property()
* is used by default. `GtkWindow` implements this to delay showing itself * is used by default. `GtkWindow` implements this to delay showing itself
* (i.e. setting the [property@GtkWidget:visible] property) until the whole * (i.e. setting the [property@Gtk.Widget:visible] property) until the whole
* interface is created. * interface is created.
* @construct_child: Constructs a child of a buildable that has been * @construct_child: Constructs a child of a buildable that has been
* specified as “constructor” in the UI definition. This can be used to * specified as “constructor” in the UI definition. This can be used to

2
gtk/gtklabel.c
View File

@ -2971,7 +2971,7 @@ label_mnemonic_widget_weak_notify (gpointer data,
* the label) you need to set it explicitly using this function. * the label) you need to set it explicitly using this function.
* *
* The target widget will be accelerated by emitting the * The target widget will be accelerated by emitting the
* [signal@GtkWidget::mnemonic-activate] signal on it. The default handler for * [signal@Gtk.Widget::mnemonic-activate] signal on it. The default handler for
* this signal will activate the widget if there are no mnemonic collisions * this signal will activate the widget if there are no mnemonic collisions
* and toggle focus between the colliding widgets otherwise. * and toggle focus between the colliding widgets otherwise.
*/ */

4
gtk/gtkpicture.c
View File

@ -68,8 +68,8 @@
* that paintables are never made smaller than their ideal size - but * that paintables are never made smaller than their ideal size - but
* be careful if you do not know the size of the paintable in use (like * be careful if you do not know the size of the paintable in use (like
* when displaying user-loaded images). This can easily cause the picture to * when displaying user-loaded images). This can easily cause the picture to
* grow larger than the screen. And [property@GtkWidget:halign] and * grow larger than the screen. And [property@Gtk.Widget:halign] and
* [property@GtkWidget:valign] can be used to make sure the paintable doesn't * [property@Gtk.Widget:valign] can be used to make sure the paintable doesn't
* fill all available space but is instead displayed at its original size. * fill all available space but is instead displayed at its original size.
* *
* ## CSS nodes * ## CSS nodes

48
gtk/gtkscale.c
View File

@ -51,7 +51,7 @@
* ![An example GtkScale](scales.png) * ![An example GtkScale](scales.png)
* *
* To use it, you’ll probably want to investigate the methods on its base * To use it, you’ll probably want to investigate the methods on its base
* class, [class@GtkRange], in addition to the methods for `GtkScale` itself. * class, [class@Gtk.Range], in addition to the methods for `GtkScale` itself.
* To set the value of a scale, you would normally use [method@Gtk.Range.set_value]. * To set the value of a scale, you would normally use [method@Gtk.Range.set_value].
* To detect changes to the value, you would normally use the * To detect changes to the value, you would normally use the
* [signal@Gtk.Range::value-changed] signal. * [signal@Gtk.Range::value-changed] signal.
@ -648,11 +648,11 @@ gtk_scale_class_init (GtkScaleClass *class)
GObjectClass *gobject_class; GObjectClass *gobject_class;
GtkWidgetClass *widget_class; GtkWidgetClass *widget_class;
GtkRangeClass *range_class; GtkRangeClass *range_class;
gobject_class = G_OBJECT_CLASS (class); gobject_class = G_OBJECT_CLASS (class);
range_class = (GtkRangeClass*) class; range_class = (GtkRangeClass*) class;
widget_class = (GtkWidgetClass*) class; widget_class = (GtkWidgetClass*) class;
gobject_class->set_property = gtk_scale_set_property; gobject_class->set_property = gtk_scale_set_property;
gobject_class->get_property = gtk_scale_get_property; gobject_class->get_property = gtk_scale_get_property;
gobject_class->notify = gtk_scale_notify; gobject_class->notify = gtk_scale_notify;
@ -715,7 +715,7 @@ gtk_scale_class_init (GtkScaleClass *class)
/* All bindings (even arrow keys) are on both h/v scale, because /* All bindings (even arrow keys) are on both h/v scale, because
* blind users etc. don't care about scale orientation. * blind users etc. don't care about scale orientation.
*/ */
add_slider_binding (binding_set, GDK_KEY_Left, 0, add_slider_binding (binding_set, GDK_KEY_Left, 0,
GTK_SCROLL_STEP_LEFT); GTK_SCROLL_STEP_LEFT);
@ -763,19 +763,19 @@ gtk_scale_class_init (GtkScaleClass *class)
add_slider_binding (binding_set, GDK_KEY_KP_Down, GDK_CONTROL_MASK, add_slider_binding (binding_set, GDK_KEY_KP_Down, GDK_CONTROL_MASK,
GTK_SCROLL_PAGE_DOWN); GTK_SCROLL_PAGE_DOWN);
add_slider_binding (binding_set, GDK_KEY_Page_Up, GDK_CONTROL_MASK, add_slider_binding (binding_set, GDK_KEY_Page_Up, GDK_CONTROL_MASK,
GTK_SCROLL_PAGE_LEFT); GTK_SCROLL_PAGE_LEFT);
add_slider_binding (binding_set, GDK_KEY_KP_Page_Up, GDK_CONTROL_MASK, add_slider_binding (binding_set, GDK_KEY_KP_Page_Up, GDK_CONTROL_MASK,
GTK_SCROLL_PAGE_LEFT); GTK_SCROLL_PAGE_LEFT);
add_slider_binding (binding_set, GDK_KEY_Page_Up, 0, add_slider_binding (binding_set, GDK_KEY_Page_Up, 0,
GTK_SCROLL_PAGE_UP); GTK_SCROLL_PAGE_UP);
add_slider_binding (binding_set, GDK_KEY_KP_Page_Up, 0, add_slider_binding (binding_set, GDK_KEY_KP_Page_Up, 0,
GTK_SCROLL_PAGE_UP); GTK_SCROLL_PAGE_UP);
add_slider_binding (binding_set, GDK_KEY_Page_Down, GDK_CONTROL_MASK, add_slider_binding (binding_set, GDK_KEY_Page_Down, GDK_CONTROL_MASK,
GTK_SCROLL_PAGE_RIGHT); GTK_SCROLL_PAGE_RIGHT);
@ -791,26 +791,26 @@ gtk_scale_class_init (GtkScaleClass *class)
/* Logical bindings (vs. visual bindings above) */ /* Logical bindings (vs. visual bindings above) */
add_slider_binding (binding_set, GDK_KEY_plus, 0, add_slider_binding (binding_set, GDK_KEY_plus, 0,
GTK_SCROLL_STEP_FORWARD); GTK_SCROLL_STEP_FORWARD);
add_slider_binding (binding_set, GDK_KEY_minus, 0, add_slider_binding (binding_set, GDK_KEY_minus, 0,
GTK_SCROLL_STEP_BACKWARD); GTK_SCROLL_STEP_BACKWARD);
add_slider_binding (binding_set, GDK_KEY_plus, GDK_CONTROL_MASK, add_slider_binding (binding_set, GDK_KEY_plus, GDK_CONTROL_MASK,
GTK_SCROLL_PAGE_FORWARD); GTK_SCROLL_PAGE_FORWARD);
add_slider_binding (binding_set, GDK_KEY_minus, GDK_CONTROL_MASK, add_slider_binding (binding_set, GDK_KEY_minus, GDK_CONTROL_MASK,
GTK_SCROLL_PAGE_BACKWARD); GTK_SCROLL_PAGE_BACKWARD);
add_slider_binding (binding_set, GDK_KEY_KP_Add, 0, add_slider_binding (binding_set, GDK_KEY_KP_Add, 0,
GTK_SCROLL_STEP_FORWARD); GTK_SCROLL_STEP_FORWARD);
add_slider_binding (binding_set, GDK_KEY_KP_Subtract, 0, add_slider_binding (binding_set, GDK_KEY_KP_Subtract, 0,
GTK_SCROLL_STEP_BACKWARD); GTK_SCROLL_STEP_BACKWARD);
add_slider_binding (binding_set, GDK_KEY_KP_Add, GDK_CONTROL_MASK, add_slider_binding (binding_set, GDK_KEY_KP_Add, GDK_CONTROL_MASK,
GTK_SCROLL_PAGE_FORWARD); GTK_SCROLL_PAGE_FORWARD);
add_slider_binding (binding_set, GDK_KEY_KP_Subtract, GDK_CONTROL_MASK, add_slider_binding (binding_set, GDK_KEY_KP_Subtract, GDK_CONTROL_MASK,
GTK_SCROLL_PAGE_BACKWARD); GTK_SCROLL_PAGE_BACKWARD);
@ -997,9 +997,9 @@ gtk_scale_new_with_range (GtkOrientation orientation,
* *
* Also causes the value of the adjustment to be rounded to this number * Also causes the value of the adjustment to be rounded to this number
* of digits, so the retrieved value matches the displayed one, if * of digits, so the retrieved value matches the displayed one, if
* [property@GtkScale:draw-value] is %TRUE when the value changes. If * [property@Gtk.Scale:draw-value] is %TRUE when the value changes. If
* you want to enforce rounding the value when [property@GtkScale:draw-value] * you want to enforce rounding the value when [property@Gtk.Scale:draw-value]
* is %FALSE, you can set [property@GtkRange:round-digits] instead. * is %FALSE, you can set [property@Gtk.Range:round-digits] instead.
* *
* Note that rounding to a small number of digits can interfere with * Note that rounding to a small number of digits can interfere with
* the smooth autoscrolling that is built into `GtkScale`. As an alternative, * the smooth autoscrolling that is built into `GtkScale`. As an alternative,
@ -1016,7 +1016,7 @@ gtk_scale_set_digits (GtkScale *scale,
g_return_if_fail (GTK_IS_SCALE (scale)); g_return_if_fail (GTK_IS_SCALE (scale));
range = GTK_RANGE (scale); range = GTK_RANGE (scale);
digits = CLAMP (digits, -1, MAX_DIGITS); digits = CLAMP (digits, -1, MAX_DIGITS);
if (priv->digits != digits) if (priv->digits != digits)
@ -1153,7 +1153,7 @@ gtk_scale_get_draw_value (GtkScale *scale)
* *
* Sets whether the scale has an origin. * Sets whether the scale has an origin.
* *
* If [property@GtkScale:has-origin] is set to %TRUE (the default), * If [property@Gtk.Scale:has-origin] is set to %TRUE (the default),
* the scale will highlight the part of the trough between the origin * the scale will highlight the part of the trough between the origin
* (bottom or left side) and the current value. * (bottom or left side) and the current value.
*/ */
@ -1562,7 +1562,7 @@ gtk_scale_finalize (GObject *object)
* to be freed by the caller. * to be freed by the caller.
* *
* Returns: (transfer none) (nullable): the [class@Pango.Layout] * Returns: (transfer none) (nullable): the [class@Pango.Layout]
* for this scale, or %NULL if the [property@GtkScale:draw-value] * for this scale, or %NULL if the [property@Gtk.Scale:draw-value]
* property is %FALSE. * property is %FALSE.
*/ */
PangoLayout * PangoLayout *
@ -1590,15 +1590,15 @@ gtk_scale_get_layout (GtkScale *scale)
* Remember when using the `PangoLayout` function you need to * Remember when using the `PangoLayout` function you need to
* convert to and from pixels using `PANGO_PIXELS()` or `PANGO_SCALE`. * convert to and from pixels using `PANGO_PIXELS()` or `PANGO_SCALE`.
* *
* If the [property@GtkScale:draw-value] property is %FALSE, the return * If the [property@Gtk.Scale:draw-value] property is %FALSE, the return
* values are undefined. * values are undefined.
*/ */
void void
gtk_scale_get_layout_offsets (GtkScale *scale, gtk_scale_get_layout_offsets (GtkScale *scale,
int *x, int *x,
int *y) int *y)
{ {
int local_x = 0; int local_x = 0;
int local_y = 0; int local_y = 0;
g_return_if_fail (GTK_IS_SCALE (scale)); g_return_if_fail (GTK_IS_SCALE (scale));
@ -1608,7 +1608,7 @@ gtk_scale_get_layout_offsets (GtkScale *scale,
if (x) if (x)
*x = local_x; *x = local_x;
if (y) if (y)
*y = local_y; *y = local_y;
} }
@ -2041,7 +2041,7 @@ gtk_scale_buildable_custom_finished (GtkBuildable *buildable,
* *
* If #NULL is passed as @func, the value will be displayed on * If #NULL is passed as @func, the value will be displayed on
* its own, rounded according to the value of the * its own, rounded according to the value of the
* [property@GtkScale:digits] property. * [property@Gtk.Scale:digits] property.
*/ */
void void
gtk_scale_set_format_value_func (GtkScale *scale, gtk_scale_set_format_value_func (GtkScale *scale,

6
gtk/gtkswitch.c
View File

@ -34,7 +34,7 @@
* empty area, or by dragging the handle. * empty area, or by dragging the handle.
* *
* `GtkSwitch` can also handle situations where the underlying state * `GtkSwitch` can also handle situations where the underlying state
* changes with a delay. See [signal@GtkSwitch::state-set] for details. * changes with a delay. See [signal@Gtk.Switch::state-set] for details.
* *
* # CSS nodes * # CSS nodes
* *
@ -246,7 +246,7 @@ gtk_switch_pan_gesture_pan (GtkGesturePan *gesture,
if (self->is_active) if (self->is_active)
offset += width / 2; offset += width / 2;
offset /= width / 2; offset /= width / 2;
/* constrain the handle within the trough width */ /* constrain the handle within the trough width */
self->handle_pos = CLAMP (offset, 0, 1.0); self->handle_pos = CLAMP (offset, 0, 1.0);
@ -526,7 +526,7 @@ gtk_switch_class_init (GtkSwitchClass *klass)
* *
* The backend state that is controlled by the switch. * The backend state that is controlled by the switch.
* *
* See [signal@GtkSwitch::state-set] for details. * See [signal@Gtk.Switch::state-set] for details.
*/ */
switch_props[PROP_STATE] = switch_props[PROP_STATE] =
g_param_spec_boolean ("state", NULL, NULL, g_param_spec_boolean ("state", NULL, NULL,

4
gtk/gtktextview.c
View File

@ -1002,7 +1002,7 @@ gtk_text_view_class_init (GtkTextViewClass *klass)
* A negative value of indent will produce a hanging indentation. * A negative value of indent will produce a hanging indentation.
* That is, the first line will have the full width, and subsequent * That is, the first line will have the full width, and subsequent
* lines will be indented by the absolute value of indent. * lines will be indented by the absolute value of indent.
* *
*/ */
g_object_class_install_property (gobject_class, g_object_class_install_property (gobject_class,
PROP_INDENT, PROP_INDENT,
@ -3759,7 +3759,7 @@ gtk_text_view_toggle_cursor_visible (GtkTextView *text_view)
* cursor, so you may want to turn the cursor off. * cursor, so you may want to turn the cursor off.
* *
* Note that this property may be overridden by the * Note that this property may be overridden by the
* [property@GtkSettings:gtk-keynav-use-caret] setting. * [property@Gtk.Settings:gtk-keynav-use-caret] setting.
*/ */
void void
gtk_text_view_set_cursor_visible (GtkTextView *text_view, gtk_text_view_set_cursor_visible (GtkTextView *text_view,

2
gtk/gtktogglebutton.c
View File

@ -391,7 +391,7 @@ gtk_toggle_button_new_with_mnemonic (const char *label)
* and %FALSE to raise it. * and %FALSE to raise it.
* *
* If the status of the button changes, this action causes the * If the status of the button changes, this action causes the
* [signal@GtkToggleButton::toggled] signal to be emitted. * [signal@Gtk.ToggleButton::toggled] signal to be emitted.
*/ */
void void
gtk_toggle_button_set_active (GtkToggleButton *toggle_button, gtk_toggle_button_set_active (GtkToggleButton *toggle_button,

10
gtk/gtkwidget.c
View File

@ -3859,7 +3859,7 @@ gtk_widget_ensure_allocate_on_children (GtkWidget *widget)
if (!priv->alloc_needed_on_child) if (!priv->alloc_needed_on_child)
return; return;
priv->alloc_needed_on_child = FALSE; priv->alloc_needed_on_child = FALSE;
for (child = _gtk_widget_get_first_child (widget); for (child = _gtk_widget_get_first_child (widget);
@ -4040,7 +4040,7 @@ gtk_widget_allocate (GtkWidget *widget,
{ {
gtk_widget_ensure_allocate_on_children (widget); gtk_widget_ensure_allocate_on_children (widget);
} }
else else
{ {
priv->width = adjusted.width; priv->width = adjusted.width;
priv->height = adjusted.height; priv->height = adjusted.height;
@ -4084,7 +4084,7 @@ gtk_widget_allocate (GtkWidget *widget,
if (size_changed || baseline_changed) if (size_changed || baseline_changed)
gtk_widget_queue_draw (widget); gtk_widget_queue_draw (widget);
} }
if (transform_changed && priv->parent) if (transform_changed && priv->parent)
gtk_widget_queue_draw (priv->parent); gtk_widget_queue_draw (priv->parent);
@ -4254,7 +4254,7 @@ gtk_widget_compute_point (GtkWidget *widget,
* This function is a convenience wrapper around * This function is a convenience wrapper around
* [method@Gtk.WidgetClass.add_shortcut] and must be called during class * [method@Gtk.WidgetClass.add_shortcut] and must be called during class
* initialization. It does not provide for user_data, if you need that, * initialization. It does not provide for user_data, if you need that,
* you will have to use [method@GtkWidgetClass.add_shortcut] with a custom * you will have to use [method@Gtk.WidgetClass.add_shortcut] with a custom
* shortcut. * shortcut.
*/ */
void void
@ -11377,7 +11377,7 @@ gtk_widget_class_bind_template_callback_full (GtkWidgetClass *widget_class,
* this class’s template data. * this class’s template data.
* *
* Note that this must be called from a composite widget classes class * Note that this must be called from a composite widget classes class
* initializer after calling [method@GtkWidgetClass.set_template]. * initializer after calling [method@Gtk.WidgetClass.set_template].
*/ */
void void
gtk_widget_class_set_template_scope (GtkWidgetClass *widget_class, gtk_widget_class_set_template_scope (GtkWidgetClass *widget_class,