![]() |
![]() |
![]() |
LibGKSuUI Reference Manual | |
---|---|---|---|---|
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);
typedef struct { GtkDialog dialog; GtkWidget *main_vbox; GtkWidget *hbox; GtkWidget *image; GtkWidget *entry_vbox; GtkWidget *label; GtkWidget *entry; GtkWidget *ok_button; GtkWidget *cancel_button; GtkWidget *prompt_label; } GksuuiDialog;
Convenience widget based on GtkDialog to request a password.
GtkDialog |
parent widget |
GtkWidget * |
GtkDialog's vbox |
GtkWidget * |
box to separate the image of the right-side widgets |
GtkWidget * |
the authorization image, left-side widget |
GtkWidget * |
right-side widgets container |
GtkWidget * |
message describing what is required from the user, right-side widget |
GtkWidget * |
place to type the password in, right-side widget |
GtkWidget * |
OK button of the dialog |
GtkWidget * |
Cancel button of the dialog |
GtkWidget * |
GtkWidget* gksuui_dialog_new (void);
Creates a new GksuuiDialog.
Returns : |
the new GksuuiDialog |
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.
|
the dialog on which to set the message |
|
the message to be set on the dialog |
const gchar* gksuui_dialog_get_message (GksuuiDialog *dialog);
Gets the current message that the dialog will use when run.
|
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. |
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.
|
the dialog on which the icon will be set |
|
a GdkPixbuf from which to set the image |
GtkWidget* gksuui_dialog_get_icon (GksuuiDialog *dialog);
Gets the GtkImage which is currently defined as the icon for the authorization dialog.
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()
|
the dialog from which to get the message |
Returns : |
a newly allocated string containing the password |