Справочник по стилям 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 для примера.

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

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

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;
}

См. также фон и цвет выделенного фона.

Примеры:

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;
}

См. также фон

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

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

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

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

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

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

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

Пример:

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

Пример:

QTextEdit { font-style: italic }

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

Пример:

* { gridline-color: gray }

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

• QCheckBox
• QListView
• QPushButton
• QRadioButton
• QTabBar
• QToolBar
• QToolBox
• QTreeView

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

Пример:

* { lineedit-password-character: 9679 }

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

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

Пример:

QLineEdit { margin: 2px }

См. также padding, spacing и Модель рамки.

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

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

Пример:

QComboBox { max-width: 72px }

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

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

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

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

Пример:

QComboBox { min-height: 24px }

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

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

Пример:

QToolTip { opacity: 223 }

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

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

Пример:

QLineEdit { padding: 3px }

См. также отступ, интервал и Модель рамки.

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

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

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

Пример:

QTextEdit { selection-background-color: darkblue }

См. также цвет-выделения и фон.

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

Пример:

* { show-decoration-selected: 1 }

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

Пример:

QSpinBox::up-button {
    image: url(:/images/spinup.png);
    subcontrol-origin: content;
    subcontrol-position: right top;
}

См. также положение-подэлемента.

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

Пример:

QPushButton {
    text-align: left;
}

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

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

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

Пример:

QSpinBox::up-button { top: 2px }

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