 |
 |
 |
 |
Etk_Message_Dialog
Detailed Description
Etk_Message_Dialog is a convenient way to ask or to warn the user.
A message dialog can have several type (see Etk_Message_Dialog_Type), each type corresponding to a title and to an icon.
Several common predefined sets of buttons can be used by the message dialog (see Etk_Message_Dialog_Buttons), but you can also use ETK_MESSAGE_DIALOG_NONE and add your own buttons with etk_dialog_button_add().
- Object Hierarchy:
-
- Properties:
- "message-type": The type of the dialog's message which defined the title and the icon
Type: Integer (Etk_Message_Dialog_Type)Access: Read/WriteDefault Value: ETK_MESSAGE_DIALOG_INFO
- "buttons": The set of buttons used by the message dialog
Type: Integer (Etk_Message_Dialog_Buttons)Access: Read/WriteDefault Value: ETK_MESSAGE_DIALOG_NONE
- "text": The text of the message dialog
Type: String (char *)Access: Read/WriteDefault Value: NULL
|
Data Structures |
struct | Etk_Message_Dialog |
| [Widget] The structure of a message dialog More...
|
Defines |
#define | ETK_MESSAGE_DIALOG_TYPE (etk_message_dialog_type_get()) |
#define | ETK_MESSAGE_DIALOG(obj) (ETK_OBJECT_CAST((obj), ETK_MESSAGE_DIALOG_TYPE, Etk_Message_Dialog)) |
#define | ETK_IS_MESSAGE_DIALOG(obj) (ETK_OBJECT_CHECK_TYPE((obj), ETK_MESSAGE_DIALOG_TYPE)) |
Enumerations |
enum | Etk_Message_Dialog_Type {
ETK_MESSAGE_DIALOG_INFO,
ETK_MESSAGE_DIALOG_WARNING,
ETK_MESSAGE_DIALOG_QUESTION,
ETK_MESSAGE_DIALOG_ERROR
} |
| The type of the message of the dialog. More...
|
enum | Etk_Message_Dialog_Buttons |
| Some common sets of buttons for the message dialog. To use your own buttons, you can use ETK_MESSAGE_DIALOG_NONE and add your buttons with etk_dialog_button_add(). More...
|
Functions |
Etk_Widget * | etk_message_dialog_new (Etk_Message_Dialog_Type message_type, Etk_Message_Dialog_Buttons buttons, const char *text) |
| Creates a new message dialog.
|
void | etk_message_dialog_message_type_set (Etk_Message_Dialog *dialog, Etk_Message_Dialog_Type type) |
| Sets the type of the dialog's message. It will change the title and the icon of the message dialog.
|
Etk_Message_Dialog_Type | etk_message_dialog_message_type_get (Etk_Message_Dialog *dialog) |
| Gets the type of the dialog's message.
|
void | etk_message_dialog_buttons_set (Etk_Message_Dialog *dialog, Etk_Message_Dialog_Buttons buttons) |
| Sets the message dialog's buttons. To add your own buttons, use ETK_MESSAGE_DIALOG_NONE and add them with etk_dialog_button_add().
|
Etk_Message_Dialog_Buttons | etk_message_dialog_buttons_get (Etk_Message_Dialog *dialog) |
| Gets the set of buttons used by the message dialogs.
|
void | etk_message_dialog_text_set (Etk_Message_Dialog *dialog, const char *text) |
| Sets the message dialog's text.
|
const char * | etk_message_dialog_text_get (Etk_Message_Dialog *dialog) |
| Gets the message dialog's text.
|
Define Documentation
#define ETK_MESSAGE_DIALOG_TYPE (etk_message_dialog_type_get()) |
#define ETK_MESSAGE_DIALOG |
( |
obj |
|
) |
(ETK_OBJECT_CAST((obj), ETK_MESSAGE_DIALOG_TYPE, Etk_Message_Dialog)) |
#define ETK_IS_MESSAGE_DIALOG |
( |
obj |
|
) |
(ETK_OBJECT_CHECK_TYPE((obj), ETK_MESSAGE_DIALOG_TYPE)) |
Enumeration Type Documentation
The type of the message of the dialog.
- Enumerator:
-
ETK_MESSAGE_DIALOG_INFO |
Informational message |
ETK_MESSAGE_DIALOG_WARNING |
Warning message |
ETK_MESSAGE_DIALOG_QUESTION |
Question message |
ETK_MESSAGE_DIALOG_ERROR |
Error message |
Some common sets of buttons for the message dialog. To use your own buttons, you can use ETK_MESSAGE_DIALOG_NONE and add your buttons with etk_dialog_button_add().
Function Documentation
Sets the type of the dialog's message. It will change the title and the icon of the message dialog.
- Parameters:
-
| dialog | a meesage dialog |
| type | the type to set |
References _, ETK_IMAGE, etk_image_set_from_stock(), ETK_MESSAGE_DIALOG_ERROR, ETK_MESSAGE_DIALOG_INFO, ETK_MESSAGE_DIALOG_QUESTION, ETK_MESSAGE_DIALOG_WARNING, ETK_OBJECT, etk_object_notify(), ETK_WINDOW, etk_window_title_set(), image, and message_type.
Gets the type of the dialog's message.
- Parameters:
-
- Returns:
- Returns the type of the dialog
References message_type.
Sets the message dialog's buttons. To add your own buttons, use ETK_MESSAGE_DIALOG_NONE and add them with etk_dialog_button_add().
- Parameters:
-
| dialog | a dialog |
| buttons | the type of the buttons |
References buttons, buttons_type, ETK_DIALOG, etk_dialog_button_add_from_stock(), ETK_OBJECT, etk_object_destroy(), etk_object_notify(), ETK_RESPONSE_CANCEL, ETK_RESPONSE_CLOSE, ETK_RESPONSE_NO, ETK_RESPONSE_OK, and ETK_RESPONSE_YES.
Gets the set of buttons used by the message dialogs.
- Parameters:
-
- Returns:
- Returns the set of the buttons used
References buttons_type.
|
 |
 |
 |
 |
|