SListBox

SListBox-Control, es stellt eine Liste von Einträgen zur Verfügung [Mehr ...]

Vererbung

Basisklassen(n)

abgeleitete Klassen

SWindow→

SControl→

SControlPositioned→

SControlPredefined→

SListBox

Attribute

public:

Attribut	Typ	Beschreibung
columnSpacing	int	Abstand zwischen den mit TAB getrennten Spalten in Pixeln.
orgWndProcListBox	WNDPROC	Standard-Behandlungsroutine des Controls
tabStops	SNumList	Liste mit den Breiten der einzelnen Spalten in Pixeln.

protected:

Attribut	Typ	Beschreibung
memTable	SMemTable*	SMemTable wenn diese als Datenquelle verwendet wird.
pLabel	SLabel*	Label der Listbox

Operationen

public:

Name	Parameter	Rückgabewert	Beschreibung
addFromMemTable	SMemTable* memTab, BOOL autoCalcTabs=true	int	Übernimmt sämtliche Daten aus der MemTable. Spalten werden mit TAB getrennt.
addLabel	const SString& text, int xOffset=0, int yOffset=-20	void	Fügt ein Label hinzu.
addString	const SString& entry, long data=0, int pos=SLB_APPEND	int	Fügt einen Eintrag zur Listbox hinzu.
calcTabstops		BOOL	Berechnet Tabstops nach den maximalen Spalteninhalten.
getCount		int	Synonym für getSize()
getCurSel		int	Ermittelt das aktuell selektierte Element in einer Single-Selection-Listbox.
getItemData	int index	long	Ermittelt den mit einem Eintrag verbundenem Long-Wert.
getSize		int	Ermittelt die Anzahl der Einträge.
getText	int index	SString	Liefert den Textwert eines Listeneintrags
removeAll		void	Entfernt alle Einträge aus der Listbox.
removeAt	int index	BOOL	Löscht ein beliebiges Element.
setCurSel	int index	BOOL	Setzt das aktuell selektierte Element.
setSel	int index, BOOL selected=true	BOOL	Setzt ein Element in der Multiselect-Listbox als markiert/unmarkiert.
setTabstops		BOOL	Setzt die Tabstops entprechend der in tabStops enthaltenen Spaltenbreiten (in Pixeln). Diese Funktion wird nach dem Create() automatisch aufgerufen.
winProcCtrlListBox	HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam	LRESULT CALLBACK	Behandlungsroutine für Windows-Nachrichten

protected:

Name	Parameter	Rückgabewert	Beschreibung
onPostCreateCtrl		void	Wird nach dem Erstellen und vor dem ersten Anzeigen ausgelöst.

Detailbeschreibung SListBox

SListBox-Control, es stellt eine Liste von Einträgen zur Verfügung

Beispiel:

listSamples.createCtrl(this,"Samples",10,10,50,100);	// Control erzeugen
listSamples.tabStops.add(200);	// Tabstop hinzufügen
listSamples.setTabstops();	// Tabstop anwenden
listSamples.addLabel("Beispiele (mit Doppel-Klick übernehmen):");	// ein Label (=Erklärungstext oder Titel) hinzufügen, steht dann über der Listbox
_AddEventCall_OnNotify(listSamples.getID(),LBN_DBLCLK,onListSample)	// eine Behandlungsroutine (= onListSample() ) für DoppelKlick zuweisen
listSamples.addString("einfache Suche\tEs ist das nasse Wasser zum Waschen da.\t.as");	// Einträge erstellen
listSamples.addString("Teile suchen, gierig\tEs ist das nasse Wasser zum Waschen da.\t.as.* ");
listSamples.addString("Teile suchen, nicht gierig\tEs ist das nasse Wasser zum Waschen da.\t.as.*? ");

Funktionsbeschreibungen

addFromMemTable(SMemTable* memTab, BOOL autoCalcTabs=true) int

Übernimmt sämtliche Daten aus der MemTable. Spalten werden mit TAB getrennt.

Parameter:

memTab	SMemTable aus der die Daten übernommen werden sollen
autoCalcTabs	Tabulatoren automatisch ermitteln

addLabel(const SString& text, int xOffset=0, int yOffset=-20) void

Fügt ein Label hinzu.

Parameter:

text	Text des Labels
xOffset	X-Position des Labels, relativ zur Listbox
yOffset	Y-Position des Labels, relativ zur Listbox

addString(const SString& entry, long data=0, int pos=SLB_APPEND) int

Fügt einen Eintrag zur Listbox hinzu.

In 'data' wird normalerweise ein long-Wert gespeichert. Durch Typumwandlung ist es aber auch möglich einen Zeiger zu Speichern, dieser benötigt genau soviel Speicherplatz wie ein long.

Parameter:

entry	Text des Eintrags
data	Daten des Eintrags
pos	Einfügeposition, SLB_APPEND für 'am Ende anfügen'

Rückgabe:

int	Position an der der neue Eintrag eingefügt wurde

calcTabstops() BOOL

Berechnet Tabstops nach den maximalen Spalteninhalten.

getCount() int

Synonym für getSize()

getCurSel() int

Ermittelt das aktuell selektierte Element in einer Single-Selection-Listbox.

Rückgabe:

int

index d