mList.c File Reference

GTK - multiColumnList GUI_nList_. More...

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <gtk/gtk.h>
#include "../gtk/ut_gtk.h"

Functions
int	GUI_mList_add (GUIobj_mList *wLst, char *txt)
int	GUI_mList_modify_rowNr (GUIobj_mList *wLst, char *txt, int lNr)
int	GUI_mList_read_rowNr (char *outTxt, GUIobj_mList *wLst, int lNr)
int	GUI_mList_rowNr2iter (GtkTreeIter *iter, GUIobj_mList *wLst, int lNr)
int	GUI_mList_iter2rowNr (GUIobj_mList *wLst, GtkTreeIter *iter)
int	GUI_mList_set_cursor (GUIobj_mList *wLst, int lNr)
int	GUI_mList_DelRow (GUIobj_mList *wLst, int lNr)
int	GUI_mList_read_iter (char *txtOut, GUIobj_mList *wLst, GtkTreeIter *iter)
int	GUI_mList_lNr (GUIobj_mList *wLst)
int	GUI_mList_get_sel_nr (GUIobj_mList *wLst)
int	GUI_mList__ (GtkWidget *parent, GUIobj_mList *nLst, char *hdrLn, int iSel, void *selCB, void *keyCB, void *mouseCB)

---

Detailed Description

GTK - multiColumnList GUI_nList_.

=====================================================
Liste_Funktionen_Beginn:

GUI_mList__            create simple List
GUI_mList_add          append Row to List
GUI_mList_lNr          query nr of lines in List
GUI_mList_read_iter    get text of row from iter
GUI_mList_read_rowNr   get text of row nr lNr
GUI_mList_DelRow       delete row lNr
GUI_mList_set_cursor   select row nr lNr
GUI_mList_iter2rowNr   get lineNumber from iter
GUI_mList_rowNr2iter   get iter from lineNumber
GUI_mList_modify_rowNr modify text of row lNr
GUI_mList_get_sel_nr   get lineNr of selected line

Liste_Funktionen_Ende:
=====================================================

- usage examples:

static GUIobj_mList    w_lst1;

  GUI_mList__ (box0, &w_lst1, &w_tree1, "colTit", 1, NULL,NULL,NULL);
  GUI_mList_add (&w_lst1, "first line");
  ..
  gtk_widget_grab_focus (GTK_WIDGET(w_lst1.tree));   // focus on list
  ..
  gtk_widget_set_sensitive (w_lst1.tree, FALSE);     // disable List

- see also:
  ../gtk/tst_mList.c

---

Function Documentation

int GUI_mList_add	(	GUIobj_mList *	wLst,
		char *	txt
	)

append Row to List

int GUI_mList_modify_rowNr	(	GUIobj_mList *	wLst,
		char *	txt,
		int	lNr
	)

    modify text of row lNr
    see also jb_list_load

int GUI_mList_read_rowNr	(	char *	outTxt,
		GUIobj_mList *	wLst,
		int	lNr
	)

int GUI_mList_rowNr2iter	(	GtkTreeIter *	iter,
		GUIobj_mList *	wLst,
		int	lNr
	)

    get iter from rownumber
      lNr    (0 = first)

int GUI_mList_iter2rowNr	(	GUIobj_mList *	wLst,
		GtkTreeIter *	iter
	)

get lineNumber from iter

int GUI_mList_set_cursor	(	GUIobj_mList *	wLst,
		int	lNr
	)

    select row nr lNr         First line = 0
    GUI_update__ ();          // force Update

int GUI_mList_DelRow	(	GUIobj_mList *	wLst,
		int	lNr
	)

    delete row lNr
      lNr     rewNumber; 0 = first row; -1 = delete all rows !

int GUI_mList_read_iter	(	char *	txtOut,
		GUIobj_mList *	wLst,
		GtkTreeIter *	iter
	)

    get text if row nr lNr
      lNr    (0 = first)

int GUI_mList_lNr

(

GUIobj_mList *

wLst

)

query nr of lines in List

int GUI_mList_get_sel_nr

(

GUIobj_mList *

wLst

)

GUI_mList_get_sel_nr get lineNr of selected line

int GUI_mList__	(	GtkWidget *	parent,
		GUIobj_mList *	nLst,
		char *	hdrLn,
		int	iSel,
		void *	selCB,
		void *	keyCB,
		void *	mouseCB
	)

    create simple List (1 column only)
      hdrLn  title in headerline;  NULL = no headerline.
      iSel   0=not selectable, 1=singleSelections, 2=multiSelections
      wSiz   unused