Not a member of Pastebin yet?
Sign Up,
it unlocks many cool features!
- # Разбор: «рамки» вокруг ячеек в QTableView (alternatingRowColors + SelectRows) на Qt5 + KDE
- Тред: https://www.linux.org.ru/forum/development/18389093
- Дата разбора: 2026-09-28
- ## TL;DR
- Виновата **не Qt**. Рамки рисует **Qt5-плагин стиля Breeze (пакет `breeze5`)** из состава Plasma ≥ 6.7
- (коммит `aba0f922` «Make viewItemPrimitive rounded like in QtQuick style», 25.02.2026, и его семейство).
- В новом коде отрисовка фона «альтернативных» строк идёт через `Helper::renderViewItemPosition()`,
- и в ветке `QStyleOptionViewItem::Invalid` helper делает `painter->setPen(outline)`, где `outline` —
- неинициализированный `QColor()`. Перо с невалидным цветом рисуется **чёрным**; чёрный штрих 1px с
- антиалиасингом поверх лавандового фона `#b2b3ff` даёт ровно тот «полутон» `#59597f`, который виден
- на скриншоте. Qt6-представления заполняют `option.viewItemPosition` (Beginning/Middle/End при
- SelectRows) и попадают в ветку без обводки; **Qt5-представления не заполняют его никогда**
- (всегда `Invalid`, проверено зондом на Qt 5.15.15) — поэтому ломаются только Qt5-приложения.
- При `SelectItems` Breeze сам принудительно ставит `OnlyOne` → ветка без обводки → «эффекта нет»,
- что полностью совпадает с наблюдением автора треда. Обновились в сентябре не Qt, а `breeze5`
- (Arch/Manjaro: 6.7.5-1 от 2026-09-09; в Alt p11 — свой аналогичный апдейт plasma/breeze).
- ## Симптом и его декодирование
- Пиксель-анализ «плохого» скриншота (`alter-colors-bad.png`):
- * каждая ячейка «альтернативной» строки обведена прямоугольником 1px со всех четырёх сторон
- (вертикальные линии на всех границах колонок: x = 93, 192/193, 292/293, 392/393, 492;
- горизонтальные: y = 146, 175 для строки 2 и y = 206, 235 для строки 4);
- * цвет линии `#59597f` = 50 % чёрного поверх фона `#b2b3ff` (т.е. это чёрный штрих с покрытием
- ~50 % из-за антиалиасинга, а не «производный» цвет темы);
- * на «хороших» строках (1, 3) обводки нет.
- ## Цепочка причин (по коду)
- 1. **Breeze, коммит `aba0f922b7` (25.02.2026)** — `kstyle/breezestyle.cpp`,
- `Style::drawPanelItemViewItemPrimitive()`: отрисовку альтернативного фона заменили с
- `setPen(NoPen); drawRect(...)` на
- `_helper->renderViewItemPosition(painter, viewItemPosition, direction, option->rect, AlternateBase, QColor())`
- — outline передаётся как **дефолтный (невалидный) `QColor()`**.
- 2. **`Helper::renderViewItemPosition()`** (`kstyle/breezehelper.cpp`): в ветке
- `case QStyleOptionViewItem::Invalid:` делается `painter->setBrush(bg); painter->setPen(outline);
- painter->drawRect(rect);` — то есть пером становится невалидный цвет. Что `QColor()` в пере
- рисуется чёрным, известно и самим авторам: коммит-амendment `da3b2e9d` (02.06.2026) прямо говорит
- «The color this item was given could be just QColor(), which resolves into black color…»,
- но починил только случай кисти/фона, а перо в ветке `Invalid` осталось.
- 3. **Qt5 не заполняет `QStyleOptionViewItem::viewItemPosition`** (в qtbase 5.15 нет ни одной
- присваивающей строки; проверено зондом: `PE_PanelItemViewItem` приходит с `viewItemPosition = 0`
- (= `Invalid`) при любом selectionBehavior). Qt6 заполняет (Beginning/Middle/End при SelectRows) —
- эти ветки вызывают `renderFocusRect()` с `outline.isValid() == false` → `setPen(Qt::NoPen)` → чисто.
- 4. **Почему важен `SelectRows`**: в master-версии `breezestyle.cpp` есть
- `if (abstractItemView && abstractItemView->selectionBehavior() != QAbstractItemView::SelectRows)
- viewItemPosition = QStyleOptionViewItem::OnlyOne;` — а `OnlyOne` идёт через `renderFocusRect()`
- с невалидным outline → без обводки. Отсюда наблюдение «с SelectItems эффекта нет».
- 5. **Причём тут stylesheet**: ни при чём. QSS лишь задаёт яркий `AlternateBase` (`#b2b3ff`),
- на котором чёрная обводка заметна. Без QSS альтернативный цвет берётся из палитры темы
- (светлый), и получёрная обводка остаётся «серыми недорамками» — ровно как пишет автор.
- ## Почему «в августе было нормально, в сентябре сломалось»
- * В qtbase ветки kde/5.15 релевантных изменений нет: `qstylesheetstyle.cpp` не тронут с 10.2022,
- `qcommonstyle.cpp` — с 01.2023, в `qtableview.cpp` за 2026 год только коммит про sizeHint (20.05.2026).
- Локальная проверка: Qt 5.15.15 (Debian) + Fusion/Windows рисует «хорошую» картину (сплошные полосы).
- * Коммит `aba0f922` попал в релизную ветку Plasma 6.7 (июнь 2026). В Arch пакет **`breeze5`
- («Qt5 Breeze style»)** версии 6.7.5-1 собран **2026-09-09**; в Manjaro stable плазма этой волны
- приехала в середине сентября — точно в окно «уехал в отъезд / вернулся / обновился».
- В Alt p11 — аналогичный апдейт пакета breeze/plasma6. Qt 5.15.19 прилетела в Manjaro ещё в мае
- и сама по себе ничего не ломала — ломает стиль, который подхватывают Qt5-приложения в KDE.
- * Поэтому же «Qt 5.15.3 в старой Федоре» и «Qt4.8» в порядке: там либо старый Breeze без этого
- кода, либо вообще другой стиль.
- ## Проверено экспериментально (см. `lor/` в workspace)
- | Эксперимент | Результат |
- |---|---|
- | Qt 5.15.15, Fusion/Windows, offscreen-рендер того же кода | «хорошая» картина, рамок нет |
- | Зонд QProxyStyle: `viewItemPosition` в Qt 5.15 | всегда `0` (`Invalid`), и для SelectRows, и для SelectItems |
- | QPainter: `setPen(QColor())` + drawRect по лавандовой заливке | кромка `#59597f` — точное совпадение с цветом рамок на скриншоте |
- | Чтение master-кода breeze (`breezestyle.cpp:4746-4895`, `breezehelper.cpp:1692-1730`) | ветка `Invalid` → `setPen(outline=QColor())` → чёрная обводка; `OnlyOne`/`Beginning..End` → обводки нет |
- ## Что делать
- Обходные пути (приложение):
- 1. Не пользоваться Breeze для Qt5: `QApplication::setStyle("Fusion")` или переменная окружения
- `QT_STYLE_OVERRIDE=Fusion` (либо `Windows`). Ломающий код живёт только в стиле.
- 2. Рисовать фон ячеек самим через QSS-правила на субэлемент:
- `QTableView::item { background: #ffffff; } QTableView::item:alternate { background: #b2b3ff; }` —
- при наличии правила на `::item` панель рисует сам QStyleSheetStyle, минуя Breeze
- (но тогда придётся самостоятельно оформить и `::item:selected`).
- Обходные пути (система):
- 3. Откатить/закрепить пакет `breeze5` на версию ≤ 6.6.x (Manjaro: `pacman -U` старого пакета из кеша;
- в Alt — соответствующий пакет breeze из предыдущего обновления). Внешний вид Qt5-приложений
- вернётся к дореформенному.
- Куда репортить:
- 4. KDE Bugzilla, продукт **Breeze**, компонент QStyle: минимальный фикс — в
- `Helper::renderViewItemPosition()` ветки `Invalid` не ставить перо с невалидным цветом
- (`painter->setPen(outline.isValid() ? outline : Qt::NoPen);`), либо маппить `Invalid` в `OnlyOne`
- (Qt5 никогда не заполняет `viewItemPosition`). Полезно приложить ссылку на коммит `aba0f922`
- и отметить, что страдают все Qt5-приложения с item views (таблицы с SelectRows — наиболее заметно).
- Смежные баги той же серии: https://bugs.kde.org/523118 (элизия текста после того же коммита).
- ## Черновик ответа в тред (коротко)
- > Копать не в Qt, а в `breeze5` (Qt5-плагин стиля Breeze). Рамки — это чёрный штрих 1px с
- > антиалиасингом (поэтому цвет «половина от альтернативного»): после коммита aba0f922 (02.2026,
- > Plasma 6.7) альтернативный фон рисуется через Helper::renderViewItemPosition(), где в ветке
- > viewItemPosition == Invalid делается setPen(QColor()) — невалидный цвет пера рисуется чёрным.
- > Qt6-вьюхи заполняют viewItemPosition (Beginning/Middle/End), а Qt5 — никогда (всегда Invalid),
- > поэтому ломаются только Qt5-приложения; при SelectItems Breeze сам ставит OnlyOne и обводки нет —
- > всё сходится с наблюдениями. В сентябре в Manjaro/Alt обновился именно breeze5 (6.7.5-1 от 09.09.2026),
- > а не Qt. Обход: QT_STYLE_OVERRIDE=Fusion / setStyle("Fusion"), либо откат breeze5; фикс — одна строка
- > в breezehelper.cpp, стоит завести баг в KDE Bugzilla (Breeze/QStyle).
Advertisement
Add Comment
Please, Sign In to add comment