hk_dscombobox Class Reference

base class for combobox fields More...

#include <hk_dscombobox.h>

Inheritance diagram for hk_dscombobox:

[legend]Collaboration diagram for hk_dscombobox:

[legend]List of all members.

Public Types
enum	enum_mode {   combo, combo_noedit, selector, designmode,   viewmode, filtermode }
Public Member Functions
	hk_dscombobox (hk_form *form=NULL)
void	set_listdatasource (hk_datasource *list)
hk_datasource *	listdatasource (void)
virtual void	set_datasource (hk_datasource *d)
void	set_viewcolumnname (const hk_string &viewcolumn, bool registerchange=true)
hk_string	viewcolumnname (void)
void	set_listcolumnname (const hk_string &listcolumn, bool registerchange=true)
hk_string	listcolumnname (void)
virtual void	savedata (ostream &s)
virtual void	loaddata (xmlNodePtr definition)
virtual bool	set_listpresentationdatasource (long n, bool registerchange=true)
long	listpresentationdatasource (void)
virtual void	load_listitems (void)
void	set_mode (enum_mode)
enum_mode	mode (void)
hk_string	value_at (unsigned long)
hk_column *	viewcolumn (void)
hk_column *	listcolumn (void)
void	set_gridcolumn (hk_dsgridcolumn *)
hk_dsgridcolumn *	gridcolumn (void) const
void	set_use_textlist (bool, bool registerchange=true)
bool	use_textlist (void) const
void	set_textlist (list< hk_string > &, bool registerchange=true)
void	add_text (const hk_string &, bool registerchange=true)
list< hk_string > *	textlist (void) const
virtual bool	action_on_select (void)
hk_string	on_select_action (void)
void	set_on_select_action (const hk_string &, bool registerchange=true, bool force_setting=true)
Protected Member Functions
bool	datasource_enable (void)
bool	datasource_disable (void)
virtual bool	widget_specific_row_change (void)
virtual void	widget_specific_mode_change (void)
virtual void	after_store_changed_data (void)
virtual void	columndata_has_changed (void)
virtual bool	presentationmode_changed (void)
Protected Attributes
hk_dsgridcolumn *	p_gridcolumn

---

Detailed Description

base class for combobox fields

Version:

Revision

1.23

Author:

Horst Knorr (hk_classes@knoda.org)

base class for combobox fields Just set the datasource and the column (defined in the parent class hk_dsdatavisible). To fill the listbox with values set the datasource which contains the wished values with set_listdatasource. The columnname of the row which should be displayed in the listbox must be set with set_viewcolumn. The row which contains the data to be written has to be specified with set_listcolumn.

---

Member Enumeration Documentation

enum hk_dscombobox::enum_mode

if the comboboxmode is set to combo it reacts like a normal datasource. If set to 'selector' the datasource will be moved to the selected row in the datasource. You then just have to add the listcolumnname

---

Member Function Documentation

void hk_dscombobox::set_listdatasource

(

hk_datasource *

list

)

comboboxes need 2 datasources. One (the normal) datasource is set with set_datasource and stores the values in a field. The second datasource contains a list of possible values for this field.

Parameters:

list

the datasource which contains the values displayed in the combobox

void hk_dscombobox::set_datasource

(

hk_datasource *

d

)

[virtual]

the datasource

Reimplemented from hk_dsdatavisible.

void hk_dscombobox::set_viewcolumnname	(	const hk_string &	viewcolumn,
		bool	registerchange = true
	)

The column of the listdatasource which will be displayed in the combobox

void hk_dscombobox::set_listcolumnname	(	const hk_string &	listcolumn,
		bool	registerchange = true
	)

The column containing the equivalent key to the column set with set_column

void hk_dscombobox::savedata

(

ostream &

s

)

[virtual]

stores the object's values to stream s. Especially used to store queries, forms and reports

Reimplemented from hk_dsdatavisible.

void hk_dscombobox::loaddata

(

xmlNodePtr

definition

)

[virtual]

loads the object's values out of the definition string. Especially used to load queries, forms and reports

Reimplemented from hk_dsdatavisible.

bool hk_dscombobox::set_listpresentationdatasource	(	long	n,
		bool	registerchange = true
	)			[virtual]

if this combobox is part of a hk_presentation object (i.e. a form) you can set the listdatasource by its unique presentation number

hk_string hk_dscombobox::value_at

(

unsigned

long

)

[virtual]

returns the formatted value of the row 'row'

Reimplemented from hk_dsdatavisible.

bool hk_dscombobox::datasource_enable

(

void

)

[protected, virtual]

FOR WIDGET DEVELOPERS ONLY: will be automatically called when the datasources is enabling

Reimplemented from hk_dsdatavisible.

bool hk_dscombobox::datasource_disable

(

void

)

[protected, virtual]

FOR WIDGET DEVELOPERS ONLY: will be automatically called when the datasources is disabling

Reimplemented from hk_dsdatavisible.

bool hk_dscombobox::widget_specific_row_change

(

void

)

[protected, virtual]

FOR WIDGET DEVELOPERS ONLY: will be automatically called when the datasource has changed the row. Has to be rewritten for a new widget

See also:

before_row_change.

Reimplemented from hk_dsvisible.

---

The documentation for this class was generated from the following files:

• hk_dscombobox.h
• hk_dscombobox.cpp

---