Справочник по стилям Qt

Все производные от QAbstractScrollArea, включая QTextEdit и QAbstractItemView (все классы представления элементов), поддерживают прокручиваемые фоны с помощью background-attachment. Установка background-attachment в fixed обеспечивает изображение фона, которое не прокручивается вместе с viewport. Установка background-attachment в scroll, прокручивает изображение фона при перемещении полос прокрутки.

См. Настройка QAbstractScrollArea для примера.

Предупреждение: Убедитесь, что для вашего пользовательского виджета определен макрос Q_OBJECT.

Границу виджета можно стилизовать с помощью свойства border. Подэлемент ::title можно использовать для настройки панели заголовка. Кнопки закрытия и плавающего окна размещаются относительно подэлемента ::title соответственно с помощью ::close-button и ::float-button.

При вертикальной панели заголовка устанавливается псевдокласс :vertical. Кроме того, в зависимости от QDockWidget::DockWidgetFeature, устанавливаются псевдосостояния :closable, :floatable и :movable.

Примечание: Для стилизации ручки изменения размера используйте QMainWindow::separator.

Предупреждение: Стилевые таблицы не имеют эффекта, когда QDockWidget откреплен, так как Qt использует собственные окна верхнего уровня при откреплении.

См. Настройка QDockWidget для примера.

Начиная с версии 4.3, установка стилевой таблицы на QLabel автоматически устанавливает свойство QFrame::frameStyle в QFrame::StyledPanel.

См. Настройка QFrame для примера.

Указатель сортировки можно стилизовать с помощью подэлементов ::up-arrow и ::down-arrow.

См. Настройка QHeaderView для примера.

Цвет и фон выделенного элемента стилизуются с помощью selection-color и selection-background-color соответственно.

Символ пароля можно стилизовать с помощью свойства lineedit-password-character.

Задержка маски пароля может быть изменена с помощью lineedit-password-mask-delay.

См. Настройка QLineEdit для примера.

Отдельные элементы стилизуются с помощью подконтроли ::item. В дополнение к обычно поддерживаемым псевдосостояниям, подконтроль ::item поддерживает псевдосостояния :selected, :default, :exclusive и non-exclusive.

Индикатор изменяемых пунктов меню стилизуется с помощью подконтроли ::indicator.

Разделитель стилизуется с помощью подконтроли ::separator.

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

Скролл стилизуется с помощью ::scroller.

Отрыв стилизуется с помощью ::tearoff.

См. Настройка QMenu для примера.

Начиная с версии 5.15, свойство icon может быть установлено для переопределения значка кнопки.

Для QPushButton с меню индикатор меню стилизуется с помощью подконтроли ::menu-indicator. Внешний вид изменяемых кнопок можно настроить с помощью псевдосостояний :open и :closed.

Предупреждение: Если вы установили только background-color для QPushButton, фон может не отобразиться, пока вы не установите свойство border. Это происходит потому, что по умолчанию QPushButton рисует родной border, который полностью перекрывает background-color. Например,

QPushButton { background-color: red; border: none; }

См. Настройка QPushButton для примера.

Ползунок можно стилизовать с помощью подконтроли ::handle. Установка min-width или min-height задаёт ограничения размера для ползунка в зависимости от ориентации.

Подконтроль ::add-line используется для стилизации кнопки добавления строки. По умолчанию подконтроль add-line размещается в правом верхнем углу прямоугольника границы виджета. В зависимости от ориентации отображается ::right-arrow или ::down-arrow. По умолчанию стрелки размещаются в центре прямоугольника содержимого подконтроли add-line.

Подконтроль ::sub-line используется для стилизации кнопки уменьшения строки. По умолчанию подконтроль sub-line размещается в правом нижнем углу прямоугольника границы виджета. В зависимости от ориентации отображается ::left-arrow или ::up-arrow. По умолчанию стрелки размещаются в центре прямоугольника содержимого подконтроли sub-line.

Подконтроль ::sub-page используется для стилизации области ползунка, уменьшающей страницу. Подконтроль ::add-page используется для стилизации области ползунка, увеличивающей страницу.

См. Настройка QScrollBar для примера.

Желобок ползунка стилизуется с помощью ::groove. По умолчанию желобок размещается в прямоугольнике содержимого виджета. Ползунок ползунка стилизуется с помощью подконтроли ::handle. Подконтроль перемещается в прямоугольнике содержимого подконтроли желобка.

См. Настройка QSlider для примера.

См. Настройка QSplitter для примера.

Псевдосостояния :top, :left, :right, :bottom зависят от ориентации вкладок.

Перекрывающиеся вкладки для выделенного состояния создаются с помощью отрицательных отступов или схемы позиционирования absolute.

Индикатор разрыва QTabBar стилизуется с помощью подконтроли ::tear.

QTabBar использует две QToolButton для своих полос прокрутки, которые можно стилизовать с помощью селектора QTabBar QToolButton. Для указания ширины кнопки прокрутки используйте подконтроль ::scroller.

Выравнивание вкладок в QTabBar стилизуется свойством выравнивания.

Предупреждение:

Чтобы изменить положение QTabBar в QTabWidget, используйте подконтроль tab-bar (и установите subcontrol-position).

См. Настройка QTabBar для примера.

Цвет и фон выделенного элемента стилизуются соответственно с помощью selection-color и selection-background-color.

Виджет угла в QTableView реализован как QAbstractButton и может быть стилизован с помощью селектора "QTableView QTableCornerButton::section".

Предупреждение: Если вы зададите только background-color для QTableCornerButton, фон может не отобразиться, если не задать свойство border. Это происходит потому, что по умолчанию QTableCornerButton рисует родную границу, которая полностью перекрывает background-color.

Цвет сетки можно указать с помощью свойства gridline-color.

См. QAbsractScrollArea для стилизации прокручиваемых фонов.

См. Настройка QTableView для примера.

Цвет и фон выделенного текста стилизуются соответственно с помощью selection-color и selection-background-color.

См. QAbsractScrollArea для стилизации прокручиваемых фонов.

Псевдосостояния :top, :left, :right, :bottom зависят от области, в которой группа инструментов.

Псевдосостояния :first, :last, :middle, :only-one показывают положение панели инструментов в группе строк (см. QStyleOptionToolBar::positionWithinLine).

Разделитель QToolBar стилизуется с помощью подконтроли ::separator.

Ручка (для перемещения панели инструментов) стилизуется с помощью подконтроли ::handle.

См. Настройка QToolBar для примера.

Индивидуальные вкладки могут быть стилизованы с помощью подконтроли ::tab. Вкладки поддерживают псевдосостояния :only-one, :first, :last, :middle, :previous-selected, :next-selected, :selected.

Цвет и фон выделенного элемента стилизуются соответственно с помощью selection-color и selection-background-color.

Поведение выделения контролируется свойством show-decoration-selected.

Ветви дерева можно стилизовать с помощью подконтроли ::branch. Подконтроль ::branch поддерживает псевдосостояния :open, :closed, :has-sibling и :has-children.

Используйте подконтроль ::item для более точного управления элементами в QTreeView.

См. QAbsractScrollArea для стилизации прокручиваемых фонов.

См. Настройка QTreeView для примера стилизации веток.

Если вы наследуете от QWidget, вам необходимо предоставить paintEvent для вашего пользовательского QWidget, как показано ниже:

void CustomWidget::paintEvent(QPaintEvent *)
{
    QStyleOption opt;
    opt.init(this);
    QPainter p(this);
    style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);
}

Вышеприведенный код не выполняет никаких действий, если стиль не задан.

Предупреждение: Убедитесь, что вы определили макрос Q_OBJECT для вашего пользовательского виджета.

Если это свойство не задано, используется значение свойства AlternateBase палитры.

Пример:

QTreeView {
    alternate-background-color: blue;
    background: yellow;
}

См. также background и selection-background-color.

Примеры:

QLabel { background-color: yellow }
QLineEdit { background-color: rgb(255, 0, 0) }

Если это свойство не указано, фоновая картинка повторяется во всех направлениях (repeat).

Пример:

QFrame {
    background: white url(:/images/ring.png);
    background-repeat: repeat-y;
    background-position: left;
}

Пример:

QTextEdit {
    background-image: url("leaves.png");
    background-attachment: fixed;
}

См. также background

Это свойство поддерживается подклассами QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip и обычными виджетами QWidget.

Если это свойство не задано, используется значение по умолчанию padding.

Пример:

QFrame {
    background-image: url(:/images/header.png);
    background-position: top left;
    background-origin: content;
}

См. также background и Модель области.

Это свойство поддерживается подклассами QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip и обычными виджетами QWidget.

Если это свойство не задано, оно по умолчанию равно цвет (т.е., цвет переднего плана виджета).

Пример:

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-color: white;
}

См. также border-style, border-width, border-image, и Модель области.

Радиус рамки обрезает фон элемента.

Это свойство поддерживается подклассами QAbstractItemView, подклассами QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit и QToolTip.

Если это свойство не указано, оно по умолчанию равно 0.

Пример:

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-radius: 4px;
}

См. также ширину рамки и Модель области.

Это свойство поддерживается подклассами QAbstractItemView, подклассами QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit и QToolTip.

Пример:

QLineEdit {
    border-width: 2px;
    border-style: solid;
    border-color: darkblue;
}

См. также цвет рамки, радиус рамки, стиль рамки, образ рамки и Модель области.

Если это свойство не указано, оно по умолчанию равно значению, заданному текущим стилем для стилевого намека SH_DialogButtonLayout.

Пример:

* { button-layout: 2 }

Если это свойство установлено в 1, кнопки QDialogButtonBox отображают значки; если установлено в 0, значки не отображаются.

См. раздел Список значков для получения информации о настройке значков.

QDialogButtonBox { dialogbuttonbox-buttons-have-icons: 1; }

Примечание: Стилям, определяющим это свойство, необходимо быть применённым до создания QDialogButtonBox; это означает, что вы должны применить стиль к родительскому виджету или к самому приложению.

Пример:

QCheckBox { font-family: "New Century Schoolbook" }

Пример:

QTextEdit { font-style: italic }

Если этот параметр не указан, он по умолчанию принимает значение, заданное текущей стилем для стилистического подсказки SH_Table_GridLineColor.

Пример:

* { gridline-color: gray }

В настоящее время этот параметр поддерживается только виджетом QPushButton.

Примечание: Ответственность за назначение иконки кнопке (с использованием API QAbstractButton) лежит на приложении, а не на стилистике. Поэтому будьте осторожны при его настройке, если ваша стилистика не направлена на конкретное приложение.

Доступно начиная с версии 5.15.

Свойство image принимает список Url или svg. Фактическое отображаемое изображение определяется с помощью того же алгоритма, что и QIcon (т.е.) изображение никогда не масштабируется вверх, но всегда масштабируется вниз при необходимости. Если указан svg, изображение масштабируется до размера прямоугольника содержимого.

Установка свойства image для подэлементов неявно устанавливает ширину и высоту подэлемента (если изображение не в формате SVG).

В Qt 4.3 и более поздних версиях выравнивание изображения внутри прямоугольника можно указать с помощью image-position.

Это свойство предназначено только для подэлементов — для других элементов оно не поддерживается.

Предупреждение: Для отображения изображений SVG необходим плагин SVG для QIcon.

Пример:

// implicitly sets the size of down-button to the
// size of spindown.png
QSpinBox::down-button { image: url(:/images/spindown.png) }

Если position равно absolute, свойство left определяет левую границу подэлемента относительно левой границы родителя (см. также subcontrol-origin).

Если этот параметр не указан, он по умолчанию равен 0.

Пример:

QSpinBox::down-button { left: 2px }

См. также right, top и bottom.

Если этот параметр не указан, он по умолчанию принимает значение, заданное текущей стилистикой для стилистического подсказки SH_LineEdit_PasswordMaskDelay.

Это свойство было добавлено в Qt 5.4.

Пример:

* { lineedit-password-mask-delay: 1000 }

Это свойство поддерживается подклассами QAbstractItemView, подклассами QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit и QToolTip.

Значение относительно прямоугольника содержимого в модели области.

Пример:

QSpinBox { max-height: 24px }

См. также max-width.

Если этот параметр не указан, он по умолчанию принимает значение, заданное текущей стилистикой для стилистического подсказки SH_MessageBox_TextInteractionFlags.

Пример:

QMessageBox { messagebox-text-interaction-flags: 5 }

Это свойство поддерживается подклассами QAbstractItemView, подклассами QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit и QToolTip.

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

Значение относительно прямоугольника содержимого в модели размещения элементов.

Пример:

QComboBox { min-width: 72px }

См. также min-height.

Если position равно absolute, свойство right определяет правое ребро подэлемента по отношению к правому ребру родительского элемента (см. также subcontrol-origin).

Пример:

QSpinBox::down-button { right: 2px }

См. также left, top и bottom.

Это свойство поддерживается всеми виджетами, которые учитывают QWidget::palette и отображают выделенный текст.

Если это свойство не задано, значение по умолчанию — то, что задано для роли HighlightedText палитры.

Пример:

QTextEdit { selection-color: white }

См. также selection-background-color и color.

Это свойство поддерживается QCheckBox, флажковыми QGroupBox, QMenuBar и QRadioButton.

Если это свойство не указано, значение по умолчанию зависит от виджета и текущего стиля.

Пример:

QMenuBar { spacing: 10 }

См. также padding и margin.

Если это свойство не указано, значение по умолчанию зависит от подэлемента.

Пример:

QSpinBox::down-button {
    image: url(:/images/spindown.png);
    subcontrol-origin: padding;
    subcontrol-position: right bottom;
}

См. также subcontrol-origin.

Если этот параметр не задан, он по умолчанию принимает значение, указанное в текущем стиле для стилистической подсказки SH_Widget_Animation_Duration.

Этот параметр был добавлен в Qt 5.10.

Пример:

* { widget-animation-duration: 100 }

Если этот параметр не задан, он по умолчанию принимает значение, зависящее от подэлемента/виджета и текущего стиля.

Предупреждение: Если не указано иное, этот параметр не оказывает влияния при установке на виджеты. Если вы хотите виджет с фиксированной шириной, установите min-width и max-width на одно и то же значение.

Пример:

QSpinBox::up-button { width: 12px }

См. также height.

Примечание: Список list может содержать только свойства, которые не основаны на растровых изображениях.

Пример:

QTextEdit { background-position: bottom center }

Примеры:

QLabel { border-width: 1px }                    /* 1px 1px 1px 1px */
QLabel { border-width: 1px 2px }                /* 1px 2px 1px 2px */
QLabel { border-width: 1px 2px 3px }            /* 1px 2px 3px 2px */
QLabel { border-width: 1px 2px 3px 4px }        /* 1px 2px 3px 4px */

Примеры:

QLabel { border-color: red }                      /* opaque red */
QLabel { border-color: #FF0000 }                  /* opaque red */
QLabel { border-color: rgba(255, 0, 0, 75%) }     /* 75% opaque red */
QLabel { border-color: rgb(255, 0, 0) }           /* opaque red */
QLabel { border-color: rgb(100%, 0%, 0%) }        /* opaque red */
QLabel { border-color: hsv(60, 100%, 100%) }      /* opaque yellow */
QLabel { border-color: hsva(240, 255, 255, 75%) } /* 75% blue */
QLabel { border-color: hsl(60, 100%, 50%) }       /* opaque yellow */
QLabel { border-color: hsla(240, 255, 50%, 75%) } /* 75% blue */

Примечание: Разрешенные цвета RGB такие же, как и разрешенные в CSS 2.1, как указано здесь.

Пример:

* {
    file-icon: url(file.png),
               url(file_selected.png) selected;
  }

QMessageBox {
    dialogbuttonbox-buttons-have-icons: true;
    dialog-ok-icon: url(ok.svg);
    dialog-cancel-icon: url(cancel.png),
                        url(grayed_cancel.png) disabled;
}

Например,

QPushButton { color: palette(dark); }

• repeat-x: Повторять по горизонтали.
• repeat-y: Повторять по вертикали.
• repeat: Повторять по горизонтали и вертикали.
• no-repeat: Не повторять.