Home · All Classes · Main Classes · Grouped Classes · Modules · Functions |
Класс QPalette содержит цветовую группу для каждого состояния виджета. Далее...
#include <QPalette>
Наследуется QColorGroup.
Класс QPalette содержит цветовую группу для каждого состояния виджета.
Палитра состоит из трех цветовых групп: Активный, Недоступный и Неактивный. Все виджеты в Qt содержат палитру и используют ее для отрисовки себя. Это делает пользовательский интерфейс легко настраиваевым и простым в программировании.
Если Вы создаете новый виджет, мы настоятельно рекомендуем использовать цвета палитры, а не жесткое задание цветов.
Цветовые группы:
И активные и неактивные окна могут содержать недоступные виджеты.
В большинстве стилей Активный и Неактивный вид виджетов одинаковы.
Цвета и кисти могут быть заданы для различных ролей в любой из цветовых групп палитры с помощью setColor() и setBrush(). Цветовая группа содержит цвета, используемые виджетом для отрисовки. Мы рекомедуем, чтобы виджеты использовали роли цветовой группы палитры, такие как "foreground" и "base", вместо литеральных обозначений цветов, таких как "red" или "turquoise". Цветовые роли перечислены и определены в описании ColorRole.
Мы настоятельно рекомендуем использовать предоставляемую системой цветовую палитру и изменять ее по мере необходимости.
Для изменения цветовой группы, Вы можете, в зависимости от того, хотите ли Вы установить чистый цвет, или пиксельную карту, использовать функции setColor() и setBrush().
Также, для получения цвета и кисти, используются color() и brush(), а также используются функции удобства ColorRole для текущей ColorGroup: background(), foreground(), base(), и т.д.
Вы можете копировать палитру с помощью конструктора копирования, а также проверить, являются ли две палитры идентичными, с помощью isCopyOf().
QPalette оптимизирован с помощью неявного совместного использования данных, что очень эффективно при передаче объектов QPalette в качестве аргументов.
См. также QApplication::setPalette(), QWidget::setPalette() и QColor.
Константа | Значение | Описание |
---|---|---|
QPalette::Disabled | 1 | |
QPalette::Active | 0 | |
QPalette::Inactive | 2 | |
QPalette::Normal | Active | синоним Active |
Перечисление ColorRole определяет различные символические роли цветов, используемые в текущем GUI.
Основные роли - это:
Константа | Значение | Описание |
---|---|---|
QPalette::Window | 10 | Общий цвет фона. |
QPalette::Background | Window | Устаревшее значение. Вместо него следует использовать Window. |
QPalette::WindowText | 0 | Общий цвет переднего плана. |
QPalette::Foreground | WindowText | Устаревшее значение. Вместо него следует использовать WindowText. |
QPalette::Base | 9 | Используется в качестве цвета фона в виджетах для ввода текста; обычно, белый или другой светлый цвет. |
QPalette::AlternateBase | 16 | Используется в качестве альтернативного цвета фона в представлениях с чередующимися цветами строк (см. QAbstractItemView::setAlternatingRowColors()). |
QPalette::Text | 6 | Цвет переднего плана используемый с Base. Обычно тоже самое, что и WindowText, когда нужно обеспечить сильный контраст между Window и Base. |
QPalette::Button | 1 | Общий цвет фона кнопок. Этот фон может отличаться от Window, так как некоторые стили требуют различных цветов фона и кнопок. |
QPalette::ButtonText | 8 | Цвет переднего плана, используемый с цветом Button. |
Есть некоторые цветовые роли, используемые главным образом в 3D эффектах подсветки и тени. Все они, обычно, происходят от Background и используются способом, зависящим от отношения к нему. Например, кнопки для привлекательности подсвечиваются, а полосы прокрутки Motif зависяот от цвета Mid для того, чтобы быть чуть светлее, чем Window.
Константа | Значение | Описание |
---|---|---|
QPalette::Light | 2 | Светлее цвета Button. |
QPalette::Midlight | 3 | Между Button и Light. |
QPalette::Dark | 4 | Темнее цвета Button. |
QPalette::Mid | 5 | Между Button и Dark. |
QPalette::Shadow | 11 | Очень темный цвет. По умолчанию, цвет тени равен Qt::black. |
Выделенные (отмеченные) записи могут иметь две роли:
Константа | Значение | Описание |
---|---|---|
QPalette::Highlight | 12 | Цвет для индикации выделенной или текущей записи. По умолчанию, этот цвет равен Qt::darkBlue. |
QPalette::HighlightedText | 13 | Цвет текста, отличающий его от Highlight. По умолчанию, цвет текста равен Qt::white. |
И, наконец, есть специальная роль для текста, который должен быть нарисован в месте, где Text и Foreground дадут слабый контраст, таком как нажатая кнопка. Обратите внимание, что цвета текста могут использоваться для других, отличных от текста, элементов; цвета текста обычно используются для текста, но достаточно распространено использование цветов текстовых ролей для линий иконок и т.д.
Константа | Значение | Описание |
---|---|---|
QPalette::BrightText | 7 | Цвет текста, очень сильно выделяющегося на Foreground, и сильно с ним контрастирующий, например Dark. |
QPalette::Link | 14 | Цвет текста, используемый для непосещенных гиперссылок. По умолчанию, этот цвет равен Qt::blue. |
QPalette::LinkVisited | 15 | Цвет текста, используемый для уже посещенных гиперссылок. По умолчанию, этот цвет равен Qt::magenta. |
На следующем рисунке показано использование большинства цветовых ролей:
Создает объект палитры, использующий цветовую палитру приложения по умолчанию.
См. также QApplication::setPalette() и QApplication::palette().
Создает палитру, основываясь на цвете button. Другие цвета автоматически вычисляются, основываясь на этом цвете. Цвет Window будет таким же, как цвет кнопки.
Создает палитру, основываясь на цвете button. Другие цвета автоматически вычисляются, основываясь на этом цвете. Цвет Window будет таким же, как цвет кнопки.
Создает палитру, основываясь на цветах button и window. Другие цвета автоматически вычисляются, основываясь на этих цветах.
Создает палитру. Вы можете передавать кисти, пиксельные карты и простые цвета в windowText, button, light, dark, mid, text, bright_text, base и window.
См. также QBrush.
Создает копию p.
Данный конструктор весьма быстр за счет неявного совместного использования данных.
Разрушает палитру.
Возвращает дополнительную базовую кисть для альтернативного базового цвета.
См. также ColorRole and brush().
Возвращает базовую кисть для текущей цветовой группы.
См. также ColorRole и brush().
Возвращает кисть яркого текста переднего плана для текущей цветовой группы.
См. также ColorRole и brush().
Возвращает кисть цветовой группы gr, используемую для цветовой роли cr.
См. также color(), setBrush() и ColorRole.
Данная перегруженная функция-член предоставлена для удобства. Ее поведение аналогично поведению вышеприведенной функции.
Возвращает кисть, которая установлена для цветовой роли r в текущей ColorGroup.
См. также color(), setBrush() и ColorRole.
Возвращает кисть кнопки текущей цветовой группы.
См. также ColorRole и brush().
Возвращает кисть текста кнопки переднего плана текущей цветовой группы.
См. также ColorRole и brush().
Возвращает цвет цветовой группы gr используемый для цветовой роли r.
См. также brush(), setColor() и ColorRole.
Данная перегруженная функция-член предоставлена для удобства. Ее поведение аналогично поведения вышеприведенной функции.
Возвращает цвет, который был установлен для цветовой роли r текущей ColorGroup.
См. также brush() и ColorRole.
Возвращает текущую цветовую группу палитры.
См. также setCurrentColorGroup().
Возвращает темную кисть текущей цветовой группы.
См. также ColorRole и brush().
Возвращаетю кисть подсветки (QPalette::Highlight) текущей цветовой группы.
См. также ColorRole и brush().
Возвращает кисть самого светлого текста (QPalette::HighlightedText) текущей цветовой группы.
См. также ColorRole и brush().
Возвращает true если эта палитра и ралитра p являются копиями друг друга, т.е. одна из них была создана как копия другой и ни одна из них не была впоследствие изменена; в противном случае возвращает false. Данная функция намного более строга, чем равенство.
См. также operator=() и operator==().
Возвращает true (обычно быстро) если цветовая группа cg1 эквивалентна цветовой группе cg2; в противном случае возвращает false.
Возвращает светлую кисть (QPalette::Light) текущей цветовой группы.
См. также ColorRole и brush().
Возвращает кисть текста непосещенных ссылок (QPalette::Link) текущей цветовой группы.
См. также ColorRole и brush().
Возвращает кисть текста посещенных ссылок (QPalette::LinkVisited) текущей цветовой группы.
См. также ColorRole и brush().
Возвращает среднюю кисть (QPalette::Mid) текущей цветовой группы.
См. также ColorRole и brush().
Возвращает среднюю светлую кисть (QPalette::Midlight) текущей цветовой группы.
См. также ColorRole и brush().
Возвращает новый объект QPalette, все атрибуты которого являются копиями соответствующих атрибутов палитры other.
Возвращает число, являющееся уникальным идентификатором данного объекта QPalette. Серийный номер предназначается для кэширования. Это значение нельзя использовать ни для чего, кроме проверки на равенство.
Обратите внимание, что QPalette использует неявное совместное использование данных, и серийный номер изменяется при операции копирования данных (когда палитра действительно изменяется), а не при копировании самого объекта (при вызове конструктора копирования или присваивании).
См. также QPixmap, QPixmapCache и QCache.
Устанавливает кисть, используемую для цветовой роли cr, в brush для всех цветовых групп.
См. также brush(), setColor() и ColorRole.
Данная перегруженная функция-член предоставлена для удобства. Ее поведение аналогично поведения вышеприведенной функции.
Устанавливает кисть в цветовой группе cg, используемую для цветовой роли cr, в b.
См. также brush(), setColor() и ColorRole.
Устанавливает кисть в цветовой группе gr, используемую для цветовой роли r, в сплошной цвет c.
См. также setBrush(), color() и ColorRole.
Данная перегруженная функция-член предоставлена для удобства. Ее поведение аналогично поведения вышеприведенной функции.
Устанавливает кисть, используемую в цветовой роли r всех цветовых групп в сплошной цвет c.
См. также brush(), setColor() и ColorRole.
Настраивает цветовую группу cg. Вы можете передать как кисти, так и пиксельные карты и просто цвета в аргументы windowText, button, light, dark, mid, text, bright_text, base и window.
См. также QBrush.
Устанавливает текущую цветовую группу палитры в cg.
См. также currentColorGroup().
Возвращает кисть тени текущей цветовой группы.
См. также ColorRole и brush().
Возвращает кисть текста переднего плана текущей цветовой группы.
См. также ColorRole и brush().
Возвращает кисть окна (общего фона) текущей цветовой группы.
См. также ColorRole и brush().
Возвращает кисть надписей окна (общего фона) текущей цветовой группы.
См. также ColorRole и brush().
Возвращает палитру как QVariant.
Возвращает true (медленно) если данная палитра отлична от палитры p; в противном случае возвращает false (обычно быстро).
Присваивает значение p данной палитре и возвращает ссылку на эту палитру.
Данная операция выполняется быстро в связи с применением неявного совмествного использования данных.
Возвращает true (обычно быстро) если данная палитра эквивалентна палитре p; в противном случае возвращает false (медленно).
Данная перегруженная функция предоставлена для удобства.
Записывает палитру p в поток s и возвращает ссылку на поток.
См. также Формат операторов QDataStream.
Данная перегруженная функция предоставлена для удобства.
Читает палитру из потока s в палитру p и возвращает ссылку на поток.
См. также Формат операторов QDataStream.
Copyright © 2005 Trolltech | Trademarks | Qt 4.1.0 |