237
245
void cairo_dock_free_dialog (CairoDialog *pDialog);
247
/** Unreference the dialogs pointed by an icon.
248
*@param icon the icon you want to delete all dialogs from.
249
*@param bAll whether all dialogs should be removed or only the one that don't have interaction with the user.
250
*@returns TRUE if at least one dialog has been unreferenced.
252
gboolean cairo_dock_remove_dialog_if_any_full (Icon *icon, gboolean bAll);
239
254
/** Unreference all the dialogs pointed by an icon.
240
255
*@param icon the icon you want to delete all dialogs from.
241
256
*@returns TRUE if at least one dialog has been unreferenced.
243
gboolean cairo_dock_remove_dialog_if_any (Icon *icon);
258
#define cairo_dock_remove_dialog_if_any(icon) cairo_dock_remove_dialog_if_any_full (icon, TRUE)
245
261
GtkWidget *cairo_dock_add_dialog_internal_box (CairoDialog *pDialog, int iWidth, int iHeight, gboolean bCanResize);
285
301
*@param ... arguments to insert in the message, in a printf way.
286
302
*@return the newly created dialog, visible, with a reference of 1.
288
CairoDialog *cairo_dock_show_temporary_dialog_with_icon (const gchar *cText, Icon *pIcon, CairoContainer *pContainer, double fTimeLength, const gchar *cIconPath, ...);
304
CairoDialog *cairo_dock_show_temporary_dialog_with_icon_printf (const gchar *cText, Icon *pIcon, CairoContainer *pContainer, double fTimeLength, const gchar *cIconPath, ...);
306
/** Pop up a dialog with a message, and a limited duration, and an icon in the margin.
307
*@param cText the message to display.
308
*@param pIcon the icon that will hold the dialog.
309
*@param pContainer the container of the icon.
310
*@param fTimeLength the duration of the dialog (in ms), or 0 for an unlimited dialog.
311
*@param cIconPath path to an icon.
312
*@return the newly created dialog, visible, with a reference of 1.
314
CairoDialog *cairo_dock_show_temporary_dialog_with_icon (const gchar *cText, Icon *pIcon, CairoContainer *pContainer, double fTimeLength, const gchar *cIconPath);
290
316
/** Pop up a dialog with a message, and a limited duration, with no icon.
291
317
*@param cText the message to display.
292
318
*@param pIcon the icon that will hold the dialog.
293
319
*@param pContainer the container of the icon.
294
320
*@param fTimeLength the duration of the dialog (in ms), or 0 for an unlimited dialog.
295
*@param ... arguments to insert in the message, in a printf way.
296
321
*@return the newly created dialog, visible, with a reference of 1 et visible, avec une reference a 1.
298
CairoDialog *cairo_dock_show_temporary_dialog (const gchar *cText, Icon *pIcon, CairoContainer *pContainer, double fTimeLength, ...);
323
CairoDialog *cairo_dock_show_temporary_dialog (const gchar *cText, Icon *pIcon, CairoContainer *pContainer, double fTimeLength);
300
325
/** Pop up a dialog with a message, and a limited duration, and a default icon.
301
326
*@param cText the format of the message to display.
302
327
*@param pIcon the icon that will hold the dialog.
303
328
*@param pContainer the container of the icon.
304
329
*@param fTimeLength the duration of the dialog (in ms), or 0 for an unlimited dialog.
305
*@param ... arguments to insert in the message, in a printf way.
306
330
*@return the newly created dialog, visible, with a reference of 1 et visible, avec une reference a 1.
308
CairoDialog *cairo_dock_show_temporary_dialog_with_default_icon (const gchar *cText, Icon *pIcon, CairoContainer *pContainer, double fTimeLength, ...);
332
CairoDialog *cairo_dock_show_temporary_dialog_with_default_icon (const gchar *cText, Icon *pIcon, CairoContainer *pContainer, double fTimeLength);
310
334
/** Pop up a dialog with a question and 2 buttons ok/cancel.
311
335
* When the user make its choice, the callback is called with the value "yes" if he clicked on "ok", and with "no" if he clicked on "cancel".
344
368
*@param pContainer the container of the icon.
345
369
*@param cIconPath path to an icon to display in the margin.
346
370
*@param fValue initial value of the scale.
371
*@param fMaxValue maximum value of the scale.
347
372
*@param pActionFunc the callback.
348
373
*@param data data passed as a parameter of the callback.
349
374
*@param pFreeDataFunc function used to free the data.
350
375
*@return the newly created dialog, visible, with a reference of 1.
352
CairoDialog *cairo_dock_show_dialog_with_value (const gchar *cText, Icon *pIcon, CairoContainer *pContainer, const gchar *cIconPath, double fValue, CairoDockActionOnAnswerFunc pActionFunc, gpointer data, GFreeFunc pFreeDataFunc);
377
CairoDialog *cairo_dock_show_dialog_with_value (const gchar *cText, Icon *pIcon, CairoContainer *pContainer, const gchar *cIconPath, double fValue, double fMaxValue, CairoDockActionOnAnswerFunc pActionFunc, gpointer data, GFreeFunc pFreeDataFunc);
432
457
void cairo_dock_toggle_dialog_visibility (CairoDialog *pDialog);
434
459
GtkWidget *cairo_dock_steal_widget_from_its_container (GtkWidget *pWidget);
460
/** Detach the interactive widget from a dialog. The widget can then be placed anywhere after that. You have to unref it after you placed it into a container, or to destroy it.
461
*@param pDialog the desklet with an interactive widget.
464
GtkWidget *cairo_dock_steal_interactive_widget_from_dialog (CairoDialog *pDialog);
437
466
void cairo_dock_set_new_dialog_text_surface (CairoDialog *pDialog, cairo_surface_t *pNewTextSurface, int iNewTextWidth, int iNewTextHeight);
438
467
void cairo_dock_set_new_dialog_icon_surface (CairoDialog *pDialog, cairo_surface_t *pNewIconSurface, int iNewIconSize);