itom
Loading...
Searching...
No Matches
ColorDialog Class Reference

#include <colorDialog.h>

Inheritance diagram for ColorDialog:

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=QColorDialog::ColorDialogOption())
 
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< ColorDialogPrivated_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::ColorDialog ( QWidget * parent = 0)
explicit

Constructor By default, behaves like a QColorDialog

See also
QColorDialog()

Member Function Documentation

◆ addDefaultTab()

void ColorDialog::addDefaultTab ( QWidget * widget,
const QString & label,
const char * colorSignal = 0,
const char * nameSignal = 0 )
inlinestatic

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

◆ addTab()

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.

◆ getColor()

QColor ColorDialog::getColor ( const QColor & initial,
QWidget * parent,
const QString & title,
ColorDialogOptions options = QColorDialog::ColorDialogOption() )
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

◆ getColorName()

QString ColorDialog::getColorName ( )
static

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

See also
getColor

◆ indexOf()

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

◆ insertDefaultTab()

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

◆ insertTab()

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

◆ removeTab()

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.

◆ setColorName

void ColorDialog::setColorName ( const QString & name)
slot

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

◆ setDefaultTab()

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

◆ widget()

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: