mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-12-25 21:21:21 +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.
|
||||
*
|
||||
* 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] =
|
||||
g_param_spec_object ("logo", NULL, NULL,
|
||||
|
@ -89,7 +89,7 @@
|
||||
* ## GtkExpression in GObject properties
|
||||
*
|
||||
* 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:
|
||||
*
|
||||
* ```c
|
||||
@ -103,8 +103,8 @@
|
||||
* ```
|
||||
*
|
||||
* When implementing the `GObjectClass.set_property` and `GObjectClass.get_property`
|
||||
* virtual functions, you must use [id@gtk_value_get_expression], to retrieve the
|
||||
* stored `GtkExpression` from the `GValue` container, and [id@gtk_value_set_expression],
|
||||
* virtual functions, you must use [func@Gtk.value_get_expression], to retrieve the
|
||||
* stored `GtkExpression` from the `GValue` container, and [func@Gtk.value_set_expression],
|
||||
* to store the `GtkExpression` into the `GValue`; for instance:
|
||||
*
|
||||
* ```c
|
||||
|
@ -247,7 +247,7 @@ static gboolean do_setlocale = TRUE;
|
||||
/**
|
||||
* 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, "")`.
|
||||
*
|
||||
* 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
|
||||
* 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].
|
||||
*
|
||||
* # CSS Nodes
|
||||
@ -543,7 +543,7 @@ add_arrow_bindings (GtkWidgetClass *widget_class,
|
||||
GtkDirectionType direction)
|
||||
{
|
||||
guint keypad_keysym = keysym - GDK_KEY_Left + GDK_KEY_KP_Left;
|
||||
|
||||
|
||||
gtk_widget_class_add_binding_signal (widget_class, keysym, 0,
|
||||
"move-focus",
|
||||
"(i)", direction);
|
||||
|
@ -608,7 +608,7 @@ gtk_widget_get_request_mode (GtkWidget *widget)
|
||||
* the required height for the natural width is generally smaller than the
|
||||
* 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
|
||||
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:
|
||||
*
|
||||
* 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.
|
||||
* Because the preferred widths for each widget depend on the preferred
|
||||
* widths of their children, this information propagates up the hierarchy,
|
||||
* 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
|
||||
* 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
|
||||
* 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
|
||||
@ -223,7 +223,7 @@
|
||||
* to do it.
|
||||
*
|
||||
* 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
|
||||
* so forth.
|
||||
*
|
||||
@ -240,7 +240,7 @@
|
||||
*
|
||||
* 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
|
||||
* 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
|
||||
* appears at the position.
|
||||
*
|
||||
@ -405,7 +405,7 @@
|
||||
* ```
|
||||
*
|
||||
* 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
|
||||
* name as the widget in the template definition, and call
|
||||
* [method@Gtk.WidgetClass.bind_template_child_full] (or one of its wrapper macros
|
||||
|
Loading…
Reference in New Issue
Block a user