| MATE UI Library Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
#include <libmateui/libmateui.h> GtkWidget * mate_ok_dialog (const gchar *message); GtkWidget * mate_ok_dialog_parented (const gchar *message,GtkWindow *parent); GtkWidget * mate_error_dialog (const gchar *error); GtkWidget * mate_error_dialog_parented (const gchar *error,GtkWindow *parent); GtkWidget * mate_warning_dialog (const gchar *warning); GtkWidget * mate_warning_dialog_parented (const gchar *warning,GtkWindow *parent); GtkWidget * mate_question_dialog (const gchar *question,MateReplyCallback callback,gpointer data); GtkWidget * mate_question_dialog_parented (const gchar *question,MateReplyCallback callback,gpointer data,GtkWindow *parent); GtkWidget * mate_question_dialog_modal (const gchar *question,MateReplyCallback callback,gpointer data); GtkWidget * mate_question_dialog_modal_parented (const gchar *question,MateReplyCallback callback,gpointer data,GtkWindow *parent); GtkWidget * mate_ok_cancel_dialog (const gchar *message,MateReplyCallback callback,gpointer data); GtkWidget * mate_ok_cancel_dialog_parented (const gchar *message,MateReplyCallback callback,gpointer data,GtkWindow *parent); GtkWidget * mate_ok_cancel_dialog_modal (const gchar *message,MateReplyCallback callback,gpointer data); GtkWidget * mate_ok_cancel_dialog_modal_parented (const gchar *message,MateReplyCallback callback,gpointer data,GtkWindow *parent); GtkWidget * mate_request_string_dialog (const gchar *prompt,MateStringCallback callback,gpointer data); GtkWidget * mate_request_string_dialog_parented (const gchar *prompt,MateStringCallback callback,gpointer data,GtkWindow *parent); GtkWidget * mate_request_password_dialog (const gchar *prompt,MateStringCallback callback,gpointer data); GtkWidget * mate_request_password_dialog_parented (const gchar *prompt,MateStringCallback callback,gpointer data,GtkWindow *parent); GtkWidget * mate_request_dialog (gboolean password,const gchar *prompt,const gchar *default_text,const guint16 max_length,MateStringCallback callback,gpointer data,GtkWindow *parent);
GtkWidget * mate_ok_dialog (const gchar *message);
mate_ok_dialog is deprecated and should not be used in newly-written code.
Creates and shows a simple message dialog.
|
Message to display |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_ok_dialog_parented (const gchar *message,GtkWindow *parent);
mate_ok_dialog_parented is deprecated and should not be used in newly-written code.
Creates and shows a simple message dialog.
|
Message to display |
|
Parent window |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_error_dialog (const gchar *error);
mate_error_dialog is deprecated and should not be used in newly-written code.
Creates and shows a error dialog. This is an OK dialog to display on fatally failed operations.
|
Message to display |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_error_dialog_parented (const gchar *error,GtkWindow *parent);
mate_error_dialog_parented is deprecated and should not be used in newly-written code.
Creates and shows a error dialog. This is an OK dialog to display on fatally failed operations.
|
Message to display |
|
Parent window |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_warning_dialog (const gchar *warning);
mate_warning_dialog is deprecated and should not be used in newly-written code.
Creates and shows a warning dialog. For non-fatal warnings.
|
Message to display |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_warning_dialog_parented (const gchar *warning,GtkWindow *parent);
mate_warning_dialog_parented is deprecated and should not be used in newly-written code.
Creates and shows a warning dialog. For non-fatal warnings.
|
Message to display |
|
Parent window |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_question_dialog (const gchar *question,MateReplyCallback callback,gpointer data);
mate_question_dialog is deprecated and should not be used in newly-written code.
Creates a question dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'
void (* MateReplyCallback)(gint reply, gpointer data);
|
Question to ask |
|
Callback function for handling dialog results |
|
Data to pass to callback |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_question_dialog_parented (const gchar *question,MateReplyCallback callback,gpointer data,GtkWindow *parent);
mate_question_dialog_parented is deprecated and should not be used in newly-written code.
Creates a question dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'
void (* MateReplyCallback)(gint reply, gpointer data);
|
Question to ask |
|
Callback function for handling dialog results |
|
Data to pass to callback |
|
Parent window |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_question_dialog_modal (const gchar *question,MateReplyCallback callback,gpointer data);
mate_question_dialog_modal is deprecated and should not be used in newly-written code.
Creates a question dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'. The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
void (* MateReplyCallback)(gint reply, gpointer data);
|
Question to ask |
|
Callback function for handling dialog results |
|
Data to pass to callback |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_question_dialog_modal_parented (const gchar *question,MateReplyCallback callback,gpointer data,GtkWindow *parent);
mate_question_dialog_modal_parented is deprecated and should not be used in newly-written code.
Creates a question dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'. The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
void (* MateReplyCallback)(gint reply, gpointer data);
|
Question to ask |
|
Callback function for handling dialog results |
|
Data to pass to callback |
|
Parent window |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_ok_cancel_dialog (const gchar *message,MateReplyCallback callback,gpointer data);
mate_ok_cancel_dialog is deprecated and should not be used in newly-written code.
Creates an OK/Cancel dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.
void (* MateReplyCallback)(gint reply, gpointer data);
|
Message to display |
|
Callback function for handling dialog results |
|
Data to pass to callback |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_ok_cancel_dialog_parented (const gchar *message,MateReplyCallback callback,gpointer data,GtkWindow *parent);
mate_ok_cancel_dialog_parented is deprecated and should not be used in newly-written code.
Creates an OK/Cancel dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.
void (* MateReplyCallback)(gint reply, gpointer data);
|
Message to display |
|
Callback function for handling dialog results |
|
Data to pass to callback |
|
Parent window |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_ok_cancel_dialog_modal (const gchar *message,MateReplyCallback callback,gpointer data);
mate_ok_cancel_dialog_modal is deprecated and should not be used in newly-written code.
Creates an OK/Cancel dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'. The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
void (* MateReplyCallback)(gint reply, gpointer data);
|
Message to display |
|
Callback function for handling dialog results |
|
Data to pass to callback |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_ok_cancel_dialog_modal_parented (const gchar *message,MateReplyCallback callback,gpointer data,GtkWindow *parent);
mate_ok_cancel_dialog_modal_parented is deprecated and should not be used in newly-written code.
Creates and shows an OK/Cancel dialog and calls callback
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'. The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
void (* MateReplyCallback)(gint reply, gpointer data);
|
Message to display |
|
Callback function for handling dialog results |
|
Data to pass to callback |
|
Parent window |
Returns : |
Pointer to new MATE dialog object. |
GtkWidget * mate_request_string_dialog (const gchar *prompt,MateStringCallback callback,gpointer data);
mate_request_string_dialog is deprecated and should not be used in newly-written code.
Deprecated, use mate_request_dialog
Returns : |
GtkWidget * mate_request_string_dialog_parented (const gchar *prompt,MateStringCallback callback,gpointer data,GtkWindow *parent);
mate_request_string_dialog_parented is deprecated and should not be used in newly-written code.
Deprecated, use mate_request_dialog
Returns : |
GtkWidget * mate_request_password_dialog (const gchar *prompt,MateStringCallback callback,gpointer data);
mate_request_password_dialog is deprecated and should not be used in newly-written code.
Deprecated, use mate_request_dialog instead.
Returns : |
GtkWidget * mate_request_password_dialog_parented (const gchar *prompt,MateStringCallback callback,gpointer data,GtkWindow *parent);
mate_request_password_dialog_parented is deprecated and should not be used in newly-written code.
Deprecated, use mate_request_dialog.
Returns : |
GtkWidget * mate_request_dialog (gboolean password,const gchar *prompt,const gchar *default_text,const guint16 max_length,MateStringCallback callback,gpointer data,GtkWindow *parent);
mate_request_dialog is deprecated and should not be used in newly-written code.
Creates and shows a MATE text entry request dialog.
callback is called when the dialog closes, passing the text entry
input or NULL if the user cancelled. callback is defined as
void (* MateStringCallback)(gchar * string, gpointer data);
|
TRUE if on-screen text input is masked
|
|
Text of the prompt to be displayed |
|
Default text in entry widget, NULL if none
|
|
Maximum input chars allowed |
|
Callback function for handling dialog results |
|
Data passed to the callback |
|
Parent window, or NULL for no parent.
|
Returns : |
Pointer to new MATE dialog object. |