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

Все производные от QAbstractScrollArea, включая QTextEdit и QAbstractItemView (все классы просмотра элементов), поддерживают прокручиваемый фон с помощью background-attachment. Установка background-attachment в fixed обеспечивает изображение фона, которое не прокручивается вместе с областью просмотра. Установка 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.

Для элементов с подменю стрелки стилизуются с помощью right-arrow и left-arrow.

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

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

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

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

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

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

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 стилизуется свойством alignment.

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

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

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

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

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

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