Класс QTabWidget

Класс QTabWidget предоставляет набор вкладок. Подробнее...

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

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

Свойства

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

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

Переопределённые открытые функции

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

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

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

Сигналы

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

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

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

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

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

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

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

Класс QTabWidget предоставляет набор вкладок.

Вкладка предоставляет панель вкладок (см. QTabBar) и область страниц, используемую для отображения страниц, связанных с каждой вкладкой. По умолчанию панель вкладок отображается над областью страниц, но доступны различные конфигурации (см. TabPosition). Каждая вкладка связана с отдельным виджетом (называемым страницей). Только текущая страница отображается в области страниц; все остальные страницы скрыты. Пользователь может отобразить другую страницу, щелкнув по её вкладке или нажав сочетание клавиш Alt+буква, если оно есть.

Обычный способ использования QTabWidget заключается в следующем:

1. Создайте QTabWidget.
2. Создайте QWidget для каждой из страниц в диалоге вкладок, но не указывайте для них родительских виджетов.
3. Вставьте дочерние виджеты на страницу, используя макеты, чтобы разместить их как обычно.
4. Вызовите addTab() или insertTab() для размещения страниц виджетов в виджете вкладок, присваивая каждой вкладке подходящее имя с необязательным сочетанием клавиш.

Положение вкладок определяется свойством tabPosition, их форма — свойством tabShape.

Сигнал currentChanged() генерируется, когда пользователь выбирает страницу.

Индекс текущей страницы доступен как currentIndex(), текущий виджет страницы — с помощью currentWidget(). Вы можете получить указатель на виджет страницы с заданным индексом, используя widget(), и найти позицию индекса виджета с помощью indexOf(). Используйте setCurrentWidget() или setCurrentIndex() для отображения конкретной страницы.

Вы можете изменить текст и значок вкладки, используя setTabText() или setTabIcon(). Вкладку и связанную с ней страницу можно удалить с помощью removeTab().

Каждая вкладка может быть включена или выключена в любой момент (см. setTabEnabled()). Если вкладка включена, текст вкладки отображается нормально, и пользователь может выбрать эту вкладку. Если она отключена, вкладка отображается другим способом, и пользователь не может выбрать эту вкладку. Обратите внимание, что даже если вкладка отключена, страница всё равно может быть видимой, например, если все вкладки отключены.

Виджеты вкладок могут быть очень хорошим способом разбить сложный диалог. Альтернативой является использование QStackedWidget, для которого вы предоставляете способ перемещения между страницами, например, QToolBar или QListWidget.

Большая часть функциональности в QTabWidget обеспечивается QTabBar (вверху, предоставляя вкладки) и QStackedWidget (большая часть области, организующей отдельные страницы).

Виджет вкладок в стиле Windows Vista.	Виджет вкладок в стиле Macintosh.	Виджет вкладок в стиле Fusion.

См. также QTabBar, QStackedWidget, QToolBox и Пример диалога вкладок.

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

перечисление QTabWidget::TabPosition

Это перечисление определяет, где QTabWidget рисует строку вкладок:

перечисление QTabWidget::TabShape

Это перечисление определяет форму вкладок:

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

QTabWidget::QTabWidget(QWidget *parent = Q_NULLPTR)

Создаёт виджет с вкладками с родителем parent.

QTabWidget::~QTabWidget()

Уничтожает виджет с вкладками.

int QTabWidget::addTab(QWidget *page, const QString &label)

Добавляет вкладку с заданной page и label в виджет вкладок и возвращает индекс вкладки в панели вкладок.

Если label вкладки содержит амперсанд (&), буква, следующая за амперсандом, используется в качестве сочетания клавиш для вкладки, например, если метка — "Обз&ор", то Alt+О становится сочетанием клавиш, которое переместит фокус на эту вкладку.

Примечание: Если вы вызываете addTab() после show(), система макета попытается скорректировать изменения в иерархии виджетов и может вызвать мерцание. Чтобы предотвратить это, вы можете установить свойство QWidget::updatesEnabled в false до изменений; помните, чтобы установить свойство в true после завершения изменений, чтобы виджет снова получал события отрисовки.

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

int QTabWidget::addTab(QWidget *page, const QIcon &icon, const QString &label)

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

Добавляет вкладку с заданным page, icon и label в виджет вкладок и возвращает индекс вкладки в панели вкладок.

Эта функция аналогична addTab(), но с дополнительным параметром icon.

[virtual protected] void QTabWidget::changeEvent(QEvent *ev)

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

void QTabWidget::clear()

Удаляет все страницы, но не удаляет их. Вызов этой функции эквивалентен вызову removeTab() до тех пор, пока виджет вкладок не станет пустым.

QWidget *QTabWidget::cornerWidget(Qt::Corner corner = Qt::TopRightCorner) const

Возвращает виджет, отображаемый в углу виджета вкладок, или 0.

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

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

Этот сигнал излучается всякий раз, когда изменяется индекс текущей страницы. Параметр — это новое положение индекса текущей страницы, или -1, если новой страницы нет (например, если в виджете QTabWidget нет виджетов).

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

См. также currentWidget() и currentIndex.

QWidget *QTabWidget::currentWidget() const

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

См. также currentIndex() и setCurrentWidget().

[virtual protected] bool QTabWidget::event(QEvent *ev)

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

[virtual] bool QTabWidget::hasHeightForWidth() const

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

[virtual] int QTabWidget::heightForWidth(int width) const

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

int QTabWidget::indexOf(QWidget *w) const

Возвращает позицию индекса страницы, занимаемой виджетом w, или -1, если виджет не найден.

[protected] void QTabWidget::initStyleOption(QStyleOptionTabWidgetFrame *option) const

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

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

int QTabWidget::insertTab(int index, QWidget *page, const QString &label)

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

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

Если метка вкладки содержит амперсанд, буква, следующая за амперсандом, используется в качестве сочетания клавиш для вкладки, например, если метка — "Просм&отр", то Alt+О станет сочетанием клавиш, которое переместит фокус на эту вкладку.

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

Если QTabWidget был пустым до вызова этой функции, новая страница становится текущей страницей. Вставка новой вкладки в индекс, меньший или равный текущему индексу, увеличит текущий индекс, но сохранит текущую страницу.

Примечание: Если вы вызываете insertTab() после show(), система макета попытается адаптироваться к изменениям в иерархии виджетов и может вызвать мерцание. Чтобы предотвратить это, вы можете установить свойство QWidget::updatesEnabled в false перед изменениями; помните, чтобы установить свойство в true, когда изменения будут выполнены, чтобы виджет снова получал события отрисовки.

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

int QTabWidget::insertTab(int index, QWidget *page, const QIcon &icon, const QString &label)

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

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

Эта функция аналогична insertTab(), но с дополнительным параметром icon.

bool QTabWidget::isTabEnabled(int index) const

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

См. также setTabEnabled() и QWidget::isEnabled().

[virtual protected] void QTabWidget::keyPressEvent(QKeyEvent *e)

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

[virtual] QSize QTabWidget::minimumSizeHint() const

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

Возвращает подходящий минимальный размер для виджета вкладок.

[virtual protected] void QTabWidget::paintEvent(QPaintEvent *event)

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

Отрисовывает панель вкладок виджета вкладок в ответ на событие отрисовки event.

void QTabWidget::removeTab(int index)

Удаляет вкладку в позиции index из этого стека виджетов. Сам виджет страницы не удаляется.

См. также addTab() и insertTab().

[virtual protected] void QTabWidget::resizeEvent(QResizeEvent *e)

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

void QTabWidget::setCornerWidget(QWidget *widget, Qt::Corner corner = Qt::TopRightCorner)

Устанавливает заданный widget для отображения в указанном corner виджета вкладок. Геометрия виджета определяется на основе sizeHint() виджета и style().

Будет использоваться только горизонтальный элемент corner.

Передача 0 скрывает виджет в углу.

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

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

Примечание: Виджеты углов предназначены для положений вкладок North и South; известно, что другие ориентации работают неправильно.

См. также cornerWidget() и setTabPosition().

[slot] void QTabWidget::setCurrentWidget(QWidget *widget)

Делает widget текущим виджетом. Используемый widget должен быть страницей в этом виджете вкладок.

См. также addTab(), setCurrentIndex() и currentWidget().

[protected] void QTabWidget::setTabBar(QTabBar *tb)

Заменяет заголовок диалогового окна QTabBar на панель вкладок tb. Обратите внимание, что это нужно сделать *до* добавления вкладок, в противном случае поведение неопределено.

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

void QTabWidget::setTabEnabled(int index, bool enable)

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

QTabWidget использует QWidget::setEnabled() внутри, а не хранит отдельный флаг.

Обратите внимание, что даже отключенная вкладка/страница может быть видимой. Если страница уже видна, QTabWidget не будет её скрывать; если все страницы отключены, QTabWidget отобразит одну из них.

См. также isTabEnabled() и QWidget::setEnabled().

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

Это перегруженный метод.

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

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

void QTabWidget::setTabText(int index, const QString &label)

Определяет новое название для вкладки страницы на позиции index.

Если предоставленный текст содержит символ амперсанда ('&'), для него автоматически создается сочетание клавиш. Символ, следующий за '&', будет использован в качестве клавиши сочетания. Любое предыдущее сочетание клавиш будет перезаписано или очищено, если сочетание не определено текстом. Подробности см. в документации QShortcut (чтобы отобразить фактический амперсанд, используйте '&&').

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

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

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

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

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

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

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

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

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

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

[virtual] QSize QTabWidget::sizeHint() const

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

QTabBar *QTabWidget::tabBar() const

Возвращает текущую QTabBar.

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

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

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

index обозначает нажатую вкладку или -1, если под курсором нет вкладки.

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

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

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

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

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

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

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

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

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

QIcon QTabWidget::tabIcon(int index) const

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

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

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

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

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

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

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

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

QString QTabWidget::tabText(int index) const

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

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

QString QTabWidget::tabToolTip(int index) const

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

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

QString QTabWidget::tabWhatsThis(int index) const

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

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

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

QWidget *QTabWidget::widget(int index) const

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