Класс QToolBar

Класс QToolBar предоставляет перемещаемую панель, содержащую набор элементов управления. Подробнее...

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

Свойства

• 58 свойств, унаследованных от QWidget
• 1 свойство, унаследованное от QObject

Открытые функции

• 211 открытых функций, унаследованных от QWidget
• 31 открытых функций, унаследованных от QObject
• 14 открытых функций, унаследованных от QPaintDevice

Открытые слоты

• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject

Сигналы

• 3 сигнала, унаследованных от QWidget
• 2 сигнала, унаследованных от QObject

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

• 35 защищённых функций, унаследованных от QWidget
• 9 защищённых функций, унаследованных от QObject
• 1 защищённая функция, унаследованная от QPaintDevice

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

• 5 статических публичных членов, унаследованных от QWidget
• 11 статических публичных членов, унаследованных от QObject
• 35 защищённых функций, унаследованных от QWidget
• 9 защищённых функций, унаследованных от QObject
• 1 защищённая функция, унаследованная от QPaintDevice
• 1 защищённый слот, унаследованный от QWidget

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

Класс QToolBar предоставляет перемещаемую панель, содержащую набор элементов управления.

Кнопки панели инструментов добавляются путём добавления действий с помощью addAction() или insertAction(). Группы кнопок можно разделить, используя addSeparator() или insertSeparator(). Если кнопка панели инструментов не подходит, вместо неё можно вставить виджет с помощью addWidget() или insertWidget(). Примерами подходящих виджетов являются QSpinBox, QDoubleSpinBox и QComboBox. При нажатии кнопки панели инструментов генерится сигнал actionTriggered().

Панель инструментов может быть зафиксирована в определённой области (например, в верхней части окна) или перемещаться между областями панели инструментов; см. setMovable(), isMovable(), allowedAreas() и isAreaAllowed().

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

Если QToolBar не является дочерним элементом QMainWindow, он теряет возможность заполнить всплывающее окно расширения виджетами, добавленными на панель инструментов с помощью addWidget(). Вместо этого используйте действия виджетов, созданные путём наследования QWidgetAction и реализации QWidgetAction::createWidget().

См. также QToolButton, QMenu, QAction и Пример приложения.

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

QToolBar::QToolBar(const QString &title, QWidget *parent = Q_NULLPTR)

Создаёт QToolBar с заданным parent.

Заданное окно title идентифицирует панель инструментов и отображается в контекстном меню, предоставляемом QMainWindow.

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

QToolBar::QToolBar(QWidget *parent = Q_NULLPTR)

Создаёт QToolBar с заданным parent.

QToolBar::~QToolBar()

Удаляет панель инструментов.

QAction *QToolBar::actionAt(const QPoint &p) const

Возвращает действие в точке p. Эта функция возвращает ноль, если действие не найдено.

См. также QWidget::childAt().

QAction *QToolBar::actionAt(int x, int y) const

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

Возвращает действие в точке x, y. Эта функция возвращает ноль, если действие не найдено.

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

Переопределено из QWidget::actionEvent().

[signal] void QToolBar::actionTriggered(QAction *action)

Этот сигнал испускается, когда действие в этой панели инструментов активируется. Это происходит, когда кнопка инструмента действия нажимается, или когда действие активируется каким-либо другим способом вне панели инструментов. Параметр содержит активированное действие.

QAction *QToolBar::addAction(const QString &text)

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

Создаёт новое действие с заданным text. Это действие добавляется в конец панели инструментов.

QAction *QToolBar::addAction(const QIcon &icon, const QString &text)

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

Создаёт новое действие с заданным icon и text. Это действие добавляется в конец панели инструментов.

QAction *QToolBar::addAction(const QString &text, const QObject *receiver, const char *member)

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

Создаёт новое действие с заданным text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к member в receiver.

QAction *QToolBar::addAction(const QIcon &icon, const QString &text, const QObject *receiver, const char *member)

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

Создаёт новое действие с заданным icon и text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к member в receiver.

QAction *QToolBar::addAction(const QString &text, const QObject *receiver, PointerToMemberFunction method)

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

Создаёт новое действие с заданным text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к method объекта receiver.

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

QAction *QToolBar::addAction(const QString &text, Functor functor)

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

Создаёт новое действие с заданным text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к functor.

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

QAction *QToolBar::addAction(const QString &text, const QObject *context, Functor functor)

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

Создаёт новое действие с заданным text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к functor.

Если context уничтожается, functor не будет вызван.

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

QAction *QToolBar::addAction(const QIcon &icon, const QString &text, const QObject *receiver, PointerToMemberFunction method)

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

Создаёт новое действие с заданным icon и text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к method объекта receiver.

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

QAction *QToolBar::addAction(const QIcon &icon, const QString &text, Functor functor)

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

Создаёт новое действие с заданным icon и text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к functor.

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

QAction *QToolBar::addAction(const QIcon &icon, const QString &text, const QObject *context, Functor functor)

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

Создаёт новое действие с заданным icon и text. Это действие добавляется в конец панели инструментов. Сигнал triggered() действия подключается к functor.

Если context уничтожается, functor не будет вызван.

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

QAction *QToolBar::addSeparator()

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

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

QAction *QToolBar::addWidget(QWidget *widget)

Добавляет заданный widget в панель инструментов как последний элемент.

Панель инструментов принимает владение widget.

Если вы добавляете QToolButton с помощью этого метода, стиль панели инструментов Qt::ToolButtonStyle не будет учтён.

Примечание: Используйте QAction::setVisible(), чтобы изменить видимость виджета. Использование QWidget::setVisible(), QWidget::show() и QWidget::hide() не работает.

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

[signal] void QToolBar::allowedAreasChanged(Qt::ToolBarAreas allowedAreas)

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

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

См. также allowedAreas.

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

Переопределено из QWidget::changeEvent().

void QToolBar::clear()

Удаляет все действия из панели инструментов.

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

[virtual protected] bool QToolBar::event(QEvent *event)

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

[signal] void QToolBar::iconSizeChanged(const QSize &iconSize)

Этот сигнал испускается при изменении размера значка. Параметр iconSize содержит новый размер значка панели инструментов.

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

См. также iconSize и QMainWindow::iconSize.

QAction *QToolBar::insertSeparator(QAction *before)

Вставляет разделитель в панель инструментов перед элементом панели инструментов, связанным с действием before.

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

QAction *QToolBar::insertWidget(QAction *before, QWidget *widget)

Вставляет заданный widget перед элементом панели инструментов, связанным с действием before.

Примечание: для изменения видимости виджета необходимо использовать QAction::setVisible(). Использование QWidget::setVisible(), QWidget::show() и QWidget::hide() не работает.

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

bool QToolBar::isAreaAllowed(Qt::ToolBarArea area) const

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

[signal] void QToolBar::movableChanged(bool movable)

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

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

См. также movable.

[signal] void QToolBar::orientationChanged(Qt::Orientation orientation)

Этот сигнал подаётся, когда ориентация панели инструментов изменяется. Параметр orientation содержит новую ориентацию панели инструментов.

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

См. также orientation.

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

Переопределено из QWidget::paintEvent().

QAction *QToolBar::toggleViewAction() const

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

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

См. также QAction::text и QWidget::windowTitle.

[signal] void QToolBar::toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)

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

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

См. также toolButtonStyle и QMainWindow::toolButtonStyle.

[signal] void QToolBar::topLevelChanged(bool topLevel)

Этот сигнал подаётся, когда меняется свойство floating. Параметр topLevel равен true, если панель инструментов сейчас плавающая; в противном случае — false.

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

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

[signal] void QToolBar::visibilityChanged(bool visible)

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

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

QWidget *QToolBar::widgetForAction(QAction *action) const

Возвращает виджет, связанный с заданным действием action.

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

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