com.trolltech.qt.gui
Class QStandardItem

java.lang.Object
  extended by com.trolltech.qt.internal.QSignalEmitterInternal
      extended by com.trolltech.qt.QSignalEmitter
          extended by com.trolltech.qt.QtJambiObject
              extended by com.trolltech.qt.gui.QStandardItem
All Implemented Interfaces:
QtJambiInterface

public class QStandardItem
extends QtJambiObject

The QStandardItem class provides an item for use with the QStandardItemModel class. Items usually contain text, icons, or checkboxes.

Each item can have its own background brush which is set with the setBackground() function. The current background brush can be found with background(). The text label for each item can be rendered with its own font and brush. These are specified with the setFont() and setForeground() functions, and read with font() and foreground().

By default, items are enabled, editable, selectable, checkable, and can be used both as the source of a drag and drop operation and as a drop target. Each item's flags can be changed by calling setFlags(). Checkable items can be checked and unchecked with the setCheckState() function. The corresponding checkState() function indicates whether the item is currently checked.

You can store application-specific data in an item by calling setData().

Each item can have a two-dimensional table of child items. This makes it possible to build hierarchies of items. The typical hierarchy is the tree, in which case the child table is a table with a single column (a list).

The dimensions of the child table can be set with setRowCount() and setColumnCount(). Items can be positioned in the child table with setChild(). Get a pointer to a child item with child(). New rows and columns of children can also be inserted with insertRow() and insertColumn(), or appended with appendRow() and appendColumn(). When using the append and insert functions, the dimensions of the child table will grow as needed.

An existing row of children can be removed with removeRow() or takeRow(); correspondingly, a column can be removed with removeColumn() or takeColumn().

An item's children can be sorted by calling sortChildren().

Subclassing

When subclassing QStandardItem to provide custom items, it is possible to define new types for them so that they can be distinguished from the base class. The type() function should be reimplemented to return a new type value equal to or greater than UserType .

Reimplement data() and setData() if you want to perform custom handling of data queries and/or control how an item's data is represented.

Reimplement clone() if you want QStandardItemModel to be able to create instances of your custom item class on demand (see QStandardItemModel::setItemPrototype()).

Reimplement read() and write() if you want to control how items are represented in their serialized form.

Reimplement operator<() if you want to control the semantics of item comparison. operator<() determines the sorted order when sorting items with sortChildren() or with QStandardItemModel::sort().

See also:
QStandardItemModel, Item View Convenience Classes, and Model/View Programming.


Nested Class Summary
static class QStandardItem.ItemType
          This enum describes the types that are used to describe standard items.
 
Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter
QSignalEmitter.AbstractSignal, QSignalEmitter.PrivateSignal0, QSignalEmitter.PrivateSignal1, QSignalEmitter.PrivateSignal2, QSignalEmitter.PrivateSignal3, QSignalEmitter.PrivateSignal4, QSignalEmitter.PrivateSignal5, QSignalEmitter.PrivateSignal6, QSignalEmitter.PrivateSignal7, QSignalEmitter.PrivateSignal8, QSignalEmitter.PrivateSignal9, QSignalEmitter.Signal0, QSignalEmitter.Signal1, QSignalEmitter.Signal2, QSignalEmitter.Signal3, QSignalEmitter.Signal4, QSignalEmitter.Signal5, QSignalEmitter.Signal6, QSignalEmitter.Signal7, QSignalEmitter.Signal8, QSignalEmitter.Signal9
 
Nested classes/interfaces inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
com.trolltech.qt.internal.QSignalEmitterInternal.AbstractSignalInternal
 
Field Summary
 
Fields inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
currentSender
 
Constructor Summary
  QStandardItem()
          Constructs an item.
  QStandardItem(int rows)
          Constructs an item with rows rows and columns columns of child items.
  QStandardItem(int rows, int columns)
          Constructs an item with rows rows and columns columns of child items.
  QStandardItem(QIcon icon, java.lang.String text)
          Constructs an item with the given icon and text.
protected QStandardItem(QStandardItem other)
          Constructs a copy of other.
  QStandardItem(java.lang.String text)
          Constructs an item with the given text.
 
Method Summary
 java.lang.String accessibleDescription()
          Returns the item's accessible description.
 java.lang.String accessibleText()
          Returns the item's accessible text.
 void appendColumn(java.util.List items)
          Appends a column containing items.
 void appendRow(java.util.List items)
          Appends a row containing items.
 void appendRow(QStandardItem item)
          This is an overloaded member function, provided for convenience.
 void appendRows(java.util.List items)
          Appends rows containing items.
 QBrush background()
          Returns the brush used to render the item's background.
 Qt.CheckState checkState()
          Returns the checked state of the item.
 QStandardItem child(int row)
          Returns the child item at (row, column) if one has been set; otherwise returns 0.
 QStandardItem child(int row, int column)
          Returns the child item at (row, column) if one has been set; otherwise returns 0.
 QStandardItem clone()
          This method is reimplemented for internal reasons
 int column()
          Returns the column where the item is located in its parent's child table, or -1 if the item has no parent.
 int columnCount()
          Returns the number of child item columns that the item has.
 java.lang.Object data()
          Returns the item's data for the given role, or an invalid QVariant if there is no data for the role.
 java.lang.Object data(int role)
          Returns the item's data for the given role, or an invalid QVariant if there is no data for the role.
protected  void emitDataChanged()
          Causes the model associated with this item to emit a dataChanged () signal for this item.
 Qt.ItemFlags flags()
          Returns the item flags for the item.
 QFont font()
          Returns the font used to render the item's text.
 QBrush foreground()
          Returns the brush used to render the item's foreground (e.
 boolean hasChildren()
          Returns true if this item has any children; otherwise returns false.
 QIcon icon()
          Returns the item's icon.
 com.trolltech.qt.core.QModelIndex index()
          Returns the QModelIndex associated with this item.
 void insertColumn(int column, java.util.List items)
          Inserts a column at column containing items.
 void insertColumns(int column, int count)
          Inserts count columns of child items at column column.
 void insertRow(int row, java.util.List items)
          Inserts a row at row containing items.
 void insertRow(int row, QStandardItem item)
          This is an overloaded member function, provided for convenience.
 void insertRows(int row, int count)
          Inserts count rows of child items at row row.
 void insertRows(int row, java.util.List items)
          Inserts items at row.
 boolean isCheckable()
          Returns whether the item is user-checkable.
 boolean isDragEnabled()
          Returns whether the item is drag enabled.
 boolean isDropEnabled()
          Returns whether the item is drop enabled.
 boolean isEditable()
          Returns whether the item can be edited by the user.
 boolean isEnabled()
          Returns whether the item is enabled.
 boolean isSelectable()
          Returns whether the item is selectable by the user.
 boolean isTristate()
          Returns whether the item is tristate; that is, if it's checkable with three separate states.
 QStandardItemModel model()
          Returns the QStandardItemModel that this item belongs to.
 boolean operator_less(QStandardItem other)
          Returns true if this item is less than other; otherwise returns false.
 QStandardItem parent()
          Returns the item's parent item, or 0 if the item has no parent.
 void read(QDataStream in)
          Reads the item from stream in.
 void readFrom(QDataStream in)
          Reads a QStandardItem
 void removeColumn(int column)
          Removes the given column.
 void removeColumns(int column, int count)
          Removes count columns at column column.
 void removeRow(int row)
          Removes the given row.
 void removeRows(int row, int count)
          Removes count rows at row row.
 int row()
          Returns the row where the item is located in its parent's child table, or -1 if the item has no parent.
 int rowCount()
          Returns the number of child item rows that the item has.
 void setAccessibleDescription(java.lang.String accessibleDescription)
          Sets the item's accessible description to the string specified by accessibleDescription.
 void setAccessibleText(java.lang.String accessibleText)
          Sets the item's accessible text to the string specified by accessibleText.
 void setBackground(QBrush brush)
          Sets the item's background brush to the specified brush.
 void setCheckable(boolean checkable)
          Sets whether the item is user-checkable.
 void setCheckState(Qt.CheckState checkState)
          Sets the check state of the item to be state.
 void setChild(int row, int column, QStandardItem item)
          Sets the child item at (row, column) to item.
 void setChild(int row, QStandardItem item)
          This is an overloaded member function, provided for convenience.
 void setColumnCount(int columns)
          Sets the number of child item columns to columns.
 void setData(java.lang.Object value)
          Sets the item's data for the given role to the specified value.
 void setData(java.lang.Object value, int role)
          Sets the item's data for the given role to the specified value.
 void setDragEnabled(boolean dragEnabled)
          Sets whether the item is drag enabled.
 void setDropEnabled(boolean dropEnabled)
          Sets whether the item is drop enabled.
 void setEditable(boolean editable)
          Sets whether the item is editable.
 void setEnabled(boolean enabled)
          Sets whether the item is enabled.
 void setFlags(Qt.ItemFlag[] flags)
          This is an overloaded method provided for convenience.
 void setFlags(Qt.ItemFlags flags)
          Sets the item flags for the item to flags.
 void setFont(QFont font)
          Sets the font used to display the item's text to the given font.
 void setForeground(QBrush brush)
          Sets the brush used to display the item's foreground (e.
 void setIcon(QIcon icon)
          Sets the item's icon to the icon specified.
 void setRowCount(int rows)
          Sets the number of child item rows to rows.
 void setSelectable(boolean selectable)
          Sets whether the item is selectable.
 void setSizeHint(QSize sizeHint)
          Sets the size hint for the item to be size.
 void setStatusTip(java.lang.String statusTip)
          Sets the item's status tip to the string specified by statusTip.
 void setText(java.lang.String text)
          Sets the item's text to the text specified.
 void setTextAlignment(Qt.Alignment textAlignment)
          Sets the text alignment for the item's text to the alignment specified.
 void setTextAlignment(Qt.AlignmentFlag[] textAlignment)
          This is an overloaded method provided for convenience.
 void setToolTip(java.lang.String toolTip)
          Sets the item's tooltip to the string specified by toolTip.
 void setTristate(boolean tristate)
          Sets whether the item is tristate.
 void setWhatsThis(java.lang.String whatsThis)
          Sets the item's "What's This?" help to the string specified by whatsThis.
 QSize sizeHint()
          Returns the size hint set for the item, or an invalid QSize if no size hint has been set.
 void sortChildren(int column)
          Sorts the children of the item using the given order, by the values in the given column.
 void sortChildren(int column, Qt.SortOrder order)
          Sorts the children of the item using the given order, by the values in the given column.
 java.lang.String statusTip()
          Returns the item's status tip.
 QStandardItem takeChild(int row)
          Removes the child item at (row, column) without deleting it, and returns a pointer to the item.
 QStandardItem takeChild(int row, int column)
          Removes the child item at (row, column) without deleting it, and returns a pointer to the item.
 java.util.List takeColumn(int column)
          Removes column without deleting the column items, and returns a list of pointers to the removed items.
 java.util.List takeRow(int row)
          Removes row without deleting the row items, and returns a list of pointers to the removed items.
 java.lang.String text()
          Returns the item's text.
 Qt.Alignment textAlignment()
          Returns the text alignment for the item's text.
 java.lang.String toolTip()
          Returns the item's tooltip.
 int type()
          Returns the type of this item.
 java.lang.String whatsThis()
          Returns the item's "What's This?" help.
 void write(QDataStream out)
          Writes the item to stream out.
 void writeTo(QDataStream out)
          Writes thisQStandardItem
 
Methods inherited from class com.trolltech.qt.QtJambiObject
dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr
 
Methods inherited from class com.trolltech.qt.QSignalEmitter
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread
 
Methods inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
__qt_signalInitialization
 
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.trolltech.qt.QtJambiInterface
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership
 

Constructor Detail

QStandardItem

public QStandardItem()
Constructs an item.


QStandardItem

public QStandardItem(QIcon icon,
                     java.lang.String text)
Constructs an item with the given icon and text.


QStandardItem

protected QStandardItem(QStandardItem other)
Constructs a copy of other. Note that model() is not copied.

This function is useful when reimplementing clone().


QStandardItem

public QStandardItem(java.lang.String text)
Constructs an item with the given text.


QStandardItem

public QStandardItem(int rows)
Constructs an item with rows rows and columns columns of child items.


QStandardItem

public QStandardItem(int rows,
                     int columns)
Constructs an item with rows rows and columns columns of child items.

Method Detail

accessibleDescription

public final java.lang.String accessibleDescription()
Returns the item's accessible description.

The accessible description is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).

See also:
setAccessibleDescription(), and accessibleText().


accessibleText

public final java.lang.String accessibleText()
Returns the item's accessible text.

The accessible text is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).

See also:
setAccessibleText(), and accessibleDescription().


appendColumn

public final void appendColumn(java.util.List items)
Appends a column containing items. If necessary, the row count is increased to the size of items.

See also:
insertColumn().


appendRow

public final void appendRow(QStandardItem item)
This is an overloaded member function, provided for convenience.

Appends a row containing item.

When building a list or a tree that has only one column, this function provides a convenient way to append a single new item.


appendRow

public final void appendRow(java.util.List items)
Appends a row containing items. If necessary, the column count is increased to the size of items.

See also:
insertRow().


appendRows

public final void appendRows(java.util.List items)
Appends rows containing items. The column count will not change.

See also:
insertRow().


background

public final QBrush background()
Returns the brush used to render the item's background.

See also:
foreground(), and setBackground().


checkState

public final Qt.CheckState checkState()
Returns the checked state of the item.

See also:
setCheckState(), and isCheckable().


child

public final QStandardItem child(int row)
Returns the child item at (row, column) if one has been set; otherwise returns 0.

See also:
setChild(), takeChild(), and parent().


child

public final QStandardItem child(int row,
                                 int column)
Returns the child item at (row, column) if one has been set; otherwise returns 0.

See also:
setChild(), takeChild(), and parent().


column

public final int column()
Returns the column where the item is located in its parent's child table, or -1 if the item has no parent.

See also:
row(), and parent().


columnCount

public final int columnCount()
Returns the number of child item columns that the item has.

See also:
setColumnCount(), and rowCount().


emitDataChanged

protected final void emitDataChanged()
Causes the model associated with this item to emit a dataChanged () signal for this item.

You normally only need to call this function if you have subclassed QStandardItem and reimplemented data() and/or setData().

See also:
setData().


flags

public final Qt.ItemFlags flags()
Returns the item flags for the item.

The item flags determine how the user can interact with the item.

By default, items are enabled, editable, selectable, checkable, and can be used both as the source of a drag and drop operation and as a drop target.

See also:
setFlags().


font

public final QFont font()
Returns the font used to render the item's text.

See also:
setFont().


foreground

public final QBrush foreground()
Returns the brush used to render the item's foreground (e. . text).

See also:
setForeground(), and background().


hasChildren

public final boolean hasChildren()
Returns true if this item has any children; otherwise returns false.

See also:
rowCount(), columnCount(), and child().


icon

public final QIcon icon()
Returns the item's icon.

See also:
setIcon(), and iconSize.


index

public final com.trolltech.qt.core.QModelIndex index()
Returns the QModelIndex associated with this item.

When you need to invoke item functionality in a QModelIndex-based API (e.g. QAbstractItemView), you can call this function to obtain an index that corresponds to the item's location in the model.

If the item is not associated with a model, an invalid QModelIndex is returned.

See also:
model(), and QStandardItemModel::itemFromIndex().


insertColumn

public final void insertColumn(int column,
                               java.util.List items)
Inserts a column at column containing items. If necessary, the row count is increased to the size of items.

See also:
insertColumns(), and insertRow().


insertColumns

public final void insertColumns(int column,
                                int count)
Inserts count columns of child items at column column.

See also:
insertColumn(), and insertRows().


insertRow

public final void insertRow(int row,
                            QStandardItem item)
This is an overloaded member function, provided for convenience.

Inserts a row at row containing item.

When building a list or a tree that has only one column, this function provides a convenient way to insert a single new item.


insertRow

public final void insertRow(int row,
                            java.util.List items)
Inserts a row at row containing items. If necessary, the column count is increased to the size of items.

See also:
insertRows(), and insertColumn().


insertRows

public final void insertRows(int row,
                             java.util.List items)
Inserts items at row. The column count wont be changed.

See also:
insertRow(), and insertColumn().


insertRows

public final void insertRows(int row,
                             int count)
Inserts count rows of child items at row row.

See also:
insertRow(), and insertColumns().


isCheckable

public final boolean isCheckable()
Returns whether the item is user-checkable.

The default value is false.

See also:
setCheckable(), checkState(), and isTristate().


isDragEnabled

public final boolean isDragEnabled()
Returns whether the item is drag enabled. An item that is drag enabled can be dragged by the user.

The default value is true.

Note that item dragging must be enabled in the view for dragging to work; see QAbstractItemView::dragEnabled.

See also:
setDragEnabled(), isDropEnabled(), and flags().


isDropEnabled

public final boolean isDropEnabled()
Returns whether the item is drop enabled. When an item is drop enabled, it can be used as a drop target.

The default value is true.

See also:
setDropEnabled(), isDragEnabled(), and flags().


isEditable

public final boolean isEditable()
Returns whether the item can be edited by the user.

When an item is editable (and enabled), the user can edit the item by invoking one of the view's edit triggers; see QAbstractItemView::editTriggers.

The default value is true.

See also:
setEditable(), and flags().


isEnabled

public final boolean isEnabled()
Returns whether the item is enabled.

When an item is enabled, the user can interact with it. The possible types of interaction are specified by the other item flags, such as isEditable() and isSelectable().

The default value is true.

See also:
setEnabled(), and flags().


isSelectable

public final boolean isSelectable()
Returns whether the item is selectable by the user.

The default value is true.

See also:
setSelectable(), and flags().


isTristate

public final boolean isTristate()
Returns whether the item is tristate; that is, if it's checkable with three separate states.

The default value is false.

See also:
setTristate(), isCheckable(), and checkState().


model

public final QStandardItemModel model()
Returns the QStandardItemModel that this item belongs to.

If the item is not a child of another item that belongs to the model, this function returns 0.

See also:
index().


writeTo

public final void writeTo(QDataStream out)
Writes thisQStandardItem


readFrom

public final void readFrom(QDataStream in)
Reads a QStandardItem


parent

public final QStandardItem parent()
Returns the item's parent item, or 0 if the item has no parent.

See also:
child().


removeColumn

public final void removeColumn(int column)
Removes the given column. The items that were in the column are deleted.

See also:
takeColumn(), removeColumns(), and removeRow().


removeColumns

public final void removeColumns(int column,
                                int count)
Removes count columns at column column. The items that were in those columns are deleted.

See also:
removeColumn(), and removeRows().


removeRow

public final void removeRow(int row)
Removes the given row. The items that were in the row are deleted.

See also:
takeRow(), removeRows(), and removeColumn().


removeRows

public final void removeRows(int row,
                             int count)
Removes count rows at row row. The items that were in those rows are deleted.

See also:
removeRow(), and removeColumn().


row

public final int row()
Returns the row where the item is located in its parent's child table, or -1 if the item has no parent.

See also:
column(), and parent().


rowCount

public final int rowCount()
Returns the number of child item rows that the item has.

See also:
setRowCount(), and columnCount().


setAccessibleDescription

public final void setAccessibleDescription(java.lang.String accessibleDescription)
Sets the item's accessible description to the string specified by accessibleDescription.

The accessible description is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).

See also:
accessibleDescription(), and setAccessibleText().


setAccessibleText

public final void setAccessibleText(java.lang.String accessibleText)
Sets the item's accessible text to the string specified by accessibleText.

The accessible text is used by assistive technologies (i.e. for users who cannot use conventional means of interaction).

See also:
accessibleText(), and setAccessibleDescription().


setBackground

public final void setBackground(QBrush brush)
Sets the item's background brush to the specified brush.

See also:
background(), and setForeground().


setCheckState

public final void setCheckState(Qt.CheckState checkState)
Sets the check state of the item to be state.

See also:
checkState(), and setCheckable().


setCheckable

public final void setCheckable(boolean checkable)
Sets whether the item is user-checkable. If checkable is true, the item can be checked by the user; otherwise, the user cannot check the item.

The item delegate will render a checkable item with a check box next to the item's text.

See also:
isCheckable(), setCheckState(), and setTristate().


setChild

public final void setChild(int row,
                           QStandardItem item)
This is an overloaded member function, provided for convenience.

Sets the child at row to item.


setChild

public final void setChild(int row,
                           int column,
                           QStandardItem item)
Sets the child item at (row, column) to item. This item (the parent item) takes ownership of item. If necessary, the row count and column count are increased to fit the item.

See also:
child().


setColumnCount

public final void setColumnCount(int columns)
Sets the number of child item columns to columns. If this is less than columnCount(), the data in the unwanted columns is discarded.

See also:
columnCount(), and setRowCount().


setDragEnabled

public final void setDragEnabled(boolean dragEnabled)
Sets whether the item is drag enabled. If dragEnabled is true, the item can be dragged by the user; otherwise, the user cannot drag the item.

Note that you also need to ensure that item dragging is enabled in the view; see QAbstractItemView::dragEnabled.

See also:
isDragEnabled(), setDropEnabled(), and setFlags().


setDropEnabled

public final void setDropEnabled(boolean dropEnabled)
Sets whether the item is drop enabled. If dropEnabled is true, the item can be used as a drop target; otherwise, it cannot.

Note that you also need to ensure that drops are enabled in the view; see QWidget::acceptDrops(); and that the model supports the desired drop actions; see QAbstractItemModel::supportedDropActions().

See also:
isDropEnabled(), setDragEnabled(), and setFlags().


setEditable

public final void setEditable(boolean editable)
Sets whether the item is editable. If editable is true, the item can be edited by the user; otherwise, the user cannot edit the item.

How the user can edit items in a view is determined by the view's edit triggers; see QAbstractItemView::editTriggers.

See also:
isEditable(), and setFlags().


setEnabled

public final void setEnabled(boolean enabled)
Sets whether the item is enabled. If enabled is true, the item is enabled, meaning that the user can interact with the item; if enabled is false, the user cannot interact with the item.

This flag takes presedence over the other item flags; e.g. if an item is not enabled, it cannot be selected by the user, even if the Qt::ItemIsSelectable flag has been set.

See also:
isEnabled(), Qt::ItemIsEnabled , and setFlags().


setFlags

public final void setFlags(Qt.ItemFlag[] flags)
This is an overloaded method provided for convenience.


setFlags

public final void setFlags(Qt.ItemFlags flags)
Sets the item flags for the item to flags.

The item flags determine how the user can interact with the item. This is often used to disable an item.

See also:
flags(), and setData().


setFont

public final void setFont(QFont font)
Sets the font used to display the item's text to the given font.

See also:
font(), setText(), and setForeground().


setForeground

public final void setForeground(QBrush brush)
Sets the brush used to display the item's foreground (e. . text) to the given brush.

See also:
foreground(), setBackground(), and setFont().


setIcon

public final void setIcon(QIcon icon)
Sets the item's icon to the icon specified.

See also:
icon().


setRowCount

public final void setRowCount(int rows)
Sets the number of child item rows to rows. If this is less than rowCount(), the data in the unwanted rows is discarded.

See also:
rowCount(), and setColumnCount().


setSelectable

public final void setSelectable(boolean selectable)
Sets whether the item is selectable. If selectable is true, the item can be selected by the user; otherwise, the user cannot select the item.

You can control the selection behavior and mode by manipulating their view properties; see QAbstractItemView::selectionMode and QAbstractItemView::selectionBehavior.

See also:
isSelectable(), and setFlags().


setSizeHint

public final void setSizeHint(QSize sizeHint)
Sets the size hint for the item to be size. If no size hint is set, the item delegate will compute the size hint based on the item data.

See also:
sizeHint().


setStatusTip

public final void setStatusTip(java.lang.String statusTip)
Sets the item's status tip to the string specified by statusTip.

See also:
statusTip(), setToolTip(), and setWhatsThis().


setText

public final void setText(java.lang.String text)
Sets the item's text to the text specified.

See also:
text(), setFont(), and setForeground().


setTextAlignment

public final void setTextAlignment(Qt.AlignmentFlag[] textAlignment)
This is an overloaded method provided for convenience.


setTextAlignment

public final void setTextAlignment(Qt.Alignment textAlignment)
Sets the text alignment for the item's text to the alignment specified.

See also:
textAlignment().


setToolTip

public final void setToolTip(java.lang.String toolTip)
Sets the item's tooltip to the string specified by toolTip.

See also:
toolTip(), setStatusTip(), and setWhatsThis().


setTristate

public final void setTristate(boolean tristate)
Sets whether the item is tristate. If tristate is true, the item is checkable with three separate states; otherwise, the item is checkable with two states. (Note that this also requires that the item is checkable; see isCheckable().)

See also:
isTristate(), setCheckable(), and setCheckState().


setWhatsThis

public final void setWhatsThis(java.lang.String whatsThis)
Sets the item's "What's This?" help to the string specified by whatsThis.

See also:
whatsThis(), setStatusTip(), and setToolTip().


sizeHint

public final QSize sizeHint()
Returns the size hint set for the item, or an invalid QSize if no size hint has been set.

If no size hint has been set, the item delegate will compute the size hint based on the item data.

See also:
setSizeHint().


sortChildren

public final void sortChildren(int column)
Sorts the children of the item using the given order, by the values in the given column.

Note: This function is recursive, therefore it sorts the children of the item, its grandchildren, etc.

See also:
operator<().


sortChildren

public final void sortChildren(int column,
                               Qt.SortOrder order)
Sorts the children of the item using the given order, by the values in the given column.

Note: This function is recursive, therefore it sorts the children of the item, its grandchildren, etc.

See also:
operator<().


statusTip

public final java.lang.String statusTip()
Returns the item's status tip.

See also:
setStatusTip(), toolTip(), and whatsThis().


takeChild

public final QStandardItem takeChild(int row)
Removes the child item at (row, column) without deleting it, and returns a pointer to the item. If there was no child at the given location, then this function returns 0.

Note that this function, unlike takeRow() and takeColumn(), does not affect the dimensions of the child table.

See also:
child(), takeRow(), and takeColumn().


takeChild

public final QStandardItem takeChild(int row,
                                     int column)
Removes the child item at (row, column) without deleting it, and returns a pointer to the item. If there was no child at the given location, then this function returns 0.

Note that this function, unlike takeRow() and takeColumn(), does not affect the dimensions of the child table.

See also:
child(), takeRow(), and takeColumn().


takeColumn

public final java.util.List takeColumn(int column)
Removes column without deleting the column items, and returns a list of pointers to the removed items. For items in the column that have not been set, the corresponding pointers in the list will be 0.

See also:
removeColumn(), insertColumn(), and takeRow().


takeRow

public final java.util.List takeRow(int row)
Removes row without deleting the row items, and returns a list of pointers to the removed items. For items in the row that have not been set, the corresponding pointers in the list will be 0.

See also:
removeRow(), insertRow(), and takeColumn().


text

public final java.lang.String text()
Returns the item's text. This is the text that's presented to the user in a view.

See also:
setText().


textAlignment

public final Qt.Alignment textAlignment()
Returns the text alignment for the item's text.

See also:
setTextAlignment().


toolTip

public final java.lang.String toolTip()
Returns the item's tooltip.

See also:
setToolTip(), statusTip(), and whatsThis().


whatsThis

public final java.lang.String whatsThis()
Returns the item's "What's This?" help.

See also:
setWhatsThis(), toolTip(), and statusTip().


clone

public QStandardItem clone()
This method is reimplemented for internal reasons

Overrides:
clone in class java.lang.Object

data

public final java.lang.Object data()
Returns the item's data for the given role, or an invalid QVariant if there is no data for the role.

Note: The default implementation treats Qt::EditRole and Qt::DisplayRole as referring to the same data.

See also:
setData().


data

public java.lang.Object data(int role)
Returns the item's data for the given role, or an invalid QVariant if there is no data for the role.

Note: The default implementation treats Qt::EditRole and Qt::DisplayRole as referring to the same data.

See also:
setData().


operator_less

public boolean operator_less(QStandardItem other)
Returns true if this item is less than other; otherwise returns false.

The default implementation uses the data for the item's sort role (see QStandardItemModel::sortRole) to perform the comparison if the item belongs to a model; otherwise, the data for the item's Qt::DisplayRole (text()) is used to perform the comparison.

sortChildren() and QStandardItemModel::sort() use this function when sorting items. If you want custom sorting, you can subclass QStandardItem and reimplement this function.


read

public void read(QDataStream in)
Reads the item from stream in. Only the data and flags of the item are read, not the child items.

See also:
write().


setData

public final void setData(java.lang.Object value)
Sets the item's data for the given role to the specified value.

If you subclass QStandardItem and reimplement this function, your reimplementation should call emitDataChanged() if you do not call the base implementation of setData(). This will ensure that e.g. views using the model are notified of the changes.

Note: The default implementation treats Qt::EditRole and Qt::DisplayRole as referring to the same data.

See also:
Qt::ItemDataRole , data(), and setFlags().


setData

public void setData(java.lang.Object value,
                    int role)
Sets the item's data for the given role to the specified value.

If you subclass QStandardItem and reimplement this function, your reimplementation should call emitDataChanged() if you do not call the base implementation of setData(). This will ensure that e.g. views using the model are notified of the changes.

Note: The default implementation treats Qt::EditRole and Qt::DisplayRole as referring to the same data.

See also:
Qt::ItemDataRole , data(), and setFlags().


type

public int type()
Returns the type of this item. The type is used to distinguish custom items from the base class. When subclassing QStandardItem, you should reimplement this function and return a new value greater than or equal to UserType .

See also:
QStandardItem::Type .


write

public void write(QDataStream out)
Writes the item to stream out. Only the data and flags of the item are written, not the child items.

See also:
read().