Класс QTabBar

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

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

Общие типы

Свойства

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

Общедоступные функции

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

• 214 общедоступные функции, унаследованные от QWidget
• 34 общедоступные функции, унаследованные от QObject
• 14 общедоступные функции, унаследованные от QPaintDevice

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

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

Сигналы

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

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

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

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

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

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

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

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

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.

enum QTabBar::Shape

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

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

QTabBar::QTabBar(QWidget *parent = nullptr)

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

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

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

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

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

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

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

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

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

[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.

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

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

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

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

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

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

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

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

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

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

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

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

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

void QTabBar::removeTab(int index)

Удаляет вкладку по позиции index.

См. также SelectionBehavior.

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

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

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.

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

Вкладка получит владение виджетом, и поэтому все виджеты, установленные здесь, будут удалены вкладкой при её уничтожении, если вы не переместите виджет в другую вкладку или установите в 0.

Эта функция была введена в 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)

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

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

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

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

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

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

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

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

Переопределено из QWidget::sizeHint().

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

QVariant QTabBar::tabData(int index) const

Возвращает данные вкладки по позиции index, или пустой объект QVariant, если 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().

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

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

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

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

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

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 выходит за пределы диапазона.

См. также 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().

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

Переопределено из QWidget::wheelEvent().