// Copyright (c) 2003,2004,2005 Juraj Kolesár <koli@koli.sk>               
#define TT_TABLE	GSList
/*
  Main variable of the tt_table functions
	-the idea is to keep separatly list of values from T_TABLE that 
	are actualy showed by tt_table_list
*/
/*** "PUBLIC" TO USE **********************************************************/
/* tt_table (POS, **T_TABLE, *T_COLS) {{{ */
int tt_table (POS point, T_TABLE **table, T_COLS *cols);
	/*
	MEAN
		-simpliest function to handle with T_TABLE data in WINDOW area
		-displayed according to T_COLS values
		-result after confirm:
			actual T_ROW from T_TABLE is stored in T_COLS values
		-moving cursor is changing actual T_ROW in T_TABLE
		-table size is computed as smaller number from list size and description
		or previous size defined in POS
}}} */
/* tt_table_qs (*WINDOW, *T_DB, *T_QS, *T_COLS) {{{ */
int tt_table_qs (WINDOW *win, T_DB *tdb, T_QS *qs, T_COLS *cols);
    /*
	MEAN
		-table data stored in T_MATRIX are read from T_DB 
		according to T_QS request (for more see ../db/tdb.h).
	    -shows filter line and calls tt_table_list in subwin area
	    handles user inputs to view data list (find,filter)
	USER EVENT HANDLING	
	    -after changing filter or find string by hiting char key
		actualized list is changed and showed immediatly. 
    RETURN
		(__TT_ENTER)-when actual row values are stored in T_COLS [Enter]
			all other exits keeps current fliter value in T_COLS
		(__TT_ESC)	-[Esc] pressed, f.e. nothing was chosen
		(__TT_INS)	-[Insert] pressed, f.e. new input wanted
}}} */
/* tt_table_combo(POS, **T_TABLE, *T_COLS) {{{ */
int tt_table_combo(POS point, T_TABLE **table, T_COLS *cols);
	/*
	MEAN
		-combo box on POS is displayed tt_table_draw_combo
		-when pressing [Enter] T_TABLE is displayed by tt_table and user
		can select T_ROW. After selection is table destroyed and
		called tt_table_draw_combo again with selected value of T_ROW
}}} */

/*** "DRAW" ("private", but could be used) ************************************/
/* tt_table_draw (*WINDOW, *T_COLS, *T_TABLE) {{{ */
int tt_table_draw (WINDOW *win, T_COLS *cols, T_TABLE *table);
	/*
}}} */
/* tt_table_draw_row (POS, char separator, *T_COLS, *T_ROW) {{{ */
int tt_table_draw_row (POS point, char separator, T_COLS *cols, T_ROW *row);
	/*
}}} */
/* tt_table_draw_list   (*WINDOW, *T_COLS, *T_TABLE, *TT_TABLE) {{{ */
int tt_table_draw_list (
	WINDOW *win, 
	T_COLS *cols, 
	T_TABLE *table, 
	TT_TABLE *v_table
);
    /* 
		-lists TT_TABLE data in WINDOW area according to T_COLS descriptions
		(when T_COLS list is shorter than the number of columns, 
		all not described columns use descripton of the last described)
		-when T_TABLE != NULL highliths the visible cursor 
}}} */
/* tt_table_draw_combo (POS, *T_COLS, *T_TABLE) {{{ */
int tt_table_draw_combo(POS point, T_COLS *cols, T_TABLE *table);
	/*
	-draws combo symbol "[v]" and actual T_ROW from T_TABLE
}}} */
/* tt_table_draw_filter (*WINDOW, *T_COLS) {{{ */
int tt_table_draw_filter (WINDOW *win, T_COLS *cols);
	/*
	lists actual filter(T_COLS) values in WINDOW starting on position (1,1)
	(internal function for tt_table_qs)
}}} */
/*** "INTERNAL" ("private", not recomended for external use) ******************/
/* tt_table_init (int rows, *T_TABLE, **TT_TABLE) {{{ */
int tt_table_init(int rows, T_TABLE *table, TT_TABLE **v_table);
	/*
	MEAN
		initialization of TT_TABLE
		-starts from the actual position in T_TABLE		
	RETURN
		(number) of rows initialized
			-could be less or equal to "rows" attribute
			according to size of parent T_TABLE
		(0) if T_TABLE = NULL
}}} */
/* tt_table_store (*T_TABLE, *T_COLS) {{{ */
int tt_table_store(T_TABLE *table, T_COLS *cols);
	/*
	MEAN
		-stores actual T_ROW to T_COLS 
		-is called after hiting [Enter] or another confirm key
	RETURN
		__LT_OK  - when stored, or T_TABLE=NULL and nothing changed
		__LT_ERR - when T_COLS list is shorter than T_ROW
}}} */
/* tt_table_cursor   (*T_TABLE, *TT_TABLE) {{{ */
int tt_table_cursor(T_TABLE *table, TT_TABLE *v_table);
	/*
	RETURN
		(value) of visual cursor vertical position	(first line has value '1')
		(0) -if lt_table=NULL 
}}} */
/* tt_table_next     (**T_TABLE, **TT_TABLE) {{{ */
int tt_table_next(T_TABLE **table, TT_TABLE **v_table);
	/*after hiting KEY_DOWN
	-if possible then T_TABLE cursor is moved to new position 
	and	TT_TABLE values are changed if necessary 
	(when visible cursor is in the end of the table, first item 
	from TT_TABLE goes out and new from T_TABLE is added)
}}} */
/* tt_table_previous (**T_TABLE, **TT_TABLE) {{{ */
int tt_table_previous(T_TABLE **table, TT_TABLE **v_table);
	/*after hiting KEY_UP
	simmilar to tt_table_next but in oposite garde
}}} */
/* tt_table_search (char *str, int column, **T_TABLE, **TT_TABLE) {{{ */
int tt_table_search(char *str, int column,
					 T_TABLE **table, TT_TABLE **v_table);
	/*after hiting key it is added (or removed) to search string and 
	searched for it	in actual column
???	-need to make new strcmp function 
	where string "n333umber" would be less then "n3umber"
}}} */
/* tt_table_find   (char *str, int column, **T_TABLE, **TT_TABLE) {{{ */
int tt_table_find(char *str, int column,
					 T_TABLE **table, TT_TABLE **v_table);
	/*similar to search but it fills the whole value of str when SURE
}}} */