Класс QTabBar

Класс QTabBar предоставляет панель вкладок, например, для использования в диалоговых окнах с вкладками. Подробнее...

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

Общие типы

Свойства

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

Реализованные общедоступные функции

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

Сигналы

Protected Functions

Reimplemented Protected Functions

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

QTabBar проста в использовании; она рисует вкладки, используя один из предопределённых видов, и излучает сигнал, когда вкладка выбрана. Она может быть расширена для настройки внешнего вида.

Каждая вкладка имеет текст, необязательный значок, необязательный подсказку, необязательный WhatsThis и необязательные данные. Атрибуты вкладок можно изменить с помощью setTabText, setTabIcon, setTabToolTip, setTabWhatsThis и setTabData. Каждая вкладка может быть включена или выключена индивидуально с помощью setTabEnabled.

Каждая вкладка может отображать текст в различных цветах. Текущий цвет текста для вкладки можно найти с помощью функции tabTextColor. Установите цвет текста для определённой вкладки с помощью setTabTextColor.

Вкладки добавляются с помощью addTab, или вставляются в определённые позиции с помощью insertTab. Общее количество вкладок задаётся свойством count. Вкладки могут быть удалены с помощью removeTab. Комбинирование removeTab и insertTab позволяет переместить вкладки в разные позиции.

Свойство shape определяет внешний вид вкладок. Выбор формы - дело вкуса, хотя диалоговые окна вкладок (для настроек и т.п.) неизменно используют RoundedNorth. Элементы управления вкладками в окнах, отличных от диалоговых окон, почти всегда используют либо RoundedSouth, либо TriangularSouth. Многие электронные таблицы и другие элементы управления вкладками, в которых все страницы по существу одинаковы, используют TriangularSouth, в то время как RoundedSouth используется в основном, когда страницы отличаются (например, многостраничный инструмент палитра). По умолчанию в QTabBar - RoundedNorth.

Самая важная часть API QTabBar - сигнал currentChanged. Он излучается всякий раз, когда текущая вкладка изменяется (даже при запуске, когда текущая вкладка меняется с «пустой»). Также есть слот setCurrentIndex, который может использоваться для программного выбора вкладки. Функция currentIndex() возвращает индекс текущей вкладки, а count хранит количество вкладок.

QTabBar создаёт автоматические мнемонические клавиши в стиле QAbstractButton; например, если метка вкладки — «&Графика», сочетание клавиш Alt+G становится сочетанием клавиш для переключения на эту вкладку.

Следующие виртуальные функции могут потребовать переопределения для настройки внешнего вида или хранения дополнительных данных с каждой вкладкой:

• tabSizeHint() вычисляет размер вкладки.
• tabInserted() уведомляет о добавлении новой вкладки.
• tabRemoved() уведомляет об удалении вкладки.
• tabLayoutChange() уведомляет о перераспределении вкладок.
• paintEvent() отрисовывает все вкладки.

Для подклассов вам также могут понадобиться функции tabRect(), которые возвращают визуальную геометрию одной вкладки.

	Панель вкладок, показанная в стиле виджета Fusion.
	Усечённая панель вкладок, показанная в стиле виджета Fusion.

См. такжеQTabWidget.

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

перечисление QTabBar::ButtonPosition

Это перечисление типов, перечисляющее местоположение виджета на вкладке.

Это перечисление было введено или изменено в Qt 4.5.

перечисление QTabBar::SelectionBehavior

Это перечисление типов, перечисляющее поведение QTabBar, когда вкладка удалена, а удаляемая вкладка является также текущей.

Это перечисление было введено или изменено в Qt 4.5.

перечисление QTabBar::Shape

Это перечисление типов, перечисляющее встроенные формы, поддерживаемые QTabBar. Рассматривайте их как подсказки, так как некоторые стили могут не отображать некоторые формы. Однако положение должно соблюдаться.

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

QTabBar::QTabBar(QWidget *parent = nullptr)

Создаёт новую вкладку с заданным parent.

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

Этот сигнал испускается, когда текущая вкладка вкладки изменяется. Новая текущая вкладка имеет заданный index или -1, если новой нет (например, если в QTabBar нет вкладок).

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

[signal] void QTabBar::tabBarClicked(int index)

Этот сигнал испускается, когда пользователь нажимает на вкладку с индексом index.

index — индекс нажатой вкладки или -1, если под курсором нет вкладки.

Эта функция была добавлена в Qt 5.2.

[signal] void QTabBar::tabBarDoubleClicked(int index)

Этот сигнал испускается, когда пользователь дважды щелкает по вкладке с индексом index.

index — индекс нажатой вкладки или -1, если под курсором нет вкладки.

Эта функция была добавлена в Qt 5.2.

[signal] void QTabBar::tabCloseRequested(int index)

Этот сигнал испускается, когда нажата кнопка закрытия вкладки. index — индекс, который необходимо удалить.

Эта функция была добавлена в Qt 4.5.

См. также setTabsClosable().

[signal] void QTabBar::tabMoved(int from, int to)

Этот сигнал испускается, когда вкладка с индексом from перемещена в позицию с индексом to.

Примечание: QTabWidget автоматически переместит страницу, когда этот сигнал будет испущен из его вкладки.

Эта функция была добавлена в Qt 4.5.

См. также moveTab().

[virtual] QTabBar::~QTabBar()

Удаляет вкладку.

QString QTabBar::accessibleTabName(int index) const

Возвращает accessibleName вкладки с индексом index или пустую строку, если index находится вне диапазона.

См. также setAccessibleTabName().

int QTabBar::addTab(const QString &text)

Добавляет новую вкладку с текстом text. Возвращает индекс новой вкладки.

int QTabBar::addTab(const QIcon &icon, const QString &text)

Это перегруженная функция.

Добавляет новую вкладку с изображением icon и текстом text. Возвращает индекс новой вкладки.

[override virtual protected] void QTabBar::changeEvent(QEvent *event)

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

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

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

[override virtual protected] void QTabBar::hideEvent(QHideEvent *)

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

[protected] void QTabBar::initStyleOption(QStyleOptionTab *option, int tabIndex) const

Инициализирует option значениями из вкладки с индексом tabIndex. Этот метод полезен для подклассов, когда им нужен QStyleOptionTab, но они не хотят заполнять всю информацию сами.

См. также QStyleOption::initFrom() и QTabWidget::initStyleOption().

int QTabBar::insertTab(int index, const QString &text)

Вставляет новую вкладку с текстом text в позицию index. Если index находится вне диапазона, новая вкладка добавляется. Возвращает индекс новой вкладки.

int QTabBar::insertTab(int index, const QIcon &icon, const QString &text)

Это перегруженная функция.

Вставляет новую вкладку с изображением icon и текстом text в позицию index. Если index находится вне диапазона, новая вкладка добавляется. Возвращает индекс новой вкладки.

Если QTabBar был пустым до вызова этой функции, вставленная вкладка становится текущей вкладкой.

Вставка новой вкладки в индекс, меньший или равный текущему индексу, увеличивает текущий индекс, но сохраняет текущую вкладку.

bool QTabBar::isTabEnabled(int index) const

Возвращает true , если вкладка с индексом index включена; в противном случае возвращает false.

bool QTabBar::isTabVisible(int index) const

Возвращает true, если вкладка с индексом index видимая; в противном случае возвращает false.

Эта функция была добавлена в Qt 5.15.

[override virtual protected] void QTabBar::keyPressEvent(QKeyEvent *event)

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

[override virtual] QSize QTabBar::minimumSizeHint() const

Переопределяет функцию доступа к свойству: QWidget::minimumSizeHint.

[virtual protected] QSize QTabBar::minimumTabSizeHint(int index) const

Возвращает минимальный размер вкладки с индексом index.

Эта функция была добавлена в Qt 5.0.

[override virtual protected] void QTabBar::mouseMoveEvent(QMouseEvent *event)

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

[override virtual protected] void QTabBar::mousePressEvent(QMouseEvent *event)

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

[override virtual protected] void QTabBar::mouseReleaseEvent(QMouseEvent *event)

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

void QTabBar::moveTab(int from, int to)

Перемещает элемент с индексом from в позицию с индексом to.

Эта функция была добавлена в Qt 4.5.

См. также tabMoved() и tabLayoutChange().

[override virtual protected] void QTabBar::paintEvent(QPaintEvent *)

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

void QTabBar::removeTab(int index)

Удаляет вкладку с индексом index.

См. также SelectionBehavior.

[override virtual protected] void QTabBar::resizeEvent(QResizeEvent *)

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

void QTabBar::setAccessibleTabName(int index, const QString &name)

Устанавливает accessibleName вкладки с индексом index на name.

См. также accessibleTabName().

void QTabBar::setTabButton(int index, QTabBar::ButtonPosition position, QWidget *widget)

Устанавливает widget на вкладке index. Виджет размещается слева или справа в зависимости от position.

Любой ранее установленный виджет в положение скрывается.

Панель вкладок получит владение виджетом, и все виджеты, установленные здесь, будут удалены панелью вкладок при ее уничтожении, если вы не переместите виджет отдельно после установки другого виджета (или nullptr).

Эта функция была добавлена в Qt 4.5.

См. также tabButton() и tabsClosable().

void QTabBar::setTabData(int index, const QVariant &data)

Устанавливает данные вкладки в позиции index на data.

См. также tabData().

void QTabBar::setTabEnabled(int index, bool enabled)

Если enabled равно true, то вкладка в позиции index включена; в противном случае элемент в позиции index отключен.

См. также isTabEnabled().

void QTabBar::setTabIcon(int index, const QIcon &icon)

Устанавливает значок вкладки в позиции index на icon.

См. также tabIcon().

void QTabBar::setTabText(int index, const QString &text)

Устанавливает текст вкладки в позиции index на text.

См. также tabText().

void QTabBar::setTabTextColor(int index, const QColor &color)

Устанавливает цвет текста вкладки с заданным index на указанный color.

Если указан недопустимый цвет, вкладка будет использовать роль фонового цвета QTabBar.

См. также tabTextColor().

void QTabBar::setTabToolTip(int index, const QString &tip)

Устанавливает всплывающую подсказку вкладки в позиции index на tip.

См. также tabToolTip().

void QTabBar::setTabVisible(int index, bool visible)

Если visible равно true, то вкладка в позиции index отображается; в противном случае она скрывается.

Эта функция была добавлена в Qt 5.15.

См. также isTabVisible().

void QTabBar::setTabWhatsThis(int index, const QString &text)

Устанавливает текст справки What's This для вкладки в позиции index на text.

Эта функция была добавлена в Qt 4.1.

См. также tabWhatsThis().

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

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

[override virtual] QSize QTabBar::sizeHint() const

Переопределяет функцию доступа к свойству: QWidget::sizeHint.

int QTabBar::tabAt(const QPoint &position) const

Возвращает индекс вкладки, которая содержит position, или -1, если никакая вкладка не содержит position;

Эта функция была добавлена в Qt 4.3.

QWidget *QTabBar::tabButton(int index, QTabBar::ButtonPosition position) const

Возвращает виджет, установленный для вкладки index и position, или nullptr если он не установлен.

См. также setTabButton().

QVariant QTabBar::tabData(int index) const

Возвращает данные вкладки в позиции index или пустой вариант, если index находится вне диапазона.

См. также setTabData().

QIcon QTabBar::tabIcon(int index) const

Возвращает значок вкладки в позиции index или пустой значок, если index находится вне диапазона.

См. также setTabIcon().

[virtual protected] void QTabBar::tabInserted(int index)

Этот виртуальный обработчик вызывается после добавления или вставки новой вкладки в позицию index.

См. также tabRemoved().

[virtual protected] void QTabBar::tabLayoutChange()

Этот виртуальный обработчик вызывается всякий раз, когда изменяется расположение вкладок.

См. также tabRect().

QRect QTabBar::tabRect(int index) const

Возвращает визуальный прямоугольник вкладки в позиции index или пустой прямоугольник, если index скрыт или находится вне диапазона.

[virtual protected] void QTabBar::tabRemoved(int index)

Этот виртуальный обработчик вызывается после удаления вкладки из позиции index.

См. также tabInserted().

[virtual protected] QSize QTabBar::tabSizeHint(int index) const

Возвращает размер подсказки для вкладки в позиции index.

QString QTabBar::tabText(int index) const

Возвращает текст вкладки в позиции index или пустую строку, если index находится вне диапазона.

См. также setTabText().

QColor QTabBar::tabTextColor(int index) const

Возвращает цвет текста вкладки с заданным index или недопустимый цвет, если index находится вне диапазона.

См. также setTabTextColor().

QString QTabBar::tabToolTip(int index) const

Возвращает всплывающую подсказку вкладки в позиции index или пустую строку, если index находится вне диапазона.

См. также setTabToolTip().

QString QTabBar::tabWhatsThis(int index) const

Возвращает текст справки What's This для вкладки в позиции index или пустую строку, если index находится вне диапазона.

Эта функция была добавлена в Qt 4.1.

См. также setTabWhatsThis().

[override virtual protected] void QTabBar::timerEvent(QTimerEvent *event)

Переопределяет: QObject::timerEvent(QTimerEvent *event).

[override virtual protected] void QTabBar::wheelEvent(QWheelEvent *event)

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