cairo-dock-dialog-manager.h File Reference

Typedefs
typedef void(*	CairoDockActionOnAnswerFunc )(int iClickedButton, GtkWidget *pInteractiveWidget, gpointer data, CairoDialog *pDialog)
	Definition of a generic callback of a dialog, called when the user clicks on a button. Buttons are numbered from 0, -1 means 'Return' and -2 means 'Escape'.

Enumerations
enum	CairoDialogNotifications
	signals

Functions
void	gldi_dialogs_remove_on_icon (Icon *icon)
void	gldi_dialog_hide (CairoDialog *pDialog)
void	gldi_dialog_unhide (CairoDialog *pDialog)
void	gldi_dialog_toggle_visibility (CairoDialog *pDialog)

Detailed Description

This class manages the Dialogs, that are useful to bring interaction with the user.

With dialogs, you can pop-up messages, ask for question, etc. Any GTK widget can be embedded inside a dialog, giving you any possible interaction with the user.

The most generic way to build a Dialog is to fill a _CairoDialogAttr and pass it to gldi_dialog_new.

But in most of case, you can just use one of the following convenient functions, that will do the job for you.

• to show a message, you can use gldi_dialog_show_temporary_with_icon
• to ask the user a choice, a value or a text, you can use gldi_dialog_show_with_question, gldi_dialog_show_with_value or gldi_dialog_show_with_entry.
• if you want to pop up only 1 dialog at once on a given icon, use gldi_dialogs_remove_on_icon before you pop up your dialog.

Function Documentation

void gldi_dialogs_remove_on_icon

(

Icon *

icon

)

Remove the dialogs attached to an icon.

Parameters

icon	the icon you want to delete all dialogs from.

void gldi_dialog_hide

(

CairoDialog *

pDialog

)

Hide a dialog.

Parameters

pDialog

the dialog.

void gldi_dialog_unhide

(

CairoDialog *

pDialog

)

Show a dialog and give it focus.

Parameters

pDialog

the dialog.

void gldi_dialog_toggle_visibility

(

CairoDialog *

pDialog

)

Toggle the visibility of a dialog.

Parameters

pDialog

the dialog.