Класс 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 истинно, элемент в позиции 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 , если такого элемента нет.