From d796c9dd933ab96ec83b9a634feedd5d32e1ba3f Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Tue, 8 Nov 2011 12:31:36 -0600 Subject: Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731 --- doc/html/motif-extension.html | 127 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 doc/html/motif-extension.html (limited to 'doc/html/motif-extension.html') diff --git a/doc/html/motif-extension.html b/doc/html/motif-extension.html new file mode 100644 index 000000000..0e9931e85 --- /dev/null +++ b/doc/html/motif-extension.html @@ -0,0 +1,127 @@ + + + + + +TQt Motif Extension + + + + + + + +

TQt Motif Extension

+ + +

This module is part of the TQt Enterprise +Edition and is not part of the Free or Non-Commercial +Editions. +

Introduction +

The TQt Motif Extension assists the migration of old Xt and Motif based +applications to the more comfortable TQt toolkit. This extension +replaces the older Xt/Motif Support Extension included with earlier +versions of TQt. +

The TQt Motif Extension consists of the following classes: +

TQMotif - Provides the basis of the TQt Motif Extension. +
TQMotifWidget - Provides the TQWidget API for Motif widgets. +
TQMotifDialog - Provides the TQDialog API for Motif dialogs. +
TQXtWidget - The Xt/Motif integration widget from the previous +Xt/Motif extension. This class is unsupported and has many known +problems and limitations. It is provided only to keep existing source +working; it should not be used in new code. +

Additional Documentation +

Examples +
Migration Walkthrough - A +complete migration of a Motif based program to the TQt toolkit. +

Common Problems +

Incorrect CDE Color Scheme +

TQMotifWidget and TQMotifDialog will use the same Visual, Colormap +and color depth that TQApplication uses. When using CDE, the color +scheme may be incorrect when using a Visual, Colormap and color depth +that is not the default. To work around this problem, add the +following resource string to your startup files (for example, +$HOME/.dt/sessions/current/dt.resources): +

+    *userColorObj: false
+

+ +

X11 Header Conflicts +

The X11 headers define some constants that conflict with the TQt +headers. The solution is to include all TQt headers first, followed by +headers from this extension, and all Xt/Motif and X11 headers last. +For example: +

+    // TQt headers first
+    #include <qapplication.h>
+    #include <qpushbutton.h>
+    #include <qsocket.h>
+    ...
+
+    // TQMotif* headers next
+    #include <qmotif.h>
+    #include <qmotifdialog.h>
+    #include <qmotifwidget.h>
+
+    // Xt/Motif and X11 headers last
+    #include <X11/Xlib.h>
+    #include <Xt/Intrinsic.h>
+    #include <Xm/Xm.h>
+    ...
+

+ +

Multiple Screen Support +

TQMotifWidget can be used together with TQDesktopWidget to create +top-level windows on multiple screens. A common mistake is to create +a TQMotifWidget on a non-default screen while the Xt/Motif widgets are +created on the default screen. The solution is to specify the screen +to both TQMotifWidget and the Xt/Motif child. For example: +

+    Display *dpy = TQMotif::x11Display();
+    Arg args[1];
+
+    // make sure both TQMotifWidget and the XmMainWindow are on screen 1
+    XtSetArg(args[0], XtNscreen, ScreenOfDisplay(dpy, 1));
+    TQMotifWidget *toplevel =
+        new TQMotifWidget(TQApplication::desktop()->screen(1),
+                         xmMainWindowWidgetClass, args, 1, "mainwindow");
+

+ +

Trademarks +

TQt 3.3.8

+ -- cgit v1.2.1