<tdalign="right"valign="center"><imgsrc="logo32.png"align="right"width="64"height="32"border="0"></td></tr></table><h1align=center>TQMotifDialog Class Reference</h1>
<p>The TQMotifDialog class provides the TQDialog API for Motif-based dialogs.
<ahref="#details">More...</a>
<p>This class is part of the <b>TQt Motif Extension</b>.
<p> This class is defined in the <b>TQt <ahref="motif-extension.html#Motif">Motif</a> Extension</b>, which can be found in the <tt>qt/extensions</tt> directory. It is not included in the main TQt API.
<p>
The TQMotifDialog class provides the <ahref="qdialog.html">TQDialog</a> API for Motif-based dialogs.
<p>
<p> TQMotifDialog provides two separate modes of operation. The
application programmer can use TQMotifDialog with an existing
Motif-based dialog and a <ahref="qwidget.html">TQWidget</a> parent, or the application
programmer can use TQMotifDialog with a custom TQt-based dialog and
a Motif-based parent. Modality continues to work as expected.
<p> Motif-based dialogs must have a <tt>Shell</tt> widget parent with a
created during construction. It can be accessed using the <ahref="#shell">shell</a>()
member function.
<p> The single child of the <tt>Shell</tt> can be accessed using the
<ahref="#dialog">dialog</a>() member function <em>after</em> it has been created.
<p> The <ahref="#acceptCallback">acceptCallback</a>() and <ahref="#rejectCallback">rejectCallback</a>() functions provide a
convenient way to call <ahref="qdialog.html#accept">TQDialog::accept</a>() and <ahref="qdialog.html#reject">TQDialog::reject</a>()
through callbacks. A pointer to the TQMotifDialog should be passed
as the <tt>client_data</tt> argument to the callback.
<p> The API and behavior TQMotifDialog is identical to that of <ahref="qdialog.html">TQDialog</a>
when using a custom TQt-based dialog with a Motif-based parent.
The only difference is that a Motif-based <em>parent</em> argument is
passed to the constructor, instead of a <ahref="qwidget.html">TQWidget</a> parent.
<hr><h2>Member Type Documentation</h2>
<h3class=fn><aname="DialogType-enum"></a>TQMotifDialog::DialogType</h3><b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
<p>
<p> This enum lists the predefined <ahref="motif-extension.html#Motif">Motif</a> dialog types.
Creates a TQMotifDialog which allows the application programmer to
use a <ahref="qwidget.html">TQWidget</a> parent for an existing <ahref="motif-extension.html#Motif">Motif</a>-based dialog. The <em>parent</em>, <em>name</em>, <em>modal</em> and <em>flags</em> arguments are passed to the
<ahref="qdialog.html">TQDialog</a> constructor.
<p> This constructor creates a <tt>Shell</tt> widget, which is a special
subclass of <tt>XmDialogShell</tt>. You can access the <tt>Shell</tt> widget
with the <ahref="#shell">shell</a>() member functon.
<p> A dialog widget is not created by this constructor. Instead, you
should create the dialog widget as a child of this
dialog. TQMotifDialog will take ownership of your custom dialog,
and you can access it with the <ahref="#dialog">dialog</a>() member function.
<p><b>Warning:</b> TQMotifDialog takes ownership of the child widget and
destroys it during destruction. You should not destroy the dialog
widget yourself.
<p><p>See also <ahref="#shell">shell</a>() and <ahref="#dialog">dialog</a>().
