Описание класса QTabWidgetКласс QTabWidget предоставляет набор виджетов со вкладками. Далее... #include <QTabWidget>Унаследован от: QWidget. Открытые типы
Свойства
Открытые функции
Переопределённые открытые функции
Открытые слоты
Сигналы
Защищенные функции
Переопределённые защищённые функции
Дополнительные унаследованные члены
Подробное описаниеКласс QTabWidget предоставляет набор виджетов со вкладками. Виджет со вкладками - это панель вкладок (смотрите QTabBar) и "область страниц", которая используется для отображения страниц, связанных с каждой из вкладок. По умолчанию панель вкладок отображается над областью страниц, но доступны различные конфигурации (смотрите TabPosition). Каждая вкладка ассоциируется с отдельным виджетом (называемым страницей). Только текущая страница отображается в области страниц; все другие страницы скрыты. Пользователь может отобразить отдельную страницу, щёлкнув по её вкладке или нажав комбинацию горячих клавиш Alt+letter, если она имеется. Обычно для использования QTabWidget необходимо выполнить следующее:
Положение вкладок определяется tabPosition, их форма - tabShape. Сигнал currentChanged() посылается, когда пользователь выбирает страницу. Индекс текущей страницы доступен через currentIndex(), виджет текущей страницы - через currentWidget(). Вы можете запросить указатель на виджет страницы с указанным индексом при помощи widget(), а можете найти индекс позиции виджета при помощи indexOf(). Используйте setCurrentWidget() или setCurrentIndex() для отображения конкретной страницы. Вы можете изменить текст и иконку вкладки при помощи setTabText() или setTabIcon(). Вкладка и связанная с ней страница могут быть удалены при помощи removeTab(). Каждая вкладка либо включена, либо отключена в любой момент времени (смотрите setTabEnabled()). Если вкладка включена, то текст вкладки отображается нормально и пользователь может выбрать эту вкладку. Если она отключена, то вкладка отображается по-другому и пользователь не может выбрать эту вкладку. Заметьте, что даже если вкладка отключена, страница может оставаться видимой, если, например, оказалось, что все вкладки отключены. Виджет со вкладками может быть хорошим решением для разделения сложного диалогового окна. Альтернативой является использование QStackedWidget, для которого предоставляются какие-либо средства навигации, например, QToolBar или QListWidget. Большая часть функциональность в QTabWidget обеспечивается QTabBar (сверху, реализует вкладки) и QStackedWidget (большая часть области, реализует индивидуальные страницы).
Смотрите также QTabBar, QStackedWidget, QToolBox и Пример "Tab Dialog". Описание типов-членовenum QTabWidget::TabPositionДанное перечисление определяет, где QTabWidget рисует ряд вкладок:
enum QTabWidget::TabShapeДанное перечисление определяет форму вкладок:
Описание свойствcount : const intЭто свойство содержит количество вкладок в панели вкладок. По умолчанию это свойство содержит значение, равное 0. Функции доступа:
currentIndex : intЭто свойство содержит индекс позиции текущей вкладки. Если текущего виджета нет, то текущий индекс будет равен -1. По умолчанию это свойство содержит значение -1, поскольку изначально на виджете нет вкладок. Функции доступа:
Уведомляющий сигнал:
documentMode : boolЭто свойство определяет, отображается или нет виджет со вкладками в режиме, подходящем для страниц документа. Это то же самое, что и режим документа в Mac OS X. Когда это свойство установлено, виджет со вкладками не отрисовывает рамку. Этот режим полезен для отображения страниц, типичных для документов, где страница занимает большую часть области виджета со вкладками. Это свойство было введено в Qt 4.5. Функции доступа:
Смотрите также elideMode, QTabBar::documentMode, QTabBar::usesScrollButtons и QStyle::SH_TabBar_PreferNoArrows. elideMode : Qt::TextElideModeЭто свойство определяет, как должен сокращаться текст в панели вкладок. Это свойство управляет тем, как элементы сокращаются, когда не хватает места для их отображения при заданном размере панели вкладок. По умолчанию это значение зависит от стиля. Это свойство было введено в Qt 4.2. Функции доступа:
Смотрите также QTabBar::elideMode, usesScrollButtons и QStyle::SH_TabBar_ElideMode. iconSize : QSizeЭто свойство определяет размер пиктограмм в панели вкладок. Значение по умолчанию зависит от стиля. Это максимальный размер, который будет иметь пиктограмма. Пиктограммы не увеличиваются, если они имеют меньший размер. Это свойство было введено в Qt 4.2. Функции доступа:
Смотрите также QTabBar::iconSize. movable : boolЭто свойство определяет, может ли пользователь перемещать вкладки в пределах области панели вкладок. По умолчанию это свойство равно false; Это свойство было введено в Qt 4.5. Функции доступа:
tabPosition : TabPositionЭто свойство определяет позицию вкладок в этом виджете со вкладками. Возможные значения для этого свойства описаны в перечислении TabPosition. По умолчанию это свойство установлено в North. Функции доступа:
Смотрите также TabPosition. tabShape : TabShapeЭто свойство определяет форму вкладок в этом виджете со вкладками. Возможными значениями для этого свойства являются QTabWidget::Rounded (по умолчанию) и QTabWidget::Triangular. Функции доступа:
Смотрите также TabShape. tabsClosable : boolЭто свойство указывает, добавляются ли автоматически кнопки закрытия к каждой вкладке. Это свойство было введено в Qt 4.5. Функции доступа:
Смотрите также QTabBar::tabsClosable(). usesScrollButtons : boolЭто свойство указывает, должна ли панель вкладок отображать кнопки для прокрутки вкладок, когда их слишком много. Когда в панели вкладок имеется слишком много вкладок для её размера, панель вкладок может либо расширить свой размер, либо добавить кнопки, которые позволяют вам прокручивать вкладки. По умолчанию это значение зависит от стиля. Это свойство было введено в Qt 4.2. Функции доступа:
Смотрите также elideMode, QTabBar::usesScrollButtons и QStyle::SH_TabBar_PreferNoArrows. Описание функций-членовQTabWidget::QTabWidget ( QWidget * parent = 0 )Создаёт виджет со вкладками с родителем parent. QTabWidget::~QTabWidget ()Уничтожает виджет со вкладками. int QTabWidget::addTab ( QWidget * page, const QString & label )Добавляет вкладку с указанной страницей page и меткой label к виджету со вкладками и возвращает индекс вкладки в панели вкладок. Если метка label вкладки содержит амперсанд, то буква, следующая за амперсандом, используется как горячая клавиша для вкладки, например, если метка "Bro&wse", то Alt+W становится комбинацией горячих клавиш, которая будет перемещать фокус ввода к этой вкладке. Замечание: Если вы вызовете addTab() после show(), то система компоновки попытается подстроиться под изменения в иерархии виджетов, что может вызвать мерцание. Для предотвращения этого вы можете установить свойство QWidget::updatesEnabled в false перед изменениями; не забудьте установить свойство в true, когда изменения будут завершены, что даст возможность виджету снова получать события рисования. Смотрите также insertTab(). int QTabWidget::addTab ( QWidget * page, const QIcon & icon, const QString & label )Это перегруженная функция. Добавляет вкладку с указанной страницей page, пиктограммой icon и меткой label к виджету со вкладками и возвращает индекс вкладки в панели вкладок. Это функция аналогична addTab(), но с дополнительным параметром icon. void QTabWidget::changeEvent ( QEvent * ev ) [virtual protected]Переопределено от QWidget::changeEvent(). void QTabWidget::clear ()Удаляет все страницы, но не уничтожает их. Вызов этой функции эквивалентен вызову removeTab() до тех пор, пока виджет со вкладками не станет пустым. QWidget * QTabWidget::cornerWidget ( Qt::Corner corner = Qt::TopRightCorner ) constВозвращает виджет, отображаемый в углу corner виджета со вкладками или 0. Смотрите также setCornerWidget(). void QTabWidget::currentChanged ( int index ) [signal]Этот сигнал посылается, когда изменяется индекс текущей страницы. Параметром является новый индекс index текущей страницы или -1, если нет новой страницы (например, если нет виджетов в QTabWidget) Смотрите также currentWidget() и currentIndex. QWidget * QTabWidget::currentWidget () constВозвращает указатель на страницу, отображаемую в данный момент диалогом со вкладками. Диалог со вкладками сделает всё возможное, чтобы убедиться, что это значение никогда не будет 0 (но если вы хорошо попытаетесь, то это возможно). Смотрите также currentIndex() и setCurrentWidget(). bool QTabWidget::event ( QEvent * ev ) [virtual protected]Переопределено от QObject::event(). int QTabWidget::heightForWidth ( int width ) const [virtual]Переопределено от QWidget::heightForWidth(). Эта функция была введена в Qt 4.8. int QTabWidget::indexOf ( QWidget * w ) constВозвращает индекс позиции страницы, которая занята виджетом w, или -1, если виджет не найден. void QTabWidget::initStyleOption ( QStyleOptionTabWidgetFrame * option ) const [protected]Инициализирует параметр option значениями этого QTabWidget. Этот метод полезен для подклассов, когда им необходим QStyleOptionTabWidgetFrame, но они не хотят заполнять его сами. Смотрите также QStyleOption::initFrom() и QTabBar::initStyleOption(). int QTabWidget::insertTab ( int index, QWidget * page, const QString & label )Вставляет вкладку с указанной меткой label и страницей page в виджет со вкладками по указанному индексу index и возвращает индекс вставленной вкладки в панели вкладок. Метка отображается на вкладке и может различаться по внешнему виду в зависимости от конфигурации виджета со вкладками. Если метка label вкладки содержит амперсанд, то буква, следующая за амперсандом, используется как горячая клавиша для вкладки, например, если метка "Bro&wse", то Alt+W становится комбинацией горячих клавиш, которая будет перемещать фокус ввода к этой вкладке. Если индекс 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(). void QTabWidget::keyPressEvent ( QKeyEvent * e ) [virtual protected]Переопределено от QWidget::keyPressEvent(). QSize QTabWidget::minimumSizeHint () const [virtual]Переопределено от QWidget::minimumSizeHint(). Возвращает подходящий минимальный размер для виджета со вкладками. void QTabWidget::paintEvent ( QPaintEvent * event ) [virtual protected]Переопределено от QWidget::paintEvent(). Рисует панель вкладок виджета со вкладками в ответ на событие рисования event. void QTabWidget::removeTab ( int index )Удаляет вкладку в позиции с индексом index из этого стека виджетов. Сам виджет страницы не уничтожается. Смотрите также addTab() и insertTab(). void QTabWidget::resizeEvent ( QResizeEvent * e ) [virtual protected]Переопределено от QWidget::resizeEvent(). void QTabWidget::setCornerWidget ( QWidget * widget, Qt::Corner corner = Qt::TopRightCorner )Устанавливает заданный виджет widget для отображения в указанном углу corner виджета со вкладками. Геометрия виджета определяется на основе sizeHint() и style() виджета. Будет использоваться только горизонтальная составляющая corner. При передаче 0 виджеты в углу не будут отображаться. Любой ранее установленный угловой виджет будет скрыт. Все установленные здесь виджеты будут удалены виджетом со вкладками при его уничтожении, если вы вручную не изменили родителя виджета после установки какого-то другого углового виджета (или 0). Замечание: Угловые виджеты предназначены для позиций North и South вкладок; другие ориентации, насколько известно, не работают должным образом. Смотрите также cornerWidget() и setTabPosition(). void QTabWidget::setCurrentWidget ( QWidget * widget ) [slot]Делает виджет widget текущим виджетом. Виджет widget должен быть страницей в этом виджете со вкладками. Смотрите также addTab(), setCurrentIndex() и currentWidget(). void QTabWidget::setTabBar ( QTabBar * tb ) [protected]Заменяет заголовочный 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 )Это перегруженная функция. Устанавливает пиктограмму icon для вкладки в позиции с индексом index. Смотрите также tabIcon(). void QTabWidget::setTabText ( int index, const QString & label )Определяет новую метку label для страницы на вкладке в позиции с индексом index. Если предоставленный текст содержит символ амперсанда ('&'), то для неё автоматически создается горячая клавиша. Следующий после '&' символ будет использован для создания сочетания "горячих" клавиш. Любая предыдущая комбинация "горячих" клавиш будет заменена, а если комбинация "горячих" клавиш в тексте не определена, то очищена. За подробностями обращайтесь к документации по QShortcut (для фактического отображения амперсанда используйте '&&'). Смотрите также tabText(). void QTabWidget::setTabToolTip ( int index, const QString & tip )Устанавливает всплывающую подсказку у вкладки для страницы в позиции с индексом index в tip. Смотрите также tabToolTip(). void QTabWidget::setTabWhatsThis ( int index, const QString & text )Устанавливает текст подсказки "Что это?" для страницы в позиции с индексом index в text. Эта функция была введена в Qt 4.1. Смотрите также tabWhatsThis(). void QTabWidget::showEvent ( QShowEvent * ) [virtual protected]Переопределено от QWidget::showEvent(). QSize QTabWidget::sizeHint () const [virtual]Переопределено от QWidget::sizeHint(). QTabBar * QTabWidget::tabBar () const [protected]Возвращает текущий QTabBar. Смотрите также setTabBar(). void QTabWidget::tabCloseRequested ( int index ) [signal]Этот сигнал посылается, когда нажимается кнопка закрытия на вкладке. index - это индекс, который должен быть удалён. Эта функция была введена в Qt 4.5. Смотрите также setTabsClosable(). QIcon QTabWidget::tabIcon ( int index ) constВозвращает пиктограмму для вкладки на странице в позиции с индексом index. Смотрите также setTabIcon(). void QTabWidget::tabInserted ( int index ) [virtual protected]Этот виртуальный обработчик вызывается после того, как была добавлена или вставлена в позицию с индексом index новая вкладка. Смотрите также tabRemoved(). void QTabWidget::tabRemoved ( int index ) [virtual protected]Этот виртуальный обработчик вызывается после того, как вкладка была удалена из позиции с индексом index. Смотрите также tabInserted(). QString QTabWidget::tabText ( int index ) constВозвращает текст метки для вкладки на странице в позиции с индексом index. Смотрите также setTabText(). QString QTabWidget::tabToolTip ( int index ) constВозвращает всплывающую подсказку вкладки для страницы в позиции с индексом index или пустую строку, если всплывающая подсказка не была установлена. Смотрите также setTabToolTip(). QString QTabWidget::tabWhatsThis ( int index ) constВозвращает текст подсказки "Что это?" для страницы в позиции с индексом index или пустую строку, если текст подсказки не был установлен. Эта функция была введена в Qt 4.1. Смотрите также setTabWhatsThis(). QWidget * QTabWidget::widget ( int index ) constВозвращает страницу вкладки в позиции с индексом index или 0, если индекс index выходит за допустимые границы. |
|
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |