diff options
Diffstat (limited to 'doc/man/man3')
109 files changed, 2217 insertions, 2217 deletions
diff --git a/doc/man/man3/tqapplication.3qt b/doc/man/man3/tqapplication.3qt index 087c53964..c972a56d7 100644 --- a/doc/man/man3/tqapplication.3qt +++ b/doc/man/man3/tqapplication.3qt @@ -247,7 +247,7 @@ Inherits TQObject. .BI "TQWidget * \fBactiveModalWidget\fR ()" .br .ti -1c -.BI "QClipboard * \fBclipboard\fR ()" +.BI "TQClipboard * \fBclipboard\fR ()" .br .ti -1c .BI "TQWidget * \fBwidgetAt\fR ( int x, int y, bool child = FALSE )" @@ -762,7 +762,7 @@ Examples: .)l chart/main.cpp and scribble/scribble.cpp. .SH "void QApplication::beep ()\fC [static]\fR" Sounds the bell, using the default volume and sound. -.SH "QClipboard * QApplication::clipboard ()\fC [static]\fR" +.SH "TQClipboard * QApplication::clipboard ()\fC [static]\fR" Returns a pointer to the application global clipboard. .PP Examples: @@ -1087,7 +1087,7 @@ You can call this function occasionally when your program is busy performing a l See also exec(), TQTimer, and QEventLoop::processEvents(). .PP Examples: -.)l fileiconview/qfileiconview.cpp and network/ftpclient/main.cpp. +.)l fileiconview/tqfileiconview.cpp and network/ftpclient/main.cpp. .SH "void QApplication::processEvents ( int maxtime )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP @@ -1479,7 +1479,7 @@ For example, if the mouse position of the click is stored in \fCstartPos\fR and .br .fi .PP -Qt uses this value internally, e.g. in QFileDialog. +Qt uses this value internally, e.g. in TQFileDialog. .PP The default value is 4 pixels. .PP diff --git a/doc/man/man3/tqasciidict.3qt b/doc/man/man3/tqasciidict.3qt index 23d0a52cf..915cb8288 100644 --- a/doc/man/man3/tqasciidict.3qt +++ b/doc/man/man3/tqasciidict.3qt @@ -76,10 +76,10 @@ Inherits TQPtrCollection. .SS "Protected Members" .in +1c .ti -1c -.BI "virtual QDataStream & \fBread\fR ( QDataStream & s, TQPtrCollection::Item & item )" +.BI "virtual TQDataStream & \fBread\fR ( TQDataStream & s, TQPtrCollection::Item & item )" .br .ti -1c -.BI "virtual QDataStream & \fBwrite\fR ( QDataStream & s, TQPtrCollection::Item ) const" +.BI "virtual TQDataStream & \fBwrite\fR ( TQDataStream & s, TQPtrCollection::Item ) const" .br .in -1c .SH DESCRIPTION @@ -213,7 +213,7 @@ If there are two or more items with equal keys, then the item that was most rece Equivalent to the find() function. .PP See also find(). -.SH "QDataStream & TQAsciiDict::read ( QDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" +.SH "TQDataStream & TQAsciiDict::read ( TQDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" Reads a dictionary item from the stream \fIs\fR and returns a reference to the stream. .PP The default implementation sets \fIitem\fR to 0. @@ -286,7 +286,7 @@ Returns a pointer to the item taken out, or 0 if the key does not exist in the d All dictionary iterators that refer to the taken item will be set to point to the next item in the dictionary traversal order. .PP See also remove(), clear(), and setAutoDelete(). -.SH "QDataStream & TQAsciiDict::write ( QDataStream & s, TQPtrCollection::Item ) const\fC [virtual protected]\fR" +.SH "TQDataStream & TQAsciiDict::write ( TQDataStream & s, TQPtrCollection::Item ) const\fC [virtual protected]\fR" Writes a dictionary item to the stream \fIs\fR and returns a reference to the stream. .PP See also read(). diff --git a/doc/man/man3/tqbitarray.3qt b/doc/man/man3/tqbitarray.3qt index 498f6edd0..1c3bbb462 100644 --- a/doc/man/man3/tqbitarray.3qt +++ b/doc/man/man3/tqbitarray.3qt @@ -93,10 +93,10 @@ Inherits TQByteArray. .BI "TQBitArray \fBoperator^\fR ( const TQBitArray & a1, const TQBitArray & a2 )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQBitArray & a )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQBitArray & a )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQBitArray & a )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQBitArray & a )" .br .in -1c .SH DESCRIPTION @@ -325,14 +325,14 @@ Returns the AND result between the bit arrays \fIa1\fR and \fIa2\fR. The result has the length of the longest of the two bit arrays, with any missing bits (i.e. if one array is shorter than the other), taken to be 0. .PP See also TQBitArray::operator&=(). -.SH "QDataStream & operator<< ( QDataStream & s, const TQBitArray & a )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQBitArray & a )" Writes bit array \fIa\fR to stream \fIs\fR. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, TQBitArray & a )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, TQBitArray & a )" Reads a bit array into \fIa\fR from stream \fIs\fR. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "TQBitArray operator^ ( const TQBitArray & a1, const TQBitArray & a2 )" Returns the XOR result between the bit arrays \fIa1\fR and \fIa2\fR. .PP diff --git a/doc/man/man3/tqbrush.3qt b/doc/man/man3/tqbrush.3qt index 8bf55904d..cf52814e2 100644 --- a/doc/man/man3/tqbrush.3qt +++ b/doc/man/man3/tqbrush.3qt @@ -64,10 +64,10 @@ Inherits Qt. .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QBrush & b )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QBrush & b )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QBrush & b )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QBrush & b )" .br .in -1c .SH DESCRIPTION @@ -199,14 +199,14 @@ Returns the brush style. .PP See also setStyle(). .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QBrush & b )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QBrush & b )" Writes the brush \fIb\fR to the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, QBrush & b )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, QBrush & b )" Reads the brush \fIb\fR from the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqbrush.html diff --git a/doc/man/man3/tqbuffer.3qt b/doc/man/man3/tqbuffer.3qt index cd6451e71..4eeaee57d 100644 --- a/doc/man/man3/tqbuffer.3qt +++ b/doc/man/man3/tqbuffer.3qt @@ -1,5 +1,5 @@ '\" t -.TH QBuffer 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQBuffer 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,24 +7,24 @@ .ad l .nh .SH NAME -QBuffer \- I/O device that operates on a TQByteArray +TQBuffer \- I/O device that operates on a TQByteArray .SH SYNOPSIS All the functions in this class are reentrant when TQt is built with thread support.</p> .PP -\fC#include <ntqbuffer.h>\fR +\fC#include <tqbuffer.h>\fR .PP Inherits TQIODevice. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQBuffer\fR ()" +.BI "\fBTQBuffer\fR ()" .br .ti -1c -.BI "\fBQBuffer\fR ( TQByteArray buf )" +.BI "\fBTQBuffer\fR ( TQByteArray buf )" .br .ti -1c -.BI "\fB~QBuffer\fR ()" +.BI "\fB~TQBuffer\fR ()" .br .ti -1c .BI "TQByteArray \fBbuffer\fR () const" @@ -40,28 +40,28 @@ Inherits TQIODevice. .br .in -1c .SH DESCRIPTION -The QBuffer class is an I/O device that operates on a TQByteArray. +The TQBuffer class is an I/O device that operates on a TQByteArray. .PP -QBuffer is used to read and write to a memory buffer. It is normally used with a TQTextStream or a QDataStream. QBuffer has an associated TQByteArray which holds the buffer data. The size() of the buffer is automatically adjusted as data is written. +TQBuffer is used to read and write to a memory buffer. It is normally used with a TQTextStream or a TQDataStream. TQBuffer has an associated TQByteArray which holds the buffer data. The size() of the buffer is automatically adjusted as data is written. .PP -The constructor \fCQBuffer(TQByteArray)\fR creates a QBuffer using an existing byte array. The byte array can also be set with setBuffer(). Writing to the QBuffer will modify the original byte array because TQByteArray is explicitly shared. +The constructor \fCTQBuffer(TQByteArray)\fR creates a TQBuffer using an existing byte array. The byte array can also be set with setBuffer(). Writing to the TQBuffer will modify the original byte array because TQByteArray is explicitly shared. .PP Use open() to open the buffer before use and to set the mode (read-only, write-only, etc.). close() closes the buffer. The buffer must be closed before reopening or calling setBuffer(). .PP -A common way to use QBuffer is through QDataStream or TQTextStream, which have constructors that take a QBuffer parameter. For convenience, there are also QDataStream and TQTextStream constructors that take a TQByteArray parameter. These constructors create and open an internal QBuffer. +A common way to use TQBuffer is through TQDataStream or TQTextStream, which have constructors that take a TQBuffer parameter. For convenience, there are also TQDataStream and TQTextStream constructors that take a TQByteArray parameter. These constructors create and open an internal TQBuffer. .PP -Note that TQTextStream can also operate on a TQString (a Unicode string); a QBuffer cannot. +Note that TQTextStream can also operate on a TQString (a Unicode string); a TQBuffer cannot. .PP -You can also use QBuffer directly through the standard TQIODevice functions readBlock(), writeBlock() readLine(), at(), getch(), putch() and ungetch(). +You can also use TQBuffer directly through the standard TQIODevice functions readBlock(), writeBlock() readLine(), at(), getch(), putch() and ungetch(). .PP -See also QFile, QDataStream, TQTextStream, TQByteArray, Shared Classes, Collection Classes, and Input/Output and Networking. +See also TQFile, TQDataStream, TQTextStream, TQByteArray, Shared Classes, Collection Classes, and Input/Output and Networking. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QBuffer::QBuffer ()" +.SH "TQBuffer::TQBuffer ()" Constructs an empty buffer. -.SH "QBuffer::QBuffer ( TQByteArray buf )" +.SH "TQBuffer::TQBuffer ( TQByteArray buf )" Constructs a buffer that operates on \fIbuf\fR. .PP -If you open the buffer in write mode (<a href="ntqfile.html#open">IO_WriteOnly</a> or IO_ReadWrite) and write something into the buffer, \fIbuf\fR will be modified. +If you open the buffer in write mode (<a href="tqfile.html#open">IO_WriteOnly</a> or IO_ReadWrite) and write something into the buffer, \fIbuf\fR will be modified. .PP Example: .PP @@ -69,7 +69,7 @@ Example: .br TQCString str = "abc"; .br - QBuffer b( str ); + TQBuffer b( str ); .br b.open( IO_WriteOnly ); .br @@ -84,21 +84,21 @@ Example: .fi .PP See also setBuffer(). -.SH "QBuffer::~QBuffer ()" +.SH "TQBuffer::~TQBuffer ()" Destroys the buffer. -.SH "TQByteArray QBuffer::buffer () const" +.SH "TQByteArray TQBuffer::buffer () const" Returns this buffer's byte array. .PP See also setBuffer(). -.SH "bool QBuffer::setBuffer ( TQByteArray buf )" +.SH "bool TQBuffer::setBuffer ( TQByteArray buf )" Replaces the buffer's contents with \fIbuf\fR and returns TRUE. .PP Does nothing (and returns FALSE) if isOpen() is TRUE. .PP -Note that if you open the buffer in write mode (<a href="ntqfile.html#open">IO_WriteOnly</a> or IO_ReadWrite) and write something into the buffer, \fIbuf\fR is also modified because TQByteArray is an explicitly shared class. +Note that if you open the buffer in write mode (<a href="tqfile.html#open">IO_WriteOnly</a> or IO_ReadWrite) and write something into the buffer, \fIbuf\fR is also modified because TQByteArray is an explicitly shared class. .PP See also buffer(), open(), and close(). -.SH "TQ_LONG QBuffer::writeBlock ( const char * p, TQ_ULONG len )\fC [virtual]\fR" +.SH "TQ_LONG TQBuffer::writeBlock ( const char * p, TQ_ULONG len )\fC [virtual]\fR" Writes \fIlen\fR bytes from \fIp\fR into the buffer at the current index position, overwriting any characters there and extending the buffer if necessary. Returns the number of bytes actually written. .PP Returns -1 if an error occurred. @@ -106,14 +106,14 @@ Returns -1 if an error occurred. See also readBlock(). .PP Reimplemented from TQIODevice. -.SH "TQ_LONG QBuffer::writeBlock ( const TQByteArray & data )" +.SH "TQ_LONG TQBuffer::writeBlock ( const TQByteArray & data )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP This convenience function is the same as calling \fCwriteBlock( data.data(), data.size() )\fR with \fIdata\fR. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqbuffer.html +.BR http://doc.trolltech.com/tqbuffer.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqclipboard.3qt b/doc/man/man3/tqclipboard.3qt index fba1aacf7..fac76e43f 100644 --- a/doc/man/man3/tqclipboard.3qt +++ b/doc/man/man3/tqclipboard.3qt @@ -1,5 +1,5 @@ '\" t -.TH QClipboard 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQClipboard 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QClipboard \- Access to the window system clipboard +TQClipboard \- Access to the window system clipboard .SH SYNOPSIS -\fC#include <ntqclipboard.h>\fR +\fC#include <tqclipboard.h>\fR .PP Inherits TQObject. .PP @@ -104,24 +104,24 @@ Inherits TQObject. .br .in -1c .SH DESCRIPTION -The QClipboard class provides access to the window system clipboard. +The TQClipboard class provides access to the window system clipboard. .PP The clipboard offers a simple mechanism to copy and paste data between applications. .PP -QClipboard supports the same data types that TQDragObject does, and uses similar mechanisms. For advanced clipboard usage read the drag-and-drop documentation. +TQClipboard supports the same data types that TQDragObject does, and uses similar mechanisms. For advanced clipboard usage read the drag-and-drop documentation. .PP -There is a single QClipboard object in an application, and you can access it using QApplication::clipboard(). +There is a single TQClipboard object in an application, and you can access it using QApplication::clipboard(). .PP Example: .PP .nf .br - QClipboard *cb = QApplication::clipboard(); + TQClipboard *cb = QApplication::clipboard(); .br .br // Copy text from the clipboard (paste) .br - TQString text = cb->text(QClipboard::Clipboard); + TQString text = cb->text(TQClipboard::Clipboard); .br if ( !text.isNull() ) .br @@ -132,11 +132,11 @@ Example: .br cb->setText( "This text can be pasted by other programs", .br - QClipboard::Clipboard ); + TQClipboard::Clipboard ); .br .fi .PP -QClipboard features some convenience functions to access common data types: setText() allows the exchange of Unicode text and setPixmap() and setImage() allows the exchange of QPixmaps and TQImages between applications. The setData() function is the ultimate in flexibility: it allows you to add any TQMimeSource into the clipboard. There are corresponding getters for each of these, e.g. text(), image() and pixmap(). +TQClipboard features some convenience functions to access common data types: setText() allows the exchange of Unicode text and setPixmap() and setImage() allows the exchange of QPixmaps and TQImages between applications. The setData() function is the ultimate in flexibility: it allows you to add any TQMimeSource into the clipboard. There are corresponding getters for each of these, e.g. text(), image() and pixmap(). .PP You can clear the clipboard by calling clear(). .SH "Platform Specific Information" @@ -165,93 +165,93 @@ See the multiclip example in the \fIQt Designer\fR examples directory for an exa .PP See also Environment Classes and Input/Output and Networking. .SS "Member Type Documentation" -.SH "QClipboard::Mode" +.SH "TQClipboard::Mode" .PP -This enum type is used to control which part of the system clipboard is used by QClipboard::data(), QClipboard::setData() and related functions. +This enum type is used to control which part of the system clipboard is used by TQClipboard::data(), TQClipboard::setData() and related functions. .TP -\fCQClipboard::Clipboard\fR - indicates that data should be stored and retrieved from the global clipboard. +\fCTQClipboard::Clipboard\fR - indicates that data should be stored and retrieved from the global clipboard. .TP -\fCQClipboard::Selection\fR - indicates that data should be stored and retrieved from the global mouse selection. +\fCTQClipboard::Selection\fR - indicates that data should be stored and retrieved from the global mouse selection. .PP \fINote\fR: Support for Selection is provided only on systems with a global mouse selection (e.g. X11). .PP -See also QClipboard::supportsSelection(). +See also TQClipboard::supportsSelection(). .SH MEMBER FUNCTION DOCUMENTATION -.SH "void QClipboard::clear ( Mode mode )" +.SH "void TQClipboard::clear ( Mode mode )" Clear the clipboard contents. .PP -The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is QClipboard::Clipboard, this function clears the the global clipboard contents. If \fImode\fR is QClipboard::Selection, this function clears the global mouse selection contents. +The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is TQClipboard::Clipboard, this function clears the the global clipboard contents. If \fImode\fR is TQClipboard::Selection, this function clears the global mouse selection contents. .PP -See also QClipboard::Mode and supportsSelection(). -.SH "void QClipboard::clear ()" +See also TQClipboard::Mode and supportsSelection(). +.SH "void TQClipboard::clear ()" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -This function uses the QClipboard::clear() function which takes a QClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is QClipboard::Selection, otherwise the mode argument is QClipboard::Clipboard. -.SH "TQMimeSource * QClipboard::data ( Mode mode ) const" +This function uses the TQClipboard::clear() function which takes a TQClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is TQClipboard::Selection, otherwise the mode argument is TQClipboard::Clipboard. +.SH "TQMimeSource * TQClipboard::data ( Mode mode ) const" Returns a reference to a TQMimeSource representation of the current clipboard data. .PP -The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is QClipboard::Clipboard, the data is retrieved from the global clipboard. If \fImode\fR is QClipboard::Selection, the data is retrieved from the global mouse selection. +The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is TQClipboard::Clipboard, the data is retrieved from the global clipboard. If \fImode\fR is TQClipboard::Selection, the data is retrieved from the global mouse selection. .PP See also setData(). -.SH "TQMimeSource * QClipboard::data () const" +.SH "TQMimeSource * TQClipboard::data () const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -This function uses the QClipboard::data() function which takes a QClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is QClipboard::Selection, otherwise the mode argument is QClipboard::Clipboard. -.SH "void QClipboard::dataChanged ()\fC [signal]\fR" +This function uses the TQClipboard::data() function which takes a TQClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is TQClipboard::Selection, otherwise the mode argument is TQClipboard::Clipboard. +.SH "void TQClipboard::dataChanged ()\fC [signal]\fR" This signal is emitted when the clipboard data is changed. -.SH "TQImage QClipboard::image ( Mode mode ) const" +.SH "TQImage TQClipboard::image ( Mode mode ) const" Returns the clipboard image, or returns a null image if the clipboard does not contain an image or if it contains an image in an unsupported image format. .PP -The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is QClipboard::Clipboard, the image is retrieved from the global clipboard. If \fImode\fR is QClipboard::Selection, the image is retrieved from the global mouse selection. +The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is TQClipboard::Clipboard, the image is retrieved from the global clipboard. If \fImode\fR is TQClipboard::Selection, the image is retrieved from the global mouse selection. .PP See also setImage(), pixmap(), data(), and TQImage::isNull(). -.SH "TQImage QClipboard::image () const" +.SH "TQImage TQClipboard::image () const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -This function uses the QClipboard::image() function which takes a QClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is QClipboard::Selection, otherwise the mode argument is QClipboard::Clipboard. -.SH "bool QClipboard::ownsClipboard () const" +This function uses the TQClipboard::image() function which takes a TQClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is TQClipboard::Selection, otherwise the mode argument is TQClipboard::Clipboard. +.SH "bool TQClipboard::ownsClipboard () const" Returns TRUE if this clipboard object owns the clipboard data; otherwise returns FALSE. -.SH "bool QClipboard::ownsSelection () const" +.SH "bool TQClipboard::ownsSelection () const" Returns TRUE if this clipboard object owns the mouse selection data; otherwise returns FALSE. -.SH "QPixmap QClipboard::pixmap ( Mode mode ) const" +.SH "QPixmap TQClipboard::pixmap ( Mode mode ) const" Returns the clipboard pixmap, or null if the clipboard does not contain a pixmap. Note that this can lose information. For example, if the image is 24-bit and the display is 8-bit, the result is converted to 8 bits, and if the image has an alpha channel, the result just has a mask. .PP -The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is QClipboard::Clipboard, the pixmap is retrieved from the global clipboard. If \fImode\fR is QClipboard::Selection, the pixmap is retrieved from the global mouse selection. +The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is TQClipboard::Clipboard, the pixmap is retrieved from the global clipboard. If \fImode\fR is TQClipboard::Selection, the pixmap is retrieved from the global mouse selection. .PP See also setPixmap(), image(), data(), and QPixmap::convertFromImage(). -.SH "QPixmap QClipboard::pixmap () const" +.SH "QPixmap TQClipboard::pixmap () const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -This function uses the QClipboard::pixmap() function which takes a QClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is QClipboard::Selection, otherwise the mode argument is QClipboard::Clipboard. -.SH "void QClipboard::selectionChanged ()\fC [signal]\fR" +This function uses the TQClipboard::pixmap() function which takes a TQClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is TQClipboard::Selection, otherwise the mode argument is TQClipboard::Clipboard. +.SH "void TQClipboard::selectionChanged ()\fC [signal]\fR" This signal is emitted when the selection is changed. This only applies to windowing systems that support selections, e.g. X11. Windows doesn't support selections. -.SH "bool QClipboard::selectionModeEnabled () const" +.SH "bool TQClipboard::selectionModeEnabled () const" \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. .PP -Use the QClipboard::data(), QClipboard::setData() and related functions which take a QClipboard::Mode argument. +Use the TQClipboard::data(), TQClipboard::setData() and related functions which take a TQClipboard::Mode argument. .PP Returns the selection mode. .PP See also setSelectionMode() and supportsSelection(). -.SH "void QClipboard::setData ( TQMimeSource * src, Mode mode )" +.SH "void TQClipboard::setData ( TQMimeSource * src, Mode mode )" Sets the clipboard data to \fIsrc\fR. Ownership of the data is transferred to the clipboard. If you want to remove the data either call clear() or call setData() again with new data. .PP -The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is QClipboard::Clipboard, the data is retrieved from the global clipboard. If \fImode\fR is QClipboard::Selection, the data is retrieved from the global mouse selection. +The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is TQClipboard::Clipboard, the data is retrieved from the global clipboard. If \fImode\fR is TQClipboard::Selection, the data is retrieved from the global mouse selection. .PP The TQDragObject subclasses are reasonable objects to put into the clipboard (but do not try to call TQDragObject::drag() on the same object). Any TQDragObject placed in the clipboard should have a parent of 0. Do not put TQDragMoveEvent or TQDropEvent subclasses in the clipboard, as they do not belong to the event handler which receives them. .PP The setText(), setImage() and setPixmap() functions are simpler wrappers for setting text, image and pixmap data respectively. .PP See also data(). -.SH "void QClipboard::setData ( TQMimeSource * src )" +.SH "void TQClipboard::setData ( TQMimeSource * src )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -This function uses the QClipboard::setData() function which takes a QClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is QClipboard::Selection, otherwise the mode argument is QClipboard::Clipboard. -.SH "void QClipboard::setImage ( const TQImage & image, Mode mode )" +This function uses the TQClipboard::setData() function which takes a TQClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is TQClipboard::Selection, otherwise the mode argument is TQClipboard::Clipboard. +.SH "void TQClipboard::setImage ( const TQImage & image, Mode mode )" Copies \fIimage\fR into the clipboard. .PP -The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is QClipboard::Clipboard, the image is stored in the global clipboard. If \fImode\fR is QClipboard::Selection, the data is stored in the global mouse selection. +The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is TQClipboard::Clipboard, the image is stored in the global clipboard. If \fImode\fR is TQClipboard::Selection, the data is stored in the global mouse selection. .PP This is shorthand for: .PP @@ -262,77 +262,77 @@ This is shorthand for: .fi .PP See also image(), setPixmap(), and setData(). -.SH "void QClipboard::setImage ( const TQImage & image )" +.SH "void TQClipboard::setImage ( const TQImage & image )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -This function uses the QClipboard::setImage() function which takes a QClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is QClipboard::Selection, otherwise the mode argument is QClipboard::Clipboard. -.SH "void QClipboard::setPixmap ( const QPixmap & pixmap, Mode mode )" +This function uses the TQClipboard::setImage() function which takes a TQClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is TQClipboard::Selection, otherwise the mode argument is TQClipboard::Clipboard. +.SH "void TQClipboard::setPixmap ( const QPixmap & pixmap, Mode mode )" Copies \fIpixmap\fR into the clipboard. Note that this is slower than setImage() because it needs to convert the QPixmap to a TQImage first. .PP -The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is QClipboard::Clipboard, the pixmap is stored in the global clipboard. If \fImode\fR is QClipboard::Selection, the pixmap is stored in the global mouse selection. +The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is TQClipboard::Clipboard, the pixmap is stored in the global clipboard. If \fImode\fR is TQClipboard::Selection, the pixmap is stored in the global mouse selection. .PP See also pixmap(), setImage(), and setData(). -.SH "void QClipboard::setPixmap ( const QPixmap & pixmap )" +.SH "void TQClipboard::setPixmap ( const QPixmap & pixmap )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -This function uses the QClipboard::setPixmap() function which takes a QClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is QClipboard::Selection, otherwise the mode argument is QClipboard::Clipboard. -.SH "void QClipboard::setSelectionMode ( bool enable )" +This function uses the TQClipboard::setPixmap() function which takes a TQClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is TQClipboard::Selection, otherwise the mode argument is TQClipboard::Clipboard. +.SH "void TQClipboard::setSelectionMode ( bool enable )" \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. .PP -Use the QClipboard::data(), QClipboard::setData() and related functions which take a QClipboard::Mode argument. +Use the TQClipboard::data(), TQClipboard::setData() and related functions which take a TQClipboard::Mode argument. .PP -Sets the clipboard selection mode. If \fIenable\fR is TRUE, then subsequent calls to QClipboard::setData() and other functions which put data into the clipboard will put the data into the mouse selection, otherwise the data will be put into the clipboard. +Sets the clipboard selection mode. If \fIenable\fR is TRUE, then subsequent calls to TQClipboard::setData() and other functions which put data into the clipboard will put the data into the mouse selection, otherwise the data will be put into the clipboard. .PP See also supportsSelection() and selectionModeEnabled(). -.SH "void QClipboard::setText ( const TQString & text, Mode mode )" +.SH "void TQClipboard::setText ( const TQString & text, Mode mode )" Copies \fItext\fR into the clipboard as plain text. .PP -The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is QClipboard::Clipboard, the text is stored in the global clipboard. If \fImode\fR is QClipboard::Selection, the text is stored in the global mouse selection. +The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is TQClipboard::Clipboard, the text is stored in the global clipboard. If \fImode\fR is TQClipboard::Selection, the text is stored in the global mouse selection. .PP See also text() and setData(). .PP Example: regexptester/regexptester.cpp. -.SH "void QClipboard::setText ( const TQString & text )" +.SH "void TQClipboard::setText ( const TQString & text )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -This function uses the QClipboard::setText() function which takes a QClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is QClipboard::Selection, otherwise the mode argument is QClipboard::Clipboard. -.SH "bool QClipboard::supportsSelection () const" +This function uses the TQClipboard::setText() function which takes a TQClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is TQClipboard::Selection, otherwise the mode argument is TQClipboard::Clipboard. +.SH "bool TQClipboard::supportsSelection () const" Returns TRUE if the clipboard supports mouse selection; otherwise returns FALSE. .PP Example: regexptester/regexptester.cpp. -.SH "TQString QClipboard::text ( Mode mode ) const" +.SH "TQString TQClipboard::text ( Mode mode ) const" Returns the clipboard text as plain text, or a null string if the clipboard does not contain any text. .PP -The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is QClipboard::Clipboard, the text is retrieved from the global clipboard. If \fImode\fR is QClipboard::Selection, the text is retrieved from the global mouse selection. +The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is TQClipboard::Clipboard, the text is retrieved from the global clipboard. If \fImode\fR is TQClipboard::Selection, the text is retrieved from the global mouse selection. .PP See also setText(), data(), and TQString::operator!(). -.SH "TQString QClipboard::text ( TQCString & subtype, Mode mode ) const" +.SH "TQString TQClipboard::text ( TQCString & subtype, Mode mode ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns the clipboard text in subtype \fIsubtype\fR, or a null string if the clipboard does not contain any text. If \fIsubtype\fR is null, any subtype is acceptable, and \fIsubtype\fR is set to the chosen subtype. .PP -The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is QClipboard::Clipboard, the text is retrieved from the global clipboard. If \fImode\fR is QClipboard::Selection, the text is retrieved from the global mouse selection. +The \fImode\fR argument is used to control which part of the system clipboard is used. If \fImode\fR is TQClipboard::Clipboard, the text is retrieved from the global clipboard. If \fImode\fR is TQClipboard::Selection, the text is retrieved from the global mouse selection. .PP Common values for \fIsubtype\fR are "plain" and "html". .PP See also setText(), data(), and TQString::operator!(). -.SH "TQString QClipboard::text () const" +.SH "TQString TQClipboard::text () const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -This function uses the QClipboard::text() function which takes a QClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is QClipboard::Selection, otherwise the mode argument is QClipboard::Clipboard. -.SH "TQString QClipboard::text ( TQCString & subtype ) const" +This function uses the TQClipboard::text() function which takes a TQClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() returns TRUE, the mode argument is TQClipboard::Selection, otherwise the mode argument is TQClipboard::Clipboard. +.SH "TQString TQClipboard::text ( TQCString & subtype ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns the clipboard text in subtype \fIsubtype\fR, or a null string if the clipboard does not contain any text. This function uses the -QClipboard::text() function which takes a QClipboard::Mode +TQClipboard::text() function which takes a TQClipboard::Mode argument. The value of the mode argument is determined by the return value of selectionModeEnabled(). If selectionModeEnabled() -returns TRUE, the mode argument is QClipboard::Selection, -otherwise the mode argument is QClipboard::Clipboard. +returns TRUE, the mode argument is TQClipboard::Selection, +otherwise the mode argument is TQClipboard::Clipboard. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqclipboard.html +.BR http://doc.trolltech.com/tqclipboard.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqcolor.3qt b/doc/man/man3/tqcolor.3qt index 34696d4c3..c6f474a61 100644 --- a/doc/man/man3/tqcolor.3qt +++ b/doc/man/man3/tqcolor.3qt @@ -140,10 +140,10 @@ TQColor \- Colors based on RGB or HSV values .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQColor & c )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQColor & c )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQColor & c )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQColor & c )" .br .ti -1c .BI "int \fBqRed\fR ( TQRgb rgb )" @@ -523,14 +523,14 @@ The type \fIQRgb\fR is equivalent to \fCunsigned\fR \fCint\fR. .PP See also rgb() and setHsv(). .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const TQColor & c )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQColor & c )" Writes a color object, \fIc\fR to the stream, \fIs\fR. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, TQColor & c )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, TQColor & c )" Reads a color object, \fIc\fR, from the stream, \fIs\fR. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "int tqAlpha ( TQRgb rgba )" Returns the alpha component of the RGBA quadruplet \fIrgba\fR. .SH "int tqBlue ( TQRgb rgb )" diff --git a/doc/man/man3/tqcolorgroup.3qt b/doc/man/man3/tqcolorgroup.3qt index c22374b32..4c9b2fac4 100644 --- a/doc/man/man3/tqcolorgroup.3qt +++ b/doc/man/man3/tqcolorgroup.3qt @@ -104,7 +104,7 @@ QColorGroup \- Group of widget colors .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QColorGroup & g )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QColorGroup & g )" .br .in -1c .SH DESCRIPTION @@ -327,10 +327,10 @@ See also ColorRole. .PP Example: listviews/listviews.cpp. .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QColorGroup & g )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QColorGroup & g )" Writes color group, \fIg\fR to the stream \fIs\fR. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/qcolorgroup.html diff --git a/doc/man/man3/tqcstring.3qt b/doc/man/man3/tqcstring.3qt index 0ba70bce6..4013c5165 100644 --- a/doc/man/man3/tqcstring.3qt +++ b/doc/man/man3/tqcstring.3qt @@ -240,10 +240,10 @@ Inherits TQByteArray. .BI "int \fBqstrnicmp\fR ( const char * str1, const char * str2, uint len )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQCString & str )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQCString & str )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQCString & str )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQCString & str )" .br .ti -1c .BI "bool \fBoperator==\fR ( const TQCString & s1, const TQCString & s2 )" @@ -975,10 +975,10 @@ Returns TRUE if \fIs1\fR is less than \fIs2\fR; otherwise returns FALSE. Equivalent to qstrcmp(\fIs1\fR, \fIs2\fR) < 0. .PP See also Note on character comparisons. -.SH "QDataStream & operator<< ( QDataStream & s, const TQCString & str )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQCString & str )" Writes string \fIstr\fR to the stream \fIs\fR. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "bool operator<= ( const TQCString & s1, const char * s2 )" Returns TRUE if \fIs1\fR is less than or equal to \fIs2\fR; otherwise returns FALSE. .PP @@ -1037,10 +1037,10 @@ Returns TRUE if \fIs1\fR is greater than or equal to \fIs2\fR; otherwise returns Equivalent to qstrcmp(\fIs1\fR, \fIs2\fR) >= 0. .PP See also Note on character comparisons. -.SH "QDataStream & operator>> ( QDataStream & s, TQCString & str )" +.SH "TQDataStream & operator>> ( TQDataStream & s, TQCString & str )" Reads a string into \fIstr\fR from the stream \fIs\fR. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "void * tqmemmove ( void * dst, const void * src, uint len )" This function is normally part of the C library. TQt implements memmove() for platforms that do not provide it. .PP diff --git a/doc/man/man3/tqcursor.3qt b/doc/man/man3/tqcursor.3qt index c8c0b23ef..3b86bbbf9 100644 --- a/doc/man/man3/tqcursor.3qt +++ b/doc/man/man3/tqcursor.3qt @@ -82,10 +82,10 @@ Inherits Qt. .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QCursor & c )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QCursor & c )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QCursor & c )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QCursor & c )" .br .in -1c .SH DESCRIPTION @@ -198,7 +198,7 @@ You can call TQWidget::mapFromGlobal() to translate it to widget coordinates. See also setPos(), TQWidget::mapFromGlobal(), and TQWidget::mapToGlobal(). .PP Examples: -.)l chart/canvasview.cpp, fileiconview/qfileiconview.cpp, and menu/menu.cpp. +.)l chart/canvasview.cpp, fileiconview/tqfileiconview.cpp, and menu/menu.cpp. .SH "void QCursor::setPos ( int x, int y )\fC [static]\fR" Moves the cursor (hot spot) to the global screen position (\fIx\fR, \fIy\fR). .PP @@ -218,14 +218,14 @@ Returns the cursor shape identifier. The return value is one of the CursorShape .PP See also setShape(). .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QCursor & c )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QCursor & c )" Writes the cursor \fIc\fR to the stream \fIs\fR. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, QCursor & c )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, QCursor & c )" Reads a cursor from the stream \fIs\fR and sets \fIc\fR to the read data. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqcursor.html diff --git a/doc/man/man3/tqdatabrowser.3qt b/doc/man/man3/tqdatabrowser.3qt index 7d7e4fe05..d3a8d11d0 100644 --- a/doc/man/man3/tqdatabrowser.3qt +++ b/doc/man/man3/tqdatabrowser.3qt @@ -271,17 +271,17 @@ See also Database Classes. .SH "TQDataBrowser::Boundary" This enum describes where the data browser is positioned. .TP -\fCQDataBrowser::Unknown\fR - the boundary cannot be determined (usually because there is no default cursor, or the default cursor is not active). +\fCTQDataBrowser::Unknown\fR - the boundary cannot be determined (usually because there is no default cursor, or the default cursor is not active). .TP -\fCQDataBrowser::None\fR - the browser is not positioned on a boundary, but it is positioned on a record somewhere in the middle. +\fCTQDataBrowser::None\fR - the browser is not positioned on a boundary, but it is positioned on a record somewhere in the middle. .TP -\fCQDataBrowser::BeforeBeginning\fR - the browser is positioned before the first available record. +\fCTQDataBrowser::BeforeBeginning\fR - the browser is positioned before the first available record. .TP -\fCQDataBrowser::Beginning\fR - the browser is positioned at the first record. +\fCTQDataBrowser::Beginning\fR - the browser is positioned at the first record. .TP -\fCQDataBrowser::End\fR - the browser is positioned at the last record. +\fCTQDataBrowser::End\fR - the browser is positioned at the last record. .TP -\fCQDataBrowser::AfterEnd\fR - the browser is positioned after the last available record. +\fCTQDataBrowser::AfterEnd\fR - the browser is positioned after the last available record. .SH MEMBER FUNCTION DOCUMENTATION .SH "TQDataBrowser::TQDataBrowser ( TQWidget * parent = 0, const char * name = 0, WFlags fl = 0 )" Constructs a data browser which is a child of \fIparent\fR, with the name \fIname\fR and widget flags set to \fIfl\fR. diff --git a/doc/man/man3/tqdatastream.3qt b/doc/man/man3/tqdatastream.3qt index 046771aae..cd69ab262 100644 --- a/doc/man/man3/tqdatastream.3qt +++ b/doc/man/man3/tqdatastream.3qt @@ -1,5 +1,5 @@ '\" t -.TH QDataStream 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQDataStream 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,25 +7,25 @@ .ad l .nh .SH NAME -QDataStream \- Serialization of binary data to a TQIODevice +TQDataStream \- Serialization of binary data to a TQIODevice .SH SYNOPSIS All the functions in this class are reentrant when TQt is built with thread support.</p> .PP -\fC#include <ntqdatastream.h>\fR +\fC#include <tqdatastream.h>\fR .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQDataStream\fR ()" +.BI "\fBTQDataStream\fR ()" .br .ti -1c -.BI "\fBQDataStream\fR ( TQIODevice * d )" +.BI "\fBTQDataStream\fR ( TQIODevice * d )" .br .ti -1c -.BI "\fBQDataStream\fR ( TQByteArray a, int mode )" +.BI "\fBTQDataStream\fR ( TQByteArray a, int mode )" .br .ti -1c -.BI "virtual \fB~QDataStream\fR ()" +.BI "virtual \fB~TQDataStream\fR ()" .br .ti -1c .BI "TQIODevice * \fBdevice\fR () const" @@ -64,116 +64,116 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "void \fBsetVersion\fR ( int v )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( TQ_INT8 & i )" +.BI "TQDataStream & \fBoperator>>\fR ( TQ_INT8 & i )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( TQ_UINT8 & i )" +.BI "TQDataStream & \fBoperator>>\fR ( TQ_UINT8 & i )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( TQ_INT16 & i )" +.BI "TQDataStream & \fBoperator>>\fR ( TQ_INT16 & i )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( TQ_UINT16 & i )" +.BI "TQDataStream & \fBoperator>>\fR ( TQ_UINT16 & i )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( TQ_INT32 & i )" +.BI "TQDataStream & \fBoperator>>\fR ( TQ_INT32 & i )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( TQ_UINT32 & i )" +.BI "TQDataStream & \fBoperator>>\fR ( TQ_UINT32 & i )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( TQ_INT64 & i )" +.BI "TQDataStream & \fBoperator>>\fR ( TQ_INT64 & i )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( TQ_UINT64 & i )" +.BI "TQDataStream & \fBoperator>>\fR ( TQ_UINT64 & i )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( TQ_LONG & i )" +.BI "TQDataStream & \fBoperator>>\fR ( TQ_LONG & i )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( TQ_ULONG & i )" +.BI "TQDataStream & \fBoperator>>\fR ( TQ_ULONG & i )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( float & f )" +.BI "TQDataStream & \fBoperator>>\fR ( float & f )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( double & f )" +.BI "TQDataStream & \fBoperator>>\fR ( double & f )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( char *& s )" +.BI "TQDataStream & \fBoperator>>\fR ( char *& s )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( TQ_INT8 i )" +.BI "TQDataStream & \fBoperator<<\fR ( TQ_INT8 i )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( TQ_UINT8 i )" +.BI "TQDataStream & \fBoperator<<\fR ( TQ_UINT8 i )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( TQ_INT16 i )" +.BI "TQDataStream & \fBoperator<<\fR ( TQ_INT16 i )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( TQ_UINT16 i )" +.BI "TQDataStream & \fBoperator<<\fR ( TQ_UINT16 i )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( TQ_INT32 i )" +.BI "TQDataStream & \fBoperator<<\fR ( TQ_INT32 i )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( TQ_UINT32 i )" +.BI "TQDataStream & \fBoperator<<\fR ( TQ_UINT32 i )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( TQ_INT64 i )" +.BI "TQDataStream & \fBoperator<<\fR ( TQ_INT64 i )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( TQ_UINT64 i )" +.BI "TQDataStream & \fBoperator<<\fR ( TQ_UINT64 i )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( TQ_LONG i )" +.BI "TQDataStream & \fBoperator<<\fR ( TQ_LONG i )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( TQ_ULONG i )" +.BI "TQDataStream & \fBoperator<<\fR ( TQ_ULONG i )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( float f )" +.BI "TQDataStream & \fBoperator<<\fR ( float f )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( double f )" +.BI "TQDataStream & \fBoperator<<\fR ( double f )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( const char * s )" +.BI "TQDataStream & \fBoperator<<\fR ( const char * s )" .br .ti -1c -.BI "QDataStream & \fBreadBytes\fR ( char *& s, uint & l )" +.BI "TQDataStream & \fBreadBytes\fR ( char *& s, uint & l )" .br .ti -1c -.BI "QDataStream & \fBreadRawBytes\fR ( char * s, uint len )" +.BI "TQDataStream & \fBreadRawBytes\fR ( char * s, uint len )" .br .ti -1c -.BI "QDataStream & \fBwriteBytes\fR ( const char * s, uint len )" +.BI "TQDataStream & \fBwriteBytes\fR ( const char * s, uint len )" .br .ti -1c -.BI "QDataStream & \fBwriteRawBytes\fR ( const char * s, uint len )" +.BI "TQDataStream & \fBwriteRawBytes\fR ( const char * s, uint len )" .br .in -1c .SH DESCRIPTION -The QDataStream class provides serialization of binary data to a TQIODevice. +The TQDataStream class provides serialization of binary data to a TQIODevice. .PP A data stream is a binary stream of encoded information which is 100% independent of the host computer's operating system, CPU or byte order. For example, a data stream that is written by a PC under Windows can be read by a Sun SPARC running Solaris. .PP You can also use a data stream to read/write raw unencoded binary data. If you want a "parsing" input stream, see TQTextStream. .PP -The QDataStream class implements the serialization of C++'s basic data types, like \fCchar\fR, \fCshort\fR, \fCint\fR, \fCchar*\fR, etc. Serialization of more complex data is accomplished by breaking up the data into primitive units. +The TQDataStream class implements the serialization of C++'s basic data types, like \fCchar\fR, \fCshort\fR, \fCint\fR, \fCchar*\fR, etc. Serialization of more complex data is accomplished by breaking up the data into primitive units. .PP -A data stream cooperates closely with a TQIODevice. A TQIODevice represents an input/output medium one can read data from and write data to. The QFile class is an example of an IO device. +A data stream cooperates closely with a TQIODevice. A TQIODevice represents an input/output medium one can read data from and write data to. The TQFile class is an example of an IO device. .PP Example (write binary data to a stream): .PP .nf .br - QFile file( "file.dat" ); + TQFile file( "file.dat" ); .br file.open( IO_WriteOnly ); .br - QDataStream stream( &file ); // we will serialize the data into the file + TQDataStream stream( &file ); // we will serialize the data into the file .br stream << "the answer is"; // serialize a string .br @@ -185,11 +185,11 @@ Example (read binary data from a stream): .PP .nf .br - QFile file( "file.dat" ); + TQFile file( "file.dat" ); .br file.open( IO_ReadOnly ); .br - QDataStream stream( &file ); // read the data serialized from the file + TQDataStream stream( &file ); // read the data serialized from the file .br TQString str; .br @@ -199,7 +199,7 @@ Example (read binary data from a stream): .br .fi .PP -Each item written to the stream is written in a predefined binary format that varies depending on the item's type. Supported TQt types include QBrush, TQColor, TQDateTime, QFont, QPixmap, TQString, QVariant and many others. For the complete list of all TQt types supporting data streaming see the Format of the QDataStream operators. +Each item written to the stream is written in a predefined binary format that varies depending on the item's type. Supported TQt types include QBrush, TQColor, TQDateTime, QFont, QPixmap, TQString, QVariant and many others. For the complete list of all TQt types supporting data streaming see the Format of the TQDataStream operators. .PP For integers it is best to always cast to a TQt integer type for writing, and to read back into the same TQt integer type. This ensures that you get integers of the size you want and insulates you from compiler and platform differences. .PP @@ -211,15 +211,15 @@ If you want the data to be compatible with an earlier version of TQt use setVers .PP If you want the data to be human-readable, e.g. for debugging, you can set the data stream into printable data mode with setPrintableData(). The data is then written slower, in a bloated but human readable format. .PP -If you are producing a new binary data format, such as a file format for documents created by your application, you could use a QDataStream to write the data in a portable format. Typically, you would write a brief header containing a magic string and a version number to give yourself room for future expansion. For example: +If you are producing a new binary data format, such as a file format for documents created by your application, you could use a TQDataStream to write the data in a portable format. Typically, you would write a brief header containing a magic string and a version number to give yourself room for future expansion. For example: .PP .nf .br - QFile file( "file.xxx" ); + TQFile file( "file.xxx" ); .br file.open( IO_WriteOnly ); .br - QDataStream stream( &file ); + TQDataStream stream( &file ); .br .br // Write a header with a "magic number" and a version @@ -239,11 +239,11 @@ Then read it in with: .PP .nf .br - QFile file( "file.xxx" ); + TQFile file( "file.xxx" ); .br file.open( IO_ReadOnly ); .br - QDataStream stream( &file ); + TQDataStream stream( &file ); .br .br // Read and check the header @@ -296,25 +296,25 @@ A similar pair of functions is readBytes() and writeBytes(). These differ from t .PP See also TQTextStream, QVariant, and Input/Output and Networking. .SS "Member Type Documentation" -.SH "QDataStream::ByteOrder" +.SH "TQDataStream::ByteOrder" The byte order used for reading/writing the data. .TP -\fCQDataStream::BigEndian\fR - the default +\fCTQDataStream::BigEndian\fR - the default .TP -\fCQDataStream::LittleEndian\fR +\fCTQDataStream::LittleEndian\fR .SH MEMBER FUNCTION DOCUMENTATION -.SH "QDataStream::QDataStream ()" +.SH "TQDataStream::TQDataStream ()" Constructs a data stream that has no IO device. .PP See also setDevice(). -.SH "QDataStream::QDataStream ( TQIODevice * d )" +.SH "TQDataStream::TQDataStream ( TQIODevice * d )" Constructs a data stream that uses the IO device \fId\fR. .PP -\fBWarning:\fR If you use QSocket or QSocketDevice as the IO device \fId\fR for reading data, you must make sure that enough data is available on the socket for the operation to successfully proceed; QDataStream does not have any means to handle or recover from short-reads. +\fBWarning:\fR If you use TQSocket or TQSocketDevice as the IO device \fId\fR for reading data, you must make sure that enough data is available on the socket for the operation to successfully proceed; TQDataStream does not have any means to handle or recover from short-reads. .PP See also setDevice() and device(). -.SH "QDataStream::QDataStream ( TQByteArray a, int mode )" -Constructs a data stream that operates on a byte array, \fIa\fR, through an internal QBuffer device. The \fImode\fR is a TQIODevice::mode(), usually either IO_ReadOnly or IO_WriteOnly. +.SH "TQDataStream::TQDataStream ( TQByteArray a, int mode )" +Constructs a data stream that operates on a byte array, \fIa\fR, through an internal TQBuffer device. The \fImode\fR is a TQIODevice::mode(), usually either IO_ReadOnly or IO_WriteOnly. .PP Example: .PP @@ -326,7 +326,7 @@ Example: .br a.setRawData( bindata, sizeof(bindata) ); // a points to bindata .br - QDataStream stream( a, IO_ReadOnly ); // open on a's data + TQDataStream stream( a, IO_ReadOnly ); // open on a's data .br stream >> [something]; // read raw bindata .br @@ -335,23 +335,23 @@ Example: .fi .PP The TQByteArray::setRawData() function is not for the inexperienced. -.SH "QDataStream::~QDataStream ()\fC [virtual]\fR" +.SH "TQDataStream::~TQDataStream ()\fC [virtual]\fR" Destroys the data stream. .PP The destructor will not affect the current IO device, unless it is an internal IO device processing a TQByteArray passed in the \fIconstructor\fR, in which case the internal IO device is destroyed. -.SH "bool QDataStream::atEnd () const" +.SH "bool TQDataStream::atEnd () const" Returns TRUE if the IO device has reached the end position (end of the stream or file) or if there is no IO device set; otherwise returns FALSE, i.e. if the current position of the IO device is before the end position. .PP See also TQIODevice::atEnd(). -.SH "int QDataStream::byteOrder () const" +.SH "int TQDataStream::byteOrder () const" Returns the current byte order setting -- either BigEndian or LittleEndian. .PP See also setByteOrder(). -.SH "TQIODevice * QDataStream::device () const" +.SH "TQIODevice * TQDataStream::device () const" Returns the IO device currently set. .PP See also setDevice() and unsetDevice(). -.SH "bool QDataStream::eof () const" +.SH "bool TQDataStream::eof () const" \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. .PP Returns TRUE if the IO device has reached the end position (end of stream or file) or if there is no IO device set. @@ -359,115 +359,115 @@ Returns TRUE if the IO device has reached the end position (end of stream or fil Returns FALSE if the current position of the read/write head of the IO device is somewhere before the end position. .PP See also TQIODevice::atEnd(). -.SH "bool QDataStream::isPrintableData () const" +.SH "bool TQDataStream::isPrintableData () const" Returns TRUE if the printable data flag has been set; otherwise returns FALSE. .PP See also setPrintableData(). -.SH "QDataStream & QDataStream::operator<< ( TQ_INT8 i )" +.SH "TQDataStream & TQDataStream::operator<< ( TQ_INT8 i )" Writes a signed byte, \fIi\fR, to the stream and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( TQ_UINT8 i )" +.SH "TQDataStream & TQDataStream::operator<< ( TQ_UINT8 i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes an unsigned byte, \fIi\fR, to the stream and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( TQ_INT16 i )" +.SH "TQDataStream & TQDataStream::operator<< ( TQ_INT16 i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes a signed 16-bit integer, \fIi\fR, to the stream and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( TQ_UINT16 i )" +.SH "TQDataStream & TQDataStream::operator<< ( TQ_UINT16 i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes an unsigned 16-bit integer, \fIi\fR, to the stream and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( TQ_INT32 i )" +.SH "TQDataStream & TQDataStream::operator<< ( TQ_INT32 i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes a signed 32-bit integer, \fIi\fR, to the stream and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( TQ_UINT32 i )" +.SH "TQDataStream & TQDataStream::operator<< ( TQ_UINT32 i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes an unsigned integer, \fIi\fR, to the stream as a 32-bit unsigned integer (TQ_UINT32). Returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( TQ_INT64 i )" +.SH "TQDataStream & TQDataStream::operator<< ( TQ_INT64 i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes a signed 64-bit integer, \fIi\fR, to the stream and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( TQ_UINT64 i )" +.SH "TQDataStream & TQDataStream::operator<< ( TQ_UINT64 i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes an unsigned 64-bit integer, \fIi\fR, to the stream and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( TQ_LONG i )" +.SH "TQDataStream & TQDataStream::operator<< ( TQ_LONG i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes a signed integer \fIi\fR, of the system's word length, to the stream and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( TQ_ULONG i )" +.SH "TQDataStream & TQDataStream::operator<< ( TQ_ULONG i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes an unsigned integer \fIi\fR, of the system's word length, to the stream and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( float f )" +.SH "TQDataStream & TQDataStream::operator<< ( float f )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes a 32-bit floating point number, \fIf\fR, to the stream using the standard IEEE754 format. Returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( double f )" +.SH "TQDataStream & TQDataStream::operator<< ( double f )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes a 64-bit floating point number, \fIf\fR, to the stream using the standard IEEE754 format. Returns a reference to the stream. -.SH "QDataStream & QDataStream::operator<< ( const char * s )" +.SH "TQDataStream & TQDataStream::operator<< ( const char * s )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes the '\0'-terminated string \fIs\fR to the stream and returns a reference to the stream. .PP The string is serialized using writeBytes(). -.SH "QDataStream & QDataStream::operator>> ( TQ_INT8 & i )" +.SH "TQDataStream & TQDataStream::operator>> ( TQ_INT8 & i )" Reads a signed byte from the stream into \fIi\fR, and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( TQ_UINT8 & i )" +.SH "TQDataStream & TQDataStream::operator>> ( TQ_UINT8 & i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads an unsigned byte from the stream into \fIi\fR, and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( TQ_INT16 & i )" +.SH "TQDataStream & TQDataStream::operator>> ( TQ_INT16 & i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads a signed 16-bit integer from the stream into \fIi\fR, and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( TQ_UINT16 & i )" +.SH "TQDataStream & TQDataStream::operator>> ( TQ_UINT16 & i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads an unsigned 16-bit integer from the stream into \fIi\fR, and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( TQ_INT32 & i )" +.SH "TQDataStream & TQDataStream::operator>> ( TQ_INT32 & i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads a signed 32-bit integer from the stream into \fIi\fR, and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( TQ_UINT32 & i )" +.SH "TQDataStream & TQDataStream::operator>> ( TQ_UINT32 & i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads an unsigned 32-bit integer from the stream into \fIi\fR, and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( TQ_INT64 & i )" +.SH "TQDataStream & TQDataStream::operator>> ( TQ_INT64 & i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads a signed 64-bit integer from the stream into \fIi\fR, and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( TQ_UINT64 & i )" +.SH "TQDataStream & TQDataStream::operator>> ( TQ_UINT64 & i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads an unsigned 64-bit integer from the stream, into \fIi\fR, and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( TQ_LONG & i )" +.SH "TQDataStream & TQDataStream::operator>> ( TQ_LONG & i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads a signed integer of the system's word length from the stream into \fIi\fR, and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( TQ_ULONG & i )" +.SH "TQDataStream & TQDataStream::operator>> ( TQ_ULONG & i )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads an unsigned integer of the system's word length from the stream, into \fIi\fR, and returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( float & f )" +.SH "TQDataStream & TQDataStream::operator>> ( float & f )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads a 32-bit floating point number from the stream into \fIf\fR, using the standard IEEE754 format. Returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( double & f )" +.SH "TQDataStream & TQDataStream::operator>> ( double & f )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads a 64-bit floating point number from the stream into \fIf\fR, using the standard IEEE754 format. Returns a reference to the stream. -.SH "QDataStream & QDataStream::operator>> ( char *& s )" +.SH "TQDataStream & TQDataStream::operator>> ( char *& s )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads the '\0'-terminated string \fIs\fR from the stream and returns a reference to the stream. .PP Space for the string is allocated using \fCnew\fR -- the caller must destroy it with delete[]. -.SH "QDataStream & QDataStream::readBytes ( char *& s, uint & l )" +.SH "TQDataStream & TQDataStream::readBytes ( char *& s, uint & l )" Reads the buffer \fIs\fR from the stream and returns a reference to the stream. .PP The buffer \fIs\fR is allocated using \fCnew\fR. Destroy it with the \fCdelete[]\fR operator. If the length is zero or \fIs\fR cannot be allocated, \fIs\fR is set to 0. @@ -477,68 +477,68 @@ The \fIl\fR parameter will be set to the length of the buffer. The serialization format is a TQ_UINT32 length specifier first, then \fIl\fR bytes of data. Note that the data is \fInot\fR encoded. .PP See also readRawBytes() and writeBytes(). -.SH "QDataStream & QDataStream::readRawBytes ( char * s, uint len )" +.SH "TQDataStream & TQDataStream::readRawBytes ( char * s, uint len )" Reads \fIlen\fR bytes from the stream into \fIs\fR and returns a reference to the stream. .PP The buffer \fIs\fR must be preallocated. The data is \fInot\fR encoded. .PP See also readBytes(), TQIODevice::readBlock(), and writeRawBytes(). -.SH "void QDataStream::setByteOrder ( int bo )" +.SH "void TQDataStream::setByteOrder ( int bo )" Sets the serialization byte order to \fIbo\fR. .PP -The \fIbo\fR parameter can be QDataStream::BigEndian or QDataStream::LittleEndian. +The \fIbo\fR parameter can be TQDataStream::BigEndian or TQDataStream::LittleEndian. .PP The default setting is big endian. We recommend leaving this setting unless you have special requirements. .PP See also byteOrder(). -.SH "void QDataStream::setDevice ( TQIODevice * d )" -void QDataStream::setDevice(TQIODevice *d ) +.SH "void TQDataStream::setDevice ( TQIODevice * d )" +void TQDataStream::setDevice(TQIODevice *d ) .PP Sets the IO device to \fId\fR. .PP See also device() and unsetDevice(). -.SH "void QDataStream::setPrintableData ( bool enable )" +.SH "void TQDataStream::setPrintableData ( bool enable )" If \fIenable\fR is TRUE, data will be output in a human readable format. If \fIenable\fR is FALSE, data will be output in a binary format. .PP If \fIenable\fR is TRUE, the write functions will generate output that consists of printable characters (7 bit ASCII). This output will typically be a lot larger than the default binary output, and consequently slower to write. .PP We recommend only enabling printable data for debugging purposes. -.SH "void QDataStream::setVersion ( int v )" +.SH "void TQDataStream::setVersion ( int v )" Sets the version number of the data serialization format to \fIv\fR. .PP You don't need to set a version if you are using the current version of Qt. .PP -In order to accommodate new functionality, the datastream serialization format of some TQt classes has changed in some versions of Qt. If you want to read data that was created by an earlier version of Qt, or write data that can be read by a program that was compiled with an earlier version of Qt, use this function to modify the serialization format of QDataStream. +In order to accommodate new functionality, the datastream serialization format of some TQt classes has changed in some versions of Qt. If you want to read data that was created by an earlier version of Qt, or write data that can be read by a program that was compiled with an earlier version of Qt, use this function to modify the serialization format of TQDataStream. .PP <center>.nf .TS -l - l. TQt Version QDataStream Version TQt 3.3 6 TQt 3.2 5 TQt 3.1 5 TQt 3.0 4 TQt 2.1.x and TQt 2.2.x 3 TQt 2.0.x 2 TQt 1.x +l - l. TQt Version TQDataStream Version TQt 3.3 6 TQt 3.2 5 TQt 3.1 5 TQt 3.0 4 TQt 2.1.x and TQt 2.2.x 3 TQt 2.0.x 2 TQt 1.x .TE .fi </center> .PP See also version(). -.SH "void QDataStream::unsetDevice ()" +.SH "void TQDataStream::unsetDevice ()" Unsets the IO device. This is the same as calling setDevice( 0 ). .PP See also device() and setDevice(). -.SH "int QDataStream::version () const" +.SH "int TQDataStream::version () const" Returns the version number of the data serialization format. In TQt 3.1, this number is 5. .PP See also setVersion(). -.SH "QDataStream & QDataStream::writeBytes ( const char * s, uint len )" +.SH "TQDataStream & TQDataStream::writeBytes ( const char * s, uint len )" Writes the length specifier \fIlen\fR and the buffer \fIs\fR to the stream and returns a reference to the stream. .PP The \fIlen\fR is serialized as a TQ_UINT32, followed by \fIlen\fR bytes from \fIs\fR. Note that the data is \fInot\fR encoded. .PP See also writeRawBytes() and readBytes(). -.SH "QDataStream & QDataStream::writeRawBytes ( const char * s, uint len )" +.SH "TQDataStream & TQDataStream::writeRawBytes ( const char * s, uint len )" Writes \fIlen\fR bytes from \fIs\fR to the stream and returns a reference to the stream. The data is \fInot\fR encoded. .PP See also writeBytes(), TQIODevice::writeBlock(), and readRawBytes(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqdatastream.html +.BR http://doc.trolltech.com/tqdatastream.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqdatatable.3qt b/doc/man/man3/tqdatatable.3qt index 8d8fb648b..d28ce5e23 100644 --- a/doc/man/man3/tqdatatable.3qt +++ b/doc/man/man3/tqdatatable.3qt @@ -322,11 +322,11 @@ See also Database Classes. .SH "TQDataTable::Refresh" This enum describes the refresh options. .TP -\fCQDataTable::RefreshData\fR - refresh the data, i.e. read it from the database +\fCTQDataTable::RefreshData\fR - refresh the data, i.e. read it from the database .TP -\fCQDataTable::RefreshColumns\fR - refresh the list of fields, e.g. the column headings +\fCTQDataTable::RefreshColumns\fR - refresh the list of fields, e.g. the column headings .TP -\fCQDataTable::RefreshAll\fR - refresh both the data and the list of fields +\fCTQDataTable::RefreshAll\fR - refresh both the data and the list of fields .SH MEMBER FUNCTION DOCUMENTATION .SH "TQDataTable::TQDataTable ( TQWidget * parent = 0, const char * name = 0 )" Constructs a data table which is a child of \fIparent\fR, called name \fIname\fR. diff --git a/doc/man/man3/tqdate.3qt b/doc/man/man3/tqdate.3qt index e0126c0a1..4dd499798 100644 --- a/doc/man/man3/tqdate.3qt +++ b/doc/man/man3/tqdate.3qt @@ -130,10 +130,10 @@ All the functions in this class are reentrant when TQt is built with thread supp .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQDate & d )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQDate & d )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQDate & d )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQDate & d )" .br .in -1c .SH DESCRIPTION @@ -394,14 +394,14 @@ Returns the year (1752..8000) of this date. .PP See also month() and day(). .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const TQDate & d )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQDate & d )" Writes the date, \fId\fR, to the data stream, \fIs\fR. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, TQDate & d )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, TQDate & d )" Reads a date from the stream \fIs\fR into \fId\fR. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/tqdate.html diff --git a/doc/man/man3/tqdatetime.3qt b/doc/man/man3/tqdatetime.3qt index 0aa70de04..52fd1696e 100644 --- a/doc/man/man3/tqdatetime.3qt +++ b/doc/man/man3/tqdatetime.3qt @@ -109,10 +109,10 @@ All the functions in this class are reentrant when TQt is built with thread supp .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQDateTime & dt )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQDateTime & dt )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQDateTime & dt )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQDateTime & dt )" .br .in -1c .SH DESCRIPTION @@ -302,14 +302,14 @@ On systems that do not support timezones, this function will behave as if local .PP See also setTime_t(). .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const TQDateTime & dt )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQDateTime & dt )" Writes the datetime \fIdt\fR to the stream \fIs\fR. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, TQDateTime & dt )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, TQDateTime & dt )" Reads a datetime from the stream \fIs\fR into \fIdt\fR. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/tqdatetime.html diff --git a/doc/man/man3/tqdialog.3qt b/doc/man/man3/tqdialog.3qt index 0f676df42..482306099 100644 --- a/doc/man/man3/tqdialog.3qt +++ b/doc/man/man3/tqdialog.3qt @@ -13,7 +13,7 @@ QDialog \- The base class of dialog windows .PP Inherits TQWidget. .PP -Inherited by QColorDialog, QErrorMessage, QFileDialog, QFontDialog, QInputDialog, QMessageBox, QMotifDialog, QProgressDialog, QTabDialog, and QWizard. +Inherited by QColorDialog, QErrorMessage, TQFileDialog, QFontDialog, QInputDialog, QMessageBox, QMotifDialog, QProgressDialog, QTabDialog, and QWizard. .PP .SS "Public Members" .in +1c @@ -122,13 +122,13 @@ A modal dialog. .PP .nf .br - QFileDialog *dlg = new QFileDialog( workingDirectory, + TQFileDialog *dlg = new TQFileDialog( workingDirectory, .br TQString::null, 0, 0, TRUE ); .br - dlg->setCaption( QFileDialog::tr( "Open" ) ); + dlg->setCaption( TQFileDialog::tr( "Open" ) ); .br - dlg->setMode( QFileDialog::ExistingFile ); + dlg->setMode( TQFileDialog::ExistingFile ); .br TQString result; .br @@ -222,7 +222,7 @@ Users cannot interact with any other window in the same application until they c See also show() and result(). .PP Examples: -.)l chart/chartform.cpp, dialog/mainwindow.cpp, i18n/main.cpp, network/ftpclient/ftpmainwindow.ui.h, network/networkprotocol/view.cpp, qdir/qdir.cpp, and wizard/main.cpp. +.)l chart/chartform.cpp, dialog/mainwindow.cpp, i18n/main.cpp, network/ftpclient/ftpmainwindow.ui.h, network/networkprotocol/view.cpp, tqdir/tqdir.cpp, and wizard/main.cpp. .SH "TQWidget * QDialog::extension () const" Returns the dialog's extension or 0 if no extension has been defined. .PP diff --git a/doc/man/man3/tqdict.3qt b/doc/man/man3/tqdict.3qt index 677bf3df9..c34011b1e 100644 --- a/doc/man/man3/tqdict.3qt +++ b/doc/man/man3/tqdict.3qt @@ -76,10 +76,10 @@ Inherits TQPtrCollection. .SS "Protected Members" .in +1c .ti -1c -.BI "virtual QDataStream & \fBread\fR ( QDataStream & s, TQPtrCollection::Item & item )" +.BI "virtual TQDataStream & \fBread\fR ( TQDataStream & s, TQPtrCollection::Item & item )" .br .ti -1c -.BI "virtual QDataStream & \fBwrite\fR ( QDataStream & s, TQPtrCollection::Item ) const" +.BI "virtual TQDataStream & \fBwrite\fR ( TQDataStream & s, TQPtrCollection::Item ) const" .br .in -1c .SH DESCRIPTION @@ -270,7 +270,7 @@ If there are two or more items with equal keys, then the most recently inserted Equivalent to the find() function. .PP See also find(). -.SH "QDataStream & TQDict::read ( QDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" +.SH "TQDataStream & TQDict::read ( TQDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" Reads a dictionary item from the stream \fIs\fR and returns a reference to the stream. .PP The default implementation sets \fIitem\fR to 0. @@ -343,7 +343,7 @@ Returns a pointer to the item taken out, or 0 if the key does not exist in the d All dictionary iterators that refer to the taken item will be set to point to the next item in the dictionary traversal order. .PP See also remove(), clear(), and setAutoDelete(). -.SH "QDataStream & TQDict::write ( QDataStream & s, TQPtrCollection::Item ) const\fC [virtual protected]\fR" +.SH "TQDataStream & TQDict::write ( TQDataStream & s, TQPtrCollection::Item ) const\fC [virtual protected]\fR" Writes a dictionary item to the stream \fIs\fR and returns a reference to the stream. .PP See also read(). diff --git a/doc/man/man3/tqdir.3qt b/doc/man/man3/tqdir.3qt index 9fca59162..8aaeb93f8 100644 --- a/doc/man/man3/tqdir.3qt +++ b/doc/man/man3/tqdir.3qt @@ -1,5 +1,5 @@ '\" t -.TH QDir 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQDir 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,11 +7,11 @@ .ad l .nh .SH NAME -QDir \- Access to directory structures and their contents in a platform-independent way +TQDir \- Access to directory structures and their contents in a platform-independent way .SH SYNOPSIS All the functions in this class are reentrant when TQt is built with thread support.</p> .PP -\fC#include <ntqdir.h>\fR +\fC#include <tqdir.h>\fR .PP .SS "Public Members" .in +1c @@ -22,22 +22,22 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "enum \fBSortSpec\fR { Name = 0x00, Time = 0x01, Size = 0x02, Unsorted = 0x03, SortByMask = 0x03, DirsFirst = 0x04, Reversed = 0x08, IgnoreCase = 0x10, LocaleAware = 0x20, DefaultSort = -1 }" .br .ti -1c -.BI "\fBQDir\fR ()" +.BI "\fBTQDir\fR ()" .br .ti -1c -.BI "\fBQDir\fR ( const TQString & path, const TQString & nameFilter = TQString::null, int sortSpec = Name | IgnoreCase, int filterSpec = All )" +.BI "\fBTQDir\fR ( const TQString & path, const TQString & nameFilter = TQString::null, int sortSpec = Name | IgnoreCase, int filterSpec = All )" .br .ti -1c -.BI "\fBQDir\fR ( const QDir & d )" +.BI "\fBTQDir\fR ( const TQDir & d )" .br .ti -1c -.BI "virtual \fB~QDir\fR ()" +.BI "virtual \fB~TQDir\fR ()" .br .ti -1c -.BI "QDir & \fBoperator=\fR ( const QDir & d )" +.BI "TQDir & \fBoperator=\fR ( const TQDir & d )" .br .ti -1c -.BI "QDir & \fBoperator=\fR ( const TQString & path )" +.BI "TQDir & \fBoperator=\fR ( const TQString & path )" .br .ti -1c .BI "virtual void \fBsetPath\fR ( const TQString & path )" @@ -109,10 +109,10 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "virtual TQStringList \fBentryList\fR ( const TQString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const" .br .ti -1c -.BI "virtual const QFileInfoList * \fBentryInfoList\fR ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const" +.BI "virtual const TQFileInfoList * \fBentryInfoList\fR ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const" .br .ti -1c -.BI "virtual const QFileInfoList * \fBentryInfoList\fR ( const TQString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const" +.BI "virtual const TQFileInfoList * \fBentryInfoList\fR ( const TQString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const" .br .ti -1c .BI "virtual bool \fBmkdir\fR ( const TQString & dirName, bool acceptAbsPath = TRUE ) const" @@ -136,10 +136,10 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "virtual void \fBconvertToAbs\fR ()" .br .ti -1c -.BI "virtual bool \fBoperator==\fR ( const QDir & d ) const" +.BI "virtual bool \fBoperator==\fR ( const TQDir & d ) const" .br .ti -1c -.BI "virtual bool \fBoperator!=\fR ( const QDir & d ) const" +.BI "virtual bool \fBoperator!=\fR ( const TQDir & d ) const" .br .ti -1c .BI "virtual bool \fBremove\fR ( const TQString & fileName, bool acceptAbsPath = TRUE )" @@ -160,7 +160,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "TQString \fBconvertSeparators\fR ( const TQString & pathName )" .br .ti -1c -.BI "const QFileInfoList * \fBdrives\fR ()" +.BI "const TQFileInfoList * \fBdrives\fR ()" .br .ti -1c .BI "char \fBseparator\fR ()" @@ -169,13 +169,13 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "bool \fBsetCurrent\fR ( const TQString & path )" .br .ti -1c -.BI "QDir \fBcurrent\fR ()" +.BI "TQDir \fBcurrent\fR ()" .br .ti -1c -.BI "QDir \fBhome\fR ()" +.BI "TQDir \fBhome\fR ()" .br .ti -1c -.BI "QDir \fBroot\fR ()" +.BI "TQDir \fBroot\fR ()" .br .ti -1c .BI "TQString \fBcurrentDirPath\fR ()" @@ -200,19 +200,19 @@ All the functions in this class are reentrant when TQt is built with thread supp .br .in -1c .SH DESCRIPTION -The QDir class provides access to directory structures and their contents in a platform-independent way. +The TQDir class provides access to directory structures and their contents in a platform-independent way. .PP -A QDir is used to manipulate path names, access information regarding paths and files, and manipulate the underlying file system. +A TQDir is used to manipulate path names, access information regarding paths and files, and manipulate the underlying file system. .PP -A QDir can point to a file using either a relative or an absolute path. Absolute paths begin with the directory separator "/" (optionally preceded by a drive specification under Windows). If you always use "/" as a directory separator, TQt will translate your paths to conform to the underlying operating system. Relative file names begin with a directory name or a file name and specify a path relative to the current directory. +A TQDir can point to a file using either a relative or an absolute path. Absolute paths begin with the directory separator "/" (optionally preceded by a drive specification under Windows). If you always use "/" as a directory separator, TQt will translate your paths to conform to the underlying operating system. Relative file names begin with a directory name or a file name and specify a path relative to the current directory. .PP -The "current" path refers to the application's working directory. A QDir's own path is set and retrieved with setPath() and path(). +The "current" path refers to the application's working directory. A TQDir's own path is set and retrieved with setPath() and path(). .PP -An example of an absolute path is the string "/tmp/quartz", a relative path might look like "src/fatlib". You can use the function isRelative() to check if a QDir is using a relative or an absolute file path. Call convertToAbs() to convert a relative QDir to an absolute one. For a simplified path use cleanDirPath(). To obtain a path which has no symbolic links or redundant ".." elements use canonicalPath(). The path can be set with setPath(), and changed with cd() and cdUp(). +An example of an absolute path is the string "/tmp/quartz", a relative path might look like "src/fatlib". You can use the function isRelative() to check if a TQDir is using a relative or an absolute file path. Call convertToAbs() to convert a relative TQDir to an absolute one. For a simplified path use cleanDirPath(). To obtain a path which has no symbolic links or redundant ".." elements use canonicalPath(). The path can be set with setPath(), and changed with cd() and cdUp(). .PP -QDir provides several static functions, for example, setCurrent() to set the application's working directory and currentDirPath() to retrieve the application's working directory. Access to some common paths is provided with the static functions, current(), home() and root() which return QDir objects or currentDirPath(), homeDirPath() and rootDirPath() which return the path as a string. If you want to know about your application's path use QApplication::applicationDirPath(). +TQDir provides several static functions, for example, setCurrent() to set the application's working directory and currentDirPath() to retrieve the application's working directory. Access to some common paths is provided with the static functions, current(), home() and root() which return TQDir objects or currentDirPath(), homeDirPath() and rootDirPath() which return the path as a string. If you want to know about your application's path use QApplication::applicationDirPath(). .PP -The number of entries in a directory is returned by count(). Obtain a string list of the names of all the files and directories in a directory with entryList(). If you prefer a list of QFileInfo pointers use entryInfoList(). Both these functions can apply a name filter, an attributes filter (e.g. read-only, files not directories, etc.), and a sort order. The filters and sort may be set with calls to setNameFilter(), setFilter() and setSorting(). They may also be specified in the entryList() and entryInfoList()'s arguments. +The number of entries in a directory is returned by count(). Obtain a string list of the names of all the files and directories in a directory with entryList(). If you prefer a list of TQFileInfo pointers use entryInfoList(). Both these functions can apply a name filter, an attributes filter (e.g. read-only, files not directories, etc.), and a sort order. The filters and sort may be set with calls to setNameFilter(), setFilter() and setSorting(). They may also be specified in the entryList() and entryInfoList()'s arguments. .PP Create a new directory with mkdir(), rename a directory with rename() and remove an existing directory with rmdir(). Remove a file with remove(). You can interrogate a directory with exists(), isReadable() and isRoot(). .PP @@ -229,7 +229,7 @@ See if a directory exists. .PP .nf .br - QDir d( "example" ); // "./example" + TQDir d( "example" ); // "./example" .br if ( !d.exists() ) .br @@ -241,7 +241,7 @@ Traversing directories and reading a file. .PP .nf .br - QDir d = QDir::root(); // "/" + TQDir d = TQDir::root(); // "/" .br if ( !d.cd("tmp") ) { // "/tmp" .br @@ -249,7 +249,7 @@ Traversing directories and reading a file. .br } else { .br - QFile f( d.filePath("ex1.txt") ); // "/tmp/ex1.txt" + TQFile f( d.filePath("ex1.txt") ); // "/tmp/ex1.txt" .br if ( !f.open(IO_ReadWrite) ) .br @@ -265,25 +265,25 @@ A program that lists all the files in the current directory (excluding symbolic .br #include <stdio.h> .br - #include <ntqdir.h> + #include <tqdir.h> .br .br int main( int argc, char **argv ) .br { .br - QDir d; + TQDir d; .br - d.setFilter( QDir::Files | QDir::Hidden | QDir::NoSymLinks ); + d.setFilter( TQDir::Files | TQDir::Hidden | TQDir::NoSymLinks ); .br - d.setSorting( QDir::Size | QDir::Reversed ); + d.setSorting( TQDir::Size | TQDir::Reversed ); .br .br - const QFileInfoList *list = d.entryInfoList(); + const TQFileInfoList *list = d.entryInfoList(); .br - QFileInfoListIterator it( *list ); + TQFileInfoListIterator it( *list ); .br - QFileInfo *fi; + TQFileInfo *fi; .br .br printf( " Bytes Filename\\n" ); @@ -304,77 +304,77 @@ A program that lists all the files in the current directory (excluding symbolic .PP See also QApplication::applicationDirPath() and Input/Output and Networking. .SS "Member Type Documentation" -.SH "QDir::FilterSpec" -This enum describes the filtering options available to QDir, e.g. for entryList() and entryInfoList(). The filter value is specified by OR-ing together values from the following list: +.SH "TQDir::FilterSpec" +This enum describes the filtering options available to TQDir, e.g. for entryList() and entryInfoList(). The filter value is specified by OR-ing together values from the following list: .TP -\fCQDir::Dirs\fR - List directories only. +\fCTQDir::Dirs\fR - List directories only. .TP -\fCQDir::Files\fR - List files only. +\fCTQDir::Files\fR - List files only. .TP -\fCQDir::Drives\fR - List disk drives (ignored under Unix). +\fCTQDir::Drives\fR - List disk drives (ignored under Unix). .TP -\fCQDir::NoSymLinks\fR - Do not list symbolic links (ignored by operating systems that don't support symbolic links). +\fCTQDir::NoSymLinks\fR - Do not list symbolic links (ignored by operating systems that don't support symbolic links). .TP -\fCQDir::All\fR - List directories, files, drives and symlinks (this does not list broken symlinks unless you specify System). +\fCTQDir::All\fR - List directories, files, drives and symlinks (this does not list broken symlinks unless you specify System). .TP -\fCQDir::TypeMask\fR - A mask for the the Dirs, Files, Drives and NoSymLinks flags. +\fCTQDir::TypeMask\fR - A mask for the the Dirs, Files, Drives and NoSymLinks flags. .TP -\fCQDir::Readable\fR - List files for which the application has read access. +\fCTQDir::Readable\fR - List files for which the application has read access. .TP -\fCQDir::Writable\fR - List files for which the application has write access. +\fCTQDir::Writable\fR - List files for which the application has write access. .TP -\fCQDir::Executable\fR - List files for which the application has execute access. Executables needs to be combined with Dirs or Files. +\fCTQDir::Executable\fR - List files for which the application has execute access. Executables needs to be combined with Dirs or Files. .TP -\fCQDir::RWEMask\fR - A mask for the Readable, Writable and Executable flags. +\fCTQDir::RWEMask\fR - A mask for the Readable, Writable and Executable flags. .TP -\fCQDir::Modified\fR - Only list files that have been modified (ignored under Unix). +\fCTQDir::Modified\fR - Only list files that have been modified (ignored under Unix). .TP -\fCQDir::Hidden\fR - List hidden files (on Unix, files starting with a .). +\fCTQDir::Hidden\fR - List hidden files (on Unix, files starting with a .). .TP -\fCQDir::System\fR - List system files (on Unix, FIFOs, sockets and device files) +\fCTQDir::System\fR - List system files (on Unix, FIFOs, sockets and device files) .TP -\fCQDir::AccessMask\fR - A mask for the Readable, Writable, Executable Modified, Hidden and System flags +\fCTQDir::AccessMask\fR - A mask for the Readable, Writable, Executable Modified, Hidden and System flags .TP -\fCQDir::DefaultFilter\fR - Internal flag. +\fCTQDir::DefaultFilter\fR - Internal flag. .PP -If you do not set any of Readable, Writable or Executable, QDir will set all three of them. This makes the default easy to write and at the same time useful. +If you do not set any of Readable, Writable or Executable, TQDir will set all three of them. This makes the default easy to write and at the same time useful. .PP Examples: .)l \fCReadable|Writable\fR means list all files for which the application has read access, write access or both. \fCDirs|Drives\fR means list drives, directories, all files that the application can read, write or execute, and also symlinks to such files/directories. -.SH "QDir::SortSpec" -This enum describes the sort options available to QDir, e.g. for entryList() and entryInfoList(). The sort value is specified by OR-ing together values from the following list: +.SH "TQDir::SortSpec" +This enum describes the sort options available to TQDir, e.g. for entryList() and entryInfoList(). The sort value is specified by OR-ing together values from the following list: .TP -\fCQDir::Name\fR - Sort by name. +\fCTQDir::Name\fR - Sort by name. .TP -\fCQDir::Time\fR - Sort by time (modification time). +\fCTQDir::Time\fR - Sort by time (modification time). .TP -\fCQDir::Size\fR - Sort by file size. +\fCTQDir::Size\fR - Sort by file size. .TP -\fCQDir::Unsorted\fR - Do not sort. +\fCTQDir::Unsorted\fR - Do not sort. .TP -\fCQDir::SortByMask\fR - A mask for Name, Time and Size. +\fCTQDir::SortByMask\fR - A mask for Name, Time and Size. .TP -\fCQDir::DirsFirst\fR - Put the directories first, then the files. +\fCTQDir::DirsFirst\fR - Put the directories first, then the files. .TP -\fCQDir::Reversed\fR - Reverse the sort order. +\fCTQDir::Reversed\fR - Reverse the sort order. .TP -\fCQDir::IgnoreCase\fR - Sort case-insensitively. +\fCTQDir::IgnoreCase\fR - Sort case-insensitively. .TP -\fCQDir::LocaleAware\fR - Sort names using locale aware compares +\fCTQDir::LocaleAware\fR - Sort names using locale aware compares .TP -\fCQDir::DefaultSort\fR - Internal flag. +\fCTQDir::DefaultSort\fR - Internal flag. .PP You can only specify one of the first four. .PP If you specify both DirsFirst and Reversed, directories are still put first, but in reverse order; the files will be listed after the directories, again in reverse order. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QDir::QDir ()" -Constructs a QDir pointing to the current directory ("."). +.SH "TQDir::TQDir ()" +Constructs a TQDir pointing to the current directory ("."). .PP See also currentDirPath(). -.SH "QDir::QDir ( const TQString & path, const TQString & nameFilter = TQString::null, int sortSpec = Name | IgnoreCase, int filterSpec = All )" -Constructs a QDir with path \fIpath\fR, that filters its entries by name using \fInameFilter\fR and by attributes using \fIfilterSpec\fR. It also sorts the names using \fIsortSpec\fR. +.SH "TQDir::TQDir ( const TQString & path, const TQString & nameFilter = TQString::null, int sortSpec = Name | IgnoreCase, int filterSpec = All )" +Constructs a TQDir with path \fIpath\fR, that filters its entries by name using \fInameFilter\fR and by attributes using \fIfilterSpec\fR. It also sorts the names using \fIsortSpec\fR. .PP The default \fInameFilter\fR is an empty string, which excludes nothing; the default \fIfilterSpec\fR is All, which also means exclude nothing. The default \fIsortSpec\fR is \fCName|IgnoreCase\fR, i.e. sort by name case-insensitively. .PP @@ -382,7 +382,7 @@ Example that lists all the files in "/tmp": .PP .nf .br - QDir d( "/tmp" ); + TQDir d( "/tmp" ); .br for ( int i = 0; i < d.count(); i++ ) .br @@ -390,37 +390,37 @@ Example that lists all the files in "/tmp": .br .fi .PP -If \fIpath\fR is "" or TQString::null, QDir uses "." (the current directory). If \fInameFilter\fR is "" or TQString::null, QDir uses the name filter "*" (all files). +If \fIpath\fR is "" or TQString::null, TQDir uses "." (the current directory). If \fInameFilter\fR is "" or TQString::null, TQDir uses the name filter "*" (all files). .PP Note that \fIpath\fR need not exist. .PP See also exists(), setPath(), setNameFilter(), setFilter(), and setSorting(). -.SH "QDir::QDir ( const QDir & d )" -Constructs a QDir that is a copy of the directory \fId\fR. +.SH "TQDir::TQDir ( const TQDir & d )" +Constructs a TQDir that is a copy of the directory \fId\fR. .PP See also operator=(). -.SH "QDir::~QDir ()\fC [virtual]\fR" -Destroys the QDir frees up its resources. -.SH "TQString QDir::absFilePath ( const TQString & fileName, bool acceptAbsPath = TRUE ) const\fC [virtual]\fR" +.SH "TQDir::~TQDir ()\fC [virtual]\fR" +Destroys the TQDir frees up its resources. +.SH "TQString TQDir::absFilePath ( const TQString & fileName, bool acceptAbsPath = TRUE ) const\fC [virtual]\fR" Returns the absolute path name of a file in the directory. Does \fInot\fR check if the file actually exists in the directory. Redundant multiple separators or "." and ".." directories in \fIfileName\fR will not be removed (see cleanDirPath()). .PP If \fIacceptAbsPath\fR is TRUE a \fIfileName\fR starting with a separator "/" will be returned without change. If \fIacceptAbsPath\fR is FALSE an absolute path will be prepended to the fileName and the resultant string returned. .PP See also filePath(). -.SH "TQString QDir::absPath () const\fC [virtual]\fR" +.SH "TQString TQDir::absPath () const\fC [virtual]\fR" Returns the absolute path (a path that starts with "/" or with a drive specification), which may contain symbolic links, but never contains redundant ".", ".." or multiple separators. .PP See also setPath(), canonicalPath(), exists(), cleanDirPath(), dirName(), and absFilePath(). .PP -Example: fileiconview/qfileiconview.cpp. -.SH "TQString QDir::canonicalPath () const\fC [virtual]\fR" +Example: fileiconview/tqfileiconview.cpp. +.SH "TQString TQDir::canonicalPath () const\fC [virtual]\fR" Returns the canonical path, i.e. a path without symbolic links or redundant "." or ".." elements. .PP On systems that do not have symbolic links this function will always return the same string that absPath() returns. If the canonical path does not exist (normally due to dangling symbolic links) canonicalPath() returns TQString::null. .PP See also path(), absPath(), exists(), cleanDirPath(), dirName(), absFilePath(), and TQString::isNull(). -.SH "bool QDir::cd ( const TQString & dirName, bool acceptAbsPath = TRUE )\fC [virtual]\fR" -Changes the QDir's directory to \fIdirName\fR. +.SH "bool TQDir::cd ( const TQString & dirName, bool acceptAbsPath = TRUE )\fC [virtual]\fR" +Changes the TQDir's directory to \fIdirName\fR. .PP If \fIacceptAbsPath\fR is TRUE a path starting with separator "/" will cause the function to change to the absolute directory. If \fIacceptAbsPath\fR is FALSE any number of separators at the beginning of \fIdirName\fR will be removed and the function will descend into \fIdirName\fR. .PP @@ -431,20 +431,20 @@ Calling cd( ".." ) is equivalent to calling cdUp(). See also cdUp(), isReadable(), exists(), and path(). .PP Example: fileiconview/mainwindow.cpp. -.SH "bool QDir::cdUp ()\fC [virtual]\fR" -Changes directory by moving one directory up from the QDir's current directory. +.SH "bool TQDir::cdUp ()\fC [virtual]\fR" +Changes directory by moving one directory up from the TQDir's current directory. .PP Returns TRUE if the new directory exists and is readable; otherwise returns FALSE. Note that the logical cdUp() operation is not performed if the new directory does not exist. .PP See also cd(), isReadable(), exists(), and path(). -.SH "TQString QDir::cleanDirPath ( const TQString & filePath )\fC [static]\fR" +.SH "TQString TQDir::cleanDirPath ( const TQString & filePath )\fC [static]\fR" Removes all multiple directory separators "/" and resolves any" ."s or ".."s found in the path, \fIfilePath\fR. .PP Symbolic links are kept. This function does not return the canonical path, but rather the simplest version of the input. For example, "./local" becomes "local", "local/../bin" becomes" bin" and "/local/usr/../bin" becomes "/local/bin". .PP See also absPath() and canonicalPath(). -.SH "TQString QDir::convertSeparators ( const TQString & pathName )\fC [static]\fR" +.SH "TQString TQDir::convertSeparators ( const TQString & pathName )\fC [static]\fR" Returns \fIpathName\fR with the '/' separators converted to separators that are appropriate for the underlying operating system. .PP On Windows, convertSeparators("c:/winnt/system32") returns" c:\\winnt\\system32". @@ -452,86 +452,86 @@ On Windows, convertSeparators("c:/winnt/system32") returns" c:\\winnt\\system32" The returned string may be the same as the argument on some operating systems, for example on Unix. .PP Examples: -.)l dirview/dirview.cpp and fileiconview/qfileiconview.cpp. -.SH "void QDir::convertToAbs ()\fC [virtual]\fR" +.)l dirview/dirview.cpp and fileiconview/tqfileiconview.cpp. +.SH "void TQDir::convertToAbs ()\fC [virtual]\fR" Converts the directory path to an absolute path. If it is already absolute nothing is done. .PP See also isRelative(). -.SH "uint QDir::count () const" +.SH "uint TQDir::count () const" Returns the total number of directories and files that were found. .PP Equivalent to entryList().count(). .PP See also operator[]() and entryList(). -.SH "QDir QDir::current ()\fC [static]\fR" +.SH "TQDir TQDir::current ()\fC [static]\fR" Returns the application's current directory. .PP -Use path() to access a QDir object's path. +Use path() to access a TQDir object's path. .PP -See also currentDirPath() and QDir::QDir(). -.SH "TQString QDir::currentDirPath ()\fC [static]\fR" +See also currentDirPath() and TQDir::TQDir(). +.SH "TQString TQDir::currentDirPath ()\fC [static]\fR" Returns the absolute path of the application's current directory. .PP See also current(). .PP Examples: -.)l dirview/dirview.cpp, helpviewer/helpwindow.cpp, and qdir/qdir.cpp. -.SH "TQString QDir::dirName () const\fC [virtual]\fR" +.)l dirview/dirview.cpp, helpviewer/helpwindow.cpp, and tqdir/tqdir.cpp. +.SH "TQString TQDir::dirName () const\fC [virtual]\fR" Returns the name of the directory; this is \fInot\fR the same as the path, e.g. a directory with the name "mail", might have the path" /var/spool/mail". If the directory has no name (e.g. it is the root directory) TQString::null is returned. .PP No check is made to ensure that a directory with this name actually exists. .PP See also path(), absPath(), absFilePath(), exists(), and TQString::isNull(). -.SH "const QFileInfoList * QDir::drives ()\fC [static]\fR" -Returns a list of the root directories on this system. On Windows this returns a number of QFileInfo objects containing "C:/", "D:/" etc. On other operating systems, it returns a list containing just one root directory (e.g. "/"). +.SH "const TQFileInfoList * TQDir::drives ()\fC [static]\fR" +Returns a list of the root directories on this system. On Windows this returns a number of TQFileInfo objects containing "C:/", "D:/" etc. On other operating systems, it returns a list containing just one root directory (e.g. "/"). .PP The returned pointer is owned by Qt. Callers should \fInot\fR delete or modify it. .PP Example: dirview/main.cpp. -.SH "TQStrList QDir::encodedEntryList ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" +.SH "TQStrList TQDir::encodedEntryList ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. .PP -This function is included to easy porting from TQt 1.x to TQt 2.0, it is the same as entryList(), but encodes the filenames as 8-bit strings using QFile::encodedName(). +This function is included to easy porting from TQt 1.x to TQt 2.0, it is the same as entryList(), but encodes the filenames as 8-bit strings using TQFile::encodedName(). .PP It is more efficient to use entryList(). -.SH "TQStrList QDir::encodedEntryList ( const TQString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" +.SH "TQStrList TQDir::encodedEntryList ( const TQString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. .PP This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -This function is included to easy porting from TQt 1.x to TQt 2.0, it is the same as entryList(), but encodes the filenames as 8-bit strings using QFile::encodedName(). +This function is included to easy porting from TQt 1.x to TQt 2.0, it is the same as entryList(), but encodes the filenames as 8-bit strings using TQFile::encodedName(). .PP It is more efficient to use entryList(). -.SH "const QFileInfoList * QDir::entryInfoList ( const TQString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" -Returns a list of QFileInfo objects for all the files and directories in the directory, ordered in accordance with setSorting() and filtered in accordance with setFilter() and setNameFilter(). +.SH "const TQFileInfoList * TQDir::entryInfoList ( const TQString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" +Returns a list of TQFileInfo objects for all the files and directories in the directory, ordered in accordance with setSorting() and filtered in accordance with setFilter() and setNameFilter(). .PP The filter and sorting specifications can be overridden using the \fInameFilter\fR, \fIfilterSpec\fR and \fIsortSpec\fR arguments. .PP Returns 0 if the directory is unreadable or does not exist. .PP -The returned pointer is a const pointer to a QFileInfoList. The list is owned by the QDir object and will be reused on the next call to entryInfoList() for the same QDir instance. If you want to keep the entries of the list after a subsequent call to this function you must copy them. +The returned pointer is a const pointer to a TQFileInfoList. The list is owned by the TQDir object and will be reused on the next call to entryInfoList() for the same TQDir instance. If you want to keep the entries of the list after a subsequent call to this function you must copy them. .PP -Note: QFileInfoList is really a TQPtrList<QFileInfo>. +Note: TQFileInfoList is really a TQPtrList<TQFileInfo>. .PP See also entryList(), setNameFilter(), setSorting(), and setFilter(). .PP Examples: -.)l dirview/dirview.cpp and fileiconview/qfileiconview.cpp. -.SH "const QFileInfoList * QDir::entryInfoList ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" +.)l dirview/dirview.cpp and fileiconview/tqfileiconview.cpp. +.SH "const TQFileInfoList * TQDir::entryInfoList ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Returns a list of QFileInfo objects for all the files and directories in the directory, ordered in accordance with setSorting() and filtered in accordance with setFilter() and setNameFilter(). +Returns a list of TQFileInfo objects for all the files and directories in the directory, ordered in accordance with setSorting() and filtered in accordance with setFilter() and setNameFilter(). .PP The filter and sorting specifications can be overridden using the \fIfilterSpec\fR and \fIsortSpec\fR arguments. .PP Returns 0 if the directory is unreadable or does not exist. .PP -The returned pointer is a const pointer to a QFileInfoList. The list is owned by the QDir object and will be reused on the next call to entryInfoList() for the same QDir instance. If you want to keep the entries of the list after a subsequent call to this function you must copy them. +The returned pointer is a const pointer to a TQFileInfoList. The list is owned by the TQDir object and will be reused on the next call to entryInfoList() for the same TQDir instance. If you want to keep the entries of the list after a subsequent call to this function you must copy them. .PP -Note: QFileInfoList is really a TQPtrList<QFileInfo>. +Note: TQFileInfoList is really a TQPtrList<TQFileInfo>. .PP See also entryList(), setNameFilter(), setSorting(), and setFilter(). -.SH "TQStringList QDir::entryList ( const TQString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" +.SH "TQStringList TQDir::entryList ( const TQString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" Returns a list of the names of all the files and directories in the directory, ordered in accordance with setSorting() and filtered in accordance with setFilter() and setNameFilter(). .PP The filter and sorting specifications can be overridden using the \fInameFilter\fR, \fIfilterSpec\fR and \fIsortSpec\fR arguments. @@ -541,7 +541,7 @@ Returns an empty list if the directory is unreadable or does not exist. See also entryInfoList(), setNameFilter(), setSorting(), and setFilter(). .PP Example: table/statistics/statistics.cpp. -.SH "TQStringList QDir::entryList ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" +.SH "TQStringList TQDir::entryList ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns a list of the names of all the files and directories in the directory, ordered in accordance with setSorting() and filtered in accordance with setFilter() and setNameFilter(). @@ -551,29 +551,29 @@ The filter and sorting specifications can be overridden using the \fIfilterSpec\ Returns an empty list if the directory is unreadable or does not exist. .PP See also entryInfoList(), setNameFilter(), setSorting(), and setFilter(). -.SH "bool QDir::exists ( const TQString & name, bool acceptAbsPath = TRUE )\fC [virtual]\fR" +.SH "bool TQDir::exists ( const TQString & name, bool acceptAbsPath = TRUE )\fC [virtual]\fR" Checks for the existence of the file \fIname\fR. .PP If \fIacceptAbsPath\fR is TRUE a path starting with separator "/" will check the file with the absolute path. If \fIacceptAbsPath\fR is FALSE any number of separators at the beginning of \fIname\fR will be removed and the resultant file name will be checked. .PP Returns TRUE if the file exists; otherwise returns FALSE. .PP -See also QFileInfo::exists() and QFile::exists(). -.SH "bool QDir::exists () const\fC [virtual]\fR" +See also TQFileInfo::exists() and TQFile::exists(). +.SH "bool TQDir::exists () const\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns TRUE if the \fIdirectory\fR exists; otherwise returns FALSE. (If a file with the same name is found this function will return FALSE). .PP -See also QFileInfo::exists() and QFile::exists(). -.SH "TQString QDir::filePath ( const TQString & fileName, bool acceptAbsPath = TRUE ) const\fC [virtual]\fR" -Returns the path name of a file in the directory. Does \fInot\fR check if the file actually exists in the directory. If the QDir is relative the returned path name will also be relative. Redundant multiple separators or "." and ".." directories in \fIfileName\fR will not be removed (see cleanDirPath()). +See also TQFileInfo::exists() and TQFile::exists(). +.SH "TQString TQDir::filePath ( const TQString & fileName, bool acceptAbsPath = TRUE ) const\fC [virtual]\fR" +Returns the path name of a file in the directory. Does \fInot\fR check if the file actually exists in the directory. If the TQDir is relative the returned path name will also be relative. Redundant multiple separators or "." and ".." directories in \fIfileName\fR will not be removed (see cleanDirPath()). .PP If \fIacceptAbsPath\fR is TRUE a \fIfileName\fR starting with a separator "/" will be returned without change. If \fIacceptAbsPath\fR is FALSE an absolute path will be prepended to the fileName and the resultant string returned. .PP See also absFilePath(), isRelative(), and canonicalPath(). -.SH "FilterSpec QDir::filter () const" +.SH "FilterSpec TQDir::filter () const" Returns the value set by setFilter() -.SH "QDir QDir::home ()\fC [static]\fR" +.SH "TQDir TQDir::home ()\fC [static]\fR" Returns the home directory. .PP Under Windows the \fCHOME\fR environment variable is used. If this does not exist the \fCUSERPROFILE\fR environment variable is used. If that does not exist the path is formed by concatenating the \fCHOMEDRIVE\fR and \fCHOMEPATH\fR environment variables. If they don't exist the rootDirPath() is used (this uses the \fCSystemDrive\fR environment variable). If none of these exist "C:\" is used. @@ -581,35 +581,35 @@ Under Windows the \fCHOME\fR environment variable is used. If this does not exis Under non-Windows operating systems the \fCHOME\fR environment variable is used if it exists, otherwise rootDirPath() is used. .PP See also homeDirPath(). -.SH "TQString QDir::homeDirPath ()\fC [static]\fR" +.SH "TQString TQDir::homeDirPath ()\fC [static]\fR" Returns the absolute path of the user's home directory. .PP See also home(). -.SH "bool QDir::isReadable () const\fC [virtual]\fR" +.SH "bool TQDir::isReadable () const\fC [virtual]\fR" Returns TRUE if the directory is readable \fIand\fR we can open files by name; otherwise returns FALSE. .PP \fBWarning:\fR A FALSE value from this function is not a guarantee that files in the directory are not accessible. .PP -See also QFileInfo::isReadable(). +See also TQFileInfo::isReadable(). .PP Examples: -.)l dirview/dirview.cpp and fileiconview/qfileiconview.cpp. -.SH "bool QDir::isRelative () const\fC [virtual]\fR" +.)l dirview/dirview.cpp and fileiconview/tqfileiconview.cpp. +.SH "bool TQDir::isRelative () const\fC [virtual]\fR" Returns TRUE if the directory path is relative to the current directory and returns FALSE if the path is absolute (e.g. under UNIX a path is relative if it does not start with a "/"). .PP See also convertToAbs(). -.SH "bool QDir::isRelativePath ( const TQString & path )\fC [static]\fR" +.SH "bool TQDir::isRelativePath ( const TQString & path )\fC [static]\fR" Returns TRUE if \fIpath\fR is relative; returns FALSE if it is absolute. .PP See also isRelative(). -.SH "bool QDir::isRoot () const\fC [virtual]\fR" +.SH "bool TQDir::isRoot () const\fC [virtual]\fR" Returns TRUE if the directory is the root directory; otherwise returns FALSE. .PP Note: If the directory is a symbolic link to the root directory this function returns FALSE. If you want to test for this use canonicalPath(), e.g. .PP .nf .br - QDir d( "/tmp/root_link" ); + TQDir d( "/tmp/root_link" ); .br d = d.canonicalPath(); .br @@ -620,13 +620,13 @@ Note: If the directory is a symbolic link to the root directory this function re .fi .PP See also root() and rootDirPath(). -.SH "bool QDir::match ( const TQString & filter, const TQString & fileName )\fC [static]\fR" +.SH "bool TQDir::match ( const TQString & filter, const TQString & fileName )\fC [static]\fR" Returns TRUE if the \fIfileName\fR matches the wildcard (glob) pattern \fIfilter\fR; otherwise returns FALSE. The \fIfilter\fR may contain multiple patterns separated by spaces or semicolons. .PP (See TQRegExp wildcard matching.) .PP See also TQRegExp::match(). -.SH "bool QDir::match ( const TQStringList & filters, const TQString & fileName )\fC [static]\fR" +.SH "bool TQDir::match ( const TQStringList & filters, const TQString & fileName )\fC [static]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns TRUE if the \fIfileName\fR matches any of the wildcard (glob) patterns in the list of \fIfilters\fR; otherwise returns FALSE. @@ -634,11 +634,11 @@ Returns TRUE if the \fIfileName\fR matches any of the wildcard (glob) patterns i (See TQRegExp wildcard matching.) .PP See also TQRegExp::match(). -.SH "bool QDir::matchAllDirs () const" +.SH "bool TQDir::matchAllDirs () const" Returns the value set by setMatchAllDirs() .PP See also setMatchAllDirs(). -.SH "bool QDir::mkdir ( const TQString & dirName, bool acceptAbsPath = TRUE ) const\fC [virtual]\fR" +.SH "bool TQDir::mkdir ( const TQString & dirName, bool acceptAbsPath = TRUE ) const\fC [virtual]\fR" Creates a directory. .PP If \fIacceptAbsPath\fR is TRUE a path starting with a separator ('/') will create the absolute directory; if \fIacceptAbsPath\fR is FALSE any number of separators at the beginning of \fIdirName\fR will be removed. @@ -646,9 +646,9 @@ If \fIacceptAbsPath\fR is TRUE a path starting with a separator ('/') will creat Returns TRUE if successful; otherwise returns FALSE. .PP See also rmdir(). -.SH "TQString QDir::nameFilter () const" +.SH "TQString TQDir::nameFilter () const" Returns the string set by setNameFilter() -.SH "bool QDir::operator!= ( const QDir & d ) const\fC [virtual]\fR" +.SH "bool TQDir::operator!= ( const TQDir & d ) const\fC [virtual]\fR" Returns TRUE if directory \fId\fR and this directory have different paths or different sort or filter settings; otherwise returns FALSE. .PP Example: @@ -657,22 +657,22 @@ Example: .br // The current directory is "/usr/local" .br - QDir d1( "/usr/local/bin" ); + TQDir d1( "/usr/local/bin" ); .br - QDir d2( "bin" ); + TQDir d2( "bin" ); .br if ( d1 != d2 ) .br tqDebug( "They differ" ); .br .fi -.SH "QDir & QDir::operator= ( const QDir & d )" -Makes a copy of QDir \fId\fR and assigns it to this QDir. -.SH "QDir & QDir::operator= ( const TQString & path )" +.SH "TQDir & TQDir::operator= ( const TQDir & d )" +Makes a copy of TQDir \fId\fR and assigns it to this TQDir. +.SH "TQDir & TQDir::operator= ( const TQString & path )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Sets the directory path to be the given \fIpath\fR. -.SH "bool QDir::operator== ( const QDir & d ) const\fC [virtual]\fR" +.SH "bool TQDir::operator== ( const TQDir & d ) const\fC [virtual]\fR" Returns TRUE if directory \fId\fR and this directory have the same path and their sort and filter settings are the same; otherwise returns FALSE. .PP Example: @@ -681,9 +681,9 @@ Example: .br // The current directory is "/usr/local" .br - QDir d1( "/usr/local/bin" ); + TQDir d1( "/usr/local/bin" ); .br - QDir d2( "bin" ); + TQDir d2( "bin" ); .br d2.convertToAbs(); .br @@ -692,27 +692,27 @@ Example: tqDebug( "They're the same" ); .br .fi -.SH "TQString QDir::operator[] ( int index ) const" +.SH "TQString TQDir::operator[] ( int index ) const" Returns the file name at position \fIindex\fR in the list of file names. Equivalent to entryList().at(index). .PP Returns a TQString::null if the \fIindex\fR is out of range or if the entryList() function failed. .PP See also count() and entryList(). -.SH "TQString QDir::path () const\fC [virtual]\fR" +.SH "TQString TQDir::path () const\fC [virtual]\fR" Returns the path, this may contain symbolic links, but never contains redundant ".", ".." or multiple separators. .PP The returned path can be either absolute or relative (see setPath()). .PP See also setPath(), absPath(), exists(), cleanDirPath(), dirName(), absFilePath(), and convertSeparators(). -.SH "void QDir::refresh () const" +.SH "void TQDir::refresh () const" Refreshes the directory information. -.SH "bool QDir::remove ( const TQString & fileName, bool acceptAbsPath = TRUE )\fC [virtual]\fR" +.SH "bool TQDir::remove ( const TQString & fileName, bool acceptAbsPath = TRUE )\fC [virtual]\fR" Removes the file, \fIfileName\fR. .PP If \fIacceptAbsPath\fR is TRUE a path starting with separator "/" will remove the file with the absolute path. If \fIacceptAbsPath\fR is FALSE any number of separators at the beginning of \fIfileName\fR will be removed and the resultant file name will be removed. .PP Returns TRUE if the file is removed successfully; otherwise returns FALSE. -.SH "bool QDir::rename ( const TQString & oldName, const TQString & newName, bool acceptAbsPaths = TRUE )\fC [virtual]\fR" +.SH "bool TQDir::rename ( const TQString & oldName, const TQString & newName, bool acceptAbsPaths = TRUE )\fC [virtual]\fR" Renames a file or directory. .PP If \fIacceptAbsPaths\fR is TRUE a path starting with a separator ('/') will rename the file with the absolute path; if \fIacceptAbsPaths\fR is FALSE any number of separators at the beginning of the names will be removed. @@ -721,8 +721,8 @@ Returns TRUE if successful; otherwise returns FALSE. .PP On most file systems, rename() fails only if \fIoldName\fR does not exist or if \fInewName\fR and \fIoldName\fR are not on the same partition. On Windows, rename() will fail if \fInewName\fR already exists. However, there are also other reasons why rename() can fail. For example, on at least one file system rename() fails if \fInewName\fR points to an open file. .PP -Example: fileiconview/qfileiconview.cpp. -.SH "bool QDir::rmdir ( const TQString & dirName, bool acceptAbsPath = TRUE ) const\fC [virtual]\fR" +Example: fileiconview/tqfileiconview.cpp. +.SH "bool TQDir::rmdir ( const TQString & dirName, bool acceptAbsPath = TRUE ) const\fC [virtual]\fR" Removes a directory. .PP If \fIacceptAbsPath\fR is TRUE a path starting with a separator ('/') will remove the absolute directory; if \fIacceptAbsPath\fR is FALSE any number of separators at the beginning of \fIdirName\fR will be removed. @@ -732,31 +732,31 @@ The directory must be empty for rmdir() to succeed. Returns TRUE if successful; otherwise returns FALSE. .PP See also mkdir(). -.SH "QDir QDir::root ()\fC [static]\fR" +.SH "TQDir TQDir::root ()\fC [static]\fR" Returns the root directory. .PP See also rootDirPath() and drives(). -.SH "TQString QDir::rootDirPath ()\fC [static]\fR" +.SH "TQString TQDir::rootDirPath ()\fC [static]\fR" Returns the absolute path for the root directory. .PP For UNIX operating systems this returns "/". For Windows file systems this normally returns "c:/". .PP See also root() and drives(). -.SH "char QDir::separator ()\fC [static]\fR" +.SH "char TQDir::separator ()\fC [static]\fR" Returns the native directory separator; "/" under UNIX (including Mac OS X) and "\" under Windows. .PP You do not need to use this function to build file paths. If you always use "/", TQt will translate your paths to conform to the underlying operating system. -.SH "bool QDir::setCurrent ( const TQString & path )\fC [static]\fR" +.SH "bool TQDir::setCurrent ( const TQString & path )\fC [static]\fR" Sets the application's current working directory to \fIpath\fR. Returns TRUE if the directory was successfully changed; otherwise returns FALSE. -.SH "void QDir::setFilter ( int filterSpec )\fC [virtual]\fR" -Sets the filter used by entryList() and entryInfoList() to \fIfilterSpec\fR. The filter is used to specify the kind of files that should be returned by entryList() and entryInfoList(). See QDir::FilterSpec. +.SH "void TQDir::setFilter ( int filterSpec )\fC [virtual]\fR" +Sets the filter used by entryList() and entryInfoList() to \fIfilterSpec\fR. The filter is used to specify the kind of files that should be returned by entryList() and entryInfoList(). See TQDir::FilterSpec. .PP See also filter() and setNameFilter(). -.SH "void QDir::setMatchAllDirs ( bool enable )\fC [virtual]\fR" +.SH "void TQDir::setMatchAllDirs ( bool enable )\fC [virtual]\fR" If \fIenable\fR is TRUE then all directories are included (e.g. in entryList()), and the nameFilter() is only applied to the files. If \fIenable\fR is FALSE then the nameFilter() is applied to both directories and files. .PP See also matchAllDirs(). -.SH "void QDir::setNameFilter ( const TQString & nameFilter )\fC [virtual]\fR" +.SH "void TQDir::setNameFilter ( const TQString & nameFilter )\fC [virtual]\fR" Sets the name filter used by entryList() and entryInfoList() to \fInameFilter\fR. .PP The \fInameFilter\fR is a wildcard (globbing) filter that understands" *" and "?" wildcards. (See TQRegExp wildcard matching.) You may specify several filter entries all separated by a single space " " or by a semi-colon" ;". @@ -764,25 +764,25 @@ The \fInameFilter\fR is a wildcard (globbing) filter that understands" *" and "? For example, if you want entryList() and entryInfoList() to list all files ending with either ".cpp" or ".h", you would use either dir.setNameFilter("*.cpp *.h") or dir.setNameFilter("*.cpp;*.h"). .PP See also nameFilter() and setFilter(). -.SH "void QDir::setPath ( const TQString & path )\fC [virtual]\fR" +.SH "void TQDir::setPath ( const TQString & path )\fC [virtual]\fR" Sets the path of the directory to \fIpath\fR. The path is cleaned of redundant ".", ".." and of multiple separators. No check is made to ensure that a directory with this path exists. .PP The path can be either absolute or relative. Absolute paths begin with the directory separator "/" (optionally preceded by a drive specification under Windows). Relative file names begin with a directory name or a file name and specify a path relative to the current directory. An example of an absolute path is the string" /tmp/quartz", a relative path might look like "src/fatlib". .PP See also path(), absPath(), exists(), cleanDirPath(), dirName(), absFilePath(), isRelative(), and convertToAbs(). -.SH "void QDir::setSorting ( int sortSpec )\fC [virtual]\fR" +.SH "void TQDir::setSorting ( int sortSpec )\fC [virtual]\fR" Sets the sort order used by entryList() and entryInfoList(). .PP -The \fIsortSpec\fR is specified by OR-ing values from the enum QDir::SortSpec. +The \fIsortSpec\fR is specified by OR-ing values from the enum TQDir::SortSpec. .PP See also sorting() and SortSpec. -.SH "SortSpec QDir::sorting () const" +.SH "SortSpec TQDir::sorting () const" Returns the value set by setSorting() .PP See also setSorting() and SortSpec. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqdir.html +.BR http://doc.trolltech.com/tqdir.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqdns.3qt b/doc/man/man3/tqdns.3qt index c205f7612..01b59bc7a 100644 --- a/doc/man/man3/tqdns.3qt +++ b/doc/man/man3/tqdns.3qt @@ -1,5 +1,5 @@ '\" t -.TH QDns 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQDns 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QDns \- Asynchronous DNS lookups +TQDns \- Asynchronous DNS lookups .SH SYNOPSIS -\fC#include <ntqdns.h>\fR +\fC#include <tqdns.h>\fR .PP Inherits TQObject. .PP @@ -19,22 +19,22 @@ Inherits TQObject. .BI "enum \fBRecordType\fR { None, A, Aaaa, Mx, Srv, Cname, Ptr, Txt }" .br .ti -1c -.BI "\fBQDns\fR ()" +.BI "\fBTQDns\fR ()" .br .ti -1c -.BI "\fBQDns\fR ( const TQString & label, RecordType rr = A )" +.BI "\fBTQDns\fR ( const TQString & label, RecordType rr = A )" .br .ti -1c -.BI "\fBQDns\fR ( const QHostAddress & address, RecordType rr = Ptr )" +.BI "\fBTQDns\fR ( const TQHostAddress & address, RecordType rr = Ptr )" .br .ti -1c -.BI "virtual \fB~QDns\fR ()" +.BI "virtual \fB~TQDns\fR ()" .br .ti -1c .BI "virtual void \fBsetLabel\fR ( const TQString & label )" .br .ti -1c -.BI "virtual void \fBsetLabel\fR ( const QHostAddress & address )" +.BI "virtual void \fBsetLabel\fR ( const TQHostAddress & address )" .br .ti -1c .BI "TQString \fBlabel\fR () const" @@ -49,7 +49,7 @@ Inherits TQObject. .BI "bool \fBisWorking\fR () const" .br .ti -1c -.BI "TQValueList<QHostAddress> \fBaddresses\fR () const" +.BI "TQValueList<TQHostAddress> \fBaddresses\fR () const" .br .ti -1c .BI "TQValueList<MailServer> \fBmailServers\fR () const" @@ -77,59 +77,59 @@ Inherits TQObject. .br .in -1c .SH DESCRIPTION -The QDns class provides asynchronous DNS lookups. +The TQDns class provides asynchronous DNS lookups. .PP Both Windows and Unix provide synchronous DNS lookups; Windows provides some asynchronous support too. At the time of writing neither operating system provides asynchronous support for anything other than hostname-to-address mapping. .PP -QDns rectifies this shortcoming, by providing asynchronous caching lookups for the record types that we expect modern GUI applications to need in the near future. +TQDns rectifies this shortcoming, by providing asynchronous caching lookups for the record types that we expect modern GUI applications to need in the near future. .PP -The class is \fInot\fR straightforward to use (although it is much simpler than the native APIs); QSocket provides much easier to use TCP connection facilities. The aim of QDns is to provide a correct and small API to the DNS and nothing more. (We use "correctness" to mean that the DNS information is correctly cached, and correctly timed out.) +The class is \fInot\fR straightforward to use (although it is much simpler than the native APIs); TQSocket provides much easier to use TCP connection facilities. The aim of TQDns is to provide a correct and small API to the DNS and nothing more. (We use "correctness" to mean that the DNS information is correctly cached, and correctly timed out.) .PP -The API comprises a constructor, functions to set the DNS node (the domain in DNS terminology) and record type (setLabel() and setRecordType()), the corresponding get functions, an isWorking() function to determine whether QDns is working or reading, a resultsReady() signal and query functions for the result. +The API comprises a constructor, functions to set the DNS node (the domain in DNS terminology) and record type (setLabel() and setRecordType()), the corresponding get functions, an isWorking() function to determine whether TQDns is working or reading, a resultsReady() signal and query functions for the result. .PP There is one query function for each RecordType, namely addresses(), mailServers(), servers(), hostNames() and texts(). There are also two generic query functions: canonicalName() returns the name you'll presumably end up using (the exact meaning of this depends on the record type) and qualifiedNames() returns a list of the fully qualified names label() maps to. .PP -See also QSocket and Input/Output and Networking. +See also TQSocket and Input/Output and Networking. .SS "Member Type Documentation" -.SH "QDns::RecordType" -This enum type defines the record types QDns can handle. The DNS provides many more; these are the ones we've judged to be in current use, useful for GUI programs and important enough to support right away: +.SH "TQDns::RecordType" +This enum type defines the record types TQDns can handle. The DNS provides many more; these are the ones we've judged to be in current use, useful for GUI programs and important enough to support right away: .TP -\fCQDns::None\fR - No information. This exists only so that QDns can have a default. +\fCTQDns::None\fR - No information. This exists only so that TQDns can have a default. .TP -\fCQDns::A\fR - IPv4 addresses. By far the most common type. +\fCTQDns::A\fR - IPv4 addresses. By far the most common type. .TP -\fCQDns::Aaaa\fR - IPv6 addresses. So far mostly unused. +\fCTQDns::Aaaa\fR - IPv6 addresses. So far mostly unused. .TP -\fCQDns::Mx\fR - Mail eXchanger names. Used for mail delivery. +\fCTQDns::Mx\fR - Mail eXchanger names. Used for mail delivery. .TP -\fCQDns::Srv\fR - SeRVer names. Generic record type for finding servers. So far mostly unused. +\fCTQDns::Srv\fR - SeRVer names. Generic record type for finding servers. So far mostly unused. .TP -\fCQDns::Cname\fR - Canonical names. Maps from nicknames to the true name (the canonical name) for a host. +\fCTQDns::Cname\fR - Canonical names. Maps from nicknames to the true name (the canonical name) for a host. .TP -\fCQDns::Ptr\fR - name PoinTeRs. Maps from IPv4 or IPv6 addresses to hostnames. +\fCTQDns::Ptr\fR - name PoinTeRs. Maps from IPv4 or IPv6 addresses to hostnames. .TP -\fCQDns::Txt\fR - arbitrary TeXT for domains. +\fCTQDns::Txt\fR - arbitrary TeXT for domains. .PP We expect that some support for the RFC-2535 extensions will be added in future versions. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QDns::QDns ()" +.SH "TQDns::TQDns ()" Constructs a DNS query object with invalid settings for both the label and the search type. -.SH "QDns::QDns ( const TQString & label, RecordType rr = A )" +.SH "TQDns::TQDns ( const TQString & label, RecordType rr = A )" Constructs a DNS query object that will return record type \fIrr\fR information about \fIlabel\fR. .PP The DNS lookup is started the next time the application enters the event loop. When the result is found the signal resultsReady() is emitted. .PP \fIrr\fR defaults to A, IPv4 addresses. -.SH "QDns::QDns ( const QHostAddress & address, RecordType rr = Ptr )" +.SH "TQDns::TQDns ( const TQHostAddress & address, RecordType rr = Ptr )" Constructs a DNS query object that will return record type \fIrr\fR information about host address \fIaddress\fR. The label is set to the IN-ADDR.ARPA domain name. This is useful in combination with the Ptr record type (e.g. if you want to look up a hostname for a given address). .PP The DNS lookup is started the next time the application enters the event loop. When the result is found the signal resultsReady() is emitted. .PP \fIrr\fR defaults to Ptr, that maps addresses to hostnames. -.SH "QDns::~QDns ()\fC [virtual]\fR" +.SH "TQDns::~TQDns ()\fC [virtual]\fR" Destroys the DNS query object and frees its allocated resources. -.SH "TQValueList<QHostAddress> QDns::addresses () const" -Returns a list of the addresses for this name if this QDns object has a recordType() of QDns::A or QDns::Aaaa and the answer is available; otherwise returns an empty list. +.SH "TQValueList<TQHostAddress> TQDns::addresses () const" +Returns a list of the addresses for this name if this TQDns object has a recordType() of TQDns::A or TQDns::Aaaa and the answer is available; otherwise returns an empty list. .PP As a special case, if label() is a valid numeric IP address, this function returns that address. .PP @@ -137,9 +137,9 @@ Note that if you want to iterate over the list, you should iterate over a copy, .PP .nf .br - TQValueList<QHostAddress> list = myDns.addresses(); + TQValueList<TQHostAddress> list = myDns.addresses(); .br - TQValueList<QHostAddress>::Iterator it = list.begin(); + TQValueList<TQHostAddress>::Iterator it = list.begin(); .br while( it != list.end() ) { .br @@ -150,13 +150,13 @@ Note that if you want to iterate over the list, you should iterate over a copy, } .br .fi -.SH "TQString QDns::canonicalName () const" +.SH "TQString TQDns::canonicalName () const" Returns the canonical name for this DNS node. (This works regardless of what recordType() is set to.) .PP If the canonical name isn't known, this function returns a null string. .PP -The canonical name of a DNS node is its full name, or the full name of the target of its CNAME. For example, if l.trolltech.com is a CNAME to lillian.troll.no, and the search path for QDns is" trolltech.com", then the canonical name for all of "lillian"," l", "lillian.troll.no." and "l.trolltech.com" is" lillian.troll.no.". -.SH "TQStringList QDns::hostNames () const" +The canonical name of a DNS node is its full name, or the full name of the target of its CNAME. For example, if l.trolltech.com is a CNAME to lillian.troll.no, and the search path for TQDns is" trolltech.com", then the canonical name for all of "lillian"," l", "lillian.troll.no." and "l.trolltech.com" is" lillian.troll.no.". +.SH "TQStringList TQDns::hostNames () const" Returns a list of host names if the record type is Ptr. .PP Note that if you want to iterate over the list, you should iterate over a copy, e.g. @@ -176,30 +176,30 @@ Note that if you want to iterate over the list, you should iterate over a copy, } .br .fi -.SH "bool QDns::isWorking () const" -Returns TRUE if QDns is doing a lookup for this object (i.e. if it does not already have the necessary information); otherwise returns FALSE. +.SH "bool TQDns::isWorking () const" +Returns TRUE if TQDns is doing a lookup for this object (i.e. if it does not already have the necessary information); otherwise returns FALSE. .PP -QDns emits the resultsReady() signal when the status changes to FALSE. +TQDns emits the resultsReady() signal when the status changes to FALSE. .PP Example: network/mail/smtp.cpp. -.SH "TQString QDns::label () const" +.SH "TQString TQDns::label () const" Returns the domain name for which this object returns information. .PP See also setLabel(). -.SH "TQValueList<MailServer> QDns::mailServers () const" -Returns a list of mail servers if the record type is Mx. The class \fCQDns::MailServer\fR contains the following public variables: +.SH "TQValueList<MailServer> TQDns::mailServers () const" +Returns a list of mail servers if the record type is Mx. The class \fCTQDns::MailServer\fR contains the following public variables: .TP -TQString QDns::MailServer::name +TQString TQDns::MailServer::name .TP -TQ_UINT16 QDns::MailServer::priority +TQ_UINT16 TQDns::MailServer::priority .PP Note that if you want to iterate over the list, you should iterate over a copy, e.g. .PP .nf .br - TQValueList<QDns::MailServer> list = myDns.mailServers(); + TQValueList<TQDns::MailServer> list = myDns.mailServers(); .br - TQValueList<QDns::MailServer>::Iterator it = list.begin(); + TQValueList<TQDns::MailServer>::Iterator it = list.begin(); .br while( it != list.end() ) { .br @@ -212,7 +212,7 @@ Note that if you want to iterate over the list, you should iterate over a copy, .fi .PP Example: network/mail/smtp.cpp. -.SH "TQStringList QDns::qualifiedNames () const" +.SH "TQStringList TQDns::qualifiedNames () const" Returns a list of the fully qualified names label() maps to. .PP Note that if you want to iterate over the list, you should iterate over a copy, e.g. @@ -232,32 +232,32 @@ Note that if you want to iterate over the list, you should iterate over a copy, } .br .fi -.SH "RecordType QDns::recordType () const" +.SH "RecordType TQDns::recordType () const" Returns the record type of this DNS query object. .PP See also setRecordType() and RecordType. -.SH "void QDns::resultsReady ()\fC [signal]\fR" +.SH "void TQDns::resultsReady ()\fC [signal]\fR" This signal is emitted when results are available for one of the qualifiedNames(). .PP Example: network/mail/smtp.cpp. -.SH "TQValueList<Server> QDns::servers () const" -Returns a list of servers if the record type is Srv. The class \fCQDns::Server\fR contains the following public variables: +.SH "TQValueList<Server> TQDns::servers () const" +Returns a list of servers if the record type is Srv. The class \fCTQDns::Server\fR contains the following public variables: .TP -TQString QDns::Server::name +TQString TQDns::Server::name .TP -TQ_UINT16 QDns::Server::priority +TQ_UINT16 TQDns::Server::priority .TP -TQ_UINT16 QDns::Server::weight +TQ_UINT16 TQDns::Server::weight .TP -TQ_UINT16 QDns::Server::port +TQ_UINT16 TQDns::Server::port .PP Note that if you want to iterate over the list, you should iterate over a copy, e.g. .PP .nf .br - TQValueList<QDns::Server> list = myDns.servers(); + TQValueList<TQDns::Server> list = myDns.servers(); .br - TQValueList<QDns::Server>::Iterator it = list.begin(); + TQValueList<TQDns::Server>::Iterator it = list.begin(); .br while( it != list.end() ) { .br @@ -268,23 +268,23 @@ Note that if you want to iterate over the list, you should iterate over a copy, } .br .fi -.SH "void QDns::setLabel ( const TQString & label )\fC [virtual]\fR" +.SH "void TQDns::setLabel ( const TQString & label )\fC [virtual]\fR" Sets this DNS query object to query for information about \fIlabel\fR. .PP This does not change the recordType(), but its isWorking() status will probably change as a result. .PP The DNS lookup is started the next time the application enters the event loop. When the result is found the signal resultsReady() is emitted. -.SH "void QDns::setLabel ( const QHostAddress & address )\fC [virtual]\fR" +.SH "void TQDns::setLabel ( const TQHostAddress & address )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Sets this DNS query object to query for information about the host address \fIaddress\fR. The label is set to the IN-ADDR.ARPA domain name. This is useful in combination with the Ptr record type (e.g. if you want to look up a hostname for a given address). -.SH "void QDns::setRecordType ( RecordType rr = A )\fC [virtual]\fR" +.SH "void TQDns::setRecordType ( RecordType rr = A )\fC [virtual]\fR" Sets this object to query for record type \fIrr\fR records. .PP The DNS lookup is started the next time the application enters the event loop. When the result is found the signal resultsReady() is emitted. .PP See also RecordType. -.SH "TQStringList QDns::texts () const" +.SH "TQStringList TQDns::texts () const" Returns a list of texts if the record type is Txt. .PP Note that if you want to iterate over the list, you should iterate over a copy, e.g. @@ -306,7 +306,7 @@ Note that if you want to iterate over the list, you should iterate over a copy, .fi .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqdns.html +.BR http://doc.trolltech.com/tqdns.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqdomdocument.3qt b/doc/man/man3/tqdomdocument.3qt index 6a7e8e25c..33813c7b5 100644 --- a/doc/man/man3/tqdomdocument.3qt +++ b/doc/man/man3/tqdomdocument.3qt @@ -157,7 +157,7 @@ The TQDom classes are typically used as follows: .br TQDomDocument doc( "mydocument" ); .br - QFile file( "mydocument.xml" ); + TQFile file( "mydocument.xml" ); .br if ( !file.open( IO_ReadOnly ) ) .br diff --git a/doc/man/man3/tqdomnode.3qt b/doc/man/man3/tqdomnode.3qt index 7f68db777..cf59170eb 100644 --- a/doc/man/man3/tqdomnode.3qt +++ b/doc/man/man3/tqdomnode.3qt @@ -489,7 +489,7 @@ Example: xml/outliner/outlinetree.cpp. .SH "bool TQDomNode::isProcessingInstruction () const\fC [virtual]\fR" Returns TRUE if the node is a processing instruction; otherwise returns FALSE. .PP -If this function returns TRUE, it does not imply that this object is a TQDomProcessingInstruction; you can get the QProcessingInstruction with toProcessingInstruction(). +If this function returns TRUE, it does not imply that this object is a TQDomProcessingInstruction; you can get the TQProcessingInstruction with toProcessingInstruction(). .PP See also toProcessingInstruction(). .PP diff --git a/doc/man/man3/tqdragobject.3qt b/doc/man/man3/tqdragobject.3qt index 498ef445b..aefc06e08 100644 --- a/doc/man/man3/tqdragobject.3qt +++ b/doc/man/man3/tqdragobject.3qt @@ -73,7 +73,7 @@ TQDragObject is the base class for all data that needs to be transferred between .PP See the Drag-and-drop documentation for an overview of how to provide drag and drop in your application. .PP -See the QClipboard documentation for an overview of how to provide cut-and-paste in your application. +See the TQClipboard documentation for an overview of how to provide cut-and-paste in your application. .PP The drag() function is used to start a drag operation. You can specify the DragMode in the call or use one of the convenience functions dragCopy(), dragMove() or dragLink(). The drag source where the data originated is retrieved with source(). If the data was dropped on a widget within the application, target() will return a pointer to that widget. Specify the pixmap to display during the drag with setPixmap(). .PP @@ -143,7 +143,7 @@ The \fIhotspot\fR is the point on (or off) the pixmap that should be under the c .PP \fBWarning:\fR We have seen problems with drag cursors on different graphics hardware and driver software on Windows. Setting the graphics acceleration in the display settings down one tick solved the problems in all cases. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "void TQDragObject::setPixmap ( QPixmap pm )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP diff --git a/doc/man/man3/tqdropevent.3qt b/doc/man/man3/tqdropevent.3qt index b20cb9f02..0c23fa2ef 100644 --- a/doc/man/man3/tqdropevent.3qt +++ b/doc/man/man3/tqdropevent.3qt @@ -102,12 +102,12 @@ Example: iconview/simple_dd/main.cpp. Call this to indicate that the action described by action() is accepted (i.e. if \fIy\fR is TRUE, which is the default), not merely the default copy action. If you call acceptAction(TRUE), there is no need to also call accept(TRUE). .PP Examples: -.)l dirview/dirview.cpp and fileiconview/qfileiconview.cpp. +.)l dirview/dirview.cpp and fileiconview/tqfileiconview.cpp. .SH "Action TQDropEvent::action () const" Returns the Action which the target is requesting to be performed with the data. If your application understands the action and can process the supplied data, call acceptAction(); if your application can process the supplied data but can only perform the Copy action, call accept(). .PP Examples: -.)l dirview/dirview.cpp and fileiconview/qfileiconview.cpp. +.)l dirview/dirview.cpp and fileiconview/tqfileiconview.cpp. .SH "TQByteArray TQDropEvent::data ( const char * f ) const" \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. .PP @@ -135,7 +135,7 @@ Reimplemented from TQMimeSource. .SH "void TQDropEvent::ignore ()" The opposite of accept(), i.e. you have ignored the drop event. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "bool TQDropEvent::isAccepted () const" Returns TRUE if the drop target accepts the event; otherwise returns FALSE. .SH "bool TQDropEvent::isActionAccepted () const" @@ -149,7 +149,7 @@ Returns TRUE if this event provides format \fImimeType\fR; otherwise returns FAL .PP See also data(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .PP Reimplemented from TQMimeSource. .SH "void TQDropEvent::setAction ( Action a )" diff --git a/doc/man/man3/tqevent.3qt b/doc/man/man3/tqevent.3qt index fe54d3176..ba12ce519 100644 --- a/doc/man/man3/tqevent.3qt +++ b/doc/man/man3/tqevent.3qt @@ -139,7 +139,7 @@ This enum type defines the valid event types in Qt. The event types and the spec .TP \fCQEvent::Clipboard\fR - Clipboard contents have changed. .TP -\fCQEvent::SockAct\fR - Socket activated, used to implement QSocketNotifier. +\fCQEvent::SockAct\fR - Socket activated, used to implement TQSocketNotifier. .TP \fCQEvent::DragEnter\fR - A drag-and-drop enters widget, TQDragEnterEvent. .TP diff --git a/doc/man/man3/tqeventloop.3qt b/doc/man/man3/tqeventloop.3qt index 58896b22f..c86e9c2ed 100644 --- a/doc/man/man3/tqeventloop.3qt +++ b/doc/man/man3/tqeventloop.3qt @@ -39,13 +39,13 @@ Inherited by QMotif. .BI "virtual bool \fBhasPendingEvents\fR () const" .br .ti -1c -.BI "virtual void \fBregisterSocketNotifier\fR ( QSocketNotifier * notifier )" +.BI "virtual void \fBregisterSocketNotifier\fR ( TQSocketNotifier * notifier )" .br .ti -1c -.BI "virtual void \fBunregisterSocketNotifier\fR ( QSocketNotifier * notifier )" +.BI "virtual void \fBunregisterSocketNotifier\fR ( TQSocketNotifier * notifier )" .br .ti -1c -.BI "void \fBsetSocketNotifierPending\fR ( QSocketNotifier * notifier )" +.BI "void \fBsetSocketNotifierPending\fR ( TQSocketNotifier * notifier )" .br .ti -1c .BI "int \fBactivateSocketNotifiers\fR ()" @@ -195,9 +195,9 @@ NOTE: This function will not process events continuously; it returns after all a This function returns TRUE if an event was processed; otherwise it returns FALSE. .PP See also ProcessEvents and hasPendingEvents(). -.SH "void QEventLoop::registerSocketNotifier ( QSocketNotifier * notifier )\fC [virtual]\fR" +.SH "void QEventLoop::registerSocketNotifier ( TQSocketNotifier * notifier )\fC [virtual]\fR" Registers \fInotifier\fR with the event loop. Subclasses need to reimplement this method to tie a socket notifier into another event loop. Reimplementations \fIMUST\fR call the base implementation. -.SH "void QEventLoop::setSocketNotifierPending ( QSocketNotifier * notifier )" +.SH "void QEventLoop::setSocketNotifierPending ( TQSocketNotifier * notifier )" Marks \fInotifier\fR as pending. The socket notifier will be activated the next time activateSocketNotifiers() is called. .SH "int QEventLoop::timeToWait () const" Returns the number of milliseconds that TQt needs to handle its timers or -1 if there are no timers running. @@ -205,7 +205,7 @@ Returns the number of milliseconds that TQt needs to handle its timers or -1 if QEventLoop subclasses that do their own timer handling need to use this to make sure that Qt's timers continue to work. .PP Note: This function is only useful on systems where \fCselect()\fR is used to block the eventloop. On Windows, this function always returns -1. On MacOS X, this function always returns -1 when the GUI is enabled. On MacOS X, this function returns the documented value when the GUI is disabled. -.SH "void QEventLoop::unregisterSocketNotifier ( QSocketNotifier * notifier )\fC [virtual]\fR" +.SH "void QEventLoop::unregisterSocketNotifier ( TQSocketNotifier * notifier )\fC [virtual]\fR" Unregisters \fInotifier\fR from the event loop. Subclasses need to reimplement this method to tie a socket notifier into another event loop. Reimplementations \fIMUST\fR call the base implementation. .SH "void QEventLoop::wakeUp ()\fC [virtual]\fR" \fBNote:\fR This function is thread-safe when TQt is built withthread support.</p> diff --git a/doc/man/man3/tqfile.3qt b/doc/man/man3/tqfile.3qt index 96c3ed460..6063665e7 100644 --- a/doc/man/man3/tqfile.3qt +++ b/doc/man/man3/tqfile.3qt @@ -1,5 +1,5 @@ '\" t -.TH QFile 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQFile 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,24 +7,24 @@ .ad l .nh .SH NAME -QFile \- I/O device that operates on files +TQFile \- I/O device that operates on files .SH SYNOPSIS Almost all the functions in this class are reentrant when TQt is built with thread support. The exceptions are \fBsetEncodingFunction\fR(), \fBsetDecodingFunction\fR(), and \fBsetErrorString\fR(). </p> .PP -\fC#include <ntqfile.h>\fR +\fC#include <tqfile.h>\fR .PP Inherits TQIODevice. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQFile\fR ()" +.BI "\fBTQFile\fR ()" .br .ti -1c -.BI "\fBQFile\fR ( const TQString & name )" +.BI "\fBTQFile\fR ( const TQString & name )" .br .ti -1c -.BI "\fB~QFile\fR ()" +.BI "\fB~TQFile\fR ()" .br .ti -1c .BI "TQString \fBname\fR () const" @@ -121,13 +121,13 @@ Inherits TQIODevice. .br .in -1c .SH DESCRIPTION -The QFile class is an I/O device that operates on files. +The TQFile class is an I/O device that operates on files. .PP -QFile is an I/O device for reading and writing binary and text files. A QFile may be used by itself or more conveniently with a QDataStream or TQTextStream. +TQFile is an I/O device for reading and writing binary and text files. A TQFile may be used by itself or more conveniently with a TQDataStream or TQTextStream. .PP The file name is usually passed in the constructor but can be changed with setName(). You can check for a file's existence with exists() and remove a file with remove(). .PP -The file is opened with open(), closed with close() and flushed with flush(). Data is usually read and written using QDataStream or TQTextStream, but you can read with readBlock() and readLine() and write with writeBlock(). QFile also supports getch(), ungetch() and putch(). +The file is opened with open(), closed with close() and flushed with flush(). Data is usually read and written using TQDataStream or TQTextStream, but you can read with readBlock() and readLine() and write with writeBlock(). TQFile also supports getch(), ungetch() and putch(). .PP The size of the file is returned by size(). You can get the current file position or move to a new file position using the at() functions. If you've reached the end of the file, atEnd() returns TRUE. The file handle is returned by handle(). .PP @@ -137,7 +137,7 @@ Here is a code fragment that uses TQTextStream to read a text file line by line. .br TQStringList lines; .br - QFile file( "file.txt" ); + TQFile file( "file.txt" ); .br if ( file.open( IO_ReadOnly ) ) { .br @@ -167,7 +167,7 @@ Writing text is just as easy. The following example shows how to write the data .PP .nf .br - QFile file( "file.txt" ); + TQFile file( "file.txt" ); .br if ( file.open( IO_WriteOnly ) ) { .br @@ -183,36 +183,36 @@ Writing text is just as easy. The following example shows how to write the data .br .fi .PP -The QFileInfo class holds detailed information about a file, such as access permissions, file dates and file types. +The TQFileInfo class holds detailed information about a file, such as access permissions, file dates and file types. .PP -The QDir class manages directories and lists of file names. +The TQDir class manages directories and lists of file names. .PP Qt uses Unicode file names. If you want to do your own I/O on Unix systems you may want to use encodeName() (and decodeName()) to convert the file name into the local encoding. .PP -See also QDataStream, TQTextStream, and Input/Output and Networking. +See also TQDataStream, TQTextStream, and Input/Output and Networking. .SS "Member Type Documentation" -.SH "QFile::DecoderFn" -This is used by QFile::setDecodingFunction(). -.SH "QFile::EncoderFn" -This is used by QFile::setEncodingFunction(). +.SH "TQFile::DecoderFn" +This is used by TQFile::setDecodingFunction(). +.SH "TQFile::EncoderFn" +This is used by TQFile::setEncodingFunction(). .SH MEMBER FUNCTION DOCUMENTATION -.SH "QFile::QFile ()" -Constructs a QFile with no name. -.SH "QFile::QFile ( const TQString & name )" -Constructs a QFile with a file name \fIname\fR. +.SH "TQFile::TQFile ()" +Constructs a TQFile with no name. +.SH "TQFile::TQFile ( const TQString & name )" +Constructs a TQFile with a file name \fIname\fR. .PP See also setName(). -.SH "QFile::~QFile ()" -Destroys a QFile. Calls close(). -.SH "bool QFile::atEnd () const\fC [virtual]\fR" -Returns TRUE if the end of file has been reached; otherwise returns FALSE. If QFile has not been open()'d, then the behavior is undefined. +.SH "TQFile::~TQFile ()" +Destroys a TQFile. Calls close(). +.SH "bool TQFile::atEnd () const\fC [virtual]\fR" +Returns TRUE if the end of file has been reached; otherwise returns FALSE. If TQFile has not been open()'d, then the behavior is undefined. .PP See also size(). .PP Example: distributor/distributor.ui.h. .PP Reimplemented from TQIODevice. -.SH "void QFile::close ()\fC [virtual]\fR" +.SH "void TQFile::close ()\fC [virtual]\fR" Closes an open file. .PP The file is not closed if it was opened with an existing file handle. If the existing file handle is a \fCFILE*\fR, the file is flushed. If the existing file handle is an \fCint\fR file descriptor, nothing is done to the file. @@ -222,17 +222,17 @@ Some "write-behind" filesystems may report an unspecified error on closing the f See also open() and flush(). .PP Examples: -.)l chart/chartform_files.cpp, distributor/distributor.ui.h, helpviewer/helpwindow.cpp, mdi/application.cpp, qdir/qdir.cpp, qwerty/qwerty.cpp, and xml/outliner/outlinetree.cpp. +.)l chart/chartform_files.cpp, distributor/distributor.ui.h, helpviewer/helpwindow.cpp, mdi/application.cpp, tqdir/tqdir.cpp, qwerty/qwerty.cpp, and xml/outliner/outlinetree.cpp. .PP Reimplemented from TQIODevice. -.SH "TQString QFile::decodeName ( const TQCString & localFileName )\fC [static]\fR" -This does the reverse of QFile::encodeName() using \fIlocalFileName\fR. +.SH "TQString TQFile::decodeName ( const TQCString & localFileName )\fC [static]\fR" +This does the reverse of TQFile::encodeName() using \fIlocalFileName\fR. .PP See also setDecodingFunction(). .PP Example: distributor/distributor.ui.h. -.SH "TQCString QFile::encodeName ( const TQString & fileName )\fC [static]\fR" -When you use QFile, QFileInfo, and QDir to access the file system with Qt, you can use Unicode file names. On Unix, these file names are converted to an 8-bit encoding. If you want to do your own file I/O on Unix, you should convert the file name using this function. On Windows NT/2000, Unicode file names are supported directly in the file system and this function should be avoided. On Windows 95, non-Latin1 locales are not supported. +.SH "TQCString TQFile::encodeName ( const TQString & fileName )\fC [static]\fR" +When you use TQFile, TQFileInfo, and TQDir to access the file system with Qt, you can use Unicode file names. On Unix, these file names are converted to an 8-bit encoding. If you want to do your own file I/O on Unix, you should convert the file name using this function. On Windows NT/2000, Unicode file names are supported directly in the file system and this function should be avoided. On Windows 95, non-Latin1 locales are not supported. .PP By default, this function converts \fIfileName\fR to the local 8-bit encoding determined by the user's locale. This is sufficient for file names that the user chooses. File names hard-coded into the application should only use 7-bit ASCII filename characters. .PP @@ -241,14 +241,14 @@ The conversion scheme can be changed using setEncodingFunction(). This might be See also decodeName(). .PP Example: distributor/distributor.ui.h. -.SH "TQString QFile::errorString () const" +.SH "TQString TQFile::errorString () const" Returns a human-readable description of the reason of an error that occurred on the device. The error described by the string corresponds to changes of TQIODevice::status(). If the status is reset, the error string is also reset. .PP -The returned strings are not translated with the TQObject::tr() or QApplication::translate() functions. They are marked as translatable strings in the "QFile" context. Before you show the string to the user you should translate it first, for example: +The returned strings are not translated with the TQObject::tr() or QApplication::translate() functions. They are marked as translatable strings in the "TQFile" context. Before you show the string to the user you should translate it first, for example: .PP .nf .br - QFile f( "address.dat" ); + TQFile f( "address.dat" ); .br if ( !f.open( IO_ReadOnly ) { .br @@ -258,7 +258,7 @@ The returned strings are not translated with the TQObject::tr() or QApplication: .br tr("Open failed"), .br - tr("Could not open file for reading: %1").arg( tqApp->translate("QFile",f.errorString()) ) + tr("Could not open file for reading: %1").arg( tqApp->translate("TQFile",f.errorString()) ) .br ); .br @@ -269,24 +269,24 @@ The returned strings are not translated with the TQObject::tr() or QApplication: .fi .PP See also TQIODevice::status(), TQIODevice::resetStatus(), and setErrorString(). -.SH "bool QFile::exists ( const TQString & fileName )\fC [static]\fR" +.SH "bool TQFile::exists ( const TQString & fileName )\fC [static]\fR" Returns TRUE if the file given by \fIfileName\fR exists; otherwise returns FALSE. .PP Examples: .)l chart/chartform.cpp, dirview/dirview.cpp, and helpviewer/helpwindow.cpp. -.SH "bool QFile::exists () const" +.SH "bool TQFile::exists () const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Returns TRUE if this file exists; otherwise returns FALSE. .PP See also name(). -.SH "void QFile::flush ()\fC [virtual]\fR" +.SH "void TQFile::flush ()\fC [virtual]\fR" Flushes the file buffer to the disk. .PP close() also flushes the file buffer. .PP Reimplemented from TQIODevice. -.SH "int QFile::getch ()\fC [virtual]\fR" +.SH "int TQFile::getch ()\fC [virtual]\fR" Reads a single byte/character from the file. .PP Returns the byte/character read, or -1 if the end of the file has been reached. @@ -294,19 +294,19 @@ Returns the byte/character read, or -1 if the end of the file has been reached. See also putch() and ungetch(). .PP Reimplemented from TQIODevice. -.SH "int QFile::handle () const" +.SH "int TQFile::handle () const" Returns the file handle of the file. .PP -This is a small positive integer, suitable for use with C library functions such as fdopen() and fcntl(). On systems that use file descriptors for sockets (ie. Unix systems, but not Windows) the handle can be used with QSocketNotifier as well. +This is a small positive integer, suitable for use with C library functions such as fdopen() and fcntl(). On systems that use file descriptors for sockets (ie. Unix systems, but not Windows) the handle can be used with TQSocketNotifier as well. .PP If the file is not open or there is an error, handle() returns -1. .PP -See also QSocketNotifier. -.SH "TQString QFile::name () const" +See also TQSocketNotifier. +.SH "TQString TQFile::name () const" Returns the name set by setName(). .PP -See also setName() and QFileInfo::fileName(). -.SH "bool QFile::open ( int m )\fC [virtual]\fR" +See also setName() and TQFileInfo::fileName(). +.SH "bool TQFile::open ( int m )\fC [virtual]\fR" Opens the file specified by the file name currently set, using the mode \fIm\fR. Returns TRUE if successful, otherwise FALSE. .PP @@ -330,17 +330,17 @@ Example: .PP .nf .br - QFile f1( "/tmp/data.bin" ); + TQFile f1( "/tmp/data.bin" ); .br f1.open( IO_Raw | IO_ReadWrite ); .br .br - QFile f2( "readme.txt" ); + TQFile f2( "readme.txt" ); .br f2.open( IO_ReadOnly | IO_Translate ); .br .br - QFile f3( "audit.log" ); + TQFile f3( "audit.log" ); .br f3.open( IO_WriteOnly | IO_Append ); .br @@ -349,10 +349,10 @@ Example: See also name(), close(), isOpen(), and flush(). .PP Examples: -.)l application/application.cpp, chart/chartform_files.cpp, distributor/distributor.ui.h, helpviewer/helpwindow.cpp, qdir/qdir.cpp, qwerty/qwerty.cpp, and xml/outliner/outlinetree.cpp. +.)l application/application.cpp, chart/chartform_files.cpp, distributor/distributor.ui.h, helpviewer/helpwindow.cpp, tqdir/tqdir.cpp, qwerty/qwerty.cpp, and xml/outliner/outlinetree.cpp. .PP Reimplemented from TQIODevice. -.SH "bool QFile::open ( int m, FILE * f )" +.SH "bool TQFile::open ( int m, FILE * f )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Opens a file in the mode \fIm\fR using an existing file handle \fIf\fR. Returns TRUE if successful, otherwise FALSE. @@ -368,7 +368,7 @@ Example: .br { .br - QFile f; + TQFile f; .br f.open( IO_WriteOnly, stderr ); .br @@ -380,24 +380,24 @@ Example: .br .fi .PP -When a QFile is opened using this function, close() does not actually close the file, only flushes it. +When a TQFile is opened using this function, close() does not actually close the file, only flushes it. .PP \fBWarning:\fR If \fIf\fR is \fCstdin\fR, \fCstdout\fR, \fCstderr\fR, you may not be able to seek. See TQIODevice::isSequentialAccess() for more information. .PP See also close(). -.SH "bool QFile::open ( int m, int f )" +.SH "bool TQFile::open ( int m, int f )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Opens a file in the mode \fIm\fR using an existing file descriptor \fIf\fR. Returns TRUE if successful, otherwise FALSE. .PP -When a QFile is opened using this function, close() does not actually close the file. +When a TQFile is opened using this function, close() does not actually close the file. .PP -The QFile that is opened using this function, is automatically set to be in raw mode; this means that the file input/output functions are slow. If you run into performance issues, you should try to use one of the other open functions. +The TQFile that is opened using this function, is automatically set to be in raw mode; this means that the file input/output functions are slow. If you run into performance issues, you should try to use one of the other open functions. .PP \fBWarning:\fR If \fIf\fR is one of 0 (stdin), 1 (stdout) or 2 (stderr), you may not be able to seek. size() is set to \fCINT_MAX\fR (in limits.h). .PP See also close(). -.SH "int QFile::putch ( int ch )\fC [virtual]\fR" +.SH "int TQFile::putch ( int ch )\fC [virtual]\fR" Writes the character \fIch\fR to the file. .PP Returns \fIch\fR, or -1 if some error occurred. @@ -407,7 +407,7 @@ See also getch() and ungetch(). Reimplemented from TQIODevice. .SH "TQByteArray TQIODevice::readAll ()\fC [virtual]\fR" This convenience function returns all of the remaining data in the device. -.SH "TQ_LONG QFile::readLine ( char * p, TQ_ULONG maxlen )\fC [virtual]\fR" +.SH "TQ_LONG TQFile::readLine ( char * p, TQ_ULONG maxlen )\fC [virtual]\fR" Reads a line of text. .PP Reads bytes from the file into the char* \fIp\fR, until end-of-line or \fImaxlen\fR bytes have been read, whichever occurs first. Returns the number of bytes read, or -1 if there was an error. Any terminating newline is not stripped. @@ -417,7 +417,7 @@ This function is only efficient for buffered files. Avoid readLine() for files t See also readBlock() and TQTextStream::readLine(). .PP Reimplemented from TQIODevice. -.SH "TQ_LONG QFile::readLine ( TQString & s, TQ_ULONG maxlen )" +.SH "TQ_LONG TQFile::readLine ( TQString & s, TQ_ULONG maxlen )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Reads a line of text. @@ -429,33 +429,33 @@ This function is only efficient for buffered files. Avoid using readLine() for f Note that the string is read as plain Latin1 bytes, not Unicode. .PP See also readBlock() and TQTextStream::readLine(). -.SH "bool QFile::remove ()" +.SH "bool TQFile::remove ()" Removes the file specified by the file name currently set. Returns TRUE if successful; otherwise returns FALSE. .PP The file is closed before it is removed. -.SH "bool QFile::remove ( const TQString & fileName )\fC [static]\fR" +.SH "bool TQFile::remove ( const TQString & fileName )\fC [static]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Removes the file \fIfileName\fR. Returns TRUE if successful, otherwise FALSE. -.SH "void QFile::setDecodingFunction ( DecoderFn f )\fC [static]\fR" +.SH "void TQFile::setDecodingFunction ( DecoderFn f )\fC [static]\fR" \fBWarning:\fR This function is \fInot\fR reentrant.</p> .PP Sets the function for decoding 8-bit file names to \fIf\fR. The default uses the locale-specific 8-bit encoding. .PP See also encodeName() and decodeName(). -.SH "void QFile::setEncodingFunction ( EncoderFn f )\fC [static]\fR" +.SH "void TQFile::setEncodingFunction ( EncoderFn f )\fC [static]\fR" \fBWarning:\fR This function is \fInot\fR reentrant.</p> .PP Sets the function for encoding Unicode file names to \fIf\fR. The default encodes in the locale-specific 8-bit encoding. .PP See also encodeName(). -.SH "void QFile::setErrorString ( const TQString & str )\fC [protected]\fR" +.SH "void TQFile::setErrorString ( const TQString & str )\fC [protected]\fR" \fBWarning:\fR This function is \fInot\fR reentrant.</p> .PP Sets the error string returned by the errorString() function to \fIstr\fR. .PP See also errorString() and TQIODevice::status(). -.SH "void QFile::setName ( const TQString & name )" +.SH "void TQFile::setName ( const TQString & name )" Sets the name of the file to \fIname\fR. The name can have no path, a relative path or an absolute absolute path. .PP Do not call this function if the file has already been opened. @@ -466,13 +466,13 @@ Example: .PP .nf .br - QFile file; + TQFile file; .br - QDir::setCurrent( "/tmp" ); + TQDir::setCurrent( "/tmp" ); .br file.setName( "readme.txt" ); .br - QDir::setCurrent( "/home" ); + TQDir::setCurrent( "/home" ); .br file.open( IO_ReadOnly ); // opens "/home/readme.txt" under Unix .br @@ -480,8 +480,8 @@ Example: .PP Note that the directory separator "/" works for all operating systems supported by Qt. .PP -See also name(), QFileInfo, and QDir. -.SH "Offset QFile::size () const\fC [virtual]\fR" +See also name(), TQFileInfo, and TQDir. +.SH "Offset TQFile::size () const\fC [virtual]\fR" Returns the file size. .PP See also at(). @@ -489,7 +489,7 @@ See also at(). Example: table/statistics/statistics.cpp. .PP Reimplemented from TQIODevice. -.SH "int QFile::ungetch ( int ch )\fC [virtual]\fR" +.SH "int TQFile::ungetch ( int ch )\fC [virtual]\fR" Puts the character \fIch\fR back into the file and decrements the index if it is not zero. .PP This function is normally called to "undo" a getch() operation. @@ -501,7 +501,7 @@ See also getch() and putch(). Reimplemented from TQIODevice. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqfile.html +.BR http://doc.trolltech.com/tqfile.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqfiledialog.3qt b/doc/man/man3/tqfiledialog.3qt index f8cbdf2e9..3c8798f27 100644 --- a/doc/man/man3/tqfiledialog.3qt +++ b/doc/man/man3/tqfiledialog.3qt @@ -1,5 +1,5 @@ '\" t -.TH QFileDialog 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQFileDialog 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,22 +7,22 @@ .ad l .nh .SH NAME -QFileDialog \- Dialogs that allow users to select files or directories +TQFileDialog \- Dialogs that allow users to select files or directories .SH SYNOPSIS -\fC#include <ntqfiledialog.h>\fR +\fC#include <tqfiledialog.h>\fR .PP Inherits QDialog. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQFileDialog\fR ( const TQString & dirName, const TQString & filter = TQString::null, TQWidget * parent = 0, const char * name = 0, bool modal = FALSE )" +.BI "\fBTQFileDialog\fR ( const TQString & dirName, const TQString & filter = TQString::null, TQWidget * parent = 0, const char * name = 0, bool modal = FALSE )" .br .ti -1c -.BI "\fBQFileDialog\fR ( TQWidget * parent = 0, const char * name = 0, bool modal = FALSE )" +.BI "\fBTQFileDialog\fR ( TQWidget * parent = 0, const char * name = 0, bool modal = FALSE )" .br .ti -1c -.BI "\fB~QFileDialog\fR ()" +.BI "\fB~TQFileDialog\fR ()" .br .ti -1c .BI "TQString \fBselectedFile\fR () const" @@ -49,10 +49,10 @@ Inherits QDialog. .BI "TQString \fBdirPath\fR () const" .br .ti -1c -.BI "void \fBsetDir\fR ( const QDir & dir )" +.BI "void \fBsetDir\fR ( const TQDir & dir )" .br .ti -1c -.BI "const QDir * \fBdir\fR () const" +.BI "const TQDir * \fBdir\fR () const" .br .ti -1c .BI "void \fBsetShowHiddenFiles\fR ( bool s )" @@ -106,13 +106,13 @@ Inherits QDialog. .BI "void \fBsetContentsPreviewEnabled\fR ( bool )" .br .ti -1c -.BI "void \fBsetInfoPreview\fR ( TQWidget * w, QFilePreview * preview )" +.BI "void \fBsetInfoPreview\fR ( TQWidget * w, TQFilePreview * preview )" .br .ti -1c -.BI "void \fBsetContentsPreview\fR ( TQWidget * w, QFilePreview * preview )" +.BI "void \fBsetContentsPreview\fR ( TQWidget * w, TQFilePreview * preview )" .br .ti -1c -.BI "QUrl \fBurl\fR () const" +.BI "TQUrl \fBurl\fR () const" .br .ti -1c .BI "void \fBaddFilter\fR ( const TQString & filter )" @@ -124,7 +124,7 @@ Inherits QDialog. .BI "void \fBsetDir\fR ( const TQString & pathstr )" .br .ti -1c -.BI "void \fBsetUrl\fR ( const QUrlOperator & url )" +.BI "void \fBsetUrl\fR ( const TQUrlOperator & url )" .br .ti -1c .BI "void \fBsetFilter\fR ( const TQString & newFilter )" @@ -172,10 +172,10 @@ Inherits QDialog. .BI "TQStringList \fBgetOpenFileNames\fR ( const TQString & filter = TQString::null, const TQString & dir = TQString::null, TQWidget * parent = 0, const char * name = 0, const TQString & caption = TQString::null, TQString * selectedFilter = 0, bool resolveSymlinks = TRUE )" .br .ti -1c -.BI "void \fBsetIconProvider\fR ( QFileIconProvider * provider )" +.BI "void \fBsetIconProvider\fR ( TQFileIconProvider * provider )" .br .ti -1c -.BI "QFileIconProvider * \fBiconProvider\fR ()" +.BI "TQFileIconProvider * \fBiconProvider\fR ()" .br .in -1c .SS "Properties" @@ -227,15 +227,15 @@ Inherits QDialog. .br .in -1c .SH DESCRIPTION -The QFileDialog class provides dialogs that allow users to select files or directories. +The TQFileDialog class provides dialogs that allow users to select files or directories. .PP -The QFileDialog class enables a user to traverse their file system in order to select one or many files or a directory. +The TQFileDialog class enables a user to traverse their file system in order to select one or many files or a directory. .PP -The easiest way to create a QFileDialog is to use the static functions. On Windows, these static functions will call the native Windows file dialog and on Mac OS X, these static function will call the native Mac OS X file dialog. +The easiest way to create a TQFileDialog is to use the static functions. On Windows, these static functions will call the native Windows file dialog and on Mac OS X, these static function will call the native Mac OS X file dialog. .PP .nf .br - TQString s = QFileDialog::getOpenFileName( + TQString s = TQFileDialog::getOpenFileName( .br "/home", .br @@ -249,7 +249,7 @@ The easiest way to create a QFileDialog is to use the static functions. On Windo .br .fi .PP -In the above example, a modal QFileDialog is created using a static function. The startup directory is set to "/home". The file filter is set to "Images (*.png *.xpm *.jpg)". The parent of the file dialog is set to \fIthis\fR and it is given the identification name - "open file dialog". The caption at the top of file dialog is set to "Choose a file". If you want to use multiple filters, separate each one with \fItwo\fR semi-colons, e.g. +In the above example, a modal TQFileDialog is created using a static function. The startup directory is set to "/home". The file filter is set to "Images (*.png *.xpm *.jpg)". The parent of the file dialog is set to \fIthis\fR and it is given the identification name - "open file dialog". The caption at the top of file dialog is set to "Choose a file". If you want to use multiple filters, separate each one with \fItwo\fR semi-colons, e.g. .PP .nf .br @@ -257,17 +257,17 @@ In the above example, a modal QFileDialog is created using a static function. Th .br .fi .PP -You can create your own QFileDialog without using the static functions. By calling setMode(), you can set what can be returned by the QFileDialog. +You can create your own TQFileDialog without using the static functions. By calling setMode(), you can set what can be returned by the TQFileDialog. .PP .nf .br - QFileDialog* fd = new QFileDialog( this, "file dialog", TRUE ); + TQFileDialog* fd = new TQFileDialog( this, "file dialog", TRUE ); .br - fd->setMode( QFileDialog::AnyFile ); + fd->setMode( TQFileDialog::AnyFile ); .br .fi .PP -In the above example, the mode of the file dialog is set to AnyFile, meaning that the user can select any file, or even specify a file that doesn't exist. This mode is useful for creating a "File Save As" file dialog. Use ExistingFile if the user must select an existing file or Directory if only a directory may be selected. (See the QFileDialog::Mode enum for the complete list of modes.) +In the above example, the mode of the file dialog is set to AnyFile, meaning that the user can select any file, or even specify a file that doesn't exist. This mode is useful for creating a "File Save As" file dialog. Use ExistingFile if the user must select an existing file or Directory if only a directory may be selected. (See the TQFileDialog::Mode enum for the complete list of modes.) .PP You can retrieve the dialog's mode with mode(). Use setFilter() to set the dialog's file filter, e.g. .PP @@ -277,13 +277,13 @@ You can retrieve the dialog's mode with mode(). Use setFilter() to set the dialo .br .fi .PP -In the above example, the filter is set to "Images (*.png *.xpm *.jpg)", this means that only files with the extension \fCpng\fR, \fCxpm\fR or \fCjpg\fR will be shown in the QFileDialog. You can apply several filters by using setFilters() and add additional filters with addFilter(). Use setSelectedFilter() to select one of the filters you've given as the file dialog's default filter. Whenever the user changes the filter the filterSelected() signal is emitted. +In the above example, the filter is set to "Images (*.png *.xpm *.jpg)", this means that only files with the extension \fCpng\fR, \fCxpm\fR or \fCjpg\fR will be shown in the TQFileDialog. You can apply several filters by using setFilters() and add additional filters with addFilter(). Use setSelectedFilter() to select one of the filters you've given as the file dialog's default filter. Whenever the user changes the filter the filterSelected() signal is emitted. .PP -The file dialog has two view modes, QFileDialog::List which simply lists file and directory names and QFileDialog::Detail which displays additional information alongside each name, e.g. file size, modification date, etc. Set the mode with setViewMode(). +The file dialog has two view modes, TQFileDialog::List which simply lists file and directory names and TQFileDialog::Detail which displays additional information alongside each name, e.g. file size, modification date, etc. Set the mode with setViewMode(). .PP .nf .br - fd->setViewMode( QFileDialog::Detail ); + fd->setViewMode( TQFileDialog::Detail ); .br .fi .PP @@ -305,13 +305,13 @@ If you are using the ExistingFiles mode then you will need to use selectedFiles( .PP The dialog's working directory can be set with setDir(). The display of hidden files is controlled with setShowHiddenFiles(). The dialog can be forced to re-read the directory with rereadDir() and re-sort the directory with resortDir(). All the files in the current directory can be selected with selectAll(). .SH "Creating and using preview widgets" -There are two kinds of preview widgets that can be used with QFileDialogs: \fIcontent\fR preview widgets and \fIinformation\fR preview widgets. They are created and used in the same way except that the function names differ, e.g. setContentsPreview() and setInfoPreview(). +There are two kinds of preview widgets that can be used with TQFileDialogs: \fIcontent\fR preview widgets and \fIinformation\fR preview widgets. They are created and used in the same way except that the function names differ, e.g. setContentsPreview() and setInfoPreview(). .PP -A preview widget is a widget that is placed inside a QFileDialog so that the user can see either the contents of the file, or information about the file. +A preview widget is a widget that is placed inside a TQFileDialog so that the user can see either the contents of the file, or information about the file. .PP .nf .br - class Preview : public QLabel, public QFilePreview + class Preview : public QLabel, public TQFilePreview .br { .br @@ -320,7 +320,7 @@ A preview widget is a widget that is placed inside a QFileDialog so that the use Preview( TQWidget *parent=0 ) : QLabel( parent ) {} .br .br - void previewUrl( const QUrl &u ) + void previewUrl( const TQUrl &u ) .br { .br @@ -342,22 +342,22 @@ A preview widget is a widget that is placed inside a QFileDialog so that the use .br .fi .PP -In the above snippet, we create a preview widget which inherits from QLabel and QFilePreview. File preview widgets \fImust\fR inherit from QFilePreview. +In the above snippet, we create a preview widget which inherits from QLabel and TQFilePreview. File preview widgets \fImust\fR inherit from TQFilePreview. .PP -Inside the class we reimplement QFilePreview::previewUrl(), this is where we determine what happens when a file is selected. In the above example we only show a preview of the file if it is a valid pixmap. Here's how to make a file dialog use a preview widget: +Inside the class we reimplement TQFilePreview::previewUrl(), this is where we determine what happens when a file is selected. In the above example we only show a preview of the file if it is a valid pixmap. Here's how to make a file dialog use a preview widget: .PP .nf .br Preview* p = new Preview; .br .br - QFileDialog* fd = new QFileDialog( this ); + TQFileDialog* fd = new TQFileDialog( this ); .br fd->setContentsPreviewEnabled( TRUE ); .br fd->setContentsPreview( p, p ); .br - fd->setPreviewMode( QFileDialog::Contents ); + fd->setPreviewMode( TQFileDialog::Contents ); .br fd->show(); .br @@ -367,7 +367,7 @@ The first line creates an instance of our preview widget. We then create our fil .PP If you create another preview widget that is used for displaying information about a file, create it in the same way as the contents preview widget and call setInfoPreviewEnabled(), and setInfoPreview(). Then the user will be able to switch between the two preview modes. .PP -For more information about creating a QFilePreview widget see QFilePreview. +For more information about creating a TQFilePreview widget see TQFilePreview. .PP .ce 1 .B "[Image Omitted]" @@ -378,53 +378,53 @@ For more information about creating a QFilePreview widget see QFilePreview. .PP See also Dialog Classes. .SS "Member Type Documentation" -.SH "QFileDialog::Mode" +.SH "TQFileDialog::Mode" This enum is used to indicate what the user may select in the file dialog, i.e. what the dialog will return if the user clicks OK. .TP -\fCQFileDialog::AnyFile\fR - The name of a file, whether it exists or not. +\fCTQFileDialog::AnyFile\fR - The name of a file, whether it exists or not. .TP -\fCQFileDialog::ExistingFile\fR - The name of a single existing file. +\fCTQFileDialog::ExistingFile\fR - The name of a single existing file. .TP -\fCQFileDialog::Directory\fR - The name of a directory. Both files and directories are displayed. +\fCTQFileDialog::Directory\fR - The name of a directory. Both files and directories are displayed. .TP -\fCQFileDialog::DirectoryOnly\fR - The name of a directory. The file dialog will only display directories. +\fCTQFileDialog::DirectoryOnly\fR - The name of a directory. The file dialog will only display directories. .TP -\fCQFileDialog::ExistingFiles\fR - The names of zero or more existing files. +\fCTQFileDialog::ExistingFiles\fR - The names of zero or more existing files. .PP See setMode(). -.SH "QFileDialog::PreviewMode" +.SH "TQFileDialog::PreviewMode" This enum describes the preview mode of the file dialog. .TP -\fCQFileDialog::NoPreview\fR - No preview is shown at all. +\fCTQFileDialog::NoPreview\fR - No preview is shown at all. .TP -\fCQFileDialog::Contents\fR - Show a preview of the contents of the current file using the contents preview widget. +\fCTQFileDialog::Contents\fR - Show a preview of the contents of the current file using the contents preview widget. .TP -\fCQFileDialog::Info\fR - Show information about the current file using the info preview widget. +\fCTQFileDialog::Info\fR - Show information about the current file using the info preview widget. .PP See setPreviewMode(), setContentsPreview() and setInfoPreview(). -.SH "QFileDialog::ViewMode" +.SH "TQFileDialog::ViewMode" This enum describes the view mode of the file dialog, i.e. what information about each file will be displayed. .TP -\fCQFileDialog::List\fR - Display file and directory names with icons. +\fCTQFileDialog::List\fR - Display file and directory names with icons. .TP -\fCQFileDialog::Detail\fR - Display file and directory names with icons plus additional information, such as file size and modification date. +\fCTQFileDialog::Detail\fR - Display file and directory names with icons plus additional information, such as file size and modification date. .PP See setViewMode(). .SH MEMBER FUNCTION DOCUMENTATION -.SH "QFileDialog::QFileDialog ( const TQString & dirName, const TQString & filter = TQString::null, TQWidget * parent = 0, const char * name = 0, bool modal = FALSE )" +.SH "TQFileDialog::TQFileDialog ( const TQString & dirName, const TQString & filter = TQString::null, TQWidget * parent = 0, const char * name = 0, bool modal = FALSE )" Constructs a file dialog called \fIname\fR with the parent, \fIparent\fR. If \fImodal\fR is TRUE then the file dialog is modal; otherwise it is modeless. .PP If \fIdirName\fR is specified then it will be used as the dialog's working directory, i.e. it will be the directory that is shown when the dialog appears. If \fIfilter\fR is specified it will be used as the dialog's file filter. -.SH "QFileDialog::QFileDialog ( TQWidget * parent = 0, const char * name = 0, bool modal = FALSE )" +.SH "TQFileDialog::TQFileDialog ( TQWidget * parent = 0, const char * name = 0, bool modal = FALSE )" Constructs a file dialog called \fIname\fR, with the parent, \fIparent\fR. If \fImodal\fR is TRUE then the file dialog is modal; otherwise it is modeless. -.SH "QFileDialog::~QFileDialog ()" +.SH "TQFileDialog::~TQFileDialog ()" Destroys the file dialog. -.SH "void QFileDialog::addFilter ( const TQString & filter )" +.SH "void TQFileDialog::addFilter ( const TQString & filter )" Adds the filter \fIfilter\fR to the list of filters and makes it the current filter. .PP .nf .br - QFileDialog* fd = new QFileDialog( this ); + TQFileDialog* fd = new TQFileDialog( this ); .br fd->addFilter( "Images (*.png *.jpg *.xpm)" ); .br @@ -435,26 +435,26 @@ Adds the filter \fIfilter\fR to the list of filters and makes it the current fil In the above example, a file dialog is created, and the file filter "Images (*.png *.jpg *.xpm)" is added and is set as the current filter. The original filter, "All Files (*)", is still available. .PP See also setFilter() and setFilters(). -.SH "void QFileDialog::addLeftWidget ( TQWidget * w )\fC [protected]\fR" +.SH "void TQFileDialog::addLeftWidget ( TQWidget * w )\fC [protected]\fR" Adds the widget \fIw\fR to the left-hand side of the file dialog. .PP See also addRightWidget(), addWidgets(), and addToolButton(). -.SH "void QFileDialog::addRightWidget ( TQWidget * w )\fC [protected]\fR" +.SH "void TQFileDialog::addRightWidget ( TQWidget * w )\fC [protected]\fR" Adds the widget \fIw\fR to the right-hand side of the file dialog. .PP See also addLeftWidget(), addWidgets(), and addToolButton(). -.SH "void QFileDialog::addToolButton ( QButton * b, bool separator = FALSE )\fC [protected]\fR" +.SH "void TQFileDialog::addToolButton ( QButton * b, bool separator = FALSE )\fC [protected]\fR" Adds the tool button \fIb\fR to the row of tool buttons at the top of the file dialog. The button is appended to the right of this row. If \fIseparator\fR is TRUE, a small space is inserted between the last button of the row and the new button \fIb\fR. .PP See also addWidgets(), addLeftWidget(), and addRightWidget(). -.SH "void QFileDialog::addWidgets ( QLabel * l, TQWidget * w, QPushButton * b )\fC [protected]\fR" +.SH "void TQFileDialog::addWidgets ( QLabel * l, TQWidget * w, QPushButton * b )\fC [protected]\fR" Adds the specified widgets to the bottom of the file dialog. The label \fIl\fR is placed underneath the "file name" and the "file types" labels. The widget \fIw\fR is placed underneath the file types combobox. The button \fIb\fR is placed underneath the Cancel pushbutton. .PP .nf .br MyFileDialog::MyFileDialog( TQWidget* parent, const char* name ) : .br - QFileDialog( parent, name ) + TQFileDialog( parent, name ) .br { .br @@ -476,40 +476,40 @@ If you don't want to have one of the widgets added, pass 0 in that widget's posi Every time you call this function, a new row of widgets will be added to the bottom of the file dialog. .PP See also addToolButton(), addLeftWidget(), and addRightWidget(). -.SH "const QDir * QFileDialog::dir () const" +.SH "const TQDir * TQFileDialog::dir () const" Returns the current directory shown in the file dialog. .PP -The ownership of the QDir pointer is transferred to the caller, so it must be deleted by the caller when no longer required. +The ownership of the TQDir pointer is transferred to the caller, so it must be deleted by the caller when no longer required. .PP See also setDir(). -.SH "void QFileDialog::dirEntered ( const TQString & )\fC [signal]\fR" +.SH "void TQFileDialog::dirEntered ( const TQString & )\fC [signal]\fR" This signal is emitted when the user enters a directory. .PP See also dir(). -.SH "TQString QFileDialog::dirPath () const" +.SH "TQString TQFileDialog::dirPath () const" Returns the file dialog's working directory. See the "dirPath" property for details. -.SH "void QFileDialog::fileHighlighted ( const TQString & )\fC [signal]\fR" +.SH "void TQFileDialog::fileHighlighted ( const TQString & )\fC [signal]\fR" This signal is emitted when the user highlights a file, i.e. makes it the current file. .PP See also fileSelected() and filesSelected(). -.SH "void QFileDialog::fileSelected ( const TQString & )\fC [signal]\fR" +.SH "void TQFileDialog::fileSelected ( const TQString & )\fC [signal]\fR" This signal is emitted when the user selects a file. .PP See also filesSelected(), fileHighlighted(), and selectedFile. -.SH "void QFileDialog::filesSelected ( const TQStringList & )\fC [signal]\fR" +.SH "void TQFileDialog::filesSelected ( const TQStringList & )\fC [signal]\fR" This signal is emitted when the user selects one or more files in \fIExistingFiles\fR mode. .PP See also fileSelected(), fileHighlighted(), and selectedFiles. -.SH "void QFileDialog::filterSelected ( const TQString & )\fC [signal]\fR" +.SH "void TQFileDialog::filterSelected ( const TQString & )\fC [signal]\fR" This signal is emitted when the user selects a filter. .PP See also selectedFilter. -.SH "TQString QFileDialog::getExistingDirectory ( const TQString & dir = TQString::null, TQWidget * parent = 0, const char * name = 0, const TQString & caption = TQString::null, bool dirOnly = TRUE, bool resolveSymlinks = TRUE )\fC [static]\fR" +.SH "TQString TQFileDialog::getExistingDirectory ( const TQString & dir = TQString::null, TQWidget * parent = 0, const char * name = 0, const TQString & caption = TQString::null, bool dirOnly = TRUE, bool resolveSymlinks = TRUE )\fC [static]\fR" This is a convenience static function that will return an existing directory selected by the user. .PP .nf .br - TQString s = QFileDialog::getExistingDirectory( + TQString s = TQFileDialog::getExistingDirectory( .br "/home", .br @@ -533,15 +533,15 @@ If \fIdirOnly\fR is TRUE, then only directories will be shown in the file dialog .PP Under Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if /usr/tmp is a symlink to /var/tmp, the file dialog will change to /var/tmp after entering /usr/tmp. If \fIresolveSymlinks\fR is FALSE, the file dialog will treat symlinks as regular directories. .PP -Under Windows and Mac OS X, this static function will use the native file dialog and not a QFileDialog, unless the style of the application is set to something other than the native style. (Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any TQTimers and if parent is not 0 then it will position the dialog just under the parent's titlebar). +Under Windows and Mac OS X, this static function will use the native file dialog and not a TQFileDialog, unless the style of the application is set to something other than the native style. (Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any TQTimers and if parent is not 0 then it will position the dialog just under the parent's titlebar). .PP See also getOpenFileName(), getOpenFileNames(), and getSaveFileName(). -.SH "TQString QFileDialog::getOpenFileName ( const TQString & startWith = TQString::null, const TQString & filter = TQString::null, TQWidget * parent = 0, const char * name = 0, const TQString & caption = TQString::null, TQString * selectedFilter = 0, bool resolveSymlinks = TRUE )\fC [static]\fR" +.SH "TQString TQFileDialog::getOpenFileName ( const TQString & startWith = TQString::null, const TQString & filter = TQString::null, TQWidget * parent = 0, const char * name = 0, const TQString & caption = TQString::null, TQString * selectedFilter = 0, bool resolveSymlinks = TRUE )\fC [static]\fR" This is a convenience static function that returns an existing file selected by the user. If the user pressed Cancel, it returns a null string. .PP .nf .br - TQString s = QFileDialog::getOpenFileName( + TQString s = TQFileDialog::getOpenFileName( .br "/home", .br @@ -561,7 +561,7 @@ The file dialog's working directory will be set to \fIstartWith\fR. If \fIstartW .PP The dialog's caption is set to \fIcaption\fR. If \fIcaption\fR is not specified then a default caption will be used. .PP -Under Windows and Mac OS X, this static function will use the native file dialog and not a QFileDialog, unless the style of the application is set to something other than the native style (Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any TQTimers and if parent is not 0 then it will position the dialog just under the parent's titlebar). +Under Windows and Mac OS X, this static function will use the native file dialog and not a TQFileDialog, unless the style of the application is set to something other than the native style (Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any TQTimers and if parent is not 0 then it will position the dialog just under the parent's titlebar). .PP Under Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if /usr/tmp is a symlink to /var/tmp, the file dialog will change to /var/tmp after entering /usr/tmp. If \fIresolveSymlinks\fR is FALSE, the file dialog will treat symlinks as regular directories. .PP @@ -569,12 +569,12 @@ See also getOpenFileNames(), getSaveFileName(), and getExistingDirectory(). .PP Examples: .)l action/application.cpp, addressbook/mainwindow.cpp, application/application.cpp, distributor/distributor.ui.h, network/ftpclient/ftpmainwindow.ui.h, qwerty/qwerty.cpp, and showimg/showimg.cpp. -.SH "TQStringList QFileDialog::getOpenFileNames ( const TQString & filter = TQString::null, const TQString & dir = TQString::null, TQWidget * parent = 0, const char * name = 0, const TQString & caption = TQString::null, TQString * selectedFilter = 0, bool resolveSymlinks = TRUE )\fC [static]\fR" +.SH "TQStringList TQFileDialog::getOpenFileNames ( const TQString & filter = TQString::null, const TQString & dir = TQString::null, TQWidget * parent = 0, const char * name = 0, const TQString & caption = TQString::null, TQString * selectedFilter = 0, bool resolveSymlinks = TRUE )\fC [static]\fR" This is a convenience static function that will return one or more existing files selected by the user. .PP .nf .br - TQStringList files = QFileDialog::getOpenFileNames( + TQStringList files = TQFileDialog::getOpenFileNames( .br "Images (*.png *.xpm *.jpg)", .br @@ -594,7 +594,7 @@ The file dialog's working directory will be set to \fIdir\fR. If \fIdir\fR inclu .PP The dialog's caption is set to \fIcaption\fR. If \fIcaption\fR is not specified then a default caption will be used. .PP -Under Windows and Mac OS X, this static function will use the native file dialog and not a QFileDialog, unless the style of the application is set to something other than the native style. (Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any TQTimers and if parent is not 0 then it will position the dialog just under the parent's titlebar). +Under Windows and Mac OS X, this static function will use the native file dialog and not a TQFileDialog, unless the style of the application is set to something other than the native style. (Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any TQTimers and if parent is not 0 then it will position the dialog just under the parent's titlebar). .PP Under Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if /usr/tmp is a symlink to /var/tmp, the file dialog will change to /var/tmp after entering /usr/tmp. If \fIresolveSymlinks\fR is FALSE, the file dialog will treat symlinks as regular directories. .PP @@ -617,14 +617,14 @@ Note that if you want to iterate over the list of files, you should iterate over .fi .PP See also getOpenFileName(), getSaveFileName(), and getExistingDirectory(). -.SH "TQString QFileDialog::getSaveFileName ( const TQString & startWith = TQString::null, const TQString & filter = TQString::null, TQWidget * parent = 0, const char * name = 0, const TQString & caption = TQString::null, TQString * selectedFilter = 0, bool resolveSymlinks = TRUE )\fC [static]\fR" +.SH "TQString TQFileDialog::getSaveFileName ( const TQString & startWith = TQString::null, const TQString & filter = TQString::null, TQWidget * parent = 0, const char * name = 0, const TQString & caption = TQString::null, TQString * selectedFilter = 0, bool resolveSymlinks = TRUE )\fC [static]\fR" This is a convenience static function that will return a file name selected by the user. The file does not have to exist. .PP It creates a modal file dialog called \fIname\fR, with parent, \fIparent\fR. If a parent is not 0, the dialog will be shown centered over the parent. .PP .nf .br - TQString s = QFileDialog::getSaveFileName( + TQString s = TQFileDialog::getSaveFileName( .br "/home", .br @@ -642,7 +642,7 @@ The file dialog's working directory will be set to \fIstartWith\fR. If \fIstartW .PP The dialog's caption is set to \fIcaption\fR. If \fIcaption\fR is not specified then a default caption will be used. .PP -Under Windows and Mac OS X, this static function will use the native file dialog and not a QFileDialog, unless the style of the application is set to something other than the native style. (Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any TQTimers and if parent is not 0 then it will position the dialog just under the parent's titlebar. +Under Windows and Mac OS X, this static function will use the native file dialog and not a TQFileDialog, unless the style of the application is set to something other than the native style. (Note that on Windows the dialog will spin a blocking modal event loop that will not dispatch any TQTimers and if parent is not 0 then it will position the dialog just under the parent's titlebar. .PP Under Unix/X11, the normal behavior of the file dialog is to resolve and follow symlinks. For example, if /usr/tmp is a symlink to /var/tmp, the file dialog will change to /var/tmp after entering /usr/tmp. If \fIresolveSymlinks\fR is FALSE, the file dialog will treat symlinks as regular directories. .PP @@ -650,44 +650,44 @@ See also getOpenFileName(), getOpenFileNames(), and getExistingDirectory(). .PP Examples: .)l action/application.cpp, addressbook/mainwindow.cpp, application/application.cpp, network/ftpclient/ftpmainwindow.ui.h, qmag/qmag.cpp, qwerty/qwerty.cpp, and showimg/showimg.cpp. -.SH "QFileIconProvider * QFileDialog::iconProvider ()\fC [static]\fR" +.SH "TQFileIconProvider * TQFileDialog::iconProvider ()\fC [static]\fR" Returns a pointer to the icon provider currently set on the file dialog. By default there is no icon provider, and this function returns 0. .PP -See also setIconProvider() and QFileIconProvider. -.SH "bool QFileDialog::isContentsPreviewEnabled () const" +See also setIconProvider() and TQFileIconProvider. +.SH "bool TQFileDialog::isContentsPreviewEnabled () const" Returns TRUE if the file dialog can provide a contents preview of the currently selected file; otherwise returns FALSE. See the "contentsPreview" property for details. -.SH "bool QFileDialog::isInfoPreviewEnabled () const" +.SH "bool TQFileDialog::isInfoPreviewEnabled () const" Returns TRUE if the file dialog can provide preview information about the currently selected file; otherwise returns FALSE. See the "infoPreview" property for details. -.SH "Mode QFileDialog::mode () const" +.SH "Mode TQFileDialog::mode () const" Returns the file dialog's mode. See the "mode" property for details. -.SH "PreviewMode QFileDialog::previewMode () const" +.SH "PreviewMode TQFileDialog::previewMode () const" Returns the preview mode for the file dialog. See the "previewMode" property for details. -.SH "void QFileDialog::rereadDir ()" +.SH "void TQFileDialog::rereadDir ()" Rereads the current directory shown in the file dialog. .PP The only time you will need to call this function is if the contents of the directory change and you wish to refresh the file dialog to reflect the change. .PP See also resortDir(). -.SH "void QFileDialog::resortDir ()" +.SH "void TQFileDialog::resortDir ()" Re-sorts the displayed directory. .PP See also rereadDir(). -.SH "void QFileDialog::selectAll ( bool b )" +.SH "void TQFileDialog::selectAll ( bool b )" If \fIb\fR is TRUE then all the files in the current directory are selected; otherwise, they are deselected. -.SH "TQString QFileDialog::selectedFile () const" +.SH "TQString TQFileDialog::selectedFile () const" Returns the name of the selected file. See the "selectedFile" property for details. -.SH "TQStringList QFileDialog::selectedFiles () const" +.SH "TQStringList TQFileDialog::selectedFiles () const" Returns the list of selected files. See the "selectedFiles" property for details. -.SH "TQString QFileDialog::selectedFilter () const" +.SH "TQString TQFileDialog::selectedFilter () const" Returns the filter which the user has selected in the file dialog. See the "selectedFilter" property for details. -.SH "void QFileDialog::setContentsPreview ( TQWidget * w, QFilePreview * preview )" -Sets the widget to be used for displaying the contents of the file to the widget \fIw\fR and a preview of those contents to the QFilePreview \fIpreview\fR. +.SH "void TQFileDialog::setContentsPreview ( TQWidget * w, TQFilePreview * preview )" +Sets the widget to be used for displaying the contents of the file to the widget \fIw\fR and a preview of those contents to the TQFilePreview \fIpreview\fR. .PP -Normally you would create a preview widget that derives from both TQWidget and QFilePreview, so you should pass the same widget twice. If you don't, you must remember to delete the preview object in order to avoid memory leaks. +Normally you would create a preview widget that derives from both TQWidget and TQFilePreview, so you should pass the same widget twice. If you don't, you must remember to delete the preview object in order to avoid memory leaks. .PP .nf .br - class Preview : public QLabel, public QFilePreview + class Preview : public QLabel, public TQFilePreview .br { .br @@ -696,7 +696,7 @@ Normally you would create a preview widget that derives from both TQWidget and Q Preview( TQWidget *parent=0 ) : QLabel( parent ) {} .br .br - void previewUrl( const QUrl &u ) + void previewUrl( const TQUrl &u ) .br { .br @@ -727,13 +727,13 @@ Normally you would create a preview widget that derives from both TQWidget and Q Preview* p = new Preview; .br .br - QFileDialog* fd = new QFileDialog( this ); + TQFileDialog* fd = new TQFileDialog( this ); .br fd->setContentsPreviewEnabled( TRUE ); .br fd->setContentsPreview( p, p ); .br - fd->setPreviewMode( QFileDialog::Contents ); + fd->setPreviewMode( TQFileDialog::Contents ); .br fd->show(); .br @@ -743,20 +743,20 @@ Normally you would create a preview widget that derives from both TQWidget and Q .PP See also contentsPreview, setInfoPreview(), and previewMode. .PP -Example: qdir/qdir.cpp. -.SH "void QFileDialog::setContentsPreviewEnabled ( bool )" +Example: tqdir/tqdir.cpp. +.SH "void TQFileDialog::setContentsPreviewEnabled ( bool )" Sets whether the file dialog can provide a contents preview of the currently selected file. See the "contentsPreview" property for details. -.SH "void QFileDialog::setDir ( const QDir & dir )" +.SH "void TQFileDialog::setDir ( const TQDir & dir )" Sets the file dialog's working directory to \fIdir\fR. .PP See also dir(). -.SH "void QFileDialog::setDir ( const TQString & pathstr )\fC [slot]\fR" +.SH "void TQFileDialog::setDir ( const TQString & pathstr )\fC [slot]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Sets the file dialog's working directory to \fIpathstr\fR. .PP See also dir(). -.SH "void QFileDialog::setFilter ( const TQString & newFilter )\fC [slot]\fR" +.SH "void TQFileDialog::setFilter ( const TQString & newFilter )\fC [slot]\fR" Sets the filter used in the file dialog to \fInewFilter\fR. .PP If \fInewFilter\fR contains a pair of parentheses containing one or more of \fI\fBanything*something\fR\fR separated by spaces or by semi-colons then only the text contained in the parentheses is used as the filter. This means that these calls are all equivalent: @@ -774,7 +774,7 @@ If \fInewFilter\fR contains a pair of parentheses containing one or more of \fI\ .fi .PP See also setFilters(). -.SH "void QFileDialog::setFilters ( const TQString & filters )\fC [slot]\fR" +.SH "void TQFileDialog::setFilters ( const TQString & filters )\fC [slot]\fR" Sets the filters used in the file dialog to \fIfilters\fR. Each group of filters must be separated by \fC;;\fR (\fItwo\fR semi-colons). .PP .nf @@ -785,35 +785,35 @@ Sets the filters used in the file dialog to \fIfilters\fR. Each group of filters .br "Any files (*)"); .br - QFileDialog fd = new QFileDialog( this ); + TQFileDialog fd = new TQFileDialog( this ); .br fd->setFilters( types ); .br fd->show(); .br .fi -.SH "void QFileDialog::setFilters ( const char ** types )\fC [slot]\fR" +.SH "void TQFileDialog::setFilters ( const char ** types )\fC [slot]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP \fItypes\fR must be a null-terminated list of strings. -.SH "void QFileDialog::setFilters ( const TQStringList & )\fC [slot]\fR" +.SH "void TQFileDialog::setFilters ( const TQStringList & )\fC [slot]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -.SH "void QFileDialog::setIconProvider ( QFileIconProvider * provider )\fC [static]\fR" -Sets the QFileIconProvider used by the file dialog to \fIprovider\fR. +.SH "void TQFileDialog::setIconProvider ( TQFileIconProvider * provider )\fC [static]\fR" +Sets the TQFileIconProvider used by the file dialog to \fIprovider\fR. .PP -The default is that there is no QFileIconProvider and QFileDialog just draws a folder icon next to each directory and nothing next to files. +The default is that there is no TQFileIconProvider and TQFileDialog just draws a folder icon next to each directory and nothing next to files. .PP -See also QFileIconProvider and iconProvider(). +See also TQFileIconProvider and iconProvider(). .PP Example: showimg/main.cpp. -.SH "void QFileDialog::setInfoPreview ( TQWidget * w, QFilePreview * preview )" -Sets the widget to be used for displaying information about the file to the widget \fIw\fR and a preview of that information to the QFilePreview \fIpreview\fR. +.SH "void TQFileDialog::setInfoPreview ( TQWidget * w, TQFilePreview * preview )" +Sets the widget to be used for displaying information about the file to the widget \fIw\fR and a preview of that information to the TQFilePreview \fIpreview\fR. .PP -Normally you would create a preview widget that derives from both TQWidget and QFilePreview, so you should pass the same widget twice. If you don't, you must remember to delete the preview object in order to avoid memory leaks. +Normally you would create a preview widget that derives from both TQWidget and TQFilePreview, so you should pass the same widget twice. If you don't, you must remember to delete the preview object in order to avoid memory leaks. .PP .nf .br - class Preview : public QLabel, public QFilePreview + class Preview : public QLabel, public TQFilePreview .br { .br @@ -822,7 +822,7 @@ Normally you would create a preview widget that derives from both TQWidget and Q Preview( TQWidget *parent=0 ) : QLabel( parent ) {} .br .br - void previewUrl( const QUrl &u ) + void previewUrl( const TQUrl &u ) .br { .br @@ -853,13 +853,13 @@ Normally you would create a preview widget that derives from both TQWidget and Q Preview* p = new Preview; .br .br - QFileDialog* fd = new QFileDialog( this ); + TQFileDialog* fd = new TQFileDialog( this ); .br fd->setInfoPreviewEnabled( TRUE ); .br fd->setInfoPreview( p, p ); .br - fd->setPreviewMode( QFileDialog::Info ); + fd->setPreviewMode( TQFileDialog::Info ); .br fd->show(); .br @@ -869,41 +869,41 @@ Normally you would create a preview widget that derives from both TQWidget and Q .fi .PP See also setContentsPreview(), infoPreview, and previewMode. -.SH "void QFileDialog::setInfoPreviewEnabled ( bool )" +.SH "void TQFileDialog::setInfoPreviewEnabled ( bool )" Sets whether the file dialog can provide preview information about the currently selected file. See the "infoPreview" property for details. -.SH "void QFileDialog::setMode ( Mode )" +.SH "void TQFileDialog::setMode ( Mode )" Sets the file dialog's mode. See the "mode" property for details. -.SH "void QFileDialog::setPreviewMode ( PreviewMode m )" +.SH "void TQFileDialog::setPreviewMode ( PreviewMode m )" Sets the preview mode for the file dialog to \fIm\fR. See the "previewMode" property for details. -.SH "void QFileDialog::setSelectedFilter ( const TQString & mask )\fC [virtual]\fR" +.SH "void TQFileDialog::setSelectedFilter ( const TQString & mask )\fC [virtual]\fR" Sets the current filter selected in the file dialog to the first one that contains the text \fImask\fR. -.SH "void QFileDialog::setSelectedFilter ( int n )\fC [virtual]\fR" +.SH "void TQFileDialog::setSelectedFilter ( int n )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Sets the current filter selected in the file dialog to the \fIn\fR-th filter in the filter list. .PP See also filterSelected(), selectedFilter, selectedFiles, and selectedFile. -.SH "void QFileDialog::setSelection ( const TQString & filename )" +.SH "void TQFileDialog::setSelection ( const TQString & filename )" Sets the default selection to \fIfilename\fR. If \fIfilename\fR is absolute, setDir() is also called to set the file dialog's working directory to the filename's directory. .PP -Example: qdir/qdir.cpp. -.SH "void QFileDialog::setShowHiddenFiles ( bool s )" +Example: tqdir/tqdir.cpp. +.SH "void TQFileDialog::setShowHiddenFiles ( bool s )" Sets whether hidden files are shown in the file dialog to \fIs\fR. See the "showHiddenFiles" property for details. -.SH "void QFileDialog::setUrl ( const QUrlOperator & url )\fC [slot]\fR" +.SH "void TQFileDialog::setUrl ( const TQUrlOperator & url )\fC [slot]\fR" Sets the file dialog's working directory to the directory specified at \fIurl\fR. .PP See also url(). -.SH "void QFileDialog::setViewMode ( ViewMode m )" +.SH "void TQFileDialog::setViewMode ( ViewMode m )" Sets the file dialog's view mode to \fIm\fR. See the "viewMode" property for details. -.SH "bool QFileDialog::showHiddenFiles () const" +.SH "bool TQFileDialog::showHiddenFiles () const" Returns TRUE if hidden files are shown in the file dialog; otherwise returns FALSE. See the "showHiddenFiles" property for details. -.SH "QUrl QFileDialog::url () const" +.SH "TQUrl TQFileDialog::url () const" Returns the URL of the current working directory in the file dialog. .PP See also setUrl(). .PP Example: network/networkprotocol/view.cpp. -.SH "ViewMode QFileDialog::viewMode () const" +.SH "ViewMode TQFileDialog::viewMode () const" Returns the file dialog's view mode. See the "viewMode" property for details. .SS "Property Documentation" .SH "bool contentsPreview" @@ -995,12 +995,12 @@ If you set the view mode to be \fIDetail\fR (the default), then you will see the .PP If you set the view mode to be \fIList\fR, then you will just see a list of the files and folders. .PP -See QFileDialog::ViewMode +See TQFileDialog::ViewMode .PP Set this property's value with setViewMode() and get this property's value with viewMode(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqfiledialog.html +.BR http://doc.trolltech.com/tqfiledialog.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqfileiconprovider.3qt b/doc/man/man3/tqfileiconprovider.3qt index 142565242..2f4a2b9e0 100644 --- a/doc/man/man3/tqfileiconprovider.3qt +++ b/doc/man/man3/tqfileiconprovider.3qt @@ -1,5 +1,5 @@ '\" t -.TH QFileIconProvider 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQFileIconProvider 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,43 +7,43 @@ .ad l .nh .SH NAME -QFileIconProvider \- Icons for QFileDialog to use +TQFileIconProvider \- Icons for TQFileDialog to use .SH SYNOPSIS -\fC#include <ntqfiledialog.h>\fR +\fC#include <tqfiledialog.h>\fR .PP Inherits TQObject. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQFileIconProvider\fR ( TQObject * parent = 0, const char * name = 0 )" +.BI "\fBTQFileIconProvider\fR ( TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "virtual const QPixmap * \fBpixmap\fR ( const QFileInfo & info )" +.BI "virtual const QPixmap * \fBpixmap\fR ( const TQFileInfo & info )" .br .in -1c .SH DESCRIPTION -The QFileIconProvider class provides icons for QFileDialog to use. +The TQFileIconProvider class provides icons for TQFileDialog to use. .PP -By default QFileIconProvider is not used, but any application or library can subclass it, reimplement pixmap() to return a suitable icon, and make all QFileDialog objects use it by calling the static function QFileDialog::setIconProvider(). +By default TQFileIconProvider is not used, but any application or library can subclass it, reimplement pixmap() to return a suitable icon, and make all TQFileDialog objects use it by calling the static function TQFileDialog::setIconProvider(). .PP -It is advisable to make all the icons that QFileIconProvider returns be the same size or at least the same width. This makes the list view look much better. +It is advisable to make all the icons that TQFileIconProvider returns be the same size or at least the same width. This makes the list view look much better. .PP -See also QFileDialog and Miscellaneous Classes. +See also TQFileDialog and Miscellaneous Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QFileIconProvider::QFileIconProvider ( TQObject * parent = 0, const char * name = 0 )" +.SH "TQFileIconProvider::TQFileIconProvider ( TQObject * parent = 0, const char * name = 0 )" Constructs an empty file icon provider called \fIname\fR, with the parent \fIparent\fR. -.SH "const QPixmap * QFileIconProvider::pixmap ( const QFileInfo & info )\fC [virtual]\fR" +.SH "const QPixmap * TQFileIconProvider::pixmap ( const TQFileInfo & info )\fC [virtual]\fR" Returns a pointer to a pixmap that should be used to signify the file with the information \fIinfo\fR. .PP -If pixmap() returns 0, QFileDialog draws the default pixmap. +If pixmap() returns 0, TQFileDialog draws the default pixmap. .PP The default implementation returns particular icons for files, directories, link-files and link-directories. It returns a blank "icon" for other types. .PP If you return a pixmap here, it should measure 16x16 pixels. .SH "SEE ALSO" -.BR http://doc.trolltech.com/qfileiconprovider.html +.BR http://doc.trolltech.com/tqfileiconprovider.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqfileinfo.3qt b/doc/man/man3/tqfileinfo.3qt index fec4426a6..7be7afdb6 100644 --- a/doc/man/man3/tqfileinfo.3qt +++ b/doc/man/man3/tqfileinfo.3qt @@ -1,5 +1,5 @@ '\" t -.TH QFileInfo 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQFileInfo 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,11 +7,11 @@ .ad l .nh .SH NAME -QFileInfo \- System-independent file information +TQFileInfo \- System-independent file information .SH SYNOPSIS All the functions in this class are reentrant when TQt is built with thread support.</p> .PP -\fC#include <ntqfileinfo.h>\fR +\fC#include <tqfileinfo.h>\fR .PP .SS "Public Members" .in +1c @@ -19,34 +19,34 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "enum \fBPermissionSpec\fR { ReadOwner = 04000, WriteOwner = 02000, ExeOwner = 01000, ReadUser = 00400, WriteUser = 00200, ExeUser = 00100, ReadGroup = 00040, WriteGroup = 00020, ExeGroup = 00010, ReadOther = 00004, WriteOther = 00002, ExeOther = 00001 }" .br .ti -1c -.BI "\fBQFileInfo\fR ()" +.BI "\fBTQFileInfo\fR ()" .br .ti -1c -.BI "\fBQFileInfo\fR ( const TQString & file )" +.BI "\fBTQFileInfo\fR ( const TQString & file )" .br .ti -1c -.BI "\fBQFileInfo\fR ( const QFile & file )" +.BI "\fBTQFileInfo\fR ( const TQFile & file )" .br .ti -1c -.BI "\fBQFileInfo\fR ( const QDir & d, const TQString & fileName )" +.BI "\fBTQFileInfo\fR ( const TQDir & d, const TQString & fileName )" .br .ti -1c -.BI "\fBQFileInfo\fR ( const QFileInfo & fi )" +.BI "\fBTQFileInfo\fR ( const TQFileInfo & fi )" .br .ti -1c -.BI "\fB~QFileInfo\fR ()" +.BI "\fB~TQFileInfo\fR ()" .br .ti -1c -.BI "QFileInfo & \fBoperator=\fR ( const QFileInfo & fi )" +.BI "TQFileInfo & \fBoperator=\fR ( const TQFileInfo & fi )" .br .ti -1c .BI "void \fBsetFile\fR ( const TQString & file )" .br .ti -1c -.BI "void \fBsetFile\fR ( const QFile & file )" +.BI "void \fBsetFile\fR ( const TQFile & file )" .br .ti -1c -.BI "void \fBsetFile\fR ( const QDir & d, const TQString & fileName )" +.BI "void \fBsetFile\fR ( const TQDir & d, const TQString & fileName )" .br .ti -1c .BI "bool \fBexists\fR () const" @@ -79,7 +79,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "TQString \fBdirPath\fR ( bool absPath = FALSE ) const" .br .ti -1c -.BI "QDir \fBdir\fR ( bool absPath = FALSE ) const" +.BI "TQDir \fBdir\fR ( bool absPath = FALSE ) const" .br .ti -1c .BI "bool \fBisReadable\fR () const" @@ -140,15 +140,15 @@ All the functions in this class are reentrant when TQt is built with thread supp .br .in -1c .SH DESCRIPTION -The QFileInfo class provides system-independent file information. +The TQFileInfo class provides system-independent file information. .PP -QFileInfo provides information about a file's name and position (path) in the file system, its access rights and whether it is a directory or symbolic link, etc. The file's size and last modified/read times are also available. +TQFileInfo provides information about a file's name and position (path) in the file system, its access rights and whether it is a directory or symbolic link, etc. The file's size and last modified/read times are also available. .PP -A QFileInfo can point to a file with either a relative or an absolute file path. Absolute file paths begin with the directory separator "/" (or with a drive specification on Windows). Relative file names begin with a directory name or a file name and specify a path relative to the current working directory. An example of an absolute path is the string "/tmp/quartz". A relative path might look like "src/fatlib". You can use the function isRelative() to check whether a QFileInfo is using a relative or an absolute file path. You can call the function convertToAbs() to convert a relative QFileInfo's path to an absolute path. +A TQFileInfo can point to a file with either a relative or an absolute file path. Absolute file paths begin with the directory separator "/" (or with a drive specification on Windows). Relative file names begin with a directory name or a file name and specify a path relative to the current working directory. An example of an absolute path is the string "/tmp/quartz". A relative path might look like "src/fatlib". You can use the function isRelative() to check whether a TQFileInfo is using a relative or an absolute file path. You can call the function convertToAbs() to convert a relative TQFileInfo's path to an absolute path. .PP -The file that the QFileInfo works on is set in the constructor or later with setFile(). Use exists() to see if the file exists and size() to get its size. +The file that the TQFileInfo works on is set in the constructor or later with setFile(). Use exists() to see if the file exists and size() to get its size. .PP -To speed up performance, QFileInfo caches information about the file. Because files can be changed by other users or programs, or even by other parts of the same program, there is a function that refreshes the file information: refresh(). If you want to switch off a QFileInfo's caching and force it to access the file system every time you request information from it call setCaching(FALSE). +To speed up performance, TQFileInfo caches information about the file. Because files can be changed by other users or programs, or even by other parts of the same program, there is a function that refreshes the file information: refresh(). If you want to switch off a TQFileInfo's caching and force it to access the file system every time you request information from it call setCaching(FALSE). .PP The file's type is obtained with isFile(), isDir() and isSymLink(). The readLink() function provides the name of the file the symlink points to. .PP @@ -156,79 +156,79 @@ Elements of the file's name can be extracted with dirPath() and fileName(). The .PP The file's dates are returned by created(), lastModified() and lastRead(). Information about the file's access permissions is obtained with isReadable(), isWritable() and isExecutable(). The file's ownership is available from owner(), ownerId(), group() and groupId(). You can examine a file's permissions and ownership in a single statement using the permission() function. .PP -If you need to read and traverse directories, see the QDir class. +If you need to read and traverse directories, see the TQDir class. .PP See also Input/Output and Networking. .SS "Member Type Documentation" -.SH "QFileInfo::PermissionSpec" +.SH "TQFileInfo::PermissionSpec" This enum is used by the permission() function to report the permissions and ownership of a file. The values may be OR-ed together to test multiple permissions and ownership values. .TP -\fCQFileInfo::ReadOwner\fR - The file is readable by the owner of the file. +\fCTQFileInfo::ReadOwner\fR - The file is readable by the owner of the file. .TP -\fCQFileInfo::WriteOwner\fR - The file is writable by the owner of the file. +\fCTQFileInfo::WriteOwner\fR - The file is writable by the owner of the file. .TP -\fCQFileInfo::ExeOwner\fR - The file is executable by the owner of the file. +\fCTQFileInfo::ExeOwner\fR - The file is executable by the owner of the file. .TP -\fCQFileInfo::ReadUser\fR - The file is readable by the user. +\fCTQFileInfo::ReadUser\fR - The file is readable by the user. .TP -\fCQFileInfo::WriteUser\fR - The file is writable by the user. +\fCTQFileInfo::WriteUser\fR - The file is writable by the user. .TP -\fCQFileInfo::ExeUser\fR - The file is executable by the user. +\fCTQFileInfo::ExeUser\fR - The file is executable by the user. .TP -\fCQFileInfo::ReadGroup\fR - The file is readable by the group. +\fCTQFileInfo::ReadGroup\fR - The file is readable by the group. .TP -\fCQFileInfo::WriteGroup\fR - The file is writable by the group. +\fCTQFileInfo::WriteGroup\fR - The file is writable by the group. .TP -\fCQFileInfo::ExeGroup\fR - The file is executable by the group. +\fCTQFileInfo::ExeGroup\fR - The file is executable by the group. .TP -\fCQFileInfo::ReadOther\fR - The file is readable by anyone. +\fCTQFileInfo::ReadOther\fR - The file is readable by anyone. .TP -\fCQFileInfo::WriteOther\fR - The file is writable by anyone. +\fCTQFileInfo::WriteOther\fR - The file is writable by anyone. .TP -\fCQFileInfo::ExeOther\fR - The file is executable by anyone. +\fCTQFileInfo::ExeOther\fR - The file is executable by anyone. .PP \fBWarning:\fR The semantics of ReadUser, WriteUser and ExeUser are unfortunately not platform independent: on Unix, the rights of the owner of the file are returned and on Windows the rights of the current user are returned. This behavior might change in a future TQt version. If you want to find the rights of the owner of the file, you should use the flags ReadOwner, WriteOwner and ExeOwner. If you want to find out the rights of the current user, you should use isReadable(), isWritable() and isExecutable(). .SH MEMBER FUNCTION DOCUMENTATION -.SH "QFileInfo::QFileInfo ()" -Constructs a new empty QFileInfo. -.SH "QFileInfo::QFileInfo ( const TQString & file )" -Constructs a new QFileInfo that gives information about the given file. The \fIfile\fR can also include an absolute or relative path. +.SH "TQFileInfo::TQFileInfo ()" +Constructs a new empty TQFileInfo. +.SH "TQFileInfo::TQFileInfo ( const TQString & file )" +Constructs a new TQFileInfo that gives information about the given file. The \fIfile\fR can also include an absolute or relative path. .PP \fBWarning:\fR Some functions might behave in a counter-intuitive way if \fIfile\fR has a trailing directory separator. .PP -See also setFile(), isRelative(), QDir::setCurrent(), and QDir::isRelativePath(). -.SH "QFileInfo::QFileInfo ( const QFile & file )" -Constructs a new QFileInfo that gives information about file \fIfile\fR. +See also setFile(), isRelative(), TQDir::setCurrent(), and TQDir::isRelativePath(). +.SH "TQFileInfo::TQFileInfo ( const TQFile & file )" +Constructs a new TQFileInfo that gives information about file \fIfile\fR. .PP -If the \fIfile\fR has a relative path, the QFileInfo will also have a relative path. +If the \fIfile\fR has a relative path, the TQFileInfo will also have a relative path. .PP See also isRelative(). -.SH "QFileInfo::QFileInfo ( const QDir & d, const TQString & fileName )" -Constructs a new QFileInfo that gives information about the file called \fIfileName\fR in the directory \fId\fR. +.SH "TQFileInfo::TQFileInfo ( const TQDir & d, const TQString & fileName )" +Constructs a new TQFileInfo that gives information about the file called \fIfileName\fR in the directory \fId\fR. .PP -If \fId\fR has a relative path, the QFileInfo will also have a relative path. +If \fId\fR has a relative path, the TQFileInfo will also have a relative path. .PP See also isRelative(). -.SH "QFileInfo::QFileInfo ( const QFileInfo & fi )" -Constructs a new QFileInfo that is a copy of \fIfi\fR. -.SH "QFileInfo::~QFileInfo ()" -Destroys the QFileInfo and frees its resources. -.SH "TQString QFileInfo::absFilePath () const" +.SH "TQFileInfo::TQFileInfo ( const TQFileInfo & fi )" +Constructs a new TQFileInfo that is a copy of \fIfi\fR. +.SH "TQFileInfo::~TQFileInfo ()" +Destroys the TQFileInfo and frees its resources. +.SH "TQString TQFileInfo::absFilePath () const" Returns the absolute path including the file name. .PP The absolute path name consists of the full path and the file name. On Unix this will always begin with the root, '/', directory. On Windows this will always begin 'D:/' where D is a drive letter, except for network shares that are not mapped to a drive letter, in which case the path will begin '//sharename/'. .PP This function returns the same as filePath(), unless isRelative() is TRUE. .PP -If the QFileInfo is empty it returns QDir::currentDirPath(). +If the TQFileInfo is empty it returns TQDir::currentDirPath(). .PP This function can be time consuming under Unix (in the order of milliseconds). .PP See also isRelative() and filePath(). .PP Examples: -.)l biff/biff.cpp and fileiconview/qfileiconview.cpp. -.SH "TQString QFileInfo::baseName ( bool complete = FALSE ) const" +.)l biff/biff.cpp and fileiconview/tqfileiconview.cpp. +.SH "TQString TQFileInfo::baseName ( bool complete = FALSE ) const" Returns the base name of the file. .PP If \fIcomplete\fR is FALSE (the default) the base name consists of all characters in the file name up to (but not including) the \fIfirst\fR '.' character. @@ -241,7 +241,7 @@ Example: .PP .nf .br - QFileInfo fi( "/tmp/archive.tar.gz" ); + TQFileInfo fi( "/tmp/archive.tar.gz" ); .br TQString base = fi.baseName(); // base = "archive" .br @@ -250,44 +250,44 @@ Example: .fi .PP See also fileName() and extension(). -.SH "bool QFileInfo::caching () const" +.SH "bool TQFileInfo::caching () const" Returns TRUE if caching is enabled; otherwise returns FALSE. .PP See also setCaching() and refresh(). -.SH "bool QFileInfo::convertToAbs ()" +.SH "bool TQFileInfo::convertToAbs ()" Converts the file's path to an absolute path. .PP If it is already absolute, nothing is done. .PP See also filePath() and isRelative(). -.SH "TQDateTime QFileInfo::created () const" +.SH "TQDateTime TQFileInfo::created () const" Returns the date and time when the file was created. .PP On platforms where this information is not available, returns the same as lastModified(). .PP See also lastModified() and lastRead(). -.SH "QDir QFileInfo::dir ( bool absPath = FALSE ) const" -Returns the file's path as a QDir object. +.SH "TQDir TQFileInfo::dir ( bool absPath = FALSE ) const" +Returns the file's path as a TQDir object. .PP -If the QFileInfo is relative and \fIabsPath\fR is FALSE, the QDir will be relative; otherwise it will be absolute. +If the TQFileInfo is relative and \fIabsPath\fR is FALSE, the TQDir will be relative; otherwise it will be absolute. .PP See also dirPath(), filePath(), fileName(), and isRelative(). .PP -Example: fileiconview/qfileiconview.cpp. -.SH "TQString QFileInfo::dirPath ( bool absPath = FALSE ) const" +Example: fileiconview/tqfileiconview.cpp. +.SH "TQString TQFileInfo::dirPath ( bool absPath = FALSE ) const" Returns the file's path. .PP If \fIabsPath\fR is TRUE an absolute path is returned. .PP See also dir(), filePath(), fileName(), and isRelative(). .PP -Example: fileiconview/qfileiconview.cpp. -.SH "bool QFileInfo::exists () const" +Example: fileiconview/tqfileiconview.cpp. +.SH "bool TQFileInfo::exists () const" Returns TRUE if the file exists; otherwise returns FALSE. .PP Examples: .)l biff/biff.cpp, distributor/distributor.ui.h, and i18n/main.cpp. -.SH "TQString QFileInfo::extension ( bool complete = TRUE ) const" +.SH "TQString TQFileInfo::extension ( bool complete = TRUE ) const" Returns the file's extension name. .PP If \fIcomplete\fR is TRUE (the default), extension() returns the string of all characters in the file name after (but not including) the first '.' character. @@ -298,7 +298,7 @@ Example: .PP .nf .br - QFileInfo fi( "/tmp/archive.tar.gz" ); + TQFileInfo fi( "/tmp/archive.tar.gz" ); .br TQString ext = fi.extension(); // ext = "tar.gz" .br @@ -308,15 +308,15 @@ Example: .PP See also fileName() and baseName(). .PP -Example: qdir/qdir.cpp. -.SH "TQString QFileInfo::fileName () const" +Example: tqdir/tqdir.cpp. +.SH "TQString TQFileInfo::fileName () const" Returns the name of the file, excluding the path. .PP Example: .PP .nf .br - QFileInfo fi( "/tmp/archive.tar.gz" ); + TQFileInfo fi( "/tmp/archive.tar.gz" ); .br TQString name = fi.fileName(); // name = "archive.tar.gz" .br @@ -325,76 +325,76 @@ Example: See also isRelative(), filePath(), baseName(), and extension(). .PP Examples: -.)l dirview/dirview.cpp, fileiconview/qfileiconview.cpp, and network/ftpclient/ftpmainwindow.ui.h. -.SH "TQString QFileInfo::filePath () const" +.)l dirview/dirview.cpp, fileiconview/tqfileiconview.cpp, and network/ftpclient/ftpmainwindow.ui.h. +.SH "TQString TQFileInfo::filePath () const" Returns the file name, including the path (which may be absolute or relative). .PP See also isRelative() and absFilePath(). .PP Examples: -.)l dirview/main.cpp and fileiconview/qfileiconview.cpp. -.SH "TQString QFileInfo::group () const" +.)l dirview/main.cpp and fileiconview/tqfileiconview.cpp. +.SH "TQString TQFileInfo::group () const" Returns the group of the file. On Windows, on systems where files do not have groups, or if an error occurs, TQString::null is returned. .PP This function can be time consuming under Unix (in the order of milliseconds). .PP See also groupId(), owner(), and ownerId(). -.SH "uint QFileInfo::groupId () const" +.SH "uint TQFileInfo::groupId () const" Returns the id of the group the file belongs to. .PP On Windows and on systems where files do not have groups this function always returns (uint) -2. .PP See also group(), owner(), and ownerId(). -.SH "bool QFileInfo::isDir () const" +.SH "bool TQFileInfo::isDir () const" Returns TRUE if this object points to a directory or to a symbolic link to a directory; otherwise returns FALSE. .PP See also isFile() and isSymLink(). .PP Examples: -.)l dirview/dirview.cpp and fileiconview/qfileiconview.cpp. -.SH "bool QFileInfo::isExecutable () const" +.)l dirview/dirview.cpp and fileiconview/tqfileiconview.cpp. +.SH "bool TQFileInfo::isExecutable () const" Returns TRUE if the file is executable; otherwise returns FALSE. .PP See also isReadable(), isWritable(), and permission(). -.SH "bool QFileInfo::isFile () const" +.SH "bool TQFileInfo::isFile () const" Returns TRUE if this object points to a file. Returns FALSE if the object points to something which isn't a file, e.g. a directory or a symlink. .PP See also isDir() and isSymLink(). .PP Examples: -.)l dirview/dirview.cpp, distributor/distributor.ui.h, fileiconview/qfileiconview.cpp, and qdir/qdir.cpp. -.SH "bool QFileInfo::isHidden () const" +.)l dirview/dirview.cpp, distributor/distributor.ui.h, fileiconview/tqfileiconview.cpp, and tqdir/tqdir.cpp. +.SH "bool TQFileInfo::isHidden () const" Returns TRUE if the file is hidden; otherwise returns FALSE. .PP On Unix-like operating systems, including Mac OS X, a file is hidden if its name begins with ".". On Windows a file is hidden if its hidden attribute is set. -.SH "bool QFileInfo::isReadable () const" +.SH "bool TQFileInfo::isReadable () const" Returns TRUE if the file is readable; otherwise returns FALSE. .PP See also isWritable(), isExecutable(), and permission(). .PP Example: distributor/distributor.ui.h. -.SH "bool QFileInfo::isRelative () const" +.SH "bool TQFileInfo::isRelative () const" Returns TRUE if the file path name is relative. Returns FALSE if the path is absolute (e.g. under Unix a path is absolute if it begins with a "/"). -.SH "bool QFileInfo::isSymLink () const" +.SH "bool TQFileInfo::isSymLink () const" Returns TRUE if this object points to a symbolic link (or to a shortcut on Windows, or an alias on Mac OS X); otherwise returns FALSE. .PP See also isFile(), isDir(), and readLink(). .PP Examples: -.)l dirview/dirview.cpp, distributor/distributor.ui.h, and fileiconview/qfileiconview.cpp. -.SH "bool QFileInfo::isWritable () const" +.)l dirview/dirview.cpp, distributor/distributor.ui.h, and fileiconview/tqfileiconview.cpp. +.SH "bool TQFileInfo::isWritable () const" Returns TRUE if the file is writable; otherwise returns FALSE. .PP See also isReadable(), isExecutable(), and permission(). .PP Example: distributor/distributor.ui.h. -.SH "TQDateTime QFileInfo::lastModified () const" +.SH "TQDateTime TQFileInfo::lastModified () const" Returns the date and time when the file was last modified. .PP See also created() and lastRead(). .PP Example: biff/biff.cpp. -.SH "TQDateTime QFileInfo::lastRead () const" +.SH "TQDateTime TQFileInfo::lastRead () const" Returns the date and time when the file was last read (accessed). .PP On platforms where this information is not available, returns the same as lastModified(). @@ -402,21 +402,21 @@ On platforms where this information is not available, returns the same as lastMo See also created() and lastModified(). .PP Example: biff/biff.cpp. -.SH "QFileInfo & QFileInfo::operator= ( const QFileInfo & fi )" -Makes a copy of \fIfi\fR and assigns it to this QFileInfo. -.SH "TQString QFileInfo::owner () const" +.SH "TQFileInfo & TQFileInfo::operator= ( const TQFileInfo & fi )" +Makes a copy of \fIfi\fR and assigns it to this TQFileInfo. +.SH "TQString TQFileInfo::owner () const" Returns the owner of the file. On systems where files do not have owners, or if an error occurs, TQString::null is returned. .PP This function can be time consuming under Unix (in the order of milliseconds). .PP See also ownerId(), group(), and groupId(). -.SH "uint QFileInfo::ownerId () const" +.SH "uint TQFileInfo::ownerId () const" Returns the id of the owner of the file. .PP On Windows and on systems where files do not have owners this function returns ((uint) -2). .PP See also owner(), group(), and groupId(). -.SH "bool QFileInfo::permission ( int permissionSpec ) const" +.SH "bool TQFileInfo::permission ( int permissionSpec ) const" Tests for file permissions. The \fIpermissionSpec\fR argument can be several flags of type PermissionSpec OR-ed together to check for permission combinations. .PP On systems where files do not have permissions this function always returns TRUE. @@ -425,39 +425,39 @@ Example: .PP .nf .br - QFileInfo fi( "/tmp/archive.tar.gz" ); + TQFileInfo fi( "/tmp/archive.tar.gz" ); .br - if ( fi.permission( QFileInfo::WriteUser | QFileInfo::ReadGroup ) ) + if ( fi.permission( TQFileInfo::WriteUser | TQFileInfo::ReadGroup ) ) .br tqWarning( "I can change the file; my group can read the file" ); .br - if ( fi.permission( QFileInfo::WriteGroup | QFileInfo::WriteOther ) ) + if ( fi.permission( TQFileInfo::WriteGroup | TQFileInfo::WriteOther ) ) .br tqWarning( "The group or others can change the file" ); .br .fi .PP See also isReadable(), isWritable(), and isExecutable(). -.SH "TQString QFileInfo::readLink () const" +.SH "TQString TQFileInfo::readLink () const" Returns the name a symlink (or shortcut on Windows) points to, or a TQString::null if the object isn't a symbolic link. .PP -This name may not represent an existing file; it is only a string. QFileInfo::exists() returns TRUE if the symlink points to an existing file. +This name may not represent an existing file; it is only a string. TQFileInfo::exists() returns TRUE if the symlink points to an existing file. .PP See also exists(), isSymLink(), isDir(), and isFile(). -.SH "void QFileInfo::refresh () const" +.SH "void TQFileInfo::refresh () const" Refreshes the information about the file, i.e. reads in information from the file system the next time a cached property is fetched. .PP See also setCaching(). -.SH "void QFileInfo::setCaching ( bool enable )" +.SH "void TQFileInfo::setCaching ( bool enable )" If \fIenable\fR is TRUE, enables caching of file information. If \fIenable\fR is FALSE caching is disabled. .PP -When caching is enabled, QFileInfo reads the file information from the file system the first time it's needed, but generally not later. +When caching is enabled, TQFileInfo reads the file information from the file system the first time it's needed, but generally not later. .PP Caching is enabled by default. .PP See also refresh() and caching(). -.SH "void QFileInfo::setFile ( const TQString & file )" -Sets the file that the QFileInfo provides information about to \fIfile\fR. +.SH "void TQFileInfo::setFile ( const TQString & file )" +Sets the file that the TQFileInfo provides information about to \fIfile\fR. .PP The \fIfile\fR can also include an absolute or relative file path. Absolute paths begin with the directory separator (e.g. "/" under Unix) or a drive specification (under Windows). Relative file names begin with a directory name or a file name and specify a path relative to the current directory. .PP @@ -469,17 +469,17 @@ Example: .br TQString relative = "local/bin"; .br - QFileInfo absFile( absolute ); + TQFileInfo absFile( absolute ); .br - QFileInfo relFile( relative ); + TQFileInfo relFile( relative ); .br .br - QDir::setCurrent( QDir::rootDirPath() ); + TQDir::setCurrent( TQDir::rootDirPath() ); .br // absFile and relFile now point to the same file .br .br - QDir::setCurrent( "/tmp" ); + TQDir::setCurrent( "/tmp" ); .br // absFile now points to "/local/bin", .br @@ -487,32 +487,32 @@ Example: .br .fi .PP -See also isRelative(), QDir::setCurrent(), and QDir::isRelativePath(). +See also isRelative(), TQDir::setCurrent(), and TQDir::isRelativePath(). .PP Example: biff/biff.cpp. -.SH "void QFileInfo::setFile ( const QFile & file )" +.SH "void TQFileInfo::setFile ( const TQFile & file )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Sets the file that the QFileInfo provides information about to \fIfile\fR. +Sets the file that the TQFileInfo provides information about to \fIfile\fR. .PP -If \fIfile\fR includes a relative path, the QFileInfo will also have a relative path. +If \fIfile\fR includes a relative path, the TQFileInfo will also have a relative path. .PP See also isRelative(). -.SH "void QFileInfo::setFile ( const QDir & d, const TQString & fileName )" +.SH "void TQFileInfo::setFile ( const TQDir & d, const TQString & fileName )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP -Sets the file that the QFileInfo provides information about to \fIfileName\fR in directory \fId\fR. +Sets the file that the TQFileInfo provides information about to \fIfileName\fR in directory \fId\fR. .PP -If \fIfileName\fR includes a relative path, the QFileInfo will also have a relative path. +If \fIfileName\fR includes a relative path, the TQFileInfo will also have a relative path. .PP See also isRelative(). -.SH "uint QFileInfo::size () const" +.SH "uint TQFileInfo::size () const" Returns the file size in bytes, or 0 if the file does not exist or if the size is 0 or if the size cannot be fetched. .PP -Example: qdir/qdir.cpp. +Example: tqdir/tqdir.cpp. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqfileinfo.html +.BR http://doc.trolltech.com/tqfileinfo.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqfilepreview.3qt b/doc/man/man3/tqfilepreview.3qt index 5dff206d4..0859bdb6a 100644 --- a/doc/man/man3/tqfilepreview.3qt +++ b/doc/man/man3/tqfilepreview.3qt @@ -1,5 +1,5 @@ '\" t -.TH QFilePreview 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQFilePreview 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,41 +7,41 @@ .ad l .nh .SH NAME -QFilePreview \- File previewing in QFileDialog +TQFilePreview \- File previewing in TQFileDialog .SH SYNOPSIS -\fC#include <ntqfiledialog.h>\fR +\fC#include <tqfiledialog.h>\fR .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQFilePreview\fR ()" +.BI "\fBTQFilePreview\fR ()" .br .ti -1c -.BI "virtual void \fBpreviewUrl\fR ( const QUrl & url ) = 0" +.BI "virtual void \fBpreviewUrl\fR ( const TQUrl & url ) = 0" .br .in -1c .SH DESCRIPTION -The QFilePreview class provides file previewing in QFileDialog. +The TQFilePreview class provides file previewing in TQFileDialog. .PP -This class is an abstract base class which is used to implement widgets that can display a preview of a file in a QFileDialog. +This class is an abstract base class which is used to implement widgets that can display a preview of a file in a TQFileDialog. .PP You must derive the preview widget from both TQWidget and from this class. Then you must reimplement this class's previewUrl() function, which is called by the file dialog if the preview of a file (specified as a URL) should be shown. .PP -See also QFileDialog::setPreviewMode(), QFileDialog::setContentsPreview(), QFileDialog::setInfoPreview(), QFileDialog::setInfoPreviewEnabled(), QFileDialog::setContentsPreviewEnabled(). +See also TQFileDialog::setPreviewMode(), TQFileDialog::setContentsPreview(), TQFileDialog::setInfoPreview(), TQFileDialog::setInfoPreviewEnabled(), TQFileDialog::setContentsPreviewEnabled(). .PP -For an example of a preview widget see qt/examples/qdir/qdir.cpp. +For an example of a preview widget see qt/examples/tqdir/tqdir.cpp. .PP See also Miscellaneous Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QFilePreview::QFilePreview ()" -Constructs the QFilePreview. -.SH "void QFilePreview::previewUrl ( const QUrl & url )\fC [pure virtual]\fR" -This function is called by QFileDialog if a preview +.SH "TQFilePreview::TQFilePreview ()" +Constructs the TQFilePreview. +.SH "void TQFilePreview::previewUrl ( const TQUrl & url )\fC [pure virtual]\fR" +This function is called by TQFileDialog if a preview for the \fIurl\fR should be shown. Reimplement this function to provide file previewing. .SH "SEE ALSO" -.BR http://doc.trolltech.com/qfilepreview.html +.BR http://doc.trolltech.com/tqfilepreview.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqfont.3qt b/doc/man/man3/tqfont.3qt index 2f7754e01..b1bbd9a06 100644 --- a/doc/man/man3/tqfont.3qt +++ b/doc/man/man3/tqfont.3qt @@ -218,10 +218,10 @@ QFont \- Font used for drawing text .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QFont & font )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QFont & font )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QFont & font )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QFont & font )" .br .in -1c .SH DESCRIPTION @@ -249,7 +249,7 @@ If the requested font family is unavailable you can influence the font matching .PP The font-matching algorithm has a lastResortFamily() and lastResortFont() in cases where a suitable match cannot be found. You can provide substitutions for font family names using insertSubstitution() and insertSubstitutions(). Substitutions can be removed with removeSubstitution(). Use substitute() to retrieve a family's first substitute, or the family name itself if it has no substitutes. Use substitutes() to retrieve a list of a family's substitutes (which may be empty). .PP -Every QFont has a key() which you can use, for example, as the key in a cache or dictionary. If you want to store a user's font preferences you could use QSettings, writing the font information with toString() and reading it back with fromString(). The operator<<() and operator>>() functions are also available, but they work on a data stream. +Every QFont has a key() which you can use, for example, as the key in a cache or dictionary. If you want to store a user's font preferences you could use TQSettings, writing the font information with toString() and reading it back with fromString(). The operator<<() and operator>>() functions are also available, but they work on a data stream. .PP It is possible to set the height of characters shown on the screen to a specified number of pixels with setPixelSize(); however using setPointSize() has a similar effect and provides device independence. .PP @@ -722,7 +722,7 @@ If \fIenable\fR is TRUE, italic is set on; otherwise italic is set off. See also italic() and QFontInfo. .PP Examples: -.)l fileiconview/qfileiconview.cpp, fonts/simple-qfont-demo/viewer.cpp, and themes/metal.cpp. +.)l fileiconview/tqfileiconview.cpp, fonts/simple-qfont-demo/viewer.cpp, and themes/metal.cpp. .SH "void QFont::setOverline ( bool enable )" If \fIenable\fR is TRUE, sets overline on; otherwise sets overline off. .PP @@ -850,7 +850,7 @@ Returns a sorted list of substituted family names. .PP See also insertSubstitution(), removeSubstitution(), and substitute(). .SH "TQString QFont::toString () const" -Returns a description of the font. The description is a comma-separated list of the attributes, perfectly suited for use in QSettings. +Returns a description of the font. The description is a comma-separated list of the attributes, perfectly suited for use in TQSettings. .PP See also fromString() and operator<<(). .SH "bool QFont::underline () const" @@ -862,14 +862,14 @@ Returns the weight of the font which is one of the enumerated values from QFont: .PP See also setWeight(), Weight, and QFontInfo. .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QFont & font )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QFont & font )" Writes the font \fIfont\fR to the data stream \fIs\fR. (toString() writes to a text stream.) .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, QFont & font )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, QFont & font )" Reads the font \fIfont\fR from the data stream \fIs\fR. (fromString() reads from a text stream.) .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqfont.html diff --git a/doc/man/man3/tqftp.3qt b/doc/man/man3/tqftp.3qt index 778cf38a3..60fe27c40 100644 --- a/doc/man/man3/tqftp.3qt +++ b/doc/man/man3/tqftp.3qt @@ -1,5 +1,5 @@ '\" t -.TH QFtp 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQFtp 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,22 +7,22 @@ .ad l .nh .SH NAME -QFtp \- Implementation of the FTP protocol +TQFtp \- Implementation of the FTP protocol .SH SYNOPSIS -\fC#include <ntqftp.h>\fR +\fC#include <tqftp.h>\fR .PP -Inherits QNetworkProtocol. +Inherits TQNetworkProtocol. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQFtp\fR ()" +.BI "\fBTQFtp\fR ()" .br .ti -1c -.BI "\fBQFtp\fR ( TQObject * parent, const char * name = 0 )" +.BI "\fBTQFtp\fR ( TQObject * parent, const char * name = 0 )" .br .ti -1c -.BI "virtual \fB~QFtp\fR ()" +.BI "virtual \fB~TQFtp\fR ()" .br .ti -1c .BI "enum \fBState\fR { Unconnected, HostLookup, Connecting, Connected, LoggedIn, Closing }" @@ -118,7 +118,7 @@ Inherits QNetworkProtocol. .BI "void \fBstateChanged\fR ( int state )" .br .ti -1c -.BI "void \fBlistInfo\fR ( const QUrlInfo & i )" +.BI "void \fBlistInfo\fR ( const TQUrlInfo & i )" .br .ti -1c .BI "void \fBreadyRead\fR ()" @@ -140,23 +140,23 @@ Inherits QNetworkProtocol. .br .in -1c .SH DESCRIPTION -The QFtp class provides an implementation of the FTP protocol. +The TQFtp class provides an implementation of the FTP protocol. .PP -This class provides two different interfaces: one is the QNetworkProtocol interface that allows you to use FTP through the QUrlOperator abstraction. The other is a direct interface to FTP that gives you lower-level access to the FTP protocol for finer control. Using the direct interface you can also execute arbitrary FTP commands. +This class provides two different interfaces: one is the TQNetworkProtocol interface that allows you to use FTP through the TQUrlOperator abstraction. The other is a direct interface to FTP that gives you lower-level access to the FTP protocol for finer control. Using the direct interface you can also execute arbitrary FTP commands. .PP Don't mix the two interfaces, since the behavior is not well-defined. .PP -If you want to use QFtp with the QNetworkProtocol interface, you do not use it directly, but rather through a QUrlOperator, for example: +If you want to use TQFtp with the TQNetworkProtocol interface, you do not use it directly, but rather through a TQUrlOperator, for example: .PP .nf .br - QUrlOperator op( "ftp://ftp.trolltech.com" ); + TQUrlOperator op( "ftp://ftp.trolltech.com" ); .br op.listChildren(); // Asks the server to provide a directory listing .br .fi .PP -This code will only work if the QFtp class is registered; to register the class, you must call tqInitNetworkProtocols() before using a QUrlOperator with QFtp. +This code will only work if the TQFtp class is registered; to register the class, you must call tqInitNetworkProtocols() before using a TQUrlOperator with TQFtp. .PP The rest of this descrption describes the direct interface to FTP. .PP @@ -170,7 +170,7 @@ In some cases, you might want to execute a sequence of commands, e.g. if you wan .PP .nf .br - QFtp *ftp = new QFtp( this ); // this is an optional TQObject parent + TQFtp *ftp = new TQFtp( this ); // this is an optional TQObject parent .br ftp->connectToHost( "ftp.trolltech.com" ); .br @@ -287,78 +287,78 @@ The functions currentId() and currentCommand() provide more information about th .PP The functions hasPendingCommands() and clearPendingCommands() allow you to query and clear the list of pending commands. .PP -The safest and easiest way to use the FTP protocol is to use QUrlOperator() or the FTP commands described above. If you are an experienced network programmer and want to have complete control you can use rawCommand() to execute arbitrary FTP commands. +The safest and easiest way to use the FTP protocol is to use TQUrlOperator() or the FTP commands described above. If you are an experienced network programmer and want to have complete control you can use rawCommand() to execute arbitrary FTP commands. .PP -See also TQt Network Documentation, QNetworkProtocol, QUrlOperator, QHttp, and Input/Output and Networking. +See also TQt Network Documentation, TQNetworkProtocol, TQUrlOperator, TQHttp, and Input/Output and Networking. .SS "Member Type Documentation" -.SH "QFtp::Command" +.SH "TQFtp::Command" This enum is used as the return value for the currentCommand() function. This allows you to perform specific actions for particular commands, e.g. in a FTP client, you might want to clear the directory view when a list() command is started; in this case you can simply check in the slot connected to the start() signal if the currentCommand() is List. .TP -\fCQFtp::None\fR - No command is being executed. +\fCTQFtp::None\fR - No command is being executed. .TP -\fCQFtp::ConnectToHost\fR - connectToHost() is being executed. +\fCTQFtp::ConnectToHost\fR - connectToHost() is being executed. .TP -\fCQFtp::Login\fR - login() is being executed. +\fCTQFtp::Login\fR - login() is being executed. .TP -\fCQFtp::Close\fR - close() is being executed. +\fCTQFtp::Close\fR - close() is being executed. .TP -\fCQFtp::List\fR - list() is being executed. +\fCTQFtp::List\fR - list() is being executed. .TP -\fCQFtp::Cd\fR - cd() is being executed. +\fCTQFtp::Cd\fR - cd() is being executed. .TP -\fCQFtp::Get\fR - get() is being executed. +\fCTQFtp::Get\fR - get() is being executed. .TP -\fCQFtp::Put\fR - put() is being executed. +\fCTQFtp::Put\fR - put() is being executed. .TP -\fCQFtp::Remove\fR - remove() is being executed. +\fCTQFtp::Remove\fR - remove() is being executed. .TP -\fCQFtp::Mkdir\fR - mkdir() is being executed. +\fCTQFtp::Mkdir\fR - mkdir() is being executed. .TP -\fCQFtp::Rmdir\fR - rmdir() is being executed. +\fCTQFtp::Rmdir\fR - rmdir() is being executed. .TP -\fCQFtp::Rename\fR - rename() is being executed. +\fCTQFtp::Rename\fR - rename() is being executed. .TP -\fCQFtp::RawCommand\fR - rawCommand() is being executed. +\fCTQFtp::RawCommand\fR - rawCommand() is being executed. .PP See also currentCommand(). -.SH "QFtp::Error" +.SH "TQFtp::Error" This enum identifies the error that occurred. .TP -\fCQFtp::NoError\fR - No error occurred. +\fCTQFtp::NoError\fR - No error occurred. .TP -\fCQFtp::HostNotFound\fR - The host name lookup failed. +\fCTQFtp::HostNotFound\fR - The host name lookup failed. .TP -\fCQFtp::ConnectionRefused\fR - The server refused the connection. +\fCTQFtp::ConnectionRefused\fR - The server refused the connection. .TP -\fCQFtp::NotConnected\fR - Tried to send a command, but there is no connection to a server. +\fCTQFtp::NotConnected\fR - Tried to send a command, but there is no connection to a server. .TP -\fCQFtp::UnknownError\fR - An error other than those specified above occurred. +\fCTQFtp::UnknownError\fR - An error other than those specified above occurred. .PP See also error(). -.SH "QFtp::State" +.SH "TQFtp::State" This enum defines the connection state: .TP -\fCQFtp::Unconnected\fR - There is no connection to the host. +\fCTQFtp::Unconnected\fR - There is no connection to the host. .TP -\fCQFtp::HostLookup\fR - A host name lookup is in progress. +\fCTQFtp::HostLookup\fR - A host name lookup is in progress. .TP -\fCQFtp::Connecting\fR - An attempt to connect to the host is in progress. +\fCTQFtp::Connecting\fR - An attempt to connect to the host is in progress. .TP -\fCQFtp::Connected\fR - Connection to the host has been achieved. +\fCTQFtp::Connected\fR - Connection to the host has been achieved. .TP -\fCQFtp::LoggedIn\fR - Connection and user login have been achieved. +\fCTQFtp::LoggedIn\fR - Connection and user login have been achieved. .TP -\fCQFtp::Closing\fR - The connection is closing down, but it is not yet closed. (The state will be Unconnected when the connection is closed.) +\fCTQFtp::Closing\fR - The connection is closing down, but it is not yet closed. (The state will be Unconnected when the connection is closed.) .PP See also stateChanged() and state(). .SH MEMBER FUNCTION DOCUMENTATION -.SH "QFtp::QFtp ()" -Constructs a QFtp object. -.SH "QFtp::QFtp ( TQObject * parent, const char * name = 0 )" -Constructs a QFtp object. The \fIparent\fR and \fIname\fR parameters are passed to the TQObject constructor. -.SH "QFtp::~QFtp ()\fC [virtual]\fR" +.SH "TQFtp::TQFtp ()" +Constructs a TQFtp object. +.SH "TQFtp::TQFtp ( TQObject * parent, const char * name = 0 )" +Constructs a TQFtp object. The \fIparent\fR and \fIname\fR parameters are passed to the TQObject constructor. +.SH "TQFtp::~TQFtp ()\fC [virtual]\fR" Destructor. -.SH "void QFtp::abort ()\fC [slot]\fR" +.SH "void TQFtp::abort ()\fC [slot]\fR" Aborts the current command and deletes all scheduled commands. .PP If there is an unfinished command (i.e. a command for which the commandStarted() signal has been emitted, but for which the commandFinished() signal has not been emitted), this function sends an \fCABORT\fR command to the server. When the server replies that the command is aborted, the commandFinished() signal with the \fCerror\fR argument set to \fCTRUE\fR is emitted for the command. Due to timing issues, it is possible that the command had already finished before the abort request reached the server, in which case, the commandFinished() signal is emitted with the \fCerror\fR argument set to \fCFALSE\fR. @@ -372,11 +372,11 @@ If you don't start further FTP commands directly after the abort(), there won't See also clearPendingCommands(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "TQ_ULONG QFtp::bytesAvailable () const" +.SH "TQ_ULONG TQFtp::bytesAvailable () const" Returns the number of bytes that can be read from the data socket at the moment. .PP See also get(), readyRead(), readBlock(), and readAll(). -.SH "int QFtp::cd ( const TQString & dir )" +.SH "int TQFtp::cd ( const TQString & dir )" Changes the working directory of the server to \fIdir\fR. .PP The function does not block and returns immediately. The command is scheduled, and its execution is performed asynchronously. The function returns a unique identifier which is passed by commandStarted() and commandFinished(). @@ -386,11 +386,11 @@ When the command is started the commandStarted() signal is emitted. When it is f See also commandStarted() and commandFinished(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "void QFtp::clearPendingCommands ()" +.SH "void TQFtp::clearPendingCommands ()" Deletes all pending commands from the list of scheduled commands. This does not affect the command that is being executed. If you want to stop this this as well, use abort(). .PP See also hasPendingCommands() and abort(). -.SH "int QFtp::close ()" +.SH "int TQFtp::close ()" Closes the connection to the FTP server. .PP The stateChanged() signal is emitted when the state of the connecting process changes, e.g. to Closing, then Unconnected. @@ -402,19 +402,19 @@ When the command is started the commandStarted() signal is emitted. When it is f See also stateChanged(), commandStarted(), and commandFinished(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "void QFtp::commandFinished ( int id, bool error )\fC [signal]\fR" +.SH "void TQFtp::commandFinished ( int id, bool error )\fC [signal]\fR" This signal is emitted when processing the command identified by \fIid\fR has finished. \fIerror\fR is TRUE if an error occurred during the processing; otherwise \fIerror\fR is FALSE. .PP See also commandStarted(), done(), error(), and errorString(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "void QFtp::commandStarted ( int id )\fC [signal]\fR" +.SH "void TQFtp::commandStarted ( int id )\fC [signal]\fR" This signal is emitted when processing the command identified by \fIid\fR starts. .PP See also commandFinished() and done(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "int QFtp::connectToHost ( const TQString & host, TQ_UINT16 port = 21 )" +.SH "int TQFtp::connectToHost ( const TQString & host, TQ_UINT16 port = 21 )" Connects to the FTP server \fIhost\fR using port \fIport\fR. .PP The stateChanged() signal is emitted when the state of the connecting process changes, e.g. to HostLookup, then Connecting, then Connected. @@ -426,13 +426,13 @@ When the command is started the commandStarted() signal is emitted. When it is f See also stateChanged(), commandStarted(), and commandFinished(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "Command QFtp::currentCommand () const" +.SH "Command TQFtp::currentCommand () const" Returns the command type of the FTP command being executed or None if there is no command being executed. .PP See also currentId(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "TQIODevice * QFtp::currentDevice () const" +.SH "TQIODevice * TQFtp::currentDevice () const" Returns the TQIODevice pointer that is used by the FTP command to read data from or store data to. If there is no current FTP command being executed or if the command does not use an IO device, this function returns 0. .PP This function can be used to delete the TQIODevice in the slot connected to the commandFinished() signal. @@ -440,37 +440,37 @@ This function can be used to delete the TQIODevice in the slot connected to the See also get() and put(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "int QFtp::currentId () const" +.SH "int TQFtp::currentId () const" Returns the identifier of the FTP command that is being executed or 0 if there is no command being executed. .PP See also currentCommand(). -.SH "void QFtp::dataTransferProgress ( int done, int total )\fC [signal]\fR" +.SH "void TQFtp::dataTransferProgress ( int done, int total )\fC [signal]\fR" This signal is emitted in response to a get() or put() request to indicate the current progress of the download or upload. .PP -\fIdone\fR is the amount of data that has already been transferred and \fItotal\fR is the total amount of data to be read or written. It is possible that the QFtp class is not able to determine the total amount of data that should be transferred, in which case \fItotal\fR is 0. (If you connect this signal to a QProgressBar, the progress bar shows a busy indicator if the total is 0). +\fIdone\fR is the amount of data that has already been transferred and \fItotal\fR is the total amount of data to be read or written. It is possible that the TQFtp class is not able to determine the total amount of data that should be transferred, in which case \fItotal\fR is 0. (If you connect this signal to a QProgressBar, the progress bar shows a busy indicator if the total is 0). .PP \fBWarning:\fR \fIdone\fR and \fItotal\fR are not necessarily the size in bytes, since for large files these values might need to be" scaled" to avoid overflow. .PP See also get(), put(), and QProgressBar::progress. .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "void QFtp::done ( bool error )\fC [signal]\fR" +.SH "void TQFtp::done ( bool error )\fC [signal]\fR" This signal is emitted when the last pending command has finished; (it is emitted after the last command's commandFinished() signal). \fIerror\fR is TRUE if an error occurred during the processing; otherwise \fIerror\fR is FALSE. .PP See also commandFinished(), error(), and errorString(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "Error QFtp::error () const" +.SH "Error TQFtp::error () const" Returns the last error that occurred. This is useful to find out what when wrong when receiving a commandFinished() or a done() signal with the \fCerror\fR argument set to \fCTRUE\fR. .PP If you start a new command, the error status is reset to NoError. -.SH "TQString QFtp::errorString () const" +.SH "TQString TQFtp::errorString () const" Returns a human-readable description of the last error that occurred. This is useful for presenting a error message to the user when receiving a commandFinished() or a done() signal with the \fCerror\fR argument set to \fCTRUE\fR. .PP The error string is often (but not always) the reply from the server, so it is not always possible to translate the string. If the message comes from Qt, the string has already passed through tr(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "int QFtp::get ( const TQString & file, TQIODevice * dev = 0 )" +.SH "int TQFtp::get ( const TQString & file, TQIODevice * dev = 0 )" Downloads the file \fIfile\fR from the server. .PP If \fIdev\fR is 0, then the readyRead() signal is emitted when there is data available to read. You can then read the data with the readBlock() or readAll() functions. @@ -488,13 +488,13 @@ When the command is started the commandStarted() signal is emitted. When it is f See also readyRead(), dataTransferProgress(), commandStarted(), and commandFinished(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "bool QFtp::hasPendingCommands () const" +.SH "bool TQFtp::hasPendingCommands () const" Returns TRUE if there are any commands scheduled that have not yet been executed; otherwise returns FALSE. .PP The command that is being executed is \fInot\fR considered as a scheduled command. .PP See also clearPendingCommands(), currentId(), and currentCommand(). -.SH "int QFtp::list ( const TQString & dir = TQString::null )" +.SH "int TQFtp::list ( const TQString & dir = TQString::null )" Lists the contents of directory \fIdir\fR on the FTP server. If \fIdir\fR is empty, it lists the contents of the current directory. .PP The listInfo() signal is emitted for each directory entry found. @@ -506,13 +506,13 @@ When the command is started the commandStarted() signal is emitted. When it is f See also listInfo(), commandStarted(), and commandFinished(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "void QFtp::listInfo ( const QUrlInfo & i )\fC [signal]\fR" +.SH "void TQFtp::listInfo ( const TQUrlInfo & i )\fC [signal]\fR" This signal is emitted for each directory entry the list() command finds. The details of the entry are stored in \fIi\fR. .PP See also list(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "int QFtp::login ( const TQString & user = TQString::null, const TQString & password = TQString::null )" +.SH "int TQFtp::login ( const TQString & user = TQString::null, const TQString & password = TQString::null )" Logs in to the FTP server with the username \fIuser\fR and the password \fIpassword\fR. .PP The stateChanged() signal is emitted when the state of the connecting process changes, e.g. to LoggedIn. @@ -524,7 +524,7 @@ When the command is started the commandStarted() signal is emitted. When it is f See also commandStarted() and commandFinished(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "int QFtp::mkdir ( const TQString & dir )" +.SH "int TQFtp::mkdir ( const TQString & dir )" Creates a directory called \fIdir\fR on the server. .PP The function does not block and returns immediately. The command is scheduled, and its execution is performed asynchronously. The function returns a unique identifier which is passed by commandStarted() and commandFinished(). @@ -532,13 +532,13 @@ The function does not block and returns immediately. The command is scheduled, a When the command is started the commandStarted() signal is emitted. When it is finished the commandFinished() signal is emitted. .PP See also commandStarted() and commandFinished(). -.SH "int QFtp::put ( TQIODevice * dev, const TQString & file )" +.SH "int TQFtp::put ( TQIODevice * dev, const TQString & file )" Reads the data from the IO device \fIdev\fR, and writes it to the file called \fIfile\fR on the server. The data is read in chunks from the IO device, so this overload allows you to transmit large amounts of data without the need to read all the data into memory at once. .PP Make sure that the \fIdev\fR pointer is valid for the duration of the operation (it is safe to delete it when the commandFinished() is emitted). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "int QFtp::put ( const TQByteArray & data, const TQString & file )" +.SH "int TQFtp::put ( const TQByteArray & data, const TQString & file )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes the data \fIdata\fR to the file called \fIfile\fR on the server. The progress of the upload is reported by the dataTransferProgress() signal. @@ -548,8 +548,8 @@ The function does not block and returns immediately. The command is scheduled, a When the command is started the commandStarted() signal is emitted. When it is finished the commandFinished() signal is emitted. .PP See also dataTransferProgress(), commandStarted(), and commandFinished(). -.SH "int QFtp::rawCommand ( const TQString & command )" -Sends the raw FTP command \fIcommand\fR to the FTP server. This is useful for low-level FTP access. If the operation you wish to perform has an equivalent QFtp function, we recommend using the function instead of raw FTP commands since the functions are easier and safer. +.SH "int TQFtp::rawCommand ( const TQString & command )" +Sends the raw FTP command \fIcommand\fR to the FTP server. This is useful for low-level FTP access. If the operation you wish to perform has an equivalent TQFtp function, we recommend using the function instead of raw FTP commands since the functions are easier and safer. .PP The function does not block and returns immediately. The command is scheduled, and its execution is performed asynchronously. The function returns a unique identifier which is passed by commandStarted() and commandFinished(). .PP @@ -558,21 +558,21 @@ When the command is started the commandStarted() signal is emitted. When it is f See also rawCommandReply(), commandStarted(), and commandFinished(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "void QFtp::rawCommandReply ( int replyCode, const TQString & detail )\fC [signal]\fR" +.SH "void TQFtp::rawCommandReply ( int replyCode, const TQString & detail )\fC [signal]\fR" This signal is emitted in response to the rawCommand() function. \fIreplyCode\fR is the 3 digit reply code and \fIdetail\fR is the text that follows the reply code. .PP See also rawCommand(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "TQByteArray QFtp::readAll ()" +.SH "TQByteArray TQFtp::readAll ()" Reads all the bytes available from the data socket and returns them. .PP See also get(), readyRead(), bytesAvailable(), and readBlock(). -.SH "TQ_LONG QFtp::readBlock ( char * data, TQ_ULONG maxlen )" +.SH "TQ_LONG TQFtp::readBlock ( char * data, TQ_ULONG maxlen )" Reads \fImaxlen\fR bytes from the data socket into \fIdata\fR and returns the number of bytes read. Returns -1 if an error occurred. .PP See also get(), readyRead(), bytesAvailable(), and readAll(). -.SH "void QFtp::readyRead ()\fC [signal]\fR" +.SH "void TQFtp::readyRead ()\fC [signal]\fR" This signal is emitted in response to a get() command when there is new data to read. .PP If you specify a device as the second argument in the get() command, this signal is \fInot\fR emitted; instead the data is written directly to the device. @@ -582,7 +582,7 @@ You can read the data with the readAll() or readBlock() functions. This signal is useful if you want to process the data in chunks as soon as it becomes available. If you are only interested in the complete data, just connect to the commandFinished() signal and read the data then instead. .PP See also get(), readBlock(), readAll(), and bytesAvailable(). -.SH "int QFtp::remove ( const TQString & file )" +.SH "int TQFtp::remove ( const TQString & file )" Deletes the file called \fIfile\fR from the server. .PP The function does not block and returns immediately. The command is scheduled, and its execution is performed asynchronously. The function returns a unique identifier which is passed by commandStarted() and commandFinished(). @@ -592,7 +592,7 @@ When the command is started the commandStarted() signal is emitted. When it is f See also commandStarted() and commandFinished(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "int QFtp::rename ( const TQString & oldname, const TQString & newname )" +.SH "int TQFtp::rename ( const TQString & oldname, const TQString & newname )" Renames the file called \fIoldname\fR to \fInewname\fR on the server. .PP The function does not block and returns immediately. The command is scheduled, and its execution is performed asynchronously. The function returns a unique identifier which is passed by commandStarted() and commandFinished(). @@ -600,7 +600,7 @@ The function does not block and returns immediately. The command is scheduled, a When the command is started the commandStarted() signal is emitted. When it is finished the commandFinished() signal is emitted. .PP See also commandStarted() and commandFinished(). -.SH "int QFtp::rmdir ( const TQString & dir )" +.SH "int TQFtp::rmdir ( const TQString & dir )" Removes the directory called \fIdir\fR from the server. .PP The function does not block and returns immediately. The command is scheduled, and its execution is performed asynchronously. The function returns a unique identifier which is passed by commandStarted() and commandFinished(). @@ -608,13 +608,13 @@ The function does not block and returns immediately. The command is scheduled, a When the command is started the commandStarted() signal is emitted. When it is finished the commandFinished() signal is emitted. .PP See also commandStarted() and commandFinished(). -.SH "State QFtp::state () const" +.SH "State TQFtp::state () const" Returns the current state of the object. When the state changes, the stateChanged() signal is emitted. .PP See also State and stateChanged(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "void QFtp::stateChanged ( int state )\fC [signal]\fR" +.SH "void TQFtp::stateChanged ( int state )\fC [signal]\fR" This signal is emitted when the state of the connection changes. The argument \fIstate\fR is the new state of the connection; it is one of the State values. .PP It is usually emitted in response to a connectToHost() or close() command, but it can also be emitted "spontaneously", e.g. when the server closes the connection unexpectedly. @@ -624,7 +624,7 @@ See also connectToHost(), close(), state(), and State. Example: network/ftpclient/ftpmainwindow.ui.h. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqftp.html +.BR http://doc.trolltech.com/tqftp.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqhbox.3qt b/doc/man/man3/tqhbox.3qt index f3edd2824..e92e26a4e 100644 --- a/doc/man/man3/tqhbox.3qt +++ b/doc/man/man3/tqhbox.3qt @@ -60,7 +60,7 @@ The \fIparent\fR, \fIname\fR and widget flags, \fIf\fR, are passed to the QFrame Sets the spacing between the child widgets to \fIspace\fR. .PP Examples: -.)l i18n/mywidget.cpp, listboxcombo/listboxcombo.cpp, qdir/qdir.cpp, tabdialog/tabdialog.cpp, wizard/wizard.cpp, and xform/xform.cpp. +.)l i18n/mywidget.cpp, listboxcombo/listboxcombo.cpp, tqdir/tqdir.cpp, tabdialog/tabdialog.cpp, wizard/wizard.cpp, and xform/xform.cpp. .SH "bool QHBox::setStretchFactor ( TQWidget * w, int stretch )" Sets the stretch factor of widget \fIw\fR to \fIstretch\fR. Returns TRUE if \fIw\fR is found. Otherwise returns FALSE. .PP diff --git a/doc/man/man3/tqhostaddress.3qt b/doc/man/man3/tqhostaddress.3qt index 3c3bf83c0..49f2f5ad3 100644 --- a/doc/man/man3/tqhostaddress.3qt +++ b/doc/man/man3/tqhostaddress.3qt @@ -1,5 +1,5 @@ '\" t -.TH QHostAddress 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQHostAddress 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,32 +7,32 @@ .ad l .nh .SH NAME -QHostAddress \- IP address +TQHostAddress \- IP address .SH SYNOPSIS -\fC#include <ntqhostaddress.h>\fR +\fC#include <tqhostaddress.h>\fR .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQHostAddress\fR ()" +.BI "\fBTQHostAddress\fR ()" .br .ti -1c -.BI "\fBQHostAddress\fR ( TQ_UINT32 ip4Addr )" +.BI "\fBTQHostAddress\fR ( TQ_UINT32 ip4Addr )" .br .ti -1c -.BI "\fBQHostAddress\fR ( TQ_UINT8 * ip6Addr )" +.BI "\fBTQHostAddress\fR ( TQ_UINT8 * ip6Addr )" .br .ti -1c -.BI "\fBQHostAddress\fR ( const Q_IPV6ADDR & ip6Addr )" +.BI "\fBTQHostAddress\fR ( const Q_IPV6ADDR & ip6Addr )" .br .ti -1c -.BI "\fBQHostAddress\fR ( const QHostAddress & address )" +.BI "\fBTQHostAddress\fR ( const TQHostAddress & address )" .br .ti -1c -.BI "virtual \fB~QHostAddress\fR ()" +.BI "virtual \fB~TQHostAddress\fR ()" .br .ti -1c -.BI "QHostAddress & \fBoperator=\fR ( const QHostAddress & address )" +.BI "TQHostAddress & \fBoperator=\fR ( const TQHostAddress & address )" .br .ti -1c .BI "void \fBsetAddress\fR ( TQ_UINT32 ip4Addr )" @@ -65,68 +65,68 @@ QHostAddress \- IP address .BI "TQString \fBtoString\fR () const" .br .ti -1c -.BI "bool \fBoperator==\fR ( const QHostAddress & other ) const" +.BI "bool \fBoperator==\fR ( const TQHostAddress & other ) const" .br .ti -1c .BI "bool \fBisNull\fR () const" .br .in -1c .SH DESCRIPTION -The QHostAddress class provides an IP address. +The TQHostAddress class provides an IP address. .PP This class contains an IP address in a platform and protocol independent manner. It stores both IPv4 and IPv6 addresses in a way that you can easily access on any platform. .PP -QHostAddress is normally used with the classes QSocket, QServerSocket and QSocketDevice to set up a server or to connect to a host. +TQHostAddress is normally used with the classes TQSocket, TQServerSocket and TQSocketDevice to set up a server or to connect to a host. .PP Host addresses may be set with setAddress() and retrieved with ip4Addr() or toString(). .PP -See also QSocket, QServerSocket, QSocketDevice, and Input/Output and Networking. +See also TQSocket, TQServerSocket, TQSocketDevice, and Input/Output and Networking. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QHostAddress::QHostAddress ()" +.SH "TQHostAddress::TQHostAddress ()" Creates a host address object with the IP address 0.0.0.0. -.SH "QHostAddress::QHostAddress ( TQ_UINT32 ip4Addr )" +.SH "TQHostAddress::TQHostAddress ( TQ_UINT32 ip4Addr )" Creates a host address object for the IPv4 address \fIip4Addr\fR. -.SH "QHostAddress::QHostAddress ( TQ_UINT8 * ip6Addr )" +.SH "TQHostAddress::TQHostAddress ( TQ_UINT8 * ip6Addr )" Creates a host address object with the specified IPv6 address. .PP \fIip6Addr\fR must be a 16 byte array in network byte order (high-order byte first). -.SH "QHostAddress::QHostAddress ( const Q_IPV6ADDR & ip6Addr )" +.SH "TQHostAddress::TQHostAddress ( const Q_IPV6ADDR & ip6Addr )" Creates a host address object with the IPv6 address, \fIip6Addr\fR. -.SH "QHostAddress::QHostAddress ( const QHostAddress & address )" +.SH "TQHostAddress::TQHostAddress ( const TQHostAddress & address )" Creates a copy of \fIaddress\fR. -.SH "QHostAddress::~QHostAddress ()\fC [virtual]\fR" +.SH "TQHostAddress::~TQHostAddress ()\fC [virtual]\fR" Destroys the host address object. -.SH "TQ_UINT32 QHostAddress::ip4Addr () const" +.SH "TQ_UINT32 TQHostAddress::ip4Addr () const" \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. .PP Use toIPv4Address() instead. -.SH "bool QHostAddress::isIPv4Address () const" +.SH "bool TQHostAddress::isIPv4Address () const" Returns TRUE if the host address represents an IPv4 address; otherwise returns FALSE. -.SH "bool QHostAddress::isIPv6Address () const" +.SH "bool TQHostAddress::isIPv6Address () const" Returns TRUE if the host address represents an IPv6 address; otherwise returns FALSE. -.SH "bool QHostAddress::isIp4Addr () const" +.SH "bool TQHostAddress::isIp4Addr () const" \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. .PP Use isIPv4Address() instead. -.SH "bool QHostAddress::isNull () const" +.SH "bool TQHostAddress::isNull () const" Returns TRUE if this host address is null (INADDR_ANY or in6addr_any). The default constructor creates a null address, and that address isn't valid for any particular host or interface. -.SH "QHostAddress & QHostAddress::operator= ( const QHostAddress & address )" +.SH "TQHostAddress & TQHostAddress::operator= ( const TQHostAddress & address )" Assigns another host address object \fIaddress\fR to this object and returns a reference to this object. -.SH "bool QHostAddress::operator== ( const QHostAddress & other ) const" +.SH "bool TQHostAddress::operator== ( const TQHostAddress & other ) const" Returns TRUE if this host address is the same as \fIother\fR; otherwise returns FALSE. -.SH "void QHostAddress::setAddress ( TQ_UINT32 ip4Addr )" +.SH "void TQHostAddress::setAddress ( TQ_UINT32 ip4Addr )" Set the IPv4 address specified by \fIip4Addr\fR. -.SH "void QHostAddress::setAddress ( TQ_UINT8 * ip6Addr )" +.SH "void TQHostAddress::setAddress ( TQ_UINT8 * ip6Addr )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Set the IPv6 address specified by \fIip6Addr\fR. .PP \fIip6Addr\fR must be a 16 byte array in network byte order (high-order byte first). -.SH "bool QHostAddress::setAddress ( const TQString & address )" +.SH "bool TQHostAddress::setAddress ( const TQString & address )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Sets the IPv4 or IPv6 address specified by the string representation \fIaddress\fR (e.g. "127.0.0.1"). Returns TRUE and sets the address if the address was successfully parsed; otherwise returns FALSE and leaves the address unchanged. -.SH "TQ_UINT32 QHostAddress::toIPv4Address () const" +.SH "TQ_UINT32 TQHostAddress::toIPv4Address () const" Returns the IPv4 address as a number. .PP For example, if the address is 127.0.0.1, the returned value is 2130706433 (i.e. 0x7f000001). @@ -134,7 +134,7 @@ For example, if the address is 127.0.0.1, the returned value is 2130706433 (i.e. This value is only valid when isIp4Addr() returns TRUE. .PP See also toString(). -.SH "Q_IPV6ADDR QHostAddress::toIPv6Address () const" +.SH "Q_IPV6ADDR TQHostAddress::toIPv6Address () const" Returns the IPv6 address as a Q_IPV6ADDR structure. The structure consists of 16 unsigned characters. .PP .nf @@ -155,7 +155,7 @@ Returns the IPv6 address as a Q_IPV6ADDR structure. The structure consists of 16 This value is only valid when isIPv6Address() returns TRUE. .PP See also toString(). -.SH "TQString QHostAddress::toString () const" +.SH "TQString TQHostAddress::toString () const" Returns the address as a string. .PP For example, if the address is the IPv4 address 127.0.0.1, the returned string is "127.0.0.1". @@ -163,7 +163,7 @@ For example, if the address is the IPv4 address 127.0.0.1, the returned string i See also ip4Addr(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqhostaddress.html +.BR http://doc.trolltech.com/tqhostaddress.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqhttp.3qt b/doc/man/man3/tqhttp.3qt index 7e1409741..050677ed2 100644 --- a/doc/man/man3/tqhttp.3qt +++ b/doc/man/man3/tqhttp.3qt @@ -1,5 +1,5 @@ '\" t -.TH QHttp 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQHttp 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,25 +7,25 @@ .ad l .nh .SH NAME -QHttp \- Implementation of the HTTP protocol +TQHttp \- Implementation of the HTTP protocol .SH SYNOPSIS -\fC#include <ntqhttp.h>\fR +\fC#include <tqhttp.h>\fR .PP -Inherits QNetworkProtocol. +Inherits TQNetworkProtocol. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQHttp\fR ()" +.BI "\fBTQHttp\fR ()" .br .ti -1c -.BI "\fBQHttp\fR ( TQObject * parent, const char * name = 0 )" +.BI "\fBTQHttp\fR ( TQObject * parent, const char * name = 0 )" .br .ti -1c -.BI "\fBQHttp\fR ( const TQString & hostname, TQ_UINT16 port = 80, TQObject * parent = 0, const char * name = 0 )" +.BI "\fBTQHttp\fR ( const TQString & hostname, TQ_UINT16 port = 80, TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "virtual \fB~QHttp\fR ()" +.BI "virtual \fB~TQHttp\fR ()" .br .ti -1c .BI "enum \fBState\fR { Unconnected, HostLookup, Connecting, Sending, Reading, Connected, Closing }" @@ -49,10 +49,10 @@ Inherits QNetworkProtocol. .BI "int \fBhead\fR ( const TQString & path )" .br .ti -1c -.BI "int \fBrequest\fR ( const QHttpRequestHeader & header, TQIODevice * data = 0, TQIODevice * to = 0 )" +.BI "int \fBrequest\fR ( const TQHttpRequestHeader & header, TQIODevice * data = 0, TQIODevice * to = 0 )" .br .ti -1c -.BI "int \fBrequest\fR ( const QHttpRequestHeader & header, const TQByteArray & data, TQIODevice * to = 0 )" +.BI "int \fBrequest\fR ( const TQHttpRequestHeader & header, const TQByteArray & data, TQIODevice * to = 0 )" .br .ti -1c .BI "int \fBcloseConnection\fR ()" @@ -76,7 +76,7 @@ Inherits QNetworkProtocol. .BI "TQIODevice * \fBcurrentDestinationDevice\fR () const" .br .ti -1c -.BI "QHttpRequestHeader \fBcurrentRequest\fR () const" +.BI "TQHttpRequestHeader \fBcurrentRequest\fR () const" .br .ti -1c .BI "bool \fBhasPendingRequests\fR () const" @@ -106,10 +106,10 @@ Inherits QNetworkProtocol. .BI "void \fBstateChanged\fR ( int state )" .br .ti -1c -.BI "void \fBresponseHeaderReceived\fR ( const QHttpResponseHeader & resp )" +.BI "void \fBresponseHeaderReceived\fR ( const TQHttpResponseHeader & resp )" .br .ti -1c -.BI "void \fBreadyRead\fR ( const QHttpResponseHeader & resp )" +.BI "void \fBreadyRead\fR ( const TQHttpResponseHeader & resp )" .br .ti -1c .BI "void \fBdataSendProgress\fR ( int done, int total )" @@ -128,25 +128,25 @@ Inherits QNetworkProtocol. .br .in -1c .SH DESCRIPTION -The QHttp class provides an implementation of the HTTP protocol. +The TQHttp class provides an implementation of the HTTP protocol. .PP -This class provides two different interfaces: one is the QNetworkProtocol interface that allows you to use HTTP through the QUrlOperator abstraction. The other is a direct interface to HTTP that allows you to have more control over the requests and that allows you to access the response header fields. +This class provides two different interfaces: one is the TQNetworkProtocol interface that allows you to use HTTP through the TQUrlOperator abstraction. The other is a direct interface to HTTP that allows you to have more control over the requests and that allows you to access the response header fields. .PP Don't mix the two interfaces, since the behavior is not well-defined. .PP -If you want to use QHttp with the QNetworkProtocol interface, you do not use it directly, but rather through a QUrlOperator, for example: +If you want to use TQHttp with the TQNetworkProtocol interface, you do not use it directly, but rather through a TQUrlOperator, for example: .PP .nf .br - QUrlOperator op( "http://www.trolltech.com" ); + TQUrlOperator op( "http://www.trolltech.com" ); .br op.get( "index.html" ); .br .fi .PP -This code will only work if the QHttp class is registered; to register the class, you must call tqInitNetworkProtocols() before using a QUrlOperator with HTTP. +This code will only work if the TQHttp class is registered; to register the class, you must call tqInitNetworkProtocols() before using a TQUrlOperator with HTTP. .PP -The QNetworkProtocol interface for HTTP only supports the operations operationGet() and operationPut(), i.e. QUrlOperator::get() and QUrlOperator::put(), if you use it with a QUrlOperator. +The TQNetworkProtocol interface for HTTP only supports the operations operationGet() and operationPut(), i.e. TQUrlOperator::get() and TQUrlOperator::put(), if you use it with a TQUrlOperator. .PP The rest of this descrption describes the direct interface to HTTP. .PP @@ -160,7 +160,7 @@ To make an HTTP request you must set up suitable HTTP headers. The following exa .PP .nf .br - QHttpRequestHeader header( "GET", "/index.html" ); + TQHttpRequestHeader header( "GET", "/index.html" ); .br header.setValue( "Host", "www.trolltech.com" ); .br @@ -170,7 +170,7 @@ To make an HTTP request you must set up suitable HTTP headers. The following exa .br .fi .PP -For the common HTTP requests \fCGET\fR, \fCPOST\fR and \fCHEAD\fR, QHttp provides the convenience functions get(), post() and head(). They already use a reasonable header and if you don't have to set special header fields, they are easier to use. The above example can also be written as: +For the common HTTP requests \fCGET\fR, \fCPOST\fR and \fCHEAD\fR, TQHttp provides the convenience functions get(), post() and head(). They already use a reasonable header and if you don't have to set special header fields, they are easier to use. The above example can also be written as: .PP .nf .br @@ -272,58 +272,58 @@ The functions currentId() and currentRequest() provide more information about th .PP The functions hasPendingRequests() and clearPendingRequests() allow you to query and clear the list of pending requests. .PP -See also TQt Network Documentation, QNetworkProtocol, QUrlOperator, QFtp, and Input/Output and Networking. +See also TQt Network Documentation, TQNetworkProtocol, TQUrlOperator, TQFtp, and Input/Output and Networking. .SS "Member Type Documentation" -.SH "QHttp::Error" +.SH "TQHttp::Error" This enum identifies the error that occurred. .TP -\fCQHttp::NoError\fR - No error occurred. +\fCTQHttp::NoError\fR - No error occurred. .TP -\fCQHttp::HostNotFound\fR - The host name lookup failed. +\fCTQHttp::HostNotFound\fR - The host name lookup failed. .TP -\fCQHttp::ConnectionRefused\fR - The server refused the connection. +\fCTQHttp::ConnectionRefused\fR - The server refused the connection. .TP -\fCQHttp::UnexpectedClose\fR - The server closed the connection unexpectedly. +\fCTQHttp::UnexpectedClose\fR - The server closed the connection unexpectedly. .TP -\fCQHttp::InvalidResponseHeader\fR - The server sent an invalid response header. +\fCTQHttp::InvalidResponseHeader\fR - The server sent an invalid response header. .TP -\fCQHttp::WrongContentLength\fR - The client could not read the content correctly because an error with respect to the content length occurred. +\fCTQHttp::WrongContentLength\fR - The client could not read the content correctly because an error with respect to the content length occurred. .TP -\fCQHttp::Aborted\fR - The request was aborted with abort(). +\fCTQHttp::Aborted\fR - The request was aborted with abort(). .TP -\fCQHttp::UnknownError\fR - An error other than those specified above occurred. +\fCTQHttp::UnknownError\fR - An error other than those specified above occurred. .PP See also error(). -.SH "QHttp::State" +.SH "TQHttp::State" This enum is used to specify the state the client is in: .TP -\fCQHttp::Unconnected\fR - There is no connection to the host. +\fCTQHttp::Unconnected\fR - There is no connection to the host. .TP -\fCQHttp::HostLookup\fR - A host name lookup is in progress. +\fCTQHttp::HostLookup\fR - A host name lookup is in progress. .TP -\fCQHttp::Connecting\fR - An attempt to connect to the host is in progress. +\fCTQHttp::Connecting\fR - An attempt to connect to the host is in progress. .TP -\fCQHttp::Sending\fR - The client is sending its request to the server. +\fCTQHttp::Sending\fR - The client is sending its request to the server. .TP -\fCQHttp::Reading\fR - The client's request has been sent and the client is reading the server's response. +\fCTQHttp::Reading\fR - The client's request has been sent and the client is reading the server's response. .TP -\fCQHttp::Connected\fR - The connection to the host is open, but the client is neither sending a request, nor waiting for a response. +\fCTQHttp::Connected\fR - The connection to the host is open, but the client is neither sending a request, nor waiting for a response. .TP -\fCQHttp::Closing\fR - The connection is closing down, but is not yet closed. (The state will be Unconnected when the connection is closed.) +\fCTQHttp::Closing\fR - The connection is closing down, but is not yet closed. (The state will be Unconnected when the connection is closed.) .PP See also stateChanged() and state(). .SH MEMBER FUNCTION DOCUMENTATION -.SH "QHttp::QHttp ()" -Constructs a QHttp object. -.SH "QHttp::QHttp ( TQObject * parent, const char * name = 0 )" -Constructs a QHttp object. The parameters \fIparent\fR and \fIname\fR are passed on to the TQObject constructor. -.SH "QHttp::QHttp ( const TQString & hostname, TQ_UINT16 port = 80, TQObject * parent = 0, const char * name = 0 )" -Constructs a QHttp object. Subsequent requests are done by connecting to the server \fIhostname\fR on port \fIport\fR. The parameters \fIparent\fR and \fIname\fR are passed on to the TQObject constructor. +.SH "TQHttp::TQHttp ()" +Constructs a TQHttp object. +.SH "TQHttp::TQHttp ( TQObject * parent, const char * name = 0 )" +Constructs a TQHttp object. The parameters \fIparent\fR and \fIname\fR are passed on to the TQObject constructor. +.SH "TQHttp::TQHttp ( const TQString & hostname, TQ_UINT16 port = 80, TQObject * parent = 0, const char * name = 0 )" +Constructs a TQHttp object. Subsequent requests are done by connecting to the server \fIhostname\fR on port \fIport\fR. The parameters \fIparent\fR and \fIname\fR are passed on to the TQObject constructor. .PP See also setHost(). -.SH "QHttp::~QHttp ()\fC [virtual]\fR" -Destroys the QHttp object. If there is an open connection, it is closed. -.SH "void QHttp::abort ()\fC [slot]\fR" +.SH "TQHttp::~TQHttp ()\fC [virtual]\fR" +Destroys the TQHttp object. If there is an open connection, it is closed. +.SH "void TQHttp::abort ()\fC [slot]\fR" Aborts the current request and deletes all scheduled requests. .PP For the current request, the requestFinished() signal with the \fCerror\fR argument \fCTRUE\fR is emitted. For all other requests that are affected by the abort(), no signals are emitted. @@ -331,18 +331,18 @@ For the current request, the requestFinished() signal with the \fCerror\fR argum Since this slot also deletes the scheduled requests, there are no requests left and the done() signal is emitted (with the \fCerror\fR argument \fCTRUE\fR). .PP See also clearPendingRequests(). -.SH "TQ_ULONG QHttp::bytesAvailable () const" +.SH "TQ_ULONG TQHttp::bytesAvailable () const" Returns the number of bytes that can be read from the response content at the moment. .PP See also get(), post(), request(), readyRead(), readBlock(), and readAll(). -.SH "void QHttp::clearPendingRequests ()" +.SH "void TQHttp::clearPendingRequests ()" Deletes all pending requests from the list of scheduled requests. This does not affect the request that is being executed. If you want to stop this this as well, use abort(). .PP See also hasPendingRequests() and abort(). -.SH "int QHttp::closeConnection ()" +.SH "int TQHttp::closeConnection ()" Closes the connection; this is useful if you have a keep-alive connection and want to close it. .PP -For the requests issued with get(), post() and head(), QHttp sets the connection to be keep-alive. You can also do this using the header you pass to the request() function. QHttp only closes the connection to the HTTP server if the response header requires it to do so. +For the requests issued with get(), post() and head(), TQHttp sets the connection to be keep-alive. You can also do this using the header you pass to the request() function. TQHttp only closes the connection to the HTTP server if the response header requires it to do so. .PP The function does not block and returns immediately. The request is scheduled, and its execution is performed asynchronously. The function returns a unique identifier which is passed by requestStarted() and requestFinished(). .PP @@ -351,27 +351,27 @@ When the request is started the requestStarted() signal is emitted. When it is f If you want to close the connection immediately, you have to use abort() instead. .PP See also stateChanged(), abort(), requestStarted(), requestFinished(), and done(). -.SH "TQIODevice * QHttp::currentDestinationDevice () const" +.SH "TQIODevice * TQHttp::currentDestinationDevice () const" Returns the TQIODevice pointer that is used as to store the data of the HTTP request being executed. If there is no current request or if the request does not store the data to an IO device, this function returns 0. .PP This function can be used to delete the TQIODevice in the slot connected to the requestFinished() signal. .PP See also get(), post(), and request(). -.SH "int QHttp::currentId () const" +.SH "int TQHttp::currentId () const" Returns the identifier of the HTTP request being executed or 0 if there is no request being executed (i.e. they've all finished). .PP See also currentRequest(). -.SH "QHttpRequestHeader QHttp::currentRequest () const" -Returns the request header of the HTTP request being executed. If the request is one issued by setHost() or closeConnection(), it returns an invalid request header, i.e. QHttpRequestHeader::isValid() returns FALSE. +.SH "TQHttpRequestHeader TQHttp::currentRequest () const" +Returns the request header of the HTTP request being executed. If the request is one issued by setHost() or closeConnection(), it returns an invalid request header, i.e. TQHttpRequestHeader::isValid() returns FALSE. .PP See also currentId(). -.SH "TQIODevice * QHttp::currentSourceDevice () const" +.SH "TQIODevice * TQHttp::currentSourceDevice () const" Returns the TQIODevice pointer that is used as the data source of the HTTP request being executed. If there is no current request or if the request does not use an IO device as the data source, this function returns 0. .PP This function can be used to delete the TQIODevice in the slot connected to the requestFinished() signal. .PP See also currentDestinationDevice(), post(), and request(). -.SH "void QHttp::dataReadProgress ( int done, int total )\fC [signal]\fR" +.SH "void TQHttp::dataReadProgress ( int done, int total )\fC [signal]\fR" This signal is emitted when this object reads data from a HTTP server to indicate the current progress of the download. .PP \fIdone\fR is the amount of data that has already arrived and \fItotal\fR is the total amount of data. It is possible that the total amount of data that should be transferred cannot be determined, in which case \fItotal\fR is 0.(If you connect to a QProgressBar, the progress bar shows a busy indicator if the total is 0). @@ -379,7 +379,7 @@ This signal is emitted when this object reads data from a HTTP server to indicat \fBWarning:\fR \fIdone\fR and \fItotal\fR are not necessarily the size in bytes, since for large files these values might need to be" scaled" to avoid overflow. .PP See also dataSendProgress(), get(), post(), request(), and QProgressBar::progress. -.SH "void QHttp::dataSendProgress ( int done, int total )\fC [signal]\fR" +.SH "void TQHttp::dataSendProgress ( int done, int total )\fC [signal]\fR" This signal is emitted when this object sends data to a HTTP server to inform it about the progress of the upload. .PP \fIdone\fR is the amount of data that has already arrived and \fItotal\fR is the total amount of data. It is possible that the total amount of data that should be transferred cannot be determined, in which case \fItotal\fR is 0.(If you connect to a QProgressBar, the progress bar shows a busy indicator if the total is 0). @@ -387,17 +387,17 @@ This signal is emitted when this object sends data to a HTTP server to inform it \fBWarning:\fR \fIdone\fR and \fItotal\fR are not necessarily the size in bytes, since for large files these values might need to be" scaled" to avoid overflow. .PP See also dataReadProgress(), post(), request(), and QProgressBar::progress. -.SH "void QHttp::done ( bool error )\fC [signal]\fR" +.SH "void TQHttp::done ( bool error )\fC [signal]\fR" This signal is emitted when the last pending request has finished; (it is emitted after the last request's requestFinished() signal). \fIerror\fR is TRUE if an error occurred during the processing; otherwise \fIerror\fR is FALSE. .PP See also requestFinished(), error(), and errorString(). -.SH "Error QHttp::error () const" +.SH "Error TQHttp::error () const" Returns the last error that occurred. This is useful to find out what happened when receiving a requestFinished() or a done() signal with the \fCerror\fR argument \fCTRUE\fR. .PP If you start a new request, the error status is reset to NoError. -.SH "TQString QHttp::errorString () const" +.SH "TQString TQHttp::errorString () const" Returns a human-readable description of the last error that occurred. This is useful to present a error message to the user when receiving a requestFinished() or a done() signal with the \fCerror\fR argument \fCTRUE\fR. -.SH "int QHttp::get ( const TQString & path, TQIODevice * to = 0 )" +.SH "int TQHttp::get ( const TQString & path, TQIODevice * to = 0 )" Sends a get request for \fIpath\fR to the server set by setHost() or as specified in the constructor. .PP \fIpath\fR must be an absolute path like \fC/index.html\fR or an absolute URI like http://www.trolltech.com/index.html. @@ -411,13 +411,13 @@ The function does not block and returns immediately. The request is scheduled, a When the request is started the requestStarted() signal is emitted. When it is finished the requestFinished() signal is emitted. .PP See also setHost(), post(), head(), request(), requestStarted(), requestFinished(), and done(). -.SH "bool QHttp::hasPendingRequests () const" +.SH "bool TQHttp::hasPendingRequests () const" Returns TRUE if there are any requests scheduled that have not yet been executed; otherwise returns FALSE. .PP The request that is being executed is \fInot\fR considered as a scheduled request. .PP See also clearPendingRequests(), currentId(), and currentRequest(). -.SH "int QHttp::head ( const TQString & path )" +.SH "int TQHttp::head ( const TQString & path )" Sends a header request for \fIpath\fR to the server set by setHost() or as specified in the constructor. .PP \fIpath\fR must be an absolute path like \fC/index.html\fR or an absolute URI like http://www.trolltech.com/index.html. @@ -427,7 +427,7 @@ The function does not block and returns immediately. The request is scheduled, a When the request is started the requestStarted() signal is emitted. When it is finished the requestFinished() signal is emitted. .PP See also setHost(), get(), post(), request(), requestStarted(), requestFinished(), and done(). -.SH "int QHttp::post ( const TQString & path, TQIODevice * data, TQIODevice * to = 0 )" +.SH "int TQHttp::post ( const TQString & path, TQIODevice * data, TQIODevice * to = 0 )" Sends a post request for \fIpath\fR to the server set by setHost() or as specified in the constructor. .PP \fIpath\fR must be an absolute path like \fC/index.html\fR or an absolute URI like http://www.trolltech.com/index.html. @@ -443,19 +443,19 @@ The function does not block and returns immediately. The request is scheduled, a When the request is started the requestStarted() signal is emitted. When it is finished the requestFinished() signal is emitted. .PP See also setHost(), get(), head(), request(), requestStarted(), requestFinished(), and done(). -.SH "int QHttp::post ( const TQString & path, const TQByteArray & data, TQIODevice * to = 0 )" +.SH "int TQHttp::post ( const TQString & path, const TQByteArray & data, TQIODevice * to = 0 )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP \fIdata\fR is used as the content data of the HTTP request. -.SH "TQByteArray QHttp::readAll ()" +.SH "TQByteArray TQHttp::readAll ()" Reads all the bytes from the response content and returns them. .PP See also get(), post(), request(), readyRead(), bytesAvailable(), and readBlock(). -.SH "TQ_LONG QHttp::readBlock ( char * data, TQ_ULONG maxlen )" +.SH "TQ_LONG TQHttp::readBlock ( char * data, TQ_ULONG maxlen )" Reads \fImaxlen\fR bytes from the response content into \fIdata\fR and returns the number of bytes read. Returns -1 if an error occurred. .PP See also get(), post(), request(), readyRead(), bytesAvailable(), and readAll(). -.SH "void QHttp::readyRead ( const QHttpResponseHeader & resp )\fC [signal]\fR" +.SH "void TQHttp::readyRead ( const TQHttpResponseHeader & resp )\fC [signal]\fR" This signal is emitted when there is new response data to read. .PP If you specified a device in the request where the data should be written to, then this signal is \fInot\fR emitted; instead the data is written directly to the device. @@ -467,7 +467,7 @@ You can read the data with the readAll() or readBlock() functions This signal is useful if you want to process the data in chunks as soon as it becomes available. If you are only interested in the complete data, just connect to the requestFinished() signal and read the data then instead. .PP See also get(), post(), request(), readAll(), readBlock(), and bytesAvailable(). -.SH "int QHttp::request ( const QHttpRequestHeader & header, TQIODevice * data = 0, TQIODevice * to = 0 )" +.SH "int TQHttp::request ( const TQHttpRequestHeader & header, TQIODevice * data = 0, TQIODevice * to = 0 )" Sends a request to the server set by setHost() or as specified in the constructor. Uses the \fIheader\fR as the HTTP request header. You are responsible for setting up a header that is appropriate for your request. .PP The incoming data comes via the \fIdata\fR IO device. @@ -481,23 +481,23 @@ The function does not block and returns immediately. The request is scheduled, a When the request is started the requestStarted() signal is emitted. When it is finished the requestFinished() signal is emitted. .PP See also setHost(), get(), post(), head(), requestStarted(), requestFinished(), and done(). -.SH "int QHttp::request ( const QHttpRequestHeader & header, const TQByteArray & data, TQIODevice * to = 0 )" +.SH "int TQHttp::request ( const TQHttpRequestHeader & header, const TQByteArray & data, TQIODevice * to = 0 )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP \fIdata\fR is used as the content data of the HTTP request. -.SH "void QHttp::requestFinished ( int id, bool error )\fC [signal]\fR" +.SH "void TQHttp::requestFinished ( int id, bool error )\fC [signal]\fR" This signal is emitted when processing the request identified by \fIid\fR has finished. \fIerror\fR is TRUE if an error occurred during the processing; otherwise \fIerror\fR is FALSE. .PP See also requestStarted(), done(), error(), and errorString(). -.SH "void QHttp::requestStarted ( int id )\fC [signal]\fR" +.SH "void TQHttp::requestStarted ( int id )\fC [signal]\fR" This signal is emitted when processing the request identified by \fIid\fR starts. .PP See also requestFinished() and done(). -.SH "void QHttp::responseHeaderReceived ( const QHttpResponseHeader & resp )\fC [signal]\fR" +.SH "void TQHttp::responseHeaderReceived ( const TQHttpResponseHeader & resp )\fC [signal]\fR" This signal is emitted when the HTTP header of a server response is available. The header is passed in \fIresp\fR. .PP See also get(), post(), head(), request(), and readyRead(). -.SH "int QHttp::setHost ( const TQString & hostname, TQ_UINT16 port = 80 )" +.SH "int TQHttp::setHost ( const TQString & hostname, TQ_UINT16 port = 80 )" Sets the HTTP server that is used for requests to \fIhostname\fR on port \fIport\fR. .PP The function does not block and returns immediately. The request is scheduled, and its execution is performed asynchronously. The function returns a unique identifier which is passed by requestStarted() and requestFinished(). @@ -505,19 +505,19 @@ The function does not block and returns immediately. The request is scheduled, a When the request is started the requestStarted() signal is emitted. When it is finished the requestFinished() signal is emitted. .PP See also get(), post(), head(), request(), requestStarted(), requestFinished(), and done(). -.SH "State QHttp::state () const" +.SH "State TQHttp::state () const" Returns the current state of the object. When the state changes, the stateChanged() signal is emitted. .PP See also State and stateChanged(). -.SH "void QHttp::stateChanged ( int state )\fC [signal]\fR" -This signal is emitted when the state of the QHttp object changes. The argument \fIstate\fR is the new state of the connection; it is one of the State values. +.SH "void TQHttp::stateChanged ( int state )\fC [signal]\fR" +This signal is emitted when the state of the TQHttp object changes. The argument \fIstate\fR is the new state of the connection; it is one of the State values. .PP This usually happens when a request is started, but it can also happen when the server closes the connection or when a call to closeConnection() succeeded. .PP See also get(), post(), head(), request(), closeConnection(), state(), and State. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqhttp.html +.BR http://doc.trolltech.com/tqhttp.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqhttpheader.3qt b/doc/man/man3/tqhttpheader.3qt index 22b86fdd1..eb9bf96a9 100644 --- a/doc/man/man3/tqhttpheader.3qt +++ b/doc/man/man3/tqhttpheader.3qt @@ -1,5 +1,5 @@ '\" t -.TH QHttpHeader 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQHttpHeader 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,28 +7,28 @@ .ad l .nh .SH NAME -QHttpHeader \- Header information for HTTP +TQHttpHeader \- Header information for HTTP .SH SYNOPSIS -\fC#include <ntqhttp.h>\fR +\fC#include <tqhttp.h>\fR .PP -Inherited by QHttpResponseHeader and QHttpRequestHeader. +Inherited by TQHttpResponseHeader and TQHttpRequestHeader. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQHttpHeader\fR ()" +.BI "\fBTQHttpHeader\fR ()" .br .ti -1c -.BI "\fBQHttpHeader\fR ( const QHttpHeader & header )" +.BI "\fBTQHttpHeader\fR ( const TQHttpHeader & header )" .br .ti -1c -.BI "\fBQHttpHeader\fR ( const TQString & str )" +.BI "\fBTQHttpHeader\fR ( const TQString & str )" .br .ti -1c -.BI "virtual \fB~QHttpHeader\fR ()" +.BI "virtual \fB~TQHttpHeader\fR ()" .br .ti -1c -.BI "QHttpHeader & \fBoperator=\fR ( const QHttpHeader & h )" +.BI "TQHttpHeader & \fBoperator=\fR ( const TQHttpHeader & h )" .br .ti -1c .BI "TQString \fBvalue\fR ( const TQString & key ) const" @@ -77,11 +77,11 @@ Inherited by QHttpResponseHeader and QHttpRequestHeader. .br .in -1c .SH DESCRIPTION -The QHttpHeader class contains header information for HTTP. +The TQHttpHeader class contains header information for HTTP. .PP -In most cases you should use the more specialized derivatives of this class, QHttpResponseHeader and QHttpRequestHeader, rather than directly using QHttpHeader. +In most cases you should use the more specialized derivatives of this class, TQHttpResponseHeader and TQHttpRequestHeader, rather than directly using TQHttpHeader. .PP -QHttpHeader provides the HTTP header fields. A HTTP header field consists of a name followed by a colon, a single space, and the field value. (See RFC 1945.) Field names are case-insensitive. A typical header field looks like this: +TQHttpHeader provides the HTTP header fields. A HTTP header field consists of a name followed by a colon, a single space, and the field value. (See RFC 1945.) Field names are case-insensitive. A typical header field looks like this: .PP .nf .br @@ -103,71 +103,71 @@ Some fields are so common that getters and setters are provided for them as a co .PP Each header key has a \fIsingle\fR value associated with it. If you set the value for a key which already exists the previous value will be discarded. .PP -See also QHttpRequestHeader, QHttpResponseHeader, and Input/Output and Networking. +See also TQHttpRequestHeader, TQHttpResponseHeader, and Input/Output and Networking. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QHttpHeader::QHttpHeader ()" +.SH "TQHttpHeader::TQHttpHeader ()" Constructs an empty HTTP header. -.SH "QHttpHeader::QHttpHeader ( const QHttpHeader & header )" +.SH "TQHttpHeader::TQHttpHeader ( const TQHttpHeader & header )" Constructs a copy of \fIheader\fR. -.SH "QHttpHeader::QHttpHeader ( const TQString & str )" +.SH "TQHttpHeader::TQHttpHeader ( const TQString & str )" Constructs a HTTP header for \fIstr\fR. .PP This constructor parses the string \fIstr\fR for header fields and adds this information. The \fIstr\fR should consist of one or more" \\r\\n" delimited lines; each of these lines should have the format key, colon, space, value. -.SH "QHttpHeader::~QHttpHeader ()\fC [virtual]\fR" +.SH "TQHttpHeader::~TQHttpHeader ()\fC [virtual]\fR" Destructor. -.SH "uint QHttpHeader::contentLength () const" +.SH "uint TQHttpHeader::contentLength () const" Returns the value of the special HTTP header field \fCcontent-length\fR. .PP See also setContentLength() and hasContentLength(). -.SH "TQString QHttpHeader::contentType () const" +.SH "TQString TQHttpHeader::contentType () const" Returns the value of the special HTTP header field \fCcontent-type\fR. .PP See also setContentType() and hasContentType(). -.SH "bool QHttpHeader::hasContentLength () const" +.SH "bool TQHttpHeader::hasContentLength () const" Returns TRUE if the header has an entry for the special HTTP header field \fCcontent-length\fR; otherwise returns FALSE. .PP See also contentLength() and setContentLength(). -.SH "bool QHttpHeader::hasContentType () const" +.SH "bool TQHttpHeader::hasContentType () const" Returns TRUE if the header has an entry for the the special HTTP header field \fCcontent-type\fR; otherwise returns FALSE. .PP See also contentType() and setContentType(). -.SH "bool QHttpHeader::hasKey ( const TQString & key ) const" +.SH "bool TQHttpHeader::hasKey ( const TQString & key ) const" Returns TRUE if the HTTP header has an entry with the given \fIkey\fR; otherwise returns FALSE. .PP See also value(), setValue(), and keys(). -.SH "bool QHttpHeader::isValid () const" +.SH "bool TQHttpHeader::isValid () const" Returns TRUE if the HTTP header is valid; otherwise returns FALSE. .PP -A QHttpHeader is invalid if it was created by parsing a malformed string. -.SH "TQStringList QHttpHeader::keys () const" +A TQHttpHeader is invalid if it was created by parsing a malformed string. +.SH "TQStringList TQHttpHeader::keys () const" Returns a list of the keys in the HTTP header. .PP See also hasKey(). -.SH "int QHttpHeader::majorVersion () const\fC [pure virtual]\fR" +.SH "int TQHttpHeader::majorVersion () const\fC [pure virtual]\fR" Returns the major protocol-version of the HTTP header. .PP -Reimplemented in QHttpResponseHeader and QHttpRequestHeader. -.SH "int QHttpHeader::minorVersion () const\fC [pure virtual]\fR" +Reimplemented in TQHttpResponseHeader and TQHttpRequestHeader. +.SH "int TQHttpHeader::minorVersion () const\fC [pure virtual]\fR" Returns the minor protocol-version of the HTTP header. .PP -Reimplemented in QHttpResponseHeader and QHttpRequestHeader. -.SH "QHttpHeader & QHttpHeader::operator= ( const QHttpHeader & h )" +Reimplemented in TQHttpResponseHeader and TQHttpRequestHeader. +.SH "TQHttpHeader & TQHttpHeader::operator= ( const TQHttpHeader & h )" Assigns \fIh\fR and returns a reference to this http header. -.SH "void QHttpHeader::removeValue ( const TQString & key )" +.SH "void TQHttpHeader::removeValue ( const TQString & key )" Removes the entry with the key \fIkey\fR from the HTTP header. .PP See also value() and setValue(). -.SH "void QHttpHeader::setContentLength ( int len )" +.SH "void TQHttpHeader::setContentLength ( int len )" Sets the value of the special HTTP header field \fCcontent-length\fR to \fIlen\fR. .PP See also contentLength() and hasContentLength(). -.SH "void QHttpHeader::setContentType ( const TQString & type )" +.SH "void TQHttpHeader::setContentType ( const TQString & type )" Sets the value of the special HTTP header field \fCcontent-type\fR to \fItype\fR. .PP See also contentType() and hasContentType(). .PP Example: network/archivesearch/archivedialog.ui.h. -.SH "void QHttpHeader::setValue ( const TQString & key, const TQString & value )" +.SH "void TQHttpHeader::setValue ( const TQString & key, const TQString & value )" Sets the value of the entry with the \fIkey\fR to \fIvalue\fR. .PP If no entry with \fIkey\fR exists, a new entry with the given \fIkey\fR and \fIvalue\fR is created. If an entry with the \fIkey\fR already exists, its value is discarded and replaced with the given \fIvalue\fR. @@ -175,17 +175,17 @@ If no entry with \fIkey\fR exists, a new entry with the given \fIkey\fR and \fIv See also value(), hasKey(), and removeValue(). .PP Example: network/archivesearch/archivedialog.ui.h. -.SH "TQString QHttpHeader::toString () const\fC [virtual]\fR" +.SH "TQString TQHttpHeader::toString () const\fC [virtual]\fR" Returns a string representation of the HTTP header. .PP The string is suitable for use by the constructor that takes a TQString. It consists of lines with the format: key, colon, space, value, "\\r\\n". -.SH "TQString QHttpHeader::value ( const TQString & key ) const" +.SH "TQString TQHttpHeader::value ( const TQString & key ) const" Returns the value for the entry with the given \fIkey\fR. If no entry has this \fIkey\fR, an empty string is returned. .PP See also setValue(), removeValue(), hasKey(), and keys(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/qhttpheader.html +.BR http://doc.trolltech.com/tqhttpheader.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqhttprequestheader.3qt b/doc/man/man3/tqhttprequestheader.3qt index f7caa30d1..7f21e40ae 100644 --- a/doc/man/man3/tqhttprequestheader.3qt +++ b/doc/man/man3/tqhttprequestheader.3qt @@ -1,5 +1,5 @@ '\" t -.TH QHttpRequestHeader 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQHttpRequestHeader 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,25 +7,25 @@ .ad l .nh .SH NAME -QHttpRequestHeader \- Request header information for HTTP +TQHttpRequestHeader \- Request header information for HTTP .SH SYNOPSIS -\fC#include <ntqhttp.h>\fR +\fC#include <tqhttp.h>\fR .PP -Inherits QHttpHeader. +Inherits TQHttpHeader. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQHttpRequestHeader\fR ()" +.BI "\fBTQHttpRequestHeader\fR ()" .br .ti -1c -.BI "\fBQHttpRequestHeader\fR ( const TQString & method, const TQString & path, int majorVer = 1, int minorVer = 1 )" +.BI "\fBTQHttpRequestHeader\fR ( const TQString & method, const TQString & path, int majorVer = 1, int minorVer = 1 )" .br .ti -1c -.BI "\fBQHttpRequestHeader\fR ( const QHttpRequestHeader & header )" +.BI "\fBTQHttpRequestHeader\fR ( const TQHttpRequestHeader & header )" .br .ti -1c -.BI "\fBQHttpRequestHeader\fR ( const TQString & str )" +.BI "\fBTQHttpRequestHeader\fR ( const TQString & str )" .br .ti -1c .BI "void \fBsetRequest\fR ( const TQString & method, const TQString & path, int majorVer = 1, int minorVer = 1 )" @@ -53,52 +53,52 @@ Inherits QHttpHeader. .br .in -1c .SH DESCRIPTION -The QHttpRequestHeader class contains request header information for HTTP. +The TQHttpRequestHeader class contains request header information for HTTP. .PP -This class is used in the QHttp class to report the header information if the client requests something from the server. +This class is used in the TQHttp class to report the header information if the client requests something from the server. .PP HTTP requests have a method which describes the request's action. The most common requests are "GET" and "POST". In addition to the request method the header also includes a request-URI to specify the location for the method to use. .PP The method, request-URI and protocol-version can be set using a constructor or later using setRequest(). The values can be obtained using method(), path(), majorVersion() and minorVersion(). .PP -This class is a QHttpHeader subclass so that class's functions, e.g. setValue(), value(), etc. are also available. +This class is a TQHttpHeader subclass so that class's functions, e.g. setValue(), value(), etc. are also available. .PP -See also QHttpResponseHeader, QHttp, and Input/Output and Networking. +See also TQHttpResponseHeader, TQHttp, and Input/Output and Networking. .PP .SH MEMBER FUNCTION DOCUMENTATION -.SH "QHttpRequestHeader::QHttpRequestHeader ()" +.SH "TQHttpRequestHeader::TQHttpRequestHeader ()" Constructs an empty HTTP request header. -.SH "QHttpRequestHeader::QHttpRequestHeader ( const TQString & method, const TQString & path, int majorVer = 1, int minorVer = 1 )" +.SH "TQHttpRequestHeader::TQHttpRequestHeader ( const TQString & method, const TQString & path, int majorVer = 1, int minorVer = 1 )" Constructs a HTTP request header for the method \fImethod\fR, the request-URI \fIpath\fR and the protocol-version \fImajorVer\fR and \fIminorVer\fR. -.SH "QHttpRequestHeader::QHttpRequestHeader ( const QHttpRequestHeader & header )" +.SH "TQHttpRequestHeader::TQHttpRequestHeader ( const TQHttpRequestHeader & header )" Constructs a copy of \fIheader\fR. -.SH "QHttpRequestHeader::QHttpRequestHeader ( const TQString & str )" +.SH "TQHttpRequestHeader::TQHttpRequestHeader ( const TQString & str )" Constructs a HTTP request header from the string \fIstr\fR. The \fIstr\fR should consist of one or more "\\r\\n" delimited lines; the first line should be the request-line (format: method, space, request-URI, space HTTP-version); each of the remaining lines should have the format key, colon, space, value. -.SH "int QHttpRequestHeader::majorVersion () const\fC [virtual]\fR" +.SH "int TQHttpRequestHeader::majorVersion () const\fC [virtual]\fR" Returns the major protocol-version of the HTTP request header. .PP See also minorVersion(), method(), path(), and setRequest(). .PP -Reimplemented from QHttpHeader. -.SH "TQString QHttpRequestHeader::method () const" +Reimplemented from TQHttpHeader. +.SH "TQString TQHttpRequestHeader::method () const" Returns the method of the HTTP request header. .PP See also path(), majorVersion(), minorVersion(), and setRequest(). -.SH "int QHttpRequestHeader::minorVersion () const\fC [virtual]\fR" +.SH "int TQHttpRequestHeader::minorVersion () const\fC [virtual]\fR" Returns the minor protocol-version of the HTTP request header. .PP See also majorVersion(), method(), path(), and setRequest(). .PP -Reimplemented from QHttpHeader. -.SH "TQString QHttpRequestHeader::path () const" +Reimplemented from TQHttpHeader. +.SH "TQString TQHttpRequestHeader::path () const" Returns the request-URI of the HTTP request header. .PP See also method(), majorVersion(), minorVersion(), and setRequest(). -.SH "void QHttpRequestHeader::setRequest ( const TQString & method, const TQString & path, int majorVer = 1, int minorVer = 1 )" +.SH "void TQHttpRequestHeader::setRequest ( const TQString & method, const TQString & path, int majorVer = 1, int minorVer = 1 )" This function sets the request method to \fImethod\fR, the request-URI to \fIpath\fR and the protocol-version to \fImajorVer\fR and \fIminorVer\fR. .PP See also method(), path(), majorVersion(), and minorVersion(). -.SH "void QHttpHeader::setValue ( const TQString & key, const TQString & value )" +.SH "void TQHttpHeader::setValue ( const TQString & key, const TQString & value )" Sets the value of the entry with the \fIkey\fR to \fIvalue\fR. .PP If no entry with \fIkey\fR exists, a new entry with the given \fIkey\fR and \fIvalue\fR is created. If an entry with the \fIkey\fR already exists, its value is discarded and replaced with the given \fIvalue\fR. @@ -106,13 +106,13 @@ If no entry with \fIkey\fR exists, a new entry with the given \fIkey\fR and \fIv See also value(), hasKey(), and removeValue(). .PP Example: network/archivesearch/archivedialog.ui.h. -.SH "TQString QHttpHeader::value ( const TQString & key ) const" +.SH "TQString TQHttpHeader::value ( const TQString & key ) const" Returns the value for the entry with the given \fIkey\fR. If no entry has this \fIkey\fR, an empty string is returned. .PP See also setValue(), removeValue(), hasKey(), and keys(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/qhttprequestheader.html +.BR http://doc.trolltech.com/tqhttprequestheader.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqhttpresponseheader.3qt b/doc/man/man3/tqhttpresponseheader.3qt index c0fbbb496..ca1d82803 100644 --- a/doc/man/man3/tqhttpresponseheader.3qt +++ b/doc/man/man3/tqhttpresponseheader.3qt @@ -1,5 +1,5 @@ '\" t -.TH QHttpResponseHeader 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQHttpResponseHeader 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,19 +7,19 @@ .ad l .nh .SH NAME -QHttpResponseHeader \- Response header information for HTTP +TQHttpResponseHeader \- Response header information for HTTP .SH SYNOPSIS -\fC#include <ntqhttp.h>\fR +\fC#include <tqhttp.h>\fR .PP -Inherits QHttpHeader. +Inherits TQHttpHeader. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQHttpResponseHeader\fR ()" +.BI "\fBTQHttpResponseHeader\fR ()" .br .ti -1c -.BI "\fBQHttpResponseHeader\fR ( const QHttpResponseHeader & header )" +.BI "\fBTQHttpResponseHeader\fR ( const TQHttpResponseHeader & header )" .br .ti -1c .BI "int \fBstatusCode\fR () const" @@ -35,41 +35,41 @@ Inherits QHttpHeader. .br .in -1c .SH DESCRIPTION -The QHttpResponseHeader class contains response header information for HTTP. +The TQHttpResponseHeader class contains response header information for HTTP. .PP -This class is used by the QHttp class to report the header information that the client received from the server. +This class is used by the TQHttp class to report the header information that the client received from the server. .PP HTTP responses have a status code that indicates the status of the response. This code is a 3-digit integer result code (for details see to RFC 1945). In addition to the status code, you can also specify a human-readable text that describes the reason for the code ("reason phrase"). This class allows you to get the status code and the reason phrase. .PP -See also QHttpRequestHeader, QHttp, and Input/Output and Networking. +See also TQHttpRequestHeader, TQHttp, and Input/Output and Networking. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QHttpResponseHeader::QHttpResponseHeader ()" +.SH "TQHttpResponseHeader::TQHttpResponseHeader ()" Constructs an empty HTTP response header. -.SH "QHttpResponseHeader::QHttpResponseHeader ( const QHttpResponseHeader & header )" +.SH "TQHttpResponseHeader::TQHttpResponseHeader ( const TQHttpResponseHeader & header )" Constructs a copy of \fIheader\fR. -.SH "int QHttpResponseHeader::majorVersion () const\fC [virtual]\fR" +.SH "int TQHttpResponseHeader::majorVersion () const\fC [virtual]\fR" Returns the major protocol-version of the HTTP response header. .PP See also minorVersion(), statusCode(), and reasonPhrase(). .PP -Reimplemented from QHttpHeader. -.SH "int QHttpResponseHeader::minorVersion () const\fC [virtual]\fR" +Reimplemented from TQHttpHeader. +.SH "int TQHttpResponseHeader::minorVersion () const\fC [virtual]\fR" Returns the minor protocol-version of the HTTP response header. .PP See also majorVersion(), statusCode(), and reasonPhrase(). .PP -Reimplemented from QHttpHeader. -.SH "TQString QHttpResponseHeader::reasonPhrase () const" +Reimplemented from TQHttpHeader. +.SH "TQString TQHttpResponseHeader::reasonPhrase () const" Returns the reason phrase of the HTTP response header. .PP See also statusCode(), majorVersion(), and minorVersion(). -.SH "int QHttpResponseHeader::statusCode () const" +.SH "int TQHttpResponseHeader::statusCode () const" Returns the status code of the HTTP response header. .PP See also reasonPhrase(), majorVersion(), and minorVersion(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/qhttpresponseheader.html +.BR http://doc.trolltech.com/tqhttpresponseheader.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqicondrag.3qt b/doc/man/man3/tqicondrag.3qt index a6e25eb2e..ca838bfaf 100644 --- a/doc/man/man3/tqicondrag.3qt +++ b/doc/man/man3/tqicondrag.3qt @@ -43,7 +43,7 @@ If you want to use the extended drag-and-drop functionality of TQIconView, creat .PP The data in TQIconDragItems is stored in a TQByteArray and is mime-typed (see TQMimeSource and the Drag and Drop overview). If you want to use your own mime-types derive a class from TQIconDrag and reimplement format(), encodedData() and canDecode(). .PP -The fileiconview example program demonstrates the use of the TQIconDrag class including subclassing and reimplementing dragObject(), format(), encodedData() and canDecode(). See the files \fCqt/examples/fileiconview/qfileiconview.h\fR and \fCqt/examples/fileiconview/qfileiconview.cpp\fR. +The fileiconview example program demonstrates the use of the TQIconDrag class including subclassing and reimplementing dragObject(), format(), encodedData() and canDecode(). See the files \fCqt/examples/fileiconview/tqfileiconview.h\fR and \fCqt/examples/fileiconview/tqfileiconview.cpp\fR. .PP See also TQMimeSource::format() and Drag And Drop Classes. .SH MEMBER FUNCTION DOCUMENTATION @@ -58,15 +58,15 @@ Append the TQIconDragItem, \fIi\fR, to the TQIconDrag object's list of items. Yo .PP See also TQIconDragItem. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "bool TQIconDrag::canDecode ( TQMimeSource * e )\fC [static]\fR" Returns TRUE if \fIe\fR can be decoded by the TQIconDrag, otherwise return FALSE. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "TQByteArray TQIconDrag::encodedData ( const char * mime ) const\fC [virtual]\fR" Returns the encoded data of the drag object if \fImime\fR is application/x-qiconlist. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .PP Reimplemented from TQMimeSource. diff --git a/doc/man/man3/tqicondragitem.3qt b/doc/man/man3/tqicondragitem.3qt index b048ce797..0ff5ad506 100644 --- a/doc/man/man3/tqicondragitem.3qt +++ b/doc/man/man3/tqicondragitem.3qt @@ -35,7 +35,7 @@ In practice a TQIconDragItem object (or an object of a class derived from TQIcon .PP See TQIconView::dragObject() for more information. .PP -See the fileiconview/qfileiconview.cpp and iconview/simple_dd/main.cpp examples. +See the fileiconview/tqfileiconview.cpp and iconview/simple_dd/main.cpp examples. .PP See also Drag And Drop Classes. .SH MEMBER FUNCTION DOCUMENTATION @@ -48,7 +48,7 @@ Returns the data contained in the TQIconDragItem. .SH "void TQIconDragItem::setData ( const TQByteArray & d )\fC [virtual]\fR" Sets the data for the TQIconDragItem to the data stored in the TQByteArray \fId\fR. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "SEE ALSO" .BR http://doc.trolltech.com/tqicondragitem.html diff --git a/doc/man/man3/tqiconview.3qt b/doc/man/man3/tqiconview.3qt index 36090a06d..b58d7bae4 100644 --- a/doc/man/man3/tqiconview.3qt +++ b/doc/man/man3/tqiconview.3qt @@ -368,7 +368,7 @@ The simplest way to create a TQIconView is to create a TQIconView object and cre .br TQIconView *iv = new TQIconView( this ); .br - QDir dir( path, "*.xpm" ); + TQDir dir( path, "*.xpm" ); .br for ( uint i = 0; i < dir.count(); i++ ) { .br @@ -524,7 +524,7 @@ This variant uses \fIgrid\fR instead of (gridX(), gridY()). If \fIgrid\fR is inv .PP If \fIupdate\fR is TRUE (the default) the viewport is repainted. .PP -Example: fileiconview/qfileiconview.h. +Example: fileiconview/tqfileiconview.h. .SH "void TQIconView::arrangeItemsInGrid ( bool update = TRUE )\fC [virtual slot]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP @@ -579,7 +579,7 @@ Returns the TQDragObject that should be used for drag-and-drop. This function is See also TQIconDrag. .PP Examples: -.)l fileiconview/qfileiconview.cpp and iconview/simple_dd/main.cpp. +.)l fileiconview/tqfileiconview.cpp and iconview/simple_dd/main.cpp. .SH "void TQIconView::drawBackground ( QPainter * p, const QRect & r )\fC [virtual protected]\fR" This function is called to draw the rectangle \fIr\fR of the background using the painter \fIp\fR. .PP diff --git a/doc/man/man3/tqiconviewitem.3qt b/doc/man/man3/tqiconviewitem.3qt index 2206b962b..9b680ba4f 100644 --- a/doc/man/man3/tqiconviewitem.3qt +++ b/doc/man/man3/tqiconviewitem.3qt @@ -288,7 +288,7 @@ Returns TRUE if you can drop things with a TQMimeSource of \fImime\fR onto this The default implementation always returns FALSE. You must subclass TQIconViewItem and reimplement acceptDrop() to accept drops. .PP Examples: -.)l fileiconview/qfileiconview.cpp and iconview/simple_dd/main.cpp. +.)l fileiconview/tqfileiconview.cpp and iconview/simple_dd/main.cpp. .SH "void TQIconViewItem::calcRect ( const TQString & text_ = TQString::null )\fC [virtual protected]\fR" This virtual function is responsible for calculating the rectangles returned by rect(), textRect() and pixmapRect(). setRect(), setTextRect() and setPixmapRect() are provided mainly for reimplementations of this function. .PP @@ -322,13 +322,13 @@ This function is called when a drag enters the item's bounding rectangle. .PP The default implementation does nothing; subclasses may reimplement this function. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "void TQIconViewItem::dragLeft ()\fC [virtual protected]\fR" This function is called when a drag leaves the item's bounding rectangle. .PP The default implementation does nothing; subclasses may reimplement this function. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "bool TQIconViewItem::dropEnabled () const" Returns TRUE if the user is allowed to drop something onto the item; otherwise returns FALSE. .PP @@ -339,7 +339,7 @@ This function is called when something is dropped on the item. \fIe\fR provides The default implementation does nothing; subclasses may reimplement this function. .PP Examples: -.)l fileiconview/qfileiconview.cpp and iconview/simple_dd/main.cpp. +.)l fileiconview/tqfileiconview.cpp and iconview/simple_dd/main.cpp. .SH "int TQIconViewItem::height () const" Returns the height of the item. .SH "TQIconView * TQIconViewItem::iconView () const" @@ -357,7 +357,7 @@ Returns TRUE if the item is selected; otherwise returns FALSE. .PP See also setSelected(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "TQString TQIconViewItem::key () const\fC [virtual]\fR" Returns the key of the icon view item or text() if no key has been explicitly set. .PP @@ -393,13 +393,13 @@ Example: .PP See also prevItem(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "void TQIconViewItem::paintFocus ( QPainter * p, const QColorGroup & cg )\fC [virtual protected]\fR" Paints the focus rectangle of the item using the painter \fIp\fR and the color group \fIcg\fR. .SH "void TQIconViewItem::paintItem ( QPainter * p, const QColorGroup & cg )\fC [virtual protected]\fR" Paints the item using the painter \fIp\fR and the color group \fIcg\fR. If you want the item to be drawn with a different font or color, reimplement this function, change the values of the color group or the painter's font, and then call the TQIconViewItem::paintItem() with the changed values. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "QPicture * TQIconViewItem::picture () const\fC [virtual]\fR" Returns the icon of the icon view item if it is a picture, or 0 if it is a pixmap. In the latter case use pixmap() instead. Normally you set the picture of the item with setPicture(), but sometimes it's inconvenient to call setPicture() for every item. So you can subclass TQIconViewItem, reimplement this function and return a pointer to the item's picture. If you do this, you \fImust\fR call calcRect() manually each time the size of this picture changes. .PP @@ -409,13 +409,13 @@ Returns the icon of the icon view item if it is a pixmap, or 0 if it is a pictur .PP See also setPixmap(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "QRect TQIconViewItem::pixmapRect ( bool relative = TRUE ) const" Returns the bounding rectangle of the item's icon. .PP If \fIrelative\fR is TRUE, (the default), the rectangle is relative to the origin of the item's rectangle. If \fIrelative\fR is FALSE, the returned rectangle is relative to the origin of the icon view's contents coordinate system. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "QPoint TQIconViewItem::pos () const" Returns the position of the item (in contents coordinates). .SH "TQIconViewItem * TQIconViewItem::prevItem () const" @@ -433,13 +433,13 @@ This function sets up the icon view so that the user can edit the item text, and .PP See also setRenameEnabled(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "bool TQIconViewItem::renameEnabled () const" Returns TRUE if the item can be renamed by the user with in-place renaming; otherwise returns FALSE. .PP See also setRenameEnabled(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "void TQIconViewItem::repaint ()\fC [virtual]\fR" Repaints the item. .SH "int TQIconViewItem::rtti () const\fC [virtual]\fR" @@ -459,7 +459,7 @@ Sets \fIk\fR as the sort key of the icon view item. By default text() is used fo .PP See also compare(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "void TQIconViewItem::setPicture ( const QPicture & icon )\fC [virtual]\fR" Sets \fIicon\fR as the item's icon in the icon view. This function might be a no-op if you reimplement picture(). .PP @@ -486,7 +486,7 @@ See also calcRect(), pixmapRect(), setItemRect(), and setTextRect(). If \fIallow\fR is TRUE, the user can rename the icon view item by clicking on the text (or pressing F2) while the item is selected (in-place renaming). If \fIallow\fR is FALSE, in-place renaming is not possible. .PP Examples: -.)l fileiconview/qfileiconview.cpp, iconview/main.cpp, and iconview/simple_dd/main.cpp. +.)l fileiconview/tqfileiconview.cpp, iconview/main.cpp, and iconview/simple_dd/main.cpp. .SH "void TQIconViewItem::setSelectable ( bool enable )\fC [virtual]\fR" Sets this item to be selectable if \fIenable\fR is TRUE (the default) or unselectable if \fIenable\fR is FALSE. .PP @@ -508,7 +508,7 @@ Note that \fIcb\fR is used only if TQIconView::selectionMode() is \fCExtended\fR .PP All items whose selection status changes repaint themselves. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "void TQIconViewItem::setSelected ( bool s )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP @@ -518,7 +518,7 @@ Sets \fItext\fR as the text of the icon view item. This function might be a no-o .PP See also text(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "void TQIconViewItem::setText ( const TQString & text, bool recalc, bool redraw = TRUE )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP @@ -536,13 +536,13 @@ Returns the text of the icon view item. Normally you set the text of the item wi .PP See also setText(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "QRect TQIconViewItem::textRect ( bool relative = TRUE ) const" Returns the bounding rectangle of the item's text. .PP If \fIrelative\fR is TRUE, (the default), the returned rectangle is relative to the origin of the item's rectangle. If \fIrelative\fR is FALSE, the returned rectangle is relative to the origin of the icon view's contents coordinate system. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "int TQIconViewItem::width () const" Returns the width of the item. .SH "int TQIconViewItem::x () const" diff --git a/doc/man/man3/tqimage.3qt b/doc/man/man3/tqimage.3qt index 0923308da..7db34b273 100644 --- a/doc/man/man3/tqimage.3qt +++ b/doc/man/man3/tqimage.3qt @@ -293,10 +293,10 @@ TQImage \- Hardware-independent pixmap representation with direct access to the .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQImage & image )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQImage & image )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQImage & image )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQImage & image )" .br .ti -1c .BI "void \fBbitBlt\fR ( TQImage * dst, int dx, int dy, const TQImage * src, int sx, int sy, int sw, int sh, int conversion_flags )" @@ -821,7 +821,7 @@ This function writes a TQImage to the TQIODevice, \fIdevice\fR. This can be used .br TQByteArray ba; .br - QBuffer buffer( ba ); + TQBuffer buffer( ba ); .br buffer.open( IO_WriteOnly ); .br @@ -1046,16 +1046,16 @@ The copying is clipped if areas outside \fIsrc\fR or \fIdst\fR are specified. If \fIsw\fR is -1, it is adjusted to src->width(). Similarly, if \fIsh\fR is -1, it is adjusted to src->height(). .PP Currently inefficient for non 32-bit images. -.SH "QDataStream & operator<< ( QDataStream & s, const TQImage & image )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQImage & image )" Writes the image \fIimage\fR to the stream \fIs\fR as a PNG image, or as a BMP image if the stream's version is 1. .PP Note that writing the stream to a file will not produce a valid image file. .PP -See also TQImage::save() and Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, TQImage & image )" +See also TQImage::save() and Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, TQImage & image )" Reads an image from the stream \fIs\fR and stores it in \fIimage\fR. .PP -See also TQImage::load() and Format of the QDataStream operators. +See also TQImage::load() and Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/tqimage.html diff --git a/doc/man/man3/tqimageio.3qt b/doc/man/man3/tqimageio.3qt index 57befd609..4e17954c7 100644 --- a/doc/man/man3/tqimageio.3qt +++ b/doc/man/man3/tqimageio.3qt @@ -121,7 +121,7 @@ PBM, PGM, and PPM format \fIoutput\fR is always in the more condensed raw format .PP GIF support may be removed completely in a future version of Qt. We recommend using the PNG format. .PP -See also TQImage, QPixmap, QFile, QMovie, Graphics Classes, Image Processing Classes, and Input/Output and Networking. +See also TQImage, QPixmap, TQFile, QMovie, Graphics Classes, Image Processing Classes, and Input/Output and Networking. .SH MEMBER FUNCTION DOCUMENTATION .SH "TQImageIO::TQImageIO ()" Constructs a TQImageIO object with all parameters set to zero. diff --git a/doc/man/man3/tqintdict.3qt b/doc/man/man3/tqintdict.3qt index 71d58c019..7e97f6d69 100644 --- a/doc/man/man3/tqintdict.3qt +++ b/doc/man/man3/tqintdict.3qt @@ -76,10 +76,10 @@ Inherits TQPtrCollection. .SS "Protected Members" .in +1c .ti -1c -.BI "virtual QDataStream & \fBread\fR ( QDataStream & s, TQPtrCollection::Item & item )" +.BI "virtual TQDataStream & \fBread\fR ( TQDataStream & s, TQPtrCollection::Item & item )" .br .ti -1c -.BI "virtual QDataStream & \fBwrite\fR ( QDataStream & s, TQPtrCollection::Item ) const" +.BI "virtual TQDataStream & \fBwrite\fR ( TQDataStream & s, TQPtrCollection::Item ) const" .br .in -1c .SH DESCRIPTION @@ -207,7 +207,7 @@ If there are two or more items with equal keys, then the most recently inserted Equivalent to the find() function. .PP See also find(). -.SH "QDataStream & TQIntDict::read ( QDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" +.SH "TQDataStream & TQIntDict::read ( TQDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" Reads a dictionary item from the stream \fIs\fR and returns a reference to the stream. .PP The default implementation sets \fIitem\fR to 0. @@ -284,7 +284,7 @@ All dictionary iterators that refer to the taken item will be set to point to th See also remove(), clear(), and setAutoDelete(). .PP Example: table/bigtable/main.cpp. -.SH "QDataStream & TQIntDict::write ( QDataStream & s, TQPtrCollection::Item ) const\fC [virtual protected]\fR" +.SH "TQDataStream & TQIntDict::write ( TQDataStream & s, TQPtrCollection::Item ) const\fC [virtual protected]\fR" Writes a dictionary item to the stream \fIs\fR and returns a reference to the stream. .PP See also read(). diff --git a/doc/man/man3/tqiodevice.3qt b/doc/man/man3/tqiodevice.3qt index 4974d1058..f2675e624 100644 --- a/doc/man/man3/tqiodevice.3qt +++ b/doc/man/man3/tqiodevice.3qt @@ -11,9 +11,9 @@ TQIODevice \- The base class of I/O devices .SH SYNOPSIS All the functions in this class are reentrant when TQt is built with thread support.</p> .PP -\fC#include <ntqiodevice.h>\fR +\fC#include <tqiodevice.h>\fR .PP -Inherited by QBuffer, QFile, QSocket, and QSocketDevice. +Inherited by TQBuffer, TQFile, TQSocket, and TQSocketDevice. .PP .SS "Public Members" .in +1c @@ -21,7 +21,7 @@ Inherited by QBuffer, QFile, QSocket, and QSocketDevice. .BI "typedef TQ_ULONG \fBOffset\fR" .br .ti -1c -.BI "\fBQIODevice\fR ()" +.BI "\fBTQIODevice\fR ()" .br .ti -1c .BI "virtual \fB~TQIODevice\fR ()" @@ -150,9 +150,9 @@ Inherited by QBuffer, QFile, QSocket, and QSocketDevice. .SH DESCRIPTION The TQIODevice class is the base class of I/O devices. .PP -An I/O device represents a medium that one can read bytes from and/or write bytes to. The TQIODevice class is the abstract superclass of all such devices; classes such as QFile, QBuffer and QSocket inherit TQIODevice and implement virtual functions such as write() appropriately. +An I/O device represents a medium that one can read bytes from and/or write bytes to. The TQIODevice class is the abstract superclass of all such devices; classes such as TQFile, TQBuffer and TQSocket inherit TQIODevice and implement virtual functions such as write() appropriately. .PP -Although applications sometimes use TQIODevice directly, it is usually better to use TQTextStream and QDataStream, which provide stream operations on any TQIODevice subclass. TQTextStream provides text-oriented stream functionality (for human-readable ASCII files, for example), whereas QDataStream deals with binary data in a totally platform-independent manner. +Although applications sometimes use TQIODevice directly, it is usually better to use TQTextStream and TQDataStream, which provide stream operations on any TQIODevice subclass. TQTextStream provides text-oriented stream functionality (for human-readable ASCII files, for example), whereas TQDataStream deals with binary data in a totally platform-independent manner. .PP The public member functions in TQIODevice roughly fall into two groups: the action functions and the state access functions. The most important action functions are: .IP @@ -270,7 +270,7 @@ TQIODevice provides numerous pure virtual functions that you need to implement w .PP The three non-pure virtual functions need not be reimplemented for sequential devices. .PP -See also QDataStream, TQTextStream, and Input/Output and Networking. +See also TQDataStream, TQTextStream, and Input/Output and Networking. .SS "Member Type Documentation" .SH "TQIODevice::Offset" The offset within the device. @@ -288,17 +288,17 @@ See also size(). .PP Example: distributor/distributor.ui.h. .PP -Reimplemented in QSocket. +Reimplemented in TQSocket. .SH "bool TQIODevice::at ( Offset pos )\fC [virtual]\fR" Virtual function that sets the I/O device position to \fIpos\fR. Returns TRUE if the position was successfully set, i.e. \fIpos\fR is within range and the seek was successful; otherwise returns FALSE. .PP See also size(). .PP -Reimplemented in QSocket. +Reimplemented in TQSocket. .SH "bool TQIODevice::atEnd () const\fC [virtual]\fR" Virtual function that returns TRUE if the I/O device position is at the end of the input; otherwise returns FALSE. .PP -Reimplemented in QFile and QSocket. +Reimplemented in TQFile and TQSocket. .SH "void TQIODevice::close ()\fC [pure virtual]\fR" Closes the I/O device. .PP @@ -308,7 +308,7 @@ See also open(). .PP Example: grapher/grapher.cpp. .PP -Reimplemented in QFile and QSocket. +Reimplemented in TQFile and TQSocket. .SH "int TQIODevice::flags () const" Returns the current I/O device flags setting. .PP @@ -320,7 +320,7 @@ Flushes an open I/O device. .PP This virtual function must be reimplemented by all subclasses. .PP -Reimplemented in QFile and QSocket. +Reimplemented in TQFile and TQSocket. .SH "int TQIODevice::getch ()\fC [pure virtual]\fR" Reads a single byte/character from the I/O device. .PP @@ -330,7 +330,7 @@ This virtual function must be reimplemented by all subclasses. .PP See also putch() and ungetch(). .PP -Reimplemented in QFile and QSocket. +Reimplemented in TQFile and TQSocket. .SH "bool TQIODevice::isAsynchronous () const" Returns TRUE if the device is an asynchronous device; otherwise returns FALSE, i.e. if the device is a synchronous device. .PP @@ -384,7 +384,7 @@ See also isAsynchronous(). .SH "bool TQIODevice::isTranslated () const" Returns TRUE if the I/O device translates carriage-return and linefeed characters; otherwise returns FALSE. .PP -A QFile is translated if it is opened with the IO_Translate mode flag. +A TQFile is translated if it is opened with the IO_Translate mode flag. .SH "bool TQIODevice::isWritable () const" Returns TRUE if the I/O device was opened using IO_WriteOnly or IO_ReadWrite mode; otherwise returns FALSE. .PP @@ -411,7 +411,7 @@ See also close(). .PP Example: grapher/grapher.cpp. .PP -Reimplemented in QFile and QSocket. +Reimplemented in TQFile and TQSocket. .SH "int TQIODevice::putch ( int ch )\fC [pure virtual]\fR" Writes the character \fIch\fR to the I/O device. .PP @@ -423,7 +423,7 @@ See also getch() and ungetch(). .PP Example: grapher/grapher.cpp. .PP -Reimplemented in QFile and QSocket. +Reimplemented in TQFile and TQSocket. .SH "TQByteArray TQIODevice::readAll ()\fC [virtual]\fR" This convenience function returns all of the remaining data in the device. .SH "TQ_LONG TQIODevice::readBlock ( char * data, TQ_ULONG maxlen )\fC [pure virtual]\fR" @@ -439,7 +439,7 @@ See also writeBlock(), isOpen(), and isReadable(). .PP Example: distributor/distributor.ui.h. .PP -Reimplemented in QSocket and QSocketDevice. +Reimplemented in TQSocket and TQSocketDevice. .SH "TQ_LONG TQIODevice::readLine ( char * data, TQ_ULONG maxlen )\fC [virtual]\fR" Reads a line of text, (or up to \fImaxlen\fR bytes if a newline isn't encountered) plus a terminating '\0' into \fIdata\fR. If there is a newline at the end if the line, it is not stripped. .PP @@ -449,7 +449,7 @@ This virtual function can be reimplemented much more efficiently by the most sub .PP See also readBlock() and TQTextStream::readLine(). .PP -Reimplemented in QFile. +Reimplemented in TQFile. .SH "bool TQIODevice::reset ()" Sets the device index position to 0. .PP @@ -473,7 +473,7 @@ Virtual function that returns the size of the I/O device. .PP See also at(). .PP -Reimplemented in QFile and QSocket. +Reimplemented in TQFile and TQSocket. .SH "int TQIODevice::state () const" Returns bits OR'ed together that specify the current state. .PP @@ -506,7 +506,7 @@ This virtual function must be reimplemented by all subclasses. .PP See also getch() and putch(). .PP -Reimplemented in QFile and QSocket. +Reimplemented in TQFile and TQSocket. .SH "TQ_LONG TQIODevice::writeBlock ( const char * data, TQ_ULONG len )\fC [pure virtual]\fR" Writes \fIlen\fR bytes from \fIdata\fR to the I/O device and returns the number of bytes actually written. .PP @@ -518,7 +518,7 @@ See also readBlock(). .PP Example: distributor/distributor.ui.h. .PP -Reimplemented in QBuffer, QSocket, and QSocketDevice. +Reimplemented in TQBuffer, TQSocket, and TQSocketDevice. .SH "TQ_LONG TQIODevice::writeBlock ( const TQByteArray & data )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP @@ -526,7 +526,7 @@ This convenience function is the same as calling writeBlock( data.data(), data.size() ). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqiodevice.html +.BR http://doc.trolltech.com/tqiodevice.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqkeyevent.3qt b/doc/man/man3/tqkeyevent.3qt index 0a0992b23..64d318e43 100644 --- a/doc/man/man3/tqkeyevent.3qt +++ b/doc/man/man3/tqkeyevent.3qt @@ -109,7 +109,7 @@ A value of either 0 or Key_unknown means that the event is not the result of a k .PP See also TQWidget::setKeyCompression(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "ButtonState QKeyEvent::state () const" Returns the keyboard modifier flags that existed immediately before the event occurred. .PP @@ -117,7 +117,7 @@ The returned value is ShiftButton, ControlButton, AltButton and MetaButton OR'ed .PP See also stateAfter(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "ButtonState QKeyEvent::stateAfter () const" Returns the keyboard modifier flags that existed immediately after the event occurred. .PP diff --git a/doc/man/man3/tqkeysequence.3qt b/doc/man/man3/tqkeysequence.3qt index 2a811b776..0ee6b9e51 100644 --- a/doc/man/man3/tqkeysequence.3qt +++ b/doc/man/man3/tqkeysequence.3qt @@ -64,10 +64,10 @@ Inherits Qt. .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QKeySequence & keysequence )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QKeySequence & keysequence )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QKeySequence & keysequence )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QKeySequence & keysequence )" .br .in -1c .SH DESCRIPTION @@ -134,14 +134,14 @@ Returns TRUE if \fIkeysequence\fR is equal to this key sequence; otherwise retur .SH "int QKeySequence::operator[] ( uint index ) const" Returns a reference to the element at position \fIindex\fR in the key sequence. This can only be used to read an element. .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QKeySequence & keysequence )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QKeySequence & keysequence )" Writes the key sequence \fIkeysequence\fR to the stream \fIs\fR. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, QKeySequence & keysequence )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, QKeySequence & keysequence )" Reads a key sequence from the stream \fIs\fR into the key sequence \fIkeysequence\fR. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqkeysequence.html diff --git a/doc/man/man3/tqlistview.3qt b/doc/man/man3/tqlistview.3qt index 261b22c2b..7210b9047 100644 --- a/doc/man/man3/tqlistview.3qt +++ b/doc/man/man3/tqlistview.3qt @@ -531,7 +531,7 @@ If \fIwidth\fR is negative, the new column's WidthMode is set to Maximum instead See also setColumnText(), setColumnWidth(), and setColumnWidthMode(). .PP Examples: -.)l addressbook/centralwidget.cpp, checklists/checklists.cpp, dirview/main.cpp, fileiconview/mainwindow.cpp, listviews/listviews.cpp, and qdir/qdir.cpp. +.)l addressbook/centralwidget.cpp, checklists/checklists.cpp, dirview/main.cpp, fileiconview/mainwindow.cpp, listviews/listviews.cpp, and tqdir/tqdir.cpp. .SH "int QListView::addColumn ( const TQIconSet & iconset, const TQString & label, int width = -1 )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP @@ -695,7 +695,7 @@ Returns the QHeader object that manages this list view's columns. Please don't m You may safely call QHeader::setClickEnabled(), QHeader::setResizeEnabled(), QHeader::setMovingEnabled(), QHeader::hide() and all the const QHeader functions. .PP Examples: -.)l listviews/listviews.cpp and qdir/qdir.cpp. +.)l listviews/listviews.cpp and tqdir/tqdir.cpp. .SH "void QListView::hideColumn ( int column )" Hides the column specified at \fIcolumn\fR. This is a convenience function that calls setColumnWidth( \fIcolumn\fR, 0 ). .PP diff --git a/doc/man/man3/tqlistviewitem.3qt b/doc/man/man3/tqlistviewitem.3qt index e641f8861..110579a94 100644 --- a/doc/man/man3/tqlistviewitem.3qt +++ b/doc/man/man3/tqlistviewitem.3qt @@ -301,7 +301,7 @@ Note that the order of the children will change when the sorting order changes a .PP Many programs will need to reimplement QListViewItem. The most commonly reimplemented functions are: <center>.nf .TS -l - l. Function Description text() Returns the text in a column. Many subclasses will compute 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, QFileDialog reimplements key() to sort by date. setup() Called before showing the item and whenever the list view's font changes, for example. activate() +l - l. Function Description text() Returns the text in a column. Many subclasses will compute 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 reimplements key() to sort by date. setup() Called before showing the item and whenever the list view's font changes, for example. activate() .TE .fi </center> diff --git a/doc/man/man3/tqlocalfs.3qt b/doc/man/man3/tqlocalfs.3qt index 40837fd0e..05a32196e 100644 --- a/doc/man/man3/tqlocalfs.3qt +++ b/doc/man/man3/tqlocalfs.3qt @@ -1,5 +1,5 @@ '\" t -.TH QLocalFs 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQLocalFs 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,42 +7,42 @@ .ad l .nh .SH NAME -QLocalFs \- Implementation of a QNetworkProtocol that works on the local file system +TQLocalFs \- Implementation of a TQNetworkProtocol that works on the local file system .SH SYNOPSIS -\fC#include <ntqlocalfs.h>\fR +\fC#include <tqlocalfs.h>\fR .PP -Inherits QNetworkProtocol. +Inherits TQNetworkProtocol. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQLocalFs\fR ()" +.BI "\fBTQLocalFs\fR ()" .br .in -1c .SH DESCRIPTION -The QLocalFs class is an implementation of a QNetworkProtocol that works on the local file system. +The TQLocalFs class is an implementation of a TQNetworkProtocol that works on the local file system. .PP -This class is derived from QNetworkProtocol. QLocalFs is not normally used directly, but rather through a QUrlOperator, for example: +This class is derived from TQNetworkProtocol. TQLocalFs is not normally used directly, but rather through a TQUrlOperator, for example: .PP .nf .br - QUrlOperator op( "file:///tmp" ); + TQUrlOperator op( "file:///tmp" ); .br op.listChildren(); // Asks the server to provide a directory listing .br .fi .PP -This code will only work if the QLocalFs class is registered; to register the class, you must call tqInitNetworkProtocols() before using a QUrlOperator with QLocalFs. +This code will only work if the TQLocalFs class is registered; to register the class, you must call tqInitNetworkProtocols() before using a TQUrlOperator with TQLocalFs. .PP -If you really need to use QLocalFs directly, don't forget to set its QUrlOperator with setUrl(). +If you really need to use TQLocalFs directly, don't forget to set its TQUrlOperator with setUrl(). .PP -See also TQt Network Documentation, QNetworkProtocol, QUrlOperator, and Input/Output and Networking. +See also TQt Network Documentation, TQNetworkProtocol, TQUrlOperator, and Input/Output and Networking. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QLocalFs::QLocalFs ()" +.SH "TQLocalFs::TQLocalFs ()" Constructor. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqlocalfs.html +.BR http://doc.trolltech.com/tqlocalfs.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqmainwindow.3qt b/doc/man/man3/tqmainwindow.3qt index 1e19375e5..5ccd2c217 100644 --- a/doc/man/man3/tqmainwindow.3qt +++ b/doc/man/man3/tqmainwindow.3qt @@ -418,7 +418,7 @@ To save the layout and positions of all the dock windows do this: .PP .nf .br - QFile file( filename ); + TQFile file( filename ); .br if ( file.open( IO_WriteOnly ) ) { .br @@ -436,7 +436,7 @@ To restore the dock window positions and sizes (normally when the application is .PP .nf .br - QFile file( filename ); + TQFile file( filename ); .br if ( file.open( IO_ReadOnly ) ) { .br @@ -450,7 +450,7 @@ To restore the dock window positions and sizes (normally when the application is .br .fi .PP -The QSettings class can be used in conjunction with the streaming operators to store the application's settings. +The TQSettings class can be used in conjunction with the streaming operators to store the application's settings. .PP TQMainWindow's management of dock windows and toolbars is done transparently behind-the-scenes by QDockArea. .PP @@ -809,13 +809,13 @@ Set this property's value with setUsesTextLabel() and get this property's value .SH "TQTextStream & operator<< ( TQTextStream & ts, const TQMainWindow & mainWindow )" Writes the layout (sizes and positions) of the dock windows in the dock areas of the TQMainWindow \fImainWindow\fR, including Minimized and TornOff dock windows, to the text stream \fIts\fR. .PP -This can be used, for example, in conjunction with QSettings to save the user's layout when the \\mainWindow receives a closeEvent. +This can be used, for example, in conjunction with TQSettings to save the user's layout when the \\mainWindow receives a closeEvent. .PP See also operator>>() and closeEvent(). .SH "TQTextStream & operator>> ( TQTextStream & ts, TQMainWindow & mainWindow )" Reads the layout (sizes and positions) of the dock windows in the dock areas of the TQMainWindow \fImainWindow\fR from the text stream, \fIts\fR, including Minimized and TornOff dock windows. Restores the dock windows and dock areas to these sizes and positions. The layout information must be in the format produced by operator<<(). .PP -This can be used, for example, in conjunction with QSettings to restore the user's layout. +This can be used, for example, in conjunction with TQSettings to restore the user's layout. .PP See also operator<<(). diff --git a/doc/man/man3/tqmap.3qt b/doc/man/man3/tqmap.3qt index 886b2fa76..402ab40bb 100644 --- a/doc/man/man3/tqmap.3qt +++ b/doc/man/man3/tqmap.3qt @@ -161,10 +161,10 @@ TQMap \- Value-based template class that provides a dictionary .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQMap<Key, T> & m )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQMap<Key, T> & m )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQMap<Key, T> & m )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQMap<Key, T> & m )" .br .in -1c .SH DESCRIPTION @@ -522,9 +522,9 @@ See also empty(). .SH "TQValueList<T> TQMap::values () const" Returns a list of all the values in the map, in key order. .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const TQMap<Key, T> & m )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQMap<Key, T> & m )" Writes the map \fIm\fR to the stream \fIs\fR. The types \fIKey\fR and \fIT\fR must implement the streaming operator as well. -.SH "QDataStream & operator>> ( QDataStream & s, TQMap<Key, T> & m )" +.SH "TQDataStream & operator>> ( TQDataStream & s, TQMap<Key, T> & m )" Reads the map \fIm\fR from the stream \fIs\fR. The types \fIKey\fR and \fIT\fR must implement the streaming operator as well. diff --git a/doc/man/man3/tqmemarray.3qt b/doc/man/man3/tqmemarray.3qt index da21cdc40..27b4f7cbb 100644 --- a/doc/man/man3/tqmemarray.3qt +++ b/doc/man/man3/tqmemarray.3qt @@ -144,10 +144,10 @@ Inherited by TQByteArray and QPointArray. .BI "TQ_UINT16 \fBqChecksum\fR ( const char * data, uint len )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQByteArray & a )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQByteArray & a )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQByteArray & a )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQByteArray & a )" .br .in -1c .SH DESCRIPTION @@ -362,7 +362,7 @@ The array is a null array if data() == 0 (null pointer). See also isNull(). .PP Examples: -.)l fileiconview/qfileiconview.cpp and network/networkprotocol/nntp.cpp. +.)l fileiconview/tqfileiconview.cpp and network/networkprotocol/nntp.cpp. .SH "void TQMemArray::detach ()\fC [virtual]\fR" Detaches this array from shared array data; i.e. it makes a private, deep copy of the data. .PP @@ -454,7 +454,7 @@ New elements are not initialized. .PP See also size(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "bool TQMemArray::resize ( uint size )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP @@ -482,7 +482,7 @@ Example I (intended use): .br a.setRawData( bindata, sizeof(bindata) ); // a points to bindata .br - QDataStream s( a, IO_ReadOnly ); // open on a's data + TQDataStream s( a, IO_ReadOnly ); // open on a's data .br s >> <something>; // read raw bindata .br @@ -532,14 +532,14 @@ Equivalent to resize(\fIpos\fR). .PP See also resize(). .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const TQByteArray & a )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQByteArray & a )" Writes byte array \fIa\fR to the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, TQByteArray & a )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, TQByteArray & a )" Reads a byte array into \fIa\fR from the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "TQ_UINT16 tqChecksum ( const char * data, uint len )" Returns the CRC-16 checksum of \fIlen\fR bytes starting at \fIdata\fR. .PP diff --git a/doc/man/man3/tqmenudata.3qt b/doc/man/man3/tqmenudata.3qt index ba5de1daa..5b1144a68 100644 --- a/doc/man/man3/tqmenudata.3qt +++ b/doc/man/man3/tqmenudata.3qt @@ -671,7 +671,7 @@ Returns the text that has been set for menu item \fIid\fR, or TQString::null if See also changeItem(), pixmap(), and iconSet(). .PP Examples: -.)l qdir/qdir.cpp and showimg/showimg.cpp. +.)l tqdir/tqdir.cpp and showimg/showimg.cpp. .SH "void TQMenuData::updateItem ( int id )\fC [virtual]\fR" Virtual function; notifies subclasses about an item with \fIid\fR that has been changed. .PP diff --git a/doc/man/man3/tqmessagebox.3qt b/doc/man/man3/tqmessagebox.3qt index f7e0762e8..62acce77a 100644 --- a/doc/man/man3/tqmessagebox.3qt +++ b/doc/man/man3/tqmessagebox.3qt @@ -160,7 +160,7 @@ question() is useful for simple yes/no questions: .PP .nf .br - if ( QFile::exists( filename ) && + if ( TQFile::exists( filename ) && .br QMessageBox::question( .br @@ -640,7 +640,7 @@ If \fIparent\fR is 0, the message box becomes an application-global modal dialog See also question(), warning(), and critical(). .PP Examples: -.)l action/application.cpp, application/application.cpp, dirview/dirview.cpp, fileiconview/qfileiconview.cpp, picture/picture.cpp, qwerty/qwerty.cpp, and simple/main.cpp. +.)l action/application.cpp, application/application.cpp, dirview/dirview.cpp, fileiconview/tqfileiconview.cpp, picture/picture.cpp, qwerty/qwerty.cpp, and simple/main.cpp. .SH "int QMessageBox::information ( TQWidget * parent, const TQString & caption, const TQString & text, const TQString & button0Text = TQString::null, const TQString & button1Text = TQString::null, const TQString & button2Text = TQString::null, int defaultButtonNumber = 0, int escapeButtonNumber = -1 )\fC [static]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP diff --git a/doc/man/man3/tqmovie.3qt b/doc/man/man3/tqmovie.3qt index 059aeb957..87336af97 100644 --- a/doc/man/man3/tqmovie.3qt +++ b/doc/man/man3/tqmovie.3qt @@ -20,7 +20,7 @@ QMovie \- Incremental loading of animations or images, signalling as it progress .BI "\fBQMovie\fR ( int bufsize )" .br .ti -1c -.BI "\fBQMovie\fR ( QDataSource * src, int bufsize = 1024 )" +.BI "\fBQMovie\fR ( TQDataSource * src, int bufsize = 1024 )" .br .ti -1c .BI "\fBQMovie\fR ( const TQString & fileName, int bufsize = 1024 )" @@ -174,7 +174,7 @@ Constructs a QMovie with an external data source. You should later call pushData The \fIbufsize\fR argument sets the maximum amount of data the movie will transfer from the data source per event loop. The lower this value, the better interleaved the movie playback will be with other event processing, but the slower the overall processing will be. .PP See also pushData(). -.SH "QMovie::QMovie ( QDataSource * src, int bufsize = 1024 )" +.SH "QMovie::QMovie ( TQDataSource * src, int bufsize = 1024 )" Constructs a QMovie that reads an image sequence from the given data source, \fIsrc\fR. The source must be allocated dynamically, because QMovie will take ownership of it and will destroy it when the movie is destroyed. The movie starts playing as soon as event processing continues. .PP The \fIbufsize\fR argument sets the maximum amount of data the movie will transfer from the data source per event loop. The lower this value, the better interleaved the movie playback will be with other event processing, but the slower the overall processing will be. diff --git a/doc/man/man3/tqnetworkoperation.3qt b/doc/man/man3/tqnetworkoperation.3qt index 84b13be15..89d8c5624 100644 --- a/doc/man/man3/tqnetworkoperation.3qt +++ b/doc/man/man3/tqnetworkoperation.3qt @@ -1,5 +1,5 @@ '\" t -.TH QNetworkOperation 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQNetworkOperation 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,25 +7,25 @@ .ad l .nh .SH NAME -QNetworkOperation \- Common operations for network protocols +TQNetworkOperation \- Common operations for network protocols .SH SYNOPSIS -\fC#include <ntqnetworkprotocol.h>\fR +\fC#include <tqnetworkprotocol.h>\fR .PP Inherits TQObject. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQNetworkOperation\fR ( QNetworkProtocol::Operation operation, const TQString & arg0, const TQString & arg1, const TQString & arg2 )" +.BI "\fBTQNetworkOperation\fR ( TQNetworkProtocol::Operation operation, const TQString & arg0, const TQString & arg1, const TQString & arg2 )" .br .ti -1c -.BI "\fBQNetworkOperation\fR ( QNetworkProtocol::Operation operation, const TQByteArray & arg0, const TQByteArray & arg1, const TQByteArray & arg2 )" +.BI "\fBTQNetworkOperation\fR ( TQNetworkProtocol::Operation operation, const TQByteArray & arg0, const TQByteArray & arg1, const TQByteArray & arg2 )" .br .ti -1c -.BI "\fB~QNetworkOperation\fR ()" +.BI "\fB~TQNetworkOperation\fR ()" .br .ti -1c -.BI "void \fBsetState\fR ( QNetworkProtocol::State state )" +.BI "void \fBsetState\fR ( TQNetworkProtocol::State state )" .br .ti -1c .BI "void \fBsetProtocolDetail\fR ( const TQString & detail )" @@ -40,10 +40,10 @@ Inherits TQObject. .BI "void \fBsetRawArg\fR ( int num, const TQByteArray & arg )" .br .ti -1c -.BI "QNetworkProtocol::Operation \fBoperation\fR () const" +.BI "TQNetworkProtocol::Operation \fBoperation\fR () const" .br .ti -1c -.BI "QNetworkProtocol::State \fBstate\fR () const" +.BI "TQNetworkProtocol::State \fBstate\fR () const" .br .ti -1c .BI "TQString \fBarg\fR ( int num ) const" @@ -62,65 +62,65 @@ Inherits TQObject. .br .in -1c .SH DESCRIPTION -The QNetworkOperation class provides common operations for network protocols. +The TQNetworkOperation class provides common operations for network protocols. .PP An object is created to describe the operation and the current state for each operation that a network protocol should process. .PP For a detailed description of the TQt Network Architecture and how to implement and use network protocols in Qt, see the TQt Network Documentation. .PP -See also QNetworkProtocol and Input/Output and Networking. +See also TQNetworkProtocol and Input/Output and Networking. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QNetworkOperation::QNetworkOperation ( QNetworkProtocol::Operation operation, const TQString & arg0, const TQString & arg1, const TQString & arg2 )" -Constructs a network operation object. \fIoperation\fR is the type of the operation, and \fIarg0\fR, \fIarg1\fR and \fIarg2\fR are the first three arguments of the operation. The state is initialized to QNetworkProtocol::StWaiting. +.SH "TQNetworkOperation::TQNetworkOperation ( TQNetworkProtocol::Operation operation, const TQString & arg0, const TQString & arg1, const TQString & arg2 )" +Constructs a network operation object. \fIoperation\fR is the type of the operation, and \fIarg0\fR, \fIarg1\fR and \fIarg2\fR are the first three arguments of the operation. The state is initialized to TQNetworkProtocol::StWaiting. .PP -See also QNetworkProtocol::Operation and QNetworkProtocol::State. -.SH "QNetworkOperation::QNetworkOperation ( QNetworkProtocol::Operation operation, const TQByteArray & arg0, const TQByteArray & arg1, const TQByteArray & arg2 )" -Constructs a network operation object. \fIoperation\fR is the type of the operation, and \fIarg0\fR, \fIarg1\fR and \fIarg2\fR are the first three raw data arguments of the operation. The state is initialized to QNetworkProtocol::StWaiting. +See also TQNetworkProtocol::Operation and TQNetworkProtocol::State. +.SH "TQNetworkOperation::TQNetworkOperation ( TQNetworkProtocol::Operation operation, const TQByteArray & arg0, const TQByteArray & arg1, const TQByteArray & arg2 )" +Constructs a network operation object. \fIoperation\fR is the type of the operation, and \fIarg0\fR, \fIarg1\fR and \fIarg2\fR are the first three raw data arguments of the operation. The state is initialized to TQNetworkProtocol::StWaiting. .PP -See also QNetworkProtocol::Operation and QNetworkProtocol::State. -.SH "QNetworkOperation::~QNetworkOperation ()" +See also TQNetworkProtocol::Operation and TQNetworkProtocol::State. +.SH "TQNetworkOperation::~TQNetworkOperation ()" Destructor. -.SH "TQString QNetworkOperation::arg ( int num ) const" +.SH "TQString TQNetworkOperation::arg ( int num ) const" Returns the operation's \fInum\fR-th argument. If this argument was not already set, an empty string is returned. .PP Example: network/networkprotocol/nntp.cpp. -.SH "int QNetworkOperation::errorCode () const" +.SH "int TQNetworkOperation::errorCode () const" Returns the error code for the last error that occurred. -.SH "void QNetworkOperation::free ()" +.SH "void TQNetworkOperation::free ()" Sets this object to delete itself when it hasn't been used for one second. .PP -Because QNetworkOperation pointers are passed around a lot the QNetworkProtocol generally does not have enough knowledge to delete these at the correct time. If a QNetworkProtocol doesn't need an operation any more it will call this function instead. +Because TQNetworkOperation pointers are passed around a lot the TQNetworkProtocol generally does not have enough knowledge to delete these at the correct time. If a TQNetworkProtocol doesn't need an operation any more it will call this function instead. .PP Note: you should never need to call the method yourself. -.SH "QNetworkProtocol::Operation QNetworkOperation::operation () const" +.SH "TQNetworkProtocol::Operation TQNetworkOperation::operation () const" Returns the type of the operation. -.SH "TQString QNetworkOperation::protocolDetail () const" +.SH "TQString TQNetworkOperation::protocolDetail () const" Returns a detailed error message for the last error. This must have been set using setProtocolDetail(). -.SH "TQByteArray QNetworkOperation::rawArg ( int num ) const" +.SH "TQByteArray TQNetworkOperation::rawArg ( int num ) const" Returns the operation's \fInum\fR-th raw data argument. If this argument was not already set, an empty bytearray is returned. -.SH "void QNetworkOperation::setArg ( int num, const TQString & arg )" +.SH "void TQNetworkOperation::setArg ( int num, const TQString & arg )" Sets the network operation's \fInum\fR-th argument to \fIarg\fR. -.SH "void QNetworkOperation::setErrorCode ( int ec )" +.SH "void TQNetworkOperation::setErrorCode ( int ec )" Sets the error code to \fIec\fR. .PP -If the operation failed, the protocol should set an error code to describe the error in more detail. If possible, one of the error codes defined in QNetworkProtocol should be used. +If the operation failed, the protocol should set an error code to describe the error in more detail. If possible, one of the error codes defined in TQNetworkProtocol should be used. .PP -See also setProtocolDetail() and QNetworkProtocol::Error. -.SH "void QNetworkOperation::setProtocolDetail ( const TQString & detail )" +See also setProtocolDetail() and TQNetworkProtocol::Error. +.SH "void TQNetworkOperation::setProtocolDetail ( const TQString & detail )" If the operation failed, the error message can be specified as \fIdetail\fR. -.SH "void QNetworkOperation::setRawArg ( int num, const TQByteArray & arg )" +.SH "void TQNetworkOperation::setRawArg ( int num, const TQByteArray & arg )" Sets the network operation's \fInum\fR-th raw data argument to \fIarg\fR. -.SH "void QNetworkOperation::setState ( QNetworkProtocol::State state )" -Sets the \fIstate\fR of the operation object. This should be done by the network protocol during processing; at the end it should be set to QNetworkProtocol::StDone or QNetworkProtocol::StFailed, depending on success or failure. +.SH "void TQNetworkOperation::setState ( TQNetworkProtocol::State state )" +Sets the \fIstate\fR of the operation object. This should be done by the network protocol during processing; at the end it should be set to TQNetworkProtocol::StDone or TQNetworkProtocol::StFailed, depending on success or failure. .PP -See also QNetworkProtocol::State. -.SH "QNetworkProtocol::State QNetworkOperation::state () const" +See also TQNetworkProtocol::State. +.SH "TQNetworkProtocol::State TQNetworkOperation::state () const" Returns the state of the operation. You can determine whether an operation is still waiting to be processed, is being processed, has been processed successfully, or failed. .SH "SEE ALSO" -.BR http://doc.trolltech.com/qnetworkoperation.html +.BR http://doc.trolltech.com/tqnetworkoperation.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqnetworkprotocol.3qt b/doc/man/man3/tqnetworkprotocol.3qt index f7bb8f9ae..3d1727a81 100644 --- a/doc/man/man3/tqnetworkprotocol.3qt +++ b/doc/man/man3/tqnetworkprotocol.3qt @@ -1,5 +1,5 @@ '\" t -.TH QNetworkProtocol 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQNetworkProtocol 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,13 +7,13 @@ .ad l .nh .SH NAME -QNetworkProtocol \- Common API for network protocols +TQNetworkProtocol \- Common API for network protocols .SH SYNOPSIS -\fC#include <ntqnetworkprotocol.h>\fR +\fC#include <tqnetworkprotocol.h>\fR .PP Inherits TQObject. .PP -Inherited by QFtp, QHttp, and QLocalFs. +Inherited by TQFtp, TQHttp, and TQLocalFs. .PP .SS "Public Members" .in +1c @@ -30,13 +30,13 @@ Inherited by QFtp, QHttp, and QLocalFs. .BI "enum \fBError\fR { NoError = 0, ErrValid, ErrUnknownProtocol, ErrUnsupported, ErrParse, ErrLoginIncorrect, ErrHostNotFound, ErrListChildren, ErrListChlidren = ErrListChildren, ErrMkDir, ErrMkdir = ErrMkDir, ErrRemove, ErrRename, ErrGet, ErrPut, ErrFileNotExisting, ErrPermissionDenied }" .br .ti -1c -.BI "\fBQNetworkProtocol\fR ()" +.BI "\fBTQNetworkProtocol\fR ()" .br .ti -1c -.BI "virtual \fB~QNetworkProtocol\fR ()" +.BI "virtual \fB~TQNetworkProtocol\fR ()" .br .ti -1c -.BI "virtual void \fBsetUrl\fR ( QUrlOperator * u )" +.BI "virtual void \fBsetUrl\fR ( TQUrlOperator * u )" .br .ti -1c .BI "virtual void \fBsetAutoDelete\fR ( bool b, int i = 10000 )" @@ -48,13 +48,13 @@ Inherited by QFtp, QHttp, and QLocalFs. .BI "virtual int \fBsupportedOperations\fR () const" .br .ti -1c -.BI "virtual void \fBaddOperation\fR ( QNetworkOperation * op )" +.BI "virtual void \fBaddOperation\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "QUrlOperator * \fBurl\fR () const" +.BI "TQUrlOperator * \fBurl\fR () const" .br .ti -1c -.BI "QNetworkOperation * \fBoperationInProgress\fR () const" +.BI "TQNetworkOperation * \fBoperationInProgress\fR () const" .br .ti -1c .BI "virtual void \fBclearOperationQueue\fR ()" @@ -66,43 +66,43 @@ Inherited by QFtp, QHttp, and QLocalFs. .SS "Signals" .in +1c .ti -1c -.BI "void \fBdata\fR ( const TQByteArray & data, QNetworkOperation * op )" +.BI "void \fBdata\fR ( const TQByteArray & data, TQNetworkOperation * op )" .br .ti -1c .BI "void \fBconnectionStateChanged\fR ( int state, const TQString & data )" .br .ti -1c -.BI "void \fBfinished\fR ( QNetworkOperation * op )" +.BI "void \fBfinished\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBstart\fR ( QNetworkOperation * op )" +.BI "void \fBstart\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBnewChildren\fR ( const TQValueList<QUrlInfo> & i, QNetworkOperation * op )" +.BI "void \fBnewChildren\fR ( const TQValueList<TQUrlInfo> & i, TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBnewChild\fR ( const QUrlInfo & i, QNetworkOperation * op )" +.BI "void \fBnewChild\fR ( const TQUrlInfo & i, TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBcreatedDirectory\fR ( const QUrlInfo & i, QNetworkOperation * op )" +.BI "void \fBcreatedDirectory\fR ( const TQUrlInfo & i, TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBremoved\fR ( QNetworkOperation * op )" +.BI "void \fBremoved\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBitemChanged\fR ( QNetworkOperation * op )" +.BI "void \fBitemChanged\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBdataTransferProgress\fR ( int bytesDone, int bytesTotal, QNetworkOperation * op )" +.BI "void \fBdataTransferProgress\fR ( int bytesDone, int bytesTotal, TQNetworkOperation * op )" .br .in -1c .SS "Static Public Members" .in +1c .ti -1c -.BI "void \fBregisterNetworkProtocol\fR ( const TQString & protocol, QNetworkProtocolFactoryBase * protocolFactory )" +.BI "void \fBregisterNetworkProtocol\fR ( const TQString & protocol, TQNetworkProtocolFactoryBase * protocolFactory )" .br .ti -1c -.BI "QNetworkProtocol * \fBgetNetworkProtocol\fR ( const TQString & protocol )" +.BI "TQNetworkProtocol * \fBgetNetworkProtocol\fR ( const TQString & protocol )" .br .ti -1c .BI "bool \fBhasOnlyLocalFileSystem\fR ()" @@ -111,33 +111,33 @@ Inherited by QFtp, QHttp, and QLocalFs. .SS "Protected Members" .in +1c .ti -1c -.BI "virtual void \fBoperationListChildren\fR ( QNetworkOperation * op )" +.BI "virtual void \fBoperationListChildren\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "virtual void \fBoperationMkDir\fR ( QNetworkOperation * op )" +.BI "virtual void \fBoperationMkDir\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "virtual void \fBoperationRemove\fR ( QNetworkOperation * op )" +.BI "virtual void \fBoperationRemove\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "virtual void \fBoperationRename\fR ( QNetworkOperation * op )" +.BI "virtual void \fBoperationRename\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "virtual void \fBoperationGet\fR ( QNetworkOperation * op )" +.BI "virtual void \fBoperationGet\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "virtual void \fBoperationPut\fR ( QNetworkOperation * op )" +.BI "virtual void \fBoperationPut\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "virtual bool \fBcheckConnection\fR ( QNetworkOperation * op )" +.BI "virtual bool \fBcheckConnection\fR ( TQNetworkOperation * op )" .br .in -1c .SH DESCRIPTION -The QNetworkProtocol class provides a common API for network protocols. +The TQNetworkProtocol class provides a common API for network protocols. .PP -This is a base class which should be used for network protocols implementations that can then be used in TQt (e.g. in the file dialog) together with the QUrlOperator. +This is a base class which should be used for network protocols implementations that can then be used in TQt (e.g. in the file dialog) together with the TQUrlOperator. .PP -The easiest way to implement a new network protocol is to reimplement the operation*() methods, e.g. operationGet(), etc. Only the supported operations should be reimplemented. To specify which operations are supported, also reimplement supportedOperations() and return an int that is OR'd together using the supported operations from the QNetworkProtocol::Operation enum. +The easiest way to implement a new network protocol is to reimplement the operation*() methods, e.g. operationGet(), etc. Only the supported operations should be reimplemented. To specify which operations are supported, also reimplement supportedOperations() and return an int that is OR'd together using the supported operations from the TQNetworkProtocol::Operation enum. .PP When you implement a network protocol this way, it is important to emit the correct signals. Also, always emit the finished() signal when an operation is done (on success \fIand\fR on failure). TQt relies on correctly emitted finished() signals. .PP @@ -145,223 +145,223 @@ For a detailed description of the TQt Network Architecture and how to implement .PP See also Input/Output and Networking. .SS "Member Type Documentation" -.SH "QNetworkProtocol::ConnectionState" +.SH "TQNetworkProtocol::ConnectionState" When the connection state of a network protocol changes it emits the signal connectionStateChanged(). The first argument is one of the following values: .TP -\fCQNetworkProtocol::ConHostFound\fR - Host has been found. +\fCTQNetworkProtocol::ConHostFound\fR - Host has been found. .TP -\fCQNetworkProtocol::ConConnected\fR - Connection to the host has been established. +\fCTQNetworkProtocol::ConConnected\fR - Connection to the host has been established. .TP -\fCQNetworkProtocol::ConClosed\fR - Connection has been closed. -.SH "QNetworkProtocol::Error" -When an operation fails (finishes unsuccessfully), the QNetworkOperation of the operation returns an error code which has one of the following values: +\fCTQNetworkProtocol::ConClosed\fR - Connection has been closed. +.SH "TQNetworkProtocol::Error" +When an operation fails (finishes unsuccessfully), the TQNetworkOperation of the operation returns an error code which has one of the following values: .TP -\fCQNetworkProtocol::NoError\fR - No error occurred. +\fCTQNetworkProtocol::NoError\fR - No error occurred. .TP -\fCQNetworkProtocol::ErrValid\fR - The URL you are operating on is not valid. +\fCTQNetworkProtocol::ErrValid\fR - The URL you are operating on is not valid. .TP -\fCQNetworkProtocol::ErrUnknownProtocol\fR - There is no protocol implementation available for the protocol of the URL you are operating on (e.g. if the protocol is http and no http implementation has been registered). +\fCTQNetworkProtocol::ErrUnknownProtocol\fR - There is no protocol implementation available for the protocol of the URL you are operating on (e.g. if the protocol is http and no http implementation has been registered). .TP -\fCQNetworkProtocol::ErrUnsupported\fR - The operation is not supported by the protocol. +\fCTQNetworkProtocol::ErrUnsupported\fR - The operation is not supported by the protocol. .TP -\fCQNetworkProtocol::ErrParse\fR - The URL could not be parsed correctly. +\fCTQNetworkProtocol::ErrParse\fR - The URL could not be parsed correctly. .TP -\fCQNetworkProtocol::ErrLoginIncorrect\fR - You needed to login but the username or password is wrong. +\fCTQNetworkProtocol::ErrLoginIncorrect\fR - You needed to login but the username or password is wrong. .TP -\fCQNetworkProtocol::ErrHostNotFound\fR - The specified host (in the URL) couldn't be found. +\fCTQNetworkProtocol::ErrHostNotFound\fR - The specified host (in the URL) couldn't be found. .TP -\fCQNetworkProtocol::ErrListChildren\fR - An error occurred while listing the children (files). +\fCTQNetworkProtocol::ErrListChildren\fR - An error occurred while listing the children (files). .TP -\fCQNetworkProtocol::ErrMkDir\fR - An error occurred when creating a directory. +\fCTQNetworkProtocol::ErrMkDir\fR - An error occurred when creating a directory. .TP -\fCQNetworkProtocol::ErrRemove\fR - An error occurred when removing a child (file). +\fCTQNetworkProtocol::ErrRemove\fR - An error occurred when removing a child (file). .TP -\fCQNetworkProtocol::ErrRename\fR - An error occurred when renaming a child (file). +\fCTQNetworkProtocol::ErrRename\fR - An error occurred when renaming a child (file). .TP -\fCQNetworkProtocol::ErrGet\fR - An error occurred while getting (retrieving) data. +\fCTQNetworkProtocol::ErrGet\fR - An error occurred while getting (retrieving) data. .TP -\fCQNetworkProtocol::ErrPut\fR - An error occurred while putting (uploading) data. +\fCTQNetworkProtocol::ErrPut\fR - An error occurred while putting (uploading) data. .TP -\fCQNetworkProtocol::ErrFileNotExisting\fR - A file which is needed by the operation doesn't exist. +\fCTQNetworkProtocol::ErrFileNotExisting\fR - A file which is needed by the operation doesn't exist. .TP -\fCQNetworkProtocol::ErrPermissionDenied\fR - Permission for doing the operation has been denied. +\fCTQNetworkProtocol::ErrPermissionDenied\fR - Permission for doing the operation has been denied. .PP You should also use these error codes when implementing custom network protocols. If this is not possible, you can define your own error codes by using integer values that don't conflict with any of these values. -.SH "QNetworkProtocol::Operation" -This enum lists the possible operations that a network protocol can support. supportedOperations() returns an int of these that is OR'd together. Also, the type() of a QNetworkOperation is always one of these values. +.SH "TQNetworkProtocol::Operation" +This enum lists the possible operations that a network protocol can support. supportedOperations() returns an int of these that is OR'd together. Also, the type() of a TQNetworkOperation is always one of these values. .TP -\fCQNetworkProtocol::OpListChildren\fR - List the children of a URL, e.g. of a directory. +\fCTQNetworkProtocol::OpListChildren\fR - List the children of a URL, e.g. of a directory. .TP -\fCQNetworkProtocol::OpMkDir\fR - Create a directory. +\fCTQNetworkProtocol::OpMkDir\fR - Create a directory. .TP -\fCQNetworkProtocol::OpRemove\fR - Remove a child (e.g. a file). +\fCTQNetworkProtocol::OpRemove\fR - Remove a child (e.g. a file). .TP -\fCQNetworkProtocol::OpRename\fR - Rename a child (e.g. a file). +\fCTQNetworkProtocol::OpRename\fR - Rename a child (e.g. a file). .TP -\fCQNetworkProtocol::OpGet\fR - Get data from a location. +\fCTQNetworkProtocol::OpGet\fR - Get data from a location. .TP -\fCQNetworkProtocol::OpPut\fR - Put data to a location. -.SH "QNetworkProtocol::State" -This enum contains the state that a QNetworkOperation can have. +\fCTQNetworkProtocol::OpPut\fR - Put data to a location. +.SH "TQNetworkProtocol::State" +This enum contains the state that a TQNetworkOperation can have. .TP -\fCQNetworkProtocol::StWaiting\fR - The operation is in the QNetworkProtocol's queue waiting to be prcessed. +\fCTQNetworkProtocol::StWaiting\fR - The operation is in the TQNetworkProtocol's queue waiting to be prcessed. .TP -\fCQNetworkProtocol::StInProgress\fR - The operation is being processed. +\fCTQNetworkProtocol::StInProgress\fR - The operation is being processed. .TP -\fCQNetworkProtocol::StDone\fR - The operation has been processed succesfully. +\fCTQNetworkProtocol::StDone\fR - The operation has been processed succesfully. .TP -\fCQNetworkProtocol::StFailed\fR - The operation has been processed but an error occurred. +\fCTQNetworkProtocol::StFailed\fR - The operation has been processed but an error occurred. .TP -\fCQNetworkProtocol::StStopped\fR - The operation has been processed but has been stopped before it finished, and is waiting to be processed. +\fCTQNetworkProtocol::StStopped\fR - The operation has been processed but has been stopped before it finished, and is waiting to be processed. .PP .SH MEMBER FUNCTION DOCUMENTATION -.SH "QNetworkProtocol::QNetworkProtocol ()" +.SH "TQNetworkProtocol::TQNetworkProtocol ()" Constructor of the network protocol base class. Does some initialization and connecting of signals and slots. -.SH "QNetworkProtocol::~QNetworkProtocol ()\fC [virtual]\fR" +.SH "TQNetworkProtocol::~TQNetworkProtocol ()\fC [virtual]\fR" Destructor. -.SH "void QNetworkProtocol::addOperation ( QNetworkOperation * op )\fC [virtual]\fR" +.SH "void TQNetworkProtocol::addOperation ( TQNetworkOperation * op )\fC [virtual]\fR" Adds the operation \fIop\fR to the operation queue. The operation will be processed as soon as possible. This method returns immediately. -.SH "bool QNetworkProtocol::autoDelete () const" +.SH "bool TQNetworkProtocol::autoDelete () const" Returns TRUE if auto-deleting is enabled; otherwise returns FALSE. .PP -See also QNetworkProtocol::setAutoDelete(). -.SH "bool QNetworkProtocol::checkConnection ( QNetworkOperation * op )\fC [virtual protected]\fR" +See also TQNetworkProtocol::setAutoDelete(). +.SH "bool TQNetworkProtocol::checkConnection ( TQNetworkOperation * op )\fC [virtual protected]\fR" For processing operations the network protocol base class calls this method quite often. This should be reimplemented by new network protocols. It should return TRUE if the connection is OK (open); otherwise it should return FALSE. If the connection is not open the protocol should open it. .PP -If the connection can't be opened (e.g. because you already tried but the host couldn't be found), set the state of \fIop\fR to QNetworkProtocol::StFailed and emit the finished() signal with this QNetworkOperation as argument. +If the connection can't be opened (e.g. because you already tried but the host couldn't be found), set the state of \fIop\fR to TQNetworkProtocol::StFailed and emit the finished() signal with this TQNetworkOperation as argument. .PP \fIop\fR is the operation that needs an open connection. .PP Example: network/networkprotocol/nntp.cpp. -.SH "void QNetworkProtocol::clearOperationQueue ()\fC [virtual]\fR" +.SH "void TQNetworkProtocol::clearOperationQueue ()\fC [virtual]\fR" Clears the operation queue. -.SH "void QNetworkProtocol::connectionStateChanged ( int state, const TQString & data )\fC [signal]\fR" +.SH "void TQNetworkProtocol::connectionStateChanged ( int state, const TQString & data )\fC [signal]\fR" This signal is emitted whenever the state of the connection of the network protocol is changed. \fIstate\fR describes the new state, which is one of, ConHostFound, ConConnected or ConClosed. \fIdata\fR is a message text. -.SH "void QNetworkProtocol::createdDirectory ( const QUrlInfo & i, QNetworkOperation * op )\fC [signal]\fR" +.SH "void TQNetworkProtocol::createdDirectory ( const TQUrlInfo & i, TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted when mkdir() has been succesful and the directory has been created. \fIi\fR holds the information about the new directory. \fIop\fR is the pointer to the operation object which contains all the information about the operation, including the state, etc. Using op->arg( 0 ), you can get the file name of the new directory. .PP -When a protocol emits this signal, QNetworkProtocol is smart enough to let the QUrlOperator, which is used by the network protocol, emit its corresponding signal. -.SH "void QNetworkProtocol::data ( const TQByteArray & data, QNetworkOperation * op )\fC [signal]\fR" +When a protocol emits this signal, TQNetworkProtocol is smart enough to let the TQUrlOperator, which is used by the network protocol, emit its corresponding signal. +.SH "void TQNetworkProtocol::data ( const TQByteArray & data, TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted when new \fIdata\fR has been received after calling get() or put(). \fIop\fR holds the name of the file from which data is retrieved or uploaded in its first argument, and the (raw) data in its second argument. You can get them with op->arg( 0 ) and op->rawArg( 1 ). \fIop\fR is the pointer to the operation object, which contains all the information about the operation, including the state, etc. .PP -When a protocol emits this signal, QNetworkProtocol is smart enough to let the QUrlOperator (which is used by the network protocol) emit its corresponding signal. -.SH "void QNetworkProtocol::dataTransferProgress ( int bytesDone, int bytesTotal, QNetworkOperation * op )\fC [signal]\fR" +When a protocol emits this signal, TQNetworkProtocol is smart enough to let the TQUrlOperator (which is used by the network protocol) emit its corresponding signal. +.SH "void TQNetworkProtocol::dataTransferProgress ( int bytesDone, int bytesTotal, TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted during the transfer of data (using put() or get()). \fIbytesDone\fR is how many bytes of \fIbytesTotal\fR have been transferred. \fIbytesTotal\fR may be -1, which means that the total number of bytes is not known. \fIop\fR is the pointer to the operation object which contains all the information about the operation, including the state, etc. .PP -When a protocol emits this signal, QNetworkProtocol is smart enough to let the QUrlOperator, which is used by the network protocol, emit its corresponding signal. -.SH "void QNetworkProtocol::finished ( QNetworkOperation * op )\fC [signal]\fR" +When a protocol emits this signal, TQNetworkProtocol is smart enough to let the TQUrlOperator, which is used by the network protocol, emit its corresponding signal. +.SH "void TQNetworkProtocol::finished ( TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted when an operation finishes. This signal is always emitted, for both success and failure. \fIop\fR is the pointer to the operation object which contains all the information about the operation, including the state, etc. Check the state and error code of the operation object to determine whether or not the operation was successful. .PP -When a protocol emits this signal, QNetworkProtocol is smart enough to let the QUrlOperator, which is used by the network protocol, emit its corresponding signal. -.SH "QNetworkProtocol * QNetworkProtocol::getNetworkProtocol ( const TQString & protocol )\fC [static]\fR" +When a protocol emits this signal, TQNetworkProtocol is smart enough to let the TQUrlOperator, which is used by the network protocol, emit its corresponding signal. +.SH "TQNetworkProtocol * TQNetworkProtocol::getNetworkProtocol ( const TQString & protocol )\fC [static]\fR" Static method to get a new instance of the network protocol \fIprotocol\fR. For example, if you need to do some FTP operations, do the following: .PP .nf .br - QFtp *ftp = QNetworkProtocol::getNetworkProtocol( "ftp" ); + TQFtp *ftp = TQNetworkProtocol::getNetworkProtocol( "ftp" ); .br .fi This returns a pointer to a new instance of an ftp implementation or null if no protocol for ftp was registered. The ownership of the pointer is transferred to you, so you must delete it if you don't need it anymore. .PP -Normally you should not work directly with network protocols, so you will not need to call this method yourself. Instead, use QUrlOperator, which makes working with network protocols much more convenient. +Normally you should not work directly with network protocols, so you will not need to call this method yourself. Instead, use TQUrlOperator, which makes working with network protocols much more convenient. .PP -See also QUrlOperator. -.SH "bool QNetworkProtocol::hasOnlyLocalFileSystem ()\fC [static]\fR" +See also TQUrlOperator. +.SH "bool TQNetworkProtocol::hasOnlyLocalFileSystem ()\fC [static]\fR" Returns TRUE if the only protocol registered is for working on the local filesystem; returns FALSE if other network protocols are also registered. -.SH "void QNetworkProtocol::itemChanged ( QNetworkOperation * op )\fC [signal]\fR" +.SH "void TQNetworkProtocol::itemChanged ( TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted whenever a file which is a child of this URL has been changed, e.g. by successfully calling rename(). \fIop\fR holds the original and the new file names in the first and second arguments, accessible with op->arg( 0 ) and op->arg( 1 ) respectively. \fIop\fR is the pointer to the operation object which contains all the information about the operation, including the state, etc. .PP -When a protocol emits this signal, QNetworkProtocol is smart enough to let the QUrlOperator, which is used by the network protocol, emit its corresponding signal. -.SH "void QNetworkProtocol::newChild ( const QUrlInfo & i, QNetworkOperation * op )\fC [signal]\fR" -This signal is emitted if a new child (file) has been read. QNetworkProtocol automatically connects it to a slot which creates a list of QUrlInfo objects (with just one QUrlInfo \fIi\fR) and emits the newChildren() signal with this list. \fIop\fR is the pointer to the operation object which contains all the information about the operation that has finished, including the state, etc. +When a protocol emits this signal, TQNetworkProtocol is smart enough to let the TQUrlOperator, which is used by the network protocol, emit its corresponding signal. +.SH "void TQNetworkProtocol::newChild ( const TQUrlInfo & i, TQNetworkOperation * op )\fC [signal]\fR" +This signal is emitted if a new child (file) has been read. TQNetworkProtocol automatically connects it to a slot which creates a list of TQUrlInfo objects (with just one TQUrlInfo \fIi\fR) and emits the newChildren() signal with this list. \fIop\fR is the pointer to the operation object which contains all the information about the operation that has finished, including the state, etc. .PP -This is just a convenience signal useful for implementing your own network protocol. In all other cases connect to the newChildren() signal with its list of QUrlInfo objects. -.SH "void QNetworkProtocol::newChildren ( const TQValueList<QUrlInfo> & i, QNetworkOperation * op )\fC [signal]\fR" +This is just a convenience signal useful for implementing your own network protocol. In all other cases connect to the newChildren() signal with its list of TQUrlInfo objects. +.SH "void TQNetworkProtocol::newChildren ( const TQValueList<TQUrlInfo> & i, TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted after listChildren() was called and new children (files) have been read from the list of files. \fIi\fR holds the information about the new children. \fIop\fR is the pointer to the operation object which contains all the information about the operation, including the state, etc. .PP -When a protocol emits this signal, QNetworkProtocol is smart enough to let the QUrlOperator, which is used by the network protocol, emit its corresponding signal. +When a protocol emits this signal, TQNetworkProtocol is smart enough to let the TQUrlOperator, which is used by the network protocol, emit its corresponding signal. .PP -When implementing your own network protocol and reading children, you usually don't read one child at once, but rather a list of them. That's why this signal takes a list of QUrlInfo objects. If you prefer to read just one child at a time you can use the convenience signal newChild(), which takes a single QUrlInfo object. -.SH "void QNetworkProtocol::operationGet ( QNetworkOperation * op )\fC [virtual protected]\fR" -When implementing a new network protocol, this method should be reimplemented if the protocol supports getting data; this method should then process the QNetworkOperation. +When implementing your own network protocol and reading children, you usually don't read one child at once, but rather a list of them. That's why this signal takes a list of TQUrlInfo objects. If you prefer to read just one child at a time you can use the convenience signal newChild(), which takes a single TQUrlInfo object. +.SH "void TQNetworkProtocol::operationGet ( TQNetworkOperation * op )\fC [virtual protected]\fR" +When implementing a new network protocol, this method should be reimplemented if the protocol supports getting data; this method should then process the TQNetworkOperation. .PP When you reimplement this method it's very important that you emit the correct signals at the correct time (especially the finished() signal after processing an operation). Take a look at the TQt Network Documentation which describes in detail how to reimplement this method. You may also want to look at the example implementation in examples/network/networkprotocol/nntp.cpp. .PP \fIop\fR is the pointer to the operation object which contains all the information on the operation that has finished, including the state, etc. .PP Example: network/networkprotocol/nntp.cpp. -.SH "QNetworkOperation * QNetworkProtocol::operationInProgress () const" +.SH "TQNetworkOperation * TQNetworkProtocol::operationInProgress () const" Returns the operation, which is being processed, or 0 of no operation is being processed at the moment. -.SH "void QNetworkProtocol::operationListChildren ( QNetworkOperation * op )\fC [virtual protected]\fR" -When implementing a new network protocol, this method should be reimplemented if the protocol supports listing children (files); this method should then process this QNetworkOperation. +.SH "void TQNetworkProtocol::operationListChildren ( TQNetworkOperation * op )\fC [virtual protected]\fR" +When implementing a new network protocol, this method should be reimplemented if the protocol supports listing children (files); this method should then process this TQNetworkOperation. .PP When you reimplement this method it's very important that you emit the correct signals at the correct time (especially the finished() signal after processing an operation). Take a look at the TQt Network Documentation which describes in detail how to reimplement this method. You may also want to look at the example implementation in examples/network/networkprotocol/nntp.cpp. .PP \fIop\fR is the pointer to the operation object which contains all the information on the operation that has finished, including the state, etc. .PP Example: network/networkprotocol/nntp.cpp. -.SH "void QNetworkProtocol::operationMkDir ( QNetworkOperation * op )\fC [virtual protected]\fR" -When implementing a new network protocol, this method should be reimplemented if the protocol supports making directories; this method should then process this QNetworkOperation. +.SH "void TQNetworkProtocol::operationMkDir ( TQNetworkOperation * op )\fC [virtual protected]\fR" +When implementing a new network protocol, this method should be reimplemented if the protocol supports making directories; this method should then process this TQNetworkOperation. .PP When you reimplement this method it's very important that you emit the correct signals at the correct time (especially the finished() signal after processing an operation). Take a look at the TQt Network Documentation which describes in detail how to reimplement this method. You may also want to look at the example implementation in examples/network/networkprotocol/nntp.cpp. .PP \fIop\fR is the pointer to the operation object which contains all the information on the operation that has finished, including the state, etc. -.SH "void QNetworkProtocol::operationPut ( QNetworkOperation * op )\fC [virtual protected]\fR" -When implementing a new network protocol, this method should be reimplemented if the protocol supports putting (uploading) data; this method should then process the QNetworkOperation. +.SH "void TQNetworkProtocol::operationPut ( TQNetworkOperation * op )\fC [virtual protected]\fR" +When implementing a new network protocol, this method should be reimplemented if the protocol supports putting (uploading) data; this method should then process the TQNetworkOperation. .PP When you reimplement this method it's very important that you emit the correct signals at the correct time (especially the finished() signal after processing an operation). Take a look at the TQt Network Documentation which describes in detail how to reimplement this method. You may also want to look at the example implementation in examples/network/networkprotocol/nntp.cpp. .PP \fIop\fR is the pointer to the operation object which contains all the information on the operation that has finished, including the state, etc. -.SH "void QNetworkProtocol::operationRemove ( QNetworkOperation * op )\fC [virtual protected]\fR" -When implementing a new network protocol, this method should be reimplemented if the protocol supports removing children (files); this method should then process this QNetworkOperation. +.SH "void TQNetworkProtocol::operationRemove ( TQNetworkOperation * op )\fC [virtual protected]\fR" +When implementing a new network protocol, this method should be reimplemented if the protocol supports removing children (files); this method should then process this TQNetworkOperation. .PP When you reimplement this method it's very important that you emit the correct signals at the correct time (especially the finished() signal after processing an operation). Take a look at the TQt Network Documentation which is describes in detail how to reimplement this method. You may also want to look at the example implementation in examples/network/networkprotocol/nntp.cpp. .PP \fIop\fR is the pointer to the operation object which contains all the information on the operation that has finished, including the state, etc. -.SH "void QNetworkProtocol::operationRename ( QNetworkOperation * op )\fC [virtual protected]\fR" -When implementing a new newtork protocol, this method should be reimplemented if the protocol supports renaming children (files); this method should then process this QNetworkOperation. +.SH "void TQNetworkProtocol::operationRename ( TQNetworkOperation * op )\fC [virtual protected]\fR" +When implementing a new newtork protocol, this method should be reimplemented if the protocol supports renaming children (files); this method should then process this TQNetworkOperation. .PP When you reimplement this method it's very important that you emit the correct signals at the correct time (especially the finished() signal after processing an operation). Take a look at the TQt Network Documentation which describes in detail how to reimplement this method. You may also want to look at the example implementation in examples/network/networkprotocol/nntp.cpp. .PP \fIop\fR is the pointer to the operation object which contains all the information on the operation that has finished, including the state, etc. -.SH "void QNetworkProtocol::registerNetworkProtocol ( const TQString & protocol, QNetworkProtocolFactoryBase * protocolFactory )\fC [static]\fR" -Static method to register a network protocol for Qt. For example, if you have an implementation of NNTP (called Nntp) which is derived from QNetworkProtocol, call: +.SH "void TQNetworkProtocol::registerNetworkProtocol ( const TQString & protocol, TQNetworkProtocolFactoryBase * protocolFactory )\fC [static]\fR" +Static method to register a network protocol for Qt. For example, if you have an implementation of NNTP (called Nntp) which is derived from TQNetworkProtocol, call: .PP .nf .br - QNetworkProtocol::registerNetworkProtocol( "nntp", new QNetworkProtocolFactory<Nntp> ); + TQNetworkProtocol::registerNetworkProtocol( "nntp", new TQNetworkProtocolFactory<Nntp> ); .br .fi after which your implementation is registered for future nntp operations. .PP The name of the protocol is given in \fIprotocol\fR and a pointer to the protocol factory is given in \fIprotocolFactory\fR. -.SH "void QNetworkProtocol::removed ( QNetworkOperation * op )\fC [signal]\fR" +.SH "void TQNetworkProtocol::removed ( TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted when remove() has been succesful and the file has been removed. \fIop\fR holds the file name of the removed file in the first argument, accessible with op->arg( 0 ). \fIop\fR is the pointer to the operation object which contains all the information about the operation, including the state, etc. .PP -When a protocol emits this signal, QNetworkProtocol is smart enough to let the QUrlOperator, which is used by the network protocol, emit its corresponding signal. -.SH "void QNetworkProtocol::setAutoDelete ( bool b, int i = 10000 )\fC [virtual]\fR" -Because it's sometimes hard to take care of removing network protocol instances, QNetworkProtocol provides an auto-delete mechanism. If you set \fIb\fR to TRUE, the network protocol instance is removed after it has been inactive for \fIi\fR milliseconds (i.e. \fIi\fR milliseconds after the last operation has been processed). If you set \fIb\fR to FALSE the auto-delete mechanism is switched off. +When a protocol emits this signal, TQNetworkProtocol is smart enough to let the TQUrlOperator, which is used by the network protocol, emit its corresponding signal. +.SH "void TQNetworkProtocol::setAutoDelete ( bool b, int i = 10000 )\fC [virtual]\fR" +Because it's sometimes hard to take care of removing network protocol instances, TQNetworkProtocol provides an auto-delete mechanism. If you set \fIb\fR to TRUE, the network protocol instance is removed after it has been inactive for \fIi\fR milliseconds (i.e. \fIi\fR milliseconds after the last operation has been processed). If you set \fIb\fR to FALSE the auto-delete mechanism is switched off. .PP -If you switch on auto-delete, the QNetworkProtocol also deletes its QUrlOperator. -.SH "void QNetworkProtocol::setUrl ( QUrlOperator * u )\fC [virtual]\fR" -Sets the QUrlOperator, on which the protocol works, to \fIu\fR. +If you switch on auto-delete, the TQNetworkProtocol also deletes its TQUrlOperator. +.SH "void TQNetworkProtocol::setUrl ( TQUrlOperator * u )\fC [virtual]\fR" +Sets the TQUrlOperator, on which the protocol works, to \fIu\fR. .PP -See also QUrlOperator. -.SH "void QNetworkProtocol::start ( QNetworkOperation * op )\fC [signal]\fR" +See also TQUrlOperator. +.SH "void TQNetworkProtocol::start ( TQNetworkOperation * op )\fC [signal]\fR" Some operations (such as listChildren()) emit this signal when they start processing the operation. \fIop\fR is the pointer to the operation object which contains all the information about the operation, including the state, etc. .PP -When a protocol emits this signal, QNetworkProtocol is smart enough to let the QUrlOperator, which is used by the network protocol, emit its corresponding signal. -.SH "void QNetworkProtocol::stop ()\fC [virtual]\fR" +When a protocol emits this signal, TQNetworkProtocol is smart enough to let the TQUrlOperator, which is used by the network protocol, emit its corresponding signal. +.SH "void TQNetworkProtocol::stop ()\fC [virtual]\fR" Stops the current operation that is being processed and clears all waiting operations. -.SH "int QNetworkProtocol::supportedOperations () const\fC [virtual]\fR" -Returns an int that is OR'd together using the enum values of QNetworkProtocol::Operation, which describes which operations are supported by the network protocol. Should be reimplemented by new network protocols. +.SH "int TQNetworkProtocol::supportedOperations () const\fC [virtual]\fR" +Returns an int that is OR'd together using the enum values of TQNetworkProtocol::Operation, which describes which operations are supported by the network protocol. Should be reimplemented by new network protocols. .PP Example: network/networkprotocol/nntp.cpp. -.SH "QUrlOperator * QNetworkProtocol::url () const" -Returns the QUrlOperator on which the protocol works. +.SH "TQUrlOperator * TQNetworkProtocol::url () const" +Returns the TQUrlOperator on which the protocol works. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqnetworkprotocol.html +.BR http://doc.trolltech.com/tqnetworkprotocol.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqnpinstance.3qt b/doc/man/man3/tqnpinstance.3qt index e48d1a0b7..a17dafec2 100644 --- a/doc/man/man3/tqnpinstance.3qt +++ b/doc/man/man3/tqnpinstance.3qt @@ -113,7 +113,7 @@ The QNPInstance is responsible for creating an appropriate QNPWidget window if r .PP Note that there is \fIabsolutely no guarantee\fR regarding the order in which functions are called. Sometimes the browser will call newWindow() first, at other times, newStreamCreated() will be called first (assuming the \fC<EMBED>\fR tag has a SRC parameter). .PP -\fINone of Qt's GUI functionality\fR may be used until after the first call to newWindow(). This includes any use of QPaintDevice (i.e. QPixmap, TQWidget, and all subclasses), QApplication, anything related to QPainter (QBrush, etc.), fonts, QMovie, TQToolTip, etc. Useful classes which specifically \fIcan\fR be used are TQImage, QFile, and QBuffer. +\fINone of Qt's GUI functionality\fR may be used until after the first call to newWindow(). This includes any use of QPaintDevice (i.e. QPixmap, TQWidget, and all subclasses), QApplication, anything related to QPainter (QBrush, etc.), fonts, QMovie, TQToolTip, etc. Useful classes which specifically \fIcan\fR be used are TQImage, TQFile, and TQBuffer. .PP This restriction can easily be accommodated by structuring your plugin so that the task of the QNPInstance is to gather data, while the task of the QNPWidget is to provide a graphical interface to that data. .SS "Member Type Documentation" diff --git a/doc/man/man3/tqnpstream.3qt b/doc/man/man3/tqnpstream.3qt index d948389c2..958767d40 100644 --- a/doc/man/man3/tqnpstream.3qt +++ b/doc/man/man3/tqnpstream.3qt @@ -57,7 +57,7 @@ This class is defined in the \fBQt Netscape Extension\fR, which can be found in .PP The QNPStream class provides a stream of data provided to a QNPInstance by the browser. .PP -Note that this is neither a TQTextStream nor a QDataStream. +Note that this is neither a TQTextStream nor a TQDataStream. .PP See also QNPInstance::write() and QNPInstance::newStreamCreated(). .SH MEMBER FUNCTION DOCUMENTATION diff --git a/doc/man/man3/tqobject.3qt b/doc/man/man3/tqobject.3qt index 1d8df8949..39be265fe 100644 --- a/doc/man/man3/tqobject.3qt +++ b/doc/man/man3/tqobject.3qt @@ -15,7 +15,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .PP Inherits Qt. .PP --Inherited by QAccel, QAccessibleObject, TQAction, QApplication, QAssistantClient, QDataPump, TQWidget, TQCanvas, TQStyle, QClipboard, QDns, QLayout, TQDragObject, TQEditorFactory, QEventLoop, QFileIconProvider, QNetworkProtocol, QNetworkOperation, QNPInstance, TQObjectCleanupHandler, QProcess, QServerSocket, TQSessionManager, QSignal, QSignalMapper, QSocket, QSocketNotifier, QSound, TQSqlDatabase, TQSqlDriver, TQSqlForm, TQStyleSheet, TQTimer, TQToolTipGroup, QTranslator, QUrlOperator, and QValidator. +-Inherited by QAccel, QAccessibleObject, TQAction, QApplication, QAssistantClient, TQDataPump, TQWidget, TQCanvas, TQStyle, TQClipboard, TQDns, QLayout, TQDragObject, TQEditorFactory, QEventLoop, TQFileIconProvider, TQNetworkProtocol, TQNetworkOperation, QNPInstance, TQObjectCleanupHandler, TQProcess, TQServerSocket, TQSessionManager, TQSignal, TQSignalMapper, TQSocket, TQSocketNotifier, QSound, TQSqlDatabase, TQSqlDriver, TQSqlForm, TQStyleSheet, TQTimer, TQToolTipGroup, QTranslator, TQUrlOperator, and QValidator. .PP .SS "Public Members" .in +1c diff --git a/doc/man/man3/tqpainter.3qt b/doc/man/man3/tqpainter.3qt index ee86c6e29..afd753ff2 100644 --- a/doc/man/man3/tqpainter.3qt +++ b/doc/man/man3/tqpainter.3qt @@ -885,7 +885,7 @@ Currently the mask of the pixmap or it's alpha channel are ignored when painting See also bitBlt() and QPixmap::setMask(). .PP Examples: -.)l grapher/grapher.cpp, picture/picture.cpp, qdir/qdir.cpp, qmag/qmag.cpp, showimg/showimg.cpp, t10/cannon.cpp, and xform/xform.cpp. +.)l grapher/grapher.cpp, picture/picture.cpp, tqdir/tqdir.cpp, qmag/qmag.cpp, showimg/showimg.cpp, t10/cannon.cpp, and xform/xform.cpp. .SH "void QPainter::drawPixmap ( const QPoint & p, const QPixmap & pm, const QRect & sr )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP @@ -1094,7 +1094,7 @@ You can specify a TQColor as \fIbrush\fR, since there is a QBrush constructor th See also drawRect(). .PP Examples: -.)l listboxcombo/listboxcombo.cpp, multiple/ax1.h, progress/progress.cpp, qdir/qdir.cpp, qfd/fontdisplayer.cpp, themes/metal.cpp, and themes/wood.cpp. +.)l listboxcombo/listboxcombo.cpp, multiple/ax1.h, progress/progress.cpp, tqdir/tqdir.cpp, qfd/fontdisplayer.cpp, themes/metal.cpp, and themes/wood.cpp. .SH "void QPainter::fillRect ( const QRect & r, const QBrush & brush )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP @@ -1114,7 +1114,7 @@ Returns the currently set painter font. .PP See also setFont() and QFont. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "QFontInfo QPainter::fontInfo () const" Returns the font info for the painter, if the painter is active. It is not possible to obtain font information for an inactive painter, so the return value is undefined if the painter is not active. .PP diff --git a/doc/man/man3/tqpalette.3qt b/doc/man/man3/tqpalette.3qt index a1ab5cca9..5bdb2951b 100644 --- a/doc/man/man3/tqpalette.3qt +++ b/doc/man/man3/tqpalette.3qt @@ -92,10 +92,10 @@ QPalette \- Color groups for each widget state .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QPalette & p )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QPalette & p )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QPalette & p )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QPalette & p )" .br .in -1c .SH DESCRIPTION @@ -238,14 +238,14 @@ Sets the Inactive color group to \fIg\fR. .PP See also active(), setDisabled(), setActive(), and QColorGroup. .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QPalette & p )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QPalette & p )" Writes the palette, \fIp\fR to the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, QPalette & p )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, QPalette & p )" Reads a palette from the stream, \fIs\fR into the palette \fIp\fR, and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqpalette.html diff --git a/doc/man/man3/tqpen.3qt b/doc/man/man3/tqpen.3qt index 9ce81f70a..410a03e84 100644 --- a/doc/man/man3/tqpen.3qt +++ b/doc/man/man3/tqpen.3qt @@ -76,10 +76,10 @@ Inherits Qt. .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QPen & p )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QPen & p )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QPen & p )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QPen & p )" .br .in -1c .SH DESCRIPTION @@ -252,14 +252,14 @@ See also setWidth(). .PP Example: scribble/scribble.h. .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QPen & p )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QPen & p )" Writes the pen \fIp\fR to the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, QPen & p )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, QPen & p )" Reads a pen from the stream \fIs\fR into \fIp\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqpen.html diff --git a/doc/man/man3/tqpicture.3qt b/doc/man/man3/tqpicture.3qt index 477488a74..9df2652e6 100644 --- a/doc/man/man3/tqpicture.3qt +++ b/doc/man/man3/tqpicture.3qt @@ -76,10 +76,10 @@ Inherits QPaintDevice. .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QPicture & r )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QPicture & r )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QPicture & r )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QPicture & r )" .br .in -1c .SH DESCRIPTION @@ -223,9 +223,9 @@ Returns the size of the picture data. .PP See also data(). .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QPicture & r )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QPicture & r )" Writes picture \fIr\fR to the stream \fIs\fR and returns a reference to the stream. -.SH "QDataStream & operator>> ( QDataStream & s, QPicture & r )" +.SH "TQDataStream & operator>> ( TQDataStream & s, QPicture & r )" Reads a picture from the stream \fIs\fR into picture \fIr\fR and returns a reference to the stream. diff --git a/doc/man/man3/tqpixmap.3qt b/doc/man/man3/tqpixmap.3qt index 37c9aaa2e..a00579abb 100644 --- a/doc/man/man3/tqpixmap.3qt +++ b/doc/man/man3/tqpixmap.3qt @@ -198,10 +198,10 @@ Inherited by TQBitmap and TQCanvasPixmap. .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QPixmap & pixmap )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QPixmap & pixmap )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QPixmap & pixmap )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QPixmap & pixmap )" .br .ti -1c .BI "void \fBcopyBlt\fR ( QPixmap * dst, int dx, int dy, const QPixmap * src, int sx, int sy, int sw, int sh )" @@ -546,7 +546,7 @@ Resizing an existing pixmap to (0, 0) makes a pixmap into a null pixmap. See also resize(). .PP Examples: -.)l movies/main.cpp, qdir/qdir.cpp, qmag/qmag.cpp, and scrollview/scrollview.cpp. +.)l movies/main.cpp, tqdir/tqdir.cpp, qmag/qmag.cpp, and scrollview/scrollview.cpp. .SH "bool QPixmap::isTQBitmap () const" Returns TRUE if this is a TQBitmap; otherwise returns FALSE. .SH "bool QPixmap::load ( const TQString & fileName, const char * format, int conversion_flags )" @@ -652,7 +652,7 @@ This function writes a QPixmap to the TQIODevice, \fIdevice\fR. This can be used .br TQByteArray ba; .br - QBuffer buffer( ba ); + TQBuffer buffer( ba ); .br buffer.open( IO_WriteOnly ); .br @@ -741,7 +741,7 @@ This function is slow because it involves transformation to a TQImage, non-trivi See also trueMatrix(), QWMatrix, QPainter::setWorldMatrix(), and TQImage::xForm(). .PP Examples: -.)l desktop/desktop.cpp, fileiconview/qfileiconview.cpp, movies/main.cpp, and qmag/qmag.cpp. +.)l desktop/desktop.cpp, fileiconview/tqfileiconview.cpp, movies/main.cpp, and qmag/qmag.cpp. .SH RELATED FUNCTION DOCUMENTATION .SH "void copyBlt ( QPixmap * dst, int dx, int dy, const QPixmap * src, int sx, int sy, int sw, int sh )" Copies a block of pixels from \fIsrc\fR to \fIdst\fR. The alpha channel and mask data (if any) is also copied from \fIsrc\fR. NOTE: \fIsrc\fR is \fInot\fR alpha blended or masked when copied to \fIdst\fR. Use bitBlt() or QPainter::drawPixmap() to perform alpha blending or masked drawing. @@ -751,16 +751,16 @@ Copies a block of pixels from \fIsrc\fR to \fIdst\fR. The alpha channel and mask If \fIsrc\fR, \fIdst\fR, \fIsw\fR or \fIsh\fR is 0 (zero), copyBlt() does nothing. If \fIsw\fR or \fIsh\fR is negative, copyBlt() copies starting at \fIsx\fR (and respectively, \fIsy\fR) and ending at the right edge (and respectively, the bottom edge) of \fIsrc\fR. .PP copyBlt() does nothing if \fIsrc\fR and \fIdst\fR have different depths. -.SH "QDataStream & operator<< ( QDataStream & s, const QPixmap & pixmap )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QPixmap & pixmap )" Writes the pixmap \fIpixmap\fR to the stream \fIs\fR as a PNG image. .PP Note that writing the stream to a file will not produce a valid image file. .PP -See also QPixmap::save() and Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, QPixmap & pixmap )" +See also QPixmap::save() and Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, QPixmap & pixmap )" Reads a pixmap from the stream \fIs\fR into the pixmap \fIpixmap\fR. .PP -See also QPixmap::load() and Format of the QDataStream operators. +See also QPixmap::load() and Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqpixmap.html diff --git a/doc/man/man3/tqpoint.3qt b/doc/man/man3/tqpoint.3qt index 1f042cb1d..862870427 100644 --- a/doc/man/man3/tqpoint.3qt +++ b/doc/man/man3/tqpoint.3qt @@ -98,10 +98,10 @@ QPoint \- Defines a point in the plane .BI "const QPoint \fBoperator/\fR ( const QPoint & p, double c )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QPoint & p )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QPoint & p )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QPoint & p )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QPoint & p )" .br .in -1c .SH DESCRIPTION @@ -295,14 +295,14 @@ Returns the x coordinate of the point. See also setX() and y(). .PP Examples: -.)l canvas/canvas.cpp, chart/canvasview.cpp, dirview/dirview.cpp, fileiconview/qfileiconview.cpp, helpsystem/tooltip.cpp, life/life.cpp, and t14/cannon.cpp. +.)l canvas/canvas.cpp, chart/canvasview.cpp, dirview/dirview.cpp, fileiconview/tqfileiconview.cpp, helpsystem/tooltip.cpp, life/life.cpp, and t14/cannon.cpp. .SH "int QPoint::y () const" Returns the y coordinate of the point. .PP See also setY() and x(). .PP Examples: -.)l canvas/canvas.cpp, chart/canvasview.cpp, fileiconview/qfileiconview.cpp, helpsystem/tooltip.cpp, life/life.cpp, t14/cannon.cpp, and themes/wood.cpp. +.)l canvas/canvas.cpp, chart/canvasview.cpp, fileiconview/tqfileiconview.cpp, helpsystem/tooltip.cpp, life/life.cpp, t14/cannon.cpp, and themes/wood.cpp. .SH RELATED FUNCTION DOCUMENTATION .SH "bool operator!= ( const QPoint & p1, const QPoint & p2 )" Returns TRUE if \fIp1\fR and \fIp2\fR are not equal; otherwise returns FALSE. @@ -340,16 +340,16 @@ This is an overloaded member function, provided for convenience. It behaves esse Returns the QPoint formed by dividing both components of \fIp\fR by \fIc\fR. .PP Note that the result is truncated because points are held as integers. -.SH "QDataStream & operator<< ( QDataStream & s, const QPoint & p )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QPoint & p )" Writes point \fIp\fR to the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "bool operator== ( const QPoint & p1, const QPoint & p2 )" Returns TRUE if \fIp1\fR and \fIp2\fR are equal; otherwise returns FALSE. -.SH "QDataStream & operator>> ( QDataStream & s, QPoint & p )" +.SH "TQDataStream & operator>> ( TQDataStream & s, QPoint & p )" Reads a QPoint from the stream \fIs\fR into point \fIp\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqpoint.html diff --git a/doc/man/man3/tqpointarray.3qt b/doc/man/man3/tqpointarray.3qt index b01c0df2e..94e6a9740 100644 --- a/doc/man/man3/tqpointarray.3qt +++ b/doc/man/man3/tqpointarray.3qt @@ -76,10 +76,10 @@ Inherits TQMemArray<QPoint>. .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QPointArray & a )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QPointArray & a )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QPointArray & a )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QPointArray & a )" .br .in -1c .SH DESCRIPTION @@ -242,14 +242,14 @@ Sets the point at array index \fIi\fR to \fIp\fR. .SH "void QPointArray::translate ( int dx, int dy )" Translates all points in the array by \fI(dx, dy)\fR. .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QPointArray & a )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QPointArray & a )" Writes the point array, \fIa\fR to the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, QPointArray & a )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, QPointArray & a )" Reads a point array, \fIa\fR from the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqpointarray.html diff --git a/doc/man/man3/tqpopupmenu.3qt b/doc/man/man3/tqpopupmenu.3qt index f6c5bb47f..c81f1dc78 100644 --- a/doc/man/man3/tqpopupmenu.3qt +++ b/doc/man/man3/tqpopupmenu.3qt @@ -278,7 +278,7 @@ Normally, you connect each menu item to a single slot using TQMenuData::insertIt See also highlighted() and TQMenuData::insertItem(). .PP Examples: -.)l grapher/grapher.cpp, helpviewer/helpwindow.cpp, qdir/qdir.cpp, qwerty/qwerty.cpp, scrollview/scrollview.cpp, and showimg/showimg.cpp. +.)l grapher/grapher.cpp, helpviewer/helpwindow.cpp, tqdir/tqdir.cpp, qwerty/qwerty.cpp, scrollview/scrollview.cpp, and showimg/showimg.cpp. .SH "void TQMenuData::changeItem ( int id, const TQString & text )" Changes the text of the menu item \fIid\fR to \fItext\fR. If the item has an icon, the icon remains unchanged. .PP @@ -355,7 +355,7 @@ or aligned to a widget: .fi .PP Examples: -.)l fileiconview/qfileiconview.cpp, menu/menu.cpp, and scribble/scribble.cpp. +.)l fileiconview/tqfileiconview.cpp, menu/menu.cpp, and scribble/scribble.cpp. .SH "int TQPopupMenu::exec ( const QPoint & pos, int indexAtPoint = 0 )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP @@ -765,7 +765,7 @@ Returns the text that has been set for menu item \fIid\fR, or TQString::null if See also changeItem(), pixmap(), and iconSet(). .PP Examples: -.)l qdir/qdir.cpp and showimg/showimg.cpp. +.)l tqdir/tqdir.cpp and showimg/showimg.cpp. .SH "void TQPopupMenu::updateItem ( int id )\fC [virtual]\fR" Updates the item with identity \fIid\fR. .PP diff --git a/doc/man/man3/tqprocess.3qt b/doc/man/man3/tqprocess.3qt index 0e2fe3009..c1f3ee1d3 100644 --- a/doc/man/man3/tqprocess.3qt +++ b/doc/man/man3/tqprocess.3qt @@ -1,5 +1,5 @@ '\" t -.TH QProcess 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQProcess 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,25 +7,25 @@ .ad l .nh .SH NAME -QProcess \- Used to start external programs and to communicate with them +TQProcess \- Used to start external programs and to communicate with them .SH SYNOPSIS -\fC#include <ntqprocess.h>\fR +\fC#include <tqprocess.h>\fR .PP Inherits TQObject. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQProcess\fR ( TQObject * parent = 0, const char * name = 0 )" +.BI "\fBTQProcess\fR ( TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fBQProcess\fR ( const TQString & arg0, TQObject * parent = 0, const char * name = 0 )" +.BI "\fBTQProcess\fR ( const TQString & arg0, TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fBQProcess\fR ( const TQStringList & args, TQObject * parent = 0, const char * name = 0 )" +.BI "\fBTQProcess\fR ( const TQStringList & args, TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fB~QProcess\fR ()" +.BI "\fB~TQProcess\fR ()" .br .ti -1c .BI "TQStringList \fBarguments\fR () const" @@ -40,10 +40,10 @@ Inherits TQObject. .BI "virtual void \fBaddArgument\fR ( const TQString & arg )" .br .ti -1c -.BI "QDir \fBworkingDirectory\fR () const" +.BI "TQDir \fBworkingDirectory\fR () const" .br .ti -1c -.BI "virtual void \fBsetWorkingDirectory\fR ( const QDir & dir )" +.BI "virtual void \fBsetWorkingDirectory\fR ( const TQDir & dir )" .br .ti -1c .BI "enum \fBCommunication\fR { Stdin = 0x01, Stdout = 0x02, Stderr = 0x04, DupStderr = 0x08 }" @@ -131,7 +131,7 @@ Inherits TQObject. .br .in -1c .SH DESCRIPTION -The QProcess class is used to start external programs and to communicate with them. +The TQProcess class is used to start external programs and to communicate with them. .PP You can write to the started program's standard input, and can read the program's standard output and standard error. You can pass command line arguments to the program either in the constructor or with setArguments() or addArgument(). The program's working directory can be set with setWorkingDirectory(). If you need to set up environment variables pass them to the start() or launch() functions (see below). The processExited() signal is emitted if the program exits. The program's exit status is available from exitStatus(), although you could simply call normalExit() to see if the program terminated normally. .PP @@ -153,7 +153,7 @@ As an example, suppose we want to start the \fCuic\fR command (a TQt command lin .br .fi .PP -A code snippet for this with the QProcess class might look like this: +A code snippet for this with the TQProcess class might look like this: .PP .nf .br @@ -164,7 +164,7 @@ A code snippet for this with the QProcess class might look like this: .PP .nf .br - proc = new QProcess( this ); + proc = new TQProcess( this ); .fi .PP .nf @@ -221,46 +221,46 @@ In the above example you could connect the processExited() signal to the slot Ui .PP Note that if you are expecting a lot of output from the process, you may hit platform-dependent limits to the pipe buffer size. The solution is to make sure you connect to the output, e.g. the readyReadStdout() and readyReadStderr() signals and read the data as soon as it becomes available. .PP -Please note that QProcess does not emulate a shell. This means that QProcess does not do any expansion of arguments: a '*' is passed as a '*' to the program and is \fInot\fR replaced by all the files, a '$HOME' is also passed literally and is \fInot\fR replaced by the environment variable HOME and the special characters for IO redirection ('>', '|', etc.) are also passed literally and do \fInot\fR have the special meaning as they have in a shell. +Please note that TQProcess does not emulate a shell. This means that TQProcess does not do any expansion of arguments: a '*' is passed as a '*' to the program and is \fInot\fR replaced by all the files, a '$HOME' is also passed literally and is \fInot\fR replaced by the environment variable HOME and the special characters for IO redirection ('>', '|', etc.) are also passed literally and do \fInot\fR have the special meaning as they have in a shell. .PP -Also note that QProcess does not emulate a terminal. This means that certain programs which need direct terminal control, do not work as expected with QProcess. Such programs include console email programs (like pine and mutt) but also programs which require the user to enter a password (like su and ssh). +Also note that TQProcess does not emulate a terminal. This means that certain programs which need direct terminal control, do not work as expected with TQProcess. Such programs include console email programs (like pine and mutt) but also programs which require the user to enter a password (like su and ssh). .SH "Notes for Windows users" -Some Windows commands, for example, \fCdir\fR, are not provided by separate applications, but by the command interpreter. If you attempt to use QProcess to execute these commands directly it won't work. One possible solution is to execute the command interpreter itself (\fCcmd.exe\fR on some Windows systems), and ask the interpreter to execute the desired command. +Some Windows commands, for example, \fCdir\fR, are not provided by separate applications, but by the command interpreter. If you attempt to use TQProcess to execute these commands directly it won't work. One possible solution is to execute the command interpreter itself (\fCcmd.exe\fR on some Windows systems), and ask the interpreter to execute the desired command. .PP Under Windows there are certain problems starting 16-bit applications and capturing their output. Microsoft recommends using an intermediate application to start 16-bit applications. .PP -See also QSocket, Input/Output and Networking, and Miscellaneous Classes. +See also TQSocket, Input/Output and Networking, and Miscellaneous Classes. .SS "Member Type Documentation" -.SH "QProcess::Communication" +.SH "TQProcess::Communication" This enum type defines the communication channels connected to the process. .TP -\fCQProcess::Stdin\fR - Data can be written to the process's standard input. +\fCTQProcess::Stdin\fR - Data can be written to the process's standard input. .TP -\fCQProcess::Stdout\fR - Data can be read from the process's standard output. +\fCTQProcess::Stdout\fR - Data can be read from the process's standard output. .TP -\fCQProcess::Stderr\fR - Data can be read from the process's standard error. +\fCTQProcess::Stderr\fR - Data can be read from the process's standard error. .TP -\fCQProcess::DupStderr\fR - Both the process's standard error output \fIand\fR its standard output are written to its standard output. (Like Unix's dup2().) This means that nothing is sent to the standard error output. This is especially useful if your application requires that the output on standard output and on standard error must be read in the same order that they are produced. This is a flag, so to activate it you must pass \fCStdout|Stderr|DupStderr\fR, or \fCStdin|Stdout|Stderr|DupStderr\fR if you want to provide input, to the setCommunication() call. +\fCTQProcess::DupStderr\fR - Both the process's standard error output \fIand\fR its standard output are written to its standard output. (Like Unix's dup2().) This means that nothing is sent to the standard error output. This is especially useful if your application requires that the output on standard output and on standard error must be read in the same order that they are produced. This is a flag, so to activate it you must pass \fCStdout|Stderr|DupStderr\fR, or \fCStdin|Stdout|Stderr|DupStderr\fR if you want to provide input, to the setCommunication() call. .PP See also setCommunication() and communication(). .SH MEMBER FUNCTION DOCUMENTATION -.SH "QProcess::QProcess ( TQObject * parent = 0, const char * name = 0 )" -Constructs a QProcess object. The \fIparent\fR and \fIname\fR parameters are passed to the TQObject constructor. +.SH "TQProcess::TQProcess ( TQObject * parent = 0, const char * name = 0 )" +Constructs a TQProcess object. The \fIparent\fR and \fIname\fR parameters are passed to the TQObject constructor. .PP See also setArguments(), addArgument(), and start(). -.SH "QProcess::QProcess ( const TQString & arg0, TQObject * parent = 0, const char * name = 0 )" -Constructs a QProcess with \fIarg0\fR as the command to be executed. The \fIparent\fR and \fIname\fR parameters are passed to the TQObject constructor. +.SH "TQProcess::TQProcess ( const TQString & arg0, TQObject * parent = 0, const char * name = 0 )" +Constructs a TQProcess with \fIarg0\fR as the command to be executed. The \fIparent\fR and \fIname\fR parameters are passed to the TQObject constructor. .PP The process is not started. You must call start() or launch() to start the process. .PP See also setArguments(), addArgument(), and start(). -.SH "QProcess::QProcess ( const TQStringList & args, TQObject * parent = 0, const char * name = 0 )" -Constructs a QProcess with \fIargs\fR as the arguments of the process. The first element in the list is the command to be executed. The other elements in the list are the arguments to this command. The \fIparent\fR and \fIname\fR parameters are passed to the TQObject constructor. +.SH "TQProcess::TQProcess ( const TQStringList & args, TQObject * parent = 0, const char * name = 0 )" +Constructs a TQProcess with \fIargs\fR as the arguments of the process. The first element in the list is the command to be executed. The other elements in the list are the arguments to this command. The \fIparent\fR and \fIname\fR parameters are passed to the TQObject constructor. .PP The process is not started. You must call start() or launch() to start the process. .PP See also setArguments(), addArgument(), and start(). -.SH "QProcess::~QProcess ()" +.SH "TQProcess::~TQProcess ()" Destroys the instance. .PP If the process is running, it is \fBnot\fR terminated! The standard input, standard output and standard error of the process are closed. @@ -268,7 +268,7 @@ If the process is running, it is \fBnot\fR terminated! The standard input, stand You can connect the destroyed() signal to the kill() slot, if you want the process to be terminated automatically when the instance is destroyed. .PP See also tryTerminate() and kill(). -.SH "void QProcess::addArgument ( const TQString & arg )\fC [virtual]\fR" +.SH "void TQProcess::addArgument ( const TQString & arg )\fC [virtual]\fR" Adds \fIarg\fR to the end of the list of arguments. .PP The first element in the list of arguments is the command to be executed; the following elements are the command's arguments. @@ -276,7 +276,7 @@ The first element in the list of arguments is the command to be executed; the fo See also arguments() and setArguments(). .PP Example: process/process.cpp. -.SH "TQStringList QProcess::arguments () const" +.SH "TQStringList TQProcess::arguments () const" Returns the list of arguments that are set for the process. Arguments can be specified with the constructor or with the functions setArguments() and addArgument(). .PP Note that if you want to iterate over the list, you should iterate over a copy, e.g. @@ -298,39 +298,39 @@ Note that if you want to iterate over the list, you should iterate over a copy, .fi .PP See also setArguments() and addArgument(). -.SH "bool QProcess::canReadLineStderr () const" +.SH "bool TQProcess::canReadLineStderr () const" Returns TRUE if it's possible to read an entire line of text from standard error at this time; otherwise returns FALSE. .PP See also readLineStderr() and canReadLineStdout(). -.SH "bool QProcess::canReadLineStdout () const" +.SH "bool TQProcess::canReadLineStdout () const" Returns TRUE if it's possible to read an entire line of text from standard output at this time; otherwise returns FALSE. .PP See also readLineStdout() and canReadLineStderr(). -.SH "void QProcess::clearArguments ()" +.SH "void TQProcess::clearArguments ()" Clears the list of arguments that are set for the process. .PP See also setArguments() and addArgument(). -.SH "void QProcess::closeStdin ()\fC [virtual slot]\fR" +.SH "void TQProcess::closeStdin ()\fC [virtual slot]\fR" Closes the process's standard input. .PP This function also deletes any pending data that has not been written to standard input. .PP See also wroteToStdin(). -.SH "int QProcess::communication () const" +.SH "int TQProcess::communication () const" Returns the communication required with the process, i.e. some combination of the Communication flags. .PP See also setCommunication(). -.SH "int QProcess::exitStatus () const" +.SH "int TQProcess::exitStatus () const" Returns the exit status of the process or 0 if the process is still running. This function returns immediately and does not wait until the process is finished. .PP If normalExit() is FALSE (e.g. if the program was killed or crashed), this function returns 0, so you should check the return value of normalExit() before relying on this value. .PP See also normalExit() and processExited(). -.SH "bool QProcess::isRunning () const" +.SH "bool TQProcess::isRunning () const" Returns TRUE if the process is running; otherwise returns FALSE. .PP See also normalExit(), exitStatus(), and processExited(). -.SH "void QProcess::kill () const\fC [slot]\fR" +.SH "void TQProcess::kill () const\fC [slot]\fR" Terminates the process. This is not a safe way to end a process since the process will not be able to do any cleanup. tryTerminate() is safer, but processes can ignore a tryTerminate(). .PP The nice way to end a process and to be sure that it is finished, is to do something like this: @@ -348,7 +348,7 @@ This tries to terminate the process the nice way. If the process is still runnin The slot returns immediately: it does not wait until the process has finished. When the process terminates, the processExited() signal is emitted. .PP See also tryTerminate() and processExited(). -.SH "bool QProcess::launch ( const TQByteArray & buf, TQStringList * env = 0 )\fC [virtual]\fR" +.SH "bool TQProcess::launch ( const TQByteArray & buf, TQStringList * env = 0 )\fC [virtual]\fR" Runs the process and writes the data \fIbuf\fR to the process's standard input. If all the data is written to standard input, standard input is closed. The command is searched for in the path for executable programs; you can also use an absolute path in the command itself. .PP If \fIenv\fR is null, then the process is started with the same environment as the starting process. If \fIenv\fR is non-null, then the values in the string list are interpreted as environment setttings of the form \fCkey=value\fR and the process is started with these environment settings. For convenience, there is a small exception to this rule under Unix: if \fIenv\fR does not contain any settings for the environment variable \fCLD_LIBRARY_PATH\fR, then this variable is inherited from the starting process. @@ -364,27 +364,27 @@ You can call this function even when a process that was started with this instan The object emits the signal launchFinished() when this function call is finished. If the start was successful, this signal is emitted after all the data has been written to standard input. If the start failed, then this signal is emitted immediately. .PP See also start() and launchFinished(). -.SH "bool QProcess::launch ( const TQString & buf, TQStringList * env = 0 )\fC [virtual]\fR" +.SH "bool TQProcess::launch ( const TQString & buf, TQStringList * env = 0 )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP The data \fIbuf\fR is written to standard input with writeToStdin() using the TQString::local8Bit() representation of the strings. -.SH "void QProcess::launchFinished ()\fC [signal]\fR" +.SH "void TQProcess::launchFinished ()\fC [signal]\fR" This signal is emitted when the process was started with launch(). If the start was successful, this signal is emitted after all the data has been written to standard input. If the start failed, then this signal is emitted immediately. .PP -This signal is especially useful if you want to know when you can safely delete the QProcess object when you are not interested in reading from standard output or standard error. +This signal is especially useful if you want to know when you can safely delete the TQProcess object when you are not interested in reading from standard output or standard error. .PP See also launch() and TQObject::deleteLater(). -.SH "bool QProcess::normalExit () const" +.SH "bool TQProcess::normalExit () const" Returns TRUE if the process has exited normally; otherwise returns FALSE. This implies that this function returns FALSE if the process is still running. .PP See also isRunning(), exitStatus(), and processExited(). -.SH "void QProcess::processExited ()\fC [signal]\fR" +.SH "void TQProcess::processExited ()\fC [signal]\fR" This signal is emitted when the process has exited. .PP See also isRunning(), normalExit(), exitStatus(), start(), and launch(). .PP Example: process/process.cpp. -.SH "PID QProcess::processIdentifier ()" +.SH "PID TQProcess::processIdentifier ()" Returns platform dependent information about the process. This can be used together with platform specific system calls. .PP Under Unix the return value is the PID of the process, or -1 if no process belongs to this object. @@ -392,25 +392,25 @@ Under Unix the return value is the PID of the process, or -1 if no process belon Under Windows it is a pointer to the \fCPROCESS_INFORMATION\fR struct, or 0 if no process is belongs to this object. .PP Use of this function's return value is likely to be non-portable. -.SH "TQString QProcess::readLineStderr ()\fC [virtual]\fR" +.SH "TQString TQProcess::readLineStderr ()\fC [virtual]\fR" Reads a line of text from standard error, excluding any trailing newline or carriage return characters and returns it. Returns TQString::null if canReadLineStderr() returns FALSE. .PP By default, the text is interpreted to be in Latin-1 encoding. If you need other codecs, you can set a different codec with TQTextCodec::setCodecForCStrings(). .PP See also canReadLineStderr(), readyReadStderr(), readStderr(), and readLineStdout(). -.SH "TQString QProcess::readLineStdout ()\fC [virtual]\fR" +.SH "TQString TQProcess::readLineStdout ()\fC [virtual]\fR" Reads a line of text from standard output, excluding any trailing newline or carriage return characters, and returns it. Returns TQString::null if canReadLineStdout() returns FALSE. .PP By default, the text is interpreted to be in Latin-1 encoding. If you need other codecs, you can set a different codec with TQTextCodec::setCodecForCStrings(). .PP See also canReadLineStdout(), readyReadStdout(), readStdout(), and readLineStderr(). -.SH "TQByteArray QProcess::readStderr ()\fC [virtual]\fR" +.SH "TQByteArray TQProcess::readStderr ()\fC [virtual]\fR" Reads the data that the process has written to standard error. When new data is written to standard error, the class emits the signal readyReadStderr(). .PP If there is no data to read, this function returns a TQByteArray of size 0: it does not wait until there is something to read. .PP See also readyReadStderr(), readLineStderr(), readStdout(), and writeToStdin(). -.SH "TQByteArray QProcess::readStdout ()\fC [virtual]\fR" +.SH "TQByteArray TQProcess::readStdout ()\fC [virtual]\fR" Reads the data that the process has written to standard output. When new data is written to standard output, the class emits the signal readyReadStdout(). .PP If there is no data to read, this function returns a TQByteArray of size 0: it does not wait until there is something to read. @@ -418,13 +418,13 @@ If there is no data to read, this function returns a TQByteArray of size 0: it d See also readyReadStdout(), readLineStdout(), readStderr(), and writeToStdin(). .PP Example: process/process.cpp. -.SH "void QProcess::readyReadStderr ()\fC [signal]\fR" +.SH "void TQProcess::readyReadStderr ()\fC [signal]\fR" This signal is emitted when the process has written data to standard error. You can read the data with readStderr(). .PP Note that this signal is only emitted when there is new data and not when there is old, but unread data. In the slot connected to this signal, you should always read everything that is available at that moment to make sure that you don't lose any data. .PP See also readStderr(), readLineStderr(), and readyReadStdout(). -.SH "void QProcess::readyReadStdout ()\fC [signal]\fR" +.SH "void TQProcess::readyReadStdout ()\fC [signal]\fR" This signal is emitted when the process has written data to standard output. You can read the data with readStdout(). .PP Note that this signal is only emitted when there is new data and not when there is old, but unread data. In the slot connected to this signal, you should always read everything that is available at that moment to make sure that you don't lose any data. @@ -432,15 +432,15 @@ Note that this signal is only emitted when there is new data and not when there See also readStdout(), readLineStdout(), and readyReadStderr(). .PP Example: process/process.cpp. -.SH "void QProcess::setArguments ( const TQStringList & args )\fC [virtual]\fR" +.SH "void TQProcess::setArguments ( const TQStringList & args )\fC [virtual]\fR" Sets \fIargs\fR as the arguments for the process. The first element in the list is the command to be executed. The other elements in the list are the arguments to the command. Any previous arguments are deleted. .PP -QProcess does not perform argument substitutions; for example, if you specify "*" or "$DISPLAY", these values are passed to the process literally. If you want to have the same behavior as the shell provides, you must do the substitutions yourself; i.e. instead of specifying a "*" you must specify the list of all the filenames in the current directory, and instead of "$DISPLAY" you must specify the value of the environment variable \fCDISPLAY\fR. +TQProcess does not perform argument substitutions; for example, if you specify "*" or "$DISPLAY", these values are passed to the process literally. If you want to have the same behavior as the shell provides, you must do the substitutions yourself; i.e. instead of specifying a "*" you must specify the list of all the filenames in the current directory, and instead of "$DISPLAY" you must specify the value of the environment variable \fCDISPLAY\fR. .PP Note for Windows users. The standard Windows shells, e.g. \fCcommand.com\fR and \fCcmd.exe\fR, do not perform file globbing, i.e. they do not convert a "*" on the command line into a list of files in the current directory. For this reason most Windows applications implement their own file globbing, and as a result of this, specifying an argument of "*" for a Windows application is likely to result in the application performing a file glob and ending up with a list of filenames. .PP See also arguments() and addArgument(). -.SH "void QProcess::setCommunication ( int commFlags )" +.SH "void TQProcess::setCommunication ( int commFlags )" Sets \fIcommFlags\fR as the communication required with the process. .PP \fIcommFlags\fR is a bitwise OR of the flags defined by the Communication enum. @@ -448,13 +448,13 @@ Sets \fIcommFlags\fR as the communication required with the process. The default is \fCStdin|Stdout|Stderr\fR. .PP See also communication(). -.SH "void QProcess::setWorkingDirectory ( const QDir & dir )\fC [virtual]\fR" +.SH "void TQProcess::setWorkingDirectory ( const TQDir & dir )\fC [virtual]\fR" Sets \fIdir\fR as the working directory for processes. This does not affect running processes; only processes that are started afterwards are affected. .PP Setting the working directory is especially useful for processes that try to access files with relative paths. .PP See also workingDirectory() and start(). -.SH "bool QProcess::start ( TQStringList * env = 0 )\fC [virtual]\fR" +.SH "bool TQProcess::start ( TQStringList * env = 0 )\fC [virtual]\fR" Tries to run a process for the command and arguments that were specified with setArguments(), addArgument() or that were specified in the constructor. The command is searched for in the path for executable programs; you can also use an absolute path in the command itself. .PP If \fIenv\fR is null, then the process is started with the same environment as the starting process. If \fIenv\fR is non-null, then the values in the stringlist are interpreted as environment setttings of the form \fCkey=value\fR and the process is started in these environment settings. For convenience, there is a small exception to this rule: under Unix, if \fIenv\fR does not contain any settings for the environment variable \fCLD_LIBRARY_PATH\fR, then this variable is inherited from the starting process; under Windows the same applies for the environment variable \fCPATH\fR. @@ -463,40 +463,40 @@ Returns TRUE if the process could be started; otherwise returns FALSE. .PP You can write data to the process's standard input with writeToStdin(). You can close standard input with closeStdin() and you can terminate the process with tryTerminate(), or with kill(). .PP -You can call this function even if you've used this instance to create a another process which is still running. In such cases, QProcess closes the old process's standard input and deletes pending data, i.e., you lose all control over the old process, but the old process is not terminated. This applies also if the process could not be started. (On operating systems that have zombie processes, TQt will also wait() on the old process.) +You can call this function even if you've used this instance to create a another process which is still running. In such cases, TQProcess closes the old process's standard input and deletes pending data, i.e., you lose all control over the old process, but the old process is not terminated. This applies also if the process could not be started. (On operating systems that have zombie processes, TQt will also wait() on the old process.) .PP See also launch() and closeStdin(). .PP Example: process/process.cpp. -.SH "void QProcess::tryTerminate () const\fC [slot]\fR" +.SH "void TQProcess::tryTerminate () const\fC [slot]\fR" Asks the process to terminate. Processes can ignore this if they wish. If you want to be certain that the process really terminates, you can use kill() instead. .PP The slot returns immediately: it does not wait until the process has finished. When the process terminates, the processExited() signal is emitted. .PP See also kill() and processExited(). -.SH "QDir QProcess::workingDirectory () const" +.SH "TQDir TQProcess::workingDirectory () const" Returns the working directory that was set with setWorkingDirectory(), or the current directory if none has been explicitly set. .PP -See also setWorkingDirectory() and QDir::current(). -.SH "void QProcess::writeToStdin ( const TQByteArray & buf )\fC [virtual slot]\fR" +See also setWorkingDirectory() and TQDir::current(). +.SH "void TQProcess::writeToStdin ( const TQByteArray & buf )\fC [virtual slot]\fR" Writes the data \fIbuf\fR to the process's standard input. The process may or may not read this data. .PP -This function always returns immediately. The data you pass to writeToStdin() is copied into an internal memory buffer in QProcess, and when control goes back to the event loop, QProcess will starting transferring data from this buffer to the running process. Sometimes the data will be transferred in several payloads, depending on how much data is read at a time by the process itself. When QProcess has transferred all the data from its memory buffer to the running process, it emits wroteToStdin(). +This function always returns immediately. The data you pass to writeToStdin() is copied into an internal memory buffer in TQProcess, and when control goes back to the event loop, TQProcess will starting transferring data from this buffer to the running process. Sometimes the data will be transferred in several payloads, depending on how much data is read at a time by the process itself. When TQProcess has transferred all the data from its memory buffer to the running process, it emits wroteToStdin(). .PP Note that some operating systems use a buffer to transfer the data. As a result, wroteToStdin() may be emitted before the running process has actually read all the data. .PP See also wroteToStdin(), closeStdin(), readStdout(), and readStderr(). -.SH "void QProcess::writeToStdin ( const TQString & buf )\fC [virtual slot]\fR" +.SH "void TQProcess::writeToStdin ( const TQString & buf )\fC [virtual slot]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP The string \fIbuf\fR is handled as text using the TQString::local8Bit() representation. -.SH "void QProcess::wroteToStdin ()\fC [signal]\fR" +.SH "void TQProcess::wroteToStdin ()\fC [signal]\fR" This signal is emitted if the data sent to standard input (via writeToStdin()) was actually written to the process. This does not imply that the process really read the data, since this class only detects when it was able to write the data to the operating system. But it is now safe to close standard input without losing pending data. .PP See also writeToStdin() and closeStdin(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqprocess.html +.BR http://doc.trolltech.com/tqprocess.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqprogressbar.3qt b/doc/man/man3/tqprogressbar.3qt index 2a86d119d..2d51550e0 100644 --- a/doc/man/man3/tqprogressbar.3qt +++ b/doc/man/man3/tqprogressbar.3qt @@ -98,7 +98,7 @@ A progress bar is used to give the user an indication of the progress of an oper .PP The progress bar uses the concept of \fIsteps\fR; you give it the total number of steps and the number of steps completed so far and it will display the percentage of steps that have been completed. You can specify the total number of steps in the constructor or later with setTotalSteps(). The current number of steps is set with setProgress(). The progress bar can be rewound to the beginning with reset(). .PP -If the total is given as 0 the progress bar shows a busy indicator instead of a percentage of steps. This is useful, for example, when using QFtp or QHttp to download items when they are unable to determine the size of the item being downloaded. +If the total is given as 0 the progress bar shows a busy indicator instead of a percentage of steps. This is useful, for example, when using TQFtp or TQHttp to download items when they are unable to determine the size of the item being downloaded. .PP See also QProgressDialog, GUI Design Handbook: Progress Indicator, and Advanced Widgets. .PP diff --git a/doc/man/man3/tqprogressdialog.3qt b/doc/man/man3/tqprogressdialog.3qt index f9c199e8b..6c225a88c 100644 --- a/doc/man/man3/tqprogressdialog.3qt +++ b/doc/man/man3/tqprogressdialog.3qt @@ -175,7 +175,7 @@ for ( int i = 0; i < numFiles; i++ ) { progress.setProgress( numFiles ); .fi .PP -A modeless progress dialog is suitable for operations that take place in the background, where the user is able to interact with the application. Such operations are typically based on TQTimer (or TQObject::timerEvent()), QSocketNotifier, or QUrlOperator; or performed in a separate thread. A QProgressBar in the status bar of your main window is often an alternative to a modeless progress dialog. +A modeless progress dialog is suitable for operations that take place in the background, where the user is able to interact with the application. Such operations are typically based on TQTimer (or TQObject::timerEvent()), TQSocketNotifier, or TQUrlOperator; or performed in a separate thread. A QProgressBar in the status bar of your main window is often an alternative to a modeless progress dialog. .PP You need to have an event loop to be running, connect the canceled() signal to a slot that stops the operation, and call setProgress() at intervals. For example: .PP diff --git a/doc/man/man3/tqptrdict.3qt b/doc/man/man3/tqptrdict.3qt index 4bb5617ab..ec5fb95c5 100644 --- a/doc/man/man3/tqptrdict.3qt +++ b/doc/man/man3/tqptrdict.3qt @@ -76,10 +76,10 @@ Inherits TQPtrCollection. .SS "Protected Members" .in +1c .ti -1c -.BI "virtual QDataStream & \fBread\fR ( QDataStream & s, TQPtrCollection::Item & item )" +.BI "virtual TQDataStream & \fBread\fR ( TQDataStream & s, TQPtrCollection::Item & item )" .br .ti -1c -.BI "virtual QDataStream & \fBwrite\fR ( QDataStream & s, TQPtrCollection::Item ) const" +.BI "virtual TQDataStream & \fBwrite\fR ( TQDataStream & s, TQPtrCollection::Item ) const" .br .in -1c .SH DESCRIPTION @@ -213,7 +213,7 @@ If there are two or more items with equal keys, then the most recently inserted Equivalent to the find() function. .PP See also find(). -.SH "QDataStream & TQPtrDict::read ( QDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" +.SH "TQDataStream & TQPtrDict::read ( TQDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" Reads a dictionary item from the stream \fIs\fR and returns a reference to the stream. .PP The default implementation sets \fIitem\fR to 0. @@ -284,7 +284,7 @@ Returns a pointer to the item taken out, or 0 if the key does not exist in the d All dictionary iterators that refer to the taken item will be set to point to the next item in the dictionary traversal order. .PP See also remove(), clear(), and setAutoDelete(). -.SH "QDataStream & TQPtrDict::write ( QDataStream & s, TQPtrCollection::Item ) const\fC [virtual protected]\fR" +.SH "TQDataStream & TQPtrDict::write ( TQDataStream & s, TQPtrCollection::Item ) const\fC [virtual protected]\fR" Writes a dictionary item to the stream \fIs\fR and returns a reference to the stream. .PP See also read(). diff --git a/doc/man/man3/tqptrlist.3qt b/doc/man/man3/tqptrlist.3qt index 3ab8a4c35..454bcd00a 100644 --- a/doc/man/man3/tqptrlist.3qt +++ b/doc/man/man3/tqptrlist.3qt @@ -159,10 +159,10 @@ Inherited by TQObjectList and TQStrList. .BI "virtual int \fBcompareItems\fR ( TQPtrCollection::Item item1, TQPtrCollection::Item item2 )" .br .ti -1c -.BI "virtual QDataStream & \fBread\fR ( QDataStream & s, TQPtrCollection::Item & item )" +.BI "virtual TQDataStream & \fBread\fR ( TQDataStream & s, TQPtrCollection::Item & item )" .br .ti -1c -.BI "virtual QDataStream & \fBwrite\fR ( QDataStream & s, TQPtrCollection::Item item ) const" +.BI "virtual TQDataStream & \fBwrite\fR ( TQDataStream & s, TQPtrCollection::Item item ) const" .br .in -1c .SH DESCRIPTION @@ -511,7 +511,7 @@ Returns a pointer to the item preceding the current item. Returns 0 if the curre Makes the preceding item current. If the current item before this function call was the first item, the current item will be set to 0. If the current item was 0, this function does nothing. .PP See also first(), last(), next(), and current(). -.SH "QDataStream & TQPtrList::read ( QDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" +.SH "TQDataStream & TQPtrList::read ( TQDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" Reads a list item from the stream \fIs\fR and returns a reference to the stream. .PP The default implementation sets \fIitem\fR to 0. @@ -683,7 +683,7 @@ See also removeNode() and currentNode(). Stores all list items in the vector \fIvec\fR. .PP The vector must be of the same item type, otherwise the result will be undefined. -.SH "QDataStream & TQPtrList::write ( QDataStream & s, TQPtrCollection::Item item ) const\fC [virtual protected]\fR" +.SH "TQDataStream & TQPtrList::write ( TQDataStream & s, TQPtrCollection::Item item ) const\fC [virtual protected]\fR" Writes a list item, \fIitem\fR to the stream \fIs\fR and returns a reference to the stream. .PP The default implementation does nothing. diff --git a/doc/man/man3/tqptrqueue.3qt b/doc/man/man3/tqptrqueue.3qt index 9eb1bd189..3a772c55f 100644 --- a/doc/man/man3/tqptrqueue.3qt +++ b/doc/man/man3/tqptrqueue.3qt @@ -62,10 +62,10 @@ TQPtrQueue \- Template class that provides a queue .SS "Protected Members" .in +1c .ti -1c -.BI "virtual QDataStream & \fBread\fR ( QDataStream & s, TQPtrCollection::Item & item )" +.BI "virtual TQDataStream & \fBread\fR ( TQDataStream & s, TQPtrCollection::Item & item )" .br .ti -1c -.BI "virtual QDataStream & \fBwrite\fR ( QDataStream & s, TQPtrCollection::Item item ) const" +.BI "virtual TQDataStream & \fBwrite\fR ( TQDataStream & s, TQPtrCollection::Item item ) const" .br .in -1c .SH DESCRIPTION @@ -133,7 +133,7 @@ Assigns \fIqueue\fR to this queue and returns a reference to this queue. This queue is first cleared and then each item in \fIqueue\fR is enqueued to this queue. Only the pointers are copied. .PP \fBWarning:\fR The autoDelete() flag is not modified. If it it TRUE for both \fIqueue\fR and this queue, deleting the two lists will cause \fIdouble-deletion\fR of the items. -.SH "QDataStream & TQPtrQueue::read ( QDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" +.SH "TQDataStream & TQPtrQueue::read ( TQDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" Reads a queue item, \fIitem\fR, from the stream \fIs\fR and returns a reference to the stream. .PP The default implementation sets \fIitem\fR to 0. @@ -153,7 +153,7 @@ If auto-deleting is turned on, all the items in a queue are deleted when the que The default setting is FALSE, for safety. If you turn it on, be careful about copying the queue: you might find yourself with two queues deleting the same items. .PP See also autoDelete(). -.SH "QDataStream & TQPtrQueue::write ( QDataStream & s, TQPtrCollection::Item item ) const\fC [virtual protected]\fR" +.SH "TQDataStream & TQPtrQueue::write ( TQDataStream & s, TQPtrCollection::Item item ) const\fC [virtual protected]\fR" Writes a queue item, \fIitem\fR, to the stream \fIs\fR and returns a reference to the stream. .PP The default implementation does nothing. diff --git a/doc/man/man3/tqptrstack.3qt b/doc/man/man3/tqptrstack.3qt index 53c9769f5..42633a329 100644 --- a/doc/man/man3/tqptrstack.3qt +++ b/doc/man/man3/tqptrstack.3qt @@ -62,10 +62,10 @@ TQPtrStack \- Template class that provides a stack .SS "Protected Members" .in +1c .ti -1c -.BI "virtual QDataStream & \fBread\fR ( QDataStream & s, TQPtrCollection::Item & item )" +.BI "virtual TQDataStream & \fBread\fR ( TQDataStream & s, TQPtrCollection::Item & item )" .br .ti -1c -.BI "virtual QDataStream & \fBwrite\fR ( QDataStream & s, TQPtrCollection::Item item ) const" +.BI "virtual TQDataStream & \fBwrite\fR ( TQDataStream & s, TQPtrCollection::Item item ) const" .br .in -1c .SH DESCRIPTION @@ -113,7 +113,7 @@ Sets the contents of this stack by making a shallow copy of another stack \fIs\f Removes the top item from the stack and returns it. The stack must not be empty. .SH "void TQPtrStack::push ( const type * d )" Adds an element \fId\fR to the top of the stack. Last in, first out. -.SH "QDataStream & TQPtrStack::read ( QDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" +.SH "TQDataStream & TQPtrStack::read ( TQDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" Reads a stack item, \fIitem\fR, from the stream \fIs\fR and returns a reference to the stream. .PP The default implementation sets \fIitem\fR to 0. @@ -131,7 +131,7 @@ If \fIenable\fR is TRUE the stack auto-deletes its contents; if \fIenable\fR is See also autoDelete(). .SH "type * TQPtrStack::top () const" Returns a pointer to the top item on the stack (most recently pushed). The stack is not changed. Returns 0 if the stack is empty. -.SH "QDataStream & TQPtrStack::write ( QDataStream & s, TQPtrCollection::Item item ) const\fC [virtual protected]\fR" +.SH "TQDataStream & TQPtrStack::write ( TQDataStream & s, TQPtrCollection::Item item ) const\fC [virtual protected]\fR" Writes a stack item, \fIitem\fR, to the stream \fIs\fR and returns a reference to the stream. .PP The default implementation does nothing. diff --git a/doc/man/man3/tqptrvector.3qt b/doc/man/man3/tqptrvector.3qt index dde23fe24..5d675735f 100644 --- a/doc/man/man3/tqptrvector.3qt +++ b/doc/man/man3/tqptrvector.3qt @@ -106,10 +106,10 @@ Inherits TQPtrCollection. .BI "virtual int \fBcompareItems\fR ( TQPtrCollection::Item d1, TQPtrCollection::Item d2 )" .br .ti -1c -.BI "virtual QDataStream & \fBread\fR ( QDataStream & s, TQPtrCollection::Item & item )" +.BI "virtual TQDataStream & \fBread\fR ( TQDataStream & s, TQPtrCollection::Item & item )" .br .ti -1c -.BI "virtual QDataStream & \fBwrite\fR ( QDataStream & s, TQPtrCollection::Item item ) const" +.BI "virtual TQDataStream & \fBwrite\fR ( TQDataStream & s, TQPtrCollection::Item item ) const" .br .in -1c .SH DESCRIPTION @@ -267,7 +267,7 @@ Returns the item at position \fIi\fR, or 0 if there is no item at that position. Equivalent to at( \fIi\fR ). .PP See also at(). -.SH "QDataStream & TQPtrVector::read ( QDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" +.SH "TQDataStream & TQPtrVector::read ( TQDataStream & s, TQPtrCollection::Item & item )\fC [virtual protected]\fR" Reads a vector item, \fIitem\fR, from the stream \fIs\fR and returns a reference to the stream. .PP The default implementation sets \fIitem\fR to 0. @@ -318,7 +318,7 @@ Returns the item at position \fIi\fR in the vector, and removes that item from t Unlike remove(), this function does \fInot\fR call deleteItem() for the removed item. .PP See also remove() and at(). -.SH "QDataStream & TQPtrVector::write ( QDataStream & s, TQPtrCollection::Item item ) const\fC [virtual protected]\fR" +.SH "TQDataStream & TQPtrVector::write ( TQDataStream & s, TQPtrCollection::Item item ) const\fC [virtual protected]\fR" Writes a vector item, \fIitem\fR, to the stream \fIs\fR and returns a reference to the stream. .PP The default implementation does nothing. diff --git a/doc/man/man3/tqpushbutton.3qt b/doc/man/man3/tqpushbutton.3qt index 9afed57c1..20ffb02a3 100644 --- a/doc/man/man3/tqpushbutton.3qt +++ b/doc/man/man3/tqpushbutton.3qt @@ -202,7 +202,7 @@ Auto-repeat or not. .TP Pressed down or not. .PP -As a general rule, use a push button when the application or dialog window performs an action when the user clicks on it (such as Apply, Cancel, Close and Help) \fIand\fR when the widget is supposed to have a wide, rectangular shape with a text label. Small, typically square buttons that change the state of the window rather than performing an action (such as the buttons in the top-right corner of the QFileDialog) are not command buttons, but tool buttons. TQt provides a special class (TQToolButton) for these buttons. +As a general rule, use a push button when the application or dialog window performs an action when the user clicks on it (such as Apply, Cancel, Close and Help) \fIand\fR when the widget is supposed to have a wide, rectangular shape with a text label. Small, typically square buttons that change the state of the window rather than performing an action (such as the buttons in the top-right corner of the TQFileDialog) are not command buttons, but tool buttons. TQt provides a special class (TQToolButton) for these buttons. .PP If you need toggle behavior (see setToggleButton()) or a button that auto-repeats the activation signal when being pushed down like the arrows in a scroll bar (see setAutoRepeat()), a command button is probably not what you want. When in doubt, use a tool button. .PP @@ -319,7 +319,7 @@ Ownership of the popup menu is \fInot\fR transferred to the push button. See also popup(). .PP Examples: -.)l buttongroups/buttongroups.cpp and qdir/qdir.cpp. +.)l buttongroups/buttongroups.cpp and tqdir/tqdir.cpp. .SH "void QButton::setText ( const TQString & )\fC [virtual]\fR" Sets the text shown on the button. See the "text" property for details. .SH "void QPushButton::setToggleButton ( bool )" diff --git a/doc/man/man3/tqrect.3qt b/doc/man/man3/tqrect.3qt index 68141b0ee..0701ed63b 100644 --- a/doc/man/man3/tqrect.3qt +++ b/doc/man/man3/tqrect.3qt @@ -218,10 +218,10 @@ QRect \- Defines a rectangle in the plane .BI "bool \fBoperator!=\fR ( const QRect & r1, const QRect & r2 )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QRect & r )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QRect & r )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QRect & r )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QRect & r )" .br .in -1c .SH DESCRIPTION @@ -625,16 +625,16 @@ Examples: .SH RELATED FUNCTION DOCUMENTATION .SH "bool operator!= ( const QRect & r1, const QRect & r2 )" Returns TRUE if \fIr1\fR and \fIr2\fR are different; otherwise returns FALSE. -.SH "QDataStream & operator<< ( QDataStream & s, const QRect & r )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QRect & r )" Writes the QRect, \fIr\fR, to the stream \fIs\fR, and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "bool operator== ( const QRect & r1, const QRect & r2 )" Returns TRUE if \fIr1\fR and \fIr2\fR are equal; otherwise returns FALSE. -.SH "QDataStream & operator>> ( QDataStream & s, QRect & r )" +.SH "TQDataStream & operator>> ( TQDataStream & s, QRect & r )" Reads a QRect from the stream \fIs\fR into rect \fIr\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqrect.html diff --git a/doc/man/man3/tqregion.3qt b/doc/man/man3/tqregion.3qt index 9f76f7ae7..bcb963eb3 100644 --- a/doc/man/man3/tqregion.3qt +++ b/doc/man/man3/tqregion.3qt @@ -116,10 +116,10 @@ QRegion \- Clip region for a painter .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QRegion & r )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QRegion & r )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QRegion & r )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QRegion & r )" .br .in -1c .SH DESCRIPTION @@ -353,14 +353,14 @@ Returns a region which is the union of this region and \fIr\fR. .PP The figure shows the union of two elliptical regions. .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QRegion & r )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QRegion & r )" Writes the region \fIr\fR to the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, QRegion & r )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, QRegion & r )" Reads a region from the stream \fIs\fR into \fIr\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqregion.html diff --git a/doc/man/man3/tqscrollview.3qt b/doc/man/man3/tqscrollview.3qt index ac9ed9d6e..10cb3f599 100644 --- a/doc/man/man3/tqscrollview.3qt +++ b/doc/man/man3/tqscrollview.3qt @@ -633,7 +633,7 @@ For example: .PP The clip rectangle and translation of the painter \fIp\fR is already set appropriately. .PP -Example: qdir/qdir.cpp. +Example: tqdir/tqdir.cpp. .PP Reimplemented in TQCanvasView and QTable. .SH "void QScrollView::drawContentsOffset ( QPainter * p, int offsetx, int offsety, int clipx, int clipy, int clipw, int cliph )\fC [virtual protected]\fR" diff --git a/doc/man/man3/tqserversocket.3qt b/doc/man/man3/tqserversocket.3qt index 8a111b563..24c3d907f 100644 --- a/doc/man/man3/tqserversocket.3qt +++ b/doc/man/man3/tqserversocket.3qt @@ -1,5 +1,5 @@ '\" t -.TH QServerSocket 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQServerSocket 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,25 +7,25 @@ .ad l .nh .SH NAME -QServerSocket \- TCP-based server +TQServerSocket \- TCP-based server .SH SYNOPSIS -\fC#include <ntqserversocket.h>\fR +\fC#include <tqserversocket.h>\fR .PP Inherits TQObject. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQServerSocket\fR ( TQ_UINT16 port, int backlog = 1, TQObject * parent = 0, const char * name = 0 )" +.BI "\fBTQServerSocket\fR ( TQ_UINT16 port, int backlog = 1, TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fBQServerSocket\fR ( const QHostAddress & address, TQ_UINT16 port, int backlog = 1, TQObject * parent = 0, const char * name = 0 )" +.BI "\fBTQServerSocket\fR ( const TQHostAddress & address, TQ_UINT16 port, int backlog = 1, TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fBQServerSocket\fR ( TQObject * parent = 0, const char * name = 0 )" +.BI "\fBTQServerSocket\fR ( TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "virtual \fB~QServerSocket\fR ()" +.BI "virtual \fB~TQServerSocket\fR ()" .br .ti -1c .BI "bool \fBok\fR () const" @@ -40,7 +40,7 @@ Inherits TQObject. .BI "virtual void \fBsetSocket\fR ( int socket )" .br .ti -1c -.BI "QHostAddress \fBaddress\fR () const" +.BI "TQHostAddress \fBaddress\fR () const" .br .ti -1c .BI "virtual void \fBnewConnection\fR ( int socket ) = 0" @@ -49,67 +49,67 @@ Inherits TQObject. .SS "Protected Members" .in +1c .ti -1c -.BI "QSocketDevice * \fBsocketDevice\fR ()" +.BI "TQSocketDevice * \fBsocketDevice\fR ()" .br .in -1c .SH DESCRIPTION -The QServerSocket class provides a TCP-based server. +The TQServerSocket class provides a TCP-based server. .PP -This class is a convenience class for accepting incoming TCP connections. You can specify the port or have QServerSocket pick one, and listen on just one address or on all the machine's addresses. +This class is a convenience class for accepting incoming TCP connections. You can specify the port or have TQServerSocket pick one, and listen on just one address or on all the machine's addresses. .PP -Using the API is very simple: subclass QServerSocket, call the constructor of your choice, and implement newConnection() to handle new incoming connections. There is nothing more to do. +Using the API is very simple: subclass TQServerSocket, call the constructor of your choice, and implement newConnection() to handle new incoming connections. There is nothing more to do. .PP -(Note that due to lack of support in the underlying APIs, QServerSocket cannot accept or reject connections conditionally.) +(Note that due to lack of support in the underlying APIs, TQServerSocket cannot accept or reject connections conditionally.) .PP -See also QSocket, QSocketDevice, QHostAddress, QSocketNotifier, and Input/Output and Networking. +See also TQSocket, TQSocketDevice, TQHostAddress, TQSocketNotifier, and Input/Output and Networking. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QServerSocket::QServerSocket ( TQ_UINT16 port, int backlog = 1, TQObject * parent = 0, const char * name = 0 )" -Creates a server socket object, that will serve the given \fIport\fR on all the addresses of this host. If \fIport\fR is 0, QServerSocket will pick a suitable port in a system-dependent manner. Use \fIbacklog\fR to specify how many pending connections the server can have. +.SH "TQServerSocket::TQServerSocket ( TQ_UINT16 port, int backlog = 1, TQObject * parent = 0, const char * name = 0 )" +Creates a server socket object, that will serve the given \fIport\fR on all the addresses of this host. If \fIport\fR is 0, TQServerSocket will pick a suitable port in a system-dependent manner. Use \fIbacklog\fR to specify how many pending connections the server can have. .PP The \fIparent\fR and \fIname\fR arguments are passed on to the TQObject constructor. .PP \fBWarning:\fR On Tru64 Unix systems a value of 0 for \fIbacklog\fR means that you don't accept any connections at all; you should specify a value larger than 0. -.SH "QServerSocket::QServerSocket ( const QHostAddress & address, TQ_UINT16 port, int backlog = 1, TQObject * parent = 0, const char * name = 0 )" +.SH "TQServerSocket::TQServerSocket ( const TQHostAddress & address, TQ_UINT16 port, int backlog = 1, TQObject * parent = 0, const char * name = 0 )" Creates a server socket object, that will serve the given \fIport\fR only on the given \fIaddress\fR. Use \fIbacklog\fR to specify how many pending connections the server can have. .PP The \fIparent\fR and \fIname\fR arguments are passed on to the TQObject constructor. .PP \fBWarning:\fR On Tru64 Unix systems a value of 0 for \fIbacklog\fR means that you don't accept any connections at all; you should specify a value larger than 0. -.SH "QServerSocket::QServerSocket ( TQObject * parent = 0, const char * name = 0 )" +.SH "TQServerSocket::TQServerSocket ( TQObject * parent = 0, const char * name = 0 )" Construct an empty server socket. .PP -This constructor, in combination with setSocket(), allows us to use the QServerSocket class as a wrapper for other socket types (e.g. Unix Domain Sockets under Unix). +This constructor, in combination with setSocket(), allows us to use the TQServerSocket class as a wrapper for other socket types (e.g. Unix Domain Sockets under Unix). .PP The \fIparent\fR and \fIname\fR arguments are passed on to the TQObject constructor. .PP See also setSocket(). -.SH "QServerSocket::~QServerSocket ()\fC [virtual]\fR" +.SH "TQServerSocket::~TQServerSocket ()\fC [virtual]\fR" Destroys the socket. .PP -This causes any backlogged connections (connections that have reached the host, but not yet been completely set up by calling QSocketDevice::accept()) to be severed. +This causes any backlogged connections (connections that have reached the host, but not yet been completely set up by calling TQSocketDevice::accept()) to be severed. .PP Existing connections continue to exist; this only affects the acceptance of new connections. -.SH "QHostAddress QServerSocket::address () const" +.SH "TQHostAddress TQServerSocket::address () const" Returns the address on which this object listens, or 0.0.0.0 if this object listens on more than one address. ok() must be TRUE before calling this function. .PP -See also port() and QSocketDevice::address(). -.SH "void QServerSocket::newConnection ( int socket )\fC [pure virtual]\fR" +See also port() and TQSocketDevice::address(). +.SH "void TQServerSocket::newConnection ( int socket )\fC [pure virtual]\fR" This pure virtual function is responsible for setting up a new incoming connection. \fIsocket\fR is the fd (file descriptor) for the newly accepted connection. -.SH "bool QServerSocket::ok () const" +.SH "bool TQServerSocket::ok () const" Returns TRUE if the construction succeeded; otherwise returns FALSE. -.SH "TQ_UINT16 QServerSocket::port () const" -Returns the port number on which this server socket listens. This is always non-zero; if you specify 0 in the constructor, QServerSocket will pick a non-zero port itself. ok() must be TRUE before calling this function. +.SH "TQ_UINT16 TQServerSocket::port () const" +Returns the port number on which this server socket listens. This is always non-zero; if you specify 0 in the constructor, TQServerSocket will pick a non-zero port itself. ok() must be TRUE before calling this function. .PP -See also address() and QSocketDevice::port(). +See also address() and TQSocketDevice::port(). .PP Example: network/httpd/httpd.cpp. -.SH "void QServerSocket::setSocket ( int socket )\fC [virtual]\fR" +.SH "void TQServerSocket::setSocket ( int socket )\fC [virtual]\fR" Sets the socket to use \fIsocket\fR. bind() and listen() should already have been called for \fIsocket\fR. .PP -This allows us to use the QServerSocket class as a wrapper for other socket types (e.g. Unix Domain Sockets). -.SH "int QServerSocket::socket () const" +This allows us to use the TQServerSocket class as a wrapper for other socket types (e.g. Unix Domain Sockets). +.SH "int TQServerSocket::socket () const" Returns the operating system socket. -.SH "QSocketDevice * QServerSocket::socketDevice ()\fC [protected]\fR" +.SH "TQSocketDevice * TQServerSocket::socketDevice ()\fC [protected]\fR" Returns a pointer to the internal socket device. The returned pointer is 0 if there is no connection or pending connection. .PP There is normally no need to manipulate the socket device directly @@ -117,7 +117,7 @@ since this class does all the necessary setup for most client or server socket applications. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqserversocket.html +.BR http://doc.trolltech.com/tqserversocket.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsessionmanager.3qt b/doc/man/man3/tqsessionmanager.3qt index 4ae80cd58..ce3995dc9 100644 --- a/doc/man/man3/tqsessionmanager.3qt +++ b/doc/man/man3/tqsessionmanager.3qt @@ -73,7 +73,7 @@ Inherits TQObject. .SH DESCRIPTION The TQSessionManager class provides access to the session manager. .PP -The session manager is responsible for session management, most importantly for interruption and resumption. A "session" is a kind of record of the state of the system, e.g. which applications were run at start up and which applications are currently running. The session manager is used to save the session, e.g. when the machine is shut down; and to restore a session, e.g. when the machine is started up. Use QSettings to save and restore an individual application's settings, e.g. window positions, recently used files, etc. +The session manager is responsible for session management, most importantly for interruption and resumption. A "session" is a kind of record of the state of the system, e.g. which applications were run at start up and which applications are currently running. The session manager is used to save the session, e.g. when the machine is shut down; and to restore a session, e.g. when the machine is started up. Use TQSettings to save and restore an individual application's settings, e.g. window positions, recently used files, etc. .PP TQSessionManager provides an interface between the application and the session manager so that the program can work well with the session manager. In Qt, session management requests for action are handled by the two virtual functions QApplication::commitData() and QApplication::saveState(). Both provide a reference to a session manager object as argument, to allow the application to communicate with the session manager. .PP @@ -276,7 +276,7 @@ If the session manager is capable of restoring sessions it will execute \fIcomma .PP The \fC-session\fR option is mandatory; otherwise QApplication cannot tell whether it has been restored or what the current session identifier is. See QApplication::isSessionRestored() and QApplication::sessionId() for details. .PP -If your application is very simple, it may be possible to store the entire application state in additional command line options. This is usually a very bad idea because command lines are often limited to a few hundred bytes. Instead, use QSettings, or temporary files or a database for this purpose. By marking the data with the unique sessionId(), you will be able to restore the application in a future session. +If your application is very simple, it may be possible to store the entire application state in additional command line options. This is usually a very bad idea because command lines are often limited to a few hundred bytes. Instead, use TQSettings, or temporary files or a database for this purpose. By marking the data with the unique sessionId(), you will be able to restore the application in a future session. .PP See also restartCommand(), setDiscardCommand(), and setRestartHint(). .SH "void TQSessionManager::setRestartHint ( RestartHint hint )" diff --git a/doc/man/man3/tqsettings.3qt b/doc/man/man3/tqsettings.3qt index e28aa332d..da46c8e22 100644 --- a/doc/man/man3/tqsettings.3qt +++ b/doc/man/man3/tqsettings.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSettings 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSettings 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSettings \- Persistent platform-independent application settings +TQSettings \- Persistent platform-independent application settings .SH SYNOPSIS -\fC#include <ntqsettings.h>\fR +\fC#include <tqsettings.h>\fR .PP .SS "Public Members" .in +1c @@ -23,13 +23,13 @@ QSettings \- Persistent platform-independent application settings .BI "enum \fBScope\fR { User, Global }" .br .ti -1c -.BI "\fBQSettings\fR ()" +.BI "\fBTQSettings\fR ()" .br .ti -1c -.BI "\fBQSettings\fR ( Format format )" +.BI "\fBTQSettings\fR ( Format format )" .br .ti -1c -.BI "\fB~QSettings\fR ()" +.BI "\fB~TQSettings\fR ()" .br .ti -1c .BI "bool \fBwriteEntry\fR ( const TQString & key, bool value )" @@ -99,13 +99,13 @@ QSettings \- Persistent platform-independent application settings .br .in -1c .SH DESCRIPTION -The QSettings class provides persistent platform-independent application settings. +The TQSettings class provides persistent platform-independent application settings. .PP -On Unix systems, QSettings uses text files to store settings. On Windows systems, QSettings uses the system registry. On Mac OS X, QSettings uses the Carbon preferences API. +On Unix systems, TQSettings uses text files to store settings. On Windows systems, TQSettings uses the system registry. On Mac OS X, TQSettings uses the Carbon preferences API. .PP Each setting comprises an identifying key and the data associated with the key. A key is a unicode string which consists of \fItwo\fR or more subkeys. A subkey is a slash, '/', followed by one or more unicode characters (excluding slashes, newlines, carriage returns and equals, '=', signs). The associated data, called the entry or value, may be a boolean, an integer, a double, a string or a list of strings. Entry strings may contain any unicode characters. .PP -If you want to save and restore the entire desktop's settings, i.e. which applications are running, use QSettings to save the settings for each individual application and TQSessionManager to save the desktop's session. +If you want to save and restore the entire desktop's settings, i.e. which applications are running, use TQSettings to save the settings for each individual application and TQSessionManager to save the desktop's session. .PP Example settings: .PP @@ -136,7 +136,7 @@ A typical usage pattern for reading settings at application startup: .PP .nf .br - QSettings settings; + TQSettings settings; .br settings.setPath( "MyCompany.com", "MyApplication" ); .br @@ -153,7 +153,7 @@ A typical usage pattern for saving settings at application exit or 'save prefere .PP .nf .br - QSettings settings; + TQSettings settings; .br settings.setPath( "MyCompany.com", "MyApplication" ); .br @@ -170,7 +170,7 @@ A key prefix can be prepended to all keys using beginGroup(). The application of .PP .nf .br - QSettings settings; + TQSettings settings; .br .br settings.beginGroup( "/MainWindow" ); @@ -228,11 +228,11 @@ All the values of a key (for example, all the 'recent files' subkeys values), ma .PP These limitations are not enforced on Unix or Mac OS X. .PP -\fBWarning:\fR Creating multiple, simultaneous instances of QSettings writing to a text file may lead to data loss! This is a known issue which will be fixed in a future release of Qt. +\fBWarning:\fR Creating multiple, simultaneous instances of TQSettings writing to a text file may lead to data loss! This is a known issue which will be fixed in a future release of Qt. .SH "Notes for Mac OS X Applications" The location where settings are stored is not formally defined by the CFPreferences API. .PP -At the time of writing settings are stored (either on a global or user basis, preferring locally) into a plist file in \fC$ROOT/System/Library/Preferences\fR (in XML format). QSettings will create an appropriate plist file (\fCcom.<first group name>.plist\fR) out of the full path to a key. +At the time of writing settings are stored (either on a global or user basis, preferring locally) into a plist file in \fC$ROOT/System/Library/Preferences\fR (in XML format). TQSettings will create an appropriate plist file (\fCcom.<first group name>.plist\fR) out of the full path to a key. .PP For further information on CFPreferences see Apple's Specifications .SH "Notes for Unix Applications" @@ -244,13 +244,13 @@ There is no universally accepted place for storing application settings under Un .TP \fC/opt/MyCompany/share/MyApplication/etc\fR .TP -\fC$HOME/.qt\fR When reading settings the files are searched in the order shown above, with later settings overriding earlier settings. Files for which the user doesn't have read permission are ignored. When saving settings QSettings works in the order shown above, writing to the first settings file for which the user has write permission. (\fCINSTALL\fR is the directory where TQt was installed. This can be modified by using the configure script's -prefix argument ) +\fC$HOME/.qt\fR When reading settings the files are searched in the order shown above, with later settings overriding earlier settings. Files for which the user doesn't have read permission are ignored. When saving settings TQSettings works in the order shown above, writing to the first settings file for which the user has write permission. (\fCINSTALL\fR is the directory where TQt was installed. This can be modified by using the configure script's -prefix argument ) .PP If you want to put the settings in a particular place in the filesystem you could do this: .PP .nf .br - settings.insertSearchPath( QSettings::Unix, "/opt/MyCompany/share" ); + settings.insertSearchPath( TQSettings::Unix, "/opt/MyCompany/share" ); .br .fi .PP @@ -265,44 +265,44 @@ will end up writing the "geometry/width" setting to the file \fC$HOME/.qt/myappl .PP For cross-platform applications you should ensure that the Windows size limitations are not exceeded. .PP -\fBWarning:\fR QSettings doesn't write the settings until it is destroyed so you should construct the QSettings object on the stack. +\fBWarning:\fR TQSettings doesn't write the settings until it is destroyed so you should construct the TQSettings object on the stack. .PP See also Input/Output and Networking and Miscellaneous Classes. .SS "Member Type Documentation" -.SH "QSettings::Format" +.SH "TQSettings::Format" .TP -\fCQSettings::Native\fR - Store the settings in a platform dependent location +\fCTQSettings::Native\fR - Store the settings in a platform dependent location .TP -\fCQSettings::Ini\fR - Store the settings in a text file -.SH "QSettings::Scope" +\fCTQSettings::Ini\fR - Store the settings in a text file +.SH "TQSettings::Scope" .TP -\fCQSettings::Global\fR - Save settings as global as possible +\fCTQSettings::Global\fR - Save settings as global as possible .TP -\fCQSettings::User\fR - Save settings in user space -.SH "QSettings::System" +\fCTQSettings::User\fR - Save settings in user space +.SH "TQSettings::System" .TP -\fCQSettings::Mac\fR - Macintosh execution environments +\fCTQSettings::Mac\fR - Macintosh execution environments .TP -\fCQSettings::Unix\fR - Mac OS X, Unix, Linux and Unix-like execution environments +\fCTQSettings::Unix\fR - Mac OS X, Unix, Linux and Unix-like execution environments .TP -\fCQSettings::Windows\fR - Windows execution environments +\fCTQSettings::Windows\fR - Windows execution environments .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSettings::QSettings ()" +.SH "TQSettings::TQSettings ()" Creates a settings object. .PP -Be aware that you must call setPath() or insertSearchPath() before you can use the QSettings object. -.SH "QSettings::QSettings ( Format format )" +Be aware that you must call setPath() or insertSearchPath() before you can use the TQSettings object. +.SH "TQSettings::TQSettings ( Format format )" Creates a settings object. If \fIformat\fR is 'Ini' the settings will be stored in a text file, using the Unix strategy (see above). If \fIformat\fR is 'Native', the settings will be stored in a platform specific way (ie. the Windows registry). .PP -Be aware that you must call setPath() or insertSearchPath() before you can use the QSettings object. -.SH "QSettings::~QSettings ()" +Be aware that you must call setPath() or insertSearchPath() before you can use the TQSettings object. +.SH "TQSettings::~TQSettings ()" Destroys the settings object. All modifications made to the settings will automatically be saved. -.SH "void QSettings::beginGroup ( const TQString & group )" +.SH "void TQSettings::beginGroup ( const TQString & group )" Appends \fIgroup\fR to the current key prefix. .PP .nf .br - QSettings settings; + TQSettings settings; .br settings.beginGroup( "/MainWindow" ); .br @@ -311,12 +311,12 @@ Appends \fIgroup\fR to the current key prefix. settings.endGroup(); .br .fi -.SH "void QSettings::endGroup ()" +.SH "void TQSettings::endGroup ()" Undo previous calls to beginGroup(). Note that a single beginGroup("a/b/c") is undone by a single call to endGroup(). .PP .nf .br - QSettings settings; + TQSettings settings; .br settings.beginGroup( "/MainWindow/Geometry" ); .br @@ -325,7 +325,7 @@ Undo previous calls to beginGroup(). Note that a single beginGroup("a/b/c") is u settings.endGroup(); .br .fi -.SH "TQStringList QSettings::entryList ( const TQString & key ) const" +.SH "TQStringList TQSettings::entryList ( const TQString & key ) const" Returns a list of the keys which contain entries under \fIkey\fR. Does \fInot\fR return any keys that contain subkeys. .PP Example settings: @@ -357,11 +357,11 @@ In the above example, \fCkeys\fR will contain 'background color' and 'foreground To access the geometry values, you could either use subkeyList() to read the keys then read each entry, or simply read each entry directly by specifying its full key, e.g." /MyCompany/MyApplication/geometry/y". .PP See also subkeyList(). -.SH "TQString QSettings::group () const" +.SH "TQString TQSettings::group () const" Returns the current key prefix, or a null string if there is no key prefix set. .PP See also beginGroup(). -.SH "void QSettings::insertSearchPath ( System s, const TQString & path )" +.SH "void TQSettings::insertSearchPath ( System s, const TQString & path )" Inserts \fIpath\fR into the settings search path. The semantics of \fIpath\fR depends on the system \fIs\fR. It is usually easier and better to use setPath() instead of this function. .PP When \fIs\fR is \fIWindows\fR and the execution environment is \fInot\fR Windows the function does nothing. Similarly when \fIs\fR is \fIUnix\fR and the execution environment is \fInot\fR Unix the function does nothing. @@ -380,9 +380,9 @@ HKEY_LOCAL_MACHINE/Software/MyApplication .PP .nf .br - QSettings settings; + TQSettings settings; .br - settings.insertSearchPath( QSettings::Windows, "/MyCompany" ); + settings.insertSearchPath( TQSettings::Windows, "/MyCompany" ); .br settings.writeEntry( "/MyApplication/Tip of the day", TRUE ); .br @@ -409,11 +409,11 @@ All insertions into the search path will go before $HOME/.qt/. For example: .PP .nf .br - QSettings settings; + TQSettings settings; .br - settings.insertSearchPath( QSettings::Unix, "/opt/MyCompany/share/etc" ); + settings.insertSearchPath( TQSettings::Unix, "/opt/MyCompany/share/etc" ); .br - settings.insertSearchPath( QSettings::Unix, "/opt/MyCompany/share/MyApplication/etc" ); + settings.insertSearchPath( TQSettings::Unix, "/opt/MyCompany/share/MyApplication/etc" ); .br // ... .br @@ -426,7 +426,7 @@ SYSCONF .TP /opt/MyCompany/share/MyApplication/etc .TP -$HOME/.qt When reading settings the files are searched in the order shown above, with later settings overriding earlier settings. Files for which the user doesn't have read permission are ignored. When saving settings QSettings works in the order shown above, writing to the first settings file for which the user has write permission. +$HOME/.qt When reading settings the files are searched in the order shown above, with later settings overriding earlier settings. Files for which the user doesn't have read permission are ignored. When saving settings TQSettings works in the order shown above, writing to the first settings file for which the user has write permission. .PP Note that paths in the file system are not created by this function, so they must already exist to be useful. .PP @@ -435,19 +435,19 @@ Settings under Unix are stored in files whose names are based on the first subke See also removeSearchPath(). .PP Example: chart/chartform.cpp. -.SH "bool QSettings::readBoolEntry ( const TQString & key, bool def = FALSE, bool * ok = 0 ) const" +.SH "bool TQSettings::readBoolEntry ( const TQString & key, bool def = FALSE, bool * ok = 0 ) const" Reads the entry specified by \fIkey\fR, and returns a bool, or the default value, \fIdef\fR, if the entry couldn't be read. If \fIok\fR is non-null, *ok is set to TRUE if the key was read, FALSE otherwise. .PP See also readEntry(), readNumEntry(), readDoubleEntry(), writeEntry(), and removeEntry(). -.SH "double QSettings::readDoubleEntry ( const TQString & key, double def = 0, bool * ok = 0 ) const" +.SH "double TQSettings::readDoubleEntry ( const TQString & key, double def = 0, bool * ok = 0 ) const" Reads the entry specified by \fIkey\fR, and returns a double, or the default value, \fIdef\fR, if the entry couldn't be read. If \fIok\fR is non-null, *ok is set to TRUE if the key was read, FALSE otherwise. .PP See also readEntry(), readNumEntry(), readBoolEntry(), writeEntry(), and removeEntry(). -.SH "TQString QSettings::readEntry ( const TQString & key, const TQString & def = TQString::null, bool * ok = 0 ) const" +.SH "TQString TQSettings::readEntry ( const TQString & key, const TQString & def = TQString::null, bool * ok = 0 ) const" Reads the entry specified by \fIkey\fR, and returns a TQString, or the default value, \fIdef\fR, if the entry couldn't be read. If \fIok\fR is non-null, *ok is set to TRUE if the key was read, FALSE otherwise. .PP See also readListEntry(), readNumEntry(), readDoubleEntry(), readBoolEntry(), writeEntry(), and removeEntry(). -.SH "TQStringList QSettings::readListEntry ( const TQString & key, bool * ok = 0 ) const" +.SH "TQStringList TQSettings::readListEntry ( const TQString & key, bool * ok = 0 ) const" Reads the entry specified by \fIkey\fR as a string. If \fIok\fR is not 0, \fI*ok\fR is set to TRUE if the key was read, otherwise \fI*ok\fR is set to FALSE. .PP Note that if you want to iterate over the list, you should iterate over a copy, e.g. @@ -469,7 +469,7 @@ Note that if you want to iterate over the list, you should iterate over a copy, .fi .PP See also readEntry(), readDoubleEntry(), readBoolEntry(), writeEntry(), removeEntry(), and TQStringList::split(). -.SH "TQStringList QSettings::readListEntry ( const TQString & key, const TQChar & separator, bool * ok = 0 ) const" +.SH "TQStringList TQSettings::readListEntry ( const TQString & key, const TQChar & separator, bool * ok = 0 ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. @@ -497,33 +497,33 @@ Note that if you want to iterate over the list, you should iterate over a copy, .fi .PP See also readEntry(), readDoubleEntry(), readBoolEntry(), writeEntry(), removeEntry(), and TQStringList::split(). -.SH "int QSettings::readNumEntry ( const TQString & key, int def = 0, bool * ok = 0 ) const" +.SH "int TQSettings::readNumEntry ( const TQString & key, int def = 0, bool * ok = 0 ) const" Reads the entry specified by \fIkey\fR, and returns an integer, or the default value, \fIdef\fR, if the entry couldn't be read. If \fIok\fR is non-null, *ok is set to TRUE if the key was read, FALSE otherwise. .PP See also readEntry(), readDoubleEntry(), readBoolEntry(), writeEntry(), and removeEntry(). -.SH "bool QSettings::removeEntry ( const TQString & key )" +.SH "bool TQSettings::removeEntry ( const TQString & key )" Removes the entry specified by \fIkey\fR. .PP Returns true if the entry was successfully removed; otherwise returns false. Note that removing the last entry in any given folder, will also remove the folder. .PP See also readEntry() and writeEntry(). -.SH "void QSettings::removeSearchPath ( System s, const TQString & path )" +.SH "void TQSettings::removeSearchPath ( System s, const TQString & path )" Removes all occurrences of \fIpath\fR (using exact matching) from the settings search path for system \fIs\fR. Note that the default search paths cannot be removed. .PP See also insertSearchPath(). -.SH "void QSettings::resetGroup ()" +.SH "void TQSettings::resetGroup ()" Set the current key prefix to the empty string. -.SH "void QSettings::setPath ( const TQString & domain, const TQString & product, Scope scope = Global )" +.SH "void TQSettings::setPath ( const TQString & domain, const TQString & product, Scope scope = Global )" Insert platform-dependent paths from platform-independent information. .PP The \fIdomain\fR should be an Internet domain name controlled by the producer of the software, eg. Trolltech products use "trolltech.com". .PP The \fIproduct\fR should be the official name of the product. .PP -The \fIscope\fR should be QSettings::User for user-specific settings, or QSettings::Global for system-wide settings (generally these will be read-only to many users). +The \fIscope\fR should be TQSettings::User for user-specific settings, or TQSettings::Global for system-wide settings (generally these will be read-only to many users). .PP Not all information is relevant on all systems. -.SH "TQStringList QSettings::subkeyList ( const TQString & key ) const" +.SH "TQStringList TQSettings::subkeyList ( const TQString & key ) const" Returns a list of the keys which contain subkeys under \fIkey\fR. Does \fInot\fR return any keys that contain entries. .PP Example settings: @@ -558,7 +558,7 @@ Example settings: .PP In the above example, \fCkeys\fR will contain 'geometry' and 'recent files'. It will not contain 'background color' or 'foreground color' because those keys contain entries not subkeys. To get a list of keys that contain entries rather than subkeys use entryList() instead. .PP -\fBWarning:\fR In the above example, if QSettings is writing to an Ini file, then a call to +\fBWarning:\fR In the above example, if TQSettings is writing to an Ini file, then a call to .PP .nf .br @@ -570,10 +570,10 @@ will return an empty list. This happens because a key like .br /MyCompany/MyApplication/background color .fi -is written to the file \fI"mycompanyrc"\fR, under the section \fI[MyApplication]\fR. This call is therefore a request to list the sections in an ini file, which is not supported in this version of QSettings. This is a known issue which will be fixed in Qt-4. +is written to the file \fI"mycompanyrc"\fR, under the section \fI[MyApplication]\fR. This call is therefore a request to list the sections in an ini file, which is not supported in this version of TQSettings. This is a known issue which will be fixed in Qt-4. .PP See also entryList(). -.SH "bool QSettings::writeEntry ( const TQString & key, bool value )" +.SH "bool TQSettings::writeEntry ( const TQString & key, bool value )" Writes the boolean entry \fIvalue\fR into key \fIkey\fR. The \fIkey\fR is created if it doesn't exist. Any previous value is overwritten by \fIvalue\fR. .PP If an error occurs the settings are left unchanged and FALSE is returned; otherwise TRUE is returned. @@ -583,7 +583,7 @@ If an error occurs the settings are left unchanged and FALSE is returned; otherw See also readListEntry(), readNumEntry(), readDoubleEntry(), readBoolEntry(), and removeEntry(). .PP Example: chart/chartform.cpp. -.SH "bool QSettings::writeEntry ( const TQString & key, double value )" +.SH "bool TQSettings::writeEntry ( const TQString & key, double value )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes the double entry \fIvalue\fR into key \fIkey\fR. The \fIkey\fR is created if it doesn't exist. Any previous value is overwritten by \fIvalue\fR. @@ -591,7 +591,7 @@ Writes the double entry \fIvalue\fR into key \fIkey\fR. The \fIkey\fR is created If an error occurs the settings are left unchanged and FALSE is returned; otherwise TRUE is returned. .PP See also readListEntry(), readNumEntry(), readDoubleEntry(), readBoolEntry(), and removeEntry(). -.SH "bool QSettings::writeEntry ( const TQString & key, int value )" +.SH "bool TQSettings::writeEntry ( const TQString & key, int value )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes the integer entry \fIvalue\fR into key \fIkey\fR. The \fIkey\fR is created if it doesn't exist. Any previous value is overwritten by \fIvalue\fR. @@ -599,7 +599,7 @@ Writes the integer entry \fIvalue\fR into key \fIkey\fR. The \fIkey\fR is create If an error occurs the settings are left unchanged and FALSE is returned; otherwise TRUE is returned. .PP See also readListEntry(), readNumEntry(), readDoubleEntry(), readBoolEntry(), and removeEntry(). -.SH "bool QSettings::writeEntry ( const TQString & key, const TQString & value )" +.SH "bool TQSettings::writeEntry ( const TQString & key, const TQString & value )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes the string entry \fIvalue\fR into key \fIkey\fR. The \fIkey\fR is created if it doesn't exist. Any previous value is overwritten by \fIvalue\fR. If \fIvalue\fR is an empty string or a null string the key's value will be an empty string. @@ -607,7 +607,7 @@ Writes the string entry \fIvalue\fR into key \fIkey\fR. The \fIkey\fR is created If an error occurs the settings are left unchanged and FALSE is returned; otherwise TRUE is returned. .PP See also readListEntry(), readNumEntry(), readDoubleEntry(), readBoolEntry(), and removeEntry(). -.SH "bool QSettings::writeEntry ( const TQString & key, const TQStringList & value )" +.SH "bool TQSettings::writeEntry ( const TQString & key, const TQStringList & value )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes the string list entry \fIvalue\fR into key \fIkey\fR. The \fIkey\fR is created if it doesn't exist. Any previous value is overwritten by \fIvalue\fR. @@ -615,7 +615,7 @@ Writes the string list entry \fIvalue\fR into key \fIkey\fR. The \fIkey\fR is cr If an error occurs the settings are left unchanged and FALSE is returned; otherwise returns TRUE. .PP See also readListEntry(), readNumEntry(), readDoubleEntry(), readBoolEntry(), and removeEntry(). -.SH "bool QSettings::writeEntry ( const TQString & key, const TQStringList & value, const TQChar & separator )" +.SH "bool TQSettings::writeEntry ( const TQString & key, const TQStringList & value, const TQChar & separator )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. @@ -629,7 +629,7 @@ If an error occurs the settings are left unchanged and FALSE is returned; otherw See also readListEntry(), readNumEntry(), readDoubleEntry(), readBoolEntry(), removeEntry(), and TQStringList::join(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsettings.html +.BR http://doc.trolltech.com/tqsettings.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsignal.3qt b/doc/man/man3/tqsignal.3qt index f2fd48f62..d00d757f9 100644 --- a/doc/man/man3/tqsignal.3qt +++ b/doc/man/man3/tqsignal.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSignal 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSignal 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,19 +7,19 @@ .ad l .nh .SH NAME -QSignal \- Can be used to send signals for classes that don't inherit TQObject +TQSignal \- Can be used to send signals for classes that don't inherit TQObject .SH SYNOPSIS -\fC#include <ntqsignal.h>\fR +\fC#include <tqsignal.h>\fR .PP Inherits TQObject. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQSignal\fR ( TQObject * parent = 0, const char * name = 0 )" +.BI "\fBTQSignal\fR ( TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fB~QSignal\fR ()" +.BI "\fB~TQSignal\fR ()" .br .ti -1c .BI "bool \fBconnect\fR ( const TQObject * receiver, const char * member )" @@ -38,21 +38,21 @@ Inherits TQObject. .br .in -1c .SH DESCRIPTION -The QSignal class can be used to send signals for classes that don't inherit TQObject. +The TQSignal class can be used to send signals for classes that don't inherit TQObject. .PP -If you want to send signals from a class that does not inherit TQObject, you can create an internal QSignal object to emit the signal. You must also provide a function that connects the signal to an outside object slot. This is how we have implemented signals in the TQMenuData class, which is not a TQObject. +If you want to send signals from a class that does not inherit TQObject, you can create an internal TQSignal object to emit the signal. You must also provide a function that connects the signal to an outside object slot. This is how we have implemented signals in the TQMenuData class, which is not a TQObject. .PP In general, we recommend inheriting TQObject instead. TQObject provides much more functionality. .PP You can set a single QVariant parameter for the signal with setValue(). .PP -Note that TQObject is a \fIprivate\fR base class of QSignal, i.e. you cannot call any TQObject member functions from a QSignal object. +Note that TQObject is a \fIprivate\fR base class of TQSignal, i.e. you cannot call any TQObject member functions from a TQSignal object. .PP Example: .PP .nf .br - #include <ntqsignal.h> + #include <tqsignal.h> .br .br class MyClass @@ -74,7 +74,7 @@ Example: .br private: .br - QSignal *sig; + TQSignal *sig; .br }; .br @@ -83,7 +83,7 @@ Example: .br { .br - sig = new QSignal; + sig = new TQSignal; .br } .br @@ -120,27 +120,27 @@ Example: .PP See also Input/Output and Networking and Miscellaneous Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSignal::QSignal ( TQObject * parent = 0, const char * name = 0 )" +.SH "TQSignal::TQSignal ( TQObject * parent = 0, const char * name = 0 )" Constructs a signal object called \fIname\fR, with the parent object \fIparent\fR. These arguments are passed directly to TQObject. -.SH "QSignal::~QSignal ()" +.SH "TQSignal::~TQSignal ()" Destroys the signal. All connections are removed, as is the case with all TQObjects. -.SH "void QSignal::activate ()" +.SH "void TQSignal::activate ()" Emits the signal. If the platform supports QVariant and a parameter has been set with setValue(), this value is passed in the signal. -.SH "bool QSignal::connect ( const TQObject * receiver, const char * member )" +.SH "bool TQSignal::connect ( const TQObject * receiver, const char * member )" Connects the signal to \fImember\fR in object \fIreceiver\fR. .PP See also disconnect() and TQObject::connect(). -.SH "bool QSignal::disconnect ( const TQObject * receiver, const char * member = 0 )" +.SH "bool TQSignal::disconnect ( const TQObject * receiver, const char * member = 0 )" Disonnects the signal from \fImember\fR in object \fIreceiver\fR. .PP See also connect() and TQObject::disconnect(). -.SH "void QSignal::setValue ( const QVariant & value )" +.SH "void TQSignal::setValue ( const QVariant & value )" Sets the signal's parameter to \fIvalue\fR -.SH "QVariant QSignal::value () const" +.SH "QVariant TQSignal::value () const" Returns the signal's parameter .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsignal.html +.BR http://doc.trolltech.com/tqsignal.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsignalmapper.3qt b/doc/man/man3/tqsignalmapper.3qt index af0c40f77..ab1eadb33 100644 --- a/doc/man/man3/tqsignalmapper.3qt +++ b/doc/man/man3/tqsignalmapper.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSignalMapper 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSignalMapper 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,19 +7,19 @@ .ad l .nh .SH NAME -QSignalMapper \- Bundles signals from identifiable senders +TQSignalMapper \- Bundles signals from identifiable senders .SH SYNOPSIS -\fC#include <ntqsignalmapper.h>\fR +\fC#include <tqsignalmapper.h>\fR .PP Inherits TQObject. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQSignalMapper\fR ( TQObject * parent, const char * name = 0 )" +.BI "\fBTQSignalMapper\fR ( TQObject * parent, const char * name = 0 )" .br .ti -1c -.BI "\fB~QSignalMapper\fR ()" +.BI "\fB~TQSignalMapper\fR ()" .br .ti -1c .BI "virtual void \fBsetMapping\fR ( const TQObject * sender, int identifier )" @@ -47,44 +47,44 @@ Inherits TQObject. .br .in -1c .SH DESCRIPTION -The QSignalMapper class bundles signals from identifiable senders. +The TQSignalMapper class bundles signals from identifiable senders. .PP This class collects a set of parameterless signals, and re-emits them with integer or string parameters corresponding to the object that sent the signal. .PP See also Input/Output and Networking. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSignalMapper::QSignalMapper ( TQObject * parent, const char * name = 0 )" -Constructs a QSignalMapper called \fIname\fR, with parent \fIparent\fR. Like all TQObjects, it will be deleted when the parent is deleted. -.SH "QSignalMapper::~QSignalMapper ()" -Destroys the QSignalMapper. -.SH "void QSignalMapper::map ()\fC [slot]\fR" +.SH "TQSignalMapper::TQSignalMapper ( TQObject * parent, const char * name = 0 )" +Constructs a TQSignalMapper called \fIname\fR, with parent \fIparent\fR. Like all TQObjects, it will be deleted when the parent is deleted. +.SH "TQSignalMapper::~TQSignalMapper ()" +Destroys the TQSignalMapper. +.SH "void TQSignalMapper::map ()\fC [slot]\fR" This slot emits signals based on which object sends signals to it. .PP Examples: .)l i18n/main.cpp and themes/themes.cpp. -.SH "void QSignalMapper::mapped ( int )\fC [signal]\fR" +.SH "void TQSignalMapper::mapped ( int )\fC [signal]\fR" This signal is emitted when map() is signaled from an object that has an integer mapping set. .PP See also setMapping(). .PP Examples: .)l i18n/main.cpp and themes/themes.cpp. -.SH "void QSignalMapper::mapped ( const TQString & )\fC [signal]\fR" +.SH "void TQSignalMapper::mapped ( const TQString & )\fC [signal]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP This signal is emitted when map() is signaled from an object that has a string mapping set. .PP See also setMapping(). -.SH "void QSignalMapper::removeMappings ( const TQObject * sender )" +.SH "void TQSignalMapper::removeMappings ( const TQObject * sender )" Removes all mappings for \fIsender\fR. This is done automatically when mapped objects are destroyed. -.SH "void QSignalMapper::setMapping ( const TQObject * sender, int identifier )\fC [virtual]\fR" +.SH "void TQSignalMapper::setMapping ( const TQObject * sender, int identifier )\fC [virtual]\fR" Adds a mapping so that when map() is signaled from the given \fIsender\fR, the signal mapped(\fIidentifier\fR) is emitted. .PP There may be at most one integer identifier for each object. .PP Examples: .)l i18n/main.cpp and themes/themes.cpp. -.SH "void QSignalMapper::setMapping ( const TQObject * sender, const TQString & identifier )\fC [virtual]\fR" +.SH "void TQSignalMapper::setMapping ( const TQObject * sender, const TQString & identifier )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Adds a mapping so that when map() is signaled from the given \fIsender\fR, the signal mapper(\fIidentifier\fR) is emitted. @@ -93,7 +93,7 @@ There may be at most one string identifier for each object, and it may not be empty. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsignalmapper.html +.BR http://doc.trolltech.com/tqsignalmapper.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsize.3qt b/doc/man/man3/tqsize.3qt index 510dba354..b71bc08c4 100644 --- a/doc/man/man3/tqsize.3qt +++ b/doc/man/man3/tqsize.3qt @@ -116,10 +116,10 @@ TQSize \- Defines the size of a two-dimensional object .BI "const TQSize \fBoperator/\fR ( const TQSize & s, double c )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQSize & sz )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQSize & sz )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQSize & sz )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQSize & sz )" .br .in -1c .SH DESCRIPTION @@ -333,16 +333,16 @@ This is an overloaded member function, provided for convenience. It behaves esse Divides \fIs\fR by \fIc\fR and returns the result. .PP Note that the result is truncated. -.SH "QDataStream & operator<< ( QDataStream & s, const TQSize & sz )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQSize & sz )" Writes the size \fIsz\fR to the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "bool operator== ( const TQSize & s1, const TQSize & s2 )" Returns TRUE if \fIs1\fR and \fIs2\fR are equal; otherwise returns FALSE. -.SH "QDataStream & operator>> ( QDataStream & s, TQSize & sz )" +.SH "TQDataStream & operator>> ( TQDataStream & s, TQSize & sz )" Reads the size from the stream \fIs\fR into size \fIsz\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/tqsize.html diff --git a/doc/man/man3/tqsocket.3qt b/doc/man/man3/tqsocket.3qt index 67e432bbb..b8dbd811f 100644 --- a/doc/man/man3/tqsocket.3qt +++ b/doc/man/man3/tqsocket.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSocket 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSocket 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSocket \- Buffered TCP connection +TQSocket \- Buffered TCP connection .SH SYNOPSIS -\fC#include <ntqsocket.h>\fR +\fC#include <tqsocket.h>\fR .PP Inherits TQObject and TQIODevice. .PP @@ -19,10 +19,10 @@ Inherits TQObject and TQIODevice. .BI "enum \fBError\fR { ErrConnectionRefused, ErrHostNotFound, ErrSocketRead }" .br .ti -1c -.BI "\fBQSocket\fR ( TQObject * parent = 0, const char * name = 0 )" +.BI "\fBTQSocket\fR ( TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "virtual \fB~QSocket\fR ()" +.BI "virtual \fB~TQSocket\fR ()" .br .ti -1c .BI "enum \fBState\fR { Idle, HostLookup, Connecting, Connected, Closing, Connection = Connected }" @@ -37,10 +37,10 @@ Inherits TQObject and TQIODevice. .BI "virtual void \fBsetSocket\fR ( int socket )" .br .ti -1c -.BI "QSocketDevice * \fBsocketDevice\fR ()" +.BI "TQSocketDevice * \fBsocketDevice\fR ()" .br .ti -1c -.BI "virtual void \fBsetSocketDevice\fR ( QSocketDevice * device )" +.BI "virtual void \fBsetSocketDevice\fR ( TQSocketDevice * device )" .br .ti -1c .BI "virtual void \fBconnectToHost\fR ( const TQString & host, TQ_UINT16 port )" @@ -112,10 +112,10 @@ Inherits TQObject and TQIODevice. .BI "TQ_UINT16 \fBpeerPort\fR () const" .br .ti -1c -.BI "QHostAddress \fBaddress\fR () const" +.BI "TQHostAddress \fBaddress\fR () const" .br .ti -1c -.BI "QHostAddress \fBpeerAddress\fR () const" +.BI "TQHostAddress \fBpeerAddress\fR () const" .br .ti -1c .BI "void \fBsetReadBufferSize\fR ( TQ_ULONG bufSize )" @@ -149,7 +149,7 @@ Inherits TQObject and TQIODevice. .br .in -1c .SH DESCRIPTION -The QSocket class provides a buffered TCP connection. +The TQSocket class provides a buffered TCP connection. .PP It provides a totally non-blocking TQIODevice, and modifies and extends the API of TQIODevice with socket-specific code. .PP @@ -161,66 +161,66 @@ connectToHost() is the most-used function. As its name implies, it opens a conne .PP Most network protocols are either packet-oriented or line-oriented. canReadLine() indicates whether a connection contains an entire unread line or not, and bytesAvailable() returns the number of bytes available for reading. .PP -The signals error(), connected(), readyRead() and connectionClosed() inform you of the progress of the connection. There are also some less commonly used signals. hostFound() is emitted when connectToHost() has finished its DNS lookup and is starting its TCP connection. delayedCloseFinished() is emitted when close() succeeds. bytesWritten() is emitted when QSocket moves data from its "to be written" queue into the TCP implementation. +The signals error(), connected(), readyRead() and connectionClosed() inform you of the progress of the connection. There are also some less commonly used signals. hostFound() is emitted when connectToHost() has finished its DNS lookup and is starting its TCP connection. delayedCloseFinished() is emitted when close() succeeds. bytesWritten() is emitted when TQSocket moves data from its "to be written" queue into the TCP implementation. .PP -There are several access functions for the socket: state() returns whether the object is idle, is doing a DNS lookup, is connecting, has an operational connection, etc. address() and port() return the IP address and port used for the connection. The peerAddress() and peerPort() functions return the IP address and port used by the peer, and peerName() returns the name of the peer (normally the name that was passed to connectToHost()). socketDevice() returns a pointer to the QSocketDevice used for this socket. +There are several access functions for the socket: state() returns whether the object is idle, is doing a DNS lookup, is connecting, has an operational connection, etc. address() and port() return the IP address and port used for the connection. The peerAddress() and peerPort() functions return the IP address and port used by the peer, and peerName() returns the name of the peer (normally the name that was passed to connectToHost()). socketDevice() returns a pointer to the TQSocketDevice used for this socket. .PP -QSocket inherits TQIODevice, and reimplements some functions. In general, you can treat it as a TQIODevice for writing, and mostly also for reading. The match isn't perfect, since the TQIODevice API is designed for devices that are controlled by the same machine, and an asynchronous peer-to-peer network connection isn't quite like that. For example, there is nothing that matches TQIODevice::size() exactly. The documentation for open(), close(), flush(), size(), at(), atEnd(), readBlock(), writeBlock(), getch(), putch(), ungetch() and readLine() describes the differences in detail. +TQSocket inherits TQIODevice, and reimplements some functions. In general, you can treat it as a TQIODevice for writing, and mostly also for reading. The match isn't perfect, since the TQIODevice API is designed for devices that are controlled by the same machine, and an asynchronous peer-to-peer network connection isn't quite like that. For example, there is nothing that matches TQIODevice::size() exactly. The documentation for open(), close(), flush(), size(), at(), atEnd(), readBlock(), writeBlock(), getch(), putch(), ungetch() and readLine() describes the differences in detail. .PP -\fBWarning:\fR QSocket is not suitable for use in threads. If you need to uses sockets in threads use the lower-level QSocketDevice class. +\fBWarning:\fR TQSocket is not suitable for use in threads. If you need to uses sockets in threads use the lower-level TQSocketDevice class. .PP -\fBWarning:\fR Because TQt doesn't use the native socketstream implementation on Mac OS X, QSocket has an implicit transfer latency of 100ms. You can achieve lower latency on Mac OS X by using QSocketDevice instead. +\fBWarning:\fR Because TQt doesn't use the native socketstream implementation on Mac OS X, TQSocket has an implicit transfer latency of 100ms. You can achieve lower latency on Mac OS X by using TQSocketDevice instead. .PP -See also QSocketDevice, QHostAddress, QSocketNotifier, and Input/Output and Networking. +See also TQSocketDevice, TQHostAddress, TQSocketNotifier, and Input/Output and Networking. .SS "Member Type Documentation" -.SH "QSocket::Error" +.SH "TQSocket::Error" This enum specifies the possible errors: .TP -\fCQSocket::ErrConnectionRefused\fR - if the connection was refused +\fCTQSocket::ErrConnectionRefused\fR - if the connection was refused .TP -\fCQSocket::ErrHostNotFound\fR - if the host was not found +\fCTQSocket::ErrHostNotFound\fR - if the host was not found .TP -\fCQSocket::ErrSocketRead\fR - if a read from the socket failed -.SH "QSocket::State" +\fCTQSocket::ErrSocketRead\fR - if a read from the socket failed +.SH "TQSocket::State" This enum defines the connection states: .TP -\fCQSocket::Idle\fR - if there is no connection +\fCTQSocket::Idle\fR - if there is no connection .TP -\fCQSocket::HostLookup\fR - during a DNS lookup +\fCTQSocket::HostLookup\fR - during a DNS lookup .TP -\fCQSocket::Connecting\fR - during TCP connection establishment +\fCTQSocket::Connecting\fR - during TCP connection establishment .TP -\fCQSocket::Connected\fR - when there is an operational connection +\fCTQSocket::Connected\fR - when there is an operational connection .TP -\fCQSocket::Closing\fR - if the socket is closing down, but is not yet closed. +\fCTQSocket::Closing\fR - if the socket is closing down, but is not yet closed. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSocket::QSocket ( TQObject * parent = 0, const char * name = 0 )" -Creates a QSocket object in QSocket::Idle state. +.SH "TQSocket::TQSocket ( TQObject * parent = 0, const char * name = 0 )" +Creates a TQSocket object in TQSocket::Idle state. .PP The \fIparent\fR and \fIname\fR arguments are passed on to the TQObject constructor. .PP Note that a QApplication must have been constructed before sockets can be used. -.SH "QSocket::~QSocket ()\fC [virtual]\fR" +.SH "TQSocket::~TQSocket ()\fC [virtual]\fR" Destroys the socket. Closes the connection if necessary. .PP See also close(). -.SH "QHostAddress QSocket::address () const" +.SH "TQHostAddress TQSocket::address () const" Returns the host address of this socket. (This is normally the main IP address of the host, but can be e.g. 127.0.0.1 for connections to localhost.) -.SH "Offset QSocket::at () const\fC [virtual]\fR" -Returns the current read index. Since QSocket is a sequential device, the current read index is always zero. +.SH "Offset TQSocket::at () const\fC [virtual]\fR" +Returns the current read index. Since TQSocket is a sequential device, the current read index is always zero. .PP Reimplemented from TQIODevice. -.SH "bool QSocket::at ( Offset index )\fC [virtual]\fR" +.SH "bool TQSocket::at ( Offset index )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Moves the read index forward to \fIindex\fR and returns TRUE if the operation was successful; otherwise returns FALSE. Moving the index forward means skipping incoming data. .PP Reimplemented from TQIODevice. -.SH "bool QSocket::atEnd () const\fC [virtual]\fR" +.SH "bool TQSocket::atEnd () const\fC [virtual]\fR" Returns TRUE if there is no more data to read; otherwise returns FALSE. .PP Reimplemented from TQIODevice. -.SH "TQ_ULONG QSocket::bytesAvailable () const" +.SH "TQ_ULONG TQSocket::bytesAvailable () const" Returns the number of incoming bytes that can be read, i.e. the size of the input buffer. Equivalent to size(). .PP This function can trigger the readyRead() signal, if more data has arrived on the socket. @@ -228,17 +228,17 @@ This function can trigger the readyRead() signal, if more data has arrived on th See also bytesToWrite(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "TQ_ULONG QSocket::bytesToWrite () const" +.SH "TQ_ULONG TQSocket::bytesToWrite () const" Returns the number of bytes that are waiting to be written, i.e. the size of the output buffer. .PP See also bytesAvailable() and clearPendingData(). -.SH "void QSocket::bytesWritten ( int nbytes )\fC [signal]\fR" +.SH "void TQSocket::bytesWritten ( int nbytes )\fC [signal]\fR" This signal is emitted when data has been written to the network. The \fInbytes\fR parameter specifies how many bytes were written. .PP The bytesToWrite() function is often used in the same context; it indicates how many buffered bytes there are left to write. .PP See also writeBlock() and bytesToWrite(). -.SH "bool QSocket::canReadLine () const" +.SH "bool TQSocket::canReadLine () const" Returns TRUE if it's possible to read an entire line of text from this socket at this time; otherwise returns FALSE. .PP Note that if the peer closes the connection unexpectedly, this function returns FALSE. This means that loops such as this won't work: @@ -255,16 +255,16 @@ See also readLine(). .PP Examples: .)l network/clientserver/client/client.cpp, network/httpd/httpd.cpp, network/mail/smtp.cpp, and network/networkprotocol/nntp.cpp. -.SH "void QSocket::clearPendingData ()" +.SH "void TQSocket::clearPendingData ()" Deletes the data that is waiting to be written. This is useful if you want to close the socket without waiting for all the data to be written. .PP See also bytesToWrite(), close(), and delayedCloseFinished(). -.SH "void QSocket::close ()\fC [virtual]\fR" +.SH "void TQSocket::close ()\fC [virtual]\fR" Closes the socket. .PP The read buffer is cleared. .PP -If the output buffer is empty, the state is set to QSocket::Idle and the connection is terminated immediately. If the output buffer still contains data to be written, QSocket goes into the QSocket::Closing state and the rest of the data will be written. When all of the outgoing data have been written, the state is set to QSocket::Idle and the connection is terminated. At this point, the delayedCloseFinished() signal is emitted. +If the output buffer is empty, the state is set to TQSocket::Idle and the connection is terminated immediately. If the output buffer still contains data to be written, TQSocket goes into the TQSocket::Closing state and the rest of the data will be written. When all of the outgoing data have been written, the state is set to TQSocket::Idle and the connection is terminated. At this point, the delayedCloseFinished() signal is emitted. .PP If you don't want that the data of the output buffer is written, call clearPendingData() before you call close(). .PP @@ -274,80 +274,80 @@ Examples: .)l network/clientserver/client/client.cpp, network/httpd/httpd.cpp, and network/networkprotocol/nntp.cpp. .PP Reimplemented from TQIODevice. -.SH "void QSocket::connectToHost ( const TQString & host, TQ_UINT16 port )\fC [virtual]\fR" +.SH "void TQSocket::connectToHost ( const TQString & host, TQ_UINT16 port )\fC [virtual]\fR" Attempts to make a connection to \fIhost\fR on the specified \fIport\fR and return immediately. .PP -Any connection or pending connection is closed immediately, and QSocket goes into the HostLookup state. When the lookup succeeds, it emits hostFound(), starts a TCP connection and goes into the Connecting state. Finally, when the connection succeeds, it emits connected() and goes into the Connected state. If there is an error at any point, it emits error(). +Any connection or pending connection is closed immediately, and TQSocket goes into the HostLookup state. When the lookup succeeds, it emits hostFound(), starts a TCP connection and goes into the Connecting state. Finally, when the connection succeeds, it emits connected() and goes into the Connected state. If there is an error at any point, it emits error(). .PP -\fIhost\fR may be an IP address in string form, or it may be a DNS name. QSocket will do a normal DNS lookup if required. Note that \fIport\fR is in native byte order, unlike some other libraries. +\fIhost\fR may be an IP address in string form, or it may be a DNS name. TQSocket will do a normal DNS lookup if required. Note that \fIport\fR is in native byte order, unlike some other libraries. .PP See also state(). .PP Examples: .)l network/clientserver/client/client.cpp, network/mail/smtp.cpp, and network/networkprotocol/nntp.cpp. -.SH "void QSocket::connected ()\fC [signal]\fR" +.SH "void TQSocket::connected ()\fC [signal]\fR" This signal is emitted after connectToHost() has been called and a connection has been successfully established. .PP See also connectToHost() and connectionClosed(). .PP Examples: .)l network/clientserver/client/client.cpp, network/mail/smtp.cpp, and network/networkprotocol/nntp.cpp. -.SH "void QSocket::connectionClosed ()\fC [signal]\fR" +.SH "void TQSocket::connectionClosed ()\fC [signal]\fR" This signal is emitted when the other end has closed the connection. The read buffers may contain buffered input data which you can read after the connection was closed. .PP See also connectToHost() and close(). .PP Examples: .)l network/clientserver/client/client.cpp, network/clientserver/server/server.cpp, and network/networkprotocol/nntp.cpp. -.SH "void QSocket::delayedCloseFinished ()\fC [signal]\fR" +.SH "void TQSocket::delayedCloseFinished ()\fC [signal]\fR" This signal is emitted when a delayed close is finished. .PP -If you call close() and there is buffered output data to be written, QSocket goes into the QSocket::Closing state and returns immediately. It will then keep writing to the socket until all the data has been written. Then, the delayedCloseFinished() signal is emitted. +If you call close() and there is buffered output data to be written, TQSocket goes into the TQSocket::Closing state and returns immediately. It will then keep writing to the socket until all the data has been written. Then, the delayedCloseFinished() signal is emitted. .PP See also close(). .PP Examples: .)l network/clientserver/client/client.cpp and network/httpd/httpd.cpp. -.SH "void QSocket::error ( int )\fC [signal]\fR" +.SH "void TQSocket::error ( int )\fC [signal]\fR" This signal is emitted after an error occurred. The parameter is the Error value. .PP Examples: .)l network/clientserver/client/client.cpp and network/networkprotocol/nntp.cpp. -.SH "void QSocket::flush ()\fC [virtual]\fR" +.SH "void TQSocket::flush ()\fC [virtual]\fR" Implementation of the abstract virtual TQIODevice::flush() function. .PP Reimplemented from TQIODevice. -.SH "int QSocket::getch ()\fC [virtual]\fR" +.SH "int TQSocket::getch ()\fC [virtual]\fR" Reads a single byte/character from the internal read buffer. Returns the byte/character read, or -1 if there is nothing to be read. .PP See also bytesAvailable() and putch(). .PP Reimplemented from TQIODevice. -.SH "void QSocket::hostFound ()\fC [signal]\fR" +.SH "void TQSocket::hostFound ()\fC [signal]\fR" This signal is emitted after connectToHost() has been called and the host lookup has succeeded. .PP See also connected(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "bool QSocket::open ( int m )\fC [virtual]\fR" +.SH "bool TQSocket::open ( int m )\fC [virtual]\fR" Opens the socket using the specified TQIODevice file mode \fIm\fR. This function is called automatically when needed and you should not call it yourself. .PP See also close(). .PP Reimplemented from TQIODevice. -.SH "QHostAddress QSocket::peerAddress () const" -Returns the address of the connected peer if the socket is in Connected state; otherwise an empty QHostAddress is returned. -.SH "TQString QSocket::peerName () const" +.SH "TQHostAddress TQSocket::peerAddress () const" +Returns the address of the connected peer if the socket is in Connected state; otherwise an empty TQHostAddress is returned. +.SH "TQString TQSocket::peerName () const" Returns the host name as specified to the connectToHost() function. An empty string is returned if none has been set. .PP Example: network/mail/smtp.cpp. -.SH "TQ_UINT16 QSocket::peerPort () const" +.SH "TQ_UINT16 TQSocket::peerPort () const" Returns the peer's host port number, normally as specified to the connectToHost() function. If none has been set, this function returns 0. .PP Note that TQt always uses native byte order, i.e. 67 is 67 in Qt; there is no need to call htons(). -.SH "TQ_UINT16 QSocket::port () const" +.SH "TQ_UINT16 TQSocket::port () const" Returns the host port number of this socket, in native byte order. -.SH "int QSocket::putch ( int ch )\fC [virtual]\fR" +.SH "int TQSocket::putch ( int ch )\fC [virtual]\fR" Writes the character \fIch\fR to the output buffer. .PP Returns \fIch\fR, or -1 if an error occurred. @@ -355,24 +355,24 @@ Returns \fIch\fR, or -1 if an error occurred. See also getch(). .PP Reimplemented from TQIODevice. -.SH "TQ_LONG QSocket::readBlock ( char * data, TQ_ULONG maxlen )\fC [virtual]\fR" +.SH "TQ_LONG TQSocket::readBlock ( char * data, TQ_ULONG maxlen )\fC [virtual]\fR" Reads \fImaxlen\fR bytes from the socket into \fIdata\fR and returns the number of bytes read. Returns -1 if an error occurred. .PP Example: network/networkprotocol/nntp.cpp. .PP Reimplemented from TQIODevice. -.SH "TQ_ULONG QSocket::readBufferSize () const" +.SH "TQ_ULONG TQSocket::readBufferSize () const" Returns the size of the read buffer. .PP See also setReadBufferSize(). -.SH "TQString QSocket::readLine ()\fC [virtual]\fR" +.SH "TQString TQSocket::readLine ()\fC [virtual]\fR" Returns a line of text including a terminating newline character (\\n). Returns "" if canReadLine() returns FALSE. .PP See also canReadLine(). .PP Examples: .)l network/clientserver/client/client.cpp, network/httpd/httpd.cpp, network/mail/smtp.cpp, and network/networkprotocol/nntp.cpp. -.SH "void QSocket::readyRead ()\fC [signal]\fR" +.SH "void TQSocket::readyRead ()\fC [signal]\fR" This signal is emitted every time there is new incoming data. .PP Bear in mind that new incoming data is only reported once; if you do not read all the data, this class buffers the data and you can read it later, but no signal is emitted unless new data arrives. A good practice is to read all data in the slot connected to this signal unless you are sure that you need to receive more data to be able to process it. @@ -381,50 +381,50 @@ See also readBlock(), readLine(), and bytesAvailable(). .PP Examples: .)l network/clientserver/client/client.cpp, network/httpd/httpd.cpp, network/mail/smtp.cpp, and network/networkprotocol/nntp.cpp. -.SH "void QSocket::setReadBufferSize ( TQ_ULONG bufSize )" -Sets the size of the QSocket's internal read buffer to \fIbufSize\fR. +.SH "void TQSocket::setReadBufferSize ( TQ_ULONG bufSize )" +Sets the size of the TQSocket's internal read buffer to \fIbufSize\fR. .PP -Usually QSocket reads all data that is available from the operating system's socket. If the buffer size is limited to a certain size, this means that the QSocket class doesn't buffer more than this size of data. +Usually TQSocket reads all data that is available from the operating system's socket. If the buffer size is limited to a certain size, this means that the TQSocket class doesn't buffer more than this size of data. .PP If the size of the read buffer is 0, the read buffer is unlimited and all incoming data is buffered. This is the default. .PP If you read the data in the readyRead() signal, you shouldn't use this option since it might slow down your program unnecessary. This option is useful if you only need to read the data at certain points in time, like in a realtime streaming application. .PP See also readBufferSize(). -.SH "void QSocket::setSocket ( int socket )\fC [virtual]\fR" +.SH "void TQSocket::setSocket ( int socket )\fC [virtual]\fR" Sets the socket to use \fIsocket\fR and the state() to Connected. The socket must already be connected. .PP -This allows us to use the QSocket class as a wrapper for other socket types (e.g. Unix Domain Sockets). +This allows us to use the TQSocket class as a wrapper for other socket types (e.g. Unix Domain Sockets). .PP Example: network/httpd/httpd.cpp. -.SH "void QSocket::setSocketDevice ( QSocketDevice * device )\fC [virtual]\fR" +.SH "void TQSocket::setSocketDevice ( TQSocketDevice * device )\fC [virtual]\fR" Sets the internal socket device to \fIdevice\fR. Passing a \fIdevice\fR of 0 will cause the internal socket device to be used. Any existing connection will be disconnected before using the new \fIdevice\fR. .PP -The new device should not be connected before being associated with a QSocket; after setting the socket call connectToHost() to make the connection. +The new device should not be connected before being associated with a TQSocket; after setting the socket call connectToHost() to make the connection. .PP -This function is useful if you need to subclass QSocketDevice and want to use the QSocket API, for example, to implement Unix domain sockets. -.SH "Offset QSocket::size () const\fC [virtual]\fR" +This function is useful if you need to subclass TQSocketDevice and want to use the TQSocket API, for example, to implement Unix domain sockets. +.SH "Offset TQSocket::size () const\fC [virtual]\fR" Returns the number of incoming bytes that can be read right now (like bytesAvailable()). .PP Reimplemented from TQIODevice. -.SH "int QSocket::socket () const" +.SH "int TQSocket::socket () const" Returns the socket number, or -1 if there is no socket at the moment. -.SH "QSocketDevice * QSocket::socketDevice ()" +.SH "TQSocketDevice * TQSocket::socketDevice ()" Returns a pointer to the internal socket device. .PP There is normally no need to manipulate the socket device directly since this class does the necessary setup for most applications. -.SH "State QSocket::state () const" +.SH "State TQSocket::state () const" Returns the current state of the socket connection. .PP -See also QSocket::State. +See also TQSocket::State. .PP Examples: .)l network/clientserver/client/client.cpp and network/networkprotocol/nntp.cpp. -.SH "int QSocket::ungetch ( int ch )\fC [virtual]\fR" +.SH "int TQSocket::ungetch ( int ch )\fC [virtual]\fR" This implementation of the virtual function TQIODevice::ungetch() prepends the character \fIch\fR to the read buffer so that the next read returns this character as the first character of the output. .PP Reimplemented from TQIODevice. -.SH "TQ_ULONG QSocket::waitForMore ( int msecs, bool * timeout ) const" +.SH "TQ_ULONG TQSocket::waitForMore ( int msecs, bool * timeout ) const" Wait up to \fImsecs\fR milliseconds for more data to be available. .PP If \fImsecs\fR is -1 the call will block indefinitely. @@ -436,9 +436,9 @@ If \fItimeout\fR is non-null and no error occurred (i.e. it does not return -1): \fBWarning:\fR This is a blocking call and should be avoided in event driven applications. .PP See also bytesAvailable(). -.SH "TQ_ULONG QSocket::waitForMore ( int msecs ) const" +.SH "TQ_ULONG TQSocket::waitForMore ( int msecs ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -.SH "TQ_LONG QSocket::writeBlock ( const char * data, TQ_ULONG len )\fC [virtual]\fR" +.SH "TQ_LONG TQSocket::writeBlock ( const char * data, TQ_ULONG len )\fC [virtual]\fR" Writes \fIlen\fR bytes to the socket from \fIdata\fR and returns the number of bytes written. Returns -1 if an error occurred. .PP Example: network/networkprotocol/nntp.cpp. @@ -446,7 +446,7 @@ Example: network/networkprotocol/nntp.cpp. Reimplemented from TQIODevice. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsocket.html +.BR http://doc.trolltech.com/tqsocket.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsocketdevice.3qt b/doc/man/man3/tqsocketdevice.3qt index 40bc49f05..99779fb98 100644 --- a/doc/man/man3/tqsocketdevice.3qt +++ b/doc/man/man3/tqsocketdevice.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSocketDevice 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSocketDevice 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSocketDevice \- Platform-independent low-level socket API +TQSocketDevice \- Platform-independent low-level socket API .SH SYNOPSIS -\fC#include <ntqsocketdevice.h>\fR +\fC#include <tqsocketdevice.h>\fR .PP Inherits TQIODevice. .PP @@ -22,16 +22,16 @@ Inherits TQIODevice. .BI "enum \fBProtocol\fR { IPv4, IPv6, Unknown }" .br .ti -1c -.BI "\fBQSocketDevice\fR ( Type type = Stream )" +.BI "\fBTQSocketDevice\fR ( Type type = Stream )" .br .ti -1c -.BI "\fBQSocketDevice\fR ( Type type, Protocol protocol, int dummy )" +.BI "\fBTQSocketDevice\fR ( Type type, Protocol protocol, int dummy )" .br .ti -1c -.BI "\fBQSocketDevice\fR ( int socket, Type type )" +.BI "\fBTQSocketDevice\fR ( int socket, Type type )" .br .ti -1c -.BI "virtual \fB~QSocketDevice\fR ()" +.BI "virtual \fB~TQSocketDevice\fR ()" .br .ti -1c .BI "bool \fBisValid\fR () const" @@ -73,10 +73,10 @@ Inherits TQIODevice. .BI "virtual void \fBsetSendBufferSize\fR ( uint size )" .br .ti -1c -.BI "virtual bool \fBconnect\fR ( const QHostAddress & addr, TQ_UINT16 port )" +.BI "virtual bool \fBconnect\fR ( const TQHostAddress & addr, TQ_UINT16 port )" .br .ti -1c -.BI "virtual bool \fBbind\fR ( const QHostAddress & address, TQ_UINT16 port )" +.BI "virtual bool \fBbind\fR ( const TQHostAddress & address, TQ_UINT16 port )" .br .ti -1c .BI "virtual bool \fBlisten\fR ( int backlog )" @@ -97,7 +97,7 @@ Inherits TQIODevice. .BI "virtual TQ_LONG \fBwriteBlock\fR ( const char * data, TQ_ULONG len )" .br .ti -1c -.BI "virtual TQ_LONG \fBwriteBlock\fR ( const char * data, TQ_ULONG len, const QHostAddress & host, TQ_UINT16 port )" +.BI "virtual TQ_LONG \fBwriteBlock\fR ( const char * data, TQ_ULONG len, const TQHostAddress & host, TQ_UINT16 port )" .br .ti -1c .BI "TQ_UINT16 \fBport\fR () const" @@ -106,10 +106,10 @@ Inherits TQIODevice. .BI "TQ_UINT16 \fBpeerPort\fR () const" .br .ti -1c -.BI "QHostAddress \fBaddress\fR () const" +.BI "TQHostAddress \fBaddress\fR () const" .br .ti -1c -.BI "QHostAddress \fBpeerAddress\fR () const" +.BI "TQHostAddress \fBpeerAddress\fR () const" .br .ti -1c .BI "enum \fBError\fR { NoError, AlreadyBound, Inaccessible, NoResources, InternalError, Bug = InternalError, Impossible, NoFiles, ConnectionRefused, NetworkFailure, UnknownError }" @@ -125,30 +125,30 @@ Inherits TQIODevice. .br .in -1c .SH DESCRIPTION -The QSocketDevice class provides a platform-independent low-level socket API. +The TQSocketDevice class provides a platform-independent low-level socket API. .PP -This class provides a low level API for working with sockets. Users of this class are assumed to have networking experience. For most users the QSocket class provides a much easier and high level alternative, but certain things (like UDP) can't be done with QSocket and if you need a platform-independent API for those, QSocketDevice is the right choice. +This class provides a low level API for working with sockets. Users of this class are assumed to have networking experience. For most users the TQSocket class provides a much easier and high level alternative, but certain things (like UDP) can't be done with TQSocket and if you need a platform-independent API for those, TQSocketDevice is the right choice. .PP The essential purpose of the class is to provide a TQIODevice that works on sockets, wrapped in a platform-independent API. .PP -When calling connect() or bind(), QSocketDevice detects the protocol family (IPv4, IPv6) automatically. Passing the protocol family to QSocketDevice's constructor or to setSocket() forces creation of a socket device of a specific protocol. If not set, the protocol will be detected at the first call to connect() or bind(). +When calling connect() or bind(), TQSocketDevice detects the protocol family (IPv4, IPv6) automatically. Passing the protocol family to TQSocketDevice's constructor or to setSocket() forces creation of a socket device of a specific protocol. If not set, the protocol will be detected at the first call to connect() or bind(). .PP -See also QSocket, QSocketNotifier, QHostAddress, and Input/Output and Networking. +See also TQSocket, TQSocketNotifier, TQHostAddress, and Input/Output and Networking. .SS "Member Type Documentation" -.SH "QSocketDevice::Error" -This enum type describes the error states of QSocketDevice. +.SH "TQSocketDevice::Error" +This enum type describes the error states of TQSocketDevice. .TP -\fCQSocketDevice::NoError\fR - No error has occurred. +\fCTQSocketDevice::NoError\fR - No error has occurred. .TP -\fCQSocketDevice::AlreadyBound\fR - The device is already bound, according to bind(). +\fCTQSocketDevice::AlreadyBound\fR - The device is already bound, according to bind(). .TP -\fCQSocketDevice::Inaccessible\fR - The operating system or firewall prohibited the action. +\fCTQSocketDevice::Inaccessible\fR - The operating system or firewall prohibited the action. .TP -\fCQSocketDevice::NoResources\fR - The operating system ran out of a resource. +\fCTQSocketDevice::NoResources\fR - The operating system ran out of a resource. .TP -\fCQSocketDevice::InternalError\fR - An internal error occurred in QSocketDevice. +\fCTQSocketDevice::InternalError\fR - An internal error occurred in TQSocketDevice. .TP -\fCQSocketDevice::Impossible\fR - An attempt was made to do something which makes no sense. For example: +\fCTQSocketDevice::Impossible\fR - An attempt was made to do something which makes no sense. For example: .IP .nf .br @@ -157,71 +157,71 @@ This enum type describes the error states of QSocketDevice. sd->writeBlock( someData, 42 ); .br .fi -The libc ::close() closes the socket, but QSocketDevice is not aware of this. So when you call writeBlock(), the impossible happens. +The libc ::close() closes the socket, but TQSocketDevice is not aware of this. So when you call writeBlock(), the impossible happens. .TP -\fCQSocketDevice::NoFiles\fR - The operating system will not let QSocketDevice open another file. +\fCTQSocketDevice::NoFiles\fR - The operating system will not let TQSocketDevice open another file. .TP -\fCQSocketDevice::ConnectionRefused\fR - A connection attempt was rejected by the peer. +\fCTQSocketDevice::ConnectionRefused\fR - A connection attempt was rejected by the peer. .TP -\fCQSocketDevice::NetworkFailure\fR - There is a network failure. +\fCTQSocketDevice::NetworkFailure\fR - There is a network failure. .TP -\fCQSocketDevice::UnknownError\fR - The operating system did something unexpected. -.SH "QSocketDevice::Protocol" +\fCTQSocketDevice::UnknownError\fR - The operating system did something unexpected. +.SH "TQSocketDevice::Protocol" This enum type describes the protocol family of the socket. Possible values are: .TP -\fCQSocketDevice::IPv4\fR - The socket is an IPv4 socket. +\fCTQSocketDevice::IPv4\fR - The socket is an IPv4 socket. .TP -\fCQSocketDevice::IPv6\fR - The socket is an IPv6 socket. +\fCTQSocketDevice::IPv6\fR - The socket is an IPv6 socket. .TP -\fCQSocketDevice::Unknown\fR - The protocol family of the socket is not known. This can happen if you use QSocketDevice with an already existing socket; it tries to determine the protocol family, but this can fail if the protocol family is not known to QSocketDevice. +\fCTQSocketDevice::Unknown\fR - The protocol family of the socket is not known. This can happen if you use TQSocketDevice with an already existing socket; it tries to determine the protocol family, but this can fail if the protocol family is not known to TQSocketDevice. .PP See also protocol() and setSocket(). -.SH "QSocketDevice::Type" +.SH "TQSocketDevice::Type" This enum type describes the type of the socket: .TP -\fCQSocketDevice::Stream\fR - a stream socket (TCP, usually) +\fCTQSocketDevice::Stream\fR - a stream socket (TCP, usually) .TP -\fCQSocketDevice::Datagram\fR - a datagram socket (UDP, usually) +\fCTQSocketDevice::Datagram\fR - a datagram socket (UDP, usually) .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSocketDevice::QSocketDevice ( Type type = Stream )" -Creates a QSocketDevice object for a stream or datagram socket. +.SH "TQSocketDevice::TQSocketDevice ( Type type = Stream )" +Creates a TQSocketDevice object for a stream or datagram socket. .PP -The \fItype\fR argument must be either QSocketDevice::Stream for a reliable, connection-oriented TCP socket, or QSocketDevice::Datagram for an unreliable UDP socket. +The \fItype\fR argument must be either TQSocketDevice::Stream for a reliable, connection-oriented TCP socket, or TQSocketDevice::Datagram for an unreliable UDP socket. .PP The socket is created as an IPv4 socket. .PP See also blocking() and protocol(). -.SH "QSocketDevice::QSocketDevice ( Type type, Protocol protocol, int dummy )" -Creates a QSocketDevice object for a stream or datagram socket. +.SH "TQSocketDevice::TQSocketDevice ( Type type, Protocol protocol, int dummy )" +Creates a TQSocketDevice object for a stream or datagram socket. .PP -The \fItype\fR argument must be either QSocketDevice::Stream for a reliable, connection-oriented TCP socket, or QSocketDevice::Datagram for an unreliable UDP socket. +The \fItype\fR argument must be either TQSocketDevice::Stream for a reliable, connection-oriented TCP socket, or TQSocketDevice::Datagram for an unreliable UDP socket. .PP The \fIprotocol\fR indicates whether the socket should be of type IPv4 or IPv6. Passing Unknown is not meaningful in this context and you should avoid using (it creates an IPv4 socket, but your code is not easily readable). .PP The argument \fIdummy\fR is necessary for compatibility with some compilers. .PP See also blocking() and protocol(). -.SH "QSocketDevice::QSocketDevice ( int socket, Type type )" -Creates a QSocketDevice object for the existing socket \fIsocket\fR. +.SH "TQSocketDevice::TQSocketDevice ( int socket, Type type )" +Creates a TQSocketDevice object for the existing socket \fIsocket\fR. .PP -The \fItype\fR argument must match the actual socket type; use QSocketDevice::Stream for a reliable, connection-oriented TCP socket, or QSocketDevice::Datagram for an unreliable, connectionless UDP socket. -.SH "QSocketDevice::~QSocketDevice ()\fC [virtual]\fR" +The \fItype\fR argument must match the actual socket type; use TQSocketDevice::Stream for a reliable, connection-oriented TCP socket, or TQSocketDevice::Datagram for an unreliable, connectionless UDP socket. +.SH "TQSocketDevice::~TQSocketDevice ()\fC [virtual]\fR" Destroys the socket device and closes the socket if it is open. -.SH "int QSocketDevice::accept ()\fC [virtual]\fR" +.SH "int TQSocketDevice::accept ()\fC [virtual]\fR" Extracts the first connection from the queue of pending connections for this socket and returns a new socket identifier. Returns -1 if the operation failed. .PP See also bind() and listen(). -.SH "QHostAddress QSocketDevice::address () const" +.SH "TQHostAddress TQSocketDevice::address () const" Returns the address of this socket device. This may be 0.0.0.0 for a while, but is set to something sensible as soon as a sensible value is available. -.SH "bool QSocketDevice::addressReusable () const" +.SH "bool TQSocketDevice::addressReusable () const" Returns TRUE if the address of this socket can be used by other sockets at the same time, and FALSE if this socket claims exclusive ownership. .PP See also setAddressReusable(). -.SH "bool QSocketDevice::bind ( const QHostAddress & address, TQ_UINT16 port )\fC [virtual]\fR" +.SH "bool TQSocketDevice::bind ( const TQHostAddress & address, TQ_UINT16 port )\fC [virtual]\fR" Assigns a name to an unnamed socket. The name is the host address \fIaddress\fR and the port number \fIport\fR. If the operation succeeds, bind() returns TRUE; otherwise it returns FALSE without changing what port() and address() return. .PP bind() is used by servers for setting up incoming connections. Call bind() before listen(). -.SH "bool QSocketDevice::blocking () const" +.SH "bool TQSocketDevice::blocking () const" Returns TRUE if the socket is valid and in blocking mode; otherwise returns FALSE. .PP Note that this function does not set error(). @@ -229,101 +229,101 @@ Note that this function does not set error(). \fBWarning:\fR On Windows, this function always returns TRUE since the ioctlsocket() function is broken. .PP See also setBlocking() and isValid(). -.SH "TQ_LONG QSocketDevice::bytesAvailable () const" +.SH "TQ_LONG TQSocketDevice::bytesAvailable () const" Returns the number of bytes available for reading, or -1 if an error occurred. .PP -\fBWarning:\fR On Microsoft Windows, we use the ioctlsocket() function to determine the number of bytes queued on the socket. According to Microsoft (KB Q125486), ioctlsocket() sometimes returns an incorrect number. The only safe way to determine the amount of data on the socket is to read it using readBlock(). QSocket has workarounds to deal with this problem. -.SH "bool QSocketDevice::connect ( const QHostAddress & addr, TQ_UINT16 port )\fC [virtual]\fR" +\fBWarning:\fR On Microsoft Windows, we use the ioctlsocket() function to determine the number of bytes queued on the socket. According to Microsoft (KB Q125486), ioctlsocket() sometimes returns an incorrect number. The only safe way to determine the amount of data on the socket is to read it using readBlock(). TQSocket has workarounds to deal with this problem. +.SH "bool TQSocketDevice::connect ( const TQHostAddress & addr, TQ_UINT16 port )\fC [virtual]\fR" Connects to the IP address and port specified by \fIaddr\fR and \fIport\fR. Returns TRUE if it establishes a connection; otherwise returns FALSE. If it returns FALSE, error() explains why. .PP Note that error() commonly returns NoError for non-blocking sockets; this just means that you can call connect() again in a little while and it'll probably succeed. -.SH "Error QSocketDevice::error () const" +.SH "Error TQSocketDevice::error () const" Returns the first error seen. -.SH "bool QSocketDevice::isValid () const" +.SH "bool TQSocketDevice::isValid () const" Returns TRUE if this is a valid socket; otherwise returns FALSE. .PP See also socket(). -.SH "bool QSocketDevice::listen ( int backlog )\fC [virtual]\fR" +.SH "bool TQSocketDevice::listen ( int backlog )\fC [virtual]\fR" Specifies how many pending connections a server socket can have. Returns TRUE if the operation was successful; otherwise returns FALSE. A \fIbacklog\fR value of 50 is quite common. .PP The listen() call only applies to sockets where type() is Stream, i.e. not to Datagram sockets. listen() must not be called before bind() or after accept(). .PP See also bind() and accept(). -.SH "QHostAddress QSocketDevice::peerAddress () const" +.SH "TQHostAddress TQSocketDevice::peerAddress () const" Returns the address of the port this socket device is connected to. This may be 0.0.0.0 for a while, but is set to something sensible as soon as a sensible value is available. .PP Note that for Datagram sockets, this is the source port of the last packet received. -.SH "TQ_UINT16 QSocketDevice::peerPort () const" +.SH "TQ_UINT16 TQSocketDevice::peerPort () const" Returns the port number of the port this socket device is connected to. This may be 0 for a while, but is set to something sensible as soon as a sensible value is available. .PP Note that for Datagram sockets, this is the source port of the last packet received, and that it is in native byte order. -.SH "TQ_UINT16 QSocketDevice::port () const" +.SH "TQ_UINT16 TQSocketDevice::port () const" Returns the port number of this socket device. This may be 0 for a while, but is set to something sensible as soon as a sensible value is available. .PP Note that TQt always uses native byte order, i.e. 67 is 67 in Qt; there is no need to call htons(). -.SH "Protocol QSocketDevice::protocol () const" +.SH "Protocol TQSocketDevice::protocol () const" Returns the socket's protocol family, which is one of Unknown, IPv4, or IPv6. .PP -QSocketDevice either creates a socket with a well known protocol family or it uses an already existing socket. In the first case, this function returns the protocol family it was constructed with. In the second case, it tries to determine the protocol family of the socket; if this fails, it returns Unknown. +TQSocketDevice either creates a socket with a well known protocol family or it uses an already existing socket. In the first case, this function returns the protocol family it was constructed with. In the second case, it tries to determine the protocol family of the socket; if this fails, it returns Unknown. .PP See also Protocol and setSocket(). -.SH "TQ_LONG QSocketDevice::readBlock ( char * data, TQ_ULONG maxlen )\fC [virtual]\fR" +.SH "TQ_LONG TQSocketDevice::readBlock ( char * data, TQ_ULONG maxlen )\fC [virtual]\fR" Reads \fImaxlen\fR bytes from the socket into \fIdata\fR and returns the number of bytes read. Returns -1 if an error occurred. Returning 0 is not an error. For Stream sockets, 0 is returned when the remote host closes the connection. For Datagram sockets, 0 is a valid datagram size. .PP Reimplemented from TQIODevice. -.SH "int QSocketDevice::receiveBufferSize () const" +.SH "int TQSocketDevice::receiveBufferSize () const" Returns the size of the operating system receive buffer. .PP See also setReceiveBufferSize(). -.SH "int QSocketDevice::sendBufferSize () const" +.SH "int TQSocketDevice::sendBufferSize () const" Returns the size of the operating system send buffer. .PP See also setSendBufferSize(). -.SH "void QSocketDevice::setAddressReusable ( bool enable )\fC [virtual]\fR" +.SH "void TQSocketDevice::setAddressReusable ( bool enable )\fC [virtual]\fR" Sets the address of this socket to be usable by other sockets too if \fIenable\fR is TRUE, and to be used exclusively by this socket if \fIenable\fR is FALSE. .PP When a socket is reusable, other sockets can use the same port number (and IP address), which is generally useful. Of course other sockets cannot use the same (address,port,peer-address,peer-port) 4-tuple as this socket, so there is no risk of confusing the two TCP connections. .PP See also addressReusable(). -.SH "void QSocketDevice::setBlocking ( bool enable )\fC [virtual]\fR" +.SH "void TQSocketDevice::setBlocking ( bool enable )\fC [virtual]\fR" Makes the socket blocking if \fIenable\fR is TRUE or nonblocking if \fIenable\fR is FALSE. .PP Sockets are blocking by default, but we recommend using nonblocking socket operations, especially for GUI programs that need to be responsive. .PP -\fBWarning:\fR On Windows, this function should be used with care since whenever you use a QSocketNotifier on Windows, the socket is immediately made nonblocking. +\fBWarning:\fR On Windows, this function should be used with care since whenever you use a TQSocketNotifier on Windows, the socket is immediately made nonblocking. .PP See also blocking() and isValid(). -.SH "void QSocketDevice::setError ( Error err )\fC [protected]\fR" +.SH "void TQSocketDevice::setError ( Error err )\fC [protected]\fR" Allows subclasses to set the error state to \fIerr\fR. -.SH "void QSocketDevice::setReceiveBufferSize ( uint size )\fC [virtual]\fR" +.SH "void TQSocketDevice::setReceiveBufferSize ( uint size )\fC [virtual]\fR" Sets the size of the operating system receive buffer to \fIsize\fR. .PP The operating system receive buffer size effectively limits two things: how much data can be in transit at any one moment, and how much data can be received in one iteration of the main event loop. .PP The default is operating system-dependent. A socket that receives large amounts of data is probably best with a buffer size of 49152. -.SH "void QSocketDevice::setSendBufferSize ( uint size )\fC [virtual]\fR" +.SH "void TQSocketDevice::setSendBufferSize ( uint size )\fC [virtual]\fR" Sets the size of the operating system send buffer to \fIsize\fR. .PP The operating system send buffer size effectively limits how much data can be in transit at any one moment. .PP The default is operating system-dependent. A socket that sends large amounts of data is probably best with a buffer size of 49152. -.SH "void QSocketDevice::setSocket ( int socket, Type type )\fC [virtual]\fR" +.SH "void TQSocketDevice::setSocket ( int socket, Type type )\fC [virtual]\fR" Sets the socket device to operate on the existing socket \fIsocket\fR. .PP -The \fItype\fR argument must match the actual socket type; use QSocketDevice::Stream for a reliable, connection-oriented TCP socket, or QSocketDevice::Datagram for an unreliable, connectionless UDP socket. +The \fItype\fR argument must match the actual socket type; use TQSocketDevice::Stream for a reliable, connection-oriented TCP socket, or TQSocketDevice::Datagram for an unreliable, connectionless UDP socket. .PP Any existing socket is closed. .PP See also isValid() and close(). -.SH "int QSocketDevice::socket () const" +.SH "int TQSocketDevice::socket () const" Returns the socket number, or -1 if it is an invalid socket. .PP See also isValid() and type(). -.SH "Type QSocketDevice::type () const" -Returns the socket type which is either QSocketDevice::Stream or QSocketDevice::Datagram. +.SH "Type TQSocketDevice::type () const" +Returns the socket type which is either TQSocketDevice::Stream or TQSocketDevice::Datagram. .PP See also socket(). -.SH "TQ_LONG QSocketDevice::waitForMore ( int msecs, bool * timeout = 0 ) const" +.SH "TQ_LONG TQSocketDevice::waitForMore ( int msecs, bool * timeout = 0 ) const" Wait up to \fImsecs\fR milliseconds for more data to be available. If \fImsecs\fR is -1 the call will block indefinitely. .PP Returns the number of bytes available for reading, or -1 if an error occurred. @@ -333,22 +333,22 @@ If \fItimeout\fR is non-null and no error occurred (i.e. it does not return -1): \fBWarning:\fR This is a blocking call and should be avoided in event driven applications. .PP See also bytesAvailable(). -.SH "TQ_LONG QSocketDevice::writeBlock ( const char * data, TQ_ULONG len )\fC [virtual]\fR" +.SH "TQ_LONG TQSocketDevice::writeBlock ( const char * data, TQ_ULONG len )\fC [virtual]\fR" Writes \fIlen\fR bytes to the socket from \fIdata\fR and returns the number of bytes written. Returns -1 if an error occurred. .PP -This is used for QSocketDevice::Stream sockets. +This is used for TQSocketDevice::Stream sockets. .PP Reimplemented from TQIODevice. -.SH "TQ_LONG QSocketDevice::writeBlock ( const char * data, TQ_ULONG len, const QHostAddress & host, TQ_UINT16 port )\fC [virtual]\fR" +.SH "TQ_LONG TQSocketDevice::writeBlock ( const char * data, TQ_ULONG len, const TQHostAddress & host, TQ_UINT16 port )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes \fIlen\fR bytes to the socket from \fIdata\fR and returns the number of bytes written. Returns -1 if an error occurred. .PP -This is used for QSocketDevice::Datagram sockets. You must +This is used for TQSocketDevice::Datagram sockets. You must specify the \fIhost\fR and \fIport\fR of the destination of the data. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsocketdevice.html +.BR http://doc.trolltech.com/tqsocketdevice.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqsocketnotifier.3qt b/doc/man/man3/tqsocketnotifier.3qt index 432975247..d351b028d 100644 --- a/doc/man/man3/tqsocketnotifier.3qt +++ b/doc/man/man3/tqsocketnotifier.3qt @@ -1,5 +1,5 @@ '\" t -.TH QSocketNotifier 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQSocketNotifier 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QSocketNotifier \- Support for socket callbacks +TQSocketNotifier \- Support for socket callbacks .SH SYNOPSIS -\fC#include <ntqsocketnotifier.h>\fR +\fC#include <tqsocketnotifier.h>\fR .PP Inherits TQObject. .PP @@ -19,10 +19,10 @@ Inherits TQObject. .BI "enum \fBType\fR { Read, Write, Exception }" .br .ti -1c -.BI "\fBQSocketNotifier\fR ( int socket, Type type, TQObject * parent = 0, const char * name = 0 )" +.BI "\fBTQSocketNotifier\fR ( int socket, Type type, TQObject * parent = 0, const char * name = 0 )" .br .ti -1c -.BI "\fB~QSocketNotifier\fR ()" +.BI "\fB~TQSocketNotifier\fR ()" .br .ti -1c .BI "int \fBsocket\fR () const" @@ -44,23 +44,23 @@ Inherits TQObject. .br .in -1c .SH DESCRIPTION -The QSocketNotifier class provides support for socket callbacks. +The TQSocketNotifier class provides support for socket callbacks. .PP This class makes it possible to write asynchronous socket-based code in Qt. Using synchronous socket operations blocks the program, which is clearly not acceptable for an event-driven GUI program. .PP Once you have opened a non-blocking socket (whether for TCP, UDP, a UNIX-domain socket, or any other protocol family your operating system supports), you can create a socket notifier to monitor the socket. Then you connect the activated() signal to the slot you want to be called when a socket event occurs. .PP -Note for Windows users: the socket passed to QSocketNotifier will become non-blocking, even if it was created as a blocking socket. +Note for Windows users: the socket passed to TQSocketNotifier will become non-blocking, even if it was created as a blocking socket. .PP There are three types of socket notifiers (read, write and exception); you must specify one of these in the constructor. .PP The type specifies when the activated() signal is to be emitted: <ol type=1> .IP 1 -QSocketNotifier::Read - There is data to be read (socket read event). +TQSocketNotifier::Read - There is data to be read (socket read event). .IP 2 -QSocketNotifier::Write - Data can be written (socket write event). +TQSocketNotifier::Write - Data can be written (socket write event). .IP 3 -QSocketNofifier::Exception - An exception has occurred (socket exception event). We recommend against using this. +TQSocketNofifier::Exception - An exception has occurred (socket exception event). We recommend against using this. .PP For example, if you need to monitor both reads and writes for the same socket you must create two socket notifiers. .PP @@ -78,41 +78,41 @@ Socket action is detected in the main event loop of Qt. The X11 version of TQt h .PP Note that on XFree86 for OS/2, select() works only in the thread in which main() is running; you should therefore use that thread for GUI operations. .PP -See also QSocket, QServerSocket, QSocketDevice, QFile::handle(), and Input/Output and Networking. +See also TQSocket, TQServerSocket, TQSocketDevice, TQFile::handle(), and Input/Output and Networking. .SS "Member Type Documentation" -.SH "QSocketNotifier::Type" +.SH "TQSocketNotifier::Type" .TP -\fCQSocketNotifier::Read\fR +\fCTQSocketNotifier::Read\fR .TP -\fCQSocketNotifier::Write\fR +\fCTQSocketNotifier::Write\fR .TP -\fCQSocketNotifier::Exception\fR +\fCTQSocketNotifier::Exception\fR .SH MEMBER FUNCTION DOCUMENTATION -.SH "QSocketNotifier::QSocketNotifier ( int socket, Type type, TQObject * parent = 0, const char * name = 0 )" +.SH "TQSocketNotifier::TQSocketNotifier ( int socket, Type type, TQObject * parent = 0, const char * name = 0 )" Constructs a socket notifier called \fIname\fR, with the parent, \fIparent\fR. It watches \fIsocket\fR for \fItype\fR events, and enables it. .PP It is generally advisable to explicitly enable or disable the socket notifier, especially for write notifiers. .PP See also setEnabled() and isEnabled(). -.SH "QSocketNotifier::~QSocketNotifier ()" +.SH "TQSocketNotifier::~TQSocketNotifier ()" Destroys the socket notifier. -.SH "void QSocketNotifier::activated ( int socket )\fC [signal]\fR" +.SH "void TQSocketNotifier::activated ( int socket )\fC [signal]\fR" This signal is emitted under certain conditions specified by the notifier type(): <ol type=1> .TP -QSocketNotifier::Read - There is data to be read (socket read event). +TQSocketNotifier::Read - There is data to be read (socket read event). .TP -QSocketNotifier::Write - Data can be written (socket write event). +TQSocketNotifier::Write - Data can be written (socket write event). .TP -QSocketNofifier::Exception - An exception has occurred (socket exception event). +TQSocketNofifier::Exception - An exception has occurred (socket exception event). .PP The \fIsocket\fR argument is the socket identifier. .PP See also type() and socket(). -.SH "bool QSocketNotifier::isEnabled () const" +.SH "bool TQSocketNotifier::isEnabled () const" Returns TRUE if the notifier is enabled; otherwise returns FALSE. .PP See also setEnabled(). -.SH "void QSocketNotifier::setEnabled ( bool enable )\fC [virtual]\fR" +.SH "void TQSocketNotifier::setEnabled ( bool enable )\fC [virtual]\fR" Enables the notifier if \fIenable\fR is TRUE or disables it if \fIenable\fR is FALSE. .PP The notifier is enabled by default. @@ -122,17 +122,17 @@ If the notifier is enabled, it emits the activated() signal whenever a socket ev Write notifiers should normally be disabled immediately after the activated() signal has been emitted; see discussion of write notifiers in the class description above. .PP See also isEnabled() and activated(). -.SH "int QSocketNotifier::socket () const" +.SH "int TQSocketNotifier::socket () const" Returns the socket identifier specified to the constructor. .PP See also type(). -.SH "Type QSocketNotifier::type () const" -Returns the socket event type specified to the constructor: QSocketNotifier::Read, QSocketNotifier::Write, or QSocketNotifier::Exception. +.SH "Type TQSocketNotifier::type () const" +Returns the socket event type specified to the constructor: TQSocketNotifier::Read, TQSocketNotifier::Write, or TQSocketNotifier::Exception. .PP See also socket(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqsocketnotifier.html +.BR http://doc.trolltech.com/tqsocketnotifier.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqstring.3qt b/doc/man/man3/tqstring.3qt index 2a37c4463..78d03fe8d 100644 --- a/doc/man/man3/tqstring.3qt +++ b/doc/man/man3/tqstring.3qt @@ -586,10 +586,10 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "const TQString \fBoperator+\fR ( char c, const TQString & s )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQString & str )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQString & str )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQString & str )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQString & str )" .br .in -1c .SH DESCRIPTION @@ -970,7 +970,7 @@ If \fIcs\fR is TRUE (the default), the search is case sensitive; otherwise the s .fi .PP Examples: -.)l fileiconview/qfileiconview.cpp and mdi/application.cpp. +.)l fileiconview/tqfileiconview.cpp and mdi/application.cpp. .SH "int TQString::contains ( char c, bool cs = TRUE ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .SH "int TQString::contains ( const char * str, bool cs = TRUE ) const" @@ -1289,7 +1289,7 @@ Returns TRUE if the string is null; otherwise returns FALSE. A null string is al See also isEmpty() and length(). .PP Examples: -.)l i18n/main.cpp, network/ftpclient/ftpmainwindow.ui.h, and qdir/qdir.cpp. +.)l i18n/main.cpp, network/ftpclient/ftpmainwindow.ui.h, and tqdir/tqdir.cpp. .SH "const char * TQString::latin1 () const" Returns a Latin-1 representation of the string. The returned value is undefined if the string contains non-Latin-1 characters. If you want to convert strings into formats other than Unicode, see the TQTextCodec classes. .PP @@ -1300,7 +1300,7 @@ The result remains valid so long as one unmodified copy of the source string exi See also fromLatin1(), ascii(), utf8(), and local8Bit(). .PP Examples: -.)l fileiconview/qfileiconview.cpp and network/networkprotocol/nntp.cpp. +.)l fileiconview/tqfileiconview.cpp and network/networkprotocol/nntp.cpp. .SH "TQString TQString::left ( uint len ) const" Returns a substring that contains the \fIlen\fR leftmost characters of the string. .PP @@ -1341,7 +1341,7 @@ Null strings and empty strings have zero length. See also isNull() and isEmpty(). .PP Examples: -.)l dirview/dirview.cpp, fileiconview/qfileiconview.cpp, network/networkprotocol/nntp.cpp, rot13/rot13.cpp, and themes/themes.cpp. +.)l dirview/dirview.cpp, fileiconview/tqfileiconview.cpp, network/networkprotocol/nntp.cpp, rot13/rot13.cpp, and themes/themes.cpp. .SH "TQCString TQString::local8Bit () const" Returns the string encoded in a locale-specific format. On X11, this is the TQTextCodec::codecForLocale(). On Windows, it is a system-defined encoding. On Mac OS X, this always uses UTF-8 as the encoding. .PP @@ -1825,7 +1825,7 @@ If \fIlen\fR is greater than the length of the string then the whole string is r .PP See also left(), mid(), and isEmpty(). .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "TQString TQString::rightJustify ( uint width, TQChar fill = ' ', bool truncate = FALSE ) const" Returns a string of length \fIwidth\fR that contains the \fIfill\fR character followed by the string. .PP @@ -2458,10 +2458,10 @@ This is an overloaded member function, provided for convenience. It behaves esse Returns TRUE if \fIs1\fR is lexically less than \fIs2\fR; otherwise returns FALSE. The comparison is case sensitive. .PP Equivalent to compare(\fIs1\fR, \fIs2\fR) < 0. -.SH "QDataStream & operator<< ( QDataStream & s, const TQString & str )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQString & str )" Writes the string \fIstr\fR to the stream \fIs\fR. .PP -See also Format of the QDataStream operators +See also Format of the TQDataStream operators .SH "bool operator<= ( const TQString & s1, const char * s2 )" Returns TRUE if \fIs1\fR is lexically less than or equal to \fIs2\fR; otherwise returns FALSE. The comparison is case sensitive. Note that a null string is not equal to a not-null empty string. .PP @@ -2522,10 +2522,10 @@ Returns TRUE if \fIs1\fR is lexically greater than or equal to \fIs2\fR; otherwi Equivalent to compare(\fIs1\fR, \fIs2\fR) >= 0. .PP See also isNull() and isEmpty(). -.SH "QDataStream & operator>> ( QDataStream & s, TQString & str )" +.SH "TQDataStream & operator>> ( TQDataStream & s, TQString & str )" Reads a string from the stream \fIs\fR into string \fIstr\fR. .PP -See also Format of the QDataStream operators +See also Format of the TQDataStream operators .SH "SEE ALSO" .BR http://doc.trolltech.com/tqstring.html diff --git a/doc/man/man3/tqstringlist.3qt b/doc/man/man3/tqstringlist.3qt index 90f9268e9..1eea14bdf 100644 --- a/doc/man/man3/tqstringlist.3qt +++ b/doc/man/man3/tqstringlist.3qt @@ -271,7 +271,7 @@ Joins the string list into a single string with each element separated by the st See also split(). .PP Examples: -.)l fileiconview/qfileiconview.cpp and toplevel/options.ui.h. +.)l fileiconview/tqfileiconview.cpp and toplevel/options.ui.h. .SH "void TQStringList::sort ()" Sorts the list of strings in ascending case-sensitive order. .PP diff --git a/doc/man/man3/tqtextedit.3qt b/doc/man/man3/tqtextedit.3qt index 2ec5f68ea..18f80c315 100644 --- a/doc/man/man3/tqtextedit.3qt +++ b/doc/man/man3/tqtextedit.3qt @@ -567,7 +567,7 @@ Loading and saving text is achieved using setText() and text(), for example: .PP .nf .br - QFile file( fileName ); // Read the text from a file + TQFile file( fileName ); // Read the text from a file .br if ( file.open( IO_ReadOnly ) ) { .br @@ -578,7 +578,7 @@ Loading and saving text is achieved using setText() and text(), for example: } .br .br - QFile file( fileName ); // Write the text to a file + TQFile file( fileName ); // Write the text to a file .br if ( file.open( IO_WriteOnly ) ) { .br @@ -822,7 +822,7 @@ Returns the context of the text edit. The context is a path which the text edit' See also text. .PP Examples: -.)l action/application.cpp, application/application.cpp, helpviewer/helpwindow.cpp, mdi/application.cpp, and qdir/qdir.cpp. +.)l action/application.cpp, application/application.cpp, helpviewer/helpwindow.cpp, mdi/application.cpp, and tqdir/tqdir.cpp. .SH "void TQTextEdit::copy ()\fC [virtual slot]\fR" Copies any selected text (from selection 0) to the clipboard. .PP @@ -1007,7 +1007,7 @@ Returns the TQMimeSourceFactory which is being used by this text edit. See also setMimeSourceFactory(). .PP Examples: -.)l action/application.cpp, application/application.cpp, helpviewer/helpwindow.cpp, mdi/application.cpp, and qdir/qdir.cpp. +.)l action/application.cpp, application/application.cpp, helpviewer/helpwindow.cpp, mdi/application.cpp, and tqdir/tqdir.cpp. .SH "void TQTextEdit::modificationChanged ( bool m )\fC [signal]\fR" This signal is emitted when the modification status of the document has changed. If \fIm\fR is TRUE, the document was modified, otherwise the modification state has been reset to unmodified. .PP diff --git a/doc/man/man3/tqtextstream.3qt b/doc/man/man3/tqtextstream.3qt index c03c81006..41682ee1e 100644 --- a/doc/man/man3/tqtextstream.3qt +++ b/doc/man/man3/tqtextstream.3qt @@ -212,13 +212,13 @@ l - l. Function Meaning bin sets the TQTextStream to read/write binary numbers o .PP \fBWarning:\fR By default TQTextStream will automatically detect whether integers in the stream are in decimal, octal, hexadecimal or binary format when reading from the stream. In particular, a leading '0' signifies octal, i.e. the sequence "0100" will be interpreted as 64. .PP -The TQTextStream class reads and writes text; it is not appropriate for dealing with binary data (but QDataStream is). +The TQTextStream class reads and writes text; it is not appropriate for dealing with binary data (but TQDataStream is). .PP By default, output of Unicode text (i.e. TQString) is done using the local 8-bit encoding. This can be changed using the setEncoding() method. For input, the TQTextStream will auto-detect standard Unicode "byte order marked" text files; otherwise the local 8-bit encoding is used. .PP The TQIODevice is set in the constructor, or later using setDevice(). If the end of the input is reached atEnd() returns TRUE. Data can be read into variables of the appropriate type using the operator>>() overloads, or read in its entirety into a single string using read(), or read a line at a time using readLine(). Whitespace can be skipped over using skipWhiteSpace(). You can set flags for the stream using flags() or setf(). The stream also supports width(), precision() and fill(); use reset() to reset the defaults. .PP -See also QDataStream, Input/Output and Networking, and Text Related Classes. +See also TQDataStream, Input/Output and Networking, and Text Related Classes. .SS "Member Type Documentation" .SH "TQTextStream::Encoding" .TP @@ -277,7 +277,7 @@ Note that because TQString is Unicode, you should not use readRawBytes() or writ .PP This constructor is equivalent to the constructor taking a TQString* parameter. .SH "TQTextStream::TQTextStream ( TQByteArray a, int mode )" -Constructs a text stream that operates on the byte array, \fIa\fR, through an internal QBuffer device. The \fImode\fR argument is passed to the device's open() function; see TQIODevice::mode(). +Constructs a text stream that operates on the byte array, \fIa\fR, through an internal TQBuffer device. The \fImode\fR argument is passed to the device's open() function; see TQIODevice::mode(). .PP Example: .PP @@ -293,13 +293,13 @@ Example: .PP Writing data to the text stream will modify the contents of the array. The array will be expanded when data is written beyond the end of the string. .PP -Same example, using a QBuffer: +Same example, using a TQBuffer: .PP .nf .br TQByteArray array; .br - QBuffer buf( array ); + TQBuffer buf( array ); .br buf.open( IO_WriteOnly ); .br @@ -311,7 +311,7 @@ Same example, using a QBuffer: .br .fi .SH "TQTextStream::TQTextStream ( FILE * fh, int mode )" -Constructs a text stream that operates on an existing file handle \fIfh\fR through an internal QFile device. The \fImode\fR argument is passed to the device's open() function; see TQIODevice::mode(). +Constructs a text stream that operates on an existing file handle \fIfh\fR through an internal TQFile device. The \fImode\fR argument is passed to the device's open() function; see TQIODevice::mode(). .PP Note that if you create a TQTextStream \fCcout\fR or another name that is also used for another variable of a different type, some linkers may confuse the two variables, which will often cause crashes. .SH "TQTextStream::~TQTextStream ()\fC [virtual]\fR" @@ -515,7 +515,7 @@ Reads the entire stream from the current position, and returns a string containi See also TQIODevice::readLine(). .PP Examples: -.)l action/application.cpp, application/application.cpp, mdi/application.cpp, qdir/qdir.cpp, and qwerty/qwerty.cpp. +.)l action/application.cpp, application/application.cpp, mdi/application.cpp, tqdir/tqdir.cpp, and qwerty/qwerty.cpp. .SH "TQString TQTextStream::readLine ()" Reads a line from the stream and returns a string containing the text. .PP diff --git a/doc/man/man3/tqtime.3qt b/doc/man/man3/tqtime.3qt index efeea2eef..606dddc6f 100644 --- a/doc/man/man3/tqtime.3qt +++ b/doc/man/man3/tqtime.3qt @@ -106,10 +106,10 @@ All the functions in this class are reentrant when TQt is built with thread supp .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQTime & t )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQTime & t )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQTime & t )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQTime & t )" .br .in -1c .SH DESCRIPTION @@ -337,14 +337,14 @@ If \fIf\fR is TQt::LocalDate, the string format depends on the locale settings o .PP If the time is an invalid time, then TQString::null will be returned. .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const TQTime & t )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQTime & t )" Writes time \fIt\fR to the stream \fIs\fR. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, TQTime & t )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, TQTime & t )" Reads a time from the stream \fIs\fR into \fIt\fR. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/tqtime.html diff --git a/doc/man/man3/tqtooltip.3qt b/doc/man/man3/tqtooltip.3qt index c60104f8c..d02655ad7 100644 --- a/doc/man/man3/tqtooltip.3qt +++ b/doc/man/man3/tqtooltip.3qt @@ -193,7 +193,7 @@ Adds a tool tip to \fIwidget\fR. \fItext\fR is the text to be shown in the tool This is the most common entry point to the TQToolTip class; it is suitable for adding tool tips to buttons, checkboxes, comboboxes and so on. .PP Examples: -.)l helpsystem/mainwindow.cpp, qdir/qdir.cpp, scribble/scribble.cpp, and tooltip/tooltip.cpp. +.)l helpsystem/mainwindow.cpp, tqdir/tqdir.cpp, scribble/scribble.cpp, and tooltip/tooltip.cpp. .SH "void TQToolTip::add ( TQWidget * widget, const TQString & text, TQToolTipGroup * group, const TQString & longText )\fC [static]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP diff --git a/doc/man/man3/tqtranslatormessage.3qt b/doc/man/man3/tqtranslatormessage.3qt index 80eb19e7e..3748377ba 100644 --- a/doc/man/man3/tqtranslatormessage.3qt +++ b/doc/man/man3/tqtranslatormessage.3qt @@ -20,7 +20,7 @@ QTranslatorMessage \- Translator message and its properties .BI "\fBQTranslatorMessage\fR ( const char * context, const char * sourceText, const char * comment, const TQString & translation = TQString::null )" .br .ti -1c -.BI "\fBQTranslatorMessage\fR ( QDataStream & stream )" +.BI "\fBQTranslatorMessage\fR ( TQDataStream & stream )" .br .ti -1c .BI "\fBQTranslatorMessage\fR ( const QTranslatorMessage & m )" @@ -50,7 +50,7 @@ QTranslatorMessage \- Translator message and its properties .BI "enum \fBPrefix\fR { NoPrefix, Hash, HashContext, HashContextSourceText, HashContextSourceTextComment }" .br .ti -1c -.BI "void \fBwrite\fR ( QDataStream & stream, bool strip = FALSE, Prefix prefix = HashContextSourceTextComment ) const" +.BI "void \fBwrite\fR ( TQDataStream & stream, bool strip = FALSE, Prefix prefix = HashContextSourceTextComment ) const" .br .ti -1c .BI "Prefix \fBcommonPrefix\fR ( const QTranslatorMessage & m ) const" @@ -104,7 +104,7 @@ See also write() and commonPrefix(). Constructs a translator message with the extended key (0, 0, 0, 0) and TQString::null as translation. .SH "QTranslatorMessage::QTranslatorMessage ( const char * context, const char * sourceText, const char * comment, const TQString & translation = TQString::null )" Constructs an translator message with the extended key (\fIh\fR, \fIcontext\fR, \fIsourceText\fR, \fIcomment\fR), where \fIh\fR is computed from \fIsourceText\fR and \fIcomment\fR, and possibly with a \fItranslation\fR. -.SH "QTranslatorMessage::QTranslatorMessage ( QDataStream & stream )" +.SH "QTranslatorMessage::QTranslatorMessage ( TQDataStream & stream )" Constructs a translator message read from the \fIstream\fR. The resulting message may have any combination of content. .PP See also QTranslator::save(). @@ -154,7 +154,7 @@ Returns the source text of this message (e.g. "&Save"). Returns the translation of the source text (e.g., "&Sauvegarder"). .PP See also setTranslation(). -.SH "void QTranslatorMessage::write ( QDataStream & stream, bool strip = FALSE, Prefix prefix = HashContextSourceTextComment ) const" +.SH "void QTranslatorMessage::write ( TQDataStream & stream, bool strip = FALSE, Prefix prefix = HashContextSourceTextComment ) const" Writes this translator message to the \fIstream\fR. If \fIstrip\fR is FALSE (the default), all the information in the message is written. If \fIstrip\fR is TRUE, only the part of the extended key specified by \fIprefix\fR is written with the translation (HashContextSourceTextComment by default). .PP See also commonPrefix(). diff --git a/doc/man/man3/tquridrag.3qt b/doc/man/man3/tquridrag.3qt index 3becd127f..38de28a97 100644 --- a/doc/man/man3/tquridrag.3qt +++ b/doc/man/man3/tquridrag.3qt @@ -96,7 +96,7 @@ Decodes URIs from the mime source event \fIe\fR, converts them to local files if .PP Returns TRUE if \fIcontained\fR a valid list of URIs; otherwise returns FALSE. The list will be empty if no URIs were local files. .PP -Example: fileiconview/qfileiconview.cpp. +Example: fileiconview/tqfileiconview.cpp. .SH "bool TQUriDrag::decodeToUnicodeUris ( const TQMimeSource * e, TQStringList & l )\fC [static]\fR" Decodes URIs from the mime source event \fIe\fR, converts them to Unicode URIs (only useful for displaying to humans), placing them in \fIl\fR (which is first cleared). .PP diff --git a/doc/man/man3/tqurl.3qt b/doc/man/man3/tqurl.3qt index 44f0be0ee..fb465a0f8 100644 --- a/doc/man/man3/tqurl.3qt +++ b/doc/man/man3/tqurl.3qt @@ -1,5 +1,5 @@ '\" t -.TH QUrl 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQUrl 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,28 +7,28 @@ .ad l .nh .SH NAME -QUrl \- URL parser and simplifies working with URLs +TQUrl \- URL parser and simplifies working with URLs .SH SYNOPSIS -\fC#include <ntqurl.h>\fR +\fC#include <tqurl.h>\fR .PP -Inherited by QUrlOperator. +Inherited by TQUrlOperator. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQUrl\fR ()" +.BI "\fBTQUrl\fR ()" .br .ti -1c -.BI "\fBQUrl\fR ( const TQString & url )" +.BI "\fBTQUrl\fR ( const TQString & url )" .br .ti -1c -.BI "\fBQUrl\fR ( const QUrl & url )" +.BI "\fBTQUrl\fR ( const TQUrl & url )" .br .ti -1c -.BI "\fBQUrl\fR ( const QUrl & url, const TQString & relUrl, bool checkSlash = FALSE )" +.BI "\fBTQUrl\fR ( const TQUrl & url, const TQString & relUrl, bool checkSlash = FALSE )" .br .ti -1c -.BI "virtual \fB~QUrl\fR ()" +.BI "virtual \fB~TQUrl\fR ()" .br .ti -1c .BI "TQString \fBprotocol\fR () const" @@ -121,13 +121,13 @@ Inherited by QUrlOperator. .BI "TQString \fBdirPath\fR () const" .br .ti -1c -.BI "QUrl & \fBoperator=\fR ( const QUrl & url )" +.BI "TQUrl & \fBoperator=\fR ( const TQUrl & url )" .br .ti -1c -.BI "QUrl & \fBoperator=\fR ( const TQString & url )" +.BI "TQUrl & \fBoperator=\fR ( const TQString & url )" .br .ti -1c -.BI "bool \fBoperator==\fR ( const QUrl & url ) const" +.BI "bool \fBoperator==\fR ( const TQUrl & url ) const" .br .ti -1c .BI "bool \fBoperator==\fR ( const TQString & url ) const" @@ -164,11 +164,11 @@ Inherited by QUrlOperator. .br .in -1c .SH DESCRIPTION -The QUrl class provides a URL parser and simplifies working with URLs. +The TQUrl class provides a URL parser and simplifies working with URLs. .PP -The QUrl class is provided for simple work with URLs. It can parse, decode, encode, etc. +The TQUrl class is provided for simple work with URLs. It can parse, decode, encode, etc. .PP -QUrl works with the decoded path and encoded query in turn. +TQUrl works with the decoded path and encoded query in turn. .PP Example: .PP @@ -196,25 +196,25 @@ The individual parts of a URL can be set with setProtocol(), setHost(), setPort( .PP Because path is always encoded internally you must not use "%00" in the path, although this is okay (but not recommended) for the query. .PP -QUrl is normally used like this: +TQUrl is normally used like this: .PP .nf .br - QUrl url( "http://www.trolltech.com" ); + TQUrl url( "http://www.trolltech.com" ); .br // or .br - QUrl url( "file:/home/myself/Mail", "Inbox" ); + TQUrl url( "file:/home/myself/Mail", "Inbox" ); .br .fi .PP You can then access and manipulate the various parts of the URL. .PP -To make it easy to work with QUrls and TQStrings, QUrl implements the necessary cast and assignment operators so you can do following: +To make it easy to work with TQUrls and TQStrings, TQUrl implements the necessary cast and assignment operators so you can do following: .PP .nf .br - QUrl url( "http://www.trolltech.com" ); + TQUrl url( "http://www.trolltech.com" ); .br TQString s = url; .br @@ -222,32 +222,32 @@ To make it easy to work with QUrls and TQStrings, QUrl implements the necessary .br TQString s( "http://www.trolltech.com" ); .br - QUrl url( s ); + TQUrl url( s ); .br .fi .PP Use the static functions, encode() and decode() to encode or decode a URL in a string. (They operate on the string in-place.) The isRelativeUrl() static function returns TRUE if the given string is a relative URL. .PP -If you want to use a URL to work on a hierarchical structure (e.g. a local or remote filesystem), you might want to use the subclass QUrlOperator. +If you want to use a URL to work on a hierarchical structure (e.g. a local or remote filesystem), you might want to use the subclass TQUrlOperator. .PP -See also QUrlOperator, Input/Output and Networking, and Miscellaneous Classes. +See also TQUrlOperator, Input/Output and Networking, and Miscellaneous Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QUrl::QUrl ()" +.SH "TQUrl::TQUrl ()" Constructs an empty URL that is invalid. -.SH "QUrl::QUrl ( const TQString & url )" +.SH "TQUrl::TQUrl ( const TQString & url )" Constructs a URL by parsing the string \fIurl\fR. .PP If you pass a string like "/home/qt", the "file" protocol is assumed. -.SH "QUrl::QUrl ( const QUrl & url )" +.SH "TQUrl::TQUrl ( const TQUrl & url )" Copy constructor. Copies the data of \fIurl\fR. -.SH "QUrl::QUrl ( const QUrl & url, const TQString & relUrl, bool checkSlash = FALSE )" +.SH "TQUrl::TQUrl ( const TQUrl & url, const TQString & relUrl, bool checkSlash = FALSE )" Constructs an URL taking \fIurl\fR as the base (context) and \fIrelUrl\fR as a relative URL to \fIurl\fR. If \fIrelUrl\fR is not relative, \fIrelUrl\fR is taken as the new URL. .PP For example, the path of .PP .nf .br - QUrl url( "ftp://ftp.trolltech.com/qt/source", "qt-2.1.0.tar.gz" ); + TQUrl url( "ftp://ftp.trolltech.com/qt/source", "qt-2.1.0.tar.gz" ); .br .fi will be "/qt/srource/qt-2.1.0.tar.gz". @@ -256,7 +256,7 @@ On the other hand, .PP .nf .br - QUrl url( "ftp://ftp.trolltech.com/qt/source", "/usr/local" ); + TQUrl url( "ftp://ftp.trolltech.com/qt/source", "/usr/local" ); .br .fi will result in a new URL, "ftp://ftp.trolltech.com/usr/local", because "/usr/local" isn't relative. @@ -265,50 +265,50 @@ Similarly, .PP .nf .br - QUrl url( "ftp://ftp.trolltech.com/qt/source", "file:/usr/local" ); + TQUrl url( "ftp://ftp.trolltech.com/qt/source", "file:/usr/local" ); .br .fi will result in a new URL, with "/usr/local" as the path and "file" as the protocol. .PP Normally it is expected that the path of \fIurl\fR points to a directory, even if the path has no slash at the end. But if you want the constructor to handle the last part of the path as a file name if there is no slash at the end, and to let it be replaced by the file name of \fIrelUrl\fR (if it contains one), set \fIcheckSlash\fR to TRUE. -.SH "QUrl::~QUrl ()\fC [virtual]\fR" +.SH "TQUrl::~TQUrl ()\fC [virtual]\fR" Destructor. -.SH "void QUrl::addPath ( const TQString & pa )\fC [virtual]\fR" +.SH "void TQUrl::addPath ( const TQString & pa )\fC [virtual]\fR" Adds the path \fIpa\fR to the path of the URL. .PP See also setPath() and hasPath(). -.SH "bool QUrl::cdUp ()\fC [virtual]\fR" +.SH "bool TQUrl::cdUp ()\fC [virtual]\fR" Changes the directory to one directory up. .PP See also setPath(). -.SH "void QUrl::decode ( TQString & url )\fC [static]\fR" +.SH "void TQUrl::decode ( TQString & url )\fC [static]\fR" Decodes the \fIurl\fR in-place into UTF-8. For example .PP .nf .br TQString url = "http%3A//www%20trolltech%20com" .br - QUrl::decode( url ); + TQUrl::decode( url ); .br // url is now "http://www.trolltech.com" .br .fi .PP See also encode(). -.SH "TQString QUrl::dirPath () const" +.SH "TQString TQUrl::dirPath () const" Returns the directory path of the URL. This is the part of the path of the URL without the fileName(). See the documentation of fileName() for a discussion of what is handled as file name and what is handled as directory path. .PP See also setPath() and hasPath(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "void QUrl::encode ( TQString & url )\fC [static]\fR" +.SH "void TQUrl::encode ( TQString & url )\fC [static]\fR" Encodes the \fIurl\fR in-place into UTF-8. For example .PP .nf .br TQString url = http://www.trolltech.com .br - QUrl::encode( url ); + TQUrl::encode( url ); .br // url is now "http%3A//www%20trolltech%20com" .br @@ -317,161 +317,161 @@ Encodes the \fIurl\fR in-place into UTF-8. For example See also decode(). .PP Example: network/archivesearch/archivedialog.ui.h. -.SH "TQString QUrl::encodedPathAndQuery ()" +.SH "TQString TQUrl::encodedPathAndQuery ()" Returns the encoded path and query. .PP See also decode(). -.SH "TQString QUrl::fileName () const" +.SH "TQString TQUrl::fileName () const" Returns the file name of the URL. If the path of the URL doesn't have a slash at the end, the part between the last slash and the end of the path string is considered to be the file name. If the path has a slash at the end, an empty string is returned here. .PP See also setFileName(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "bool QUrl::hasHost () const" +.SH "bool TQUrl::hasHost () const" Returns TRUE if the URL contains a hostname; otherwise returns FALSE. .PP See also setHost(). -.SH "bool QUrl::hasPassword () const" +.SH "bool TQUrl::hasPassword () const" Returns TRUE if the URL contains a password; otherwise returns FALSE. .PP \fBWarning:\fR Passwords passed in URLs are normally \fIinsecure\fR; this is due to the mechanism, not because of Qt. .PP See also setPassword() and setUser(). -.SH "bool QUrl::hasPath () const" +.SH "bool TQUrl::hasPath () const" Returns TRUE if the URL contains a path; otherwise returns FALSE. .PP See also path() and setPath(). -.SH "bool QUrl::hasPort () const" +.SH "bool TQUrl::hasPort () const" Returns TRUE if the URL contains a port; otherwise returns FALSE. .PP See also setPort(). -.SH "bool QUrl::hasRef () const" +.SH "bool TQUrl::hasRef () const" Returns TRUE if the URL has a reference; otherwise returns FALSE. .PP See also setRef(). -.SH "bool QUrl::hasUser () const" +.SH "bool TQUrl::hasUser () const" Returns TRUE if the URL contains a username; otherwise returns FALSE. .PP See also setUser() and setPassword(). -.SH "TQString QUrl::host () const" +.SH "TQString TQUrl::host () const" Returns the hostname of the URL. .PP See also setHost() and hasHost(). .PP Example: network/archivesearch/archivedialog.ui.h. -.SH "bool QUrl::isLocalFile () const" +.SH "bool TQUrl::isLocalFile () const" Returns TRUE if the URL is a local file; otherwise returns FALSE. .PP -Example: qdir/qdir.cpp. -.SH "bool QUrl::isRelativeUrl ( const TQString & url )\fC [static]\fR" +Example: tqdir/tqdir.cpp. +.SH "bool TQUrl::isRelativeUrl ( const TQString & url )\fC [static]\fR" Returns TRUE if \fIurl\fR is relative; otherwise returns FALSE. -.SH "bool QUrl::isValid () const" +.SH "bool TQUrl::isValid () const" Returns TRUE if the URL is valid; otherwise returns FALSE. A URL is invalid if it cannot be parsed, for example. -.SH "QUrl::operator TQString () const" +.SH "TQUrl::operator TQString () const" Composes a string version of the URL and returns it. .PP -See also QUrl::toString(). -.SH "QUrl & QUrl::operator= ( const QUrl & url )" +See also TQUrl::toString(). +.SH "TQUrl & TQUrl::operator= ( const TQUrl & url )" Assigns the data of \fIurl\fR to this class. -.SH "QUrl & QUrl::operator= ( const TQString & url )" +.SH "TQUrl & TQUrl::operator= ( const TQString & url )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Parses \fIurl\fR and assigns the resulting data to this class. .PP If you pass a string like "/home/qt" the "file" protocol will be assumed. -.SH "bool QUrl::operator== ( const QUrl & url ) const" +.SH "bool TQUrl::operator== ( const TQUrl & url ) const" Compares this URL with \fIurl\fR and returns TRUE if they are equal; otherwise returns FALSE. -.SH "bool QUrl::operator== ( const TQString & url ) const" +.SH "bool TQUrl::operator== ( const TQString & url ) const" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Compares this URL with \fIurl\fR. \fIurl\fR is parsed first. Returns TRUE if \fIurl\fR is equal to this url; otherwise returns FALSE. -.SH "bool QUrl::parse ( const TQString & url )\fC [virtual protected]\fR" +.SH "bool TQUrl::parse ( const TQString & url )\fC [virtual protected]\fR" Parses the \fIurl\fR. -.SH "TQString QUrl::password () const" +.SH "TQString TQUrl::password () const" Returns the password of the URL. .PP \fBWarning:\fR Passwords passed in URLs are normally \fIinsecure\fR; this is due to the mechanism, not because of Qt. .PP See also setPassword() and setUser(). -.SH "TQString QUrl::path ( bool correct = TRUE ) const" +.SH "TQString TQUrl::path ( bool correct = TRUE ) const" Returns the path of the URL. If \fIcorrect\fR is TRUE, the path is cleaned (deals with too many or too few slashes, cleans things like "/../..", etc). Otherwise path() returns exactly the path that was parsed or set. .PP See also setPath() and hasPath(). .PP -Example: qdir/qdir.cpp. -.SH "int QUrl::port () const" +Example: tqdir/tqdir.cpp. +.SH "int TQUrl::port () const" Returns the port of the URL or -1 if no port has been set. .PP See also setPort(). -.SH "TQString QUrl::protocol () const" +.SH "TQString TQUrl::protocol () const" Returns the protocol of the URL. Typically, "file", "http", "ftp", etc. .PP See also setProtocol(). -.SH "TQString QUrl::query () const" +.SH "TQString TQUrl::query () const" Returns the (encoded) query of the URL. .PP See also setQuery() and decode(). -.SH "TQString QUrl::ref () const" +.SH "TQString TQUrl::ref () const" Returns the (encoded) reference of the URL. .PP See also setRef(), hasRef(), and decode(). -.SH "void QUrl::reset ()\fC [virtual protected]\fR" +.SH "void TQUrl::reset ()\fC [virtual protected]\fR" Resets all parts of the URL to their default values and invalidates it. -.SH "void QUrl::setEncodedPathAndQuery ( const TQString & pathAndQuery )\fC [virtual]\fR" +.SH "void TQUrl::setEncodedPathAndQuery ( const TQString & pathAndQuery )\fC [virtual]\fR" Parses \fIpathAndQuery\fR for a path and query and sets those values. The whole string must be encoded. .PP See also encode(). -.SH "void QUrl::setFileName ( const TQString & name )\fC [virtual]\fR" +.SH "void TQUrl::setFileName ( const TQString & name )\fC [virtual]\fR" Sets the file name of the URL to \fIname\fR. If this URL contains a fileName(), the original file name is replaced by \fIname\fR. .PP See the documentation of fileName() for a more detailed discussion of what is handled as file name and what is handled as a directory path. .PP See also fileName(). -.SH "void QUrl::setHost ( const TQString & host )\fC [virtual]\fR" +.SH "void TQUrl::setHost ( const TQString & host )\fC [virtual]\fR" Sets the hostname of the URL to \fIhost\fR. .PP See also host() and hasHost(). -.SH "void QUrl::setPassword ( const TQString & pass )\fC [virtual]\fR" +.SH "void TQUrl::setPassword ( const TQString & pass )\fC [virtual]\fR" Sets the password of the URL to \fIpass\fR. .PP \fBWarning:\fR Passwords passed in URLs are normally \fIinsecure\fR; this is due to the mechanism, not because of Qt. .PP See also password() and setUser(). -.SH "void QUrl::setPath ( const TQString & path )\fC [virtual]\fR" +.SH "void TQUrl::setPath ( const TQString & path )\fC [virtual]\fR" Sets the path of the URL to \fIpath\fR. .PP See also path() and hasPath(). -.SH "void QUrl::setPort ( int port )\fC [virtual]\fR" +.SH "void TQUrl::setPort ( int port )\fC [virtual]\fR" Sets the port of the URL to \fIport\fR. .PP See also port(). -.SH "void QUrl::setProtocol ( const TQString & protocol )\fC [virtual]\fR" +.SH "void TQUrl::setProtocol ( const TQString & protocol )\fC [virtual]\fR" Sets the protocol of the URL to \fIprotocol\fR. Typically, "file"," http", "ftp", etc. .PP See also protocol(). -.SH "void QUrl::setQuery ( const TQString & txt )\fC [virtual]\fR" +.SH "void TQUrl::setQuery ( const TQString & txt )\fC [virtual]\fR" Sets the query of the URL to \fItxt\fR. \fItxt\fR must be encoded. .PP See also query() and encode(). -.SH "void QUrl::setRef ( const TQString & txt )\fC [virtual]\fR" +.SH "void TQUrl::setRef ( const TQString & txt )\fC [virtual]\fR" Sets the reference of the URL to \fItxt\fR. \fItxt\fR must be encoded. .PP See also ref(), hasRef(), and encode(). -.SH "void QUrl::setUser ( const TQString & user )\fC [virtual]\fR" +.SH "void TQUrl::setUser ( const TQString & user )\fC [virtual]\fR" Sets the username of the URL to \fIuser\fR. .PP See also user() and setPassword(). -.SH "TQString QUrl::toString ( bool encodedPath = FALSE, bool forcePrependProtocol = TRUE ) const\fC [virtual]\fR" +.SH "TQString TQUrl::toString ( bool encodedPath = FALSE, bool forcePrependProtocol = TRUE ) const\fC [virtual]\fR" Composes a string version of the URL and returns it. If \fIencodedPath\fR is TRUE the path in the returned string is encoded. If \fIforcePrependProtocol\fR is TRUE and \fIencodedPath\fR looks like a local filename, the "file:/" protocol is also prepended. .PP See also encode() and decode(). -.SH "TQString QUrl::user () const" +.SH "TQString TQUrl::user () const" Returns the username of the URL. .PP See also setUser() and setPassword(). .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqurl.html +.BR http://doc.trolltech.com/tqurl.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqurlinfo.3qt b/doc/man/man3/tqurlinfo.3qt index 4d96e2987..5f191c023 100644 --- a/doc/man/man3/tqurlinfo.3qt +++ b/doc/man/man3/tqurlinfo.3qt @@ -1,5 +1,5 @@ '\" t -.TH QUrlInfo 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQUrlInfo 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,9 +7,9 @@ .ad l .nh .SH NAME -QUrlInfo \- Stores information about URLs +TQUrlInfo \- Stores information about URLs .SH SYNOPSIS -\fC#include <ntqurlinfo.h>\fR +\fC#include <tqurlinfo.h>\fR .PP .SS "Public Members" .in +1c @@ -17,25 +17,25 @@ QUrlInfo \- Stores information about URLs .BI "enum \fBPermissionSpec\fR { ReadOwner = 00400, WriteOwner = 00200, ExeOwner = 00100, ReadGroup = 00040, WriteGroup = 00020, ExeGroup = 00010, ReadOther = 00004, WriteOther = 00002, ExeOther = 00001 }" .br .ti -1c -.BI "\fBQUrlInfo\fR ()" +.BI "\fBTQUrlInfo\fR ()" .br .ti -1c -.BI "\fBQUrlInfo\fR ( const QUrlOperator & path, const TQString & file )" +.BI "\fBTQUrlInfo\fR ( const TQUrlOperator & path, const TQString & file )" .br .ti -1c -.BI "\fBQUrlInfo\fR ( const QUrlInfo & ui )" +.BI "\fBTQUrlInfo\fR ( const TQUrlInfo & ui )" .br .ti -1c -.BI "\fBQUrlInfo\fR ( const TQString & name, int permissions, const TQString & owner, const TQString & group, uint size, const TQDateTime & lastModified, const TQDateTime & lastRead, bool isDir, bool isFile, bool isSymLink, bool isWritable, bool isReadable, bool isExecutable )" +.BI "\fBTQUrlInfo\fR ( const TQString & name, int permissions, const TQString & owner, const TQString & group, uint size, const TQDateTime & lastModified, const TQDateTime & lastRead, bool isDir, bool isFile, bool isSymLink, bool isWritable, bool isReadable, bool isExecutable )" .br .ti -1c -.BI "\fBQUrlInfo\fR ( const QUrl & url, int permissions, const TQString & owner, const TQString & group, uint size, const TQDateTime & lastModified, const TQDateTime & lastRead, bool isDir, bool isFile, bool isSymLink, bool isWritable, bool isReadable, bool isExecutable )" +.BI "\fBTQUrlInfo\fR ( const TQUrl & url, int permissions, const TQString & owner, const TQString & group, uint size, const TQDateTime & lastModified, const TQDateTime & lastRead, bool isDir, bool isFile, bool isSymLink, bool isWritable, bool isReadable, bool isExecutable )" .br .ti -1c -.BI "QUrlInfo & \fBoperator=\fR ( const QUrlInfo & ui )" +.BI "TQUrlInfo & \fBoperator=\fR ( const TQUrlInfo & ui )" .br .ti -1c -.BI "virtual \fB~QUrlInfo\fR ()" +.BI "virtual \fB~TQUrlInfo\fR ()" .br .ti -1c .BI "virtual void \fBsetName\fR ( const TQString & name )" @@ -113,149 +113,149 @@ QUrlInfo \- Stores information about URLs .BI "bool \fBisExecutable\fR () const" .br .ti -1c -.BI "bool \fBoperator==\fR ( const QUrlInfo & i ) const" +.BI "bool \fBoperator==\fR ( const TQUrlInfo & i ) const" .br .in -1c .SS "Static Public Members" .in +1c .ti -1c -.BI "bool \fBgreaterThan\fR ( const QUrlInfo & i1, const QUrlInfo & i2, int sortBy )" +.BI "bool \fBgreaterThan\fR ( const TQUrlInfo & i1, const TQUrlInfo & i2, int sortBy )" .br .ti -1c -.BI "bool \fBlessThan\fR ( const QUrlInfo & i1, const QUrlInfo & i2, int sortBy )" +.BI "bool \fBlessThan\fR ( const TQUrlInfo & i1, const TQUrlInfo & i2, int sortBy )" .br .ti -1c -.BI "bool \fBequal\fR ( const QUrlInfo & i1, const QUrlInfo & i2, int sortBy )" +.BI "bool \fBequal\fR ( const TQUrlInfo & i1, const TQUrlInfo & i2, int sortBy )" .br .in -1c .SH DESCRIPTION -The QUrlInfo class stores information about URLs. +The TQUrlInfo class stores information about URLs. .PP This class is just a container for storing information about URLs, which is why all information must be passed in the constructor. .PP -Unless you're reimplementing a network protocol you're unlikely to create QUrlInfo objects yourself, but you may receive QUrlInfo objects from functions, e.g. QUrlOperator::info(). +Unless you're reimplementing a network protocol you're unlikely to create TQUrlInfo objects yourself, but you may receive TQUrlInfo objects from functions, e.g. TQUrlOperator::info(). .PP The information that can be retrieved includes name(), permissions(), owner(), group(), size(), lastModified(), lastRead(), isDir(), isFile(), isSymLink(), isWritable(), isReadable() and isExecutable(). .PP See also Input/Output and Networking and Miscellaneous Classes. .SS "Member Type Documentation" -.SH "QUrlInfo::PermissionSpec" +.SH "TQUrlInfo::PermissionSpec" This enum is used by the permissions() function to report the permissions of a file. .TP -\fCQUrlInfo::ReadOwner\fR - The file is readable by the owner of the file. +\fCTQUrlInfo::ReadOwner\fR - The file is readable by the owner of the file. .TP -\fCQUrlInfo::WriteOwner\fR - The file is writable by the owner of the file. +\fCTQUrlInfo::WriteOwner\fR - The file is writable by the owner of the file. .TP -\fCQUrlInfo::ExeOwner\fR - The file is executable by the owner of the file. +\fCTQUrlInfo::ExeOwner\fR - The file is executable by the owner of the file. .TP -\fCQUrlInfo::ReadGroup\fR - The file is readable by the group. +\fCTQUrlInfo::ReadGroup\fR - The file is readable by the group. .TP -\fCQUrlInfo::WriteGroup\fR - The file is writable by the group. +\fCTQUrlInfo::WriteGroup\fR - The file is writable by the group. .TP -\fCQUrlInfo::ExeGroup\fR - The file is executable by the group. +\fCTQUrlInfo::ExeGroup\fR - The file is executable by the group. .TP -\fCQUrlInfo::ReadOther\fR - The file is readable by anyone. +\fCTQUrlInfo::ReadOther\fR - The file is readable by anyone. .TP -\fCQUrlInfo::WriteOther\fR - The file is writable by anyone. +\fCTQUrlInfo::WriteOther\fR - The file is writable by anyone. .TP -\fCQUrlInfo::ExeOther\fR - The file is executable by anyone. +\fCTQUrlInfo::ExeOther\fR - The file is executable by anyone. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QUrlInfo::QUrlInfo ()" -Constructs an invalid QUrlInfo object with default values. +.SH "TQUrlInfo::TQUrlInfo ()" +Constructs an invalid TQUrlInfo object with default values. .PP See also isValid(). -.SH "QUrlInfo::QUrlInfo ( const QUrlOperator & path, const TQString & file )" -Constructs a QUrlInfo object with information about the file \fIfile\fR in the \fIpath\fR. It tries to find the information about the \fIfile\fR in the QUrlOperator \fIpath\fR. +.SH "TQUrlInfo::TQUrlInfo ( const TQUrlOperator & path, const TQString & file )" +Constructs a TQUrlInfo object with information about the file \fIfile\fR in the \fIpath\fR. It tries to find the information about the \fIfile\fR in the TQUrlOperator \fIpath\fR. .PP -If the information is not found, this constructor creates an invalid QUrlInfo, i.e. isValid() returns FALSE. You should always check if the URL info is valid before relying on the return values of any getter functions. +If the information is not found, this constructor creates an invalid TQUrlInfo, i.e. isValid() returns FALSE. You should always check if the URL info is valid before relying on the return values of any getter functions. .PP -If \fIfile\fR is empty, it defaults to the QUrlOperator \fIpath\fR, i.e. to the directory. +If \fIfile\fR is empty, it defaults to the TQUrlOperator \fIpath\fR, i.e. to the directory. .PP -See also isValid() and QUrlOperator::info(). -.SH "QUrlInfo::QUrlInfo ( const QUrlInfo & ui )" +See also isValid() and TQUrlOperator::info(). +.SH "TQUrlInfo::TQUrlInfo ( const TQUrlInfo & ui )" Copy constructor, copies \fIui\fR to this URL info object. -.SH "QUrlInfo::QUrlInfo ( const TQString & name, int permissions, const TQString & owner, const TQString & group, uint size, const TQDateTime & lastModified, const TQDateTime & lastRead, bool isDir, bool isFile, bool isSymLink, bool isWritable, bool isReadable, bool isExecutable )" -Constructs a QUrlInfo object by specifying all the URL's information. +.SH "TQUrlInfo::TQUrlInfo ( const TQString & name, int permissions, const TQString & owner, const TQString & group, uint size, const TQDateTime & lastModified, const TQDateTime & lastRead, bool isDir, bool isFile, bool isSymLink, bool isWritable, bool isReadable, bool isExecutable )" +Constructs a TQUrlInfo object by specifying all the URL's information. .PP The information that is passed is the \fIname\fR, file \fIpermissions\fR, \fIowner\fR and \fIgroup\fR and the file's \fIsize\fR. Also passed is the \fIlastModified\fR date/time and the \fIlastRead\fR date/time. Flags are also passed, specifically, \fIisDir\fR, \fIisFile\fR, \fIisSymLink\fR, \fIisWritable\fR, \fIisReadable\fR and \fIisExecutable\fR. -.SH "QUrlInfo::QUrlInfo ( const QUrl & url, int permissions, const TQString & owner, const TQString & group, uint size, const TQDateTime & lastModified, const TQDateTime & lastRead, bool isDir, bool isFile, bool isSymLink, bool isWritable, bool isReadable, bool isExecutable )" -Constructs a QUrlInfo object by specifying all the URL's information. +.SH "TQUrlInfo::TQUrlInfo ( const TQUrl & url, int permissions, const TQString & owner, const TQString & group, uint size, const TQDateTime & lastModified, const TQDateTime & lastRead, bool isDir, bool isFile, bool isSymLink, bool isWritable, bool isReadable, bool isExecutable )" +Constructs a TQUrlInfo object by specifying all the URL's information. .PP The information that is passed is the \fIurl\fR, file \fIpermissions\fR, \fIowner\fR and \fIgroup\fR and the file's \fIsize\fR. Also passed is the \fIlastModified\fR date/time and the \fIlastRead\fR date/time. Flags are also passed, specifically, \fIisDir\fR, \fIisFile\fR, \fIisSymLink\fR, \fIisWritable\fR, \fIisReadable\fR and \fIisExecutable\fR. -.SH "QUrlInfo::~QUrlInfo ()\fC [virtual]\fR" +.SH "TQUrlInfo::~TQUrlInfo ()\fC [virtual]\fR" Destroys the URL info object. .PP -The QUrlOperator object to which this URL referred (if any) is not affected. -.SH "bool QUrlInfo::equal ( const QUrlInfo & i1, const QUrlInfo & i2, int sortBy )\fC [static]\fR" -Returns TRUE if \fIi1\fR equals to \fIi2\fR; otherwise returns FALSE. The objects are compared by the value, which is specified by \fIsortBy\fR. This must be one of QDir::Name, QDir::Time or QDir::Size. -.SH "bool QUrlInfo::greaterThan ( const QUrlInfo & i1, const QUrlInfo & i2, int sortBy )\fC [static]\fR" -Returns TRUE if \fIi1\fR is greater than \fIi2\fR; otherwise returns FALSE. The objects are compared by the value, which is specified by \fIsortBy\fR. This must be one of QDir::Name, QDir::Time or QDir::Size. -.SH "TQString QUrlInfo::group () const" +The TQUrlOperator object to which this URL referred (if any) is not affected. +.SH "bool TQUrlInfo::equal ( const TQUrlInfo & i1, const TQUrlInfo & i2, int sortBy )\fC [static]\fR" +Returns TRUE if \fIi1\fR equals to \fIi2\fR; otherwise returns FALSE. The objects are compared by the value, which is specified by \fIsortBy\fR. This must be one of TQDir::Name, TQDir::Time or TQDir::Size. +.SH "bool TQUrlInfo::greaterThan ( const TQUrlInfo & i1, const TQUrlInfo & i2, int sortBy )\fC [static]\fR" +Returns TRUE if \fIi1\fR is greater than \fIi2\fR; otherwise returns FALSE. The objects are compared by the value, which is specified by \fIsortBy\fR. This must be one of TQDir::Name, TQDir::Time or TQDir::Size. +.SH "TQString TQUrlInfo::group () const" Returns the group of the URL. .PP See also isValid(). -.SH "bool QUrlInfo::isDir () const" +.SH "bool TQUrlInfo::isDir () const" Returns TRUE if the URL is a directory; otherwise returns FALSE. .PP See also isValid(). .PP Examples: .)l network/ftpclient/ftpmainwindow.ui.h and network/networkprotocol/nntp.cpp. -.SH "bool QUrlInfo::isExecutable () const" +.SH "bool TQUrlInfo::isExecutable () const" Returns TRUE if the URL is executable; otherwise returns FALSE. .PP See also isValid(). -.SH "bool QUrlInfo::isFile () const" +.SH "bool TQUrlInfo::isFile () const" Returns TRUE if the URL is a file; otherwise returns FALSE. .PP See also isValid(). -.SH "bool QUrlInfo::isReadable () const" +.SH "bool TQUrlInfo::isReadable () const" Returns TRUE if the URL is readable; otherwise returns FALSE. .PP See also isValid(). -.SH "bool QUrlInfo::isSymLink () const" +.SH "bool TQUrlInfo::isSymLink () const" Returns TRUE if the URL is a symbolic link; otherwise returns FALSE. .PP See also isValid(). -.SH "bool QUrlInfo::isValid () const" -Returns TRUE if the URL info is valid; otherwise returns FALSE. Valid means that the QUrlInfo contains real information. For example, a call to QUrlOperator::info() might return a an invalid QUrlInfo, if no information about the requested entry is available. +.SH "bool TQUrlInfo::isValid () const" +Returns TRUE if the URL info is valid; otherwise returns FALSE. Valid means that the TQUrlInfo contains real information. For example, a call to TQUrlOperator::info() might return a an invalid TQUrlInfo, if no information about the requested entry is available. .PP You should always check if the URL info is valid before relying on the values. -.SH "bool QUrlInfo::isWritable () const" +.SH "bool TQUrlInfo::isWritable () const" Returns TRUE if the URL is writable; otherwise returns FALSE. .PP See also isValid(). -.SH "TQDateTime QUrlInfo::lastModified () const" +.SH "TQDateTime TQUrlInfo::lastModified () const" Returns the last modification date of the URL. .PP See also isValid(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "TQDateTime QUrlInfo::lastRead () const" +.SH "TQDateTime TQUrlInfo::lastRead () const" Returns the date when the URL was last read. .PP See also isValid(). -.SH "bool QUrlInfo::lessThan ( const QUrlInfo & i1, const QUrlInfo & i2, int sortBy )\fC [static]\fR" -Returns TRUE if \fIi1\fR is less than \fIi2\fR; otherwise returns FALSE. The objects are compared by the value, which is specified by \fIsortBy\fR. This must be one of QDir::Name, QDir::Time or QDir::Size. -.SH "TQString QUrlInfo::name () const" +.SH "bool TQUrlInfo::lessThan ( const TQUrlInfo & i1, const TQUrlInfo & i2, int sortBy )\fC [static]\fR" +Returns TRUE if \fIi1\fR is less than \fIi2\fR; otherwise returns FALSE. The objects are compared by the value, which is specified by \fIsortBy\fR. This must be one of TQDir::Name, TQDir::Time or TQDir::Size. +.SH "TQString TQUrlInfo::name () const" Returns the file name of the URL. .PP See also isValid(). .PP Example: network/ftpclient/ftpmainwindow.ui.h. -.SH "QUrlInfo & QUrlInfo::operator= ( const QUrlInfo & ui )" -Assigns the values of \fIui\fR to this QUrlInfo object. -.SH "bool QUrlInfo::operator== ( const QUrlInfo & i ) const" -Compares this QUrlInfo with \fIi\fR and returns TRUE if they are equal; otherwise returns FALSE. -.SH "TQString QUrlInfo::owner () const" +.SH "TQUrlInfo & TQUrlInfo::operator= ( const TQUrlInfo & ui )" +Assigns the values of \fIui\fR to this TQUrlInfo object. +.SH "bool TQUrlInfo::operator== ( const TQUrlInfo & i ) const" +Compares this TQUrlInfo with \fIi\fR and returns TRUE if they are equal; otherwise returns FALSE. +.SH "TQString TQUrlInfo::owner () const" Returns the owner of the URL. .PP See also isValid(). -.SH "int QUrlInfo::permissions () const" +.SH "int TQUrlInfo::permissions () const" Returns the permissions of the URL. You can use the PermissionSpec flags to test for certain permissions. .PP See also isValid(). -.SH "void QUrlInfo::setDir ( bool b )\fC [virtual]\fR" +.SH "void TQUrlInfo::setDir ( bool b )\fC [virtual]\fR" If \fIb\fR is TRUE then the URL is set to be a directory; if \\b is FALSE then the URL is set not to be a directory (which normally means it is a file). (Note that a URL can refer to both a file and a directory even though most file systems do not support this.) .PP If you call this function for an invalid URL info, this function turns it into a valid one. @@ -263,7 +263,7 @@ If you call this function for an invalid URL info, this function turns it into a See also isValid(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "void QUrlInfo::setFile ( bool b )\fC [virtual]\fR" +.SH "void TQUrlInfo::setFile ( bool b )\fC [virtual]\fR" If \fIb\fR is TRUE then the URL is set to be a file; if \\b is FALSE then the URL is set not to be a file (which normally means it is a directory). (Note that a URL can refer to both a file and a directory even though most file systems do not support this.) .PP If you call this function for an invalid URL info, this function turns it into a valid one. @@ -271,39 +271,39 @@ If you call this function for an invalid URL info, this function turns it into a See also isValid(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "void QUrlInfo::setGroup ( const TQString & s )\fC [virtual]\fR" +.SH "void TQUrlInfo::setGroup ( const TQString & s )\fC [virtual]\fR" Specifies that the owning group of the URL is called \fIs\fR. .PP If you call this function for an invalid URL info, this function turns it into a valid one. .PP See also isValid(). -.SH "void QUrlInfo::setLastModified ( const TQDateTime & dt )\fC [virtual]\fR" +.SH "void TQUrlInfo::setLastModified ( const TQDateTime & dt )\fC [virtual]\fR" Specifies that the object the URL refers to was last modified at \fIdt\fR. .PP If you call this function for an invalid URL info, this function turns it into a valid one. .PP See also isValid(). -.SH "void QUrlInfo::setName ( const TQString & name )\fC [virtual]\fR" -Sets the name of the URL to \fIname\fR. The name is the full text, for example, "http://doc.trolltech.com/ntqurlinfo.html". +.SH "void TQUrlInfo::setName ( const TQString & name )\fC [virtual]\fR" +Sets the name of the URL to \fIname\fR. The name is the full text, for example, "http://doc.trolltech.com/tqurlinfo.html". .PP If you call this function for an invalid URL info, this function turns it into a valid one. .PP See also isValid(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "void QUrlInfo::setOwner ( const TQString & s )\fC [virtual]\fR" +.SH "void TQUrlInfo::setOwner ( const TQString & s )\fC [virtual]\fR" Specifies that the owner of the URL is called \fIs\fR. .PP If you call this function for an invalid URL info, this function turns it into a valid one. .PP See also isValid(). -.SH "void QUrlInfo::setPermissions ( int p )\fC [virtual]\fR" +.SH "void TQUrlInfo::setPermissions ( int p )\fC [virtual]\fR" Specifies that the URL has access permisions, \fIp\fR. .PP If you call this function for an invalid URL info, this function turns it into a valid one. .PP See also isValid(). -.SH "void QUrlInfo::setReadable ( bool b )\fC [virtual]\fR" +.SH "void TQUrlInfo::setReadable ( bool b )\fC [virtual]\fR" Specifies that the URL is readable if \fIb\fR is TRUE and not readable if \fIb\fR is FALSE. .PP If you call this function for an invalid URL info, this function turns it into a valid one. @@ -311,13 +311,13 @@ If you call this function for an invalid URL info, this function turns it into a See also isValid(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "void QUrlInfo::setSize ( uint size )\fC [virtual]\fR" +.SH "void TQUrlInfo::setSize ( uint size )\fC [virtual]\fR" Specifies the \fIsize\fR of the URL. .PP If you call this function for an invalid URL info, this function turns it into a valid one. .PP See also isValid(). -.SH "void QUrlInfo::setSymLink ( bool b )\fC [virtual]\fR" +.SH "void TQUrlInfo::setSymLink ( bool b )\fC [virtual]\fR" Specifies that the URL refers to a symbolic link if \fIb\fR is TRUE and that it does not if \fIb\fR is FALSE. .PP If you call this function for an invalid URL info, this function turns it into a valid one. @@ -325,7 +325,7 @@ If you call this function for an invalid URL info, this function turns it into a See also isValid(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "void QUrlInfo::setWritable ( bool b )\fC [virtual]\fR" +.SH "void TQUrlInfo::setWritable ( bool b )\fC [virtual]\fR" Specifies that the URL is writable if \fIb\fR is TRUE and not writable if \fIb\fR is FALSE. .PP If you call this function for an invalid URL info, this function turns it into a valid one. @@ -333,7 +333,7 @@ If you call this function for an invalid URL info, this function turns it into a See also isValid(). .PP Example: network/networkprotocol/nntp.cpp. -.SH "uint QUrlInfo::size () const" +.SH "uint TQUrlInfo::size () const" Returns the size of the URL. .PP See also isValid(). @@ -341,7 +341,7 @@ See also isValid(). Example: network/ftpclient/ftpmainwindow.ui.h. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqurlinfo.html +.BR http://doc.trolltech.com/tqurlinfo.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tqurloperator.3qt b/doc/man/man3/tqurloperator.3qt index 903496409..0b1ee0a9b 100644 --- a/doc/man/man3/tqurloperator.3qt +++ b/doc/man/man3/tqurloperator.3qt @@ -1,5 +1,5 @@ '\" t -.TH QUrlOperator 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- +.TH TQUrlOperator 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*- .\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the .\" license file included in the distribution for a complete license .\" statement. @@ -7,49 +7,49 @@ .ad l .nh .SH NAME -QUrlOperator \- Common operations on URLs +TQUrlOperator \- Common operations on URLs .SH SYNOPSIS -\fC#include <ntqurloperator.h>\fR +\fC#include <tqurloperator.h>\fR .PP -Inherits TQObject and QUrl. +Inherits TQObject and TQUrl. .PP .SS "Public Members" .in +1c .ti -1c -.BI "\fBQUrlOperator\fR ()" +.BI "\fBTQUrlOperator\fR ()" .br .ti -1c -.BI "\fBQUrlOperator\fR ( const TQString & url )" +.BI "\fBTQUrlOperator\fR ( const TQString & url )" .br .ti -1c -.BI "\fBQUrlOperator\fR ( const QUrlOperator & url )" +.BI "\fBTQUrlOperator\fR ( const TQUrlOperator & url )" .br .ti -1c -.BI "\fBQUrlOperator\fR ( const QUrlOperator & url, const TQString & relUrl, bool checkSlash = FALSE )" +.BI "\fBTQUrlOperator\fR ( const TQUrlOperator & url, const TQString & relUrl, bool checkSlash = FALSE )" .br .ti -1c -.BI "virtual \fB~QUrlOperator\fR ()" +.BI "virtual \fB~TQUrlOperator\fR ()" .br .ti -1c -.BI "virtual const QNetworkOperation * \fBlistChildren\fR ()" +.BI "virtual const TQNetworkOperation * \fBlistChildren\fR ()" .br .ti -1c -.BI "virtual const QNetworkOperation * \fBmkdir\fR ( const TQString & dirname )" +.BI "virtual const TQNetworkOperation * \fBmkdir\fR ( const TQString & dirname )" .br .ti -1c -.BI "virtual const QNetworkOperation * \fBremove\fR ( const TQString & filename )" +.BI "virtual const TQNetworkOperation * \fBremove\fR ( const TQString & filename )" .br .ti -1c -.BI "virtual const QNetworkOperation * \fBrename\fR ( const TQString & oldname, const TQString & newname )" +.BI "virtual const TQNetworkOperation * \fBrename\fR ( const TQString & oldname, const TQString & newname )" .br .ti -1c -.BI "virtual const QNetworkOperation * \fBget\fR ( const TQString & location = TQString::null )" +.BI "virtual const TQNetworkOperation * \fBget\fR ( const TQString & location = TQString::null )" .br .ti -1c -.BI "virtual const QNetworkOperation * \fBput\fR ( const TQByteArray & data, const TQString & location = TQString::null )" +.BI "virtual const TQNetworkOperation * \fBput\fR ( const TQByteArray & data, const TQString & location = TQString::null )" .br .ti -1c -.BI "virtual TQPtrList<QNetworkOperation> \fBcopy\fR ( const TQString & from, const TQString & to, bool move = FALSE, bool toPath = TRUE )" +.BI "virtual TQPtrList<TQNetworkOperation> \fBcopy\fR ( const TQString & from, const TQString & to, bool move = FALSE, bool toPath = TRUE )" .br .ti -1c .BI "virtual void \fBcopy\fR ( const TQStringList & files, const TQString & dest, bool move = FALSE )" @@ -64,7 +64,7 @@ Inherits TQObject and QUrl. .BI "TQString \fBnameFilter\fR () const" .br .ti -1c -.BI "virtual QUrlInfo \fBinfo\fR ( const TQString & entry ) const" +.BI "virtual TQUrlInfo \fBinfo\fR ( const TQString & entry ) const" .br .ti -1c .BI "virtual void \fBstop\fR ()" @@ -73,31 +73,31 @@ Inherits TQObject and QUrl. .SS "Signals" .in +1c .ti -1c -.BI "void \fBnewChildren\fR ( const TQValueList<QUrlInfo> & i, QNetworkOperation * op )" +.BI "void \fBnewChildren\fR ( const TQValueList<TQUrlInfo> & i, TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBfinished\fR ( QNetworkOperation * op )" +.BI "void \fBfinished\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBstart\fR ( QNetworkOperation * op )" +.BI "void \fBstart\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBcreatedDirectory\fR ( const QUrlInfo & i, QNetworkOperation * op )" +.BI "void \fBcreatedDirectory\fR ( const TQUrlInfo & i, TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBremoved\fR ( QNetworkOperation * op )" +.BI "void \fBremoved\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBitemChanged\fR ( QNetworkOperation * op )" +.BI "void \fBitemChanged\fR ( TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBdata\fR ( const TQByteArray & data, QNetworkOperation * op )" +.BI "void \fBdata\fR ( const TQByteArray & data, TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBdataTransferProgress\fR ( int bytesDone, int bytesTotal, QNetworkOperation * op )" +.BI "void \fBdataTransferProgress\fR ( int bytesDone, int bytesTotal, TQNetworkOperation * op )" .br .ti -1c -.BI "void \fBstartedNextCopy\fR ( const TQPtrList<QNetworkOperation> & lst )" +.BI "void \fBstartedNextCopy\fR ( const TQPtrList<TQNetworkOperation> & lst )" .br .ti -1c .BI "void \fBconnectionStateChanged\fR ( int state, const TQString & data )" @@ -122,7 +122,7 @@ Inherits TQObject and QUrl. .br .in -1c .SH DESCRIPTION -The QUrlOperator class provides common operations on URLs. +The TQUrlOperator class provides common operations on URLs. .PP This class operates on hierarchical structures (such as filesystems) using URLs. Its API facilitates all the common operations: <center>.nf .TS @@ -133,11 +133,11 @@ l - l. Operation Function List files listChildren() Make a directory mkdir() Rem .PP You can obtain additional information about the URL with isDir() and info(). If a directory is to be traversed using listChildren(), a name filter can be set with setNameFilter(). .PP -A QUrlOperator can be used like this, for example to download a file (and assuming that the FTP protocol is registered): +A TQUrlOperator can be used like this, for example to download a file (and assuming that the FTP protocol is registered): .PP .nf .br - QUrlOperator *op = new QUrlOperator(); + TQUrlOperator *op = new TQUrlOperator(); .br op->copy( TQString("ftp://ftp.trolltech.com/qt/source/qt-2.1.0.tar.gz"), .br @@ -145,9 +145,9 @@ A QUrlOperator can be used like this, for example to download a file (and assumi .br .fi .PP -If you want to be notified about success/failure, progress, etc., you can connect to QUrlOperator's signals, e.g. to start(), newChildren(), createdDirectory(), removed(), data(), dataTransferProgress(), startedNextCopy(), connectionStateChanged(), finished(), etc. A network operation can be stopped with stop(). +If you want to be notified about success/failure, progress, etc., you can connect to TQUrlOperator's signals, e.g. to start(), newChildren(), createdDirectory(), removed(), data(), dataTransferProgress(), startedNextCopy(), connectionStateChanged(), finished(), etc. A network operation can be stopped with stop(). .PP -The class uses the functionality of registered network protocols to perform these operations. Depending of the protocol of the URL, it uses an appropriate network protocol class for the operations. Each of the operation functions of QUrlOperator creates a QNetworkOperation object that describes the operation and puts it into the operation queue for the network protocol used. If no suitable protocol could be found (because no implementation of the necessary network protocol is registered), the URL operator emits errors. Not every protocol supports every operation, but error handling deals with this problem. +The class uses the functionality of registered network protocols to perform these operations. Depending of the protocol of the URL, it uses an appropriate network protocol class for the operations. Each of the operation functions of TQUrlOperator creates a TQNetworkOperation object that describes the operation and puts it into the operation queue for the network protocol used. If no suitable protocol could be found (because no implementation of the necessary network protocol is registered), the URL operator emits errors. Not every protocol supports every operation, but error handling deals with this problem. .PP To register the available network protocols, use the tqInitNetworkProtocols() function. The protocols currently supported are: .TP @@ -159,80 +159,80 @@ local file system. .PP For more information about the TQt Network Architecture see the TQt Network Documentation. .PP -See also QNetworkProtocol, QNetworkOperation, Input/Output and Networking, and Miscellaneous Classes. +See also TQNetworkProtocol, TQNetworkOperation, Input/Output and Networking, and Miscellaneous Classes. .SH MEMBER FUNCTION DOCUMENTATION -.SH "QUrlOperator::QUrlOperator ()" -Constructs a QUrlOperator with an empty (i.e. invalid) URL. -.SH "QUrlOperator::QUrlOperator ( const TQString & url )" -Constructs a QUrlOperator using \fIurl\fR and parses this string. +.SH "TQUrlOperator::TQUrlOperator ()" +Constructs a TQUrlOperator with an empty (i.e. invalid) URL. +.SH "TQUrlOperator::TQUrlOperator ( const TQString & url )" +Constructs a TQUrlOperator using \fIurl\fR and parses this string. .PP If you pass strings like "/home/qt" the "file" protocol is assumed. -.SH "QUrlOperator::QUrlOperator ( const QUrlOperator & url )" +.SH "TQUrlOperator::TQUrlOperator ( const TQUrlOperator & url )" Constructs a copy of \fIurl\fR. -.SH "QUrlOperator::QUrlOperator ( const QUrlOperator & url, const TQString & relUrl, bool checkSlash = FALSE )" -Constructs a QUrlOperator. The URL on which this QUrlOperator operates is constructed out of the arguments \fIurl\fR, \fIrelUrl\fR and \fIcheckSlash\fR: see the corresponding QUrl constructor for an explanation of these arguments. -.SH "QUrlOperator::~QUrlOperator ()\fC [virtual]\fR" +.SH "TQUrlOperator::TQUrlOperator ( const TQUrlOperator & url, const TQString & relUrl, bool checkSlash = FALSE )" +Constructs a TQUrlOperator. The URL on which this TQUrlOperator operates is constructed out of the arguments \fIurl\fR, \fIrelUrl\fR and \fIcheckSlash\fR: see the corresponding TQUrl constructor for an explanation of these arguments. +.SH "TQUrlOperator::~TQUrlOperator ()\fC [virtual]\fR" Destructor. -.SH "void QUrlOperator::clearEntries ()\fC [virtual protected]\fR" +.SH "void TQUrlOperator::clearEntries ()\fC [virtual protected]\fR" Clears the cache of children. -.SH "void QUrlOperator::connectionStateChanged ( int state, const TQString & data )\fC [signal]\fR" -This signal is emitted whenever the URL operator's connection state changes. \fIstate\fR describes the new state, which is a QNetworkProtocol::ConnectionState value. +.SH "void TQUrlOperator::connectionStateChanged ( int state, const TQString & data )\fC [signal]\fR" +This signal is emitted whenever the URL operator's connection state changes. \fIstate\fR describes the new state, which is a TQNetworkProtocol::ConnectionState value. .PP \fIdata\fR is a string that describes the change of the connection. This can be used to display a message to the user. -.SH "TQPtrList<QNetworkOperation> QUrlOperator::copy ( const TQString & from, const TQString & to, bool move = FALSE, bool toPath = TRUE )\fC [virtual]\fR" -Copies the file \fIfrom\fR to \fIto\fR. If \fImove\fR is TRUE, the file is moved (copied and removed). \fIfrom\fR must point to a file and \fIto\fR must point to a directory (into which \fIfrom\fR is copied) unless \fItoPath\fR is set to FALSE. If \fItoPath\fR is set to FALSE then the \fIto\fR variable is assumed to be the absolute file path (destination file path + file name). The copying is done using the get() and put() operations. If you want to be notified about the progress of the operation, connect to the dataTransferProgress() signal. Bear in mind that the get() and put() operations emit this signal through the QUrlOperator. The number of transferred bytes and the total bytes that you receive as arguments in this signal do not relate to the the whole copy operation; they relate first to the get() and then to the put() operation. Always check what type of operation the signal comes from; this is given in the signal's last argument. +.SH "TQPtrList<TQNetworkOperation> TQUrlOperator::copy ( const TQString & from, const TQString & to, bool move = FALSE, bool toPath = TRUE )\fC [virtual]\fR" +Copies the file \fIfrom\fR to \fIto\fR. If \fImove\fR is TRUE, the file is moved (copied and removed). \fIfrom\fR must point to a file and \fIto\fR must point to a directory (into which \fIfrom\fR is copied) unless \fItoPath\fR is set to FALSE. If \fItoPath\fR is set to FALSE then the \fIto\fR variable is assumed to be the absolute file path (destination file path + file name). The copying is done using the get() and put() operations. If you want to be notified about the progress of the operation, connect to the dataTransferProgress() signal. Bear in mind that the get() and put() operations emit this signal through the TQUrlOperator. The number of transferred bytes and the total bytes that you receive as arguments in this signal do not relate to the the whole copy operation; they relate first to the get() and then to the put() operation. Always check what type of operation the signal comes from; this is given in the signal's last argument. .PP At the end, finished() (with success or failure) is emitted, so check the state of the network operation object to see whether or not the operation was successful. .PP -Because a move or copy operation consists of multiple operations (get(), put() and maybe remove()), this function doesn't return a single QNetworkOperation, but rather a list of them. They are in the order: get(), put() and (if applicable) remove(). +Because a move or copy operation consists of multiple operations (get(), put() and maybe remove()), this function doesn't return a single TQNetworkOperation, but rather a list of them. They are in the order: get(), put() and (if applicable) remove(). .PP See also get() and put(). -.SH "void QUrlOperator::copy ( const TQStringList & files, const TQString & dest, bool move = FALSE )\fC [virtual]\fR" +.SH "void TQUrlOperator::copy ( const TQStringList & files, const TQString & dest, bool move = FALSE )\fC [virtual]\fR" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Copies the \fIfiles\fR to the directory \fIdest\fR. If \fImove\fR is TRUE the files are moved, not copied. \fIdest\fR must point to a directory. .PP -This function calls copy() for each entry in \fIfiles\fR in turn. You don't get a result from this function; each time a new copy begins, startedNextCopy() is emitted, with a list of QNetworkOperations that describe the new copy operation. -.SH "void QUrlOperator::createdDirectory ( const QUrlInfo & i, QNetworkOperation * op )\fC [signal]\fR" +This function calls copy() for each entry in \fIfiles\fR in turn. You don't get a result from this function; each time a new copy begins, startedNextCopy() is emitted, with a list of TQNetworkOperations that describe the new copy operation. +.SH "void TQUrlOperator::createdDirectory ( const TQUrlInfo & i, TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted when mkdir() succeeds and the directory has been created. \fIi\fR holds the information about the new directory. .PP \fIop\fR is a pointer to the operation object, which contains all the information about the operation, including the state. \fCop->arg(0)\fR holds the new directory's name. .PP -See also QNetworkOperation and QNetworkProtocol. -.SH "void QUrlOperator::data ( const TQByteArray & data, QNetworkOperation * op )\fC [signal]\fR" +See also TQNetworkOperation and TQNetworkProtocol. +.SH "void TQUrlOperator::data ( const TQByteArray & data, TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted when new \fIdata\fR has been received after calling get() or put(). \fIop\fR is a pointer to the operation object which contains all the information about the operation, including the state. \fCop->arg(0)\fR holds the name of the file whose data is retrieved and op->rawArg(1) holds the (raw) data. .PP -See also QNetworkOperation and QNetworkProtocol. -.SH "void QUrlOperator::dataTransferProgress ( int bytesDone, int bytesTotal, QNetworkOperation * op )\fC [signal]\fR" +See also TQNetworkOperation and TQNetworkProtocol. +.SH "void TQUrlOperator::dataTransferProgress ( int bytesDone, int bytesTotal, TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted during data transfer (using put() or get()). \fIbytesDone\fR specifies how many bytes of \fIbytesTotal\fR have been transferred. More information about the operation is stored in \fIop\fR, a pointer to the network operation that is processed. \fIbytesTotal\fR may be -1, which means that the total number of bytes is not known. .PP -See also QNetworkOperation and QNetworkProtocol. -.SH "void QUrlOperator::deleteNetworkProtocol ()\fC [protected]\fR" +See also TQNetworkOperation and TQNetworkProtocol. +.SH "void TQUrlOperator::deleteNetworkProtocol ()\fC [protected]\fR" Deletes the currently used network protocol. -.SH "void QUrlOperator::finished ( QNetworkOperation * op )\fC [signal]\fR" +.SH "void TQUrlOperator::finished ( TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted when an operation of some sort finishes, whether with success or failure. \fIop\fR is a pointer to the operation object, which contains all the information, including the state, of the operation which has been finished. Check the state and error code of the operation object to see whether or not the operation was successful. .PP -See also QNetworkOperation and QNetworkProtocol. -.SH "const QNetworkOperation * QUrlOperator::get ( const TQString & location = TQString::null )\fC [virtual]\fR" -Tells the network protocol to get data from \fIlocation\fR or, if this is TQString::null, to get data from the location to which this URL points (see QUrl::fileName() and QUrl::encodedPathAndQuery()). What happens then depends on the network protocol. The data() signal is emitted when data comes in. Because it's unlikely that all data will come in at once, it is common for multiple data() signals to be emitted. The dataTransferProgress() signal is emitted while processing the operation. At the end, finished() (with success or failure) is emitted, so check the state of the network operation object to see whether or not the operation was successful. +See also TQNetworkOperation and TQNetworkProtocol. +.SH "const TQNetworkOperation * TQUrlOperator::get ( const TQString & location = TQString::null )\fC [virtual]\fR" +Tells the network protocol to get data from \fIlocation\fR or, if this is TQString::null, to get data from the location to which this URL points (see TQUrl::fileName() and TQUrl::encodedPathAndQuery()). What happens then depends on the network protocol. The data() signal is emitted when data comes in. Because it's unlikely that all data will come in at once, it is common for multiple data() signals to be emitted. The dataTransferProgress() signal is emitted while processing the operation. At the end, finished() (with success or failure) is emitted, so check the state of the network operation object to see whether or not the operation was successful. .PP -If \fIlocation\fR is TQString::null, the path of this QUrlOperator should point to a file when you use this operation. If \fIlocation\fR is not empty, it can be a relative URL (a child of the path to which the QUrlOperator points) or an absolute URL. +If \fIlocation\fR is TQString::null, the path of this TQUrlOperator should point to a file when you use this operation. If \fIlocation\fR is not empty, it can be a relative URL (a child of the path to which the TQUrlOperator points) or an absolute URL. .PP For example, to get a web page you might do something like this: .PP .nf .br - QUrlOperator op( "http://www.whatever.org/cgi-bin/search.pl?cmd=Hello" ); + TQUrlOperator op( "http://www.whatever.org/cgi-bin/search.pl?cmd=Hello" ); .br op.get(); .br .fi .PP -For most other operations, the path of the QUrlOperator must point to a directory. If you want to download a file you could do the following: +For most other operations, the path of the TQUrlOperator must point to a directory. If you want to download a file you could do the following: .PP .nf .br - QUrlOperator op( "ftp://ftp.whatever.org/pub" ); + TQUrlOperator op( "ftp://ftp.whatever.org/pub" ); .br // do some other stuff like op.listChildren() or op.mkdir( "new_dir" ) .br @@ -246,7 +246,7 @@ This will get the data of ftp://ftp.whatever.org/pub/a_file.txt. .PP .nf .br - QUrlOperator op( "http://www.whatever.org/cgi-bin" ); + TQUrlOperator op( "http://www.whatever.org/cgi-bin" ); .br op.get( "search.pl?cmd=Hello" ); // WRONG! .br @@ -255,56 +255,56 @@ This will get the data of ftp://ftp.whatever.org/pub/a_file.txt. If \fIlocation\fR is not empty and relative it must not contain any queries or references, just the name of a child. So if you need to specify a query or reference, do it as shown in the first example or specify the full URL (such as http://www.whatever.org/cgi-bin/search.pl?cmd=Hello) as \fIlocation\fR. .PP See also copy(). -.SH "void QUrlOperator::getNetworkProtocol ()\fC [protected]\fR" +.SH "void TQUrlOperator::getNetworkProtocol ()\fC [protected]\fR" Finds a network protocol for the URL and deletes the old network protocol. -.SH "QUrlInfo QUrlOperator::info ( const TQString & entry ) const\fC [virtual]\fR" -Returns the URL information for the child \fIentry\fR, or returns an empty QUrlInfo object if there is no information available about \fIentry\fR. Information about \fIentry\fR is only available after a successfully finished listChildren() operation. -.SH "bool QUrlOperator::isDir ( bool * ok = 0 )\fC [virtual]\fR" +.SH "TQUrlInfo TQUrlOperator::info ( const TQString & entry ) const\fC [virtual]\fR" +Returns the URL information for the child \fIentry\fR, or returns an empty TQUrlInfo object if there is no information available about \fIentry\fR. Information about \fIentry\fR is only available after a successfully finished listChildren() operation. +.SH "bool TQUrlOperator::isDir ( bool * ok = 0 )\fC [virtual]\fR" Returns TRUE if the URL is a directory; otherwise returns FALSE. This may not always work correctly, if the protocol of the URL is something other than file (local filesystem). If you pass a bool pointer as the \fIok\fR argument, \fI*ok\fR is set to TRUE if the result of this function is known to be correct, and to FALSE otherwise. -.SH "void QUrlOperator::itemChanged ( QNetworkOperation * op )\fC [signal]\fR" +.SH "void TQUrlOperator::itemChanged ( TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted whenever a file which is a child of the URL has been changed, for example by successfully calling rename(). \fIop\fR is a pointer to the operation object which contains all the information about the operation, including the state. \fCop->arg(0)\fR holds the original file name and \fCop->arg(1)\fR holds the new file name (if it was changed). .PP -See also QNetworkOperation and QNetworkProtocol. -.SH "const QNetworkOperation * QUrlOperator::listChildren ()\fC [virtual]\fR" +See also TQNetworkOperation and TQNetworkProtocol. +.SH "const TQNetworkOperation * TQUrlOperator::listChildren ()\fC [virtual]\fR" Starts listing the children of this URL (e.g. the files in the directory). The start() signal is emitted before the first entry is listed and finished() is emitted after the last one. The newChildren() signal is emitted for each list of new entries. If an error occurs, the signal finished() is emitted, so be sure to check the state of the network operation pointer. .PP -Because the operation may not be executed immediately, a pointer to the QNetworkOperation object created by this function is returned. This object contains all the data about the operation and is used to refer to this operation later (e.g. in the signals that are emitted by the QUrlOperator). The return value can also be 0 if the operation object couldn't be created. +Because the operation may not be executed immediately, a pointer to the TQNetworkOperation object created by this function is returned. This object contains all the data about the operation and is used to refer to this operation later (e.g. in the signals that are emitted by the TQUrlOperator). The return value can also be 0 if the operation object couldn't be created. .PP -The path of this QUrlOperator must to point to a directory (because the children of this directory will be listed), not to a file. -.SH "const QNetworkOperation * QUrlOperator::mkdir ( const TQString & dirname )\fC [virtual]\fR" +The path of this TQUrlOperator must to point to a directory (because the children of this directory will be listed), not to a file. +.SH "const TQNetworkOperation * TQUrlOperator::mkdir ( const TQString & dirname )\fC [virtual]\fR" Tries to create a directory (child) with the name \fIdirname\fR. If it is successful, a newChildren() signal with the new child is emitted, and the createdDirectory() signal with the information about the new child is also emitted. The finished() signal (with success or failure) is emitted after the operation has been processed, so check the state of the network operation object to see whether or not the operation was successful. .PP -Because the operation will not be executed immediately, a pointer to the QNetworkOperation object created by this function is returned. This object contains all the data about the operation and is used to refer to this operation later (e.g. in the signals that are emitted by the QUrlOperator). The return value can also be 0 if the operation object couldn't be created. +Because the operation will not be executed immediately, a pointer to the TQNetworkOperation object created by this function is returned. This object contains all the data about the operation and is used to refer to this operation later (e.g. in the signals that are emitted by the TQUrlOperator). The return value can also be 0 if the operation object couldn't be created. .PP -The path of this QUrlOperator must to point to a directory (not a file) because the new directory will be created in this path. -.SH "TQString QUrlOperator::nameFilter () const" +The path of this TQUrlOperator must to point to a directory (not a file) because the new directory will be created in this path. +.SH "TQString TQUrlOperator::nameFilter () const" Returns the name filter of the URL. .PP -See also QUrlOperator::setNameFilter() and QDir::nameFilter(). -.SH "void QUrlOperator::newChildren ( const TQValueList<QUrlInfo> & i, QNetworkOperation * op )\fC [signal]\fR" +See also TQUrlOperator::setNameFilter() and TQDir::nameFilter(). +.SH "void TQUrlOperator::newChildren ( const TQValueList<TQUrlInfo> & i, TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted after listChildren() was called and new children (i.e. files) have been read from a list of files. \fIi\fR holds the information about the new files. \fIop\fR is a pointer to the operation object which contains all the information about the operation, including the state. .PP -See also QNetworkOperation and QNetworkProtocol. -.SH "const QNetworkOperation * QUrlOperator::put ( const TQByteArray & data, const TQString & location = TQString::null )\fC [virtual]\fR" +See also TQNetworkOperation and TQNetworkProtocol. +.SH "const TQNetworkOperation * TQUrlOperator::put ( const TQByteArray & data, const TQString & location = TQString::null )\fC [virtual]\fR" This function tells the network protocol to put \fIdata\fR in \fIlocation\fR. If \fIlocation\fR is empty (TQString::null), it puts the \fIdata\fR in the location to which the URL points. What happens depends on the network protocol. Depending on the network protocol, some data might come back after putting data, in which case the data() signal is emitted. The dataTransferProgress() signal is emitted during processing of the operation. At the end, finished() (with success or failure) is emitted, so check the state of the network operation object to see whether or not the operation was successful. .PP -If \fIlocation\fR is TQString::null, the path of this QUrlOperator should point to a file when you use this operation. If \fIlocation\fR is not empty, it can be a relative (a child of the path to which the QUrlOperator points) or an absolute URL. +If \fIlocation\fR is TQString::null, the path of this TQUrlOperator should point to a file when you use this operation. If \fIlocation\fR is not empty, it can be a relative (a child of the path to which the TQUrlOperator points) or an absolute URL. .PP For putting some data to a file you can do the following: .PP .nf .br - QUrlOperator op( "ftp://ftp.whatever.com/home/me/filename.dat" ); + TQUrlOperator op( "ftp://ftp.whatever.com/home/me/filename.dat" ); .br op.put( data ); .br .fi .PP -For most other operations, the path of the QUrlOperator must point to a directory. If you want to upload data to a file you could do the following: +For most other operations, the path of the TQUrlOperator must point to a directory. If you want to upload data to a file you could do the following: .PP .nf .br - QUrlOperator op( "ftp://ftp.whatever.com/home/me" ); + TQUrlOperator op( "ftp://ftp.whatever.com/home/me" ); .br // do some other stuff like op.listChildren() or op.mkdir( "new_dir" ) .br @@ -315,46 +315,46 @@ For most other operations, the path of the QUrlOperator must point to a director This will upload the data to ftp://ftp.whatever.com/home/me/filename.dat. .PP See also copy(). -.SH "const QNetworkOperation * QUrlOperator::remove ( const TQString & filename )\fC [virtual]\fR" +.SH "const TQNetworkOperation * TQUrlOperator::remove ( const TQString & filename )\fC [virtual]\fR" Tries to remove the file (child) \fIfilename\fR. If it succeeds the removed() signal is emitted. finished() (with success or failure) is also emitted after the operation has been processed, so check the state of the network operation object to see whether or not the operation was successful. .PP -Because the operation will not be executed immediately, a pointer to the QNetworkOperation object created by this function is returned. This object contains all the data about the operation and is used to refer to this operation later (e.g. in the signals that are emitted by the QUrlOperator). The return value can also be 0 if the operation object couldn't be created. +Because the operation will not be executed immediately, a pointer to the TQNetworkOperation object created by this function is returned. This object contains all the data about the operation and is used to refer to this operation later (e.g. in the signals that are emitted by the TQUrlOperator). The return value can also be 0 if the operation object couldn't be created. .PP -The path of this QUrlOperator must point to a directory; because if \fIfilename\fR is relative, it will try to remove it in this directory. -.SH "void QUrlOperator::removed ( QNetworkOperation * op )\fC [signal]\fR" +The path of this TQUrlOperator must point to a directory; because if \fIfilename\fR is relative, it will try to remove it in this directory. +.SH "void TQUrlOperator::removed ( TQNetworkOperation * op )\fC [signal]\fR" This signal is emitted when remove() has been succesful and the file has been removed. .PP \fIop\fR is a pointer to the operation object which contains all the information about the operation, including the state. \fCop->arg(0)\fR holds the name of the file that was removed. .PP -See also QNetworkOperation and QNetworkProtocol. -.SH "const QNetworkOperation * QUrlOperator::rename ( const TQString & oldname, const TQString & newname )\fC [virtual]\fR" +See also TQNetworkOperation and TQNetworkProtocol. +.SH "const TQNetworkOperation * TQUrlOperator::rename ( const TQString & oldname, const TQString & newname )\fC [virtual]\fR" Tries to rename the file (child) called \fIoldname\fR to \fInewname\fR. If it succeeds, the itemChanged() signal is emitted. finished() (with success or failure) is also emitted after the operation has been processed, so check the state of the network operation object to see whether or not the operation was successful. .PP -Because the operation may not be executed immediately, a pointer to the QNetworkOperation object created by this function is returned. This object contains all the data about the operation and is used to refer to this operation later (e.g. in the signals that are emitted by the QUrlOperator). The return value can also be 0 if the operation object couldn't be created. +Because the operation may not be executed immediately, a pointer to the TQNetworkOperation object created by this function is returned. This object contains all the data about the operation and is used to refer to this operation later (e.g. in the signals that are emitted by the TQUrlOperator). The return value can also be 0 if the operation object couldn't be created. .PP -This path of this QUrlOperator must to point to a directory because \fIoldname\fR and \fInewname\fR are handled relative to this directory. -.SH "void QUrlOperator::setNameFilter ( const TQString & nameFilter )\fC [virtual]\fR" +This path of this TQUrlOperator must to point to a directory because \fIoldname\fR and \fInewname\fR are handled relative to this directory. +.SH "void TQUrlOperator::setNameFilter ( const TQString & nameFilter )\fC [virtual]\fR" Sets the name filter of the URL to \fInameFilter\fR. .PP -See also QDir::setNameFilter(). -.SH "void QUrlOperator::start ( QNetworkOperation * op )\fC [signal]\fR" +See also TQDir::setNameFilter(). +.SH "void TQUrlOperator::start ( TQNetworkOperation * op )\fC [signal]\fR" Some operations (such as listChildren()) emit this signal when they start processing the operation. \fIop\fR is a pointer to the operation object which contains all the information about the operation, including the state. .PP -See also QNetworkOperation and QNetworkProtocol. -.SH "void QUrlOperator::startedNextCopy ( const TQPtrList<QNetworkOperation> & lst )\fC [signal]\fR" -This signal is emitted if copy() starts a new copy operation. \fIlst\fR contains all QNetworkOperations related to this copy operation. +See also TQNetworkOperation and TQNetworkProtocol. +.SH "void TQUrlOperator::startedNextCopy ( const TQPtrList<TQNetworkOperation> & lst )\fC [signal]\fR" +This signal is emitted if copy() starts a new copy operation. \fIlst\fR contains all TQNetworkOperations related to this copy operation. .PP See also copy(). -.SH "void QUrlOperator::stop ()\fC [virtual]\fR" -Stops the current network operation and removes all this QUrlOperator's waiting network operations. +.SH "void TQUrlOperator::stop ()\fC [virtual]\fR" +Stops the current network operation and removes all this TQUrlOperator's waiting network operations. .SH RELATED FUNCTION DOCUMENTATION .SH "void tqInitNetworkProtocols ()" -This function registers the network protocols for FTP and HTTP. You must call this function before you use QUrlOperator for these protocols. +This function registers the network protocols for FTP and HTTP. You must call this function before you use TQUrlOperator for these protocols. .PP -This function is declared in ntqnetwork.h. +This function is declared in tqnetwork.h. .SH "SEE ALSO" -.BR http://doc.trolltech.com/ntqurloperator.html +.BR http://doc.trolltech.com/tqurloperator.html .BR http://www.trolltech.com/faq/tech.html .SH COPYRIGHT Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the diff --git a/doc/man/man3/tquuid.3qt b/doc/man/man3/tquuid.3qt index c9cb61008..61dfaa2b9 100644 --- a/doc/man/man3/tquuid.3qt +++ b/doc/man/man3/tquuid.3qt @@ -73,10 +73,10 @@ All the functions in this class are reentrant when TQt is built with thread supp .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QUuid & id )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QUuid & id )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QUuid & id )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QUuid & id )" .br .in -1c .SH DESCRIPTION @@ -172,9 +172,9 @@ Returns the version of the UUID, if the UUID is of the DCE variant; otherwise re .PP See also variant(). .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QUuid & id )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QUuid & id )" Writes the uuid \fIid\fR to the datastream \fIs\fR. -.SH "QDataStream & operator>> ( QDataStream & s, QUuid & id )" +.SH "TQDataStream & operator>> ( TQDataStream & s, QUuid & id )" Reads uuid from from the stream \fIs\fR into \fIid\fR. .SH "SEE ALSO" diff --git a/doc/man/man3/tqvaluelist.3qt b/doc/man/man3/tqvaluelist.3qt index 78b1ed236..63f54cc7d 100644 --- a/doc/man/man3/tqvaluelist.3qt +++ b/doc/man/man3/tqvaluelist.3qt @@ -219,10 +219,10 @@ Inherited by TQCanvasItemList, TQStringList, and TQValueStack. .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, TQValueList<T> & l )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQValueList<T> & l )" .br .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const TQValueList<T> & l )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQValueList<T> & l )" .br .in -1c .SH DESCRIPTION @@ -510,7 +510,7 @@ Returns the number of items in the list. See also isEmpty(). .PP Examples: -.)l chart/element.cpp, fileiconview/qfileiconview.cpp, and table/statistics/statistics.cpp. +.)l chart/element.cpp, fileiconview/tqfileiconview.cpp, and table/statistics/statistics.cpp. .SH "bool TQValueList::empty () const" Returns TRUE if the list contains no items; otherwise returns FALSE. .PP @@ -722,11 +722,11 @@ This function is provided for STL compatibility. It is equivalent to count(). .PP See also empty(). .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const TQValueList<T> & l )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const TQValueList<T> & l )" This is an overloaded member function, provided for convenience. It behaves essentially like the above function. .PP Writes a list, \fIl\fR, to the stream \fIs\fR. The type T stored in the list must implement the streaming operator. -.SH "QDataStream & operator>> ( QDataStream & s, TQValueList<T> & l )" +.SH "TQDataStream & operator>> ( TQDataStream & s, TQValueList<T> & l )" Reads a list, \fIl\fR, from the stream \fIs\fR. The type T stored in the list must implement the streaming operator. diff --git a/doc/man/man3/tqvariant.3qt b/doc/man/man3/tqvariant.3qt index 01fdc28ca..37125f393 100644 --- a/doc/man/man3/tqvariant.3qt +++ b/doc/man/man3/tqvariant.3qt @@ -26,7 +26,7 @@ QVariant \- Acts like a union for the most common TQt data types .BI "\fBQVariant\fR ( const QVariant & p )" .br .ti -1c -.BI "\fBQVariant\fR ( QDataStream & s )" +.BI "\fBQVariant\fR ( TQDataStream & s )" .br .ti -1c .BI "\fBQVariant\fR ( const TQString & val )" @@ -415,7 +415,7 @@ Here is some example code to demonstrate the use of QVariant: .PP .nf .br - QDataStream out(...); + TQDataStream out(...); .br QVariant v(123); // The variant now contains an int .br @@ -435,7 +435,7 @@ Here is some example code to demonstrate the use of QVariant: .br ... .br - QDataStream in(...); // (opening the previously written stream) + TQDataStream in(...); // (opening the previously written stream) .br in >> v; // Reads an Int variant .br @@ -556,7 +556,7 @@ Constructs a new variant with a floating point value, \fIval\fR. Constructs a new variant with a size policy value, \fIval\fR. .SH "QVariant::QVariant ( const QVariant & p )" Constructs a copy of the variant, \fIp\fR, passed as the argument to this constructor. Usually this is a deep copy, but a shallow copy is made if the stored data type is explicitly shared, as e.g. TQImage is. -.SH "QVariant::QVariant ( QDataStream & s )" +.SH "QVariant::QVariant ( TQDataStream & s )" Reads the variant from the data stream, \fIs\fR. .SH "QVariant::QVariant ( const TQString & val )" Constructs a new variant with a string value, \fIval\fR. diff --git a/doc/man/man3/tqwidget.3qt b/doc/man/man3/tqwidget.3qt index 61d813816..38ed2567d 100644 --- a/doc/man/man3/tqwidget.3qt +++ b/doc/man/man3/tqwidget.3qt @@ -2035,7 +2035,7 @@ Sets both the minimum and maximum heights of the widget to \fIh\fR without chang See also sizeHint, minimumSize, maximumSize, and setFixedSize(). .PP Examples: -.)l fonts/simple-qfont-demo/viewer.cpp, layout/layout.cpp, qdir/qdir.cpp, and showimg/showimg.cpp. +.)l fonts/simple-qfont-demo/viewer.cpp, layout/layout.cpp, tqdir/tqdir.cpp, and showimg/showimg.cpp. .SH "void TQWidget::setFixedSize ( const TQSize & s )" Sets both the minimum and maximum sizes of the widget to \fIs\fR, thereby preventing it from ever growing or shrinking. .PP @@ -2050,7 +2050,7 @@ Sets both the minimum and maximum width of the widget to \fIw\fR without changin See also sizeHint, minimumSize, maximumSize, and setFixedSize(). .PP Examples: -.)l progressbar/progressbar.cpp and qdir/qdir.cpp. +.)l progressbar/progressbar.cpp and tqdir/tqdir.cpp. .SH "void TQWidget::setFocus ()\fC [virtual slot]\fR" Gives the keyboard input focus to this widget (or its focus proxy) if this widget or one of its parents is the active window. .PP @@ -2295,7 +2295,7 @@ Non-spontaneous show events are sent to widgets immediately before they are show .PP See also event() and QShowEvent. .PP -Example: qdir/qdir.cpp. +Example: tqdir/tqdir.cpp. .SH "void TQWidget::showFullScreen ()\fC [slot]\fR" Shows the widget in full-screen mode. .PP diff --git a/doc/man/man3/tqwmatrix.3qt b/doc/man/man3/tqwmatrix.3qt index 211b8b9c5..2e9353d45 100644 --- a/doc/man/man3/tqwmatrix.3qt +++ b/doc/man/man3/tqwmatrix.3qt @@ -119,10 +119,10 @@ QWMatrix \- 2D transformations of a coordinate system .SH RELATED FUNCTION DOCUMENTATION .in +1c .ti -1c -.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QWMatrix & m )" +.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const QWMatrix & m )" .br .ti -1c -.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QWMatrix & m )" +.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, QWMatrix & m )" .br .in -1c .SH DESCRIPTION @@ -408,7 +408,7 @@ Returns a reference to the matrix. See also translate(), shear(), and rotate(). .PP Examples: -.)l canvas/canvas.cpp, fileiconview/qfileiconview.cpp, movies/main.cpp, qmag/qmag.cpp, showimg/showimg.cpp, and xform/xform.cpp. +.)l canvas/canvas.cpp, fileiconview/tqfileiconview.cpp, movies/main.cpp, qmag/qmag.cpp, showimg/showimg.cpp, and xform/xform.cpp. .SH "void QWMatrix::setMatrix ( double m11, double m12, double m21, double m22, double dx, double dy )" Sets the matrix elements to the specified values, \fIm11\fR, \fIm12\fR, \fIm21\fR, \fIm22\fR, \fIdx\fR and \fIdy\fR. .SH "void QWMatrix::setTransformationMode ( QWMatrix::TransformationMode m )\fC [static]\fR" @@ -438,14 +438,14 @@ See also scale(), shear(), and rotate(). Examples: .)l canvas/canvas.cpp, drawdemo/drawdemo.cpp, t14/cannon.cpp, and xform/xform.cpp. .SH RELATED FUNCTION DOCUMENTATION -.SH "QDataStream & operator<< ( QDataStream & s, const QWMatrix & m )" +.SH "TQDataStream & operator<< ( TQDataStream & s, const QWMatrix & m )" Writes the matrix \fIm\fR to the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. -.SH "QDataStream & operator>> ( QDataStream & s, QWMatrix & m )" +See also Format of the TQDataStream operators. +.SH "TQDataStream & operator>> ( TQDataStream & s, QWMatrix & m )" Reads the matrix \fIm\fR from the stream \fIs\fR and returns a reference to the stream. .PP -See also Format of the QDataStream operators. +See also Format of the TQDataStream operators. .SH "SEE ALSO" .BR http://doc.trolltech.com/ntqwmatrix.html diff --git a/doc/man/man3/tqxmlinputsource.3qt b/doc/man/man3/tqxmlinputsource.3qt index 2a15ba3a6..d540ba12d 100644 --- a/doc/man/man3/tqxmlinputsource.3qt +++ b/doc/man/man3/tqxmlinputsource.3qt @@ -22,7 +22,7 @@ All the functions in this class are reentrant when TQt is built with thread supp .BI "\fBTQXmlInputSource\fR ( TQIODevice * dev )" .br .ti -1c -.BI "TQXmlInputSource ( QFile & file ) \fI(obsolete)\fR" +.BI "TQXmlInputSource ( TQFile & file ) \fI(obsolete)\fR" .br .ti -1c .BI "TQXmlInputSource ( TQTextStream & stream ) \fI(obsolete)\fR" @@ -80,7 +80,7 @@ See also setData(). Constructs an input source and gets the data from device \fIdev\fR. If \fIdev\fR is not open, it is opened in read-only mode. If \fIdev\fR is 0 or it is not possible to read from the device, the input source will contain no data. .PP See also setData(), fetchData(), and TQIODevice. -.SH "TQXmlInputSource::TQXmlInputSource ( QFile & file )" +.SH "TQXmlInputSource::TQXmlInputSource ( TQFile & file )" \fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code. .PP Constructs an input source and gets the data from the file \fIfile\fR. If the file cannot be read the input source is empty. diff --git a/doc/man/man3/tqxmlsimplereader.3qt b/doc/man/man3/tqxmlsimplereader.3qt index 524a60142..131493a8c 100644 --- a/doc/man/man3/tqxmlsimplereader.3qt +++ b/doc/man/man3/tqxmlsimplereader.3qt @@ -68,7 +68,7 @@ If \fIincremental\fR is TRUE, the parser does not return FALSE when it reaches t .PP If \fIincremental\fR is FALSE, this function behaves like the normal parse function, i.e. it returns FALSE when the end of input is reached without reaching the end of the XML file and the parsing cannot be continued. .PP -See also parseContinue() and QSocket. +See also parseContinue() and TQSocket. .PP Examples: .)l xml/tagreader-with-features/tagreader.cpp and xml/tagreader/tagreader.cpp. |