Главная · Все классы · Основные классы · Классы по группам · Модули · Функции

[Предыдущая: Настройка виджетов Qt с использованием таблиц стилей] [Содержание] [Следующая: Примеры таблиц стилей Qt]

Руководство по таблицам стилей Qt

Таблицы стилей Qt поддерживают разнообразные свойства, псевдо-состояния и субэлементы управления, позволяющие настраивать внешний вид виджетов.

Список виджетов, допускающих применение стиля

В следующей таблице перечислены виджеты Qt, которые могут быть настроены с использованием таблиц стилей:

ВиджетКак применить стиль
QAbstractScrollArea Поддерживает модель "коробки" (box model).

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

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

QCheckBox Поддерживает модель "коробки" (box model). Стиль к индикатору отметки можно применить используя субэлемент управления ::indicator. По умолчанию, индикатор располагается в верхнем левом углу прямоугольника содержимого виджета.

Свойство spacing задает интервал между индикатором отметки и текстом.

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

QColumnView Стиль к элементу изменения размера можно применить используя свойство image. Применить стиль к индикаторам стрелок можно используя субэлементы управления ::left-arrow и ::right-arrow.
QComboBox Стиль к рамке вокруг комбинированного списка выбора можно применить используя модель "коробки". Стиль к кнопке выпадающего списка можно применить используя субэлемент управления ::drop-down. По умолчанию, кнопка выпадающего списка расположена в верхнем правом углу прямоугольника заполнения виджета. Стиль к значку стрелки внутри кнопки выпадающего списка можно применить используя субэлемент управления ::down-arrow. По умолчанию, стрелка расположена по центру прямоугольника содержимого субэлемента управления выпадающего списка.

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

QDateEdit Смотрите QSpinBox.
QDateTimeEdit Смотрите QSpinBox.
QDialog Поддерживает только свойства background, background-clip и background-origin.

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

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

Вышеприведенный код ничего не делает в случае отсутствия таблицы стилей.

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

QDialogButtonBox Компоновку кнопок можно изменить используя свойство button-layout.
QDoubleSpinBox Смотрите QSpinBox.
QFrame Поддерживает модель "коробки" (box model).

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

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

QGroupBox Поддерживает модель "коробки" (box model). Стиль к заголовку можно применить используя субэлемент управления ::title. По умолчанию, расположение заголовка зависит от QGroupBox::textAlignment.

В случае QGroupBox, который можно отмечать, заголовок включает в себя индикатор отметки. Стиль к индикатору применяется используя субэлемент управления ::indicator. Свойство spacing может быть использовано для управления интервалом между текстом и индикатором.

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

QHeaderView Поддерживает модель "коробки" (box model). Стиль к секциям заголовка представления элементов применяется используя субэлемент управления ::section. Субэлемент управления section поддерживает псевдо-состояния :middle, :first, :last, :only-one, :next-selected, :previous-selected, :selected.

Стиль к индикатору сортировки может быть применен с использованием субэлементов управления ::up-arrow и ::down-arrow.

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

QLabel Поддерживает модель "коробки" (box model). Не поддерживает псевдо-состояние :hover.

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

Смотрите пример Настройки QFrame (QLabel происходит от QFrame).

QLineEdit Поддерживает модель "коробки".

Стиль к цвету и фону выделенного элемента можно применить используя свойства selection-color и selection-background-color, соответственно.

Стиль к символу для ввода пароля можно применить используя свойство lineedit-password-character.

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

QListView Поддерживает модель "коробки" (box model). Когда цвета чередующихся строк разрешены, стиль к чередующимся цветам можно применить используя свойство alternate-background-color.

Стиль к цвету и фону выделенного элемента можно применить используя свойства selection-color и selection-background-color, соответственно.

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

Смотрите QAbsractScrollArea как применять стиль к прокручиваемому фону.

QListWidget Смотрите QListWidget.
QMenu Поддерживает модель "коробки" (box model).

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

Стиль к индикатору отметки пунктов меню, которые можно отмечать, применяется используя субэлемент управления ::indicator.

Стиль к разделителю применяется используя субэлемент управления ::separator.

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

Стиль к скроллеру (scroller) применяется используя субэлемент управления ::scroller.

Стиль к линии отрыва (tear-off) применяется используя субэлемент управления ::tear-off.

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

QMenuBar Поддерживает модель "коробки" (box model). Свойство spacing задает интервал между пунктами меню. Стиль к отдельным пунктам меню применяется используя субэлемент управления ::item.

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

QMessageBox Свойство messagebox-text-interaction-flags может быть использовано чтобы изменить взаимодействие с текстом в окне сообщения.
QProgressBar Поддерживает модель "коробки" (box model). Стиль к чанкам (chunks) индикатора выполнения можно применить используя субэлемент управления ::chunk. Чанк отображается в прямоугольнике содержимого виджета.

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

У незавершенного индикатора выполнения установлено псевдо-состояние :indeterminate.

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

QPushButton Поддерживает модель "коробки" (box model). Поддерживает псевдо-состояния :default, :flat, :checked.

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

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

QRadioButton Поддерживает модель "коробки" (box model). Стиль к индикатору отметки можно применить используя субэлемент управления ::indicator. По умолчанию, индикатор располагается в верхнем левом углу прямоугольника содержимого виджета.

Свойство spacing задает интервал между индикатором отметки и текстом.

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

QScrollBar Поддерживает модель "коробки" (box model). Прямоугольник содержимого виджета рассматривается как бороздка по которой двигается ползунок. Размер QScrollBar (т.е. ширина или высота в зависимости от ориентации) устанавливается используя свойство width или height, соответственно. Чтобы определить ориентацию используйте псевдо-состояния :horizontal и :vertical.

Стиль к ползунку можно применить используя субэлемент управления ::handle. Установка свойства min-width или min-height обеспечивает ограничение размера ползунка в зависимости от ориентации.

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

Субэлемент управления ::sub-line может быть использован для применения стиля к кнопке вычитания лини (subtract a line). По умолчанию, субэлемент управления sub-line расположен в нижнем правом углу прямоугольника границ виджета. В зависимости от ориентации - ::left-arrow или ::up-arrow. По умолчанию, стрелки расположены по центру прямоугольника содержимого субэлемента управления sub-line.

Субэлемент управления ::sub-page может быть использован для применения стиля к области ползунка, которая вычитает страницу (subtracts a page). Субэлемент управления ::add-page может быть использован для применения стиля к области ползунка, которая добавляет страницу (adds a page).

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

QSizeGrip Поддерживает свойства width, height и image.

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

QSlider Поддерживает модель "коробки" (box model). Для горизонтальных ползунков должны предоставляться свойства min-width и height. Для вертикальных ползунков должны предоставляться свойства min-height и width.

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

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

QSpinBox Стиль к рамке окошка счетчика может быть применен используя модель "коробки".

Стиль к верхней кнопке и верхней стрелке можно применить используя субэлементы управления ::up-button и ::up-arrow. По умолчанию, верхняя кнопка (up-button) расположена в верхнем правом углу прямоугольника заполнения виджета. Без явно заданных размеров она занимает половину высоты прямоугольника, к которому относится. Верхняя стрелка (up-arrow) расположена в центре прямоугольника содержимого верхней кнопки.

Стиль к нижней кнопке и нижней стрелке можно применить используя субэлементы управления ::down-button и ::down-arrow. По умолчанию, нижняя кнопка (down-button) расположена в нижнем правом углу прямоугольника заполнения виджета. Без явно заданных размеров она занимает половину высоты прямоугольника, к которому относится. Нижняя стрелка (bottom-arrow) расположена в центре прямоугольника содержимого нижней кнопки.

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

QSplitter Поддерживает модель "коробки" (box model). Стиль к рукоятке разделителя применяется используя субэлемент управления ::handle subcontrol.

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

QStatusBar Поддерживает только свойство background. Стиль к рамке отдельных элементов можно применить используя субэлемент управления ::item.

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

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

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

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

Стиль к индикатору разрыва QTabBar применяется используя субэлемент управления ::tear.

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

Стиль к выравниванию вкладок внутри QTabBar применяется используя свойство alignment.

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

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

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

QTabWidget Стиль к рамке виджета со вкладками применяется используя субэлемент управления ::pane. Стиль к левому и правому углам применяется используя ::left-corner и ::right-corner, соответственно. Расположение панели вкладок контролируется используя субэлемент управления ::tab-bar.

По умолчанию, субэлементы управления занимают место QTabWidget в QWindowsStyle. Чтобы разместить QTabBar по центру, установите свойство subcontrol-position субэлемента управления tab-bar.

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

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

QTableView Поддерживает модель "коробки" (box model). Когда цвета чередующихся строк разрешены, стиль к чередующимся цветам можно применить используя свойство alternate-background-color.

Стиль к цвету и фону выделенного элемента можно применить используя свойства selection-color и selection-background-color, соответственно.

Угловой виджет в QTableView реализован как QAbstractButton и к нему можно применить стиль используя селектор "QTableView QTableCornerButton::section".

Цвет сетки может быть задан используя свойство gridline-color.

Смотрите QAbsractScrollArea как применять стиль к прокручиваемому фону.

QTableWidget Смотрите QTableView.
QTextEdit Поддерживает модель "коробки" (box model).

Стиль к цвету фону выделенного текста применяется используя свойства selection-color и selection-background-color, соответственно.

Смотрите QAbsractScrollArea как применять стиль к прокручиваемому фону.

QTimeEdit Смотрите QSpinBox.
QToolBar Поддерживает модель "коробки" (box model).

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

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

Стиль к разделителю QToolBar'а применяется используя субэлемент управления ::separator.

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

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

QToolButton Поддерживает модель "коробки" (box model).

Если инструментальная кнопка QToolButton имеет меню, то для применения стиля к индикатору может использоваться субэлемент управления ::menu-indicator. По умолчанию, индикатор меню (menu-indicator) расположен в нижнем правом углу прямоугольника заполнения виджета.

Если QToolButton находится в режиме QToolButton::MenuButtonPopup, субэлемент управления ::menu-button используется для отрисовки кнопки меню. Субэлемент управления ::menu-arrow используется для отрисовки стрелки меню внутри кнопки меню (menu-button). По умолчанию, он расположен в центре прямоугольника содержимого субэлемента управления кнопки меню.

Когда QToolButton отображает стрелки, используются субэлементы управления ::up-arrow, ::down-arrow, ::left-arrow и ::right-arrow.

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

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

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

QToolBox Поддерживает модель "коробки" (box model).

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

QToolTip Поддерживает модель "коробки" (box model). Свойство opacity управляет прозрачностью всплывающей подсказки.

Смотрите пример Настройки QFrame (QToolTip является QFrame).

QTreeView Поддерживает модель "коробки" (box model). Когда цвета чередующихся строк разрешены, стиль к чередующимся цветам можно применить используя свойство alternate-background-color.

Стиль к цвету и фону выделенного элемента можно применить используя свойства selection-color и selection-background-color, соответственно.

Стиль к ветвям представления дерева можно применить используя субэлемент управления ::branch. Субэлемент управления ::branch поддерживает псевдо-состояния :open, :closed, :has-sibling и :has-children.

Смотрите QAbsractScrollArea как применять стиль к прокручиваемому фону.

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

QTreeWidget Смотрите QTreeView.
QWidget Поддерживает только свойства background, backgorund-clip и background-origin.

Если вы создаете подкласс от 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.

Список свойств

В таблице ниже перечислены все свойства, поддерживаемые таблицами стилей Qt. Значения, которые могут быть присвоены свойствам, зависят от типа свойства. Если иное не указано явно, то свойства применимы ко всем виджетам. Отмеченные звездочкой * свойства специфичны для Qt и не имеют аналогов в CSS2 или CSS3.

СвойствоТипОписание
alternate-background-color Brush
Чередующиеся цвета фона используются в подклассах QAbstractItemView.

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

Пример:

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

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

background BackgroundСокращенное обозначение для установки фона. Эквивалентно указанию background-color, background-image, background-repeat и/или background-position.

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

Пример:

  QTextEdit { background: yellow }

Часто требуется установить шаблон заполнения (fill pattern) похожий на стили в Qt::BrushStyle. Вы можете использовать свойство background-color для Qt::SolidPattern, Qt::RadialGradientPattern, Qt::LinearGradientPattern и Qt::ConicalGradientPattern. Другие шаблоны легко достигаются путем создания фонового изображение, содержащего шаблон.

Пример:

  QLabel {
      background-image: url(dense6pattern.png);
      background-repeat: repeat-xy;
  }

Смотрите также background-origin, selection-background-color, background-clip, background-attachment и alternate-background-color.

background-color Brush
Цвет фона, используемого в виджете.

Примеры:

 QLabel { background-color: yellow }
 QLineEdit { background-color: rgb(255, 0, 0) }
background-image UrlФоновое изображение, используемое для виджета. Сквозь полупрозрачные части изображения ясно виден цвет фона background-color.

Пример:

 QFrame { background-image: url(:/images/hydro.png) }
background-repeat RepeatОпределяет, как и какое фоновое изображение будет повторяться для заполнения прямоугольника background-origin.

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

Пример:

  QFrame {
      background: white url(:/images/ring.png);
      background-repeat: repeat-y;
      background-position: left;
  }
background-positionAlignmentВыравнивание фонового изображения внутри прямоугольника background-origin.

Если это свойство не задано, выравнивание равно top left.

Пример:

  QFrame {
      background: url(:/images/footer.png);
      background-position: bottom left;
  }
background-attachment AttachmentОпределяет, будет ли фоновое изображение background-image в QAbstractScrollArea прокручиваемым или фиксированным относительно окна просмотра. По умолчанию, фоновое изображение background-image прокручивается вместе с окном просмотра.

Пример:

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

Смотрите также background

background-clip OriginПрямоугольник виджета, в котором отрисовывается фон background.

Это свойство задает прямоугольник, который отсекает background-color и background-image.

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

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

Пример:

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

Смотрите также background, background-origin и Модель "коробки".

background-origin OriginПрямоугольник фона виджета для использования в сочетании с background-position и background-image.

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

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

Пример:

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

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

border BorderСокращенное обозначение для установки границы виджета. Эквивалентно указанию border-color, border-style и/или border-width.

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

Пример:

  QLineEdit { border: 1px solid white }
border-topBorderСокращенное обозначение для установки верхней границы виджета. Эквивалентно указанию border-top-color, border-top-style и/или border-top-width.
border-rightBorderСокращенное обозначение для установки правой границы виджета. Эквивалентно указанию border-right-color, border-right-style и/или border-right-width.
border-bottomBorderСокращенное обозначение для установки нижней границы виджета. Эквивалентно указанию border-bottom-color, border-bottom-style и/или border-bottom-width.
border-leftBorderСокращенное обозначение для установки левой границы виджета. Эквивалентно указанию border-left-color, border-left-style и/или border-left-width.
border-color Box ColorsЦвет всех кромок границы. Эквивалентно указанию border-top-color, border-right-color, border-bottom-color и border-left-color.

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

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

Пример:

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

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

border-top-colorBrush
Цвет верхней кромки границы.
border-right-colorBrush
Цвет правой кромки границы.
border-bottom-colorBrush
Цвет нижней кромки границы.
border-left-colorBrush
Цвет левой кромки границы.
border-image Border ImageИзображение, используемое для заливки границы. Изображение разбивается на девять частей и, если необходимо, растягивается подходящим образом. За подробностями обращайтесь к Border Image.

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

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

border-radius RadiusРадиус закругления углов границы. Эквивалентно указанию border-top-left-radius, border-top-right-radius, border-bottom-right-radius и border-bottom-left-radius.

Радиус закругления border-radius отсекает фон background элемента.

Это свойство поддерживается подклассами 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 и Модель "коробки".

border-top-left-radiusRadiusРадиус закругления верхнего левого угла границы.
border-top-right-radiusRadiusРадиус закругления верхнего правого угла границы.
border-bottom-right-radiusRadiusРадиус закругления нижнего правого угла границы. Установка этого свойства в положительное значение приводит к закруглению угла.
border-bottom-left-radiusRadiusРадиус закругления нижнего левого угла границы. Установка этого свойства в положительное значение приводит к закруглению угла.
border-style Border StyleСтиль всех кромок границы.

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

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

Пример:

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

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

border-top-styleBorder StyleСтиль верхней кромки границы.
border-right-styleBorder StyleСтиль нижней кромки границы.
border-bottom-styleBorder StyleСтиль нижней кромки границы.
border-left-styleBorder StyleСтиль левой кромки границы.
border-width Box LengthsТолщина границы. Эквивалентно указанию border-top-width, border-right-width, border-bottom-width и border-left-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 и Модель "коробки".

border-top-widthLengthТолщина верхней кромки границы.
border-right-widthLengthТолщина правой кромки границы.
border-bottom-widthLengthТолщина нижней кромки границы.
border-left-widthLengthТолщина левой кромки границы.
bottom LengthЕсли свойство position равно relative (по умолчанию), перемещает subcontrol на определенное смещение вверх; указание bottom: y эквивалентно указанию top: -y.

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

Пример:

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

Смотрите также left, right и top.

button-layout NumberКомпоновка кнопок в QDialogButtonBox или QMessageBox. Возможные значения - 0 (WinLayout), 1 (MacLayout), 2 (KdeLayout) и 3 (GnomeLayout).

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

Пример:

  * { button-layout: 2 }
color Brush
Цвет, используемый для отрисовки текста.

Это свойство поддерживается всеми виджетами, которые связаны с QWidget::palette.

Если это свойство не установлено, значение по умолчанию равно тому, что установлено для QWidget::foregroundRole в палитре виджета (обычно - черный цвет).

Пример:

  QPushButton { color: red }

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

font FontСокращенное обозначение для установки шрифта текста. Эквивалентно указанию font-family, font-size, font-style и/или font-weight.

Это свойство поддерживается всеми виджетами, которые связаны с QWidget::font.

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

Пример:

  QCheckBox { font: bold italic large "Times New Roman" }
font-familyStringСемейство шрифтов.

Пример:

  QCheckBox { font-family: "New Century Schoolbook" }
font-sizeFont SizeРазмер шрифта. В данной версии Qt поддерживаются только метрики pt и px.

Пример:

  QTextEdit { font-size: 12px }
font-styleFont StyleСтиль шрифта.

Пример:

  QTextEdit { font-style: italic }
font-weightFont WeightПлотность шрифта.
gridline-color* Color
Цвет линии сетки в QTableView.

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

Пример:

  * { gridline-color: gray }
height LengthВысота субэлемента управления (или, в некоторых случаях, виджета).

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

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

Пример:

  QSpinBox::down-button { height: 10px }

Смотрите также width.

image* Url+Изображение, которое отрисовывается в прямоугольнике содержимого субэлемента управления.

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

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

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

Предупреждение: Подключаемый модуль SVG QIcon необходим для визуализации изображений SVG.

Пример:

 /* размеры кнопки выпадающего меню неявно устанавливаются равными размерам spindown.png */
 QSpinBox::down-button { image: url(:/images/spindown.png) }

 QTextEdit { image: url(x1.png) url(x2.png) }
 QTextEdit { image: url(pic1.svg) }
image-position alignmentВ Qt версии 4.3 и позднее, выравнивание позиции изображения можно задать используя относительную или абсолютную позицию.
left LengthЕсли свойство position равно relative (по умолчанию), то перемещает субэлемент управления на определенное смещение вправо.

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

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

Пример:

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

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

lineedit-password-
character
*
NumberСимвол для ввода пароля в QLineEdit как число Unicode.

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

Пример:

     * { lineedit-password-character: 9679 }
margin Box LengthsПоля виджета. Эквивалентно заданию margin-top, margin-right, margin-bottom и margin-left.

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

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

Пример:

     QLineEdit { margin: 2px }

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

margin-topLengthВерхнее поле виджета.
margin-rightLengthПравое поле виджета.
margin-bottomLengthНижнее поле виджета.
margin-leftLengthЛевое поле виджета.
max-height LengthМаксимальная высота виджета или субэлемента управления.

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

Пример:

     QSpinBox { max-height: 24px }

Смотрите также max-width.

max-width LengthМаксимальная ширина виджета или субэлемента управления.

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

Пример:

     QComboBox { max-width: 72px }

Смотрите также max-height.

messagebox-text-
interaction-flags
*
NumberХарактеристики взаимодействия с текстом в окне сообщения. Возможные значения основаны на Qt::TextInteractionFlags.

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

Пример:

     QMessageBox { messagebox-text-interaction-flags: 5 }
min-height LengthМинимальная высота виджета или субэлемента управления.

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

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

Пример:

     QComboBox { min-height: 24px }

Смотрите также min-width.

min-width LengthМинимальная ширина виджета или субэлемента управления.

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

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

Пример:

     QComboBox { min-width: 72px }

Смотрите также min-height.

opacity* NumberПрозрачность виджета. Возможные значения - от 0 (полностью прозрачный) до 255 (матовый). В настоящее время это свойство поддерживается только для всплывающих подсказок.

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

Пример:

     QToolTip { opacity: 223 }
padding Box LengthsЗаполнитель виджета. Эквивалентно указанию padding-top, padding-right, padding-bottom и padding-left.

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

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

Пример:

     QLineEdit { padding: 3px }

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

padding-topLengthВерхний заполнитель виджета.
padding-rightLengthПравый заполнитель виджета.
padding-bottomLengthНижний заполнитель виджета.
padding-leftLengthЛевый заполнитель виджета.
position relative
| absolute
Определяет, будет ли смещение задаваться используя left, right, top и bottom в относительных или абсолютных координатах.

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

right LengthЕсли свойство position равно relative (по умолчанию), то перемещает субэлемент управления на определенное смещение влево; указание right: x эквивалентно указанию left: -x.

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

Пример:

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

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

selection-background-color* Brush
Фон выделенного текста или элемента.

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

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

Пример:

     QTextEdit { selection-background-color: darkblue }

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

selection-color* Brush
Цвет переднего плана выделенного текста или элемента.

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

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

Пример:

     QTextEdit { selection-color: white }

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

show-decoration-
selected
*
BooleanУправляет тем, будут ли выделение в QListView охватывать всю строку или только часть с текстом.

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

Пример:

     * { show-decoration-selected: 1 }
spacing* LengthВнутренний интервал в виджете.

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

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

Пример:

     QMenuBar { spacing: 10 }

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

subcontrol-origin* OriginПрямоугольник основы субэлемента управления внутри родительского элемента.

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

Пример:

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

Смотрите также subcontrol-position.

subcontrol-position* AlignmentВыравнивание субэлемента управления внутри прямоугольника основы задается subcontrol-origin.

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

Пример:

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

Смотрите также subcontrol-origin.

text-align AlignmentВыравнивание текста и пиктограмм внутри прямоугольника содержимого виджета.

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

Пример:

     QPushButton {
         text-align: left;
     }

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

top LengthЕсли свойство position равно relative (по умолчанию), то перемещает субэлемент управления на определенное смещение вниз.

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

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

Пример:

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

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

width LengthШирина субэлемента управления (или, в некоторых случаях, виджета).

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

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

Пример:

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

Смотрите также height.

Список типов свойств

В следующей таблице сведены синтаксис и значение различных типов свойств.

ТипСинтаксисОписание
Alignment { top
| bottom
| left
| right
| center }*
Горизонтальное и/или вертикальное выравнивание.

Пример:

 QTextEdit { background-position: bottom center }
Attachment { scroll
| fixed }*
Прокручиваемое или фиксированное вложение.
Background { Brush
| Url
| Repeat
| Alignment }*
Последовательность Brush, Url, Repeat и Alignment.
Boolean 0 | 1True (1) or false (0).

Пример:

 QDialog { etch-disabled-text: 1 }
Border { Border Style
| Length
| Brush }*
Сокращенное обозначение свойства border.
Border Imagenone
| Url Number{4}
(stretch | repeat){0,2}
Изображение границы (border image) - изображение, которое состоит из девяти частей (верхней левой, верхней центральной, верхней правой, центральной левой, центральной, центральной правой, нижней левой, нижней центральной, нижней правой). Когда требуется граница определенного размера, угловые части используются как есть, а верхняя, правая, нижняя и левая части растягиваются или повторяются чтобы создать границы требуемого размера.

За подробностями обращайтесь к Черновику спецификации CSS3.

Border Styledashed
| dot-dash
| dot-dot-dash
| dotted
| double
| groove
| inset
| outset
| ridge
| solid
| none
Задает шаблон, используемый для рисования границы. За подробностями обращайтесь к Черновику спецификации CSS3.
Box ColorsBrush{1,4}От одного до четырех вхождений кисти Brush, задающих верхнюю, правую, нижнюю и левую кромку прямоугольника, соответственно. Если цвет левой кромки не задан, он берется таким же что и цвет правой кромки. Если цвет нижней кромки не задан, он берется таким же что и цвет верхней кромки. Если цвет правой кромки не задан, он берется таким же что и цвет верхней кромки.

Пример:

                 QLabel { border-color: red }   /* красный красный красный красный   */
                 QLabel { border-color: red blue } /* красный синий красный синий */
                 QLabel { border-color: red blue green } /* красный синий зеленый синий
 */
                 QLabel { border-color: red blue green yellow }  /* красный
 синий зеленый желтый */
Box LengthsLength{1,4}От одного до четырех вхождений Length, задающих верхнюю, правою, нижнюю и левую кромки прямоугольника, соответственно. Если длина левой кромки не задана, то она берется равной длине правой кромки. Если длина нижней кромки не задана, то она берется равной длине верхней кромки. Если длина правой кромки не задана, то она берется равной длине верхней кромки.

Примеры:

         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 */
Brush Color
| Gradient
| PaletteRole
Задает либо цвет (Color), либо градиент (Gradient), либо компонент палитры (Palette).
Color rgb(r, g, b)
| rgba(r, g, b, a)
| #rrggbb
| Color Name
Задает цвет как значение цветовой модели RGB (red, green, blue) или RGBA (red, green, blue, alpha). Синтаксис rgb() или rgba() можно использовать вместе с целыми значениями от 0 до 255, или с процентными соотношениями.

Примеры:

         QLabel { border-color: red }                    /* непрозрачный красный */
         QLabel { border-color: #FF0000 }                /* непрозрачный красный */
         QLabel { border-color: rgba(255, 0, 0, 75%) }   /* 75% непрозрачный красный */
         QLabel { border-color: rgb(255, 0, 0) }         /* непрозрачный красный */
         QLabel { border-color: rgb(100%, 0%, 0%) }      /* непрозрачный красный */
Font (Font Style | Font Weight){0,2} Font Size StringСокращенное обозначение свойства font.
Font SizeLengthРазмер шрифта.
Font Stylenormal
| italic
| oblique
Стиль шрифта.
Font Weightnormal
| bold
| 100
| 200
...
| 900
Плотность шрифта.
Gradient qlineargradient
| qradialgradient
| qconicalgradient
Задает градиентную заливку. Имеется три типа градиентной заливки:
  • Линейные градиенты интерполируют цвета от начальной до конечной точки.
  • Радиальные градиенты интерполируют цвета между фокусом и точками на окружности вокруг нее.
  • Конические градиенты интерполируют цвета вокруг центральной точки.

Градиенты указываются в режиме ограничивающего прямоугольника объекта (Object Bounding Mode). Представьте себе прямоугольник, в котором визуализируется градиент, верхний левый угол которого находится в (0, 0), а нижний правый угол - в (1, 1). Параметры градиента в этом случае указываются как доля между 0 и 1. Эти значения экстраполируются на реальные координаты прямоугольника во время выполнения. Возможно задание значений, которые лежат вне ограничивающего прямоугольника (например, -0.6 или 1.8).

Предупреждение: Ограничители появляются отсортированными по возрастанию.

Примеры:

             /* линейный градиент от белого до зеленого */
             QTextEdit {
                 background: qlineargradient(x1:0, y1:0, x2:1, y2:1,
                             stop:0 white, stop: 0.4 gray, stop:1 green)
             }

             /* линейный градиент от белого до зеленого */
             QTextEdit {
                 background: qlineargradient(x1:0, y1:0, x2:1, y2:1,
                             stop:0 white, stop: 0.4 rgba(10, 20, 30, 40), stop:1 rgb(0, 200, 230, 200))
             }


             /* конический градиент от белого до зеленого */
             QTextEdit {
                 background: qconicalgradient(cx:0.5, cy:0.5, angle:30,
                             stop:0 white, stop:1 #00FF00)
             }

             /* радиальный градиент от белого до зеленого */
             QTextEdit {
                 background: qradialgradient(cx:0, cy:0, radius: 1,
                             fx:0.5, fy:0.5, stop:0 white, stop:1 green)
             }
Length Number (px | pt | em | ex)?Число, за которым следует единица измерения. Поддерживаемые единицы измерения:
  • px: пиксели (по умолчанию, когда единица измерения не указана)
  • pt: пункт (размер одной точки, т.е., 1/72 дюйма)
  • em: ширина буквы m шрифта (т.е., ширина 'M')
  • ex: высота буквы x шрифта (т.е., высота 'x')
Number Целое десятичное число или вещественное числоПримеры: 0, 18, +127, -255, 12.34, -.5, 0009.
Origin margin
| border
| padding
| content
Показывает какой из четырех прямоугольников использовать.
  • margin: Прямоугольник полей. Поля располагаются за пределами границы.
  • border: Прямоугольник границ. Здесь рисуются все границы.
  • padding: Прямоугольник заполнения. В отличие от полей, заполнитель находится внутри границы.
  • content: Прямоугольник содержимого. Он указывает, где находится реальное содержимое, исключая заполнитель, границу или поля.

Смотрите также Модель "коробки".

PaletteRole alternate-base
| base
| bright-text
| button
| button-text
| dark
| highlight
| highlighted-text
| light
| link
| link-visited
| mid
| mid-light
| shadow
| text
| window
| window-text
Эти значения соответствуют Ролям цвета в палитре QPalette виджета.

Например,

                 QPushButton { color: palette(dark); }
Radius Length{1, 2}От одного до двух вхождений Length. Если задана только одна длина, то она используется как радиус четвертинки окружности, определяя угол. Если заданы две длины, то первая из них - горизонтальный радиус четвертинки эллипса, тогда как вторая - вертикальный радиус.
Repeat repeat-x
| repeat-y
| repeat
| no-repeat
Значение, указывающее тип повторения.
  • repeat-x: Повторять горизонтально.
  • repeat-y: Повторять вертикально.
  • repeat: Повторять горизонтально и вертикально.
  • no-repeat: Не повторять.
Url url(filename)filename - имя файла на локальном диске или хранимого в Системе ресурсов Qt. Установка изображения неявно установит ширину и высоту элемента.

Список псевдо-состояний

Поддерживаются следующие псевдо-состояния:

Псевдо-состояниеОписание
:adjoins-item Это состояние установлено когда ветвь ::branch виджета QTreeView является смежной с элементом.
:bottom Элемент расположен внизу. Например, QTabBar у которого вкладки расположены внизу.
:checked Элемент отмечен. Например, состояние checked кнопки QAbstractButton.
:closed Элемент находится в закрытом состоянии. Например, нераскрытый элемент в QTreeView
:default Элемент является элементом по умолчанию. Например, свойство default кнопки QPushButton или действие по умолчанию в QMenu.
:disabled Элемент отключен.
:editable QComboBox является редактируемым.
:enabled Элемент включен.
:exclusive Элемент является частью взаимоисключающей (exclusive) группы элементов. Например, пункт меню взаимоисключающей QActionGroup.
:first Элемент является первым (в списке). Например, первая вкладка в QTabBar.
:flat Элемент является плоским (flat). Например, flat QPushButton.
:focus Элемент обладает фокусом ввода.
:has-children Элемент имеет дочерние элементы. Например, элемент в QTreeView, который имеет дочерние элементы.
:has-siblings Элемент имеет смежные элементы (siblings). Например, элемент в QTreeView, который имеет смежные элементы.
:horizontal Элемент имеет горизонтальную ориентацию.
:hover Мышь наведена на элемент.
:indeterminate Элемент имеет неопределенное состояние. Например, QCheckBox или QRadioButton являются частично отмечаемыми.
:last Элемент является последним (в списке). Например, последняя вкладка в QTabBar.
:left Элемент расположен слева. Например, QTabBar, у которой вкладки расположены слева.
:middle Элемент является средним (в списке). Например, вкладка не в начале и не в конце QTabBar'а.
:no-frame Элемент не имеет рамки. Например, QSpinBox или QLineEdit без рамки.
:non-exclusive Элемент является частью невзаимоисключающей (non-exclusive) группы элементов. Например, пункт меню в невзаимоисключающей QActionGroup.
:off Для переключаемых элементов, применяется к элементам в состоянии "off".
:on Для переключаемых элементов, применяется к виджетам в состоянии "on".
:only-one Элемент является единственным (в списке). Например, единственная вкладка в QTabBar.
:open Элемент находится в открытом состоянии. Например, развернутый элемент в QTreeView, или же QComboBox или QPushButton с раскрытым меню.
:next-selected Следующий элемент (в списке) выделен. Например, выделенная вкладка QTabBar является следующей по отношению к данной.
:pressed Элемент был нажат с помощью мыши.
:previous-selected Предыдущий элемент (в списке) выделен. Например, данная вкладка в QTabBar является следующей для выделенной вкладки.
:read-only Элемент помечен как только для чтения или нередактируемый. Например, QLineEdit только для чтения или нередактируемый QComboBox.
:right Элемент расположен справа. Например, QTabBar у которого вкладки расположены справа.
:selected Выделенный элемент. Например, выделенная вкладка в QTabBar или выделенный пункт меню в QMenu.
:top Элемент расположен вверху. Например, QTabBar у которого вкладки расположены вверху.
:unchecked Элемент не отмечен.
:vertical Элемент имеет вертикальную ориентацию.

Список субэлементов управления

Доступны следующие субэлементы управления:

Субэлемент управленияОписание
::add-line Кнопка для добавления линии в QScrollBar.
::add-page Область между рукояткой (ползунком) и кнопкой add-line QScrollBar.
::branch Индикатор ветви в QTreeView.
::chunk Чанк индикатора выполнения QProgressBar.
::down-arrow Стрелка вниз в QComboBox, QHeaderView (индикатор сортировки), QScrollBar или QSpinBox.
::down-button Кнопка прокрутки вниз в QScrollBar или QSpinBox.
::drop-down Кнопка выпадающего списка в QComboBox.
::groove Бороздка в QSlider.
::indicator Индикатор QCheckBox, QRadioButton, отмечаемый пункт меню QMenu или отмечаемый QGroupBox.
::handle Рукоятка (ползунок) QScrollBar или QSlider.
::item Элемент в QMenuBar, QMenu или QStatusBar.
::left-arrow Левая стрелка в QScrollBar.
::left-corner Левый угол в QTabWidget. Например, этот элемент управления можно использовать для контроля расположения левого угла виджета в QTabWidget.
::menu-arrow Стрелка в QToolButton с меню.
::menu-button Кнопка меню в QToolButton.
::menu-indicator Индикатор меню в QPushButton.
::right-arrow Правая стрелка в QMenu или QScrollBar.
::pane Панель (фрейм) QTabWidget.
::right-corner Правый угол в QTabWidget. Например, этот элемент управления можно использовать для контроля расположения правого угла виджета в QTabWidget.
::scroller Скроллер (scroller) в QMenu или QTabBar.
::section Секция в QHeaderView.
::separator Разделитель QMenu.
::sub-line Кнопка для вычитания линии в QScrollBar.
::sub-page Область между рукояткой (ползунком) и кнопкой sub-line QScrollBar.
::tab Вкладка в QTabBar или QToolBox.
::tab-bar Панель вкладок в QTabWidget. Этот субэлемент управления существует только для управления позицией QTabBar внутри QTabWidget. Для применения стиля к вкладкам используйте субэлемент управления ::tab.
::tear Индикатор разрыва в QTabBar.
::tear-off Индикатор разрыва в QMenu.
::title Заголовок QGroupBox.
::up-arrow Стрелка вверх в QHeaderView (индикатор сортировки), QScrollBar или QSpinBox.
::up-button Кнопка прокрутки вниз в QSpinBox.

Смотрите пример Настройка субэлемента управления индикатора меню QPushButton о том, как настраивать субэлемент управления.

[Предыдущая: Настройка виджетов Qt с использованием таблиц стилей] [Содержание] [Следующая: Примеры таблиц стилей Qt]


Copyright © 2008 Trolltech Торговые марки
Qt 4.3.5