Класс 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.

void QToolBox::currentChanged(int index)

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

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

void QToolBox::setCurrentWidget(QWidget *widget)

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

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

QToolBox::~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(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 , если такого элемента нет.