Класс QToolBar

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

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

Свойства

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

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

• 214 public functions inherited from QWidget
• 31 public functions inherited from QObject
• 14 public functions inherited from QPaintDevice

Public Slots

• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject

Сигналы

• 3 signals inherited from QWidget
• 2 signals inherited from QObject

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

• 5 статических публичных членов унаследовано от QWidget
• 9 статических публичных членов унаследовано от QObject

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

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

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

• 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 = 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)

Вставляет заданный 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().