Класс QGraphicsWidget

Класс QGraphicsWidget является базовым классом для всех элементов виджетов в QGraphicsScene. Подробнее...

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

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

Свойства

• 12 свойств унаследованных от QGraphicsObject
• 1 свойство унаследованное от QObject

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

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

• 2 общедоступных функции унаследованы от QGraphicsObject
• 35 общедоступных функций унаследованы от QGraphicsLayoutItem
• 34 общедоступных функции унаследованы от QObject
• 176 общедоступных функций унаследованы от QGraphicsItem

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

• 1 публичный слот унаследован от QObject

Сигналы

• 9 сигналов унаследовано от QGraphicsObject
• 2 сигнала унаследовано от QObject

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

• 10 статических общедоступных членов унаследовано от QObject

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

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

• 1 защищённая функция унаследована от QGraphicsObject
• 3 защищённых функции унаследованы от QGraphicsLayoutItem
• 9 защищённых функций унаследовано от QObject
• 24 защищённых функций унаследовано от QGraphicsItem

Дополнительные унаследованные члены

• 1 общедоступная переменная унаследована от QObject
• 1 защищённый слот унаследован от QGraphicsObject
• 2 защищённых переменных унаследовано от QObject

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

Класс QGraphicsWidget — базовый класс для всех элементов виджетов в QGraphicsScene.

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

• Предоставляет палитру, шрифт и стиль.
• Имеет определённую геометрию.
• Поддерживает макеты с помощью setLayout() и layout().
• Поддерживает ярлыки и действия с помощью grabShortcut() и insertAction()

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

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

Так как QGraphicsWidget похож на QWidget и имеет похожий API, его проще перенести из QWidget в QGraphicsWidget, чем из QGraphicsItem.

Примечание: Виджеты на основе QWidget можно напрямую встраивать в QGraphicsScene с помощью QGraphicsProxyWidget.

Заметные различия между QGraphicsWidget и QWidget:

QGraphicsWidget поддерживает подмножество атрибутов виджетов Qt (Qt::WidgetAttribute), как показано в таблице ниже. Любые атрибуты, не перечисленные в этой таблице, не поддерживаются или не используются.

Хотя QGraphicsWidget наследуется как от QObject, так и от QGraphicsItem, для управления отношениями между родительскими и дочерними элементами следует использовать функции из QGraphicsItem, а не QObject. Эти функции управляют порядком отображения элементов и их владением.

Примечание: Метод QObject::parent() всегда должен возвращать 0 для QGraphicsWidget, но эта политика не строго определена.

См. также QGraphicsProxyWidget, QGraphicsItem и Виджеты и макеты.

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

enum QGraphicsWidget::anonymous

Значение, возвращаемое виртуальной функцией type().

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

QGraphicsWidget::QGraphicsWidget(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = ...)

Создаёт экземпляр QGraphicsWidget. Необязательный аргумент parent передаётся конструктору QGraphicsItem. Необязательный аргумент wFlags задаёт флаги окна виджета (например, является ли виджет окном, инструментом, всплывающим окном и т. д.).

[virtual] QGraphicsWidget::~QGraphicsWidget()

Удаляет экземпляр QGraphicsWidget.

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

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

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

См. также insertAction(), removeAction(), QWidget::actions(), QAction::associatedWidgets() и QAction::associatedGraphicsWidgets().

void QGraphicsWidget::addAction(QAction *action)

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

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

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

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

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

void QGraphicsWidget::addActions(QList<QAction *> actions)

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

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

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

void QGraphicsWidget::adjustSize()

Настраивает размер виджета на его эффективное предпочтительное значение.

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

См. также effectiveSizeHint() и Qt::MinimumSize.

[override virtual] QRectF QGraphicsWidget::boundingRect() const

Переопределено из QGraphicsItem::boundingRect().

[virtual protected] void QGraphicsWidget::changeEvent(QEvent *event)

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

Состояние, изменяемое в этом событии, может быть получено через event.

События изменения включают: QEvent::ActivationChange, QEvent::EnabledChange, QEvent::FontChange, QEvent::StyleChange, QEvent::PaletteChange, QEvent::ParentChange, QEvent::LayoutDirectionChange и QEvent::ContentsRectChange.

[slot] bool QGraphicsWidget::close()

Вызовите эту функцию для закрытия виджета.

Возвращает true, если виджет был закрыт; в противном случае возвращает false. Этот слот сначала отправит QCloseEvent виджету, который может или не может принять событие. Если событие было проигнорировано, ничего не произойдёт. Если событие было принято, виджет будет скрыт().

Если для виджета установлен атрибут Qt::WA_DeleteOnClose, он будет удалён.

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

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

См. также close() и QCloseEvent.

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

Переопределено из QGraphicsObject::event().

Обрабатывает событие event. QGraphicsWidget обрабатывает следующие события:

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

Переопределено из QGraphicsItem::focusInEvent().

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

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

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

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

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

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

Переопределено из QGraphicsItem::focusOutEvent().

QGraphicsWidget *QGraphicsWidget::focusWidget() const

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

См. также QGraphicsItem::focusItem() и QWidget::focusWidget().

[signal] void QGraphicsWidget::geometryChanged()

Это сигнал, который излучается всякий раз, когда изменяется геометрия в setGeometry().

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

[override virtual] void QGraphicsWidget::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

Переопределено из QGraphicsLayoutItem::getContentsMargins().

Получает отступы содержимого виджета. Отступы хранятся в left, top, right и bottom в качестве указателей на qreal. Каждый аргумент может быть опущен, передав 0.

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

void QGraphicsWidget::getWindowFrameMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

Получает отступы рамки окна виджета. Отступы хранятся в left, top, right и bottom в качестве указателей на qreal. Каждый аргумент может быть опущен, передав 0.

См. также setWindowFrameMargins() и windowFrameRect().

[virtual protected] void QGraphicsWidget::grabKeyboardEvent(QEvent *event)

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

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

[virtual protected] void QGraphicsWidget::grabMouseEvent(QEvent *event)

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

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

int QGraphicsWidget::grabShortcut(const QKeySequence &sequence, Qt::ShortcutContext context = Qt::WindowShortcut)

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

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

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

Эта функция была представлена в Qt 4.5.

См. также releaseShortcut(), setShortcutEnabled() и QWidget::grabShortcut().

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

Этот обработчик событий для событий Hide доставляется после того, как виджет был скрыт, например, после вызова setVisible(false) для виджета или одного из его предков, когда виджет был ранее отображён.

Вы можете переопределить этот обработчик событий, чтобы определить, когда ваш виджет скрыт. Вызов QEvent::accept() или QEvent::ignore() на event не окажет никакого влияния.

См. также showEvent(), QWidget::hideEvent() и ItemVisibleChange.

[override virtual protected] void QGraphicsWidget::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)

Переопределено из QGraphicsItem::hoverLeaveEvent().

[override virtual protected] void QGraphicsWidget::hoverMoveEvent(QGraphicsSceneHoverEvent *event)

Реализовано повторно из QGraphicsItem::hoverMoveEvent().

[virtual protected] void QGraphicsWidget::initStyleOption(QStyleOption *option) const

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

Подклассы QGraphicsWidget должны вызывать базовый метод, а затем проверять тип option с помощью qstyleoption_cast<>() или проверять QStyleOption::Type перед сохранением опций, специфичных для виджета.

Например:

void MyGroupBoxWidget::initStyleOption(QStyleOption *option) const
{
    QGraphicsWidget::initStyleOption(option);
    if (QStyleOptionGroupBox *box = qstyleoption_cast<QStyleOptionGroupBox *>(option)) {
        // Add group box specific state.
        box->flat = isFlat();
        ...
    }
}

См. также QStyleOption::initFrom().

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

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

QGraphicsWidget должен содержать только по одному экземпляру каждого действия.

Данная функция была добавлена в Qt 4.5.

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

void QGraphicsWidget::insertActions(QAction *before, QList<QAction *> actions)

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

QGraphicsWidget может содержать не более одного экземпляра каждого действия.

Данная функция была добавлена в Qt 4.5.

См. также removeAction(), QMenu, insertAction(), и QWidget::insertActions().

bool QGraphicsWidget::isActiveWindow() const

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

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

См. также QGraphicsScene::activeWindow(), QGraphicsScene::setActiveWindow(), и isActive().

[override virtual protected] QVariant QGraphicsWidget::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value)

Реализовано повторно из QGraphicsItem::itemChange().

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

change указывает тип изменения, а value — новое значение.

Например, QGraphicsWidget использует ItemVisibleChange для передачи событий Show и Hide, ItemPositionHasChanged для передачи событий Move, и ItemParentChange для передачи событий ParentChange, а также для управления цепочкой фокуса.

QGraphicsWidget включает флаг ItemSendsGeometryChanges по умолчанию для отслеживания изменений позиции.

См. также QGraphicsItem::itemChange().

QGraphicsLayout *QGraphicsWidget::layout() const

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

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

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

[virtual protected] void QGraphicsWidget::moveEvent(QGraphicsSceneMoveEvent *event)

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

Это событие передаётся только при локальном перемещении элемента. Вызов setTransform() или перемещение любого из предков элемента не влияет на локальное положение элемента.

Вы можете переопределить этот обработчик событий, чтобы обнаружить, когда ваш виджет был перемещен. Вызов QEvent::accept() или QEvent::ignore() на event не имеет эффекта.

См. также ItemPositionChange и ItemPositionHasChanged.

[override virtual] void QGraphicsWidget::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

Реализовано повторно из QGraphicsItem::paint().

[virtual] void QGraphicsWidget::paintWindowFrame(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

Эта виртуальная функция вызывается QGraphicsScene для отрисовки рамки окна для окон с помощью painter, option и widget в локальных координатах. Базовая реализация использует текущий стиль для отрисовки рамки и заголовка.

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

См. также QGraphicsItem::paint().

[virtual protected] void QGraphicsWidget::polishEvent()

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

Базовая реализация ничего не делает.

QRectF QGraphicsWidget::rect() const

Возвращает локальный прямоугольник элемента как QRectF. Эта функция эквивалентна QRectF(QPointF(), size()).

См. также setGeometry() и resize().

void QGraphicsWidget::releaseShortcut(int id)

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

Предупреждение: Обычно вам не нужно использовать эту функцию, так как система ярлыков Qt автоматически удаляет ярлыки при уничтожении родительского виджета. Лучше использовать QAction или QShortcut для обработки ярлыков, так как они проще в использовании, чем эта низкоуровневая функция. Также обратите внимание, что это дорогостоящая операция.

Данная функция была добавлена в Qt 4.5.

См. также grabShortcut(), setShortcutEnabled(), и QWidget::releaseShortcut().

void QGraphicsWidget::removeAction(QAction *action)

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

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

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

void QGraphicsWidget::resize(qreal w, qreal h)

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

Создаёт изменение размера с заданными значениями width (w) и height (h). Эта удобная функция эквивалентна вызову resize(QSizeF(w, h)).

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

См. также setGeometry() и setTransform().

[virtual protected] void QGraphicsWidget::resizeEvent(QGraphicsSceneResizeEvent *event)

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

Это событие доставляется только при изменении размера виджета локально; вызов setTransform() для виджета или любого из его предков или представления не влияет на локальный размер виджета.

Вы можете переопределить этот обработчик событий, чтобы определить, когда ваш виджет был изменен в размерах. Вызов QEvent::accept() или QEvent::ignore() для event не имеет эффекта.

См. также geometry() и setGeometry().

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

Переопределено из QGraphicsItem::sceneEvent().

Реализация sceneEvent() в QGraphicsWidget просто передаёт event в QGraphicsWidget::event(). Вы можете обработать все события для своего виджета в event() или в любой из удобных функций; вам не нужно переопределять эту функцию в подклассе QGraphicsWidget.

См. также QGraphicsItem::sceneEvent().

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

Если on равно true, эта функция включает attribute; в противном случае attribute выключается.

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

См. также testAttribute() и QWidget::setAttribute().

void QGraphicsWidget::setContentsMargins(qreal left, qreal top, qreal right, qreal bottom)

Устанавливает отступы содержимого виджета в значения left, top, right и bottom.

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

Изменение отступов содержимого виджета всегда вызывает update(), и любой применённый макет будет активирован автоматически. Затем виджет получит событие ContentsRectChange.

См. также getContentsMargins() и setGeometry().

void QGraphicsWidget::setGeometry(qreal x, qreal y, qreal w, qreal h)

Эта удобная функция эквивалентна вызову setGeometry(QRectF( x, y, w, h)).

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

См. также geometry() и resize().

void QGraphicsWidget::setLayout(QGraphicsLayout *layout)

Устанавливает макет для этого виджета в layout. Любой существующий менеджер макета удаляется перед назначением нового макета. Если layout равен 0, виджет остаётся без макета. Геометрии существующих дочерних виджетов останутся неизменными.

Все виджеты, которые в настоящее время управляются layout или любым из его дочерних макетов, автоматически переназначаются этому элементу. Затем макет аннулируется, и геометрия дочерних виджетов корректируется в соответствии с geometry() и contentsMargins() этого элемента. Дочерние элементы, которые не управляются явно layout, не изменяются макетом после его назначения этому виджету.

QGraphicsWidget берёт на себя владение layout.

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

См. также layout(), QGraphicsLinearLayout::addItem(), и QGraphicsLayout::invalidate().

void QGraphicsWidget::setShortcutAutoRepeat(int id, bool enabled = true)

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

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

См. также grabShortcut(), releaseShortcut(), и QWidget::setShortcutAutoRepeat().

void QGraphicsWidget::setShortcutEnabled(int id, bool enabled = true)

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

Предупреждение: Вам обычно не нужно использовать эту функцию, так как система сочетаний клавиш Qt автоматически включает/выключает их, когда виджеты скрываются/показываются и получают/теряют фокус. Лучше использовать QAction или QShortcut для обработки сочетаний клавиш, так как они проще в использовании, чем эта функция низкого уровня.

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

См. также grabShortcut(), releaseShortcut(), и QWidget::setShortcutEnabled().

void QGraphicsWidget::setStyle(QStyle *style)

Устанавливает стиль виджета в style. QGraphicsWidget не принимает владение style.

Если стиль не назначен или style равен 0, виджет будет использовать QGraphicsScene::style() (если он был установлен). В противном случае виджет будет использовать QApplication::style().

Эта функция устанавливает атрибут Qt::WA_SetStyle, если style не равен 0; в противном случае атрибут очищается.

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

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

Перемещает виджет second в цикле виджетов, которые получают фокус, таким образом, что фокус клавиатуры переходит от виджета first к виджету second при нажатии клавиши Tab.

Обратите внимание, что, поскольку порядок следования 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 равен 0, это означает, что second должен быть первым виджетом, который получит фокус, если сцена получит фокус Tab (т.е. пользователь нажимает Tab, чтобы передать фокус в сцену). Если second равен 0, это означает, что first должен быть первым виджетом, который получит фокус, если сцена получит фокус BackTab.

По умолчанию порядок следования Tab определяется неявно в порядке создания виджетов.

См. также focusPolicy и Фокус клавиатуры в виджетах.

void QGraphicsWidget::setWindowFrameMargins(qreal left, qreal top, qreal right, qreal bottom)

Устанавливает отступы рамки окна виджета в значения left, top, right и bottom. Отступы рамки по умолчанию предоставляются стилем и зависят от текущих флагов окна.

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

См. также unsetWindowFrameMargins(), getWindowFrameMargins(), и windowFrameRect().

[override virtual] QPainterPath QGraphicsWidget::shape() const

Переопределено из QGraphicsItem::shape().

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

Этот обработчик событий для событий Show доставляется до отображения виджета, например, когда вызов setVisible(true) был сделан для виджета или одного из его предков, когда виджет был ранее скрыт.

Вы можете переопределить этот обработчик событий, чтобы определить, когда ваш виджет отображается. Вызов QEvent::accept() или QEvent::ignore() на event не имеет эффекта.

См. также hideEvent(), QWidget::showEvent(), и ItemVisibleChange.

[override virtual protected] QSizeF QGraphicsWidget::sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const

Переопределено из QGraphicsLayoutItem::sizeHint().

QStyle *QGraphicsWidget::style() const

Возвращает указатель на стиль виджета. Если у этого виджета нет явно назначенного стиля, возвращается стиль сцены. В свою очередь, если у сцены нет назначенного стиля, эта функция возвращает QApplication::style().

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

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

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

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

[override virtual] int QGraphicsWidget::type() const

Переопределено из QGraphicsItem::type().

[virtual protected] void QGraphicsWidget::ungrabKeyboardEvent(QEvent *event)

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

См. также ungrabKeyboard() и ungrabMouse().

[virtual protected] void QGraphicsWidget::ungrabMouseEvent(QEvent *event)

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

См. также ungrabMouse() и ungrabKeyboard().

void QGraphicsWidget::unsetWindowFrameMargins()

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

См. также setWindowFrameMargins(), getWindowFrameMargins(), и windowFrameRect().

[override virtual protected] void QGraphicsWidget::updateGeometry()

Переопределено из QGraphicsLayoutItem::updateGeometry().

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

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

См. также QGraphicsLayout::invalidate().

[virtual protected] bool QGraphicsWidget::windowFrameEvent(QEvent *event)

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

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

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

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

QRectF QGraphicsWidget::windowFrameGeometry() const

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

См. также windowFrameRect(), getWindowFrameMargins(), и setWindowFrameMargins().

QRectF QGraphicsWidget::windowFrameRect() const

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

См. также windowFrameGeometry(), getWindowFrameMargins(), и setWindowFrameMargins().

[virtual protected] Qt::WindowFrameSection QGraphicsWidget::windowFrameSectionAt(const QPointF &pos) const

Возвращает сектор рамки окна в позиции pos или Qt::NoSection, если в этой позиции нет секции рамки окна.

Эта функция используется в базовой реализации QGraphicsWidget для взаимодействия с рамкой окна.

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

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

См. также windowFrameEvent(), paintWindowFrame(), и windowFrameGeometry().

Qt::WindowType QGraphicsWidget::windowType() const

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

См. также windowFlags(), isWindow(), и isPanel().