Класс QToolBox

Класс QToolBox предоставляет столбец элементов виджетов с вкладками. Подробнее...

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

Свойства

• count : const int
• currentIndex : int

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

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

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

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

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

Сигналы

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

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

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

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

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

• 5 статических открытых членов, унаследованных от QWidget
• 11 статических открытых членов, унаследованных от QObject
• 1 защищённый слот, унаследованный от QWidget

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

Класс QToolBox предоставляет столбец элементов виджетов с вкладками.

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

Каждый элемент имеет itemText(), необязательный itemIcon(), необязательный itemToolTip() и widget(). Атрибуты элемента можно изменить с помощью setItemText(), setItemIcon() и setItemToolTip(). Каждый элемент можно включить или отключить индивидуально с помощью setItemEnabled().

Элементы добавляются с помощью addItem() или вставляются в определённые позиции с помощью insertItem(). Общее количество элементов задаётся count(). Элементы могут быть удалены с помощью delete или удалены из панели инструментов с помощью removeItem(). Сочетание removeItem() и insertItem() позволяет перемещать элементы в разные позиции.

Индекс текущего элемента виджета возвращается currentIndex(), и устанавливается с помощью setCurrentIndex(). Индекс конкретного элемента можно найти с помощью indexOf(), а элемент в заданном индексе возвращается методом item().

Сигнал currentChanged() излучается, когда текущий элемент изменяется.

См. также QTabWidget.

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

QToolBox::QToolBox(QWidget *parent = Q_NULLPTR, Qt::WindowFlags f = Qt::WindowFlags())

Создает новую инструментальную панель с заданным parent и флагами f.

QToolBox::~QToolBox()

Уничтожает инструментальную панель.

int QToolBox::addItem(QWidget *widget, const QIcon &iconSet, const QString &text)

Добавляет widget в новую вкладку в нижней части инструментальной панели. Текст новой вкладки устанавливается в text, а iconSet отображается слева от text. Возвращает индекс новой вкладки.

int QToolBox::addItem(QWidget *w, const QString &text)

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

Добавляет w в новую вкладку в нижней части инструментальной панели. Текст новой вкладки устанавливается в text. Возвращает индекс новой вкладки.

[virtual protected] void QToolBox::changeEvent(QEvent *ev)

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

[signal] void QToolBox::currentChanged(int index)

Этот сигнал генерируется при изменении текущего элемента. Индекс нового текущего элемента передается в index, или -1, если текущего элемента нет.

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

QWidget *QToolBox::currentWidget() const

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

См. также currentIndex() и setCurrentWidget().

[virtual protected] bool QToolBox::event(QEvent *e)

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

int QToolBox::indexOf(QWidget *widget) const

Возвращает индекс widget или -1, если элемент не существует.

int QToolBox::insertItem(int index, QWidget *widget, const QIcon &icon, const QString &text)

Вставляет widget в позицию index или в конец инструментальной панели, если index вне диапазона. Текст нового элемента устанавливается в text, а icon отображается слева от text. Возвращает индекс нового элемента.

int QToolBox::insertItem(int index, QWidget *widget, const QString &text)

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

Вставляет widget в позицию index или в конец инструментальной панели, если index вне диапазона. Текст нового элемента устанавливается в text. Возвращает индекс нового элемента.

bool QToolBox::isItemEnabled(int index) const

Возвращает true если элемент в позиции index включен; в противном случае возвращает false.

QIcon QToolBox::itemIcon(int index) const

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

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

[virtual protected] void QToolBox::itemInserted(int index)

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

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

[virtual protected] void QToolBox::itemRemoved(int index)

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

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

QString QToolBox::itemText(int index) const

Возвращает текст элемента в позиции index или пустую строку, если index вне диапазона.

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

QString QToolBox::itemToolTip(int index) const

Возвращает всплывающую подсказку элемента в позиции index или пустую строку, если index вне диапазона.

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

void QToolBox::removeItem(int index)

Удаляет элемент в позиции index из инструментальной панели. Обратите внимание, что виджет не удаляется.

[slot] void QToolBox::setCurrentWidget(QWidget *widget)

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

См. также addItem(), setCurrentIndex(), и currentWidget().

void QToolBox::setItemEnabled(int index, bool enabled)

Если enabled равно true, то элемент в позиции index включен; в противном случае элемент в позиции index отключен.

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

void QToolBox::setItemIcon(int index, const QIcon &icon)

Устанавливает значок элемента в позиции index на icon.

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

void QToolBox::setItemText(int index, const QString &text)

Устанавливает текст элемента в позиции index на text.

Если предоставленный текст содержит символ амперсанда ('&'), для него автоматически создается мнемоническое обозначение. Символ, следующий за '&', будет использоваться как сочетание клавиш. Любое предыдущее мнемоническое обозначение будет перезаписано или очищено, если мнемоническое обозначение не определено текстом. Подробности см. в документации по QShortcut (чтобы отобразить фактический амперсанд, используйте '&&').

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

void QToolBox::setItemToolTip(int index, const QString &toolTip)

Устанавливает всплывающую подсказку элемента в позиции index на toolTip.

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

[virtual protected] void QToolBox::showEvent(QShowEvent *e)

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

QWidget *QToolBox::widget(int index) const

Возвращает виджет в позиции index или 0, если такого элемента нет.