Класс QPalette

Класс QPalette содержит группы цветов для каждого состояния виджета. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Общедоступные типы

Открытые функции

Связанные внешние члены

Подробное описание

Палитра состоит из трех цветовых групп: Активная, Отключенная и Неактивная. Все виджеты в Qt содержат палитру и используют её для собственного отображения. Это делает пользовательский интерфейс легко настраиваемым и более удобным для поддержания согласованности.

Если вы создаете новый виджет, мы настоятельно рекомендуем использовать цвета из палитры, а не жестко задавать конкретные цвета.

Цветовые группы:

• Активная группа используется для окна, имеющего фокус клавиатуры.
• Неактивная группа используется для других окон.
• Отключенная группа используется для виджетов (не окон), которые по какой-либо причине отключены.

Как активные, так и неактивные окна могут содержать отключенные виджеты. (Отключенные виджеты часто называются недоступными или затененными.)

В большинстве стилей Active и Inactive выглядят одинаково.

Цвета и кисти могут быть установлены для конкретных ролей в любой из цветовых групп палитры с помощью setColor() и setBrush(). Цветовая группа содержит набор цветов, используемых виджетами для собственного рисования. Мы рекомендуем виджетам использовать роли цветовых групп из палитры, такие как "foreground" и "base", а не литеральные цвета, такие как "red" или "turquoise". Роли цветов перечисляются и определены в документации ColorRole.

Мы настоятельно рекомендуем использовать палитру по умолчанию текущего стиля (возвращаемую функцией QGuiApplication::palette()) и изменять её по мере необходимости. Это делается виджетами Qt при их рисовании.

Чтобы изменить цветовую группу, вы вызываете функции setColor() и setBrush(), в зависимости от того, хотите ли вы чистый цвет или узор из растрового изображения.

Существуют также соответствующие функции-получатели color() и brush(), и часто используемая вспомогательная функция для получения ColorRole для текущей ColorGroup: window(), windowText(), base() и т.д.

Вы можете скопировать палитру, используя конструктор копирования, и проверить, являются ли две палитры идентичными, используя isCopyOf().

QPalette оптимизирована за счет использования implicit sharing, поэтому передача объектов QPalette в качестве аргументов очень эффективна.

Предупреждение: Некоторые стили не используют палитру для всего рисования, например, если они используют собственные механизмы тем. Это относится как к стилям Windows Vista, так и к стилям macOS.

См. также QApplication::setPalette(), QWidget::setPalette() и QColor.

Документация по типам элементов

enum QPalette::ColorGroup

enum QPalette::ColorRole

Перечисление ColorRole определяет различные символические цветовые роли, используемые в современных графических интерфейсах.

Основные роли:

Существуют некоторые цветовые роли, используемые в основном для эффектов 3D-скоса и тени. Все они обычно выводятся из Window, и используются способами, которые зависят от этой связи. Например, кнопки зависят от него, чтобы сделать скосы привлекательными, а полосы прокрутки Motif зависят от того, что Mid немного отличается от Window.

Выбранные (отмеченные) элементы имеют две роли:

Есть две цветовые роли, связанные с гиперссылками:

Обратите внимание, что мы не используем роли Link и LinkVisited при отображении форматированного текста в Qt, и рекомендуем использовать CSS и функцию QTextDocument::setDefaultStyleSheet() для изменения внешнего вида ссылок. Например:

    QTextBrowser browser;
    QColor linkColor(Qt::red);
    QString sheet = QString::fromLatin1("a { text-decoration: underline; color: %1 }").arg(linkColor.name());
    browser.document()->setDefaultStyleSheet(sheet);

Документация функций-членов

[since 5.4] QPalette::QPalette(QPalette &&other)

Создает экземпляр QPalette, сделав его указывающим на тот же объект, на который указывал other.

После перемещения вы можете только присваивать или уничтожать other. Любые другие операции приведут к неопределённому поведению.

Эта функция была добавлена в Qt 5.4.

QPalette::QPalette(const QPalette &p)

Создает копию p.

Этот конструктор быстрый благодаря неявной совместной памяти.

QPalette::QPalette(const QBrush &windowText, const QBrush &button, const QBrush &light, const QBrush &dark, const QBrush &mid, const QBrush &text, const QBrush &bright_text, const QBrush &base, const QBrush &window)

Создает палитру. Вы можете передать кисти, растровые изображения или простые цвета для windowText, button, light, dark, mid, text, bright_text, base и window.

См. также QBrush.

QPalette::QPalette(const QColor &button, const QColor &window)

Создает палитру из цвета button и window. Другие цвета автоматически рассчитываются на основе этих цветов.

QPalette::QPalette(Qt::GlobalColor button)

Создает палитру из цвета button. Другие цвета автоматически рассчитываются на основе этого цвета. Window также будет цветом кнопки.

QPalette::QPalette(const QColor &button)

Создает палитру из цвета button. Другие цвета автоматически рассчитываются на основе этого цвета. Window также будет цветом кнопки.

QPalette::QPalette()

Создает пустой объект палитры без установленных цветовых ролей.

При использовании в качестве палитры QWidget цвета разрешаются, как описано в QWidget::setPalette().

См. также QApplication::setPalette() и QApplication::palette().

[since 5.2] QPalette &QPalette::operator=(QPalette &&other)

Перемещает присвоение other данному экземпляру QPalette.

Эта функция была добавлена в Qt 5.2.

QPalette &QPalette::operator=(const QPalette &p)

Присваивает p данной палитре и возвращает ссылку на эту палитру.

Эта операция быстрая благодаря неявной совместной памяти.

QPalette::~QPalette()

Уничтожает палитру.

const QBrush &QPalette::alternateBase() const

Возвращает альтернативную кисть фона текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::base() const

Возвращает кисть фона текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::brightText() const

Возвращает кисть яркого текста текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::brush(QPalette::ColorGroup group, QPalette::ColorRole role) const

Возвращает кисть в указанной цветовой группе, используемую для заданной цветовой роли.

См. также color(), setBrush() и ColorRole.

const QBrush &QPalette::brush(QPalette::ColorRole role) const

Это перегруженная функция.

Возвращает кисть, установленную для заданной цветовой роли в текущей ColorGroup.

См. также color(), setBrush() и ColorRole.

const QBrush &QPalette::button() const

Возвращает кисть кнопки текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::buttonText() const

Возвращает кисть текста кнопки текущей цветовой группы.

См. также ColorRole и brush().

qint64 QPalette::cacheKey() const

Возвращает число, идентифицирующее содержимое этого объекта QPalette. Разные объекты QPalette могут иметь одинаковый ключ, если они ссылаются на одинаковое содержимое.

cacheKey() изменится при изменении палитры.

const QColor &QPalette::color(QPalette::ColorGroup group, QPalette::ColorRole role) const

Возвращает цвет в указанной цветовой группе, используемый для заданной цветовой роли.

См. также brush(), setColor() и ColorRole.

const QColor &QPalette::color(QPalette::ColorRole role) const

Это перегруженная функция.

Возвращает цвет, установленный для заданной цветовой роли в текущей ColorGroup.

См. также brush() и ColorRole.

QPalette::ColorGroup QPalette::currentColorGroup() const

Возвращает текущую цветовую группу палитры.

См. также setCurrentColorGroup().

const QBrush &QPalette::dark() const

Возвращает тёмную кисть текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::highlight() const

Возвращает кисть выделения текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::highlightedText() const

Возвращает кисть выделенного текста текущей цветовой группы.

См. также ColorRole и brush().

bool QPalette::isBrushSet(QPalette::ColorGroup cg, QPalette::ColorRole cr) const

Возвращает true если ColorGroup cg и ColorRole cr были ранее установлены в этой палитре; в противном случае возвращает false.

ColorGroup cg должен быть меньше QPalette::NColorGroups, но вы можете использовать QPalette::Current. В этом случае будет использоваться ранее установленная текущая цветовая группа.

ColorRole cr должен быть меньше QPalette::NColorRoles.

См. также setBrush() и currentColorGroup().

bool QPalette::isCopyOf(const QPalette &p) const

Возвращает true если эта палитра и p являются копиями друг друга, т.е. одна из них была создана как копия другой, и ни одна из них не была затем изменена; в противном случае возвращает false. Это гораздо строже, чем равенство.

См. также operator=() и operator==().

bool QPalette::isEqual(QPalette::ColorGroup cg1, QPalette::ColorGroup cg2) const

Возвращает true (обычно быстро), если цветовая группа cg1 равна cg2; в противном случае возвращает false.

const QBrush &QPalette::light() const

Возвращает кисть светлого цвета текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::link() const

Возвращает кисть цвета текста необработанной ссылки текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::linkVisited() const

Возвращает кисть цвета текста посещённой ссылки текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::mid() const

Возвращает кисть цвета среднего тона текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::midlight() const

Возвращает кисть цвета среднего света текущей цветовой группы.

См. также ColorRole и brush().

[since 5.12] const QBrush &QPalette::placeholderText() const

Возвращает кисть цвета текста-заполнителя текущей цветовой группы.

Примечание: До Qt 5.12 цвет текста-заполнителя был жёстко задан как QPalette::text().color() с альфа-каналом 128. В Qt 6 он является независимым цветом.

Эта функция была добавлена в Qt 5.12.

См. также ColorRole и brush().

QPalette QPalette::resolve(const QPalette &other) const

Возвращает новую QPalette, которая является объединением этого экземпляра и other. Цветовые роли, заданные в этом экземпляре, имеют приоритет.

void QPalette::setBrush(QPalette::ColorRole role, const QBrush &brush)

Устанавливает кисть для данного цвета role на указанную brush для всех групп в палитре.

См. также brush(), setColor() и ColorRole.

void QPalette::setBrush(QPalette::ColorGroup group, QPalette::ColorRole role, const QBrush &brush)

Это перегруженная функция.

Устанавливает кисть в указанной цветовой group, используемой для данной цветовой role, на brush.

См. также brush(), setColor() и ColorRole.

void QPalette::setColor(QPalette::ColorGroup group, QPalette::ColorRole role, const QColor &color)

Устанавливает цвет в указанной цветовой group, используемой для данной цветовой role, на указанный твёрдый color.

См. также setBrush(), color() и ColorRole.

void QPalette::setColor(QPalette::ColorRole role, const QColor &color)

Это перегруженная функция.

Устанавливает цвет, используемый для данной цветовой role, во всех цветовых группах, на указанный твёрдый color.

См. также brush(), setColor() и ColorRole.

void QPalette::setColorGroup(QPalette::ColorGroup cg, const QBrush &windowText, const QBrush &button, const QBrush &light, const QBrush &dark, const QBrush &mid, const QBrush &text, const QBrush &bright_text, const QBrush &base, const QBrush &window)

Устанавливает группу в cg. Вы можете передать кисти, пиксельмапы или обычные цвета для windowText, button, light, dark, mid, text, bright_text, base и window.

См. также QBrush.

void QPalette::setCurrentColorGroup(QPalette::ColorGroup cg)

Устанавливает текущую цветовую группу палитры в cg.

См. также currentColorGroup().

const QBrush &QPalette::shadow() const

Возвращает кисть тени текущей цветовой группы.

См. также ColorRole и brush().

[since 5.0] void QPalette::swap(QPalette &other)

Меняет местами этот экземпляр палитры с other. Эта функция очень быстрая и никогда не терпит неудачу.

Эта функция была добавлена в Qt 5.0.

const QBrush &QPalette::text() const

Возвращает кисть переднего плана текста текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::toolTipBase() const

Возвращает кисть основания подсказки текущей цветовой группы. Эта кисть используется QToolTip и QWhatsThis.

Примечание: Подсказки используют неактивную цветовую группу QPalette, так как подсказки не являются активными окнами.

См. также ColorRole и brush().

const QBrush &QPalette::toolTipText() const

Возвращает кисть цвета текста подсказки текущей цветовой группы. Эта кисть используется QToolTip и QWhatsThis.

Примечание: Подсказки используют неактивную цветовую группу QPalette, так как подсказки не являются активными окнами.

См. также ColorRole и brush().

const QBrush &QPalette::window() const

Возвращает кисть окна (общего фона) текущей цветовой группы.

См. также ColorRole и brush().

const QBrush &QPalette::windowText() const

Возвращает кисть цвета текста окна (общего переднего плана) текущей цветовой группы.

См. также ColorRole и brush().

QVariant QPalette::operator QVariant() const

Возвращает палитру в виде QVariant

bool QPalette::operator!=(const QPalette &p) const

Возвращает true (медленно), если эта палитра отличается от p; в противном случае возвращает false (обычно быстро).

Примечание: Текущая ColorGroup не учитывается при сравнении палитр

См. также operator==().

bool QPalette::operator==(const QPalette &p) const

Возвращает true (обычно быстро), если эта палитра равна p; в противном случае возвращает false (медленно).

Примечание: Текущая ColorGroup не учитывается при сравнении палитр

См. также operator!=().