xmultilistview.h File Reference

Go to the source code of this file.

Data Structures
struct	ViewMultiList_t
	ViewMultiList_t - struct to hold information for the listview. More...

Functions
void	multi_listview_set_active_entry (Widget_t *w, int active)
	multi_listview_set_active_entry - set the active listview entry
void	multi_listview_unset_active_entry (Widget_t *w)
	multi_listview_unset_active_entry - unset the active listview entry
Widget_t *	create_multi_listview_viewport (Widget_t *parent, int elem, int width, int height)
	create_multi_listview_viewport - create a viewport on a listview to a Widget_t
Widget_t *	add_multi_listview (Widget_t *parent, const char *label, int x, int y, int width, int height)
	add_label - add a listview to a Widget_t
void	multi_listview_mem_free (void *w_, void *user_data)
	multi_listview_mem_free - release additional used memory when destroy the Widget_t
void	multi_listview_remove_list (Widget_t *listview)
	multi_listview_remove_list - remove the list from a listview Widget_t
void	multi_listview_set_list (Widget_t *listview, char **list, int list_size)
	multi_listview_set_multi_list - set a list to a listview Widget_t
void	multi_listview_set_check_dir (Widget_t *listview, int set)
	multi_listview_set_check_dir - set optional check if list item is a directory
void	multi_listview_set_item_size (Widget_t *listview, float set)
	multi_listview_set_item_size - set size for the icons in the viewport

Function Documentation

add_multi_listview()

Widget_t * add_multi_listview	(	Widget_t *	parent,
		const char *	label,
		int	x,
		int	y,
		int	width,
		int	height
	)

add_label - add a listview to a Widget_t

Parameters

*parent	- pointer to the Widget_t request the label
*label	- Label to show on the button
x,y,width,height	- the position/geometry to create the label

Returns

Widget_t* - pointer to the Widget_t label struct

Definition at line 72 of file xmultilistview.c.

                                                     {
 
    Widget_t *wid = create_widget(parent->app, parent, x, y, width, height);
    wid->label = label;
    wid->scale.gravity = CENTER;
    wid->flags &= ~USE_TRANSPARENCY;
    wid->func.expose_callback = _draw_multi_listview;
    int elem = height/75;
    wid->adj_y = add_adjustment(wid,0.0, 0.0, 0.0, -1.0,1.0, CL_NONE);
    wid->adj = wid->adj_y;
    Widget_t *viewport = create_multi_listview_viewport(wid, elem, width-10, height);
 
    ViewMultiList_t *filelist = (ViewMultiList_t*)viewport->parent_struct;
    filelist->tooltip_text = NULL;
    filelist->folder = surface_get_png(wid, filelist->folder, LDVAR(directory_png));
    filelist->folder_select = surface_get_png(wid, filelist->folder_select, LDVAR(directory_select_png));
    filelist->file = surface_get_png(wid, filelist->file, LDVAR(file_png));
    filelist->folder_scaled = NULL;
    filelist->folder_select_scaled = NULL;
    filelist->file_scaled = NULL;
    filelist->scale_down = 0.2;
    filelist->scale_up = 1.0/0.2;
    filelist->item_height = 375*filelist->scale_down;
    filelist->item_width = 500*filelist->scale_down;
    filelist->column = max(1,width/filelist->item_width);
    filelist->icon_pos = (filelist->item_width/2) - 120/filelist->scale_up;
    filelist->slider = add_vslider(wid, "", width-10, 0, 10, height);
    filelist->slider->func.expose_callback = _draw_multi_listviewslider;
    filelist->slider->adj_y = add_adjustment(filelist->slider,0.0, 0.0, 0.0, 1.0,1.0, CL_VIEWPORTSLIDER);
    filelist->slider->adj = filelist->slider->adj_y;
    filelist->slider->func.value_changed_callback = _set_multi_listviewport;
    filelist->slider->scale.gravity = WESTSOUTH;
    filelist->slider->flags &= ~USE_TRANSPARENCY;
    filelist->slider->flags |= NO_AUTOREPEAT | NO_PROPAGATE;
    filelist->slider->parent_struct = viewport;
 
    return wid;
}

References _draw_multi_listview(), _draw_multi_listviewslider(), _set_multi_listviewport(), add_adjustment(), add_vslider(), Widget_t::adj, Widget_t::adj_y, Widget_t::app, CENTER, CL_NONE, CL_VIEWPORTSLIDER, ViewMultiList_t::column, create_multi_listview_viewport(), create_widget(), Func_t::expose_callback, ViewMultiList_t::file, ViewMultiList_t::file_scaled, Widget_t::flags, ViewMultiList_t::folder, ViewMultiList_t::folder_scaled, ViewMultiList_t::folder_select, ViewMultiList_t::folder_select_scaled, Widget_t::func, Resize_t::gravity, ViewMultiList_t::icon_pos, ViewMultiList_t::item_height, ViewMultiList_t::item_width, Widget_t::label, NO_AUTOREPEAT, NO_PROPAGATE, Widget_t::parent_struct, Widget_t::scale, ViewMultiList_t::scale_down, ViewMultiList_t::scale_up, ViewMultiList_t::slider, surface_get_png(), ViewMultiList_t::tooltip_text, Func_t::value_changed_callback, and WESTSOUTH.

Referenced by open_file_dialog().

create_multi_listview_viewport()

Widget_t * create_multi_listview_viewport	(	Widget_t *	parent,
		int	elem,
		int	width,
		int	height
	)

create_multi_listview_viewport - create a viewport on a listview to a Widget_t

Parameters

*parent	- pointer to the Widget_t the listview should pop over
elem	- define how many entries to show in the viewport
width	- define the width of the viewport
height	- define the height of the viewport

Returns

Widget_t* - pointer to the Widget_t viewport

Definition at line 46 of file xmultilistview.c.

                                                                                            {
    Widget_t *wid = create_widget(parent->app, parent, 0, 0, width, height);
    os_set_input_mask(wid);
    wid->scale.gravity = NORTHWEST;
    ViewMultiList_t *filelist;
    filelist = (ViewMultiList_t*)malloc(sizeof(ViewMultiList_t));
    filelist->show_items = elem;
    filelist->check_dir = 0;
    wid->flags |= HAS_MEM;
    wid->parent_struct = filelist;
    float max_value = -elem;
    wid->adj_y = add_adjustment(wid,0.0, 0.0, 0.0, max_value,1.0, CL_VIEWPORT);
    wid->adj = wid->adj_y;
    wid->func.adj_callback = _set_multi_listview_viewpoint;
    wid->func.motion_callback = _multi_list_motion;
    wid->func.leave_callback = _leave_multi_list;
    wid->func.button_release_callback = _multi_list_entry_released;
    wid->func.double_click_callback = _multi_list_entry_double_clicked;
    wid->func.key_press_callback = _multi_list_key_pressed;
    wid->func.expose_callback = _draw_multi_list;
    wid->func.configure_notify_callback = _reconfigure_multi_listview_viewport;
    wid->func.map_notify_callback = _reconfigure_multi_listview_viewport;
    wid->func.mem_free_callback = multi_listview_mem_free;
    return wid;
}

References _draw_multi_list(), _leave_multi_list(), _multi_list_entry_double_clicked(), _multi_list_entry_released(), _multi_list_key_pressed(), _multi_list_motion(), _reconfigure_multi_listview_viewport(), _set_multi_listview_viewpoint(), add_adjustment(), Widget_t::adj, Func_t::adj_callback, Widget_t::adj_y, Widget_t::app, Func_t::button_release_callback, ViewMultiList_t::check_dir, CL_VIEWPORT, Func_t::configure_notify_callback, create_widget(), Func_t::double_click_callback, Func_t::expose_callback, Widget_t::flags, Widget_t::func, Resize_t::gravity, HAS_MEM, Func_t::key_press_callback, Func_t::leave_callback, Func_t::map_notify_callback, Func_t::mem_free_callback, Func_t::motion_callback, multi_listview_mem_free(), NORTHWEST, os_set_input_mask(), Widget_t::parent_struct, Widget_t::scale, and ViewMultiList_t::show_items.

Referenced by add_multi_listview().

multi_listview_mem_free()

void multi_listview_mem_free	(	void *	w_,
		void *	user_data
	)

multi_listview_mem_free - release additional used memory when destroy the Widget_t

Parameters

*w_	- void pointer to the Widget_t
*user_data	- void pointer to attached user_data

Definition at line 112 of file xmultilistview.c.

                                                        {
    Widget_t *w = (Widget_t*)w_;
    ViewMultiList_t *filelist = (ViewMultiList_t*)w->parent_struct;
    cairo_surface_destroy(filelist->folder);
    cairo_surface_destroy(filelist->folder_select);
    cairo_surface_destroy(filelist->file);
    cairo_surface_destroy(filelist->folder_scaled);
    cairo_surface_destroy(filelist->folder_select_scaled);
    cairo_surface_destroy(filelist->file_scaled);
    free(filelist->tooltip_text);
    free(filelist);
}

References ViewMultiList_t::file, ViewMultiList_t::file_scaled, ViewMultiList_t::folder, ViewMultiList_t::folder_scaled, ViewMultiList_t::folder_select, ViewMultiList_t::folder_select_scaled, Widget_t::parent_struct, and ViewMultiList_t::tooltip_text.

Referenced by create_multi_listview_viewport().

multi_listview_remove_list()

void multi_listview_remove_list

(

Widget_t *

listview

)

multi_listview_remove_list - remove the list from a listview Widget_t

Parameters

*listview

- pointer to the Widget_t listview which should show the list

Definition at line 125 of file xmultilistview.c.

                                                    {
    Widget_t* view_port =  listview->childlist->childs[0];
    ViewMultiList_t *filelist = (ViewMultiList_t*)view_port->parent_struct;
    filelist->list_names = NULL;
    filelist->list_size = 0;
    Metrics_t metrics;
    os_get_window_metrics(listview, &metrics);
    int height = metrics.height;
    float elem = height/filelist->item_height;
    set_adjustment(listview->adj,0.0, 0.0, 0.0, -1.0,1.0, CL_NONE);
    set_adjustment(view_port->adj,0.0, 0.0, 0.0, -elem,1.0, CL_VIEWPORT);
    adj_set_value(filelist->slider->adj,0.0);
}

References Widget_t::adj, adj_set_value(), Widget_t::childlist, Childlist_t::childs, CL_NONE, CL_VIEWPORT, Metrics_t::height, ViewMultiList_t::item_height, ViewMultiList_t::list_names, ViewMultiList_t::list_size, os_get_window_metrics(), Widget_t::parent_struct, set_adjustment(), and ViewMultiList_t::slider.

multi_listview_set_active_entry()

void multi_listview_set_active_entry	(	Widget_t *	w,
		int	active
	)

multi_listview_set_active_entry - set the active listview entry

Parameters

*w	- void pointer to the Widget_t listview
active	- the active entry (int)

Definition at line 28 of file xmultilistview.c.

                                                              {
    if(active<0) return;
    Widget_t* view_port =  w->childlist->childs[0];
    ViewMultiList_t *filelist = (ViewMultiList_t*)view_port->parent_struct;
    float value = (float)active;
    if (value>w->adj->max_value) value = w->adj->max_value;
    else if (value<w->adj->min_value) value = w->adj->min_value;
    filelist->active_item = (int)value;
    adj_set_value(w->adj,filelist->active_item);
}

References ViewMultiList_t::active_item, Widget_t::adj, adj_set_value(), Widget_t::childlist, Childlist_t::childs, Adjustment_t::max_value, Adjustment_t::min_value, and Widget_t::parent_struct.

Referenced by open_file_dialog().

multi_listview_set_check_dir()

void multi_listview_set_check_dir	(	Widget_t *	listview,
		int	set
	)

multi_listview_set_check_dir - set optional check if list item is a directory

Parameters

*listview	- pointer to the Widget_t listview which should show the list
set	- 0 = no check (default); 1 = check

Definition at line 150 of file xmultilistview.c.

                                                               {
    Widget_t* view_port =  listview->childlist->childs[0];
    ViewMultiList_t *filelist = (ViewMultiList_t*)view_port->parent_struct;
    filelist->check_dir = set;
}

References ViewMultiList_t::check_dir, Widget_t::childlist, Childlist_t::childs, and Widget_t::parent_struct.

Referenced by open_file_dialog().

multi_listview_set_item_size()

void multi_listview_set_item_size	(	Widget_t *	listview,
		float	set
	)

multi_listview_set_item_size - set size for the icons in the viewport

Parameters

*listview	- pointer to the Widget_t listview which should show the list
set	- scale factor range from 0.1 <-> 0.4

Definition at line 175 of file xmultilistview.c.

                                                                 {
    Widget_t* view_port =  listview->childlist->childs[0];
    ViewMultiList_t *filelist = (ViewMultiList_t*)view_port->parent_struct;
    filelist->scale_down = set;
    filelist->scale_up = 1.0/set;
    filelist->item_height = 375*filelist->scale_down;
    filelist->item_width = 500*filelist->scale_down;
    _reconfigure_multi_listview_viewport(view_port, NULL);
    filelist->folder_scaled = scale_image(listview,filelist,filelist->folder, filelist->folder_scaled);
    filelist->folder_select_scaled = scale_image(listview,filelist,filelist->folder_select, filelist->folder_select_scaled);
    filelist->file_scaled = scale_image(listview,filelist,filelist->file, filelist->file_scaled);
    expose_widget(view_port);
}

References _reconfigure_multi_listview_viewport(), Widget_t::childlist, Childlist_t::childs, expose_widget(), ViewMultiList_t::file, ViewMultiList_t::file_scaled, ViewMultiList_t::folder, ViewMultiList_t::folder_scaled, ViewMultiList_t::folder_select, ViewMultiList_t::folder_select_scaled, ViewMultiList_t::item_height, ViewMultiList_t::item_width, Widget_t::parent_struct, ViewMultiList_t::scale_down, scale_image(), and ViewMultiList_t::scale_up.

Referenced by multi_listview_set_list().

multi_listview_set_list()

void multi_listview_set_list	(	Widget_t *	listview,
		char **	list,
		int	list_size
	)

multi_listview_set_multi_list - set a list to a listview Widget_t

Parameters

*listview	- pointer to the Widget_t listview which should show the list
**list	- pointer to the list
list_size	- how many items contain the list

Definition at line 139 of file xmultilistview.c.

                                                                             {
    Widget_t* view_port =  listview->childlist->childs[0];
    ViewMultiList_t *filelist = (ViewMultiList_t*)view_port->parent_struct;
    filelist->list_names = list;
    filelist->list_size = list_size;
    set_adjustment(listview->adj,0.0, 0.0, 0.0, (float)(list_size-1.0),1.0, CL_NONE);
    float max_value = view_port->adj->max_value+ (float)list_size;
    set_adjustment(view_port->adj,0.0, 0.0, 0.0, max_value,1.0, CL_VIEWPORT);
    multi_listview_set_item_size(listview, filelist->scale_down);
}

References Widget_t::adj, Widget_t::childlist, Childlist_t::childs, CL_NONE, CL_VIEWPORT, ViewMultiList_t::list_names, ViewMultiList_t::list_size, Adjustment_t::max_value, multi_listview_set_item_size(), Widget_t::parent_struct, ViewMultiList_t::scale_down, and set_adjustment().

multi_listview_unset_active_entry()

void multi_listview_unset_active_entry

(

Widget_t *

w

)

multi_listview_unset_active_entry - unset the active listview entry

Parameters

*w	- void pointer to the Widget_t listview

Definition at line 39 of file xmultilistview.c.

                                                    {
    Widget_t* view_port =  w->childlist->childs[0];
    ViewMultiList_t *filelist = (ViewMultiList_t*)view_port->parent_struct;
    filelist->active_item = -1;
    filelist->prelight_item = -1;
}

References ViewMultiList_t::active_item, Widget_t::childlist, Childlist_t::childs, Widget_t::parent_struct, and ViewMultiList_t::prelight_item.

Referenced by open_file_dialog().