luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-11-09 19:06:15 +01:00
Code Issues Packages Projects Releases Wiki Activity

docs: Fix g_object_connect()'s docblock

Browse Source
This commit is contained in:
Emmanuele Bassi 2024-04-08 12:05:31 +00:00 committed by Philip Withnall
parent 159d51984b
commit b37312f7e4
1 changed files with 25 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
gobject/gobject.c
View File

@ -3466,35 +3466,37 @@ g_object_get_property (GObject *object,
* g_object_connect: (skip) * g_object_connect: (skip)
* @object: (type GObject.Object): a #GObject * @object: (type GObject.Object): a #GObject
* @signal_spec: the spec for the first signal * @signal_spec: the spec for the first signal
* @...: #GCallback for the first signal, followed by data for the * @...: [type@GObject.Callback] for the first signal, followed by data for the
* first signal, followed optionally by more signal * first signal, followed optionally by more signal
* spec/callback/data triples, followed by %NULL * spec/callback/data triples, followed by `NULL`
* *
* A convenience function to connect multiple signals at once. * A convenience function to connect multiple signals at once.
* *
* The signal specs expected by this function have the form * The signal specs expected by this function have the form
* "modifier::signal_name", where modifier can be one of the following: * `modifier::signal_name`, where `modifier` can be one of the
* - signal: equivalent to g_signal_connect_data (..., NULL, G_CONNECT_DEFAULT) * following:
* - object-signal, object_signal: equivalent to g_signal_connect_object (..., G_CONNECT_DEFAULT)
* - swapped-signal, swapped_signal: equivalent to g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED)
* - swapped_object_signal, swapped-object-signal: equivalent to g_signal_connect_object (..., G_CONNECT_SWAPPED)
* - signal_after, signal-after: equivalent to g_signal_connect_data (..., NULL, G_CONNECT_AFTER)
* - object_signal_after, object-signal-after: equivalent to g_signal_connect_object (..., G_CONNECT_AFTER)
* - swapped_signal_after, swapped-signal-after: equivalent to g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED | G_CONNECT_AFTER)
* - swapped_object_signal_after, swapped-object-signal-after: equivalent to g_signal_connect_object (..., G_CONNECT_SWAPPED | G_CONNECT_AFTER)
* *
* |[<!-- language="C" --> * - `signal`: equivalent to `g_signal_connect_data (..., NULL, G_CONNECT_DEFAULT)`
* menu->toplevel = g_object_connect (g_object_new (GTK_TYPE_WINDOW, * - `object-signal`, `object_signal`: equivalent to `g_signal_connect_object (..., G_CONNECT_DEFAULT)`
* "type", GTK_WINDOW_POPUP, * - `swapped-signal`, `swapped_signal`: equivalent to `g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED)`
* "child", menu, * - `swapped_object_signal`, `swapped-object-signal`: equivalent to `g_signal_connect_object (..., G_CONNECT_SWAPPED)`
* NULL), * - `signal_after`, `signal-after`: equivalent to `g_signal_connect_data (..., NULL, G_CONNECT_AFTER)`
* "signal::event", gtk_menu_window_event, menu, * - `object_signal_after`, `object-signal-after`: equivalent to `g_signal_connect_object (..., G_CONNECT_AFTER)`
* "signal::size_request", gtk_menu_window_size_request, menu, * - `swapped_signal_after`, `swapped-signal-after`: equivalent to `g_signal_connect_data (..., NULL, G_CONNECT_SWAPPED | G_CONNECT_AFTER)`
* "signal::destroy", gtk_widget_destroyed, &menu->toplevel, * - `swapped_object_signal_after`, `swapped-object-signal-after`: equivalent to `g_signal_connect_object (..., G_CONNECT_SWAPPED | G_CONNECT_AFTER)`
* NULL);
* ]|
* *
* Returns: (transfer none) (type GObject.Object): @object * ```c
* menu->toplevel = g_object_connect (g_object_new (GTK_TYPE_WINDOW,
* "type", GTK_WINDOW_POPUP,
* "child", menu,
* NULL),
* "signal::event", gtk_menu_window_event, menu,
* "signal::size_request", gtk_menu_window_size_request, menu,
* "signal::destroy", gtk_widget_destroyed, &menu->toplevel,
* NULL);
* ```
*
* Returns: (transfer none) (type GObject.Object): the object
*/ */
gpointer gpointer
g_object_connect (gpointer _object, g_object_connect (gpointer _object,