Function
ClapperGtkget_player_from_ancestor
Declaration [src]
ClapperPlayer*
clapper_gtk_get_player_from_ancestor (
GtkWidget* widget
)
Description [src]
Get ClapperPlayer used by ClapperGtkAv ancestor of widget.
This utility is a convenience wrapper for calling gtk_widget_get_ancestor()
of type CLAPPER_GTK_TYPE_AV and clapper_gtk_av_get_player() with
additional NULL checking and type casting.
This is meant to be used mainly for custom widget development as an easy access to the
underlying parent ClapperPlayer object. If you want to get the player from
ClapperGtkAv widget itself, use clapper_gtk_av_get_player() instead.
Rememeber that this function will return NULL when widget does not have
a ClapperGtkAv ancestor in widget hierarchy (widget is not yet placed).
Parameters
widget-
Type:
GtkWidgetA
GtkWidget.The data is owned by the caller of the function.
Return value
Type: ClapperPlayer
A ClapperPlayer from ancestor of a widget.
| The data is owned by the called function. |
The return value can be NULL. |