Класс QTabBar

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

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

Открытые типы

Свойства

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

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

Реализованные публичные функции

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

Публичные слоты

• 19 публичных слотов, унаследованных от QWidget
• 1 публичный слот, унаследованный от QObject

Сигналы

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

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

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

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

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

• 5 статических публичных членов унаследованы от QWidget
• 11 статических публичных членов унаследованы от QObject
• 1 защищенный слот унаследован от QWidget

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

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

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

Каждая вкладка имеет текст вкладки, необязательный значок вкладки, необязательный подсказку вкладки, необязательный справочник вкладки и необязательные данные вкладки. Атрибуты вкладок можно изменить с помощью 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 = Q_NULLPTR)

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

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. Возвращает индекс новой вкладки.

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

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

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

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

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

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

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

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

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

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

[virtual] QSize QTabBar::minimumSizeHint() const

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

void QTabBar::removeTab(int index)

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

См. также SelectionBehavior.

[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, 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)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[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 или недействительный цвет, если index находится за пределами диапазона.

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

QString QTabBar::tabToolTip(int index) const

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

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

QString QTabBar::tabWhatsThis(int index) const

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

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

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

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

Переопределено из QObject::timerEvent().

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

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