Ewl_List: A list widget

Detailed Description

Defines a class to layout data in a list.

Remarks:: Inherits from Ewl_MVC.
Inherits from Ewl_MVC.

Tutorial


Data Structures
struct	Ewl_List
	Inherits from Ewl_MVC and extends to provide a list widget. More...
struct	Ewl_List2
	Inherits from Ewl_MVC and extends to provide a list widget. More...
struct	Ewl_List2_Cell_Info
Defines
#define	EWL_LIST(list) ((Ewl_List *)list)
#define	EWL_LIST2(list) ((Ewl_List2 *)list)
#define	EWL_LIST2_IS(w) (ewl_widget_type_is(EWL_WIDGET(w), EWL_LIST2_TYPE))
#define	EWL_LIST2_TYPE "list2"
#define	EWL_LIST_IS(w) (ewl_widget_type_is(EWL_WIDGET(w), EWL_LIST_TYPE))
#define	EWL_LIST_TYPE "list"
Typedefs
typedef Ewl_List	Ewl_List
typedef Ewl_List2	Ewl_List2
typedef Ewl_List2_Cell_Info	Ewl_List2_Cell_Info
Functions
void	ewl_list2_cb_area_configure (Ewl_Widget w, void ev, void *data)
void	ewl_list2_cb_configure (Ewl_Widget w, void ev, void *data)
void	ewl_list2_cb_item_clicked (Ewl_Widget w, void ev, void *data)
void	ewl_list2_cb_selected_change (Ewl_MVC *mvc)
int	ewl_list2_init (Ewl_List2 *list)
	Initialises an Ewl_List widget to default values.
Ewl_Widget *	ewl_list2_new (void)
	Creates and initializes a new Ewl_List widget.
Ewl_Size_Acquisition	ewl_list2_size_acquisition_get (Ewl_List2 *list)
	Retrieve the size acquisition policy of the given list.
void	ewl_list2_size_acquisition_set (Ewl_List2 *list, Ewl_Size_Acquisition sizing)
	policy to querry the size information of the list items
void	ewl_list_cb_child_add (Ewl_Container c, Ewl_Widget w)
void	ewl_list_cb_configure (Ewl_Widget w, void ev, void *data)
void	ewl_list_cb_item_clicked (Ewl_Widget w, void ev, void *data)
void	ewl_list_cb_selected_change (Ewl_MVC *mvc)
int	ewl_list_init (Ewl_List *list)
	Initialises an Ewl_List widget to default values.
Ewl_Widget *	ewl_list_new (void)
	Creates and initializes a new Ewl_List widget.

Define Documentation

#define EWL_LIST ( list ) ((Ewl_List *)list)

Typecasts a pointer to an Ewl_List pointer

#define EWL_LIST2 ( list ) ((Ewl_List2 *)list)

#define EWL_LIST2_IS ( w ) (ewl_widget_type_is(EWL_WIDGET(w), EWL_LIST2_TYPE))

#define EWL_LIST2_TYPE "list2"

#define EWL_LIST_IS ( w ) (ewl_widget_type_is(EWL_WIDGET(w), EWL_LIST_TYPE))

Returns TRUE if the widget is an Ewl_LIST, FALSE otherwise

#define EWL_LIST_TYPE "list"

The type name for the Ewl_List widget

Typedef Documentation

typedef struct Ewl_List Ewl_List

The list strucutre

typedef struct Ewl_List2 Ewl_List2

The list strucutre

typedef struct Ewl_List2_Cell_Info Ewl_List2_Cell_Info

Function Documentation

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

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

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

void ewl_list2_cb_selected_change ( Ewl_MVC * mvc )

int ewl_list2_init ( Ewl_List2 * list )

Initialises an Ewl_List widget to default values.

Parameters:

list,:

The list to initialize

Returns:: Returns TRUE on success or FALSE on failure

Ewl_Widget* ewl_list2_new ( void )

Creates and initializes a new Ewl_List widget.

Returns:: Returns a new Ewl_Widget on success or NULL on failure

Ewl_Size_Acquisition ewl_list2_size_acquisition_get ( Ewl_List2 * list )

Retrieve the size acquisition policy of the given list.

list: The list to use

Returns:: Returns the size acquisition policy

See also:: ewl_list2_size_acquisition_set()

void ewl_list2_size_acquisition_set	(	Ewl_List2 *	list,
		Ewl_Size_Acquisition	sizing
	)

policy to querry the size information of the list items

Parameters:

list,:

The list to use sizing: the size acquisition policy

Since querrying the size information for huge count of list items is a expensive task, there are several ways to not make the process blocking the application.

With EWL_LIST2_SIZING_FIXED the size of the first item is used, for all other items. This is pretty fast but may result incorrect sized list items. Use this option when you now that all items have the same size.

With EWL_LIST2_SIZING_GROW the size are only querried slice by slice (slice >> item) in the background. You can only scroll to items that already have its size available.

Note:: Changing this value will only be effective if the size querring hasn't been started or if you force it to restart with marking the list dirty.

void ewl_list_cb_child_add	(	Ewl_Container *	c,
		Ewl_Widget *	w
	)

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

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

void ewl_list_cb_selected_change ( Ewl_MVC * mvc )

int ewl_list_init ( Ewl_List * list )

Initialises an Ewl_List widget to default values.

Parameters:

list,:

The list to initialize

Returns:: Returns TRUE on success or FALSE on failure

Ewl_Widget* ewl_list_new ( void )

Creates and initializes a new Ewl_List widget.

Returns:: Returns a new Ewl_Widget on success or NULL on failure

Ewl_List: A list widget

Detailed Description

Tutorial

Data Structures

Defines

Typedefs

Functions

Define Documentation

Typedef Documentation

Function Documentation