From ea318d1431c89e647598c510c4245c6571aa5f46 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Thu, 26 Jan 2012 23:32:43 -0600 Subject: Update to latest tqt3 automated conversion --- doc/html/qlistviewitem.html | 114 ++++++++++++++++++++++---------------------- 1 file changed, 57 insertions(+), 57 deletions(-) (limited to 'doc/html/qlistviewitem.html') diff --git a/doc/html/qlistviewitem.html b/doc/html/qlistviewitem.html index ca3eec1a1..0731f840a 100644 --- a/doc/html/qlistviewitem.html +++ b/doc/html/qlistviewitem.html @@ -33,8 +33,8 @@ body { background: #ffffff; color: black; }

The TQListViewItem class implements a list view item. More... -

#include <qlistview.h> -

Inherits TQt. +

#include <ntqlistview.h> +

Inherits TQt.

Inherited by TQCheckListItem.

List of all member functions.

Public Members

@@ -121,7 +121,7 @@ body { background: #ffffff; color: black; } The TQListViewItem class implements a list view item.

A list view item is a multi-column object capable of displaying -itself in a TQListView. +itself in a TQListView.

The easiest way to use TQListViewItem is to construct one with a few constant strings, and either a TQListView or another TQListViewItem as parent. @@ -132,7 +132,7 @@ TQListViewItem as parent. We've discarded the pointers to the items since we can still access them via their parent listView. By default, TQListView sorts its -items; this can be switched off with TQListView::setSorting(-1). +items; this can be switched off with TQListView::setSorting(-1).

The parent must be another TQListViewItem or a TQListView. If the parent is a TQListView, the item becomes a top-level item within that TQListView. If the parent is another TQListViewItem, the item @@ -142,12 +142,12 @@ becomes a child of that list view item. setSelectable(), setSelected(), setOpen() and setExpandable(). You'll also be able to change its height using setHeight(), and traverse its sub-items. You don't have to keep the pointer since -you can get a pointer to any TQListViewItem in a TQListView using -TQListView::selectedItem(), TQListView::currentItem(), -TQListView::firstChild(), TQListView::lastItem() and -TQListView::findItem(). +you can get a pointer to any TQListViewItem in a TQListView using +TQListView::selectedItem(), TQListView::currentItem(), +TQListView::firstChild(), TQListView::lastItem() and +TQListView::findItem().

If you call delete on a list view item, it will be deleted as -expected, and as usual for TQObjects, if it has any child items +expected, and as usual for TQObjects, if it has any child items (to any depth), all these will be deleted too.

TQCheckListItems are list view items that have a checkbox or radio button and can be used in place of plain TQListViewItems. @@ -181,7 +181,7 @@ particular item, initialize the iterator with the item:

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; TQListView will +can, however, call enforceSortOrder() at any time; TQListView will always call it before it needs to show an item.

Many programs will need to reimplement TQListViewItem. The most commonly reimplemented functions are: @@ -193,7 +193,7 @@ this on the fly. key() Used for sorting. The default key() simply calls text(), but judicious use of key() can give you fine -control over sorting; for example, TQFileDialog +control over sorting; for example, TQFileDialog reimplements key() to sort by date. setup() Called before showing the item and whenever the list @@ -209,58 +209,58 @@ technique to start up tquickly: The files and subdirectories in a directory aren't inserted into the tree until they're actually needed.

List View Items
-

See also TQCheckListItem, TQListView, and Advanced Widgets. +

See also TQCheckListItem, TQListView, and Advanced Widgets.


Member Function Documentation

-

TQListViewItem::TQListViewItem ( TQListView * parent ) +

TQListViewItem::TQListViewItem ( TQListView * parent )

-Constructs a new top-level list view item in the TQListView parent. +Constructs a new top-level list view item in the TQListView parent.

TQListViewItem::TQListViewItem ( TQListViewItem * parent )

Constructs a new list view item that is a child of parent and first in the parent's list of children. -

TQListViewItem::TQListViewItem ( TQListView * parent, TQListViewItem * after ) +

TQListViewItem::TQListViewItem ( TQListView * parent, TQListViewItem * after )

Constructs an empty list view item that is a child of parent and is after item after in the parent's list of children. Since -parent is a TQListView the item will be a top-level item. +parent is a TQListView the item will be a top-level item.

TQListViewItem::TQListViewItem ( TQListViewItem * parent, TQListViewItem * after )

Constructs an empty list view item that is a child of parent and is after item after in the parent's list of children. -

TQListViewItem::TQListViewItem ( TQListView * parent, TQString label1, TQString label2 = TQString::null, TQString label3 = TQString::null, TQString label4 = TQString::null, TQString label5 = TQString::null, TQString label6 = TQString::null, TQString label7 = TQString::null, TQString label8 = TQString::null ) +

TQListViewItem::TQListViewItem ( TQListView * parent, TQString label1, TQString label2 = TQString::null, TQString label3 = TQString::null, TQString label4 = TQString::null, TQString label5 = TQString::null, TQString label6 = TQString::null, TQString label7 = TQString::null, TQString label8 = TQString::null )

-Constructs a new top-level list view item in the TQListView parent, with up to eight constant strings, label1, label2, label3, label4, label5, label6, label7 and label8 +Constructs a new top-level list view item in the TQListView parent, with up to eight constant strings, label1, label2, label3, label4, label5, label6, label7 and label8 defining its columns' contents.

See also setText(). -

TQListViewItem::TQListViewItem ( TQListViewItem * parent, TQString label1, TQString label2 = TQString::null, TQString label3 = TQString::null, TQString label4 = TQString::null, TQString label5 = TQString::null, TQString label6 = TQString::null, TQString label7 = TQString::null, TQString label8 = TQString::null ) +

TQListViewItem::TQListViewItem ( TQListViewItem * parent, TQString label1, TQString label2 = TQString::null, TQString label3 = TQString::null, TQString label4 = TQString::null, TQString label5 = TQString::null, TQString label6 = TQString::null, TQString label7 = TQString::null, TQString label8 = TQString::null )

Constructs a new list view item as a child of the TQListViewItem parent with up to eight constant strings, label1, label2, label3, label4, label5, label6, label7 and label8 as columns' contents.

See also setText(). -

TQListViewItem::TQListViewItem ( TQListView * parent, TQListViewItem * after, TQString label1, TQString label2 = TQString::null, TQString label3 = TQString::null, TQString label4 = TQString::null, TQString label5 = TQString::null, TQString label6 = TQString::null, TQString label7 = TQString::null, TQString label8 = TQString::null ) +

TQListViewItem::TQListViewItem ( TQListView * parent, TQListViewItem * after, TQString label1, TQString label2 = TQString::null, TQString label3 = TQString::null, TQString label4 = TQString::null, TQString label5 = TQString::null, TQString label6 = TQString::null, TQString label7 = TQString::null, TQString label8 = TQString::null )

-Constructs a new list view item in the TQListView parent that is +Constructs a new list view item in the TQListView parent that is included after item after and that has up to eight column texts, label1, label2, label3, label4, label5, label6, label7 andlabel8.

Note that the order is changed according to TQListViewItem::key() unless the list view's sorting is disabled using -TQListView::setSorting(-1). +TQListView::setSorting(-1).

See also setText(). -

TQListViewItem::TQListViewItem ( TQListViewItem * parent, TQListViewItem * after, TQString label1, TQString label2 = TQString::null, TQString label3 = TQString::null, TQString label4 = TQString::null, TQString label5 = TQString::null, TQString label6 = TQString::null, TQString label7 = TQString::null, TQString label8 = TQString::null ) +

TQListViewItem::TQListViewItem ( TQListViewItem * parent, TQListViewItem * after, TQString label1, TQString label2 = TQString::null, TQString label3 = TQString::null, TQString label4 = TQString::null, TQString label5 = TQString::null, TQString label6 = TQString::null, TQString label7 = TQString::null, TQString label8 = TQString::null )

Constructs a new list view item as a child of the TQListViewItem parent. It is inserted after item after and may contain up to eight strings, label1, label2, label3, label4, label5, label6, label7 and label8 as column entries.

Note that the order is changed according to TQListViewItem::key() unless the list view's sorting is disabled using -TQListView::setSorting(-1). +TQListView::setSorting(-1).

See also setText().

TQListViewItem::~TQListViewItem () [virtual] @@ -281,7 +281,7 @@ on this item or presses Space on it.

See also activatedPos().

Reimplemented in TQCheckListItem. -

bool TQListViewItem::activatedPos ( TQPoint & pos ) [protected] +

bool TQListViewItem::activatedPos ( TQPoint & pos ) [protected]

When called from a reimplementation of activate(), this function gives information on how the item was activated. Otherwise the @@ -311,7 +311,7 @@ Compares this list view item to i using the column col in they are equal and > 0 if this item is greater than i.

This function is used for sorting.

The default implementation compares the item keys (key()) using -TQString::localeAwareCompare(). A reimplementation can use +TQString::localeAwareCompare(). A reimplementation can use different values and a different comparison function. Here is a reimplementation that uses plain Unicode comparison:

@@ -324,7 +324,7 @@ reimplementation that uses plain Unicode comparison:
  
 We don't recommend using ascending so your code can safely
 ignore it.
-

See also key(), TQString::localeAwareCompare(), and TQString::compare(). +

See also key(), TQString::localeAwareCompare(), and TQString::compare().

int TQListViewItem::depth () const

@@ -374,7 +374,7 @@ is already sorted. Returns the first (top) child of this item, or 0 if this item has no children.

Note that the children are not guaranteed to be sorted properly. -TQListView and TQListViewItem try to postpone or avoid sorting to +TQListView and TQListViewItem try to postpone or avoid sorting to the greatest degree possible, in order to keep the user interface snappy.

See also nextSibling() and sortChildItems(). @@ -428,7 +428,7 @@ otherwise returns FALSE

Returns TRUE if this item is selected; otherwise returns FALSE. -

See also setSelected(), TQListView::setSelected(), and TQListView::selectionChanged(). +

See also setSelected(), TQListView::setSelected(), and TQListView::selectionChanged().

Example: listviews/listviews.cpp.

bool TQListViewItem::isVisible () const @@ -447,7 +447,7 @@ if there is no item immediately above this item. that this item is visible, or can be made visible by scrolling).

This function might be relatively slow because of the tree traversions needed to find the correct item. -

See also itemBelow() and TQListView::itemRect(). +

See also itemBelow() and TQListView::itemRect().

TQListViewItem * TQListViewItem::itemBelow ()

@@ -459,18 +459,18 @@ returns 0. Returns 0 if there is no item immediately below this item.

This function assumes that all parents of this item are open (i.e. that this item is visible or can be made visible by scrolling). -

See also itemAbove() and TQListView::itemRect(). +

See also itemAbove() and TQListView::itemRect().

Example: dirview/dirview.cpp.

int TQListViewItem::itemPos () const

Returns the y coordinate of this item in the list view's coordinate system. This function is normally much slower than -TQListView::itemAt(), but it works for all items whereas +TQListView::itemAt(), but it works for all items whereas TQListView::itemAt() normally only works for items on the screen. -

See also TQListView::itemAt(), TQListView::itemRect(), and TQListView::itemPos(). +

See also TQListView::itemAt(), TQListView::itemRect(), and TQListView::itemPos(). -

TQString TQListViewItem::key ( int column, bool ascending ) const [virtual] +

TQString TQListViewItem::key ( int column, bool ascending ) const [virtual]

Returns a key that can be used for sorting by column column. @@ -481,7 +481,7 @@ key, although this is not recommended. etc., it is more efficient to reimplement compare().

See also compare() and sortChildItems(). -

TQListView * TQListViewItem::listView () const +

TQListView * TQListViewItem::listView () const

Returns a pointer to the list view containing this item.

Note that this function traverses the items to the root to find the @@ -507,7 +507,7 @@ columns; otherwise returns FALSE.

Returns the sibling item below this item, or 0 if there is no sibling item after this item.

Note that the siblings are not guaranteed to be sorted properly. -TQListView and TQListViewItem try to postpone or avoid sorting to +TQListView and TQListViewItem try to postpone or avoid sorting to the greatest degree possible, in order to keep the user interface snappy.

See also firstChild() and sortChildItems(). @@ -519,7 +519,7 @@ This function is called if the user presses Enter during in-place renaming of the item in column col.

See also cancelRename(). -

void TQListViewItem::paintBranches ( TQPainter * p, const TQColorGroup & cg, int w, int y, int h ) [virtual] +

void TQListViewItem::paintBranches ( TQPainter * p, const TQColorGroup & cg, int w, int y, int h ) [virtual]

Paints a set of branches from this item to (some of) its children.

Painter p is set up with clipping and translation so that you @@ -530,36 +530,36 @@ width w by height h. The top of the rectangle you own is at system's allowed coordinate range).

The update rectangle is in an undefined state when this function is called; this function must draw on all of the pixels. -

See also paintCell() and TQListView::drawContentsOffset(). +

See also paintCell() and TQListView::drawContentsOffset(). -

void TQListViewItem::paintCell ( TQPainter * p, const TQColorGroup & cg, int column, int width, int align ) [virtual] +

void TQListViewItem::paintCell ( TQPainter * p, const TQColorGroup & cg, int column, int width, int align ) [virtual]

This virtual function paints the contents of one column of an item and aligns it as described by align. -

p is a TQPainter open on the relevant paint device. p is +

p is a TQPainter open on the relevant paint device. p is translated so (0, 0) is the top-left pixel in the cell and width-1, height()-1 is the bottom-right pixel in the cell. The other properties of p (pen, brush, etc) are undefined. cg is the color group to use. column is the logical column number within the item that is to be painted; 0 is the column which may contain a tree. -

This function may use TQListView::itemMargin() for readability +

This function may use TQListView::itemMargin() for readability spacing on the left and right sides of data such as text, and -should honor isSelected() and TQListView::allColumnsShowFocus(). +should honor isSelected() and TQListView::allColumnsShowFocus().

If you reimplement this function, you should also reimplement width().

The rectangle to be painted is in an undefined state when this function is called, so you must draw on all the pixels. The painter p has the right font on entry. -

See also paintBranches() and TQListView::drawContentsOffset(). +

See also paintBranches() and TQListView::drawContentsOffset().

Example: listviews/listviews.cpp.

Reimplemented in TQCheckListItem. -

void TQListViewItem::paintFocus ( TQPainter * p, const TQColorGroup & cg, const TQRect & r ) [virtual] +

void TQListViewItem::paintFocus ( TQPainter * p, const TQColorGroup & cg, const TQRect & r ) [virtual]

Paints a focus indicator on the rectangle r using painter p and colors cg.

p is already clipped. -

See also paintCell(), paintBranches(), and TQListView::allColumnsShowFocus. +

See also paintCell(), paintBranches(), and TQListView::allColumnsShowFocus.

Reimplemented in TQCheckListItem.

TQListViewItem * TQListViewItem::parent () const @@ -568,7 +568,7 @@ Returns the parent of this item, or 0 if this item has no parent.

See also firstChild() and nextSibling().

Examples: dirview/dirview.cpp and qutlook/centralwidget.cpp. -

const TQPixmap * TQListViewItem::pixmap ( int column ) const [virtual] +

const TQPixmap * TQListViewItem::pixmap ( int column ) const [virtual]

Returns the pixmap for column, or 0 if there is no pixmap for column. @@ -602,7 +602,7 @@ extensions to this class.

void TQListViewItem::setDragEnabled ( bool allow ) [virtual]

If allow is TRUE, the list view starts a drag (see -TQListView::dragObject()) when the user presses and moves the mouse +TQListView::dragObject()) when the user presses and moves the mouse on this item.

void TQListViewItem::setDropEnabled ( bool allow ) [virtual] @@ -626,7 +626,7 @@ the directory and inserts items accordingly. This strategy means that dirview can display the entire file system without reading very much at startup.

Note that root items are not expandable by the user unless -TQListView::setRootIsDecorated() is set to TRUE. +TQListView::setRootIsDecorated() is set to TRUE.

See also setSelectable().

void TQListViewItem::setHeight ( int height ) [virtual protected] @@ -656,7 +656,7 @@ of the item.

See also height(), totalHeight(), and isOpen().

Examples: checklists/checklists.cpp, dirview/dirview.cpp, dirview/main.cpp, fileiconview/mainwindow.cpp, and xml/tagreader-with-features/structureparser.cpp. -

void TQListViewItem::setPixmap ( int column, const TQPixmap & pm ) [virtual] +

void TQListViewItem::setPixmap ( int column, const TQPixmap & pm ) [virtual]

Sets the pixmap in column column to pm, if pm is non-null and different from the current pixmap, and if column is @@ -682,11 +682,11 @@ programmer (e.g. setSelected() respects this value). If s is TRUE this item is selected; otherwise it is deselected.

This function does not maintain any invariants or repaint anything --- TQListView::setSelected() does that. +-- TQListView::setSelected() does that.

See also height() and totalHeight().

Example: addressbook/centralwidget.cpp. -

void TQListViewItem::setText ( int column, const TQString & text ) [virtual] +

void TQListViewItem::setText ( int column, const TQString & text ) [virtual]

Sets the text in column column to text, if column is a valid column number and text is different from the existing @@ -704,7 +704,7 @@ return this item, although you still can reach it by using e.g.

void TQListViewItem::setup () [virtual]

-This virtual function is called before the first time TQListView +This virtual function is called before the first time TQListView needs to know the height or any other graphical attribute of this object, and whenever the font, GUI style, or colors of the list view change. @@ -725,7 +725,7 @@ configuration (sort column and direction). Sorts this item's children using column column. This is done in ascending order if ascending is TRUE and in descending order if ascending is FALSE. -

Asks some of the children to sort their children. (TQListView and +

Asks some of the children to sort their children. (TQListView and TQListViewItem ensure that all on-screen objects are properly sorted but may avoid or defer sorting other objects in order to be more responsive.) @@ -759,9 +759,9 @@ functions that work on taken items are explicitly documented as such.

See also TQListViewItem::insertItem(). -

TQString TQListViewItem::text ( int column ) const [virtual] +

TQString TQListViewItem::text ( int column ) const [virtual]

-Returns the text in column column, or TQString::null if there is +Returns the text in column column, or TQString::null if there is no text in that column.

See also key() and paintCell(). @@ -777,7 +777,7 @@ item's children, and invalidateHeight() to inval height.

See also height(). -

int TQListViewItem::width ( const TQFontMetrics & fm, const TQListView * lv, int c ) const [virtual] +

int TQListViewItem::width ( const TQFontMetrics & fm, const TQListView * lv, int c ) const [virtual]

Returns the number of pixels of width required to draw column c of list view lv, using the metrics fm without cropping. The @@ -785,7 +785,7 @@ list view containing this item may use this information depending on the TQListView::WidthMode settings for the column.

The default implementation returns the width of the bounding rectangle of the text of column c. -

See also listView(), widthChanged(), TQListView::setColumnWidthMode(), and TQListView::itemMargin. +

See also listView(), widthChanged(), TQListView::setColumnWidthMode(), and TQListView::itemMargin.

void TQListViewItem::widthChanged ( int c = -1 ) const

-- cgit v1.2.1