BALL::VIEW::Preferences Class Reference
[QT Dialogs]

#include <BALL/VIEW/DIALOGS/preferences.h>

Inheritance diagram for BALL::VIEW::Preferences:

[legend]

List of all members.

Public Member Functions
Constructors
	Preferences (QWidget *parent=NULL, const char *name="Preferences")
	Preferences (const Preferences &preferences)
	Copy constructur.
virtual	~Preferences ()
	Destructor.
Public slots
HashSet< PreferencesEntry * >	entries_
HashMap< QTreeWidgetItem *, QWidget * >	item_to_widget_
HashMap< QTreeWidgetItem *, PreferencesEntry * >	item_to_entry_
HashMap< QWidget *, QTreeWidgetItem * >	widget_to_item_
void	show ()
void	showEntry (QWidget *page)
	Show the given page.
void	entrySelected ()
void	setDefaultValues ()
void	reject ()
void	applyPreferences ()
	Store the last applied values for undo.
void	showHelp ()
void	dialogButtonsClicked_ (QAbstractButton *button)
void	removeItem_ (QTreeWidgetItem *item, bool update)
Accessors
bool	hasPages ()
void	insertEntry (PreferencesEntry *child)
void	removeEntry (PreferencesEntry *child)
void	fetchPreferences (INIFile &inifile)
void	writePreferences (INIFile &inifile)
const QWidget *	currentEntry () const
const QWidget *	currentPage () const
void	setApplyEnabled (bool enabled)
	Activate or deactivate the apply and ok buttons.
void	applied ()

---

Detailed Description

Preferences is a dialog for other preference pages to be inserted. An interface for adding and removing the pages is available. The Preferences dialog will be created by the MainControl. All ModularWidget classes can add their own preferences pages.

Definition at line 40 of file preferences.h.

---

Constructor & Destructor Documentation

BALL::VIEW::Preferences::Preferences	(	QWidget *	parent = NULL,
		const char *	name = "Preferences"
	)

Default Constructor. There are five buttons:

• ok - apply the preferences
• apply - apply the preferences, but do no close the window
• cancel - hide the preferences dialog
• defaults - reset the values of the currently selected page
• help - get help

  Parameters:

  	parent	the parent QWidget (See QTabDialog in the QT documentation)
  	name	(See QDialog in the QT documentation)

BALL::VIEW::Preferences::Preferences

(

const Preferences &

preferences

)

Copy constructur.

virtual BALL::VIEW::Preferences::~Preferences

(

)

[virtual]

Destructor.

---

Member Function Documentation

void BALL::VIEW::Preferences::applied

(

)

[signal]

void BALL::VIEW::Preferences::applyPreferences

(

)

[slot]

Store the last applied values for undo.

const QWidget* BALL::VIEW::Preferences::currentEntry

(

)

const

const QWidget* BALL::VIEW::Preferences::currentPage

(

)

const

void BALL::VIEW::Preferences::dialogButtonsClicked_

(

QAbstractButton *

button

)

[protected, slot]

void BALL::VIEW::Preferences::entrySelected

(

)

[slot]

void BALL::VIEW::Preferences::fetchPreferences

(

INIFile &

inifile

)

Fetch the preferences (the position) from the INIFile inifile. This method will be called inside MainControl::show().

Parameters:

inifile

the INIFile that contains the needed information

See also:

writePreferences

bool BALL::VIEW::Preferences::hasPages

(

)

Check if pages are available.

Returns:

bool true if pages are available

void BALL::VIEW::Preferences::insertEntry

(

PreferencesEntry *

child

)

Insert a new page. This method can be called inside ModularWidget::initializePreferencesTab

Parameters:

	child	a pointer to the new dialog
	name	the name of the new dialog

See also:

removePage

void BALL::VIEW::Preferences::reject

(

)

[slot]

void BALL::VIEW::Preferences::removeEntry

(

PreferencesEntry *

child

)

Remove a previously inserted page. This method can be called inside ModularWidget::finalizePreferencesTab

Parameters:

child

a pointer to the dialog to be removed

See also:

insertPage

void BALL::VIEW::Preferences::removeItem_	(	QTreeWidgetItem *	item,
		bool	update
	)			[protected]

void BALL::VIEW::Preferences::setApplyEnabled

(

bool

enabled

)

Activate or deactivate the apply and ok buttons.

void BALL::VIEW::Preferences::setDefaultValues

(

)

[slot]

void BALL::VIEW::Preferences::show

(

)

[slot]

Open the preferences dialog.

void BALL::VIEW::Preferences::showEntry

(

QWidget *

page

)

[slot]

Show the given page.

void BALL::VIEW::Preferences::showHelp

(

)

[slot]

void BALL::VIEW::Preferences::writePreferences

(

INIFile &

inifile

)

Write the preferences (the position) to the INIFile inifile. This method will be called in MainControl::aboutToExit.

Parameters:

inifile

the INIFile to be written into

See also:

fetchPreferences

---

Member Data Documentation

HashSet<PreferencesEntry*> BALL::VIEW::Preferences::entries_ [protected]

Definition at line 157 of file preferences.h.

HashMap<QTreeWidgetItem*, PreferencesEntry*> BALL::VIEW::Preferences::item_to_entry_ [protected]

Definition at line 159 of file preferences.h.

HashMap<QTreeWidgetItem*, QWidget*> BALL::VIEW::Preferences::item_to_widget_ [protected]

Definition at line 158 of file preferences.h.

HashMap<QWidget*, QTreeWidgetItem*> BALL::VIEW::Preferences::widget_to_item_ [protected]

Definition at line 160 of file preferences.h.