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

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

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

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

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

См. пример Настройка 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 { 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".

Цвет сетки можно указать с помощью свойства 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);
}

Приведенный выше код не выполняет никаких действий, если отсутствует стилевое оформление.

Если это свойство не задано, используется значение свойства 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;
}

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

Данное свойство поддерживается подклассами 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;
}

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

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

Пример:

* { button-layout: 2 }

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

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

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

Пример:

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

Пример:

QTextEdit { font-style: italic }

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

Пример:

* { gridline-color: gray }

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

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

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

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

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

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

Пример:

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

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

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

Пример:

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

См. также право, верх и низ.

Если этот параметр не указан, он по умолчанию принимает значение, заданное текущей темой для стилевого подсказки 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, QToolButton и 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 }

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

Пример:

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

См. также height.

Пример:

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 */

Пример:

* {
    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: Не повторять.