Класс QToolBox

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

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

Свойства

• count : const int
• currentIndex : int

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

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

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

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

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

Сигналы

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

Статические открытые члены

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

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

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

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

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

• 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 = nullptr, Qt::WindowFlags f = ...)

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

[virtual] 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. Возвращает индекс новой вкладки.

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

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

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

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

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

QWidget *QToolBox::currentWidget() const

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

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

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

Переопределено из QFrame::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 истинно, то элемент в позиции 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().

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

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

QWidget *QToolBox::widget(int index) const

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