Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions |

# 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 <ntqapplication.h>
        #include <ntqpushbutton.h>
        #include <ntqsocket.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");