Dialog box that can be used to set-up the background data. More...

#include <QtxBackgroundTool.h>

Inheritance diagram for QtxBackgroundDialog:

Public Member Functions
	QtxBackgroundDialog (QWidget *=0)
	Constructor. More...

	QtxBackgroundDialog (const Qtx::BackgroundData &, QWidget *=0)
	Constructor. More...

virtual	~QtxBackgroundDialog ()
	Destructor. More...

void	setData (const Qtx::BackgroundData &)
	Set background data. More...

Qtx::BackgroundData	data () const
	Get background data. More...

void	setGradients (const QStringList &, const QIntList &=QIntList())
	Set allowed two-color gradients to the widget. More...

void	setModeAllowed (Qtx::BackgroundMode, bool=true)
	Enable / disable specific background mode. More...

void	setTextureAllowed (bool=true)
	Enable / disable texture controls. More...

void	setTextureModeAllowed (Qtx::TextureMode, bool=true)
	Enable / disable specific texture mode. More...

void	setImageFormats (const QString &)
	Set allowed image formats. More...

Public Member Functions inherited from QtxDialog
	QtxDialog (QWidget *=0, bool=false, bool=false, const int=Standard, Qt::WindowFlags=0)
	Constructor. More...

virtual	~QtxDialog ()
	Destructor. More...

void	setDialogFlags (const int)
	Set specified dialog box flags. More...

void	clearDialogFlags (const int)
	Clear specified the dialog flags. More...

bool	testDialogFlags (const int) const
	Test specified dialog flags. More...

void	setButtonFlags (const int)
	Add specified control button(s) to the dialog box. More...

void	clearButtonFlags (const int)
	Remove specified control button(s) from the dialog box. More...

bool	testButtonFlags (const int) const
	Test specified buttons. More...

int	buttonPosition (const int) const
	Get specified control button position. More...

void	setButtonPosition (const int, const int=-1)
	Set the specified control button(s) position. More...

void	setPlacePosition (const int, const int)
	Set button position for all buttons in specified area. More...

int	placePolicy (const int) const
	Get buttons layouting policy for the specified area. More...

void	setPlacePolicy (const int, const int)
	set buttons layouting policy for the specified area. More...

void	setButtonPlace (const int, const int)
	Move specified button(s) into specified area. More...

QString	buttonText (const int)
	Get specified button's text. More...

void	setButtonText (const int, const QString &text)
	Set specified button's text. More...

void	setButtonFocus (const int)
	Sets the keyboard focus to the specified button. More...

bool	hasButtonFocus (const int) const
	Check if specified button has keyboard focus. More...

bool	isButtonEnabled (const int) const
	Get "enabled" status of the specified button(s). More...

void	setButtonEnabled (const bool, const int)
	Enable/disable specified button(s). More...

bool	isBorderEnabled (const int) const
	Check if border is enabled. More...

void	setBorderEnabled (const bool, const int)
	Show/hide border for the specified button area. More...

void	removeButton (const int)
	Remove user button. More...

int	insertButton (const QString &, const int=BottomArea)
	Add user button to the dialog box. More...

QIntList	userButtonIds () const
	Get all user button IDs. More...

QAbstractButton *	userButton (const int) const
	Get user button by the specified id. More...

uint	setAlignment (uint align)
	Sets alignment policy. More...

Static Public Member Functions
static Qtx::BackgroundData	getBackground (const Qtx::BackgroundData &=Qtx::BackgroundData(), QWidget *=0, bool=true, bool=true, bool=true, bool=true, const QStringList &=QStringList(), const QIntList &=QIntList(), const QString &=QString())
	This is a convenience static function that returns an background data selected by the user. If the user presses Cancel, it returns an invalid background data. More...

static Qtx::BackgroundData	getBackground (const Qtx::BackgroundData &, QWidget *, const QIntList &, bool=true, bool=true, bool=true, bool=true, const QStringList &=QStringList(), const QIntList &=QIntList(), const QString &=QString())
	This is a convenience static function that returns an background data selected by the user. If the user presses Cancel, it returns an invalid background data. More...

Static Public Member Functions inherited from QtxDialog
static void	setUnits (QLabel *, const QString &)
	Set measure units to the specified label. More...

Private Member Functions
void	init ()
	Perform internal initialization. More...

Private Attributes
QtxBackgroundTool *	myTool

Additional Inherited Members
Public Types inherited from QtxDialog
enum	PlacePolicy { Position, Expand, Uniform }
	Buttons alignment type. More...

enum	ButtonArea { TopArea, BottomArea, LeftArea, RightArea }
	Buttons area. More...

enum	ButtonPosition { Left, Right, Center, Top = Left, Bottom = Right }
	Button position. More...

enum	ButtonFlags { None = 0x00000000, OK = 0x00000001, Apply = 0x00000002, Cancel = 0x00000004, Yes = 0x00000008, No = 0x00000010, Close = 0x00000020, Help = 0x00000040, OKCancel = OK \| Cancel, YesNo = Yes \| No, Standard = OK \| Cancel \| Help, All = Standard \| YesNo \| Apply \| Close }
	Button ID flags. More...

enum	DialogFlags { Accept = 0x000001, Reject = 0x000002, AlignOnce = 0x000004, SetFocus = 0x000008 }
	Dialog box flags. More...

Public Slots inherited from QtxDialog
void	update ()
	Update dialog box. More...

virtual void	setVisible (bool)
	Show/hide dialog box, set keyboard focus to the dialog. More...

Signals inherited from QtxDialog
void	dlgButton (int)
	Emitted when the user button is clicked. More...

void	dlgParamChanged ()
	This signal can be used in successor classes to signalize about some dialog parameter changing. More...

void	dlgHelp ()
	Emitted when the "Help" button is clicked. More...

void	dlgApply ()
	Emitted when the "Apply" button is clicked. More...

void	dlgOk ()
	Emitted when the "OK" button is clicked. More...

void	dlgNo ()
	Emitted when the "No" button is clicked. More...

void	dlgYes ()
	Emitted when the "Yes" button is clicked. More...

void	dlgClose ()
	Emitted when the "Close" button is clicked. More...

void	dlgCancel ()
	Emitted when the "Cancel" button is clicked. More...

Protected Types inherited from QtxDialog
typedef QMap< int, QAbstractButton * >	ButtonMap
	button map More...

Protected Slots inherited from QtxDialog
virtual void	accept ()
	Accept the dialog box. More...

virtual void	reject ()
	Reject the dialog box. More...

Protected Member Functions inherited from QtxDialog
QFrame *	mainFrame () const
	Get dialog box main frame widget. More...

virtual bool	acceptData () const
	Check if data entered by the user is valid. More...

virtual bool	rejectData () const
	Check if dialog box can be cancelled. More...

virtual QAbstractButton *	createButton (QWidget *)
	Create new user button. More...

QAbstractButton *	button (const int) const
	Get button by the specified ID. More...

ButtonMap	buttons (const int=All) const
	Get buttons by the specified IDs. More...

int	buttonId (const QAbstractButton *) const
	Get specified button's identifier. More...

int	buttonPosition (QAbstractButton *) const
	Get position of specified button. More...

virtual void	showEvent (QShowEvent *)
	Align this dialog according to the parent widget and alignment policy before the dialog box is shown. More...

virtual void	hideEvent (QHideEvent *)
	Process all existing events when dialog box is hidden. More...

virtual void	closeEvent (QCloseEvent *)
	Called when user closes dialog box. More...

virtual void	childEvent (QChildEvent *)
	Update dialog box layout when the size grip is added. More...

virtual void	keyPressEvent (QKeyEvent *)
	Process key pressing event. More...

Detailed Description

Usage example:

// create dialog box
QtxBackgroundDialog dlg( this );
// assign gradients types
QStringList sl;
sl << "Horizontal" << "Vertical" << "First diagonal" << "Second diagonal";
dlg.setGradients(sl);
// disable image texture and custom gradient modes
dlg.setModeAllowed(Qtx::ImageBackground, false);
dlg.setModeAllowed(Qtx::CustomGradientBackground, false);
// initialize dialog box with the some background data
dlg.setData(backgroundData);
// execute dialog box and obtain result background data
if ( dlg.exec() ) {
  Qtx::BackgroundData bgData = dlg.getBackgroundData();
}

Also it is possible to use static function:

Qtx::BackgroundData bgData = QtxBackgroundDialog::getBackground( this );
if ( bgData.isValid() ) 
  doSomething( bgData );

Constructor & Destructor Documentation

QtxBackgroundDialog::QtxBackgroundDialog ( QWidget * parent = 0 )

Parameters

parent parent widget

References init().

QtxBackgroundDialog::QtxBackgroundDialog	(	const Qtx::BackgroundData &	bgData,
		QWidget *	parent = `0`
	)

Parameters

bgData	initial background data
parent	parent widget

References init(), and setData().

QtxBackgroundDialog::~QtxBackgroundDialog ( )

virtual

Member Function Documentation

Qtx::BackgroundData QtxBackgroundDialog::data ( ) const

Returns: background data

References QtxBackgroundTool::data(), and myTool.

Qtx::BackgroundData QtxBackgroundDialog::getBackground	(	const Qtx::BackgroundData &	bgData = `Qtx::BackgroundData()`,
		QWidget *	parent = `0`,
		bool	enableSolidColor = `true`,
		bool	enableGradient = `true`,
		bool	enableCustom = `true`,
		bool	enableTexture = `true`,
		const QStringList &	gradList = `QStringList()`,
		const QIntList &	idList = `QIntList()`,
		const QString &	formats = `QString()`
	)

static

By default:

all background modes are enabled
texture controls are shown
all texture modes are enabled
simple gradient types list is empty
all image formats are supported

To customize the dialog box behavior, initialize it passing the corresponding options to the function.

Parameters

bgData	initial background data
parent	parent widget
enableSolidColor	"enable solid colored background mode" flag
enableGradient	"enable simple gradient background mode" flag
enableCustom	"enable custom gradient background mode" flag
enableTexture	"show texture controls" flag
gradList	list of simple gradients names
idList	list of simple gradients identifiers
formats	image formats

Returns: resulting background data chosen by the user or invalid data if users cancels operation

References Qtx::ColorBackground, Qtx::CustomGradientBackground, data(), setData(), setGradients(), setImageFormats(), setModeAllowed(), setTextureAllowed(), and Qtx::SimpleGradientBackground.

Qtx::BackgroundData QtxBackgroundDialog::getBackground	(	const Qtx::BackgroundData &	bgData,
		QWidget *	parent,
		const QIntList &	tmList,
		bool	enableSolidColor = `true`,
		bool	enableGradient = `true`,
		bool	enableCustom = `true`,
		bool	enableTexture = `true`,
		const QStringList &	gradList = `QStringList()`,
		const QIntList &	idList = `QIntList()`,
		const QString &	formats = `QString()`
	)

static

By default:

all background modes are enabled
texture controls are shown
all texture modes are disabled
simple gradient types list is empty
all image formats are supported

To customize the dialog box behavior, initialize it passing the corresponding options to the function.

Parameters

bgData	initial background data
parent	parent widget
tmList	allowed texture modes
enableSolidColor	"enable solid colored background mode" flag
enableGradient	"enable simple gradient background mode" flag
enableCustom	"enable custom gradient background mode" flag
enableTexture	"show texture controls" flag
gradList	list of simple gradients names
idList	list of simple gradients identifiers
formats	image formats

Returns: resulting background data chosen by the user or invalid data if users cancels operation

References Qtx::CenterTexture, Qtx::ColorBackground, Qtx::CustomGradientBackground, data(), setData(), setGradients(), setImageFormats(), setModeAllowed(), setTextureAllowed(), setTextureModeAllowed(), Qtx::SimpleGradientBackground, and Qtx::StretchTexture.

void QtxBackgroundDialog::init ( )

private

References QtxDialog::button(), QtxDialog::Cancel, main(), QtxDialog::mainFrame(), myTool, QtxDialog::OK, QtxDialog::Right, QtxDialog::setButtonPosition(), QtxDialog::setDialogFlags(), QtxDialog::SetFocus, and Vertical.

void QtxBackgroundDialog::setData ( const Qtx::BackgroundData & bgData )

Parameters

bgData background data

References myTool, and QtxBackgroundTool::setData().

void QtxBackgroundDialog::setGradients	(	const QStringList &	gradList,
		const QIntList &	idList = `QIntList()`
	)

Parameters

gradients	gradients names
ids	optional gradients identifiers; if not specified, gradients are automatically numbered starting from 0

References myTool, and QtxBackgroundTool::setGradients().

void QtxBackgroundDialog::setImageFormats ( const QString & formats )

Parameters

formats image formats

References myTool, and QtxBackgroundTool::setImageFormats().

void QtxBackgroundDialog::setModeAllowed	(	Qtx::BackgroundMode	mode,
		bool	on = `true`
	)

Parameters

mode	background mode
on	enable / disable flag

References myTool, and QtxBackgroundTool::setModeAllowed().

void QtxBackgroundDialog::setTextureAllowed ( bool on = true )

Parameters

on	enable / disable flag

See Also: setTextureModeAllowed()

References myTool, and QtxBackgroundTool::setTextureAllowed().

void QtxBackgroundDialog::setTextureModeAllowed	(	Qtx::TextureMode	mode,
		bool	on = `true`
	)

Parameters

mode	texture mode
on	enable / disable flag (`true` by default)

See Also: setTextureAllowed()

References myTool, and QtxBackgroundTool::setTextureModeAllowed().

Member Data Documentation

QtxBackgroundTool* QtxBackgroundDialog::myTool

private

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

src/Qtx/QtxBackgroundTool.h
src/Qtx/QtxBackgroundTool.cxx

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation