Guest User

Untitled

a guest
Sep 28th, 2026
166
0
Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 10.91 KB | None | 0 0
  1. # Разбор: «рамки» вокруг ячеек в QTableView (alternatingRowColors + SelectRows) на Qt5 + KDE
  2.  
  3. Тред: https://www.linux.org.ru/forum/development/18389093
  4. Дата разбора: 2026-09-28
  5.  
  6. ## TL;DR
  7.  
  8. Виновата **не Qt**. Рамки рисует **Qt5-плагин стиля Breeze (пакет `breeze5`)** из состава Plasma ≥ 6.7
  9. (коммит `aba0f922` «Make viewItemPrimitive rounded like in QtQuick style», 25.02.2026, и его семейство).
  10. В новом коде отрисовка фона «альтернативных» строк идёт через `Helper::renderViewItemPosition()`,
  11. и в ветке `QStyleOptionViewItem::Invalid` helper делает `painter->setPen(outline)`, где `outline` —
  12. неинициализированный `QColor()`. Перо с невалидным цветом рисуется **чёрным**; чёрный штрих 1px с
  13. антиалиасингом поверх лавандового фона `#b2b3ff` даёт ровно тот «полутон» `#59597f`, который виден
  14. на скриншоте. Qt6-представления заполняют `option.viewItemPosition` (Beginning/Middle/End при
  15. SelectRows) и попадают в ветку без обводки; **Qt5-представления не заполняют его никогда**
  16. (всегда `Invalid`, проверено зондом на Qt 5.15.15) — поэтому ломаются только Qt5-приложения.
  17. При `SelectItems` Breeze сам принудительно ставит `OnlyOne` → ветка без обводки → «эффекта нет»,
  18. что полностью совпадает с наблюдением автора треда. Обновились в сентябре не Qt, а `breeze5`
  19. (Arch/Manjaro: 6.7.5-1 от 2026-09-09; в Alt p11 — свой аналогичный апдейт plasma/breeze).
  20.  
  21. ## Симптом и его декодирование
  22.  
  23. Пиксель-анализ «плохого» скриншота (`alter-colors-bad.png`):
  24.  
  25. * каждая ячейка «альтернативной» строки обведена прямоугольником 1px со всех четырёх сторон
  26. (вертикальные линии на всех границах колонок: x = 93, 192/193, 292/293, 392/393, 492;
  27. горизонтальные: y = 146, 175 для строки 2 и y = 206, 235 для строки 4);
  28. * цвет линии `#59597f` = 50 % чёрного поверх фона `#b2b3ff` (т.е. это чёрный штрих с покрытием
  29. ~50 % из-за антиалиасинга, а не «производный» цвет темы);
  30. * на «хороших» строках (1, 3) обводки нет.
  31.  
  32. ## Цепочка причин (по коду)
  33.  
  34. 1. **Breeze, коммит `aba0f922b7` (25.02.2026)** — `kstyle/breezestyle.cpp`,
  35. `Style::drawPanelItemViewItemPrimitive()`: отрисовку альтернативного фона заменили с
  36. `setPen(NoPen); drawRect(...)` на
  37. `_helper->renderViewItemPosition(painter, viewItemPosition, direction, option->rect, AlternateBase, QColor())`
  38. — outline передаётся как **дефолтный (невалидный) `QColor()`**.
  39. 2. **`Helper::renderViewItemPosition()`** (`kstyle/breezehelper.cpp`): в ветке
  40. `case QStyleOptionViewItem::Invalid:` делается `painter->setBrush(bg); painter->setPen(outline);
  41. painter->drawRect(rect);` — то есть пером становится невалидный цвет. Что `QColor()` в пере
  42. рисуется чёрным, известно и самим авторам: коммит-амendment `da3b2e9d` (02.06.2026) прямо говорит
  43. «The color this item was given could be just QColor(), which resolves into black color…»,
  44. но починил только случай кисти/фона, а перо в ветке `Invalid` осталось.
  45. 3. **Qt5 не заполняет `QStyleOptionViewItem::viewItemPosition`** (в qtbase 5.15 нет ни одной
  46. присваивающей строки; проверено зондом: `PE_PanelItemViewItem` приходит с `viewItemPosition = 0`
  47. (= `Invalid`) при любом selectionBehavior). Qt6 заполняет (Beginning/Middle/End при SelectRows) —
  48. эти ветки вызывают `renderFocusRect()` с `outline.isValid() == false` → `setPen(Qt::NoPen)` → чисто.
  49. 4. **Почему важен `SelectRows`**: в master-версии `breezestyle.cpp` есть
  50. `if (abstractItemView && abstractItemView->selectionBehavior() != QAbstractItemView::SelectRows)
  51. viewItemPosition = QStyleOptionViewItem::OnlyOne;` — а `OnlyOne` идёт через `renderFocusRect()`
  52. с невалидным outline → без обводки. Отсюда наблюдение «с SelectItems эффекта нет».
  53. 5. **Причём тут stylesheet**: ни при чём. QSS лишь задаёт яркий `AlternateBase` (`#b2b3ff`),
  54. на котором чёрная обводка заметна. Без QSS альтернативный цвет берётся из палитры темы
  55. (светлый), и получёрная обводка остаётся «серыми недорамками» — ровно как пишет автор.
  56.  
  57. ## Почему «в августе было нормально, в сентябре сломалось»
  58.  
  59. * В qtbase ветки kde/5.15 релевантных изменений нет: `qstylesheetstyle.cpp` не тронут с 10.2022,
  60. `qcommonstyle.cpp` — с 01.2023, в `qtableview.cpp` за 2026 год только коммит про sizeHint (20.05.2026).
  61. Локальная проверка: Qt 5.15.15 (Debian) + Fusion/Windows рисует «хорошую» картину (сплошные полосы).
  62. * Коммит `aba0f922` попал в релизную ветку Plasma 6.7 (июнь 2026). В Arch пакет **`breeze5`
  63. («Qt5 Breeze style»)** версии 6.7.5-1 собран **2026-09-09**; в Manjaro stable плазма этой волны
  64. приехала в середине сентября — точно в окно «уехал в отъезд / вернулся / обновился».
  65. В Alt p11 — аналогичный апдейт пакета breeze/plasma6. Qt 5.15.19 прилетела в Manjaro ещё в мае
  66. и сама по себе ничего не ломала — ломает стиль, который подхватывают Qt5-приложения в KDE.
  67. * Поэтому же «Qt 5.15.3 в старой Федоре» и «Qt4.8» в порядке: там либо старый Breeze без этого
  68. кода, либо вообще другой стиль.
  69.  
  70. ## Проверено экспериментально (см. `lor/` в workspace)
  71.  
  72. | Эксперимент | Результат |
  73. |---|---|
  74. | Qt 5.15.15, Fusion/Windows, offscreen-рендер того же кода | «хорошая» картина, рамок нет |
  75. | Зонд QProxyStyle: `viewItemPosition` в Qt 5.15 | всегда `0` (`Invalid`), и для SelectRows, и для SelectItems |
  76. | QPainter: `setPen(QColor())` + drawRect по лавандовой заливке | кромка `#59597f` — точное совпадение с цветом рамок на скриншоте |
  77. | Чтение master-кода breeze (`breezestyle.cpp:4746-4895`, `breezehelper.cpp:1692-1730`) | ветка `Invalid` → `setPen(outline=QColor())` → чёрная обводка; `OnlyOne`/`Beginning..End` → обводки нет |
  78.  
  79. ## Что делать
  80.  
  81. Обходные пути (приложение):
  82. 1. Не пользоваться Breeze для Qt5: `QApplication::setStyle("Fusion")` или переменная окружения
  83. `QT_STYLE_OVERRIDE=Fusion` (либо `Windows`). Ломающий код живёт только в стиле.
  84. 2. Рисовать фон ячеек самим через QSS-правила на субэлемент:
  85. `QTableView::item { background: #ffffff; } QTableView::item:alternate { background: #b2b3ff; }` —
  86. при наличии правила на `::item` панель рисует сам QStyleSheetStyle, минуя Breeze
  87. (но тогда придётся самостоятельно оформить и `::item:selected`).
  88.  
  89. Обходные пути (система):
  90. 3. Откатить/закрепить пакет `breeze5` на версию ≤ 6.6.x (Manjaro: `pacman -U` старого пакета из кеша;
  91. в Alt — соответствующий пакет breeze из предыдущего обновления). Внешний вид Qt5-приложений
  92. вернётся к дореформенному.
  93.  
  94. Куда репортить:
  95. 4. KDE Bugzilla, продукт **Breeze**, компонент QStyle: минимальный фикс — в
  96. `Helper::renderViewItemPosition()` ветки `Invalid` не ставить перо с невалидным цветом
  97. (`painter->setPen(outline.isValid() ? outline : Qt::NoPen);`), либо маппить `Invalid` в `OnlyOne`
  98. (Qt5 никогда не заполняет `viewItemPosition`). Полезно приложить ссылку на коммит `aba0f922`
  99. и отметить, что страдают все Qt5-приложения с item views (таблицы с SelectRows — наиболее заметно).
  100. Смежные баги той же серии: https://bugs.kde.org/523118 (элизия текста после того же коммита).
  101.  
  102. ## Черновик ответа в тред (коротко)
  103.  
  104. > Копать не в Qt, а в `breeze5` (Qt5-плагин стиля Breeze). Рамки — это чёрный штрих 1px с
  105. > антиалиасингом (поэтому цвет «половина от альтернативного»): после коммита aba0f922 (02.2026,
  106. > Plasma 6.7) альтернативный фон рисуется через Helper::renderViewItemPosition(), где в ветке
  107. > viewItemPosition == Invalid делается setPen(QColor()) — невалидный цвет пера рисуется чёрным.
  108. > Qt6-вьюхи заполняют viewItemPosition (Beginning/Middle/End), а Qt5 — никогда (всегда Invalid),
  109. > поэтому ломаются только Qt5-приложения; при SelectItems Breeze сам ставит OnlyOne и обводки нет —
  110. > всё сходится с наблюдениями. В сентябре в Manjaro/Alt обновился именно breeze5 (6.7.5-1 от 09.09.2026),
  111. > а не Qt. Обход: QT_STYLE_OVERRIDE=Fusion / setStyle("Fusion"), либо откат breeze5; фикс — одна строка
  112. > в breezehelper.cpp, стоит завести баг в KDE Bugzilla (Breeze/QStyle).
  113.  
Advertisement
Add Comment
Please, Sign In to add comment