qlistviewitem.3qt

tmark1.11:用于生成QT/EMBEDDED应用工程的Markfile文件

.TH QListViewItem 3qt "6 July 1999" "Troll Tech AS" \" -*- nroff -*-
.\" Copyright 1992-1999 Troll Tech AS.  All rights reserved.  See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
QListViewItem \- Implements a list view item
.SH SYNOPSIS
.br
.PP
\fC#include <qlistview.h>\fR
.PP
Inherits Qt.
.PP
Inherited by QCheckListItem.
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBQListViewItem\fR ( QListView * parent )"
.br
.ti -1c
.BI "\fBQListViewItem\fR ( QListViewItem * parent )"
.br
.ti -1c
.BI "\fBQListViewItem\fR ( QListView * " "parent" ", QListViewItem * after )"
.br
.ti -1c
.BI "\fBQListViewItem\fR ( QListViewItem * " "parent" ", QListViewItem * after )"
.br
.ti -1c
.BI "\fBQListViewItem\fR ( QListView * " "parent" ", QString, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null )"
.br
.ti -1c
.BI "\fBQListViewItem\fR ( QListViewItem * " "parent" ", QString, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null )"
.br
.ti -1c
.BI "\fBQListViewItem\fR ( QListView * " "parent" ", QListViewItem * " "after" ", QString, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null )"
.br
.ti -1c
.BI "\fBQListViewItem\fR ( QListViewItem * " "parent" ", QListViewItem * " "after" ", QString, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null, QString = QString::null )"
.br
.ti -1c
.BI "virtual \fB~QListViewItem\fR ()"
.br
.ti -1c
.BI "virtual void \fBinsertItem\fR ( QListViewItem * )"
.br
.ti -1c
.BI "virtual void \fBtakeItem\fR ( QListViewItem * )"
.br
.ti -1c
.BI "virtual void \fBremoveItem\fR ( QListViewItem * )"
.br
.ti -1c
.BI "int \fBheight\fR () const"
.br
.ti -1c
.BI "virtual void \fBinvalidateHeight\fR ()"
.br
.ti -1c
.BI "int \fBtotalHeight\fR () const"
.br
.ti -1c
.BI "virtual int \fBwidth\fR ( const QFontMetrics &, const QListView *, int column ) const"
.br
.ti -1c
.BI "void \fBwidthChanged\fR ( int " "column" "=-1 ) const"
.br
.ti -1c
.BI "int \fBdepth\fR () const"
.br
.ti -1c
.BI "virtual void \fBsetText\fR ( int, const QString & )"
.br
.ti -1c
.BI "virtual QString \fBtext\fR ( int ) const"
.br
.ti -1c
.BI "virtual void \fBsetPixmap\fR ( int, const QPixmap & )"
.br
.ti -1c
.BI "virtual const QPixmap* \fBpixmap\fR ( int ) const"
.br
.ti -1c
.BI "virtual QString \fBkey\fR ( int, bool ) const"
.br
.ti -1c
.BI "virtual void \fBsortChildItems\fR ( int, bool )"
.br
.ti -1c
.BI "int \fBchildCount\fR () const"
.br
.ti -1c
.BI "bool \fBisOpen\fR () const"
.br
.ti -1c
.BI "virtual void \fBsetOpen\fR ( bool )"
.br
.ti -1c
.BI "virtual void \fBsetup\fR ()"
.br
.ti -1c
.BI "virtual void \fBsetSelected\fR ( bool )"
.br
.ti -1c
.BI "bool \fBisSelected\fR () const"
.br
.ti -1c
.BI "virtual void \fBpaintCell\fR ( QPainter *, const QColorGroup & " "cg" ", int " "column" ", int " "width" ", int alignment )"
.br
.ti -1c
.BI "virtual void \fBpaintBranches\fR ( QPainter * " "p" ", const QColorGroup & " "cg" ", int " "w" ", int " "y" ", int " "h" ", GUIStyle s )"
.br
.ti -1c
.BI "virtual void \fBpaintFocus\fR ( QPainter *, const QColorGroup & " "cg" ", const QRect & r )"
.br
.ti -1c
.BI "QListViewItem* \fBfirstChild\fR () const"
.br
.ti -1c
.BI "QListViewItem* \fBnextSibling\fR () const"
.br
.ti -1c
.BI "QListViewItem* \fBparent\fR () const"
.br
.ti -1c
.BI "QListViewItem* \fBitemAbove\fR ()"
.br
.ti -1c
.BI "QListViewItem* \fBitemBelow\fR ()"
.br
.ti -1c
.BI "int \fBitemPos\fR () const"
.br
.ti -1c
.BI "QListView* \fBlistView\fR () const"
.br
.ti -1c
.BI "virtual void \fBsetSelectable\fR ( bool enable )"
.br
.ti -1c
.BI "bool \fBisSelectable\fR () const"
.br
.ti -1c
.BI "virtual void \fBsetExpandable\fR ( bool )"
.br
.ti -1c
.BI "bool \fBisExpandable\fR () const"
.br
.ti -1c
.BI "void \fBrepaint\fR () const"
.br
.in -1c
.SS "Protected Members"
.in +1c
.ti -1c
.BI "virtual void \fBenforceSortOrder\fR () const"
.br
.ti -1c
.BI "virtual void \fBsetHeight\fR ( int )"
.br
.ti -1c
.BI "virtual void \fBactivate\fR ()"
.br
.in -1c
.SH DESCRIPTION
The QListViewItem class implements a list view item.
.PP
A list viev item is a multi-column object capable of displaying itself. Its design has the following main goals: 
.TP
Work quickly and well for \fIlarge\fR sets of data. 
.TP
Be easy to use in the simple case. 
.PP
The simplest way to use QListViewItem is to construct one with a few constant strings. This creates an item which is a child of \fIparent,\fR with two fixed-content strings, and discards the pointer to it:
.PP
.nf
.br
     (void) new QListViewItem( parent, "first column", "second column" );
.fi
.PP
This object will be deleted when \fIparent\fR is deleted, as for QObjects.
.PP
The parent is either another QListViewItem or a QListView. If the parent is a QListView, this item is a top-level item within that QListView. If the parent is another QListViewItem, this item becomes a child of the parent item.
.PP
If you keep the pointer, you can set or change the texts using setText(), add pixmaps using setPixmap(), change its mode using setSelectable(), setSelected(), setOpen() and setExpandable(), change its height using setHeight(), and do much tree traversal. The set* functions in QListView also affect QListViewItem, of course.
.PP
You can traverse the tree as if it were a doubly linked list using itemAbove() and itemBelow(); they return pointers to the items directly above and below this item on the screen (even if none of the three are actually visible at the moment).
.PP
You can also traverse it as a tree, using parent(), firstChild() and nextSibling(). This code does something to each of an item's children:
.PP
.nf
.br
    QListViewItem * myChild = myItem->firstChild();
.br
    while( myChild ) {
.br
        doSomething( myChild );
.br
        myChild = myChild->nextSibling();
.br
    }
.fi
.PP
(No iterator class is provided for QListViewItem, as a simple iterator does not adequately express the choices QListViewItem necessitates: Would \fC++it\fR mean "next sibling", "child if any, else next sibling", "child if this object is open and has children, else next subling" or any of a few other possible meanings?)
.PP
Note that the order of the children will change when the sorting order changes, and is undefined if the items are not visible. You can however call enforceSortOrder() at any time, and QListView will always call it before it needs to show an item.
.PP
Many programs will need to reimplement QListViewItem. The most commonly reimplemented functions are: 
.TP
text() returns the text in a column. Many subclasses will compute that on the fly. 
.TP
key() is used for sorting. The default key() simply calls text(), but judicious use of key can be used to sort by e.g. date (as QFileDialog does). 
.TP
setup() is called before showing the item, and whenever e.g. the font changes. 
.TP
activate() is called whenever the user clicks on the item or presses space when the item is the currently highlighted item.
.PP
Some subclasses call setExpandable( TRUE ) even when they have no children, and populate themselves when setup() or setOpen( TRUE ) is called. The dirview/dirview.cpp example program uses precisely this technique to start up quickly: The files and subdirectories in a directory aren't entered into the tree until they need to.
.PP
This example shows a number of root items in a QListView. These items are actually subclassed from QListViewItem: The file size, type etc. are computed on the fly.
.PP
<img src="listview.png" width="518" height="82" alt="Example List View">
.PP
The next example shows a fraction of the dirview example. Again, the Directory/Symbolic Link column is computed on the fly. None of the items are root items; the \fIusr\fR item is a child of the root and the \fIX11\fR item is a child of the \fIusr\fR item.
.PP
<img src="treeview.png" width="227" height="261" alt="Example Tree View">
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QListViewItem::QListViewItem ( QListView * parent )"
Creates a new top-level list view item in the QListView \fIparent.\fR
.SH "QListViewItem::QListViewItem ( QListView * parent, QString label1, QString label2 = QString::null, QString label3 = QString::null, QString label4 = QString::null, QString label5 = QString::null, QString label6 = QString::null, QString label7 = QString::null, QString label8 = QString::null )"
Creates a new list view item in the QListView \fIparent, parent,\fR with at most 8 constant strings as contents.
.PP
.nf
.br
     (void)new QListViewItem( lv, "/", "Root directory" );
.fi
.PP
See also: setText().
.SH "QListViewItem::QListViewItem ( QListView * parent, QListViewItem * after )"
Constructs an empty list view item which is a child of \fIparent\fR and is after \fIafter\fR in the parent's list of children.
.SH "QListViewItem::QListViewItem ( QListView * parent, QListViewItem * after, QString label1, QString label2 = QString::null, QString label3 = QString::null, QString label4 = QString::null, QString label5 = QString::null, QString label6 = QString::null, QString label7 = QString::null, QString label8 = QString::null )"
Creates a new list view item in the QListView \fIparent,\fR after item \fIafter,\fR with at most 8 constant strings as contents.
.PP
Note that the order is changed according to QListViewItem::key() unless the list view's sorting is disabled using QListView::setSorting( -1 ).
.PP
See also: setText().
.SH "QListViewItem::QListViewItem ( QListViewItem * parent )"
Creates a new list view item which is a child of \fIparent\fR and first in the parent's list of children.
.SH "QListViewItem::QListViewItem ( QListViewItem * parent, QString label1, QString label2 = QString::null, QString label3 = QString::null, QString label4 = QString::null, QString label5 = QString::null, QString label6 = QString::null, QString label7 = QString::null, QString label8 = QString::null )"
Creates a new list view item that's a child of the QListViewItem \fIparent,\fR with at most 8 constant strings as contents. Possible example in a threaded news or e-mail reader:
.PP
.nf
.br