QColorDialog Class

Dokumentation zu den Mitgliedsfunktionen

[explicit] QColorDialog::QColorDialog(QWidget *parent = nullptr)

Erstellt einen Farbdialog mit dem angegebenen „ parent “.

[explicit] QColorDialog::QColorDialog(const QColor &initial, QWidget *parent = nullptr)

Erzeugt einen Farbdialog mit dem angegebenen „ parent “ und der angegebenen Farbe „ initial “.

[virtual noexcept] QColorDialog::~QColorDialog()

Schließt den Farbdialog.

[override virtual protected] void QColorDialog::changeEvent(QEvent *e)

Umsetzt: ` QWidget::changeEvent(QEvent *event)`.

[signal] void QColorDialog::colorSelected(const QColor &color)

Dieses Signal wird ausgelöst, sobald der Benutzer auf „ OK “ geklickt hat, um eine Farbe auszuwählen. Die ausgewählte Farbe wird durch „ color “ angegeben.

Siehe auch „color“ und „ currentColorChanged()“.

[signal] void QColorDialog::currentColorChanged(const QColor &color)

Dieses Signal wird immer dann ausgelöst, wenn sich die aktuelle Farbe im Dialogfeld ändert. Die aktuelle Farbe wird durch „ color “ festgelegt.

Siehe auch „color“ und „ colorSelected()“.

[static] QColor QColorDialog::customColor(int index)

Gibt die benutzerdefinierte Farbe unter der angegebenen Adresse „ index “ als Wert vom Typ „ QColor “ zurück.

Siehe auch setCustomColor().

[static] int QColorDialog::customCount()

Gibt die Anzahl der von QColorDialog unterstützten benutzerdefinierten Farben zurück. Alle Farbdialoge verwenden dieselben benutzerdefinierten Farben.

[override virtual protected] void QColorDialog::done(int result)

Implementiert: ` QDialog::done(int r)`.

Schließt den Dialog und setzt dessen Ergebniscode auf „ result “. Wenn dieser Dialog mit „ exec()“ angezeigt wurde, bewirkt „done()“, dass die lokale Ereignisschleife beendet wird und „ exec()“ den Wert „ result “ zurückgibt.

Siehe auch „ QDialog::done()“.

[static] QColor QColorDialog::getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString &title = QString(), QColorDialog::ColorDialogOptions options = ColorDialogOptions())

Öffnet einen modalen Farbdialog mit dem angegebenen Fenster- title (oder „Farbe auswählen“, falls kein angegeben ist), lässt den Benutzer eine Farbe auswählen und gibt diese Farbe zurück. Die Farbe ist zunächst auf initial gesetzt. Der Dialog ist ein untergeordnetes Element von parent. Er gibt eine ungültige Farbe (siehe QColor::isValid()) zurück, wenn der Benutzer den Dialog abbricht.

Mit dem Argument „ options “ können Sie den Dialog anpassen.

void QColorDialog::open(QObject *receiver, const char *member)

Öffnet das Dialogfeld und verbindet dessen Signal „ colorSelected()“ mit dem Slot, der durch „ receiver “ und „ member “ angegeben wird.

Das Signal wird vom Slot getrennt, sobald das Dialogfeld geschlossen wird.

QColor QColorDialog::selectedColor() const

Gibt die Farbe zurück, die der Benutzer durch Klicken auf die Schaltfläche „ OK “ oder eine entsprechende Schaltfläche ausgewählt hat.

[static] void QColorDialog::setCustomColor(int index, QColor color)

Setzt die benutzerdefinierte Farbe unter „ index “ auf den Wert „ QColor “ color.

Siehe auch „ customColor()“.

void QColorDialog::setOption(QColorDialog::ColorDialogOption option, bool on = true)

Setzt die angegebene Eigenschaft „ option “ auf „enabled“, wenn „ on “ den Wert „true“ hat; andernfalls wird die angegebene Eigenschaft „ option “ zurückgesetzt.

Siehe auch „ options “ und „ testOption()“.

[static] void QColorDialog::setStandardColor(int index, QColor color)

Setzt die Standardfarbe unter „ index “ auf den Wert „ QColor “ color.

Siehe auch standardColor().

[override virtual] void QColorDialog::setVisible(bool visible)

Implementiert: ` QDialog::setVisible` (bool visible).

Ändert die Sichtbarkeit des Dialogfelds. Ist visible wahr, wird das Dialogfeld angezeigt; andernfalls wird es ausgeblendet.

[static] QColor QColorDialog::standardColor(int index)

Gibt die Standardfarbe an der angegebenen Koordinate ` index ` als Wert vom Typ ` QColor ` zurück.

Siehe auch setStandardColor().

bool QColorDialog::testOption(QColorDialog::ColorDialogOption option) const

Gibt „ true “ zurück, wenn die angegebene Funktion „ option “ aktiviert ist; andernfalls wird „false“ zurückgegeben.

Siehe auch „ options “ und „ setOption()“.