Référence du fichier src/cairo-dock-dialogs.h

Aller au code source de ce fichier.

Fonctions

void cairo_dock_load_dialog_buttons (CairoDock *pDock, gchar *cButtonOkImage, gchar *cButtonCancelImage)
gboolean cairo_dock_dialog_reference (Icon *pIcon)
void cairo_dock_dialog_unreference (Icon *pIcon)
CairoDockDialogcairo_dock_isolate_dialog (Icon *pIcon)
void cairo_dock_free_dialog (CairoDockDialog *pDialog)
void cairo_dock_remove_dialog_if_any (Icon *icon)
GtkWidget * cairo_dock_build_interactive_widget_for_dialog (const gchar *cInitialAnswer, double fValueForHScale)
CairoDockDialogcairo_dock_build_dialog (const gchar *cText, Icon *pIcon, CairoDock *pDock, gchar *cImageFilePath, GtkWidget *pInteractiveWidget, GtkButtonsType iButtonsType, CairoDockActionOnAnswerFunc pActionFunc, gpointer data)
void cairo_dock_dialog_calculate_aimed_point (Icon *pIcon, CairoDock *pDock, int *iX, int *iY, gboolean *bRight, gboolean *bIsPerpendicular, gboolean *bDirectionUp)
void cairo_dock_dialog_find_optimal_placement (CairoDockDialog *pDialog, Icon *pIcon, CairoDock *pDock)
void cairo_dock_place_dialog (CairoDockDialog *pDialog, Icon *pIcon, CairoDock *pDock)
void cairo_dock_replace_all_dialogs (void)
CairoDockDialogcairo_dock_show_dialog_full (const gchar *cText, Icon *pIcon, CairoDock *pDock, double fTimeLength, gchar *cIconPath, GtkButtonsType iButtonsType, GtkWidget *pInteractiveWidget, CairoDockActionOnAnswerFunc pActionFunc, gpointer data, GFreeFunc pFreeDataFunc)
void cairo_dock_show_temporary_dialog_with_icon (const gchar *cText, Icon *pIcon, CairoDock *pDock, double fTimeLength, gchar *cIconPath)
void cairo_dock_show_temporary_dialog (const gchar *cText, Icon *pIcon, CairoDock *pDock, double fTimeLength)
void cairo_dock_show_temporary_dialog_with_default_icon (const gchar *cText, Icon *pIcon, CairoDock *pDock, double fTimeLength)
CairoDockDialogcairo_dock_show_dialog_with_question (const gchar *cText, Icon *pIcon, CairoDock *pDock, gchar *cIconPath, CairoDockActionOnAnswerFunc pActionFunc, gpointer data, GFreeFunc pFreeDataFunc)
CairoDockDialogcairo_dock_show_dialog_with_entry (const gchar *cText, Icon *pIcon, CairoDock *pDock, gchar *cIconPath, const gchar *cTextForEntry, CairoDockActionOnAnswerFunc pActionFunc, gpointer data, GFreeFunc pFreeDataFunc)
CairoDockDialogcairo_dock_show_dialog_with_value (const gchar *cText, Icon *pIcon, CairoDock *pDock, gchar *cIconPath, double fValue, CairoDockActionOnAnswerFunc pActionFunc, gpointer data, GFreeFunc pFreeDataFunc)
gchar * cairo_dock_show_dialog_and_wait (const gchar *cText, Icon *pIcon, CairoDock *pDock, double fTimeLength, gchar *cIconPath, GtkButtonsType iButtonsType, GtkWidget *pInteractiveWidget)
gchar * cairo_dock_show_demand_and_wait (const gchar *cMessage, Icon *pIcon, CairoDock *pDock, const gchar *cInitialAnswer)
double cairo_dock_show_value_and_wait (const gchar *cMessage, Icon *pIcon, CairoDock *pDock, double fInitialValue)
int cairo_dock_ask_question_and_wait (const gchar *cQuestion, Icon *pIcon, CairoDock *pDock)
int cairo_dock_ask_general_question_and_wait (const gchar *cQuestion)


Documentation des fonctions

void cairo_dock_load_dialog_buttons ( CairoDock pDock,
gchar *  cButtonOkImage,
gchar *  cButtonCancelImage 
)

gboolean cairo_dock_dialog_reference ( Icon pIcon  ) 

Incremente le compteur de reference de 1 de maniere atomique, de maniere a empecher toute destruction du dialogue pendant son utilisation. Utiliser cairo_dock_dialog_reference apres en avoir termine.

Paramètres:
pIcon l'icone contenant le dialogue. TRUE ssi la reference sur le dialogue n'etait pas deja nulle et a pu etre incrementee, FALSE sinon.

void cairo_dock_dialog_unreference ( Icon pIcon  ) 

Decremente le compteur de reference de 1 de maniere atomique, et detruit le dialogue si la refernce est tombee a 0.

Paramètres:
pIcon l'icone contenant le dialogue.

CairoDockDialog* cairo_dock_isolate_dialog ( Icon pIcon  ) 

void cairo_dock_free_dialog ( CairoDockDialog pDialog  ) 

void cairo_dock_remove_dialog_if_any ( Icon icon  ) 

Tente de detruire le dialogue d'une icone; si le dialogue est utilise par quelqu'un d'autre, il sera detruit plus tard, mais le dialogue sera au moins isole, et ne pourra donc plus etre utilise par une nouvelle personne.

Paramètres:
icon l'icone contenant le dialogue.

GtkWidget* cairo_dock_build_interactive_widget_for_dialog ( const gchar *  cInitialAnswer,
double  fValueForHScale 
)

CairoDockDialog* cairo_dock_build_dialog ( const gchar *  cText,
Icon pIcon,
CairoDock pDock,
gchar *  cImageFilePath,
GtkWidget *  pInteractiveWidget,
GtkButtonsType  iButtonsType,
CairoDockActionOnAnswerFunc  pActionFunc,
gpointer  data 
)

void cairo_dock_dialog_calculate_aimed_point ( Icon pIcon,
CairoDock pDock,
int *  iX,
int *  iY,
gboolean *  bRight,
gboolean *  bIsPerpendicular,
gboolean *  bDirectionUp 
)

void cairo_dock_dialog_find_optimal_placement ( CairoDockDialog pDialog,
Icon pIcon,
CairoDock pDock 
)

void cairo_dock_place_dialog ( CairoDockDialog pDialog,
Icon pIcon,
CairoDock pDock 
)

void cairo_dock_replace_all_dialogs ( void   ) 

CairoDockDialog* cairo_dock_show_dialog_full ( const gchar *  cText,
Icon pIcon,
CairoDock pDock,
double  fTimeLength,
gchar *  cIconPath,
GtkButtonsType  iButtonsType,
GtkWidget *  pInteractiveWidget,
CairoDockActionOnAnswerFunc  pActionFunc,
gpointer  data,
GFreeFunc  pFreeDataFunc 
)

Fait apparaitre un dialogue avec un widget et 2 boutons.

Paramètres:
cText le message du dialogue.
pIcon l'icone sur laquelle pointe le dialogue.
pDock le dock contenant l'icone.
cIconPath le chemin vers une icone a afficher dans la marge.
iButtonsType type des boutons (GTK_BUTTONS_OK_CANCEL ou GTK_BUTTONS_YES_NO).
pInteractiveWidget un widget d'interaction avec l'utilisateur.
pActionFunc la fonction d'action appelee lorsque l'utilisateur valide son choix.
data 
pFreeDataFunc Si le widget est une entree de texte, retourne le texte si oui, et "" si non. Si le widget est une echelle, retourne la valeur sous forme de chaine si "oui", et "-1" si non, et sinon, retourne "yes" si oui, et "no" si non. Si besoin est, le widget est accessible via le dialogue, lui-meme accessible via l'icone.

void cairo_dock_show_temporary_dialog_with_icon ( const gchar *  cText,
Icon pIcon,
CairoDock pDock,
double  fTimeLength,
gchar *  cIconPath 
)

Fait apparaitre un dialogue a duree de vie limitee avec une icone dans la marge a cote du texte.

Paramètres:
cText le message du dialogue.
pIcon l'icone sur laquelle pointe le dialogue.
pDock le dock contenant l'icone.
fTimeLength la duree de vie du dialogue (ou 0 pour une duree de vie illimitee).
cIconPath le chemin vers une icone.

void cairo_dock_show_temporary_dialog ( const gchar *  cText,
Icon pIcon,
CairoDock pDock,
double  fTimeLength 
)

Fait apparaitre un dialogue a duree de vie limitee sans icone.

Paramètres:
cText le message du dialogue.
pIcon l'icone sur laquelle pointe le dialogue.
pDock le dock contenant l'icone.
fTimeLength la duree de vie du dialogue (ou 0 pour une duree de vie illimitee).

void cairo_dock_show_temporary_dialog_with_default_icon ( const gchar *  cText,
Icon pIcon,
CairoDock pDock,
double  fTimeLength 
)

Fait apparaitre un dialogue a duree de vie limitee et avec l'icone par defaut.

Paramètres:
cText le message du dialogue.
pIcon l'icone sur laquelle pointe le dialogue.
pDock le dock contenant l'icone.
fTimeLength la duree de vie du dialogue (ou 0 pour une duree de vie illimitee).

CairoDockDialog* cairo_dock_show_dialog_with_question ( const gchar *  cText,
Icon pIcon,
CairoDock pDock,
gchar *  cIconPath,
CairoDockActionOnAnswerFunc  pActionFunc,
gpointer  data,
GFreeFunc  pFreeDataFunc 
)

Fait apparaitre un dialogue a duree de vie illimitee avec une question et 2 boutons oui/non. Lorsque l'utilisateur clique sur "oui", la fonction d'action est appelee avec "yes", et avec "no" s'il a clique sur "non".

Paramètres:
cText le message du dialogue.
pIcon l'icone sur laquelle pointe le dialogue.
pDock le dock contenant l'icone.
cIconPath le chemin vers une icone a afficher dans la marge.
pActionFunc la fonction d'action, appelee lors du clique utilisateur.
data pointeur qui sera passe en argument de la fonction d'action.
pFreeDataFunc fonction qui liberera le pointeur. le dialogue nouvellement cree.

CairoDockDialog* cairo_dock_show_dialog_with_entry ( const gchar *  cText,
Icon pIcon,
CairoDock pDock,
gchar *  cIconPath,
const gchar *  cTextForEntry,
CairoDockActionOnAnswerFunc  pActionFunc,
gpointer  data,
GFreeFunc  pFreeDataFunc 
)

Fait apparaitre un dialogue a duree de vie illimitee avec une entree texte et 2 boutons ok/annuler. Lorsque l'utilisateur clique sur "ok", la fonction d'action est appelee avec le texte de l'entree, et avec "" s'il a clique sur "annuler".

Paramètres:
cText le message du dialogue.
pIcon l'icone sur laquelle pointe le dialogue.
pDock le dock contenant l'icone.
cIconPath le chemin vers une icone a afficher dans la marge.
cTextForEntry le texte a afficher initialement dans l'entree.
pActionFunc la fonction d'action, appelee lors du clique utilisateur.
data pointeur qui sera passe en argument de la fonction d'action.
pFreeDataFunc fonction qui liberera le pointeur. le dialogue nouvellement cree.

CairoDockDialog* cairo_dock_show_dialog_with_value ( const gchar *  cText,
Icon pIcon,
CairoDock pDock,
gchar *  cIconPath,
double  fValue,
CairoDockActionOnAnswerFunc  pActionFunc,
gpointer  data,
GFreeFunc  pFreeDataFunc 
)

Fait apparaitre un dialogue a duree de vie illimitee avec une echelle horizontale et 2 boutons ok/annuler. Lorsque l'utilisateur clique sur "ok", la fonction d'action est appelee avec la valeur de l'echelle sous forme de texte, et avec "-1" s'il a clique sur "annuler".

Paramètres:
cText le message du dialogue.
pIcon l'icone sur laquelle pointe le dialogue.
pDock le dock contenant l'icone.
cIconPath le chemin vers une icone a afficher dans la marge.
fValue la valeur initiale de l'echelle.
pActionFunc la fonction d'action, appelee lors du clique utilisateur.
data pointeur qui sera passe en argument de la fonction d'action.
pFreeDataFunc fonction qui liberera le pointeur. le dialogue nouvellement cree.

gchar* cairo_dock_show_dialog_and_wait ( const gchar *  cText,
Icon pIcon,
CairoDock pDock,
double  fTimeLength,
gchar *  cIconPath,
GtkButtonsType  iButtonsType,
GtkWidget *  pInteractiveWidget 
)

Fait apparaitre un dialogue avec un widget et 2 boutons, et met en pause le programme jusqu'a ce que l'utilisateur ait fait son choix.

Paramètres:
cText le message du dialogue.
pIcon l'icone sur laquelle pointe le dialogue.
pDock le dock contenant l'icone.
cIconPath le chemin vers une icone a afficher dans la marge.
iButtonsType type des boutons (GTK_BUTTONS_OK_CANCEL ou GTK_BUTTONS_YES_NO).
pInteractiveWidget un widget d'interaction avec l'utilisateur. La reponse sous la fome d'une chaine de caracters nouvellement allouee. Si le widget est une entree de texte, retourne le texte si oui, et "" si non. Si le widget est une echelle, retourne la valeur sous forme de chaine si "oui", et "-1" si non, et sinon, retourne "yes" si oui, et "no" si non. Si le dialogue est detruit entre-temps, NULL est retourne. Si c'est un autre widget, il faut le referencer avant, de facon a ce qu'il ne soit pas detruit avec le dialogue.

gchar* cairo_dock_show_demand_and_wait ( const gchar *  cMessage,
Icon pIcon,
CairoDock pDock,
const gchar *  cInitialAnswer 
)

Fait apparaitre un dialogue avec une entree de texte et 2 boutons ok/annuler, et met en pause le programme jusqu'a ce que l'utilisateur ait fait son choix.

Paramètres:
cMessage le message du dialogue.
pIcon l'icone qui fait la demande.
pDock le dock contenant l'icone.
cInitialAnswer la valeur initiale de l'entree de texte, ou NULL si aucune n'est fournie. le texte entre par l'utilisateur, ou NULL s'il a annule ou si le dialogue s'est fait detruire avant.

double cairo_dock_show_value_and_wait ( const gchar *  cMessage,
Icon pIcon,
CairoDock pDock,
double  fInitialValue 
)

Fait apparaitre un dialogue avec une echelle horizontale entre 0 et 1, et 2 boutons ok/annuler, et met en pause le programme jusqu'a ce que l'utilisateur ait fait son choix.

Paramètres:
cMessage le message du dialogue.
pIcon l'icone qui fait la demande.
pDock le dock contenant l'icone.
fInitialValue la valeur initiale de l'echelle, entre 0 et 1. la valeur choisie par l'utilisateur, ou -1 s'il a annule ou si le dialogue s'est fait detruire avant.

int cairo_dock_ask_question_and_wait ( const gchar *  cQuestion,
Icon pIcon,
CairoDock pDock 
)

Fait apparaitre un dialogue de question pointant sur l'icone pointee (ou la 1ere si aucune n'est pointee) avec une question et 2 boutons oui/non, et met en pause le programme jusqu'a ce que l'utilisateur ait fait son choix.

Paramètres:
cQuestion la question a poser.
pIcon l'icone qui fait la demande.
pDock le dock contenant l'icone. GTK_RESPONSE_YES ou GTK_RESPONSE_NO suivant le choix de l'utilisateur, ou GTK_RESPONSE_NONE si le dialogue s'est fait detruire avant.

int cairo_dock_ask_general_question_and_wait ( const gchar *  cQuestion  ) 

Fait apparaitre un dialogue de question bloquant, et pointant sur l'icone pointee du dock principal (ou la 1ere icone si aucune n'est pointee). Cela permet a cairo-dock de poser une question d'ordre general.

Paramètres:
cQuestion la question a poser. idem que pour cairo_dock_ask_question_and_wait .


Généré le Tue Dec 11 02:26:43 2007 pour Cairo-Dock par  doxygen 1.5.3