kpguiutils

Name

kpguiutils -- 

Synopsis



#define     CB                              (func)
#define     KP_W                            (xml,widget)
GladeXML*   kp_gui_load                     (const gchar *module,
                                             const gchar *root);
void        kp_gui_module_signals_connect   (GladeXML *xml,
                                             GuiModuleSignalsData *gmd);
void        kp_gui_module_signals_connect_data
                                            (GladeXML *xml,
                                             GuiModuleSignalsData *gmd,
                                             gpointer data);
gint        kp_gui_get_yes_no_cancel        (GtkWindow *window,
                                             const gchar *message);
gchar*      kp_gui_get_file_from_user       (GFileTest valid_mask);
gchar*      kp_gui_get_filename_from_user   (void);
gchar*      kp_gui_get_dirname_from_user    (void);
void        kp_gui_open_file_dialog         (GCallback handler);
GtkWidget*  kp_gui_get_widget               (GladeXML *xml,
                                             const gchar *widget_name);
gchar*      kp_gui_get_option_menu_active   (GtkOptionMenu *menu);
void        kp_gui_report_error             (GtkWindow *window,
                                             KPStatusbar *bar,
                                             const gchar *msg);
void        kp_gui_destroy_widget_passed    (GtkWidget *widget,
                                             gpointer data);

Description

Details

CB()

#define CB(func) (G_CALLBACK (func))

func :


KP_W()

#define KP_W(xml,widget) kp_gui_get_widget(xml,widget)

xml :

widget :


kp_gui_load ()

GladeXML*   kp_gui_load                     (const gchar *module,
                                             const gchar *root);

module :

root :

Returns :


kp_gui_module_signals_connect ()

void        kp_gui_module_signals_connect   (GladeXML *xml,
                                             GuiModuleSignalsData *gmd);

xml :

gmd :


kp_gui_module_signals_connect_data ()

void        kp_gui_module_signals_connect_data
                                            (GladeXML *xml,
                                             GuiModuleSignalsData *gmd,
                                             gpointer data);

xml :

gmd :

data :


kp_gui_get_yes_no_cancel ()

gint        kp_gui_get_yes_no_cancel        (GtkWindow *window,
                                             const gchar *message);

window :

message :

Returns :


kp_gui_get_file_from_user ()

gchar*      kp_gui_get_file_from_user       (GFileTest valid_mask);

valid_mask :

Returns :


kp_gui_get_filename_from_user ()

gchar*      kp_gui_get_filename_from_user   (void);

Opens a GtkFileSelection dialog to get a file name from the user.

Returns :

A newly-allocated string will be returned or NULL if some error occurs. The string must be freed by the caller.


kp_gui_get_dirname_from_user ()

gchar*      kp_gui_get_dirname_from_user    (void);

Returns :


kp_gui_open_file_dialog ()

void        kp_gui_open_file_dialog         (GCallback handler);

handler :


kp_gui_get_widget ()

GtkWidget*  kp_gui_get_widget               (GladeXML *xml,
                                             const gchar *widget_name);

xml :

widget_name :

Returns :


kp_gui_get_option_menu_active ()

gchar*      kp_gui_get_option_menu_active   (GtkOptionMenu *menu);

Get the text of the currently selected item of the GtkOptionMenu.

menu :

A GtkOptionMenu

Returns :

The text of the active item or NULL if something goes wrong. If the value is not NULL, it must be freed by the caller.


kp_gui_report_error ()

void        kp_gui_report_error             (GtkWindow *window,
                                             KPStatusbar *bar,
                                             const gchar *msg);

Show this error message to the user.

window :

Parent window for the dialog

bar :

A KPStatusbar, can be NULL if msg is not wanted to be shown in the statusbar

msg :

Message to show to the user


kp_gui_destroy_widget_passed ()

void        kp_gui_destroy_widget_passed    (GtkWidget *widget,
                                             gpointer data);

widget :

data :