diff options
author | Matthias Clasen <mclasen@redhat.com> | 2021-03-01 01:36:51 -0500 |
---|---|---|
committer | Emmanuele Bassi <ebassi@gnome.org> | 2021-03-11 16:37:36 +0000 |
commit | 207a45b7e05356ecb10bbe63846860d3a35f771c (patch) | |
tree | 19eab371afaf7259a7e42e675724d9096c0ba58b /gtk/gtkeventcontrollermotion.c | |
parent | 32b3386d2315c42d0d41c5236a34675018dc95a6 (diff) | |
download | gtk+-207a45b7e05356ecb10bbe63846860d3a35f771c.tar.gz |
eventcontrollermotion: Convert docs
Diffstat (limited to 'gtk/gtkeventcontrollermotion.c')
-rw-r--r-- | gtk/gtkeventcontrollermotion.c | 52 |
1 files changed, 29 insertions, 23 deletions
diff --git a/gtk/gtkeventcontrollermotion.c b/gtk/gtkeventcontrollermotion.c index 86c38c1048..47aee49149 100644 --- a/gtk/gtkeventcontrollermotion.c +++ b/gtk/gtkeventcontrollermotion.c @@ -18,14 +18,18 @@ */ /** - * SECTION:gtkeventcontrollermotion - * @Short_description: Event controller for motion events - * @Title: GtkEventControllerMotion - * @See_also: #GtkEventController + * GtkEventControllerMotion: * - * #GtkEventControllerMotion is an event controller meant for situations - * where you need to track the position of the pointer. - **/ + * `GtkEventControllerMotion` is an event controller tracking the pointer + * position. + * + * The event controller offers [signal@Gtk.EventControllerMotion::enter] + * and [signal@Gtk.EventControllerMotion::leave] signals, as well as + * [property@Gtk.EventControllerMotion:is-pointer] and + * [property@Gtk.EventControllerMotion:contains-pointer] properties + * which are updated to reflect changes in the pointer position as it + * moves over the widget. + */ #include "config.h" #include "gtkintl.h" @@ -191,15 +195,16 @@ gtk_event_controller_motion_class_init (GtkEventControllerMotionClass *klass) controller_class->handle_crossing = gtk_event_controller_motion_handle_crossing; /** - * GtkEventControllerMotion:is-pointer: + * GtkEventControllerMotion:is-pointer: (attributes org.gtk.Property.get=gtk_event_controller_motion_is_pointer) * * Whether the pointer is in the controllers widget itself, - * as opposed to in a descendent widget. See also - * #GtkEventControllerMotion:contains-pointer. + * as opposed to in a descendent widget. + * + * See also [property@Gtk.EventControllerMotion:contains-pointer]. * * When handling crossing events, this property is updated - * before #GtkEventControllerMotion::enter but after - * #GtkEventControllerMotion::leave is emitted. + * before [signal@Gtk.EventControllerMotion::enter], but after + * [signal@Gtk.EventControllerMotion::leave] is emitted. */ props[PROP_IS_POINTER] = g_param_spec_boolean ("is-pointer", @@ -209,14 +214,15 @@ gtk_event_controller_motion_class_init (GtkEventControllerMotionClass *klass) G_PARAM_READABLE); /** - * GtkEventControllerMotion:contains-pointer: + * GtkEventControllerMotion:contains-pointer: (attributes org.gtk.Property.get=gtk_event_controller_motion_contains_pointer) * * Whether the pointer is in the controllers widget or a descendant. - * See also #GtkEventControllerMotion:is-pointer. + * + * See also [property@Gtk.EventControllerMotion:is-pointer]. * * When handling crossing events, this property is updated - * before #GtkEventControllerMotion::enter but after - * #GtkEventControllerMotion::leave is emitted. + * before [signal@Gtk.EventControllerMotion::enter], but after + * [signal@Gtk.EventControllerMotion::leave] is emitted. */ props[PROP_CONTAINS_POINTER] = g_param_spec_boolean ("contains-pointer", @@ -289,7 +295,7 @@ gtk_event_controller_motion_init (GtkEventControllerMotion *motion) * * Creates a new event controller that will handle motion events. * - * Returns: a new #GtkEventControllerMotion + * Returns: a new `GtkEventControllerMotion` **/ GtkEventController * gtk_event_controller_motion_new (void) @@ -299,10 +305,10 @@ gtk_event_controller_motion_new (void) } /** - * gtk_event_controller_motion_contains_pointer: - * @self: a #GtkEventControllerMotion + * gtk_event_controller_motion_contains_pointer: (attributes org.gtk.Method.get_property=contains-pointer) + * @self: a `GtkEventControllerMotion` * - * Returns the value of the GtkEventControllerMotion:contains-pointer property. + * Returns if a pointer is within @self or one of its children. * * Returns: %TRUE if a pointer is within @self or one of its children */ @@ -315,10 +321,10 @@ gtk_event_controller_motion_contains_pointer (GtkEventControllerMotion *self) } /** - * gtk_event_controller_motion_is_pointer: - * @self: a #GtkEventControllerMotion + * gtk_event_controller_motion_is_pointer: (attributes org.gtk.Method.get_property=is-pointer) + * @self: a `GtkEventControllerMotion` * - * Returns the value of the GtkEventControllerMotion:is-pointer property. + * Returns if a pointer is within @self, but not one of its children. * * Returns: %TRUE if a pointer is within @self but not one of its children */ |