QToolBox Class Reference

The QToolBox class provides a column of tabbed widget items. Далее...

 #include <QToolBox>

Inherits: QFrame.

Свойства

count : const int
currentIndex : int

6 свойств, унаследованных от QFrame
58 свойств, унаследованных от QWidget
1 свойство, унаследованное от QObject

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

	QToolBox ( QWidget * parent = 0, Qt::WindowFlags f = 0 )
	~QToolBox ()
int	addItem ( QWidget * widget, const QIcon & iconSet, const QString & text )
int	addItem ( QWidget * w, const QString & text )
int	count () const
int	currentIndex () const
QWidget *	currentWidget () const
int	indexOf ( QWidget * widget ) const
int	insertItem ( int index, QWidget * widget, const QIcon & icon, const QString & text )
int	insertItem ( int index, QWidget * widget, const QString & text )
bool	isItemEnabled ( int index ) const
QIcon	itemIcon ( int index ) const
QString	itemText ( int index ) const
QString	itemToolTip ( int index ) const
void	removeItem ( int index )
void	setItemEnabled ( int index, bool enabled )
void	setItemIcon ( int index, const QIcon & icon )
void	setItemText ( int index, const QString & text )
void	setItemToolTip ( int index, const QString & toolTip )
QWidget *	widget ( int index ) const

14 открытых функций, унаследованных от QFrame
221 открытая функция, унаследованная от QWidget
29 открытых функций, унаследованных от QObject
13 открытых функций, унаследованных от QPaintDevice

Открытые слоты

void	setCurrentIndex ( int index )
void	setCurrentWidget ( QWidget * widget )

19 открытых слотов, унаследованных от QWidget
1 открытый слот, унаследованный от QObject

Сигналы

void	currentChanged ( int index )

1 сигнал, унаследованный от QWidget
1 сигнал, унаследованный от QObject

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

virtual void	itemInserted ( int index )
virtual void	itemRemoved ( int index )

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

virtual void	changeEvent ( QEvent * ev )
virtual bool	event ( QEvent * e )
virtual void	showEvent ( QShowEvent * e )

3 защищенные функции, унаследованные от QFrame
37 защищенных функций, унаследованных от QWidget
8 защищенных функций, унаследованных от QObject
1 защищенная функция, унаследованная от QPaintDevice

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

4 статических открытых члена, унаследованных от QWidget
7 статических открытых членов, унаследованных от QObject
1 защищенный слот, унаследованный от QWidget

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

The QToolBox class provides a column of tabbed widget items.

A toolbox is a widget that displays a column of tabs one above the other, with the current item displayed below the current tab. Every tab has an index position within the column of tabs. A tab's item is a QWidget.

Each item has an itemText(), an optional itemIcon(), an optional itemToolTip(), and a widget(). The item's attributes can be changed with setItemText(), setItemIcon(), and setItemToolTip(). Each item can be enabled or disabled individually with setItemEnabled().

Items are added using addItem(), or inserted at particular positions using insertItem(). The total number of items is given by count(). Items can be deleted with delete, or removed from the toolbox with removeItem(). Combining removeItem() and insertItem() allows you to move items to different positions.

The index of the current item widget is returned by currentIndex(), and set with setCurrentIndex(). The index of a particular item can be found using indexOf(), and the item at a given index is returned by item().

The currentChanged() signal is emitted when the current item is changed.

See also QTabWidget.

Описание свойств

count : const int

This property holds the number of items contained in the toolbox.

По умолчанию это свойство имеет значение 0.

Функции доступа:

int	count () const

currentIndex : int

This property holds the index of the current item.

By default, for an empty toolbox, this property has a value of -1.

Функции доступа:

int	currentIndex () const
void	setCurrentIndex ( int index )

Уведомляющий сигнал:

void	currentChanged ( int index )

See also indexOf() and widget().

Описание функций-членов

QToolBox::QToolBox ( QWidget * parent = 0, Qt::WindowFlags f = 0 )

Constructs a new toolbox with the given parent and the flags, f.

QToolBox::~QToolBox ()

Destroys the toolbox.

int QToolBox::addItem ( QWidget * widget, const QIcon & iconSet, const QString & text )

Adds the widget in a new tab at bottom of the toolbox. The new tab's text is set to text, and the iconSet is displayed to the left of the text. Returns the new tab's index.

int QToolBox::addItem ( QWidget * w, const QString & text )

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

Adds the widget w in a new tab at bottom of the toolbox. The new tab's text is set to text. Returns the new tab's index.

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

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

void QToolBox::currentChanged ( int index ) `[signal]`

This signal is emitted when the current item is changed. The new current item's index is passed in index, or -1 if there is no current item.

QWidget * QToolBox::currentWidget () const

Returns a pointer to the current widget, or 0 if there is no such item.

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

bool QToolBox::event ( QEvent * e ) `[virtual protected]`

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

int QToolBox::indexOf ( QWidget * widget ) const

Returns the index of widget, or -1 if the item does not exist.

int QToolBox::insertItem ( int index, QWidget * widget, const QIcon & icon, const QString & text )

Inserts the widget at position index, or at the bottom of the toolbox if index is out of range. The new item's text is set to text, and the icon is displayed to the left of the text. Returns the new item's index.

int QToolBox::insertItem ( int index, QWidget * widget, const QString & text )

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

Inserts the widget at position index, or at the bottom of the toolbox if index is out of range. The new item's text is set to text. Returns the new item's index.

bool QToolBox::isItemEnabled ( int index ) const

Returns true if the item at position index is enabled; otherwise returns false.

QIcon QToolBox::itemIcon ( int index ) const

Returns the icon of the item at position index, or a null icon if index is out of range.

See also setItemIcon().

void QToolBox::itemInserted ( int index ) `[virtual protected]`

This virtual handler is called after a new item was added or inserted at position index.

See also itemRemoved().

void QToolBox::itemRemoved ( int index ) `[virtual protected]`

This virtual handler is called after an item was removed from position index.

See also itemInserted().

QString QToolBox::itemText ( int index ) const

Returns the text of the item at position index, or an empty string if index is out of range.

See also setItemText().

QString QToolBox::itemToolTip ( int index ) const

Returns the tooltip of the item at position index, or an empty string if index is out of range.

See also setItemToolTip().

void QToolBox::removeItem ( int index )

Removes the item at position index from the toolbox. Note that the widget is not deleted.

void QToolBox::setCurrentWidget ( QWidget * widget ) `[slot]`

Makeswidget the current widget. The widget must be an item in this tool box.

See also addItem(), setCurrentIndex(), and currentWidget().

void QToolBox::setItemEnabled ( int index, bool enabled )

If enabled is true then the item at position index is enabled; otherwise the item at position index is disabled.

Смотрите также isItemEnabled().

void QToolBox::setItemIcon ( int index, const QIcon & icon )

Sets the icon of the item at position index to icon.

See also itemIcon().

void QToolBox::setItemText ( int index, const QString & text )

Sets the text of the item at position index to text.

If the provided text contains an ampersand character ('&'), a mnemonic is automatically created for it. Следующий после '&' символ будет использован для создания сочетания "горячих" клавиш. Any previous mnemonic will be overwritten, or cleared if no mnemonic is defined by the text. За подробностями обращайтесь к документации по QShortcut (для фактического отображения амперсанда используйте '&&').

See also itemText().

void QToolBox::setItemToolTip ( int index, const QString & toolTip )

Sets the tooltip of the item at position index to toolTip.

See also itemToolTip().

void QToolBox::showEvent ( QShowEvent * e ) `[virtual protected]`

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

QWidget * QToolBox::widget ( int index ) const

Returns the widget at position index, or 0 if there is no such item.

Оглавление