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

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

Любой ранее установленный виджет в 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::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).