mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-12-26 21:51:08 +00:00
docs: Stop using C symbols as links
They are much harder for the bindings to figure out the type back from it and usually just break
This commit is contained in:
parent
f2578fcfb9
commit
5516ff6a02
@ -566,7 +566,7 @@ gtk_about_dialog_class_init (GtkAboutDialogClass *klass)
|
|||||||
* A logo for the about box.
|
* A logo for the about box.
|
||||||
*
|
*
|
||||||
* If it is `NULL`, the default window icon set with
|
* If it is `NULL`, the default window icon set with
|
||||||
* [id@gtk_window_set_default_icon_name] will be used.
|
* [func@Gtk.Window.set_default_icon_name] will be used.
|
||||||
*/
|
*/
|
||||||
props[PROP_LOGO] =
|
props[PROP_LOGO] =
|
||||||
g_param_spec_object ("logo", NULL, NULL,
|
g_param_spec_object ("logo", NULL, NULL,
|
||||||
|
@ -89,7 +89,7 @@
|
|||||||
* ## GtkExpression in GObject properties
|
* ## GtkExpression in GObject properties
|
||||||
*
|
*
|
||||||
* In order to use a `GtkExpression` as a `GObject` property, you must use the
|
* In order to use a `GtkExpression` as a `GObject` property, you must use the
|
||||||
* [id@gtk_param_spec_expression] when creating a `GParamSpec` to install in the
|
* [func@Gtk.param_spec_expression] when creating a `GParamSpec` to install in the
|
||||||
* `GObject` class being defined; for instance:
|
* `GObject` class being defined; for instance:
|
||||||
*
|
*
|
||||||
* ```c
|
* ```c
|
||||||
@ -103,8 +103,8 @@
|
|||||||
* ```
|
* ```
|
||||||
*
|
*
|
||||||
* When implementing the `GObjectClass.set_property` and `GObjectClass.get_property`
|
* When implementing the `GObjectClass.set_property` and `GObjectClass.get_property`
|
||||||
* virtual functions, you must use [id@gtk_value_get_expression], to retrieve the
|
* virtual functions, you must use [func@Gtk.value_get_expression], to retrieve the
|
||||||
* stored `GtkExpression` from the `GValue` container, and [id@gtk_value_set_expression],
|
* stored `GtkExpression` from the `GValue` container, and [func@Gtk.value_set_expression],
|
||||||
* to store the `GtkExpression` into the `GValue`; for instance:
|
* to store the `GtkExpression` into the `GValue`; for instance:
|
||||||
*
|
*
|
||||||
* ```c
|
* ```c
|
||||||
|
@ -247,7 +247,7 @@ static gboolean do_setlocale = TRUE;
|
|||||||
/**
|
/**
|
||||||
* gtk_disable_setlocale:
|
* gtk_disable_setlocale:
|
||||||
*
|
*
|
||||||
* Prevents [id@gtk_init] and [id@gtk_init_check] from automatically calling
|
* Prevents [func@Gtk.init] and [func@Gtk.init_check] from automatically calling
|
||||||
* `setlocale (LC_ALL, "")`.
|
* `setlocale (LC_ALL, "")`.
|
||||||
*
|
*
|
||||||
* You would want to use this function if you wanted to set the locale for
|
* You would want to use this function if you wanted to set the locale for
|
||||||
|
@ -128,7 +128,7 @@
|
|||||||
*
|
*
|
||||||
* Menu items will also show accelerators, which are usually associated
|
* Menu items will also show accelerators, which are usually associated
|
||||||
* with actions via [method@Gtk.Application.set_accels_for_action],
|
* with actions via [method@Gtk.Application.set_accels_for_action],
|
||||||
* [id@gtk_widget_class_add_binding_action] or
|
* [method@WidgetClass.add_binding_action] or
|
||||||
* [method@Gtk.ShortcutController.add_shortcut].
|
* [method@Gtk.ShortcutController.add_shortcut].
|
||||||
*
|
*
|
||||||
* # CSS Nodes
|
* # CSS Nodes
|
||||||
|
@ -608,7 +608,7 @@ gtk_widget_get_request_mode (GtkWidget *widget)
|
|||||||
* the required height for the natural width is generally smaller than the
|
* the required height for the natural width is generally smaller than the
|
||||||
* required height for the minimum width.
|
* required height for the minimum width.
|
||||||
*
|
*
|
||||||
* Use [id@gtk_widget_measure] if you want to support baseline alignment.
|
* Use [method@Gtk.Widget.measure] if you want to support baseline alignment.
|
||||||
*/
|
*/
|
||||||
void
|
void
|
||||||
gtk_widget_get_preferred_size (GtkWidget *widget,
|
gtk_widget_get_preferred_size (GtkWidget *widget,
|
||||||
|
@ -126,13 +126,13 @@
|
|||||||
* For example, when queried in the normal %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH mode:
|
* For example, when queried in the normal %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH mode:
|
||||||
*
|
*
|
||||||
* First, the default minimum and natural width for each widget
|
* First, the default minimum and natural width for each widget
|
||||||
* in the interface will be computed using [id@gtk_widget_measure] with an
|
* in the interface will be computed using [method@Gtk.Widget.measure] with an
|
||||||
* orientation of %GTK_ORIENTATION_HORIZONTAL and a for_size of -1.
|
* orientation of %GTK_ORIENTATION_HORIZONTAL and a for_size of -1.
|
||||||
* Because the preferred widths for each widget depend on the preferred
|
* Because the preferred widths for each widget depend on the preferred
|
||||||
* widths of their children, this information propagates up the hierarchy,
|
* widths of their children, this information propagates up the hierarchy,
|
||||||
* and finally a minimum and natural width is determined for the entire
|
* and finally a minimum and natural width is determined for the entire
|
||||||
* toplevel. Next, the toplevel will use the minimum width to query for the
|
* toplevel. Next, the toplevel will use the minimum width to query for the
|
||||||
* minimum height contextual to that width using [id@gtk_widget_measure] with an
|
* minimum height contextual to that width using [method@Gtk.Widget.measure] with an
|
||||||
* orientation of %GTK_ORIENTATION_VERTICAL and a for_size of the just computed
|
* orientation of %GTK_ORIENTATION_VERTICAL and a for_size of the just computed
|
||||||
* width. This will also be a highly recursive operation. The minimum height
|
* width. This will also be a highly recursive operation. The minimum height
|
||||||
* for the minimum width is normally used to set the minimum size constraint
|
* for the minimum width is normally used to set the minimum size constraint
|
||||||
@ -223,7 +223,7 @@
|
|||||||
* to do it.
|
* to do it.
|
||||||
*
|
*
|
||||||
* Of course if you are getting the size request for another widget, such
|
* Of course if you are getting the size request for another widget, such
|
||||||
* as a child widget, you must use [id@gtk_widget_measure]; otherwise, you
|
* as a child widget, you must use [method@Gtk.Widget.measure]; otherwise, you
|
||||||
* would not properly consider widget margins, [class@Gtk.SizeGroup], and
|
* would not properly consider widget margins, [class@Gtk.SizeGroup], and
|
||||||
* so forth.
|
* so forth.
|
||||||
*
|
*
|
||||||
@ -240,7 +240,7 @@
|
|||||||
*
|
*
|
||||||
* If a widget ends up baseline aligned it will be allocated all the space in
|
* If a widget ends up baseline aligned it will be allocated all the space in
|
||||||
* the parent as if it was %GTK_ALIGN_FILL, but the selected baseline can be
|
* the parent as if it was %GTK_ALIGN_FILL, but the selected baseline can be
|
||||||
* found via [id@gtk_widget_get_baseline]. If the baseline has a
|
* found via [method@Gtk.Widget.get_baseline]. If the baseline has a
|
||||||
* value other than -1 you need to align the widget such that the baseline
|
* value other than -1 you need to align the widget such that the baseline
|
||||||
* appears at the position.
|
* appears at the position.
|
||||||
*
|
*
|
||||||
@ -405,7 +405,7 @@
|
|||||||
* ```
|
* ```
|
||||||
*
|
*
|
||||||
* You can access widgets defined in the template using the
|
* You can access widgets defined in the template using the
|
||||||
* [id@gtk_widget_get_template_child] function, but you will typically declare
|
* [method@Gtk.Widget.get_template_child] function, but you will typically declare
|
||||||
* a pointer in the instance private data structure of your type using the same
|
* a pointer in the instance private data structure of your type using the same
|
||||||
* name as the widget in the template definition, and call
|
* name as the widget in the template definition, and call
|
||||||
* [method@Gtk.WidgetClass.bind_template_child_full] (or one of its wrapper macros
|
* [method@Gtk.WidgetClass.bind_template_child_full] (or one of its wrapper macros
|
||||||
|
Loading…
Reference in New Issue
Block a user