Ewl_Row: The Row widget

---

Detailed Description

Defines a widget to display a row

Remarks:

Inherits from Ewl_Container.

Data Structures
struct	Ewl_Row
	Inherits from Ewl_Container to create a tree row that lays out cells in a left to right fashion. More...
Defines
#define	EWL_ROW(t)   ((Ewl_Row *)t)
#define	EWL_ROW_IS(w)   (ewl_widget_type_is(EWL_WIDGET(w), EWL_ROW_TYPE))
#define	EWL_ROW_TYPE   "row"
Typedefs
typedef struct Ewl_Row	Ewl_Row
Functions
void	ewl_row_cb_child_hide (Ewl_Container *c, Ewl_Widget *w)
void	ewl_row_cb_child_resize (Ewl_Container *c, Ewl_Widget *w, int size, Ewl_Orientation o)
void	ewl_row_cb_child_show (Ewl_Container *c, Ewl_Widget *w)
void	ewl_row_cb_configure (Ewl_Widget *w, void *ev_data, void *user_data)
void	ewl_row_cb_header_configure (Ewl_Widget *w, void *ev_data, void *user_data)
void	ewl_row_cb_header_destroy (Ewl_Widget *w, void *ev_data, void *user_data)
Ewl_Widget *	ewl_row_column_get (Ewl_Row *row, short n)
	Retrieve the widget at a specified column.
void	ewl_row_header_set (Ewl_Row *row, Ewl_Container *header)
	Set the row header of constraints on cell widths.
int	ewl_row_init (Ewl_Row *row)
	Initialize the row fields of an inheriting object.
Ewl_Widget *	ewl_row_new (void)
	Allocate and initialize a new row.

---

Define Documentation

#define EWL_ROW

(

t

)

((Ewl_Row *)t)

Typecasts a pointer to an Ewl_Row pointer

Referenced by ewl_row_cb_configure(), ewl_row_cb_header_configure(), ewl_row_cb_header_destroy(), and ewl_row_new().

#define EWL_ROW_IS

(

w

)

(ewl_widget_type_is(EWL_WIDGET(w), EWL_ROW_TYPE))

Returns TRUE if the widget is an Ewl_Row, FALSE otherwise

#define EWL_ROW_TYPE   "row"

Widget Theme Keys:

/row/file

Widget Theme Keys:

/row/group

The type name for the Ewl_Row widget

Referenced by ewl_row_cb_child_hide(), ewl_row_cb_child_resize(), ewl_row_cb_child_show(), ewl_row_column_get(), ewl_row_header_set(), ewl_row_init(), and ewl_tree_node_row_set().

---

Typedef Documentation

typedef struct Ewl_Row Ewl_Row

The Ewl_Row widget

---

Function Documentation

void ewl_row_cb_child_hide	(	Ewl_Container *	c,
		Ewl_Widget *	w
	)

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_container_largest_prefer(), EWL_OBJECT, ewl_object_preferred_inner_w_set(), ewl_object_preferred_w_get(), EWL_ORIENTATION_VERTICAL, EWL_ROW_TYPE, EWL_WIDGET_TYPE, and PREFERRED_W.

Referenced by ewl_row_init().

void ewl_row_cb_child_resize	(	Ewl_Container *	c,
		Ewl_Widget *	w,
		int	size,
		Ewl_Orientation	o
	)

void ewl_row_cb_child_show	(	Ewl_Container *	c,
		Ewl_Widget *	w
	)

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, ewl_container_largest_prefer(), EWL_OBJECT, ewl_object_preferred_inner_w_set(), ewl_object_preferred_w_get(), EWL_ORIENTATION_VERTICAL, EWL_ROW_TYPE, EWL_WIDGET_TYPE, and PREFERRED_W.

Referenced by ewl_row_init().

void ewl_row_cb_configure	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_row_cb_header_configure	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_row_cb_header_destroy	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

Ewl_Widget* ewl_row_column_get	(	Ewl_Row *	row,
		short	n
	)

Retrieve the widget at a specified column.

Parameters:

	row,:	the row to retrieve a columns widget from
	n,:	the column containing the desired widget

Returns:

Returns widget located in column n in row on success.

References DCHECK_PARAM_PTR_RET, DCHECK_TYPE_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, EWL_CONTAINER, and EWL_ROW_TYPE.

void ewl_row_header_set	(	Ewl_Row *	row,
		Ewl_Container *	header
	)

Set the row header of constraints on cell widths.

Parameters:

	row,:	the row to change the header row
	header,:	header row for adjusting cell placement

Returns:

Returns no value. Changes the row that cell widths and placements will be based on to header.

References DCHECK_PARAM_PTR, DCHECK_TYPE, DENTER_FUNCTION, DLEAVE_FUNCTION, DLEVEL_STABLE, DRETURN, EWL_FLAG_FILL_HFILL, EWL_OBJECT, ewl_object_fill_policy_set(), EWL_ROW_TYPE, EWL_WIDGET, ewl_widget_configure(), and header.

Referenced by ewl_row_cb_header_destroy().

int ewl_row_init

(

Ewl_Row *

row

)

Initialize the row fields of an inheriting object.

Parameters:

row,:

the row object to initialize

Returns:

Returns TRUE on success, FALSE on failure. The fields of the row object are initialized to their defaults.

References DCHECK_PARAM_PTR_RET, DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_INT, ewl_callback_append(), EWL_CALLBACK_CONFIGURE, EWL_CALLBACK_STATE_CHANGED, EWL_CONTAINER, ewl_container_hide_notify_set(), ewl_container_init(), ewl_container_resize_notify_set(), ewl_container_show_notify_set(), EWL_FLAG_FILL_HFILL, EWL_OBJECT, ewl_object_fill_policy_set(), ewl_row_cb_child_hide(), ewl_row_cb_child_resize(), ewl_row_cb_child_show(), ewl_row_cb_configure(), EWL_ROW_TYPE, EWL_WIDGET, ewl_widget_appearance_set(), ewl_widget_focusable_set(), and ewl_widget_inherit().

Referenced by ewl_row_new().

Ewl_Widget* ewl_row_new

(

void

)

Allocate and initialize a new row.

Returns:

Returns a newly allocated row on success, NULL on failure.

References DENTER_FUNCTION, DLEVEL_STABLE, DRETURN_PTR, EWL_ROW, ewl_row_init(), ewl_widget_destroy(), and NEW.