Класс QWidget

Класс QWidget является базовым классом всех объектов пользовательского интерфейса. Подробнее...

• Список всех членов, включая наследуемые
• Устаревшие члены

Публичные типы

Свойства

Публичные Функции

Реализованные публичные функции

Публичные слоты

Сигналы

Статические публичные члены

Защищенные функции

Переопределённые защищённые функции

Защищённые слоты

Макросы

Подробное описание

Виджет является атомом пользовательского интерфейса: он получает события мыши, клавиатуры и другие события от системы окон и рисует своё представление на экране. Каждый виджет прямоугольный, и они упорядочены по порядку Z. Виджет ограничивается своим родителем и виджетами, расположенными перед ним.

Виджет, не вложенный в родительский виджет, называется окном. Обычно окна имеют рамку и строку заголовка, хотя также возможно создать окна без такого оформления, используя соответствующие флаги окон. В Qt, QMainWindow и различные подклассы QDialog являются наиболее распространёнными типами окон.

Каждый конструктор виджета принимает один или два стандартных аргумента:

1. QWidget *parent = nullptr — родитель нового виджета. Если он равен nullptr (по умолчанию), новый виджет будет окном. В противном случае он будет дочерним элементом parent и будет ограничен геометрией parent (если вы не указали Qt::Window в качестве флага окна).
2. Qt::WindowFlags f = { } (если доступно) устанавливает флаги окна; значение по умолчанию подходит для почти всех виджетов, но для получения, например, окна без рамки системы окон, необходимо использовать специальные флаги.

QWidget имеет много функций-членов, но некоторые из них имеют мало прямой функциональности; например, QWidget имеет свойство шрифта, но никогда не использует его сам. Существуют многочисленные подклассы, которые обеспечивают реальную функциональность, такие как QLabel, QPushButton, QListWidget и QTabWidget.

Главные и дочерние виджеты

Виджет без родительского виджета всегда является независимым окном (главный виджет). Для этих виджетов setWindowTitle() и setWindowIcon() соответственно устанавливают строку заголовка и значок.

Виджеты, не являющиеся окнами, являются дочерними виджетами, отображаемыми внутри своих родительских виджетов. Большинство виджетов в Qt в основном полезны в качестве дочерних виджетов. Например, можно отобразить кнопку как главное окно, но большинство людей предпочитают размещать свои кнопки внутри других виджетов, таких как QDialog.

На диаграмме показан виджет QGroupBox, используемый для размещения различных дочерних виджетов в макете, предоставленном QGridLayout. Дочерние виджеты QLabel были выделены, чтобы показать их полные размеры.

Если вы хотите использовать QWidget для размещения дочерних виджетов, обычно вы хотите добавить макет в родительский QWidget. Более подробную информацию см. в разделе Управление макетами.

Композитные виджеты

Когда виджет используется в качестве контейнера для группирования ряда дочерних виджетов, он называется композитным виджетом. Их можно создать, создав виджет с необходимыми визуальными свойствами — например, QFrame — и добавив к нему дочерние виджеты, обычно управляемые макетом. На диаграмме выше показан такой композитный виджет, который был создан с помощью Qt Designer.

Композитные виджеты также можно создавать, наследуя стандартный виджет, такой как QWidget или QFrame, и добавляя необходимый макет и дочерние виджеты в конструктор подкласса. Многие из примеров, предоставленных с Qt, используют этот подход, и он также описан в руководствах Qt по учебникам.

Настраиваемые виджеты и рисование

Поскольку QWidget является подклассом QPaintDevice, подклассы могут использоваться для отображения пользовательского содержимого, которое формируется с помощью серии операций рисования с экземпляром класса QPainter. Этот подход отличается от подхода в стиле холста, используемого Графической системой просмотра, где элементы добавляются в сцену приложением и отрисовываются самой системой.

Каждый виджет выполняет все операции рисования внутри своей функции paintEvent(). Она вызывается всякий раз, когда виджет необходимо перерисовать, будь то в результате какого-либо внешнего изменения или по запросу приложения.

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

Рекомендации по размеру и политики размеров

При реализации нового виджета почти всегда полезно переопределить sizeHint() для задания разумного значения по умолчанию для размера виджета и установить правильную политику размера с помощью setSizePolicy().

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

Политика размера позволяет предоставить хорошее поведение по умолчанию для системы управления макетом, чтобы другие виджеты могли легко содержать и управлять вашим виджетом. Политика размера по умолчанию указывает, что рекомендация по размеру представляет собой предпочтительный размер виджета, и это часто достаточно хорошо подходит для многих виджетов.

События

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

Если ваш виджет содержит только дочерние виджеты, вам, вероятно, не нужно реализовывать какие-либо обработчики событий. Если вы хотите обнаружить щелчок мыши в дочернем виджете, вызовите функцию underMouse() дочернего виджета внутри функции mousePressEvent() виджета.

Пример рисования реализует более широкий набор событий для обработки перемещения мыши, нажатий кнопок и изменения размера окна.

Вам необходимо предоставить поведение и содержимое для ваших собственных виджетов, но вот краткий обзор событий, относящихся к QWidget, начиная с самых распространённых:

• paintEvent() вызывается всякий раз, когда виджет необходимо перерисовать. Каждый виджет, отображающий пользовательское содержимое, должен реализовывать его. Рисование с помощью QPainter может осуществляться только в paintEvent() или функции, вызываемой из paintEvent().
• resizeEvent() вызывается, когда виджет был изменён в размере.
• mousePressEvent() вызывается при нажатии кнопки мыши, когда указатель мыши находится внутри виджета или когда виджет захватил мышь с помощью grabMouse(). Нажатие мыши без её отпускания фактически эквивалентно вызову grabMouse().
• mouseReleaseEvent() вызывается при отпускании кнопки мыши. Виджет получает события отпускания мыши, когда он получил соответствующее событие нажатия мыши. Это означает, что если пользователь нажимает мышь внутри вашего виджета, затем перемещает мышь куда-то ещё, прежде чем отпустить кнопку мыши, ваш виджет получает событие отпускания. Существует одно исключение: если появляется всплывающее меню, пока удерживается кнопка мыши, это всплывающее меню немедленно захватывает события мыши.
• mouseDoubleClickEvent() вызывается, когда пользователь дважды щелкает в виджете. Если пользователь дважды щелкает, виджет получает событие нажатия мыши, событие отпускания мыши, (событие щелчка мыши), второе нажатие мыши, это событие и, наконец, второе событие отпускания мыши. (Также могут быть получены некоторые события перемещения мыши, если мышь не удерживается неподвижно в ходе этой операции.) Невозможно отличить щелчок от двойного щелчка до момента появления второго щелчка. (Вот одна из причин, почему большинство книг по GUI рекомендуют рассматривать двойной щелчок как расширение одиночного щелчка, а не как вызов другого действия.)

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

• keyPressEvent() вызывается всякий раз, когда нажимается клавиша, и снова, когда клавиша удерживается достаточно долго, чтобы произойти автоматическое повторение. Клавиши Tab и Shift+Tab передаются виджету только в том случае, если они не используются механизмами изменения фокуса. Чтобы принудительно обработать эти клавиши вашим виджетом, необходимо переопределить QWidget::event().
• focusInEvent() вызывается, когда виджет получает фокус клавиатуры (предполагается, что вы вызвали setFocusPolicy()). Хорошо разработанные виджеты обозначают, что они владеют фокусом клавиатуры ясным, но незаметным способом.
• focusOutEvent() вызывается, когда виджет теряет фокус клавиатуры.

Вам может потребоваться также переопределить некоторые менее распространённые обработчики событий:

• mouseMoveEvent() вызывается всякий раз, когда курсор мыши перемещается при нажатой кнопке мыши. Это может быть полезно при выполнении операций перетаскивания. Если вы вызовете setMouseTracking(true), вы получите события перемещения мыши даже при отсутствии нажатых кнопок. (См. также руководство Перетаскивание.)
• keyReleaseEvent() вызывается всякий раз, когда отпускается клавиша, а также при удерживании клавиши (если клавиша повторяется автоматически). В этом случае виджет получит пару событий отпуска и нажатия клавиши для каждого повторения. Клавиши Tab и Shift+Tab передаются виджету только в том случае, если они не используются механизмами изменения фокуса. Чтобы принудительно обработать эти клавиши вашим виджетом, необходимо переопределить QWidget::event().
• wheelEvent() вызывается всякий раз, когда пользователь прокручивает колесо мыши, а виджет имеет фокус.
• enterEvent() вызывается, когда курсор мыши входит в область экрана виджета. (Это не включает область экрана, принадлежащую любому из дочерних виджетов.)
• leaveEvent() вызывается, когда курсор мыши выходит из области экрана виджета. Если курсор попадает в дочерний виджет, это не вызовет leaveEvent().
• moveEvent() вызывается, когда виджет перемещен относительно его родителя.
• closeEvent() вызывается, когда пользователь закрывает виджет (или когда вызывается close()).

В документации для QEvent::Type также описаны некоторые довольно необычные события. Для обработки этих событий необходимо непосредственно переопределить event().

Встроенная реализация event() обрабатывает Tab и Shift+Tab (для перемещения фокуса клавиатуры) и передает большинство других событий одному из более специализированных обработчиков выше.

События и механизм их доставки описаны в Системе событий.

Группы функций и свойств

Стили виджетов

В дополнение к стандартным стилям виджетов для каждой платформы, виджеты также могут быть стилизованы в соответствии с правилами, указанными в таблице стилей. Эта функция позволяет настроить внешний вид конкретных виджетов, чтобы предоставить визуальные подсказки пользователям о их назначении. Например, кнопку можно стилизовать определенным образом, чтобы указать, что она выполняет деструктивное действие.

Использование таблиц стилей виджетов описано более подробно в документе Qt Style Sheets.

Прозрачность и буферизация

Начиная с Qt 4.0, QWidget автоматически выполняет двойную буферизацию своего рисования, поэтому нет необходимости писать код двойной буферизации в paintEvent() для предотвращения мерцания.

Начиная с Qt 4.1, содержимое родительских виджетов по умолчанию распространяется на каждый из их дочерних элементов, если не установлен Qt::WA_PaintOnScreen. Пользовательские виджеты могут использовать эту функцию для обновления нерегулярных областей (чтобы создать дочерние виджеты непрямоугольной формы) или рисования цветами с компонентом альфа, меньшим, чем полный. На следующей диаграмме показано, как атрибуты и свойства пользовательского виджета могут быть настроены для достижения различных эффектов.

На приведенной выше диаграмме показан полупрозрачный прямоугольный дочерний виджет с удаленной областью, созданный и добавленный в родительский виджет (виджет QLabel, отображающий пиксельную графику). Затем различные свойства и атрибуты виджета устанавливаются для достижения различных эффектов:

• Левый виджет не имеет дополнительных свойств или атрибутов виджета. Это состояние по умолчанию подходит для большинства пользовательских виджетов, использующих прозрачность, имеющих неправильную форму или не рисующих по всей своей области с непрозрачной кистью.
• Центральный виджет имеет установленное свойство autoFillBackground. Это свойство используется с пользовательскими виджетами, которые полагаются на виджет для предоставления фонового изображения по умолчанию и не рисуют по всей своей области с непрозрачной кистью.
• Правый виджет имеет установленный атрибут виджета Qt::WA_OpaquePaintEvent. Это указывает, что виджет будет рисовать по всей своей области непрозрачными цветами. Область виджета первоначально будет *неинициализированной*, представленной на диаграмме с красной диагональной сеткой, просвечивающейся через перерисованную область. Атрибут Qt::WA_OpaquePaintArea полезен для виджетов, которые нуждаются в быстром рисовании собственного специализированного содержимого и не нуждаются в фоновом изображении по умолчанию, заполненном цветом.

Для быстрого обновления пользовательских виджетов с простыми цветами фона, таких как виджеты для реального времени или графики, лучше определить подходящий цвет фона (используя setBackgroundRole() с ролью QPalette::Window), установить свойство autoFillBackground и реализовать только необходимую функциональность рисования в paintEvent() виджета.

Для быстрого обновления пользовательских виджетов, которые постоянно рисуют по всей своей области непрозрачным содержимым, например, виджетов потокового видео, лучше установить атрибут виджета Qt::WA_OpaquePaintEvent, избегая ненужной накладной, связанной с перерисовкой фона виджета.

Если у виджета есть атрибут виджета Qt::WA_OpaquePaintEvent *и* свойство autoFillBackground, атрибут Qt::WA_OpaquePaintEvent имеет приоритет. В зависимости от ваших потребностей, вы должны выбрать один из них.

Начиная с Qt 4.1, содержимое родительских виджетов также распространяется на стандартные виджеты Qt. Это может привести к некоторым неожиданным результатам, если родительский виджет оформлен нестандартным образом, как показано на диаграмме ниже.

Возможности настройки поведения рисования стандартных виджетов Qt без использования подклассов несколько меньше, чем у пользовательских виджетов. Обычно желаемый внешний вид стандартного виджета можно получить, установив его свойство autoFillBackground.

Создание прозрачных окон

Начиная с Qt 4.5, стало возможным создавать окна с прозрачными областями на системах окон, поддерживающих композицию.

Чтобы включить эту функцию в верхнем виджете, установите его атрибут Qt::WA_TranslucentBackground с помощью setAttribute() и убедитесь, что его фон нарисован непрозрачными цветами в областях, которые вы хотите сделать частично прозрачными.

Примечания к платформе:

• X11: Эта функция использует сервер X, поддерживающий визуальные эффекты ARGB и менеджер композиции окон.
• Windows: Для работы с полупрозрачностью виджету необходимо установить флаг окна Qt::FramelessWindowHint.
• macOS: Для работы с полупрозрачностью виджету необходимо установить флаг окна Qt::FramelessWindowHint.

Родные виджеты против сторонних виджетов

Введённые в Qt 4.4, сторонние виджеты — это виджеты, неизвестные системе окон. У них нет связанной с ними родной дескриптора окна. Эта функция значительно ускоряет отрисовку, изменение размера виджетов и устраняет мерцание.

Если вам требуется старое поведение с родными окнами, вы можете выбрать один из следующих вариантов:

1. Используйте QT_USE_NATIVE_WINDOWS=1 в вашей среде.
2. Установите атрибут Qt::AA_NativeWindows в своём приложении. Все виджеты будут родными.
3. Установите атрибут Qt::WA_NativeWindow на виджетах: сам виджет и все его предки станут родными (если не установлен Qt::WA_DontCreateNativeAncestors).
4. Вызовите QWidget::winId, чтобы принудительно использовать родное окно (это подразумевает пункт 3).
5. Установите атрибут Qt::WA_PaintOnScreen, чтобы принудительно использовать родное окно (это подразумевает пункт 3).

См. также QEvent, QPainter, QGridLayout и QBoxLayout.

Документация по типам членов

Перечисление QWidget::RenderFlagflags QWidget::RenderFlags

Это перечисление описывает, как отобразить виджет при вызове QWidget::render().

Тип RenderFlags — это typedef для QFlags<RenderFlag>. Он хранит логическое ИЛИ сочетание значений RenderFlag.

setCursor(Qt::IBeamCursor);

width = baseSize().width() + i * sizeIncrement().width();
height = baseSize().height() + j * sizeIncrement().height();

setUpdatesEnabled(false);
bigVisualChanges();
setUpdatesEnabled(true);

Документация по функциям-членам

QWidget::QWidget(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

Создаёт виджет, являющийся дочерним элементом parent, со свойствами виджета, заданными в f.

Если parent равен nullptr, новый виджет становится окном. Если parent — это другой виджет, этот виджет становится дочерним окном внутри parent. Новый виджет удаляется при удалении его parent.

Аргумент флагов виджета, f, обычно равен 0, но может быть настроен для изменения рамки окна (то есть, parent должен быть nullptr). Для настройки рамки используйте значение, составленное из побитового ИЛИ любых из флагов окна.

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

Обратите внимание, что версия Qt для X11 может не поддерживать все комбинации флагов стиля на всех системах. Это связано с тем, что в X11 Qt может только запросить у менеджера окон, а менеджер окон может переопределить настройки приложения. В Windows Qt может устанавливать любые нужные флаги.

См. также windowFlags.

[slot] bool QWidget::close()

Закрывает этот виджет. Возвращает true, если виджет был закрыт; в противном случае возвращает false.

Сначала виджету отправляется событие QCloseEvent. Виджет скрывается, если он принимает событие закрытия. Если он игнорирует событие, ничего не происходит. По умолчанию реализация QWidget::closeEvent() принимает событие закрытия.

Если у виджета установлен флаг Qt::WA_DeleteOnClose, виджет также удаляется. Событие закрытия доставляется виджету независимо от того, виден ли он или нет.

Сигнал QGuiApplication::lastWindowClosed() генерируется, когда последнее видимое основное окно (то есть окно без родителя) с установленным атрибутом Qt::WA_QuitOnClose закрывается. По умолчанию этот атрибут установлен для всех виджетов, кроме временных окон, таких как всплывающие экраны, инструменты и всплывающие меню.

[signal] void QWidget::customContextMenuRequested(const QPoint &pos)

Этот сигнал генерируется, когда политика контекстного меню виджета contextMenuPolicy имеет значение Qt::CustomContextMenu, и пользователь запросил контекстное меню на виджете. Позиция pos — это позиция события контекстного меню, полученного виджетом. Обычно это координаты в системе координат виджета. Исключение составляют QAbstractScrollArea и его подклассы, которые отображают событие контекстного меню в координатах области просмотра viewport().

См. также mapToGlobal(), QMenu и contextMenuPolicy.

[slot] void QWidget::hide()

Скрывает виджет. Эта функция эквивалентна setVisible(false).

См. также hideEvent(), isHidden(), show(), setVisible(), isVisible(), и close().

[slot] void QWidget::lower()

Перемещает виджет в низ стека виджетов родительского виджета.

После этого вызова виджет будет визуально расположен ниже (и, следовательно, будет скрыт) любых перекрывающих его соседних виджетов.

См. также raise() и stackUnder().

[slot] void QWidget::raise()

Перемещает этот виджет наверх стека виджетов родительского виджета.

После этого вызова виджет будет визуально расположен поверх любых перекрывающих его соседних виджетов.

См. также lower() и stackUnder().

[slot] void QWidget::repaint()

Перерисовывает виджет напрямую, вызывая paintEvent() немедленно, если обновления не отключены и виджет не скрыт.

Мы рекомендуем использовать repaint() только если вам нужно немедленное перерисовывание, например, во время анимации. В почти всех случаях update() лучше, так как он позволяет Qt оптимизировать скорость и свести к минимуму мерцание.

См. также update(), paintEvent() и setUpdatesEnabled().

[slot] void QWidget::setDisabled(bool disable)

Отключает события ввода виджета, если disable имеет значение true; в противном случае включает события ввода.

См. документацию enabled для получения дополнительной информации.

См. также isEnabledTo(), QKeyEvent, QMouseEvent и changeEvent().

[slot] void QWidget::setFocus()

Это перегруженная функция.

Передает фокус ввода с клавиатуры этому виджету (или его прокси-фокуса), если этот виджет или один из его родителей является активным окном.

[slot] void QWidget::setHidden(bool hidden)

Функция-утилита, эквивалентная setVisible(!hidden).

См. также isHidden().

[slot] void QWidget::show()

Отображает виджет и его дочерние виджеты.

Это эквивалентно вызову showFullScreen(), showMaximized() или setVisible(true), в зависимости от стандартного поведения платформы для флагов окна.

См. также raise(), showEvent(), hide(), setVisible(), showMinimized(), showMaximized(), showNormal(), isVisible() и windowFlags().

[slot] void QWidget::showFullScreen()

Отображает виджет в полноэкранном режиме.

Вызов этой функции влияет только на окна.

Чтобы выйти из полноэкранного режима, вызовите showNormal() или close().

Альтернативой было бы полностью обойти диспетчер окон и создать окно с флагом Qt::X11BypassWindowManagerHint. Однако это приводит к другим серьёзным проблемам, таким как полная поломка фокуса клавиатуры и очень странные эффекты при изменениях рабочего стола или при поднятии других окон.

Диспетчеры окон X11, которые следуют современным спецификациям после ICCCM, правильно поддерживают полноэкранный режим.

При показе окна во весь экран на macOS всё приложение переходит в полноэкранный режим, получая выделенный рабочий стол. При запуске приложения в полноэкранном режиме показ другого окна может автоматически перевести это окно в полноэкранный режим. Чтобы этого избежать, выйдите из полноэкранного режима, вызвав showNormal() или close() для полноэкранного окна перед показом другого окна.

См. также showNormal(), showMaximized(), show(), isVisible() и close().

[slot] void QWidget::showMaximized()

Максимизирует виджет.

Вызов этой функции влияет только на окна.

В X11 эта функция может работать неправильно с некоторыми диспетчерами окон. См. документацию Геометрия окна для объяснения.

См. также setWindowState(), showNormal(), showMinimized(), show(), hide() и isVisible().

[slot] void QWidget::showMinimized()

Минимизирует виджет, отображая его в виде значка.

Вызов этой функции влияет только на окна.

См. также showNormal(), showMaximized(), show(), hide(), isVisible() и isMinimized().

[slot] void QWidget::showNormal()

Восстанавливает виджет после его максимизации или минимизации.

Вызов этой функции влияет только на окна.

См. также setWindowState(), showMinimized(), showMaximized(), show(), hide() и isVisible().

[slot] void QWidget::update()

Обновляет виджет, если обновления не отключены и виджет не скрыт.

Эта функция не вызывает немедленного перерисовки; вместо этого она планирует событие рисования для обработки, когда Qt возвращается в основной цикл событий. Это позволяет Qt оптимизировать скорость и минимизировать мерцание по сравнению с вызовом repaint().

Вызов update() несколько раз обычно приводит к одному вызову paintEvent().

Qt обычно очищает область виджета перед вызовом paintEvent(). Если установлен атрибут виджета Qt::WA_OpaquePaintEvent, виджет отвечает за рисование всех своих пикселей непрозрачным цветом.

См. также repaint(), paintEvent(), setUpdatesEnabled() и Пример аналоговых часов.

[protected slot] void QWidget::updateMicroFocus(Qt::InputMethodQuery query = Qt::ImQueryAll)

Обновляет микрофокус виджета и информирует методы ввода о том, что состояние, указанное в query, изменилось.

[signal, since 5.2] void QWidget::windowIconChanged(const QIcon &icon)

Этот сигнал излучается при изменении значка окна с новым значком icon в качестве аргумента.

Примечание: Сигнал-уведомление для свойства windowIcon.

Функция была введена в Qt 5.2.

[signal, since 5.2] void QWidget::windowTitleChanged(const QString &title)

Этот сигнал излучается при изменении заголовка окна с новым заголовком title в качестве аргумента.

Примечание: Сигнал-уведомление для свойства windowTitle.

Функция была введена в Qt 5.2.

[virtual] QWidget::~QWidget()

Удаляет виджет.

Сначала удаляются все дочерние элементы этого виджета. Приложение завершается, если этот виджет является основным.

[virtual protected] void QWidget::actionEvent(QActionEvent *event)

Этот обработчик событий вызывается с заданным событием event всякий раз, когда действия виджета изменяются.

См. также addAction(), insertAction(), removeAction(), actions() и QActionEvent.

QList<QAction *> QWidget::actions() const

Возвращает (возможно, пустой) список действий этого виджета.

См. также contextMenuPolicy, insertAction() и removeAction().

void QWidget::activateWindow()

Устанавливает верхнеуровневый виджет, содержащий этот виджет, в качестве активного окна.

Активное окно — это видимое верхнеуровневое окно, имеющее фокус ввода с клавиатуры.

Эта функция выполняет ту же операцию, что и щелчок мышью по строке заголовка верхнеуровневого окна. В X11 результат зависит от менеджера окон. Если вы хотите убедиться, что окно также расположено поверх других, необходимо также вызвать raise(). Обратите внимание, что окно должно быть видимым; в противном случае activateWindow() не оказывает никакого эффекта.

В Windows, если вы вызываете эту функцию, когда приложение не является активным, оно не станет активным окном. Будет изменено значение записи в панели задач, чтобы указать, что окно изменилось каким-либо образом. Это происходит потому, что Microsoft не позволяет приложению прерывать текущую работу пользователя в другом приложении.

См. также isActiveWindow(), window() и show().

void QWidget::addAction(QAction *action)

Добавляет действие action в список действий этого виджета.

Все QWidgets имеют список QActions, однако они могут быть представлены графически различными способами. По умолчанию список QAction (возвращаемый actions()) используется для создания контекстного QMenu.

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

Владение action не передается этому QWidget.

См. также removeAction(), insertAction(), actions() и QMenu.

void QWidget::addActions(const QList<QAction *> &actions)

Добавляет действия actions в список действий этого виджета.

См. также removeAction(), QMenu и addAction().

void QWidget::adjustSize()

Настраивает размер виджета, чтобы он соответствовал его содержимому.

Эта функция использует sizeHint(), если она действительна, т.е., ширина и высота подсказки размера не меньше 0. В противном случае, она устанавливает размер на прямоугольник детей, охватывающий все виджеты-потомки (объединение всех прямоугольников виджетов-потомков).

Для окон также учитывается размер экрана. Если sizeHint() меньше (200, 100) и политика размера — расширяющаяся, окно будет как минимум (200, 100). Максимальный размер окна составляет 2/3 ширины и высоты экрана.

См. также sizeHint() и childrenRect().

QPalette::ColorRole QWidget::backgroundRole() const

Возвращает роль фона виджета.

Роль фона определяет кисть из palette виджета, используемую для отрисовки фона.

Если роль фона не установлена явно, виджет наследует роль фона своего родительского виджета.

См. также setBackgroundRole() и foregroundRole().

QBackingStore *QWidget::backingStore() const

Возвращает QBackingStore, в который будет отрисовываться этот виджет.

Эта функция была добавлена в Qt 5.0.

void QWidget::changeEvent(QEvent *event)

Этот обработчик событий можно переопределить для обработки изменений состояния.

Изменяемое состояние в этом событии можно получить через переданный event.

События изменения включают: QEvent::ToolBarChange, QEvent::ActivationChange, QEvent::EnabledChange, QEvent::FontChange, QEvent::StyleChange, QEvent::PaletteChange, QEvent::WindowTitleChange, QEvent::IconTextChange, QEvent::ModifiedChange, QEvent::MouseTrackingChange, QEvent::ParentChange, QEvent::WindowStateChange, QEvent::LanguageChange, QEvent::LocaleChange, QEvent::LayoutDirectionChange, QEvent::ReadOnlyChange.

QWidget *QWidget::childAt(int x, int y) const

Возвращает видимый дочерний виджет по координатам (x, y) в системе координат виджета. Если видимого дочернего виджета по указанным координатам нет, функция возвращает nullptr.

QWidget *QWidget::childAt(const QPoint &p) const

Это перегруженная функция.

Возвращает видимый дочерний виджет в точке p в собственной системе координат виджета.

void QWidget::clearFocus()

Убирает фокус клавиатуры с виджета.

Если у виджета был активный фокус, в этот виджет отправляется событие focus out event, сигнализирующее о потере фокуса.

Для получения фокуса клавиатуры виджет должен включить установку фокуса, т.е. вызвать setFocusPolicy().

См. также hasFocus(), setFocus(), focusInEvent(), focusOutEvent(), setFocusPolicy(), и QApplication::focusWidget().

void QWidget::clearMask()

Удаляет любую маску, установленную с помощью setMask().

См. также setMask().

[virtual protected] void QWidget::closeEvent(QCloseEvent *event)

Обработчик этого события вызывается с заданным событием event, когда Qt получает запрос на закрытие окна для верхнего виджета из системы окон.

По умолчанию, событие принимается, и виджет закрывается. Вы можете переопределить эту функцию, чтобы изменить способ реакции виджета на запросы закрытия окна. Например, вы можете предотвратить закрытие окна, вызвав ignore() для всех событий.

Приложения с главными окнами обычно используют переопределения этой функции для проверки, были ли сохранены данные пользователя, и запроса разрешения на закрытие перед закрытием. Например, Qt Widgets - Пример приложения использует вспомогательную функцию для определения того, следует ли закрывать окно:

void MainWindow::closeEvent(QCloseEvent *event)
{
    if (maybeSave()) {
        writeSettings();
        event->accept();
    } else {
        event->ignore();
    }
}

См. также event(), hide(), close(), QCloseEvent, и Qt Widgets - Пример приложения.

QMargins QWidget::contentsMargins() const

Функция contentsMargins возвращает отступы содержимого виджета.

См. также setContentsMargins() и contentsRect().

QRect QWidget::contentsRect() const

Возвращает область внутри отступов виджета.

См. также setContentsMargins() и contentsMargins().

[virtual protected] void QWidget::contextMenuEvent(QContextMenuEvent *event)

Этот обработчик событий, для события event, может быть переопределён в подклассе для получения событий контекстного меню виджета.

Обработчик вызывается, когда политика контекстного меню виджета contextMenuPolicy имеет значение Qt::DefaultContextMenu.

По умолчанию обработчик игнорирует событие контекстного меню. Дополнительные сведения см. в документации к QContextMenuEvent.

См. также event(), QContextMenuEvent, и customContextMenuRequested().

[protected] void QWidget::create(WId window = 0, bool initializeWindow = true, bool destroyOldWindow = true)

Создаёт новое окно виджета.

Параметры window, initializeWindow и destroyOldWindow игнорируются в Qt 5. Используйте QWindow::fromWinId() для создания QWindow, оборачивающего внешнее окно, и передайте его в QWidget::createWindowContainer().

См. также createWindowContainer() и QWindow::fromWinId().

[static] QWidget *QWidget::createWindowContainer(QWindow *window, QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Создаёт QWidget, который позволяет встроить window в приложение на основе QWidget.

Контейнер окна создаётся как дочерний элемент parent и с флагами окна flags.

После того, как окно было встроено в контейнер, контейнер будет управлять геометрией и видимостью окна. Явные вызовы QWindow::setGeometry(), QWindow::show() или QWindow::hide() для встроенного окна не рекомендуются.

Контейнер берёт на себя владение window. Окно можно удалить из контейнера окна с помощью вызова QWindow::setParent().

Контейнер окна прикрепляется как родственное дочернее окно к главному окну, дочерним элементом которого он является. Когда контейнер окна используется в качестве дочернего элемента QAbstractScrollArea или QMdiArea, он создаст родственное окно для каждого виджета в цепочке предков, чтобы обеспечить правильное расположение и обрезку в этом случае. Создание родственного окна для контейнера окна также позволяет обеспечить правильное расположение и обрезку. Это должно быть выполнено перед отображением контейнера окна. Приложения с множеством родственных дочерних окон могут столкнуться с проблемами производительности.

Контейнер окна имеет ряд известных ограничений:

• Порядок стеков; Встроенное окно будет расположено поверх иерархии виджетов как непрозрачный прямоугольник. Порядок стеков нескольких перекрывающихся экземпляров контейнера окон не определён.
• Интеграция рендеринга; Контейнер окна не взаимодействует с QGraphicsProxyWidget, QWidget::render() или подобной функциональностью.
• Обработка фокуса; Можно разрешить экземпляру контейнера окна иметь любую политику фокуса, и он делегирует фокус окну с помощью вызова QWindow::requestActivate(). Однако возврат к обычной цепочке фокуса из экземпляра QWindow будет зависеть от реализации самого экземпляра QWindow. Например, при входе в окно на основе Qt Quick с фокусом на вкладке весьма вероятно, что последующие нажатия вкладок будут циклически проходить только внутри приложения QML. Кроме того, фактически ли QWindow::requestActivate() даёт фокус окну, зависит от платформы.
• Использование множества экземпляров контейнеров окон в приложении на основе QWidget может значительно ухудшить общую производительность приложения.

[protected] void QWidget::destroy(bool destroyWindow = true, bool destroySubWindows = true)

Освобождает системные ресурсы окна. Уничтожает окно виджета, если destroyWindow равно true.

destroy() рекурсивно вызывает себя для всех дочерних виджетов, передавая destroySubWindows в качестве параметра destroyWindow. Чтобы иметь больший контроль над уничтожением дочерних виджетов, сначала уничтожьте дочерние виджеты выборочно.

Эта функция обычно вызывается из деструктора QWidget.

[virtual protected] void QWidget::dragEnterEvent(QDragEnterEvent *event)

Этот обработчик событий вызывается, когда перетаскивание выполняется, и указатель мыши входит в этот виджет. Событие передаётся в параметре event.

Если событие игнорируется, виджет не получит никаких событий перетаскивания.

См. документацию по перетаскиванию для обзора того, как предоставить перетаскивание в вашем приложении.

См. также QDrag и QDragEnterEvent.

[virtual protected] void QWidget::dragLeaveEvent(QDragLeaveEvent *event)

Этот обработчик событий вызывается, когда перетаскивание выполняется, и указатель мыши покидает этот виджет. Событие передаётся в параметре event.

См. документацию по перетаскиванию для обзора того, как предоставить перетаскивание в вашем приложении.

См. также QDrag и QDragLeaveEvent.

[virtual protected] void QWidget::dragMoveEvent(QDragMoveEvent *event)

Обработчик событий вызывается, если выполняется перетаскивание, и когда выполняются следующие условия: курсор входит в этот виджет, курсор перемещается внутри этого виджета или нажата клавиша модификатора на клавиатуре, когда у этого виджета есть фокус. Событие передается в параметре event.

См. документацию по перетаскиванию и пасьванию для общего обзора того, как обеспечить перетаскивание и пасьвание в вашем приложении.

См. также QDrag и QDragMoveEvent.

[virtual protected] void QWidget::dropEvent(QDropEvent *event)

Этот обработчик событий вызывается, когда перетаскивание завершается над этим виджетом. Событие передается в параметре event.

См. документацию по перетаскиванию и пасьванию для общего обзора того, как обеспечить перетаскивание и пасьвание в вашем приложении.

См. также QDrag и QDropEvent.

WId QWidget::effectiveWinId() const

Возвращает идентификатор эффективного окна системы для виджета, т.е. идентификатор окна родительского виджета в системе.

Если виджет является нативным, эта функция возвращает ID нативного виджета. В противном случае возвращается ID окна первого нативного родительского виджета, т.е. виджета верхнего уровня, содержащего этот виджет.

См. также nativeParentWidget().

void QWidget::ensurePolished() const

Обеспечивает, что виджет и его дочерние элементы отполированы с помощью QStyle (т.е., имеют правильный шрифт и палитру).

QWidget вызывает эту функцию после того, как он был полностью сконструирован, но перед первым отображением. Вы можете вызвать эту функцию, если хотите убедиться, что виджет отполирован перед выполнением операции, например, для корректного размера шрифта может потребоваться переопределение sizeHint() в виджете. Обратите внимание, что эта функция вызывается из стандартной реализации sizeHint().

Полировка полезна для окончательной инициализации, которая должна выполняться после вызова всех конструкторов (как из базовых классов, так и из подклассов).

Если вам нужно изменить некоторые настройки при полировке виджета, переопределите event() и обработайте тип события QEvent::Polish.

Примечание: Функция объявлена как const, чтобы ее можно было вызывать из других константных функций (например, sizeHint()).

См. также event().

[virtual protected] void QWidget::enterEvent(QEnterEvent *event)

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

Событие отправляется виджету, когда курсор мыши входит в виджет.

См. также leaveEvent(), mouseMoveEvent() и event().

[override virtual protected] bool QWidget::event(QEvent *event)

Переопределяет: QObject::event(QEvent *e).

Это основной обработчик событий; он обрабатывает событие event. Вы можете переопределить эту функцию в подклассе, но рекомендуется использовать один из специализированных обработчиков событий.

События нажатия и отпуска клавиш обрабатываются по-разному по сравнению с другими событиями. event() проверяет нажатия Tab и Shift+Tab и пытается соответствующим образом переместить фокус. Если нет виджета, на который можно переместить фокус (или нажатая клавиша не Tab или Shift+Tab), event() вызывает keyPressEvent().

Обработка событий мыши и планшета также немного специфична: только когда виджет включен, event() вызовет специализированные обработчики, такие как mousePressEvent(); в противном случае он отбросит событие.

Эта функция возвращает true, если событие было распознано, в противном случае она возвращает false. Если распознанное событие было принято (см. QEvent::accepted), любая дальнейшая обработка, такая как распространение события на родительский виджет, прекращается.

См. также closeEvent(), focusInEvent(), focusOutEvent(), enterEvent(), keyPressEvent(), keyReleaseEvent(), leaveEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), mousePressEvent(), mouseReleaseEvent(), moveEvent(), paintEvent(), resizeEvent(), QObject::event(), и QObject::timerEvent().

[static] QWidget *QWidget::find(WId id)

Возвращает указатель на виджет с идентификатором/дескриптором окна id.

Тип идентификатора окна зависит от используемой системной среды, см. qwindowdefs.h для определения. Если виджет с данным идентификатором отсутствует, возвращается nullptr.

[virtual protected] void QWidget::focusInEvent(QFocusEvent *event)

Обработчик событий может быть переопределён в подклассе для получения событий ввода фокуса (получение фокуса) для виджета. Событие передаётся в параметре event.

Виджет обычно должен установить setFocusPolicy() на значение, отличное от Qt::NoFocus, для получения событий фокуса. (Обратите внимание, что программист приложения может вызвать setFocus() для любого виджета, даже для тех, которые обычно не принимают фокус.)

Реализация по умолчанию обновляет виджет (кроме окон, не указывающих focusPolicy()).

См. также focusOutEvent(), setFocusPolicy(), keyPressEvent(), keyReleaseEvent(), event(), и QFocusEvent.

[protected] bool QWidget::focusNextChild()

Находит новый виджет для получения фокуса клавиатуры, соответствующий клавише Tab, и возвращает true, если новый виджет найден, или false, если нет.

См. также focusPreviousChild().

[virtual protected] bool QWidget::focusNextPrevChild(bool next)

Находит новый виджет для получения фокуса клавиатуры, соответствующий клавишам Tab и Shift+Tab, и возвращает true, если новый виджет найден, или false, если нет.

Если next равно true, функция ищет вперёд, если next равно false, ищет назад.

Иногда требуется переопределить эту функцию. Например, веб-браузер может переопределить её, чтобы переместить "текущую активную ссылку" вперёд или назад, а затем вызвать focusNextPrevChild() только когда достигает последней или первой ссылки на "странице".

Дочерние виджеты вызывают focusNextPrevChild() на своих родительских виджетах, но только окно, содержащее дочерние виджеты, решает, куда перенаправить фокус. Переопределяя эту функцию для объекта, вы получаете контроль над перемещением фокуса для всех дочерних виджетов.

См. также focusNextChild() и focusPreviousChild().

[virtual protected] void QWidget::focusOutEvent(QFocusEvent *event)

Обработчик событий может быть переопределён в подклассе для получения событий выхода из фокуса (потеря фокуса) для виджета. Событие передаётся в параметре event.

Виджет обычно должен установить setFocusPolicy() на значение, отличное от Qt::NoFocus, для получения событий фокуса. (Обратите внимание, что программист приложения может вызвать setFocus() для любого виджета, даже для тех, которые обычно не принимают фокус.)

Реализация по умолчанию обновляет виджет (кроме окон, не указывающих focusPolicy()).

См. также focusInEvent(), setFocusPolicy(), keyPressEvent(), keyReleaseEvent(), event(), и QFocusEvent.

[protected] bool QWidget::focusPreviousChild()

Находит новый виджет для получения фокуса клавиатуры, соответствующий клавише Shift+Tab, и возвращает true, если новый виджет найден, или false, если нет.

См. также focusNextChild().

QWidget *QWidget::focusProxy() const

Возвращает прокси фокуса или nullptr, если прокси фокуса отсутствует.

См. также setFocusProxy().

QWidget *QWidget::focusWidget() const

Возвращает последнего потомка данного виджета, на котором вызывался метод setFocus. Для виджетов верхнего уровня это виджет, который получит фокус в случае активации этого окна.

Это не то же самое, что QApplication::focusWidget(), которое возвращает виджет с фокусом в текущем активном окне.

QFontInfo QWidget::fontInfo() const

Возвращает информацию о шрифте для текущего шрифта виджета. Эквивалентно QFontInfo(widget->font()).

См. также font(), fontMetrics() и setFont().

QFontMetrics QWidget::fontMetrics() const

Возвращает метрики шрифта для текущего шрифта виджета. Эквивалентно QFontMetrics(widget->font()).

См. также font(), fontInfo() и setFont().

QPalette::ColorRole QWidget::foregroundRole() const

Возвращает роль переднего плана.

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

Если роль переднего плана не задана явно, функция возвращает роль, которая контрастирует с ролью заднего плана.

См. также setForegroundRole() и backgroundRole().

[invokable, since 5.0] QPixmap QWidget::grab(const QRect &rectangle = QRect(QPoint(0, 0), QSize(-1, -1)))

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

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

Примечание: Эту функцию можно вызвать через систему метаобъектов и из QML. См. Q_INVOKABLE.

Эта функция была добавлена в Qt 5.0.

См. также render() и QPixmap.

void QWidget::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())

Подписывает виджет на определенный gesture со специфическими flags.

См. также ungrabGesture() и QGestureEvent.

void QWidget::grabKeyboard()

Захватывает ввод с клавиатуры.

Данный виджет получает все события клавиатуры до тех пор, пока не будет вызван releaseKeyboard(); другие виджеты не получают событий клавиатуры. События мыши не затрагиваются. Используйте grabMouse(), если хотите захватить и их.

Виджет с фокусом не затрагивается, за исключением того, что он не получает событий клавиатуры. setFocus() перемещает фокус как обычно, но новый виджет с фокусом получает события клавиатуры только после вызова releaseKeyboard().

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

См. также releaseKeyboard(), grabMouse(), releaseMouse() и focusWidget().

void QWidget::grabMouse()

Захватывает ввод с мыши.

Данный виджет получает все события мыши до тех пор, пока не будет вызван releaseMouse(); другие виджеты не получают событий мыши. События клавиатуры не затрагиваются. Используйте grabKeyboard(), если хотите захватить и их.

Практически никогда не нужно захватывать мышь при использовании Qt, так как Qt захватывает и отпускает её разумно. В частности, Qt захватывает мышь при нажатии кнопки мыши и удерживает её до тех пор, пока не будет отпущена последняя кнопка.

См. также releaseMouse(), grabKeyboard() и releaseKeyboard().

void QWidget::grabMouse(const QCursor &cursor)

Эта функция перегружает grabMouse().

Захватывает входные данные мыши и изменяет форму курсора.

Курсор примет форму cursor (пока захвачен фокус мыши), и этот виджет будет единственным, который будет получать события мыши, пока не будет вызван releaseMouse().

См. также releaseMouse(), grabKeyboard(), releaseKeyboard() и setCursor().

int QWidget::grabShortcut(const QKeySequence &key, Qt::ShortcutContext context = Qt::WindowShortcut)

Добавляет ярлык в систему ярлыков Qt, который отслеживает заданную последовательность key в заданном context. Если context равен Qt::ApplicationShortcut, ярлык применяется ко всему приложению. В противном случае он локален для этого виджета (Qt::WidgetShortcut) или для самого окна (Qt::WindowShortcut).

Если ту же последовательность key захватили несколько виджетов, при её возникновении событие QEvent::Shortcut отправляется всем виджетам, к которым оно относится, в неопределённом порядке, но с установленным флагом «неопределённое».

См. также releaseShortcut() и setShortcutEnabled().

QGraphicsEffect *QWidget::graphicsEffect() const

Функция graphicsEffect возвращает указатель на эффект графики виджета.

Если у виджета нет эффекта графики, возвращается nullptr.

См. также setGraphicsEffect().

QGraphicsProxyWidget *QWidget::graphicsProxyWidget() const

Возвращает прокси-виджет для соответствующего встроенного виджета в графическом представлении; в противном случае возвращает nullptr.

См. также QGraphicsProxyWidget::createProxyForChildWidget() и QGraphicsScene::addWidget().

bool QWidget::hasEditFocus() const

Возвращает true, если у этого виджета в данный момент есть фокус редактирования; в противном случае возвращает false.

Эта функция доступна только в Qt для Embedded Linux.

См. также setEditFocus() и QApplication::navigationMode().

[virtual, since 5.0] bool QWidget::hasHeightForWidth() const

Возвращает true, если предпочтительная высота виджета зависит от его ширины; в противном случае возвращает false.

Эта функция была добавлена в Qt 5.0.

[virtual] int QWidget::heightForWidth(int w) const

Возвращает предпочтительную высоту этого виджета, учитывая ширину w.

Если у этого виджета есть макет, реализация по умолчанию возвращает предпочтительную высоту макета. Если макета нет, реализация по умолчанию возвращает -1, указывая, что предпочтительная высота не зависит от ширины.

[virtual protected] void QWidget::hideEvent(QHideEvent *event)

Обработчик событий может быть переопределён в подклассе для получения событий скрытия виджета. Событие передаётся в параметре event.

События скрытия отправляются виджетам сразу после их скрытия.

Примечание: виджет получает спонтанные события показа и скрытия, когда его статус отображения изменяется системным окном, например, спонтанное событие скрытия, когда пользователь сворачивает окно, и спонтанное событие показа, когда окно восстанавливается. После получения события спонтанного скрытия виджет всё ещё считается видимым в смысле isVisible().

См. также visible, event() и QHideEvent.

[override virtual protected] void QWidget::initPainter(QPainter *painter) const

Инициализирует перо, фон и шрифт объекта painter так же, как для данного виджета. Эта функция вызывается автоматически при открытии объекта painter для QWidget.

[virtual protected] void QWidget::inputMethodEvent(QInputMethodEvent *event)

Обработчик этого события, для события event, может быть переопределён в подклассе для получения событий композиции ввода. Этот обработчик вызывается при изменении состояния метода ввода.

Обратите внимание, что при создании пользовательских виджетов редактирования текста атрибут окна Qt::WA_InputMethodEnabled должен быть явно установлен (с помощью функции setAttribute()), чтобы получать события метода ввода.

В реализации по умолчанию вызывается event->ignore(), что отклоняет событие метода ввода. Дополнительные сведения см. в документации QInputMethodEvent.

См. также event() и QInputMethodEvent.

[virtual] QVariant QWidget::inputMethodQuery(Qt::InputMethodQuery query) const

Этот метод актуален только для виджетов ввода. Он используется методом ввода для запроса набора свойств виджета, чтобы иметь возможность поддерживать сложные операции методов ввода, такие как поддержка окружающего текста и преобразования.

query указывает, какое свойство запрашивается.

См. также inputMethodEvent(), QInputMethodEvent, QInputMethodQueryEvent и inputMethodHints.

void QWidget::insertAction(QAction *before, QAction *action)

Вставляет действие action в список действий этого виджета перед действием before. Добавляет действие в конец, если before равен nullptr или before не является допустимым действием для этого виджета.

В QWidget должно быть только одно действие каждого типа.

См. также removeAction(), addAction(), QMenu, contextMenuPolicy и actions().

void QWidget::insertActions(QAction *before, const QList<QAction *> &actions)

Вставляет действия actions в список действий этого виджета перед действием before. Добавляет действия в конец, если before равен nullptr или before не является допустимым действием для этого виджета.

В QWidget может быть только по одному действию каждого типа.

См. также removeAction(), QMenu, insertAction() и contextMenuPolicy.

bool QWidget::isAncestorOf(const QWidget *child) const

Возвращает true, если этот виджет является родителем (или предком и так далее), заданного child, и оба виджета находятся в одном окне; в противном случае возвращает false.

bool QWidget::isEnabledTo(const QWidget *ancestor) const

Возвращает true, если этот виджет станет активным, если ancestor активируется; в противном случае возвращает false.

Это верно, если ни сам виджет, ни любой родитель до, но не включая ancestor, не был явно отключен.

isEnabledTo(0) возвращает false, если этот виджет или любой из его предков был явно отключен.

Здесь термин «предок» означает родительский виджет в том же окне.

Следовательно, isEnabledTo(0) останавливается на окне этого виджета, в отличие от isEnabled(), которая также учитывает родительские окна.

См. также setEnabled() и enabled.

bool QWidget::isHidden() const

Возвращает true, если виджет скрыт, иначе возвращает false.

Скрытый виджет станет видимым только при вызове show() для него. Он не будет автоматически показан при отображении родительского виджета.

Для проверки видимости используйте !isVisible() (обратите внимание на знак восклицания).

isHidden() подразумевает !isVisible(), но виджет может быть невидимым и не скрытым одновременно. Это происходит для виджетов, являющихся потомками невидимых виджетов.

Виджеты скрыты, если:

• они были созданы как независимые окна,
• они были созданы как потомки видимых виджетов,
• был вызван hide() или setVisible(false).

bool QWidget::isVisibleTo(const QWidget *ancestor) const

Возвращает true, если этот виджет станет видимым при отображении ancestor; в противном случае возвращает false.

Значение true имеет место, если ни сам виджет, ни какой-либо родитель до, но не включая ancestor, не был явно скрыт.

Эта функция по-прежнему вернёт true, если виджет заслонён другими окнами на экране, но мог бы быть физически видимым, если бы он или они были перемещены.

isVisibleTo(0) идентично isVisible().

См. также show(), hide() и isVisible().

bool QWidget::isWindow() const

Возвращает true, если виджет является независимым окном, иначе возвращает false.

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

Окно может иметь родительский виджет. В этом случае оно будет сгруппировано со своим родителем и удалено при удалении родителя, минимизировано при минимизации родителя и т.д. При поддержке менеджером окон оно также будет иметь общую запись в панели задач со своим родителем.

Виджеты QDialog и QMainWindow по умолчанию являются окнами, даже если родительский виджет указан в конструкторе. Это поведение определяется флагом Qt::Window.

См. также window(), isModal() и parentWidget().

[virtual protected] void QWidget::keyPressEvent(QKeyEvent *event)

Этот обработчик событий для события event может быть переопределён в подклассе для получения событий нажатия клавиш для виджета.

Виджет должен вызвать setFocusPolicy() для получения фокуса изначально и иметь фокус, чтобы получить событие нажатия клавиши.

Если вы переопределяете этот обработчик, очень важно вызвать реализацию базового класса, если вы не обрабатываете нажатую клавишу.

По умолчанию реализация закрывает всплывающие виджеты, если пользователь нажимает последовательность клавиш для QKeySequence::Cancel (обычно клавиша Escape). В противном случае событие игнорируется, чтобы родительский виджет мог его интерпретировать.

Обратите внимание, что QKeyEvent начинается с isAccepted() == true, поэтому вам не нужно вызывать QKeyEvent::accept() — просто не вызывайте реализацию базового класса, если вы обрабатываете клавишу.

См. также keyReleaseEvent(), setFocusPolicy(), focusInEvent(), focusOutEvent(), event(), QKeyEvent и Пример Tetrix.

[virtual protected] void QWidget::keyReleaseEvent(QKeyEvent *event)

Этот обработчик событий для события event может быть переопределён в подклассе для получения событий отпускания клавиш для виджета.

Виджет должен получить фокус изначально и иметь фокус, чтобы получить событие отпускания клавиши.

Если вы переопределяете этот обработчик, очень важно вызвать реализацию базового класса, если вы не обрабатываете нажатую клавишу.

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

Обратите внимание, что QKeyEvent начинается с isAccepted() == true, поэтому вам не нужно вызывать QKeyEvent::accept() — просто не вызывайте реализацию базового класса, если вы обрабатываете клавишу.

См. также keyPressEvent(), QEvent::ignore(), setFocusPolicy(), focusInEvent(), focusOutEvent(), event() и QKeyEvent.

[static] QWidget *QWidget::keyboardGrabber()

Возвращает виджет, который в данный момент получает ввод с клавиатуры.

Если в данном приложении в данный момент не отображается виджет, захватывающий ввод с клавиатуры, возвращается nullptr.

См. также grabMouse() и mouseGrabber().

QLayout *QWidget::layout() const

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

Менеджер компоновки устанавливает геометрию дочерних виджетов, которые были добавлены в компоновку.

См. также setLayout(), sizePolicy() и Управление компоновкой.

[virtual protected] void QWidget::leaveEvent(QEvent *event)

Этот обработчик событий может быть переопределен в подклассе для получения событий выхода курсора мыши из виджета, которые передаются в параметре event.

Событие выхода курсора отправляется виджету, когда курсор мыши покидает виджет.

См. также enterEvent(), mouseMoveEvent() и event().

[since 6.0] QPointF QWidget::mapFrom(const QWidget *parent, const QPointF &pos) const

Преобразует координаты виджета pos из системы координат parent в систему координат этого виджета. parent не должен быть nullptr и должен быть родителем вызывающего виджета.

Эта функция была введена в Qt 6.0.

См. также mapTo(), mapFromParent(), mapFromGlobal() и underMouse().

QPoint QWidget::mapFrom(const QWidget *parent, const QPoint &pos) const

Это перегруженная функция.

[since 6.0] QPointF QWidget::mapFromGlobal(const QPointF &pos) const

Преобразует глобальные экранные координаты pos в координаты виджета.

Эта функция была введена в Qt 6.0.

См. также mapToGlobal(), mapFrom() и mapFromParent().

QPoint QWidget::mapFromGlobal(const QPoint &pos) const

Это перегруженная функция.

[since 6.0] QPointF QWidget::mapFromParent(const QPointF &pos) const

Преобразует родительские координаты виджета pos в координаты текущего виджета.

То же самое, что и mapFromGlobal(), если у виджета нет родителя.

Эта функция была введена в Qt 6.0.

См. также mapToParent(), mapFrom(), mapFromGlobal() и underMouse().

QPoint QWidget::mapFromParent(const QPoint &pos) const

Это перегруженная функция.

[since 6.0] QPointF QWidget::mapTo(const QWidget *parent, const QPointF &pos) const

Преобразует координаты виджета pos в систему координат parent. parent не должен быть nullptr и должен быть родителем вызывающего виджета.

Эта функция была введена в Qt 6.0.

См. также mapFrom(), mapToParent(), mapToGlobal() и underMouse().

QPoint QWidget::mapTo(const QWidget *parent, const QPoint &pos) const

Это перегруженная функция.

[since 6.0] QPointF QWidget::mapToGlobal(const QPointF &pos) const

Преобразует координаты виджета pos в глобальные экранные координаты. Например, mapToGlobal(QPointF(0,0)) даст глобальные координаты левого верхнего пикселя виджета.

Эта функция была добавлена в Qt 6.0.

См. также mapFromGlobal(), mapTo() и mapToParent().

QPoint QWidget::mapToGlobal(const QPoint &pos) const

Это перегруженная функция.

[since 6.0] QPointF QWidget::mapToParent(const QPointF &pos) const

Преобразует координаты виджета pos в координаты родительского виджета.

То же, что и mapToGlobal(), если у виджета нет родителя.

Эта функция была добавлена в Qt 6.0.

См. также mapFromParent(), mapTo(), mapToGlobal() и underMouse().

QPoint QWidget::mapToParent(const QPoint &pos) const

Это перегруженная функция.

QRegion QWidget::mask() const

Возвращает маску, текущую для виджета. Если маска не установлена, возвращается пустая область.

См. также setMask(), clearMask(), QRegion::isEmpty() и Пример часов со сложной формой.

[override virtual protected] int QWidget::metric(QPaintDevice::PaintDeviceMetric m) const

Переопределяет: QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const.

Внутренняя реализация виртуальной функции QPaintDevice::metric().

m — метрика для получения.

[virtual protected] void QWidget::mouseDoubleClickEvent(QMouseEvent *event)

Обработчик событий, для события event, может быть переопределён в подклассе для получения событий двойного щелчка мышью для виджета.

По умолчанию вызывается mousePressEvent().

См. также mousePressEvent(), mouseReleaseEvent(), mouseMoveEvent(), event() и QMouseEvent.

[static] QWidget *QWidget::mouseGrabber()

Возвращает виджет, который в данный момент получает ввод мыши.

Если ни один виджет в этом приложении не захватывает мышь, возвращается nullptr.

См. также grabMouse() и keyboardGrabber().

[virtual protected] void QWidget::mouseMoveEvent(QMouseEvent *event)

Обработчик событий, для события event, может быть переопределен в подклассе для получения событий перемещения мыши для виджета.

Если отслеживание мыши отключено, события перемещения мыши происходят только если нажата кнопка мыши во время перемещения. Если отслеживание мыши включено, события перемещения мыши происходят даже если не нажата никакая кнопка мыши.

QMouseEvent::pos() сообщает о позиции курсора мыши, относительно этого виджета. Для событий нажатия и отпускания, позиция обычно совпадает с позицией последнего события перемещения мыши, но она может отличаться, если рука пользователя дрожит. Это функция подлежащей операционной системы, а не Qt.

Если вы хотите отобразить всплывающую подсказку немедленно, во время перемещения мыши (например, для получения координат мыши с помощью QMouseEvent::pos() и отображения их как всплывающей подсказки), вы должны сначала включить отслеживание мыши, как описано выше. Затем, чтобы гарантировать, что подсказка обновляется немедленно, вы должны вызвать QToolTip::showText() вместо setToolTip() в вашей реализации mouseMoveEvent().

См. также setMouseTracking(), mousePressEvent(), mouseReleaseEvent(), mouseDoubleClickEvent(), event(), QMouseEvent и Пример Scribble.

[virtual protected] void QWidget::mousePressEvent(QMouseEvent *event)

Этот обработчик событий, для события event, может быть переопределён в подклассе для получения событий нажатия мыши для виджета.

Если вы создаёте новые виджеты в mousePressEvent(), то mouseReleaseEvent() может не сработать так, как ожидается, в зависимости от базовой системы окон (или менеджера окон X11), расположения виджетов и других факторов.

По умолчанию реализация выполняет закрытие всплывающих виджетов при щелчке вне окна. Для других типов виджетов она ничего не делает.

См. также mouseReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent и Пример Scribble.

[virtual protected] void QWidget::mouseReleaseEvent(QMouseEvent *event)

Этот обработчик событий, для события event, может быть переопределён в подклассе для получения событий отпускания мыши для виджета.

См. также mousePressEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), event(), QMouseEvent и Пример Scribble.

void QWidget::move(int x, int y)

Это перегруженный метод.

Соответствует move(QPoint(x, y)).

Примечание: Функция-сеттер для свойства pos.

[virtual protected] void QWidget::moveEvent(QMoveEvent *event)

Этот обработчик событий может быть переопределён в подклассе для получения событий перемещения виджета, передаваемых в параметре event. Когда виджет получает это событие, он уже находится в новом положении.

Старое положение доступно через QMoveEvent::oldPos().

См. также resizeEvent(), event(), move() и QMoveEvent.

[virtual protected] bool QWidget::nativeEvent(const QByteArray &eventType, void *message, qintptr *result)

Этот специальный обработчик событий может быть переопределён в подклассе для получения событий родной платформы, идентифицируемых по eventType, передаваемых в параметре message.

В вашей реализации этой функции, если вы хотите остановить обработку события Qt, верните true и установите result. Параметр result имеет значение только в Windows. Если вы вернёте false, это событие родной платформы передаётся обратно в Qt, которое преобразует его в Qt-событие и отправляет его виджету.

См. также QAbstractNativeEventFilter.

QWidget *QWidget::nativeParentWidget() const

Возвращает родительский виджет родной платформы для этого виджета, т.е. ближайший родительский виджет, имеющий идентификатор системы, или nullptr, если у него нет родительского виджета родной платформы.

См. также effectiveWinId().

QWidget *QWidget::nextInFocusChain() const

Возвращает следующий виджет в цепочке фокуса этого виджета.

См. также previousInFocusChain().

void QWidget::overrideWindowFlags(Qt::WindowFlags flags)

Устанавливает флаги окна для виджета на flags, не сообщая об этом системе окон.

См. также setWindowFlags().

[override virtual] QPaintEngine *QWidget::paintEngine() const

Переопределяет: QPaintDevice::paintEngine() const.

Возвращает движок отрисовки виджета.

Обратите внимание, что эта функция не должна вызываться пользователем явно, поскольку она предназначена только для переопределения. Функция вызывается Qt внутри, и стандартная реализация может не всегда возвращать корректный указатель.

[virtual protected] void QWidget::paintEvent(QPaintEvent *event)

Этот обработчик событий может быть переопределён в подклассе для получения событий отрисовки, переданных в event.

Событие отрисовки — это запрос на перерисовку всего или части виджета. Оно может произойти по одной из следующих причин:

• repaint() или update() были вызваны,
• виджет был закрыт и теперь открыт, или
• по многим другим причинам.

Многие виджеты могут просто перерисовать всю свою поверхность, когда об этом попросят, но некоторые медленные виджеты нуждаются в оптимизации, рисуя только запрошенную область: QPaintEvent::region(). Эта оптимизация скорости не меняет результат, поскольку отрисовка обрезается до этой области во время обработки события. QListView и QTableView делают это, например.

Qt также пытается ускорить отрисовку, объединяя несколько событий отрисовки в одно. Когда update() вызывается несколько раз или система окон отправляет несколько событий отрисовки, Qt объединяет эти события в одно событие с большей областью (см. QRegion::united()). Функция repaint() не допускает этой оптимизации, поэтому рекомендуется использовать update() всякий раз, когда это возможно.

Когда происходит событие отрисовки, область обновления обычно была очищена, поэтому вы рисуете на фоне виджета.

Фон можно установить, используя setBackgroundRole() и setPalette().

Начиная с Qt 4.0, QWidget автоматически использует двойную буферизацию для отрисовки, поэтому нет необходимости писать код двойной буферизации в paintEvent() для избежания мерцания.

См. также event(), repaint(), update(), QPainter, QPixmap, QPaintEvent и Пример аналоговых часов.

QWidget *QWidget::parentWidget() const

Возвращает родительский виджет, или nullptr если у него нет родительского виджета.

QWidget *QWidget::previousInFocusChain() const

Функция previousInFocusChain возвращает предыдущий виджет в цепочке фокуса этого виджета.

См. также nextInFocusChain().

void QWidget::releaseKeyboard()

Освобождает захват клавиатуры.

См. также grabKeyboard(), grabMouse() и releaseMouse().

void QWidget::releaseMouse()

Освобождает захват мыши.

См. также grabMouse(), grabKeyboard() и releaseKeyboard().

void QWidget::releaseShortcut(int id)

Удаляет ярлык с заданным id из системы ярлыков Qt. Виджет больше не будет получать события QEvent::Shortcut для последовательности клавиш ярлыка (если у него нет других ярлыков с той же последовательностью клавиш).

См. также grabShortcut() и setShortcutEnabled().

void QWidget::removeAction(QAction *action)

Удаляет действие action из списка действий этого виджета.

См. также insertAction(), actions() и insertAction().

void QWidget::render(QPaintDevice *target, const QPoint &targetOffset = QPoint(), const QRegion &sourceRegion = QRegion(), QWidget::RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren))

Отображает область sourceRegion этого виджета в target, используя renderFlags для определения способа отображения. Отображение начинается в targetOffset в target. Например:

QPixmap pixmap(widget->size());
widget->render(&pixmap);

Если sourceRegion является нулевой областью, эта функция будет использовать QWidget::rect() в качестве области, т.е. весь виджет.

Убедитесь, что вы вызываете QPainter::end() для активного художника устройства target (если таковой имеется) перед отрисовкой. Например:

QPainter painter(this);
...
painter.end();
myWidget->render(this);

void QWidget::render(QPainter *painter, const QPoint &targetOffset = QPoint(), const QRegion &sourceRegion = QRegion(), QWidget::RenderFlags renderFlags = RenderFlags(DrawWindowBackground | DrawChildren))

Это перегруженная функция.

Отображает виджет в QPainter::device() художника painter.

Преобразования и настройки, применённые к painter, будут использованы при отрисовке.

См. также QPainter::device().

void QWidget::repaint(int x, int y, int w, int h)

Это перегруженная функция.

Этот вариант перерисовывает прямоугольник (x, y, w, h) внутри виджета.

Если w отрицательно, оно заменяется на width() - x, а если h отрицательно, то оно заменяется на height() - y.

void QWidget::repaint(const QRect &rect)

Это перегруженная функция.

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

void QWidget::repaint(const QRegion &rgn)

Это перегруженная функция.

Этот вариант перерисовывает область rgn внутри виджета.

void QWidget::resize(int w, int h)

Это перегруженная функция.

Соответствует resize(QSize(w, h)).

Примечание: Функция-сеттер для свойства size.

void QWidget::resizeEvent(QResizeEvent *event)

Обработчик этого события может быть переопределен в подклассе для получения событий изменения размера виджета, которые передаются в параметре event. Когда вызывается resizeEvent(), у виджета уже есть его новая геометрия. Предыдущий размер доступен через QResizeEvent::oldSize().

Виджет будет стерт и получит событие отрисовки сразу после обработки события изменения размера. Внутри этого обработчика никакая отрисовка не нужна (и не должна быть).

См. также moveEvent(), event(), resize(), QResizeEvent, paintEvent(), и Пример Scribble.

bool QWidget::restoreGeometry(const QByteArray &geometry)

Восстанавливает геометрию и состояние виджетов верхнего уровня, сохранённых в массиве байтов geometry. Возвращает true при успехе; в противном случае возвращает false.

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

Для восстановления геометрии, сохранённой с помощью QSettings, можно использовать такой код:

QSettings settings("MyCompany", "MyApp");
myWidget->restoreGeometry(settings.value("myWidget/geometry").toByteArray());

См. документацию Геометрия окна для обзора проблем с геометрией окон.

Используйте QMainWindow::restoreState() для восстановления геометрии и состояния панелей инструментов и плавающих виджетов.

См. также saveGeometry(), QSettings, QMainWindow::saveState(), и QMainWindow::restoreState().

QByteArray QWidget::saveGeometry() const

Сохраняет текущую геометрию и состояние виджетов верхнего уровня.

Чтобы сохранить геометрию при закрытии окна, можно реализовать обработчик закрытия следующим образом:

void MyWidget::closeEvent(QCloseEvent *event)
{
    QSettings settings("MyCompany", "MyApp");
    settings.setValue("geometry", saveGeometry());
    QWidget::closeEvent(event);
}

См. документацию Геометрия окна для обзора проблем с геометрией окон.

Используйте QMainWindow::saveState() для сохранения геометрии и состояния панелей инструментов и плавающих виджетов.

См. также restoreGeometry(), QMainWindow::saveState(), и QMainWindow::restoreState().

[since 5.14] QScreen *QWidget::screen() const

Возвращает экран, на котором находится виджет.

Эта функция была добавлена в Qt 5.14.

См. также setScreen() и windowHandle().

void QWidget::scroll(int dx, int dy)

Прокручивает виджет, включая его дочерние элементы, на dx пикселей вправо и dy пикселей вниз. dx и dy могут быть отрицательными.

После прокрутки виджеты получат события рисования для областей, которые нужно перерисовать. Для виджетов, которые Qt знает как непрозрачные, это только новые видимые части. Например, если непрозрачный виджет прокручен влево на 8 пикселей, для обновления требуется только полоса шириной 8 пикселей на правом краю.

Поскольку виджеты по умолчанию распространяют содержимое своих родителей, вам необходимо установить свойство autoFillBackground или использовать setAttribute() для установки атрибута Qt::WA_OpaquePaintEvent, чтобы сделать виджет непрозрачным.

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

См. также Прозрачность и буферизация.

void QWidget::scroll(int dx, int dy, const QRect &r)

Это перегруженная функция.

Этот вариант прокручивает только r и не перемещает дочерние элементы виджета.

Если r пуста или неверна, результат неопределён.

См. также QScrollArea.

void QWidget::setAttribute(Qt::WidgetAttribute attribute, bool on = true)

Устанавливает атрибут attribute для этого виджета, если on равно true; в противном случае очищает атрибут.

См. также testAttribute().

void QWidget::setBackgroundRole(QPalette::ColorRole role)

Устанавливает роль фона виджета на role.

Роль фона определяет кисть из палитры виджета, которая используется для отрисовки фона.

Если role равно QPalette::NoRole, виджет наследует роль фона от своего родителя.

Обратите внимание, что стили могут свободно выбирать любой цвет из палитры. Вы можете изменить палитру или установить стиль, если не получите желаемого результата с помощью setBackgroundRole().

См. также backgroundRole() и foregroundRole().

void QWidget::setBaseSize(int basew, int baseh)

Это перегруженная функция.

Соответствует setBaseSize(QSize(basew, baseh)). Устанавливает базовый размер виджета на ширину basew и высоту baseh.

Примечание: Функция-установщик для свойства baseSize.

void QWidget::setContentsMargins(int left, int top, int right, int bottom)

Устанавливает отступы вокруг содержимого виджета с размерами left, top, right и bottom. Отступы используются системой компоновки и могут быть использованы подклассами для определения области рисования (например, исключая рамку).

Изменение отступов вызовет событие resizeEvent().

См. также contentsRect() и contentsMargins().

void QWidget::setContentsMargins(const QMargins &margins)

Это перегруженный метод.

Функция setContentsMargins устанавливает отступы вокруг содержимого виджета.

Устанавливает отступы вокруг содержимого виджета, заданные размерами margins. Отступы используются системой компоновки и могут быть использованы подклассами для определения области рисования (например, исключая рамку).

Изменение отступов вызовет событие resizeEvent().

См. также contentsRect() и contentsMargins().

void QWidget::setEditFocus(bool enable)

Если enable равно true, данный виджет получает фокус редактирования, в этом случае Qt::Key_Up и Qt::Key_Down будут переданы виджету нормально; в противном случае, Qt::Key_Up и Qt::Key_Down используются для изменения фокуса.

Эта функция доступна только в Qt для Embedded Linux.

См. также hasEditFocus() и QApplication::navigationMode().

void QWidget::setFixedHeight(int h)

Устанавливает минимальную и максимальную высоту виджета в h, не изменяя ширину. Предоставлено для удобства.

См. также sizeHint(), minimumSize(), maximumSize() и setFixedSize().

void QWidget::setFixedSize(const QSize &s)

Устанавливает минимальный и максимальный размеры виджета равными s, тем самым предотвращая его изменение размера.

Это переопределяет ограничения размеров, заданные QLayout.

Чтобы удалить ограничения, установите размер в QWIDGETSIZE_MAX.

В качестве альтернативы, если вы хотите, чтобы виджет имел фиксированный размер, основанный на его содержимом, вы можете вызвать QLayout::setSizeConstraint(QLayout::SetFixedSize);

См. также maximumSize и minimumSize.

void QWidget::setFixedSize(int w, int h)

Это перегруженный метод.

Устанавливает ширину виджета равной w, а высоту — h.

void QWidget::setFixedWidth(int w)

Устанавливает минимальную и максимальную ширину виджета равной w, не изменяя высоту. Предоставлено для удобства.

См. также sizeHint(), minimumSize(), maximumSize(), и setFixedSize().

void QWidget::setFocus(Qt::FocusReason reason)

Передает фокус ввода клавиатуры данному виджету (или его прокси фокуса), если этот виджет или один из его родителей является активным окном. Аргумент reason будет передан в любое событие фокуса, отправленное из этой функции, он используется для объяснения причины получения виджетом фокуса. Если окно неактивно, виджет получит фокус, когда окно станет активным.

Сначала событие о предстоящем изменении фокуса отправляется виджету с фокусом (если таковой имеется), чтобы сообщить ему, что он собирается потерять фокус. Затем происходит смена фокуса, событие выхода из фокуса отправляется предыдущему элементу с фокусом, а событие входа в фокус отправляется новому элементу, чтобы сообщить ему, что он только что получил фокус. (Ничего не происходит, если виджеты входа и выхода из фокуса одинаковы.)

setFocus() дает фокус виджету независимо от его политики фокуса, но не очищает захват клавиатуры (см. grabKeyboard()).

Обратите внимание, что если виджет скрыт, он не получит фокус, пока не будет показан.

См. также hasFocus(), clearFocus(), focusInEvent(), focusOutEvent(), setFocusPolicy(), focusWidget(), QApplication::focusWidget(), grabKeyboard(), grabMouse(), Фокус клавиатуры в виджетах и QEvent::RequestSoftwareInputPanel.

void QWidget::setFocusProxy(QWidget *w)

Устанавливает виджет-прокси фокуса для виджета w. Если w равен nullptr, функция сбрасывает этот виджет, чтобы у него не было виджета-прокси фокуса.

Некоторые виджеты могут "иметь фокус", но создают дочерний виджет, например, QLineEdit, для фактического управления фокусом. В этом случае виджет может установить строковое поле в качестве своего виджета-прокси фокуса.

setFocusProxy() устанавливает виджет, который фактически получит фокус, когда его получит "этот виджет". Если есть виджет-прокси фокуса, setFocus() и hasFocus() работают с виджетом-прокси фокуса. Если "этот виджет" является виджетом фокуса, то setFocusProxy() перемещает фокус на новый виджет-прокси фокуса.

См. также focusProxy().

void QWidget::setForegroundRole(QPalette::ColorRole role)

Устанавливает роль переднего плана виджета в role.

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

Если role равен QPalette::NoRole, виджет использует роль переднего плана, контрастирующую с ролью заднего плана.

Обратите внимание, что стили могут свободно выбирать любой цвет из палитры. Вы можете изменить палитру или установить стиль таблицы, если вы не достигли желаемого результата с помощью setForegroundRole().

См. также foregroundRole() и backgroundRole().

void QWidget::setGeometry(int x, int y, int w, int h)

Это перегруженная функция.

Это соответствует setGeometry(QRect(x, y, w, h)).

Примечание: Функция-сеттер для свойства geometry.

void QWidget::setGraphicsEffect(QGraphicsEffect *effect)

Функция setGraphicsEffect предназначена для установки графического эффекта виджета.

Устанавливает effect в качестве эффекта виджета. Если на этом виджете уже установлен эффект, QWidget удалит существующий эффект перед установкой нового effect.

Если effect является установленным эффектом на другом виджете, setGraphicsEffect() удалит эффект из виджета и установит его на этот виджет.

QWidget принимает во владение effect.

См. также graphicsEffect().

void QWidget::setLayout(QLayout *layout)

Устанавливает менеджер макета для этого виджета в layout.

Если на этом виджете уже установлен менеджер макета, QWidget не позволит вам установить другой. Сначала необходимо удалить существующий менеджер макета (возвращается layout() ), прежде чем вы сможете вызвать setLayout() с новым макетом.

Если layout является менеджером макета на другом виджете, setLayout() переродится макет и сделает его менеджером макета для этого виджета.

Пример:

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(formWidget);
    setLayout(layout);

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

QWidget примет во владение layout.

См. также layout() и Управление макетами.

void QWidget::setMask(const QBitmap &bitmap)

Приводит к тому, что видны только пиксели виджета, для которых в bitmap соответствует бит 1. Если область включает пиксели за пределами rect() виджета, элементы управления системного окна в этой области могут или не могут быть видны, в зависимости от платформы.

Обратите внимание, что этот эффект может быть медленным, если область является особенно сложной.

Следующий код демонстрирует, как изображение с альфа-каналом может использоваться для генерации маски для виджета:

    QLabel topLevelLabel;
    QPixmap pixmap(":/images/tux.png");
    topLevelLabel.setPixmap(pixmap);
    topLevelLabel.setMask(pixmap.mask());

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

Маскированные виджеты получают события мыши только в своих видимых частях.

См. также mask(), clearMask(), windowOpacity(), и Пример часов с формой.

void QWidget::setMask(const QRegion &region)

Это перегруженный метод.

Делает видимыми только те части виджета, которые перекрывают область region. Если область включает пиксели за пределами rect() виджета, элементы управления системы окон в этой области могут быть или не быть видимыми в зависимости от платформы.

Обратите внимание, что этот эффект может быть медленным, если область является особенно сложной.

См. также windowOpacity.

void QWidget::setMaximumSize(int maxw, int maxh)

Это перегруженный метод.

Этот метод соответствует setMaximumSize(QSize(maxw, maxh)). Устанавливает максимальную ширину в maxw и максимальную высоту в maxh.

Примечание: Метод-сеттер для свойства maximumSize.

void QWidget::setMinimumSize(int minw, int minh)

Это перегруженный метод.

Этот метод соответствует setMinimumSize(QSize(minw, minh)). Устанавливает минимальную ширину в minw и минимальную высоту в minh.

Примечание: Метод-сеттер для свойства minimumSize.

void QWidget::setParent(QWidget *parent)

Устанавливает родительский виджет для parent и сбрасывает флаги окна. Виджет перемещается в позицию (0, 0) в новом родительском виджете.

Если новый родительский виджет находится в другом окне, переместившийся виджет и его дочерние элементы добавляются в конец цепочки табуляции нового родительского виджета в том же внутреннем порядке, что и раньше. Если один из перемещенных виджетов имел фокус клавиатуры, setParent() вызывает clearFocus() для этого виджета.

Если новый родительский виджет находится в том же окне, что и старый родитель, установка родителя не изменяет порядок табуляции или фокус клавиатуры.

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

См. также setWindowFlags().

void QWidget::setParent(QWidget *parent, Qt::WindowFlags f)

Это перегруженный метод.

Эта функция также принимает флаги виджета, f, в качестве аргумента.

void QWidget::setScreen(QScreen *screen)

Устанавливает экран, на котором должен отображаться виджет, на screen.

Установка экрана имеет смысл только для окон. При необходимости окно виджета будет пересоздано на screen.

См. также screen() и QWindow::setScreen().

void QWidget::setShortcutAutoRepeat(int id, bool enable = true)

Если enable имеет значение true, автоматическое повторение сочетания клавиш с заданным id включено; в противном случае оно отключено.

См. также grabShortcut() и releaseShortcut().

void QWidget::setShortcutEnabled(int id, bool enable = true)

Если enable имеет значение true, сочетание клавиш с заданным id включено; в противном случае сочетание клавиш отключено.

См. также grabShortcut() и releaseShortcut().

void QWidget::setSizeIncrement(int w, int h)

Это перегруженная функция.

Устанавливает приращение размера по оси x (ширина) в w и приращение размера по оси y (высота) в h.

Примечание: Функция-сеттер для свойства sizeIncrement.

void QWidget::setSizePolicy(QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical)

Это перегруженная функция.

Устанавливает политику размера виджета на horizontal и vertical, со стандартным масштабированием и без высоты, зависящей от ширины.

Примечание: Функция-сеттер для свойства sizePolicy.

См. также QSizePolicy::QSizePolicy().

void QWidget::setStyle(QStyle *style)

Устанавливает стиль GUI виджета на style. Владение объектом стиля не передается.

Если стиль не установлен, виджет использует стиль приложения, QApplication::style() вместо.

Установка стиля виджета не влияет на существующие или будущие дочерние виджеты.

См. также style(), QStyle, QApplication::style(), и QApplication::setStyle().

[static] void QWidget::setTabOrder(QWidget *first, QWidget *second)

Располагает виджет second после виджета first в порядке фокуса.

Это эффективно удаляет виджет second из его цепочки фокуса и вставляет его после виджета first.

Обратите внимание, что поскольку порядок табуляции виджета second изменяется, вы должны упорядочить цепочку так:

setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to d

а не так:

// WRONG
setTabOrder(c, d); // c to d
setTabOrder(a, b); // a to b AND c to d
setTabOrder(b, c); // a to b to c, but not c to d

Если у first или second есть прокси фокуса, setTabOrder() правильно заменяет прокси.

См. также setFocusPolicy(), setFocusProxy(), и Фокус клавиатуры в виджетах.

[since 5.9] void QWidget::setWindowFlag(Qt::WindowType flag, bool on = true)

Устанавливает флаг окна flag для этого виджета, если on имеет значение true; в противном случае очищает флаг.

Эта функция была введена в Qt 5.9.

См. также setWindowFlags(), windowFlags(), и windowType().

void QWidget::setWindowRole(const QString &role)

Устанавливает роль окна на role. Это имеет смысл только для окон на X11.

См. также windowRole().

void QWidget::setWindowState(Qt::WindowStates windowState)

Устанавливает состояние окна на windowState. Состояние окна — это результат побитового ИЛИ (Qt::WindowMinimized, Qt::WindowMaximized, Qt::WindowFullScreen и Qt::WindowActive).

Если окно невидимо (т.е. isVisible() возвращает false), состояние окна вступит в силу при вызове show(). Для видимых окон изменение происходит немедленно. Например, чтобы переключаться между полноэкранным и обычным режимом, используйте следующий код:

w->setWindowState(w->windowState() ^ Qt::WindowFullScreen);

Для восстановления и активации минимизированного окна (сохраняя его максимальное и/или полноэкранное состояние), используйте следующее:

w->setWindowState((w->windowState() & ~Qt::WindowMinimized) | Qt::WindowActive);

Вызов этой функции скроет виджет. Вам необходимо вызвать show(), чтобы сделать виджет видимым снова.

Когда состояние окна меняется, виджет получает changeEvent() типа QEvent::WindowStateChange.

См. также Qt::WindowState и windowState().

void QWidget::setupUi(QWidget *widget)

Настраивает пользовательский интерфейс для указанного widget.

См. также Использование файла пользовательского интерфейса Designer в вашем приложении.

[virtual protected] void QWidget::showEvent(QShowEvent *event)

Обработчик этого события может быть переопределен в подклассе для получения событий отображения виджетов, которые передаются в параметре event.

Несамопроизвольные события отображения отправляются виджетам непосредственно перед их отображением. Самопроизвольные события отображения окон доставляются после этого.

Примечание: Виджет получает спонтанные события отображения и скрытия, когда его статус отображения меняется системой окон, например, спонтанное событие скрытия, когда пользователь сворачивает окно, и спонтанное событие отображения, когда окно восстанавливается. После получения спонтанного события скрытия виджет по-прежнему считается видимым в смысле isVisible().

См. также visible, event() и QShowEvent.

void QWidget::stackUnder(QWidget *w)

Размещает виджет под w в стеке родительского виджета.

Для работы виджет и w должны быть братьями.

См. также raise() и lower().

QStyle *QWidget::style() const

См. также QWidget::setStyle(), QApplication::setStyle() и QApplication::style().

[virtual protected] void QWidget::tabletEvent(QTabletEvent *event)

Этот обработчик событий, для события event, может быть переопределён в подклассе для получения событий планшетных устройств для виджета.

Если вы переопределяете этот обработчик, крайне важно, что вы ignore() событие, если вы его не обрабатываете, чтобы родительский виджет мог его интерпретировать.

По умолчанию обработчик игнорирует событие.

Если отслеживание планшетных данных выключено, события перемещения планшетных данных возникают только если стилус находится в контакте с планшетом или нажата хотя бы одна кнопка стилуса, во время перемещения стилуса. Если отслеживание планшетных данных включено, события перемещения планшетных данных возникают даже когда стилус находится вблизи планшета, без нажатых кнопок.

См. также QEvent::ignore(), QEvent::accept(), event(), setTabletTracking() и QTabletEvent.

bool QWidget::testAttribute(Qt::WidgetAttribute attribute) const

Возвращает true, если атрибут attribute установлен для этого виджета; в противном случае возвращает false.

См. также setAttribute().

bool QWidget::underMouse() const

Возвращает true, если виджет находится под курсором мыши; в противном случае возвращает false.

Это значение не обновляется должным образом во время операций перетаскивания.

См. также enterEvent() и leaveEvent().

void QWidget::ungrabGesture(Qt::GestureType gesture)

Отписывает виджет от заданного типа жеста gesture.

См. также grabGesture() и QGestureEvent.

void QWidget::update(int x, int y, int w, int h)

Это перегруженный метод.

Этот вариант обновляет прямоугольник (x, y, w, h) внутри виджета.

void QWidget::update(const QRect &rect)

Это перегруженный метод.

Этот вариант обновляет прямоугольник rect внутри виджета.

void QWidget::update(const QRegion &rgn)

Это перегруженный метод.

Этот вариант перерисовывает область rgn внутри виджета.

void QWidget::updateGeometry()

Уведомляет систему компоновки, что этот виджет изменился и, возможно, требует изменения геометрии.

Вызовите эту функцию, если изменились sizeHint() или sizePolicy().

Для явно скрытых виджетов updateGeometry() — это пустая операция. Система компоновки будет уведомлена, как только виджет будет показан.

QRegion QWidget::visibleRegion() const

Возвращает незатенённую область, где могут происходить события рисования.

Для видимых виджетов это приблизительная оценка области, не покрытой другими виджетами; в противном случае это пустая область.

Функция repaint() при необходимости вызывает эту функцию, поэтому в общем случае вам не нужно её вызывать.

[virtual protected] void QWidget::wheelEvent(QWheelEvent *event)

Этот обработчик событий, для события event, может быть переопределён в подклассе для получения событий прокрутки для виджета.

Если вы переопределяете этот обработчик, очень важно, что вы ignore() событие, если не обрабатываете его, чтобы родительский виджет мог его интерпретировать.

По умолчанию обработчик игнорирует событие.

См. также QEvent::ignore(), QEvent::accept(), event() и QWheelEvent.

WId QWidget::winId() const

Возвращает идентификатор окна системы виджета.

В принципе, портабелен, но если вы его используете, вы, вероятно, собираетесь сделать что-то непортабельное. Будьте осторожны.

Если виджет неродной (инородный) и вызывается winId(), этому виджету будет предоставлена родная ручка.

Это значение может изменяться во время выполнения. Событие типа QEvent::WinIdChange будет отправлено виджету после изменения идентификатора системы окон.

См. также find().

QWidget *QWidget::window() const

Возвращает окно для этого виджета, т.е. следующий родительский виджет, у которого есть (или может быть) фрейм системы окон.

Если виджет является окном, возвращается сам виджет.

Типичное использование — изменение заголовка окна:

aWidget->window()->setWindowTitle("New Window Title");

См. также isWindow().

[since 5.0] QWindow *QWidget::windowHandle() const

Если это родной виджет, возвращает связанное QWindow. В противном случае возвращает null.

Родные виджеты включают виджеты верхнего уровня, QGLWidget и дочерние виджеты, для которых был вызван winId().

Эта функция была введена в Qt 5.0.

См. также winId() и screen().

QString QWidget::windowRole() const

Возвращает роль окна или пустую строку.

См. также setWindowRole(), windowIcon и windowTitle.

Qt::WindowStates QWidget::windowState() const

Возвращает текущее состояние окна. Состояние окна — это результат побитового ИЛИ для Qt::WindowState: Qt::WindowMinimized, Qt::WindowMaximized, Qt::WindowFullScreen и Qt::WindowActive.

См. также Qt::WindowState и setWindowState().

Qt::WindowType QWidget::windowType() const

Возвращает тип окна этого виджета. Это идентично windowFlags() & Qt::WindowType_Mask.

См. также windowFlags.