SComboBox

Eine ComboBox ist eine Kombination aus Listbox(Ausfahlfeld) und Eingabefeld. [Mehr ...]

Vererbung

Basisklassen(n)

abgeleitete Klassen

SWindow→

SControl→

SControlPositioned→

SControlPredefined→

SComboBox

Attribute

public:

Attribut	Typ	Beschreibung
orgWndProcComboBox	WNDPROC	Standard-Behandlungsroutine des Controls

protected:

Attribut	Typ	Beschreibung
pLabel	SLabel*	Zeiger auf das Label der ComboBox.

Operationen

public:

Name	Parameter	Rückgabewert	Beschreibung
addLabel	const SString& text, int xOffset=0, int yOffset=-20	void	Fügt ein Label hinzu.
addString	const SString& text, int itemData=0	int	Fügt einen Text der ComboBox hinzu.
deleteString	int index	BOOL	Löscht einen Eintrag aus der ComboBox.
findString	const SString& searchText, BOOL matchExact=false, int startItem=0	int	Sucht eine String in der Combobox.
getCurSel		int	Gibt den aktuell selektierten Eintrag zurück, sofern einer selektiert ist.
getItemData	int index	int	Gibt den Wert zurück, der einem Item zugeordnet wurde.
getItemText	int index	SString	Gibt den Text der ComboBox zurück.
getSize		int	Ermittelt die Anzahl der Einträge in der ComboBox.
insertString	const SString& text, int insertAt, int itemData=0	int	Fügt der ComboBox einen Text an einer bestimmter Position hinzu.
removeAll		void	Entfernt alle Einträge aus der ComboBox.
selectString	const SString& searchText, int startIndex=0	BOOL	Sucht und wählt eine Eintrag aus.
setCurSel	int index	BOOL	Setzt den aktuell auszuwählenden Eintrag.
setDroppedWidth	int width	BOOL	Legt die Breite der aufklappbaren Liste fest.
setItemData	int index, int itemData	void	Ordnet einem Eintrag der ComboBox einen Wert zu.
styleNoEdit		void	Setzt den Style so, dass nur Elemente der Liste wählbar sind.
styleSort	BOOL sorted=true	void	Schaltet die automatische Sortierung ein oder aus.
winProcCtrlComboBox	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 SComboBox

Eine ComboBox ist eine Kombination aus Listbox(Ausfahlfeld) und Eingabefeld.

ComboBoxen werden in der Regel verwendet, um eine Auswahl aus mehreren Texten zu ermöglichen und trotzdem nur eine Zeile Patz zu beanspruchen. Zusätzlich kann die Auswahlliste dynamisch erweitert werden.
Achtung: Die Höhenangabe beim Anlegen der ComboBox bezieht sich auf die aufgeklappte Box.

Funktionsbeschreibungen

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, relatv zur Combobox
yOffset	Y-Position des Labels, relatv zur Combobox

addString(const SString& text, int itemData=0) int

Fügt einen Text der ComboBox hinzu.

Parameter:

text	anzufügender Text
itemData	ein beliebiger dem Eintrag zuzuordnender Wert

Rückgabe:

int	Index des neuen Eintrages

deleteString(int index) BOOL

Löscht einen Eintrag aus der ComboBox.

Parameter:

index

Index des Strings, der zu löschen ist

Rückgabe:

BOOL	true wenn erfolgreich

findString(const SString& searchText, BOOL matchExact=false, int startItem=0) int

Sucht eine String in der Combobox.

Parameter:

searchText	zu suchender Text
matchExact	wenn true muss der Eintrag exakt übereinstimmen, sonst nur von Beginn an gleich sein
startItem	Index des Items bei dem mit der Suche begonnen wird

Rückgabe:

int	Index des gefunden Eintrages, oder CB_ERR wenn nichts gefunden wurde

getCurSel() int

Gibt den aktuell selektierten Eintrag zurück, sofern einer selektiert ist.

Rückgabe:

int	Index des selektierten Eintrages oder CB_ERR wenn nichts selektiert ist

getItemData(int index) int

Gibt den Wert zurück, der einem Item zugeordnet wurde.

siehe: addString(...) und setItemData(...)

Parameter:

index

Index des Items, von dem der zugeordnete Wert gelesen werden soll

Rückgabe:

int	zugeordneter Wert, bei einem Fehler wird CB_ERR zurückgegeben

getItemText(int index) SString

Gibt den Text der ComboBox zurück.

Parameter:

index

Index des erwünschten Eintrages in der Listbox

Rückgabe:

SString

Text der in der ComboBox steht

getSize() int

Ermittelt die Anzahl der Einträge in der ComboBox.

Rückgabe:

int	Anzahl der Einträge in der ComboBox.

insertString(const SString& text, int insertAt, int itemData=0) int

Fügt der ComboBox einen Text an einer bestimmter Position hinzu.

Parameter:

text	hinzuzufügender Text
insertAt	Position an der der Text eingefügt wird
itemData	ein beliebiger dem Eintrag zuzuordnender Wert

Rückgabe:

int	Index des neuen Eintrages

onPostCreateCtrl() void

Wird nach dem Erstellen und vor dem ersten Anzeigen ausgelöst.

removeAll() void

Entfernt alle Einträge aus der ComboBox.

selectString(const SString& searchText, int startIndex=0) BOOL

Sucht und wählt eine Eintrag aus.

Der übergebene Text muss mit dem vorhandenen Eintrag von Beginn an übereinstimmen. Wenn ein passender Eintrag gefunden wurde, wird dieser in das Eingabefenster kopiert.

Parameter:

searchText	zu suchender Text
startIndex	Nullbasierender Index des Eintrages bei dem zu suchen begonnen wird. Wenn das Ende der Liste erreicht wurde, wird wieder am Anfang begonnen bis alle Elemente durchsucht wurden.

setCurSel(int index) BOOL

Setzt den aktuell auszuwählenden Eintrag.