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:
ClapperMediaItemA
ClapperMediaItem.The data is owned by the caller of the function.