Signal
ClapperGtkExtraMenuButton::open-subtitles
Declaration
void
open_subtitles (
ClapperGtkExtraMenuButton* self,
ClapperMediaItem* item,
gpointer user_data
)
Description [src]
A signal that user wants to open subtitles file.
Implementation should add a way for user to select subtitles to open
such as by e.g. using GtkFileDialog
and then add them to the
item
using clapper_media_item_set_suburi()
method.
This signal will pass the ClapperMediaItem
that was current when
user clicked the open button and subtitles should be added to this item
.
This avoids situations where another item starts playing before user selects
subtitles file to be opened. When using asynchronous operations to open file,
implementation should g_object_ref()
the item to ensure that it
stays valid until finish.
Note that this signal will not be emitted if open button is not visible by
setting clapper_gtk_extra_menu_button_set_can_open_subtitles()
to TRUE
,
so you do not have to implement handler for it otherwise.
Parameters
item
-
Type:
ClapperMediaItem
A
ClapperMediaItem
.The data is owned by the caller of the function.