GksuUIDialog -- authentication dialog widget

GksuUIDialog -- authentication dialog widget

Synopsis

                    GksuuiDialog;
GtkWidget *         gksuui_dialog_new                   (void);
void                gksuui_dialog_set_message           (GksuuiDialog *dialog,
                                                         gchar *message);
const gchar *       gksuui_dialog_get_message           (GksuuiDialog *dialog);
void                gksuui_dialog_set_icon              (GksuuiDialog *dialog,
                                                         GdkPixbuf *icon);
GtkWidget *         gksuui_dialog_get_icon              (GksuuiDialog *dialog);
gchar *             gksuui_dialog_get_password          (GksuuiDialog *dialog);

Description

Details

GksuuiDialog

typedef struct _GksuuiDialog GksuuiDialog;

Convenience widget based on GtkDialog to request a password.


gksuui_dialog_new ()

GtkWidget *         gksuui_dialog_new                   (void);

Creates a new GksuuiDialog.

Returns :

the new GksuuiDialog

gksuui_dialog_set_message ()

void                gksuui_dialog_set_message           (GksuuiDialog *dialog,
                                                         gchar *message);

Sets the message that is displayed to the user when requesting a password. You can use Pango markup to modify font attributes.

dialog :

the dialog on which to set the message

message :

the message to be set on the dialog

gksuui_dialog_get_message ()

const gchar *       gksuui_dialog_get_message           (GksuuiDialog *dialog);

Gets the current message that the dialog will use when run.

dialog :

the dialog from which to get the message

Returns :

a pointer to the string containing the message. You need to make a copy of the string to keep it.

gksuui_dialog_set_icon ()

void                gksuui_dialog_set_icon              (GksuuiDialog *dialog,
                                                         GdkPixbuf *icon);

Sets the icon that will be shown on the dialog. Should probably not be used, as the default icon is the default authorization icon.

dialog :

the dialog on which the icon will be set

icon :

a GdkPixbuf from which to set the image

gksuui_dialog_get_icon ()

GtkWidget *         gksuui_dialog_get_icon              (GksuuiDialog *dialog);

Gets the GtkImage which is currently defined as the icon for the authorization dialog.

dialog :

the dialog from which the icon should be got

Returns :

a GtkWidget which is the GtkImage

gksuui_dialog_get_password ()

gchar *             gksuui_dialog_get_password          (GksuuiDialog *dialog);

Gets the password typed by the user on the dialog. This is a convenience function to grab the password easily from the dialog after calling gtk_dialog_run()

dialog :

the dialog from which to get the message

Returns :

a newly allocated string containing the password