ColorDialog Class Reference

#include <colorDialog.h>

List of all members.

Public Slots
void	setColor (const QColor &color)
	Slot-ify QColorDialog::setCurrentColor(QColor)
void	setColorName (const QString &name)
Signals
void	currentColorNameChanged (const QString &colorName)
Public Member Functions
	ColorDialog (QWidget *parent=0)
	ColorDialog (const QColor &initial, QWidget *parent=0)
void	addTab (QWidget *widget, const QString &label)
void	insertTab (int tabIndex, QWidget *widget, const QString &label)
void	removeTab (int index)
void	setCurrentTab (int index)
	Set the current tab index. 0 ("Basic" tab) by default.
QWidget *	widget (int index) const
int	indexOf (QWidget *widget) const
QString	colorName () const
	Return the current color name if any has been set.
Static Public Member Functions
static QColor	getColor (const QColor &initial, QWidget *parent, const QString &title, ColorDialogOptions options=0)
static QString	getColorName ()
static void	addDefaultTab (QWidget *widget, const QString &label, const char *colorSignal=0, const char *nameSignal=0)
static void	insertDefaultTab (int tabIndex, QWidget *widget, const QString &label, const char *colorSignal=0, const char *nameSignal=0)
static void	setDefaultTab (int index)
Protected Slots
void	resetColorName ()
Protected Attributes
QScopedPointer < ColorDialogPrivate >	d_ptr
Static Protected Attributes
static QList< QWidget * >	DefaultTabs
static int	DefaultTab = -1
static QString	LastColorName = QString()
Private Member Functions
	Q_DECLARE_PRIVATE (ColorDialog)
	Q_DISABLE_COPY (ColorDialog)

---

Detailed Description

Customizable QColorDialog. Extra widgets can be added to the left of the dialog into a QStackedWidget

---

Constructor & Destructor Documentation

ColorDialog::ColorDialog

(

QWidget *

parent = 0

)

[explicit]

Constructor By default, behaves like a QColorDialog

See also:

QColorDialog()

---

Member Function Documentation

void ColorDialog::addDefaultTab	(	QWidget *	widget,
		const QString &	label,
		const char *	colorSignal = 0,
		const char *	nameSignal = 0
	)		[inline, static]

Add a custom widget as an additional tab of the color dialog created by ColorDialog::getColor. label is title of the tab and signal is the signal fired by the widget whenever a QColor is changed, typically: SIGNAL(currentColorChanged(QColor)). It is internally connected to set the current color of the dialog

void ColorDialog::addTab	(	QWidget *	widget,
		const QString &	label
	)		[inline]

Add an extra widget under the file format combobox. If a label is given, it will appear in the first column. The widget is reparented to ColorDialog The ownership of the widget is taken. You must manually connect the color changed signal of the widget to ColorDialog::setColor(QColor) Same apply if you want to specify a color name, you must connect the color name changed signal to ColorDialog::setColorName(QString) but you have to make sure the color name is set after setColor as it always resets the color name.

QColor ColorDialog::getColor	(	const QColor &	initial,
		QWidget *	parent,
		const QString &	title,
		ColorDialogOptions	options = 0
	)		[static]

Pops up a modal color dialog with the given window title (or "Select Color" if none is specified), lets the user choose a color, and returns that color. The color is initially set to initial. The dialog is a child of parent. It returns an invalid (see QColor::isValid()) color if the user cancels the dialog.

The options argument allows you to customize the dialog; QColorDialog::DontUseNativeDialog is forced

QString ColorDialog::getColorName

(

)

[static]

Return the last selected color name if any. getColorName() call is only valid after a getColor() call.

See also:

getColor

int ColorDialog::indexOf

(

QWidget *

widget

)

const

Returns the index position of the page occupied by the widget w, or -1 if the widget cannot be found

void ColorDialog::insertDefaultTab	(	int	tabIndex,
		QWidget *	widget,
		const QString &	label,
		const char *	colorSignal = 0,
		const char *	nameSignal = 0
	)		[static]

Same as addDefaultTab, in addition, tabIndex control the tab index of the widget. If index is -1, the tab is appended (same as addDefaultTab). The last tab added with an index of 0 will be the first tab open

void ColorDialog::insertTab	(	int	tabIndex,
		QWidget *	widget,
		const QString &	label
	)

Same as addTab(), in addition, tabIndex control the tab index of the widget. If index is -1, the tab is appended (same as addDefaultTab). The last tab added with an index of 0 will be the first tab open

void ColorDialog::removeTab

(

int

index

)

The ownership of widget remains the same. The widget is not deleted, but simply removed from the widget's stacked layout, causing it to be hidden.

void ColorDialog::setColorName

(

const QString &

name

)

[slot]

Set the color name. Note that each time the color is changed the name is reset.

void ColorDialog::setDefaultTab

(

int

index

)

[static]

Index of the tab to make default (active when getColor is called). -1 for the "Basic Colors", it's the default behavior

QWidget * ColorDialog::widget

(

int

index

)

const

Return the extra widget if any Be careful with the "Basic" tab.

---

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

• K:/git-itom/sources/itom/itomWidgets/colorDialog.h
• K:/git-itom/sources/itom/itomWidgets/colorDialog.cpp