summaryrefslogtreecommitdiffstats
path: root/doc/threads.doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/threads.doc')
-rw-r--r--doc/threads.doc36
1 files changed, 18 insertions, 18 deletions
diff --git a/doc/threads.doc b/doc/threads.doc
index f6226c03f..951656b7b 100644
--- a/doc/threads.doc
+++ b/doc/threads.doc
@@ -208,32 +208,32 @@ Normally, the programmer would like to include some information in the
event sent to the widget. See the documentation for QCustomEvent for
more information on user-defined events.
-\section1 Threads and QObject subclasses
+\section1 Threads and TQObject subclasses
-The QObject class itself is \e reentrant. However, certain rules
+The TQObject class itself is \e reentrant. However, certain rules
apply when creating and using QObjects in a thread that is not the GUI
thread.
\list 1
-\i \e None of the QObject based classes included in the TQt library are
-\e reentrant. This includes all widgets (e.g. QWidget and
+\i \e None of the TQObject based classes included in the TQt library are
+\e reentrant. This includes all widgets (e.g. TQWidget and
subclasses), OS kernel classes (e.g. QProcess, QAccel, QTimer), and
all networking classes (e.g. QSocket, QDns).
-\i QObject and all of its subclasses are \e not \e thread-safe. This
+\i TQObject and all of its subclasses are \e not \e thread-safe. This
includes the entire event delivery system. It is important to
-remember that the GUI thread may be delivering events to your QObject
+remember that the GUI thread may be delivering events to your TQObject
subclass while you are accessing the object from another thread. If
-you are using QObject in a thread that is not the GUI thread, and you
+you are using TQObject in a thread that is not the GUI thread, and you
are handling events sent to this object, you \e must protect all
access to your data with a mutex; otherwise you may experience crashes
or other undesired behavior.
-\i As a corollary to the above, deleting a QObject while pending
+\i As a corollary to the above, deleting a TQObject while pending
events are waiting to be delivered can cause a crash. You must not
-delete the QObject directly from a thread that is not the GUI thread.
-Use the QObject::deleteLater() method instead, which will cause the
+delete the TQObject directly from a thread that is not the GUI thread.
+Use the TQObject::deleteLater() method instead, which will cause the
event loop to delete the object after all pending events have been
delivered to the object.
@@ -259,7 +259,7 @@ are examples of simple GUI operations:
QPainter p;
p.begin( mywidget );
- p.setPen( QColor( "red" ) );
+ p.setPen( TQColor( "red" ) );
p.drawLine( 0,0,100,100 );
p.end();
@@ -271,8 +271,8 @@ Any operations that generate events must not be called by any thread
other than the GUI thread. Examples of such operations are:
\list
-\i creating a QWidget, QTimer, QSocketNotifier, QSocket or other network class.
-\i moving, resizing, showing or hiding a QWidget.
+\i creating a TQWidget, QTimer, QSocketNotifier, QSocket or other network class.
+\i moving, resizing, showing or hiding a TQWidget.
\i starting or stoping a QTimer.
\i enabling or disabling a QSocketNotifier.
\i using a QSocket or other network class.
@@ -283,7 +283,7 @@ Events generated by these operations will be lost on some platforms.
\section1 Threads and Signals and Slots
The Signals and Slots mechanism can be used in separate threads, as
-long as the rules for QObject based classes are followed. The Signals
+long as the rules for TQObject based classes are followed. The Signals
and Slots mechanism is synchronous: when a signal is emitted, all
slots are called immediately. The slots are executed in the thread
context that emitted the signal.
@@ -322,15 +322,15 @@ Some things to watch out for when programming with threads:
\list
-\i As mentioned above, QObject based classes are neither thread-safe
-nor reentrant. This includes all widgets (e.g. QWidget and
+\i As mentioned above, TQObject based classes are neither thread-safe
+nor reentrant. This includes all widgets (e.g. TQWidget and
subclasses), OS kernel classes (e.g. QProcess, QAccel), and all
networking classes (e.g. QSocket, QDns).
-\i Deleting a QObject while pending events are waiting to be delivered
+\i Deleting a TQObject while pending events are waiting to be delivered
will cause a crash. If you are creating QObjects in a thread that is
not the GUI thread and posting events to these objects, you should not
-delete the QObject directly. Use the QObject::deleteLater() method
+delete the TQObject directly. Use the TQObject::deleteLater() method
instead, which will cause the event loop to delete the object after
all pending events have been delivered to the object.