User dialogs core. More...

Include dependency graph for dialog.c:

Functions
int	dialog_Register (vlc_object_t *obj)
	Registers an object as the dialog provider.
int	dialog_Unregister (vlc_object_t *obj)
	Unregisters the dialog provider.
static vlc_object_t *	dialog_GetProvider (vlc_object_t *obj)
void	dialog_VFatal (vlc_object_t obj, bool modal, const char title, const char *fmt, va_list ap)
	Sends an error message through the user interface (if any).
void	dialog_Login (vlc_object_t obj, char username, char password, const char title, const char *fmt,...)
	Requests a username and password through the user interface.
int	dialog_Question (vlc_object_t obj, const char title, const char text, const char yes, const char no, const char cancel)
	Asks a total (Yes/No/Cancel) question through the user interface.
dialog_progress_bar_t *	dialog_ProgressCreate (vlc_object_t obj, const char title, const char message, const char cancel)
	Creates a progress bar dialog.
void	dialog_ProgressDestroy (dialog_progress_bar_t *dialog)
void	dialog_ProgressSet (dialog_progress_bar_t dialog, const char text, float value)
bool	dialog_ProgressCancelled (dialog_progress_bar_t *dialog)
int	dialog_ExtensionUpdate (vlc_object_t obj, extension_dialog_t dialog)
Variables
static vlc_mutex_t	provider_lock = PTHREAD_MUTEX_INITIALIZER

Detailed Description

User dialogs core.

Function Documentation

int dialog_ExtensionUpdate	(	vlc_object_t *	obj,
		extension_dialog_t *	dialog
	)

References dialog_GetProvider(), msg_Warn, extension_dialog_t::psz_title, var_SetAddress, and vlc_object_release.

static vlc_object_t* dialog_GetProvider ( vlc_object_t * obj ) [static]

References libvlc_priv(), libvlc_priv_t::p_dialog_provider, provider_lock, vlc_mutex_lock(), vlc_mutex_unlock(), and vlc_object_hold.

Referenced by dialog_ExtensionUpdate(), dialog_Login(), dialog_ProgressCreate(), dialog_Question(), and dialog_VFatal().

void dialog_Login	(	vlc_object_t *	obj,
		char **	username,
		char **	password,
		const char *	title,
		const char *	fmt,
			...
	)

Requests a username and password through the user interface.

Parameters:

	obj	the VLC object requesting credential information
	username	a pointer to the specified username [OUT]
	password	a pointer to the specified password [OUT]
	title	title for the dialog
	text	format string for the message in the dialog

Returns:: Nothing. If a user name resp. a password was specified, it will be returned as a heap-allocated character array into the username resp password pointer. Those must be freed with free(). Otherwise *username resp *password will be NULL.

References ap, dialog_GetProvider(), OBJECT_FLAGS_NOINTERACT, text, va_end(), va_start(), var_SetAddress, vasprintf(), and vlc_object_release.

bool dialog_ProgressCancelled ( dialog_progress_bar_t * dialog )

References dialog_progress_bar_t::p_sys, and dialog_progress_bar_t::pf_check.

dialog_progress_bar_t* dialog_ProgressCreate	(	vlc_object_t *	obj,
		const char *	title,
		const char *	message,
		const char *	cancel
	)

Creates a progress bar dialog.

References dialog_progress_bar_t::cancel, dialog_GetProvider(), dialog_progress_bar_t::message, OBJECT_FLAGS_NOINTERACT, dialog_progress_bar_t::pf_check, dialog_progress_bar_t::pf_destroy, dialog_progress_bar_t::pf_update, dialog_progress_bar_t::title, var_SetAddress, and vlc_object_release.

void dialog_ProgressDestroy ( dialog_progress_bar_t * dialog )

References dialog_progress_bar_t::p_sys, and dialog_progress_bar_t::pf_destroy.

void dialog_ProgressSet	(	dialog_progress_bar_t *	dialog,
		const char *	text,
		float	value
	)

References dialog_progress_bar_t::p_sys, and dialog_progress_bar_t::pf_update.

int dialog_Question	(	vlc_object_t *	obj,
		const char *	title,
		const char *	text,
		const char *	yes,
		const char *	no,
		const char *	cancel
	)

Asks a total (Yes/No/Cancel) question through the user interface.

Parameters:

	obj	VLC object emitting the question
	title	dialog box title
	text	dialog box text
	yes	first choice/button text
	no	second choice/button text
	cancel	third answer/button text, or NULL if no third option

Returns:: 0 if the user could not answer the question (e.g. there is no UI), 1, 2 resp. 3 if the user pressed the first, second resp. third button.

References dialog_question_t::answer, dialog_GetProvider(), OBJECT_FLAGS_NOINTERACT, var_SetAddress, and vlc_object_release.

int dialog_Register ( vlc_object_t * obj )

Registers an object as the dialog provider.

It is assumed that the appropriate variable callbacks are already registered.

References libvlc_priv(), libvlc_priv_t::p_dialog_provider, provider_lock, vlc_mutex_lock(), and vlc_mutex_unlock().

int dialog_Unregister ( vlc_object_t * obj )

Unregisters the dialog provider.

Note that unless you have unregistered the callbacks already, the provider might still be in use by other threads. Also, you need to cancel all pending dialogs yourself.

References libvlc_priv(), libvlc_priv_t::p_dialog_provider, provider_lock, vlc_mutex_lock(), and vlc_mutex_unlock().

void dialog_VFatal	(	vlc_object_t *	obj,
		bool	modal,
		const char *	title,
		const char *	fmt,
		va_list	ap
	)

Sends an error message through the user interface (if any).

Parameters:

	obj	the VLC object emitting the error
	modal	whether to wait for user to acknowledge the error before returning control to the caller
	title	title of the error dialog
	fmt	format string for the error message
	ap	parameters list for the formatted error message

References dialog_GetProvider(), msg_Err, msg_GenericVa, OBJECT_FLAGS_NOINTERACT, text, var_SetAddress, vasprintf(), VLC_MSG_ERR, and vlc_object_release.

Variable Documentation

vlc_mutex_t provider_lock = PTHREAD_MUTEX_INITIALIZER [static]

Referenced by dialog_GetProvider(), dialog_Register(), and dialog_Unregister().

dialog.c File Reference

Functions

Variables

Detailed Description

Function Documentation

Variable Documentation