Каждый разработчик сталкивался с ситуацией, когда стандартных виджетов Qt уже недостаточно: интерфейс почти готов, но «мелочь» — нестандартное поведение, особый ввод или кастомная визуализация — превращается в источник компромиссов и костылей. Знакомо?
Эта глава аккуратно разрушает миф, что собственные элементы управления — это долго, сложно и рискованно. Здесь раскрывается, как разработчики проектируют виджеты так, чтобы они естественно вписывались в систему компоновок, корректно масштабировались и оставались пригодными для повторного использования. Вы обнаружите, что правильный выбор базового класса экономит часы работы.
Показаны практики наследования от QLineEdit и QFrame, работа с paintEvent(), sizeHint() и QSizePolicy, а также архитектура сигналов и слотов для многоразовых компонентов. Один реальный пример — и становится ясно, почему такой подход работает в разы стабильнее.
Пропустить эту главу — значит продолжать бороться с ограничениями стандартных решений, вместо того чтобы взять контроль над интерфейсом в свои руки.
В этой главе вы найдёте готовые к использованию примеры кода.
Самопроверка по главе
Почему выбор правильного базового класса критически важен при создании собственного виджета?Ответ
Правильный ответ: Удачно подобранный базовый класс уже содержит большинство необходимых свойств и методов, что существенно экономит время разработки и избавляет от необходимости реализовывать функциональность с нуля.
Что возвращает метод sizeHint() и как это используется системой компоновки?Ответ
Правильный ответ: Возвращает объект QSize с рекомендуемыми размерами виджета. Классы компоновки используют это значение для расчета оптимальных размеров виджета при размещении, интерпретируя его согласно политике QSizePolicy.
В чем разница между константами QSizePolicy::Expanding и QSizePolicy::Preferred?Ответ
Правильный ответ: Оба позволяют виджету растягиваться и сжиматься, но Expanding сообщает компоновке, что виджет предпочтительно растягивать и ему желательно предоставить максимум места, тогда как Preferred не имеет такого приоритета.
Почему в примере CustomWidget используются параметры QSizePolicy::Minimum для ширины и Fixed для высоты?Ответ
Правильный ответ: Minimum для ширины позволяет виджету растягиваться горизонтально, но не сжиматься меньше sizeHint(), а Fixed для высоты строго фиксирует высоту на значении sizeHint(), что подходит для индикатора прогресса.
Зачем отправлять сигнал progressChanged() в CustomWidget, если в примере никто к нему не подключается?Ответ
Правильный ответ: Это принцип проектирования многоразовых компонентов — виджет должен предоставлять сигналы для всех важных событий, чтобы его можно было использовать в других приложениях, где потребуется отслеживать изменения состояния.
Почему в Qt6 рекомендуется использовать update() вместо repaint() для перерисовки виджета?Ответ
Правильный ответ: Метод update() более эффективен, так как помещает запрос на перерисовку в очередь событий и позволяет оптимизировать несколько запросов, в то время как repaint() выполняет немедленную перерисовку.
Почему в методе paintEvent() примера CustomWidget вызов drawFrame() производится в самом конце?Ответ
Правильный ответ: Чтобы рамка отрисовывалась поверх всего содержимого виджета и не перекрывалась градиентом или текстом, обеспечивая правильный порядок слоев отрисовки.
Какую функцию выполняет std::clamp(n, 0, 100) в слоте slotSetProgress()?Ответ
Правильный ответ: Ограничивает значение n диапазоном от 0 до 100, гарантируя что значение индикатора прогресса не выйдет за допустимые пределы, упрощая проверку границ.
Почему QScrollArea использует политику QSizePolicy::Expanding в обоих направлениях?Ответ
Правильный ответ: Благодаря полосам прокрутки QScrollArea может работать с любым размером, но чем больше размер, тем удобнее пользоваться, поэтому Expanding сообщает компоновке предоставлять максимум доступного места.
Как обеспечить поддержку темной темы в собственном виджете вместо использования жестко закодированных цветов?Ответ
Правильный ответ: Использовать QPalette и получать цвета из текущей палитры виджета через palette().color(), например QPalette::Text, QPalette::Base, QPalette::Highlight, что автоматически адаптируется к теме.
В каких случаях атрибуты класса виджета стоит объявлять как protected вместо private?Ответ
Правильный ответ: Когда планируется дальнейшее наследование создаваемого класса виджета и производным классам потребуется доступ к внутренним данным базового класса.
Какие методы событий нужно переопределить для корректной работы виджета с фокусом клавиатуры?Ответ
Правильный ответ: Методы focusInEvent() для обработки получения фокуса и focusOutEvent() для обработки потери фокуса, что позволяет виджету реагировать на изменения состояния фокуса.
Если нужен виджет, который может растягиваться и сжиматься, но компоновка должна стремиться дать ему максимум места — какую политику выбрать?Ответ
Правильный ответ: QSizePolicy::MinimumExpanding (если есть минимальный размер) или QSizePolicy::Expanding (если минимального размера нет), так как эти политики указывают компоновке предоставлять как можно больше места.
Практические задания
Простой уровень
Виджет цветной метки
Создайте собственный виджет, наследующий QLabel, который отображает текст на цветном фоне с возможностью изменения цвета фона через публичный слот setBackgroundColor(QColor). Виджет должен корректно работать с компоновками и иметь разумные размеры.
Подсказки: Наследуйте QLabel для использования готовой функциональности текста. Переопределите paintEvent() для отрисовки цветного фона. Используйте palette().color(QPalette::Text) для цвета текста. Переопределите sizeHint() для возврата подходящего размера (например, 150×50).
Средний уровень
Интерактивный счетчик-индикатор
Разработайте виджет счетчика, который отображает числовое значение в виде заполняющегося круга (прогресс от 0 до 100). Виджет должен иметь слоты для увеличения/уменьшения значения, отправлять сигнал при изменении, корректно работать с темами оформления и поддерживать клики мышью для изменения значения.
Подсказки: Наследуйте QWidget. Переопределите paintEvent() с использованием QPainter::drawPie() для круга. Переопределите mousePressEvent() для интерактивности. Используйте QPalette для цветов. Определите сигнал valueChanged(int). Установите QSizePolicy::Fixed для обоих направлений, чтобы виджет оставался квадратным. Используйте std::clamp() для ограничения значений.
Сложный уровень
Многофункциональный виджет графика
Создайте виджет для отображения линейного графика с масштабированием и прокруткой. Виджет должен принимать массив точек данных, автоматически масштабироваться под размер окна, поддерживать темную и светлую темы, иметь настраиваемые цвета линий через слоты, отправлять сигнал при клике на точку данных и корректно работать в любых компоновках с политикой Expanding.
Подсказки: Наследуйте QWidget. Храните данные в QVector<QPointF>. Переопределите paintEvent() с масштабированием координат. Используйте QPainterPath для рисования линий. Переопределите mousePressEvent() и wheelEvent() для интерактивности. Реализуйте resizeEvent() для пересчета масштаба. Используйте palette() для всех цветов. Определите сигналы pointClicked(int) и dataChanged(). Установите setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding). Добавьте antialiasing через setRenderHint().
💬 Присоединяйтесь к обсуждению!
Разобрались с созданием собственных виджетов? Возникли вопросы о переопределении методов событий или работе с QSizePolicy?
Поделитесь своими виджетами, расскажите о трудностях при реализации paintEvent() или обсудите лучшие практики поддержки темной темы!