clutter/stage: Add nullable annotation to get_*_actor methods

Allows to know when a NULL ClutterActor is possibly being returned.

Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/2559>
This commit is contained in:
Corentin Noël 2022-08-07 19:39:18 +02:00 committed by Marge Bot
parent 5356bc865f
commit 8fcee7a8a5
2 changed files with 3 additions and 7 deletions

View File

@ -3296,7 +3296,7 @@ clutter_stage_remove_device_entry (ClutterStage *self,
* Retrieves the [class@Clutter.Actor] underneath the pointer or touch point * Retrieves the [class@Clutter.Actor] underneath the pointer or touch point
* of @device and @sequence. * of @device and @sequence.
* *
* Return value: (transfer none): a pointer to the #ClutterActor or %NULL * Returns: (transfer none) (nullable): a pointer to the #ClutterActor or %NULL
*/ */
ClutterActor * ClutterActor *
clutter_stage_get_device_actor (ClutterStage *stage, clutter_stage_get_device_actor (ClutterStage *stage,
@ -3905,7 +3905,7 @@ clutter_grab_get_seat_state (ClutterGrab *grab)
* *
* Gets the actor that currently holds a grab. * Gets the actor that currently holds a grab.
* *
* Returns: (transfer none): The grabbing actor * Returns: (transfer none) (nullable): The grabbing actor
**/ **/
ClutterActor * ClutterActor *
clutter_stage_get_grab_actor (ClutterStage *stage) clutter_stage_get_grab_actor (ClutterStage *stage)
@ -3933,7 +3933,7 @@ clutter_stage_get_grab_actor (ClutterStage *stage)
* and may differ from the actor that the stage originally * and may differ from the actor that the stage originally
* delivered the event to. * delivered the event to.
* *
* Return value: (transfer none): a pointer to the #ClutterActor or %NULL * Returns: (transfer none) (nullable): a pointer to the #ClutterActor or %NULL
**/ **/
ClutterActor * ClutterActor *
clutter_stage_get_event_actor (ClutterStage *stage, clutter_stage_get_event_actor (ClutterStage *stage,

View File

@ -168,10 +168,6 @@ void clutter_stage_set_minimum_size (ClutterStage
guint width, guint width,
guint height); guint height);
CLUTTER_EXPORT CLUTTER_EXPORT
void clutter_stage_get_minimum_size (ClutterStage *stage,
guint *width,
guint *height);
CLUTTER_EXPORT
void clutter_stage_set_key_focus (ClutterStage *stage, void clutter_stage_set_key_focus (ClutterStage *stage,
ClutterActor *actor); ClutterActor *actor);
CLUTTER_EXPORT CLUTTER_EXPORT