Класс QToolBox

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

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

Свойства

• count : const int
• currentIndex : int

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

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

Сигналы

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

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

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

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

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

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

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

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

См. также QTabWidget.

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

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

Создаёт новый QToolBox с заданным parent и флагами, f.

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

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

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

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

Устанавливает widget в качестве текущего виджета. widget должен быть элементом этого QToolBox.

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

[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(QEvent *ev).

QWidget *QToolBox::currentWidget() const

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

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

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

Переопределяет: QFrame::event(QEvent *e).

int QToolBox::indexOf(const 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 из набора инструментов. Обратите внимание, что виджет не удаляется.

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

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

Переопределяет: QWidget::showEvent(QShowEvent *event).

QWidget *QToolBox::widget(int index) const

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