Ewl_Message: A dialog window for showing a message

---

Detailed Description

Defines the Ewl_Message class which extends the Ewl_Icondialog class.

Remarks:

Inherits from Ewl_Icondialog.

Data Structures
struct	Ewl_Message
	Inherits from Ewl_Dialog and extends to provide a message widget. More...
Defines
#define	EWL_MESSAGE(m)   ((Ewl_Message *) m)
#define	EWL_MESSAGE_IS(w)   (ewl_widget_type_is(EWL_WIDGET(w), EWL_MESSAGE_TYPE))
#define	EWL_MESSAGE_TYPE   "message"
Typedefs
typedef struct Ewl_Message	Ewl_Message
Functions
const char *	ewl_message_brief_text_get (Ewl_Message *m)
void	ewl_message_brief_text_set (Ewl_Message *m, const char *text)
	Set the brief text to the message.
void	ewl_message_cb_quit (Ewl_Widget *w, void *ev, void *data)
const char *	ewl_message_detailed_text_get (Ewl_Message *m)
void	ewl_message_detailed_text_set (Ewl_Message *m, const char *text)
	Set the detaileded text to the message.
int	ewl_message_init (Ewl_Message *m)
	Initialize an internal message to starting values.
Ewl_Widget *	ewl_message_new (void)
	Create a new internal message.

---

Define Documentation

#define EWL_MESSAGE

(

m

)

((Ewl_Message *) m)

Typecasts a pointer to an Ewl_Message pointer.

#define EWL_MESSAGE_IS

(

w

)

(ewl_widget_type_is(EWL_WIDGET(w), EWL_MESSAGE_TYPE))

Returns TRUE if the widget is an Ewl_Message, FALSE otherwise

#define EWL_MESSAGE_TYPE   "message"

Widget Theme Keys:

/message/file

Widget Theme Keys:

/message/group

The type name for the Ewl_Message widget

Referenced by ewl_message_brief_text_set(), ewl_message_cb_quit(), ewl_message_detailed_text_set(), and ewl_message_init().

---

Typedef Documentation

typedef struct Ewl_Message Ewl_Message

The message structure extends the dialog with an icon.

---

Function Documentation

const char* ewl_message_brief_text_get

(

Ewl_Message *

m

)

void ewl_message_brief_text_set	(	Ewl_Message *	m,
		const char *	brief
	)

Set the brief text to the message.

Parameters:

	m,:	message to set the brief text
	brief,:	a brief form of the message

Returns:

Returns no value.

References brief, DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, EWL_MESSAGE_TYPE, EWL_TEXT, ewl_text_clear(), ewl_text_font_set(), and ewl_text_text_append().

void ewl_message_cb_quit	(	Ewl_Widget *	w,
		void *	ev,
		void *	data
	)

const char* ewl_message_detailed_text_get

(

Ewl_Message *

m

)

void ewl_message_detailed_text_set	(	Ewl_Message *	m,
		const char *	detailed
	)

Set the detaileded text to the message.

Parameters:

	m,:	message to set the brief text
	detailed,:	a detaileded form of the message

Returns:

Returns no value.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, detailed, DLEAVE_FUNCTION, DLEVEL_STABLE, EWL_MESSAGE_TYPE, EWL_TEXT, ewl_text_clear(), ewl_text_text_append(), ewl_text_wrap_set(), and EWL_TEXT_WRAP_WORD.

int ewl_message_init

(

Ewl_Message *

m

)

Initialize an internal message to starting values.

Parameters:

dialog,:

the message to initialize.

Returns:

Return TRUE on success, FALSE otherwise.

References brief, DCHECK_PARAM_PTR_RET, DENTER_FUNCTION, detailed, DLEVEL_STABLE, DRETURN_INT, ewl_button_new(), ewl_callback_append(), EWL_CALLBACK_CLICKED, EWL_CALLBACK_DELETE_WINDOW, EWL_CONTAINER, ewl_container_child_append(), EWL_DIALOG, ewl_dialog_active_area_set(), EWL_FLAG_FILL_NONE, EWL_ICONDIALOG, ewl_icondialog_init(), EWL_ICONDIALOG_TYPE, ewl_message_cb_quit(), EWL_MESSAGE_TYPE, EWL_OBJECT, ewl_object_fill_policy_set(), EWL_POSITION_BOTTOM, EWL_POSITION_TOP, EWL_STOCK, EWL_STOCK_OK, ewl_stock_type_set(), ewl_text_new(), EWL_WIDGET, ewl_widget_appearance_set(), ewl_widget_inherit(), ewl_widget_show(), EWL_WINDOW, and ewl_window_dialog_set().

Referenced by ewl_message_new().

Ewl_Widget* ewl_message_new

(

void

)

Create a new internal message.

Returns:

Returns a pointer to a new message on success, NULL on failure.

References DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, ewl_message_init(), EWL_WIDGET, ewl_widget_destroy(), and NEW.