Класс QToolBar

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

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

Свойства

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

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

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

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

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

Сигналы

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

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

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

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

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

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

Класс 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 = nullptr)

Конструирует QToolBar с заданным parent.

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

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

QToolBar::QToolBar(QWidget *parent = nullptr)

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

[virtual] QToolBar::~QToolBar()

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

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

Возвращает действие в точке p. Если действие не найдено, возвращает ноль.

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

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

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

Возвращает действие в точке x, y. Если действие не найдено, возвращает ноль.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Этот метод был добавлен в Qt 5.6.

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

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

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

Этот метод был добавлен в Qt 5.6.

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

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

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

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

Этот метод был добавлен в Qt 5.6.

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

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

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

Этот метод был добавлен в Qt 5.6.

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

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

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

Этот метод был добавлен в Qt 5.6.

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

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

Создает новое действие с заданной иконкой и текстом. Это действие добавляется в конец панели инструментов. Сигнал 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.

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

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

void QToolBar::clear()

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

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

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

Переопределено из QWidget::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)

Вставляет заданный виджет перед элементом панели инструментов, связанным с действием 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.

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

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

См. также orientation.

[override 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().