Класс QToolBox

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

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

Свойства

• count : const int
• currentIndex : int

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

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

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

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

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

Сигналы

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

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

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

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

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

• 1 открытая переменная унаследовано от QObject
• 5 статические открытые члены унаследовано от QWidget
• 10 статических открытых членов унаследовано от QObject
• 1 защищённый слот унаследовано от QWidget
• 2 защищённых переменных унаследовано от QObject
• 1 защищённый тип унаследовано от QPaintDevice

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

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

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

Создает новую палитру инструментов с заданным 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 равно 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().

QWidget *QToolBox::widget(int index) const

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