Home

QtMotifWidget Class Reference

The QtMotifWidget class provides the QWidget API for Xt/Motif widgets. More...

 #include <QtMotifWidget>

Inherits QWidget.

• List of all members, including inherited members

Public Functions

• QtMotifWidget ( const char * name, WidgetClass widgetClass, QWidget * parent, ArgList args = NULL, Cardinal argCount = 0, Qt::WFlags flags = 0 )
• ~QtMotifWidget ()
• Widget motifWidget () const

• 207 public functions inherited from QWidget
• 12 public functions inherited from QPaintDevice
• 29 public functions inherited from QObject

Protected Functions

• virtual void hideEvent ( QHideEvent * event )
• virtual void showEvent ( QShowEvent * event )

• 37 protected functions inherited from QWidget
• 1 protected function inherited from QPaintDevice
• 7 protected functions inherited from QObject

Additional Inherited Members

• 57 properties inherited from QWidget
• 1 property inherited from QObject
• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject
• 1 signal inherited from QWidget
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QWidget
• 4 static public members inherited from QObject
• 1 protected slot inherited from QWidget
• 1 protected type inherited from QPaintDevice
• 2 protected variables inherited from QObject

Detailed Description

The QtMotifWidget class provides the QWidget API for Xt/Motif widgets.

QtMotifWidget provides a QWidget that can act as a parent for any Xt/Motif widget. Since QtMotifWidget is a proper QWidget, it can be used as a top-level widget (specify 0 as the widget's parent) or as a child of any other QWidget.

Note: Since QtMotifWidget acts as a parent for Xt/Motif widgets, you should not create QWidgets with a QtMotifWidget parent because the child widgets will not interact as expected with their Motif siblings.

An Xt/Motif widget, with a top-level QtMotifWidget parent, can begin using the standard Qt dialogs and custom QDialogs while keeping the main Xt/Motif interface of the application. Using a QtMotifWidget as the parent for the various QDialogs will ensure that modality and stacking works properly throughout the entire application.

Applications moving to Qt may have custom Xt/Motif widgets that will take time to rewrite with Qt. Such applications can use these custom widgets as QtMotifWidgets with QWidget parents. This allows the application's interface to be replaced gradually.

Warning: QtMotifWidget uses the X11 window ID of the Motif widget directly instead of creating its own. As a result, QWidget::reparent() will not work. Since QWidget::showFullScreen() and QWidget::showNormal() rely on QWidget::reparent(), these functions will also not work as expected.

Member Function Documentation

QtMotifWidget::QtMotifWidget ( const char * name, WidgetClass widgetClass, QWidget * parent, ArgList args = NULL, Cardinal argCount = 0, Qt::WFlags flags = 0 )

Constructs a QtMotifWidget of the given widgetClass as a child of parent, with the given name and widget flags specified by flags.

The args and argCount arguments are passed on to XtCreateWidget.

The resulting Xt/Motif widget can be accessed using the motifWidget() function. The widget can be used as a parent for any other Xt/Motif widget.

If parent is a QtMotifWidget, the Xt/Motif widget is created as a child of the parent's motifWidget(). If parent is 0 or a normal QWidget, the Xt/Motif widget is created as a child of a special TopLevelShell widget. Xt/Motif widgets can use this TopLevelShell as the parent for existing Xt/Motif dialogs or QtMotifDialogs.

QtMotifWidget::~QtMotifWidget ()

Destroys the QtMotifWidget. The special TopLevelShell is also destroyed, if it was created during construction.

void QtMotifWidget::hideEvent ( QHideEvent * event )   [virtual protected]

Responds to the given event by ensuring that the embedded Xt/Motif widget is unmanaged and hidden.

Reimplemented from QWidget.

Widget QtMotifWidget::motifWidget () const

Returns the embedded Xt/Motif widget. If a Shell widget was created by the constructor, you can access it with XtParent().

void QtMotifWidget::showEvent ( QShowEvent * event )   [virtual protected]

Responds to the given event by ensuring that the embedded Xt/Motif widget is managed and shown.

Reimplemented from QWidget.