Шаг 92.
Библиотека PyQt5.
Размещение компонентов в окнах. Панель с вкладками (окончание)

    На этом шаге мы рассмотрим основные методы этого класса.

    Класс QTabWidget поддерживает следующие методы (здесь приведены только основные - полное описание класса содержится на странице https://doc.qt.io/qt-5/qtabwidget.html):

• addTab () - добавляет вкладку в конец контейнера и возвращает ее индекс. Форматы метода:

    addTab (<Компонент>, <Текст заголовка>)
    addTab (<Компонент>, <QIcon>, <Текст заголовка>)
  

      В параметре <Компонент> указывается ссылка на компонент, который будет отображаться на вкладке. Чаще всего этот компонент является лишь родителем для других компонентов. Параметр <Текст заголовка> задает текст, который будет отображаться на ярлыке в области заголовка. Внутри текста заголовка символ &, указанный перед буквой, задает комбинацию клавиш быстрого доступа. В этом случае буква, перед которой указан символ &, будет, в качестве подсказки пользователю, подчеркнута. При одновременном нажатии клавиши Alt и подчеркнутой буквы откроется соответствующая вкладка. Параметр <QIcon> позволяет указать значок (экземпляр класса QIcon), который отобразится перед текстом в области заголовка.

      Пример указания стандартного значка:

    style = window.style()
    icon = style.standardIcon(QtWidgets.QStyle.SP_DriveNetIcon)
    tab.addTab(QtWidgets.QLabel("Содержимое вкладки 1"), icon, "Вкладка &1")
  

      Пример загрузки значка из файла:

    icon = QtGui.QIcon("icon.png")
    tab.addTab(QtWidgets.QLabel("Содержимое вкладки 1"), icon, "Вкладка &1")
  

• insertTab () - добавляет вкладку в указанную позицию и возвращает индекс этой вкладки. Форматы метода:

    insertTab (<Индекс>, <Компонент>, <Текст заголовка>)
    insertTab (<Индекс>, <Компонент>, <QIcon>, <Текст заголовка>)
  

• removeTab (<Индекс>) - удаляет вкладку с указанным индексом, при этом компонент, который отображался на вкладке, не удаляется;

• clear () - удаляет все вкладки, при этом компоненты, которые отображались на вкладках, не удаляются;

• setTabText (<Индекс>, <Текст заголовка>) - задает текст заголовка для вкладки с указанным индексом;

• setElideMode (<Peжим>) - задает режим обрезки текста в названии вкладки, если он не помещается в отведенную область (в месте пропуска выводится троеточие). Могут быть указаны следующие атрибуты класса QtCore.Qt:
  • ElideLeft (или 0) - текст обрезается слева;
  • ElideRight (или 1) - текст обрезается справа;
  • ElideMiddie (или 2) - текст вырезается посередине;
  • ElideNone (или 3) - текст не обрезается;

• tabText (<Индекс>) - возвращает текст заголовка вкладки с указанным индексом;

• setTabIcon (<Индекс>, <QIcon>) - устанавливает значок перед текстом в заголовке вкладки с указанным индексом. Во втором параметре указывается экземпляр класса QIcon;

• setTabPosition (<Позиция>) - задает позицию области заголовка. Могут быть указаны следующие атрибуты класса QTabWidget:
  • North (или 0) - сверху;
  • South (или 1) - снизу;
  • West (или 2) - слева;
  • East (или 3) - справа.
  Пример:

    tab.setTabPosition(QtWidgets.QTabWidget.South)
  

• setTabShape (<Форма>) - задает форму углов ярлыка вкладки в области заголовка. Могут быть указаны следующие атрибуты класса QTabWidget:
  • Rounded (или 0) - скругленные углы (значение по умолчанию);
  • Triangular (или 1) - треугольная форма;

• setTabsClosable (<Флаг>) - если в качестве параметра указано значение True, то после текста заголовка вкладки будет отображена кнопка ее закрытия. По нажатию этой кнопки генерируется сигнал tabCloseRequested;

• setMovable (<Флаг>) - если в качестве параметра указано значение True, то ярлыки вкладок можно перемещать с помощью мыши;

• setDocumentMode (<Флаг>) - если в качестве параметра указано значение True, то область компонента не будет отображаться как панель;

• setUsesScrollButtons (<Флаг>) - если в качестве параметра указано значение True, то, когда все ярлыки вкладок не помещаются в область заголовка панели, появляются две кнопки, с помощью которых можно прокручивать область заголовка, тем самым отображая только часть ярлыков. Значение False запрещает скрытие ярлыков;

• setTabToolTip (<Индекс>, <Текст>) - задает текст всплывающей подсказки для ярлыка вкладки с указанным индексом;

• setTabWhatsThis (<Индекс>, <Текст>) - задает текст справки для ярлыка вкладки с указанным индексом;

• setTabEnabled (<Индекс>, <Флаг>) - если во втором параметре содержится значение False, то вкладка с указанным в первом параметре индексом станет недоступной. Значение True делает вкладку доступной;

• isTabEnabled (<Индекс>) - возвращает значение True, если вкладка с указанным индексом доступна, и False - в противном случае;

• setCurrentIndex (<Индекс>) - делает видимой вкладку с указанным в параметре индексом. Метод является слотом;

• currentIndex () - возвращает индекс видимой вкладки;

• setCurrentWidget (<Компонент>) - делает видимой вкладку с указанным компонентом. Метод является слотом;

• currentWidget () - возвращает ссылку на компонент, расположенный на видимой вкладке;

• widget (<Индекс>) - возвращает ссылку на компонент, который расположен по указанному индексу, или значение None;

• indexOf (<Компонент>) - возвращает индекс вкладки, на которой расположен компонент. Если компонент не найден, возвращается значение -1;

• count () - возвращает количество вкладок. Получить количество вкладок можно также с помощью функции len():

    print(tab.count(), len(tab))
  

    Класс QTabWidget поддерживает такие сигналы;

• currentChanged (<Индекс>) - генерируется при переключении на другую вкладку. Через параметр внутри обработчика доступен целочисленный индекс новой вкладки;
• tabCloseRequested (<Индекс>) - генерируется при нажатии кнопки закрытия вкладки. Через параметр внутри обработчика доступен целочисленный индекс закрываемой вкладки.

    На следующем шаге мы рассмотрим компонент "аккордеон".

Предыдущий шаг Содержание Следующий шаг