libvlc_dialog_cbs Struct Reference

Dialog callbacks to be implemented. More...

#include <libvlc_dialog.h>

Data Fields
void(*	pf_display_login )(void *p_data, libvlc_dialog_id *p_id, const char *psz_title, const char *psz_text, const char *psz_default_username, bool b_ask_store)
	Called when a login dialog needs to be displayed.
void(*	pf_display_question )(void *p_data, libvlc_dialog_id *p_id, const char *psz_title, const char *psz_text, libvlc_dialog_question_type i_type, const char *psz_cancel, const char *psz_action1, const char *psz_action2)
	Called when a question dialog needs to be displayed.
void(*	pf_display_progress )(void *p_data, libvlc_dialog_id *p_id, const char *psz_title, const char *psz_text, bool b_indeterminate, float f_position, const char *psz_cancel)
	Called when a progress dialog needs to be displayed.
void(*	pf_cancel )(void *p_data, libvlc_dialog_id *p_id)
	Called when a displayed dialog needs to be cancelled.
void(*	pf_update_progress )(void *p_data, libvlc_dialog_id *p_id, float f_position, const char *psz_text)
	Called when a progress dialog needs to be updated.

Detailed Description

Dialog callbacks to be implemented.

Attention

starting with vlc 4.0.0 the error callback (pf_display_error) is no longer part of this struct and need to be registered separately using libvlc_dialog_set_error_callback

See also

libvlc_dialog_set_error_callback

Field Documentation

pf_cancel

void(* libvlc_dialog_cbs::pf_cancel) (void *p_data, libvlc_dialog_id *p_id)

Called when a displayed dialog needs to be cancelled.

The implementation must call libvlc_dialog_dismiss() to really release the dialog.

Parameters

p_data	opaque pointer for the callback
p_id	id of the dialog

pf_display_login

void(* libvlc_dialog_cbs::pf_display_login) (void *p_data, libvlc_dialog_id *p_id, const char *psz_title, const char *psz_text, const char *psz_default_username, bool b_ask_store)

Called when a login dialog needs to be displayed.

You can interact with this dialog by calling libvlc_dialog_post_login() to post an answer or libvlc_dialog_dismiss() to cancel this dialog.

Note

to receive this callback, libvlc_dialog_cbs.pf_cancel should not be NULL.

Parameters

p_data	opaque pointer for the callback
p_id	id used to interact with the dialog
psz_title	title of the dialog
psz_text	text of the dialog
psz_default_username	user name that should be set on the user form
b_ask_store	if true, ask the user if he wants to save the credentials

pf_display_progress

void(* libvlc_dialog_cbs::pf_display_progress) (void *p_data, libvlc_dialog_id *p_id, const char *psz_title, const char *psz_text, bool b_indeterminate, float f_position, const char *psz_cancel)

Called when a progress dialog needs to be displayed.

If cancellable (psz_cancel != NULL), you can cancel this dialog by calling libvlc_dialog_dismiss()

Note

to receive this callback, libvlc_dialog_cbs.pf_cancel and libvlc_dialog_cbs.pf_update_progress should not be NULL.

Parameters

p_data	opaque pointer for the callback
p_id	id used to interact with the dialog
psz_title	title of the dialog
psz_text	text of the dialog
b_indeterminate	true if the progress dialog is indeterminate
f_position	initial position of the progress bar (between 0.0 and 1.0)
psz_cancel	text of the cancel button, if NULL the dialog is not cancellable

pf_display_question

void(* libvlc_dialog_cbs::pf_display_question) (void *p_data, libvlc_dialog_id *p_id, const char *psz_title, const char *psz_text, libvlc_dialog_question_type i_type, const char *psz_cancel, const char *psz_action1, const char *psz_action2)

Called when a question dialog needs to be displayed.

You can interact with this dialog by calling libvlc_dialog_post_action() to post an answer or libvlc_dialog_dismiss() to cancel this dialog.

Note

to receive this callback, libvlc_dialog_cbs.pf_cancel should not be NULL.

Parameters

p_data	opaque pointer for the callback
p_id	id used to interact with the dialog
psz_title	title of the dialog
psz_text	text of the dialog
i_type	question type (or severity) of the dialog
psz_cancel	text of the cancel button
psz_action1	text of the first button, if NULL, don't display this button
psz_action2	text of the second button, if NULL, don't display this button

pf_update_progress

void(* libvlc_dialog_cbs::pf_update_progress) (void *p_data, libvlc_dialog_id *p_id, float f_position, const char *psz_text)

Called when a progress dialog needs to be updated.

Parameters

p_data	opaque pointer for the callback
p_id	id of the dialog
f_position	osition of the progress bar (between 0.0 and 1.0)
psz_text	new text of the progress dialog

---

The documentation for this struct was generated from the following file:

• include/vlc/libvlc_dialog.h