Home

QtMotifDialog Class Reference

The QtMotifDialog class provides the QDialog API for Motif-based dialogs. More...

 #include <QtMotifDialog>

Inherits QDialog.

• List of all members, including inherited members

Public Functions

• QtMotifDialog ( Widget parent, Qt::WFlags flags = 0 )
• QtMotifDialog ( QWidget * parent, Qt::WFlags flags = 0 )
• QtMotifDialog ( const char * name, Widget parent, Qt::WFlags flags = 0 )
• QtMotifDialog ( const char * name, QWidget * parent, Qt::WFlags flags = 0 )
• ~QtMotifDialog ()
• Widget dialog () const
• Widget shell () const

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

Static Public Members

• void acceptCallback ( Widget widget, XtPointer client_data, XtPointer ptr )
• void rejectCallback ( Widget widget, XtPointer client_data, XtPointer ptr )

• 4 static public members inherited from QWidget
• 4 static public members 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

• 2 properties inherited from QDialog
• 57 properties inherited from QWidget
• 1 property inherited from QObject
• 5 public slots inherited from QDialog
• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject
• 3 signals inherited from QDialog
• 1 signal inherited from QWidget
• 1 signal inherited from QObject
• 1 public type inherited from QObject
• 1 protected slot inherited from QWidget
• 1 protected type inherited from QPaintDevice
• 2 protected variables inherited from QObject

Detailed Description

The QtMotifDialog class provides the QDialog API for Motif-based dialogs.

QtMotifDialog provides two separate modes of operation. Application programmers can use QtMotifDialog with an existing Motif-based dialog and a QWidget parent, or they can use QtMotifDialog with a custom Qt-based dialog and a Motif-based parent. Modality continues to work as expected.

Motif-based dialogs must have a Shell widget parent with a single child, due to requirements of the Motif toolkit. The Shell widget, which is a special subclass of XmDialogShell, is created during construction. It can be accessed using the shell() member function.

The single child of the Shell can be accessed using the dialog() member function after it has been created.

The acceptCallback() and rejectCallback() functions provide a convenient way to call QDialog::accept() and QDialog::reject() through callbacks. A pointer to the QtMotifDialog should be passed as the client_data argument to the callback.

The QtMotifDialog's API and behavior is identical to that of QDialog when using a custom Qt-based dialog with a Motif-based parent. The only difference is that a Motif-based parent argument is passed to the constructor, instead of a QWidget parent.

Member Function Documentation

QtMotifDialog::QtMotifDialog ( Widget parent, Qt::WFlags flags = 0 )

Constructs a QtMotifDialog with the given parent and window flags specified by flags that allows the application programmer to use the Motif-based parent for a custom QDialog.

This constructor creates a Shell widget, which is a special subclass of XmDialogShell. You can access the Shell widget with the shell() member function.

See also shell().

QtMotifDialog::QtMotifDialog ( QWidget * parent, Qt::WFlags flags = 0 )

Constructs a QtMotifDialog with the given parent and window flags specified by flags that allows the application programmer to use a QWidget parent for an existing Motif-based dialog.

This constructor creates a Shell widget, which is a special subclass of XmDialogShell. You can access the Shell widget with the shell() member functon.

Note that a dialog widget is not created, only the shell. Instead, you should create the dialog widget as a child of the QtMotifDialog. QtMotifDialog will take ownership of your custom dialog, and you can access it with the dialog() member function.

Warning: QtMotifDialog takes ownership of the child widget and destroys it during destruction. You should not destroy the dialog widget yourself.

See also shell() and dialog().

QtMotifDialog::QtMotifDialog ( const char * name, Widget parent, Qt::WFlags flags = 0 )

This is an overloaded function.

The created Shell widget is given the name name.

QtMotifDialog::QtMotifDialog ( const char * name, QWidget * parent, Qt::WFlags flags = 0 )

This is an overloaded function.

The created Shell widget is given the name name.

QtMotifDialog::~QtMotifDialog ()

Destroys the QDialog, dialog widget, and Shell widget.

void QtMotifDialog::acceptCallback ( Widget widget, XtPointer client_data, XtPointer ptr )   [static]

Convenient Xt/Motif callback to accept the QtMotifDialog.

The data is passed in client_data. The widget and ptr parameters are ignored.

Widget QtMotifDialog::dialog () const

Returns the Motif widget embedded in this dialog.

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

This function is a reimplementation of QWidget::hideEvent(). The reimplemented function handles the given event by ensuring that the dialog widget is unmanaged and hidden.

Reimplemented from QWidget.

void QtMotifDialog::rejectCallback ( Widget widget, XtPointer client_data, XtPointer ptr )   [static]

Convenient Xt/Motif callback to reject the QtMotifDialog.

The data is passed in client_data. The widget and ptr parameters are ignored.

Widget QtMotifDialog::shell () const

Returns the Shell widget embedded in this dialog.

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

This function is a reimplementation of QWidget::showEvent(). The reimplemented function handles the given event by ensuring that the dialog widget is managed and hidden.

Reimplemented from QWidget.