QListWidgetItem Class

      new QListWidgetItem(tr("Hazel"), listWidget);

成员函数

QListWidgetItem::QListWidgetItem(QListWidget *parent = Q_NULLPTR, int type = Type)

Constructs an empty list widget item of the specified type with the given parent. If parent is not specified, the item will need to be inserted into a list widget with QListWidget::insertItem().

This constructor inserts the item into the model of the parent that is passed to the constructor. If the model is sorted then the behavior of the insert is undetermined since the model will call the '<' operator method on the item which, at this point, is not yet constructed. To avoid the undetermined behavior, we recommend not to specify the parent and use QListWidget::insertItem() instead.

参见 type().

QListWidgetItem::QListWidgetItem(const QString &text, QListWidget *parent = Q_NULLPTR, int type = Type)

Constructs an empty list widget item of the specified type with the given text and parent. If the parent is not specified, the item will need to be inserted into a list widget with QListWidget::insertItem().

This constructor inserts the item into the model of the parent that is passed to the constructor. If the model is sorted then the behavior of the insert is undetermined since the model will call the '<' operator method on the item which, at this point, is not yet constructed. To avoid the undetermined behavior, we recommend not to specify the parent and use QListWidget::insertItem() instead.

参见 type().

QListWidgetItem::QListWidgetItem(const QIcon &icon, const QString &text, QListWidget *parent = Q_NULLPTR, int type = Type)

Constructs an empty list widget item of the specified type with the given icon, text and parent. If the parent is not specified, the item will need to be inserted into a list widget with QListWidget::insertItem().

This constructor inserts the item into the model of the parent that is passed to the constructor. If the model is sorted then the behavior of the insert is undetermined since the model will call the '<' operator method on the item which, at this point, is not yet constructed. To avoid the undetermined behavior, we recommend not to specify the parent and use QListWidget::insertItem() instead.

参见 type().

QListWidgetItem::QListWidgetItem(const QListWidgetItem &other)

Constructs a copy of other. Note that type() and listWidget() are not copied.

This function is useful when reimplementing clone().

This function was introduced in Qt 4.1.

参见 data() and flags().

[virtual] QListWidgetItem::~QListWidgetItem()

Destroys the list item.

QBrush QListWidgetItem::background() const

Returns the brush used to display the list item's background.

This function was introduced in Qt 4.2.

参见 setBackground() and foreground().

Qt::CheckState QListWidgetItem::checkState() const

Returns the checked state of the list item (see Qt::CheckState).

参见 setCheckState() and flags().

[virtual] QListWidgetItem *QListWidgetItem::clone() const

Creates an exact copy of the item.

[virtual] QVariant QListWidgetItem::data(int role) const

Returns the item's data for a given role. Reimplement this function if you need extra roles or special behavior for certain roles.

参见 Qt::ItemDataRole and setData().

Qt::ItemFlags QListWidgetItem::flags() const

Returns the item flags for this item (see Qt::ItemFlags).

参见 setFlags().

QFont QListWidgetItem::font() const

Returns the font used to display this list item's text.

参见 setFont().

QBrush QListWidgetItem::foreground() const

Returns the brush used to display the list item's foreground (e.g. text).

This function was introduced in Qt 4.2.

参见 setForeground() and background().

QIcon QListWidgetItem::icon() const

Returns the list item's icon.

参见 setIcon() and iconSize.

bool QListWidgetItem::isHidden() const

Returns true if the item is hidden; otherwise returns false.

This function was introduced in Qt 4.2.

参见 setHidden().

bool QListWidgetItem::isSelected() const

Returns true if the item is selected; otherwise returns false.

This function was introduced in Qt 4.2.

参见 setSelected().

QListWidget *QListWidgetItem::listWidget() const

Returns the list widget containing the item.

[virtual] void QListWidgetItem::read(QDataStream &in)

Reads the item from stream in.

参见 write().

void QListWidgetItem::setBackground(const QBrush &brush)

Sets the background brush of the list item to the given brush.

This function was introduced in Qt 4.2.

参见 background() and setForeground().

void QListWidgetItem::setCheckState(Qt::CheckState state)

Sets the check state of the list item to state.

参见 checkState().

[virtual] void QListWidgetItem::setData(int role, const QVariant &value)

Sets the data for a given role to the given value. Reimplement this function if you need extra roles or special behavior for certain roles.

参见 Qt::ItemDataRole and data().

void QListWidgetItem::setFlags(Qt::ItemFlags flags)

Sets the item flags for the list item to flags.

参见 flags() and Qt::ItemFlags.

void QListWidgetItem::setFont(const QFont &font)

Sets the font used when painting the item to the given font.

参见 font().

void QListWidgetItem::setForeground(const QBrush &brush)

Sets the foreground brush of the list item to the given brush.

This function was introduced in Qt 4.2.

参见 foreground() and setBackground().

void QListWidgetItem::setHidden(bool hide)

Hides the item if hide is true; otherwise shows the item.

This function was introduced in Qt 4.2.

参见 isHidden().

void QListWidgetItem::setIcon(const QIcon &icon)

Sets the icon for the list item to the given icon.

参见 icon(), text(), and iconSize.

void QListWidgetItem::setSelected(bool select)

Sets the selected state of the item to select.

This function was introduced in Qt 4.2.

参见 isSelected().

void QListWidgetItem::setSizeHint(const QSize &size)

Sets the size hint for the list item to be size. If no size hint is set, the item delegate will compute the size hint based on the item data.

This function was introduced in Qt 4.1.

参见 sizeHint().

void QListWidgetItem::setStatusTip(const QString &statusTip)

Sets the status tip for the list item to the text specified by statusTip. QListWidget mouseTracking needs to be enabled for this feature to work.

参见 statusTip(), setToolTip(), setWhatsThis(), and QWidget::setMouseTracking().

void QListWidgetItem::setText(const QString &text)

Sets the text for the list widget item's to the given text.

参见 text().

void QListWidgetItem::setTextAlignment(int alignment)

Sets the list item's text alignment to alignment.

参见 textAlignment() and Qt::AlignmentFlag.

void QListWidgetItem::setToolTip(const QString &toolTip)

Sets the tooltip for the list item to the text specified by toolTip.

参见 toolTip(), setStatusTip(), and setWhatsThis().

void QListWidgetItem::setWhatsThis(const QString &whatsThis)

Sets the "What's This?" help for the list item to the text specified by whatsThis.

参见 whatsThis(), setStatusTip(), and setToolTip().

QSize QListWidgetItem::sizeHint() const

Returns the size hint set for the list item.

This function was introduced in Qt 4.1.

参见 setSizeHint().

QString QListWidgetItem::statusTip() const

Returns the list item's status tip.

参见 setStatusTip().

QString QListWidgetItem::text() const

Returns the list item's text.

参见 setText().

int QListWidgetItem::textAlignment() const

Returns the text alignment for the list item.

参见 setTextAlignment() and Qt::AlignmentFlag.

QString QListWidgetItem::toolTip() const

Returns the list item's tooltip.

参见 setToolTip(), statusTip(), and whatsThis().

int QListWidgetItem::type() const

Returns the type passed to the QListWidgetItem constructor.

QString QListWidgetItem::whatsThis() const

Returns the list item's "What's This?" help text.

参见 setWhatsThis(), statusTip(), and toolTip().

[virtual] void QListWidgetItem::write(QDataStream &out) const

Writes the item to stream out.

参见 read().

[virtual] bool QListWidgetItem::operator<(const QListWidgetItem &other) const

Returns true if this item's text is less then other item's text; otherwise returns false.

QListWidgetItem &QListWidgetItem::operator=(const QListWidgetItem &other)

Assigns other's data and flags to this item. Note that type() and listWidget() are not copied.

This function is useful when reimplementing clone().

参见 data() and flags().