Шаг 94.
Библиотека PyQt5.
Размещение компонентов в окнах. Компонент "аккордеон" (окончание)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    print(toolBox.count(), len(toolBox))
  

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

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

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