QMotifDialog(3qt)

1QMotifDialog(3qt)                                            QMotifDialog(3qt)
2
3
4

NAME

6       QMotifDialog - The QDialog API for Motif-based dialogs
7

SYNOPSIS

9       This class is part of the Qt Motif Extension.
10
11       #include <qmotifdialog.h>
12
13       Inherits QDialog.
14
15   Public Members
16       enum DialogType { Prompt, Selection, Command, FileSelection, Template,
17           Error, Information, Message, Question, Warning, Working }
18           (obsolete)
19       QMotifDialog ( DialogType dialogtype, Widget parent, ArgList args =
20           NULL, Cardinal argcount = 0, const char * name = 0, bool modal =
21           FALSE, WFlags flags = 0 )  (obsolete)
22       QMotifDialog ( Widget parent, ArgList args = NULL, Cardinal argcount =
23           0, const char * name = 0, bool modal = FALSE, WFlags flags = 0 )
24           (obsolete)
25       QMotifDialog ( Widget parent, const char * name = 0, bool modal =
26           FALSE, WFlags flags = 0 )
27       QMotifDialog ( QWidget * parent, const char * name = 0, bool modal =
28           FALSE, WFlags flags = 0 )
29       virtual ~QMotifDialog ()
30       Widget shell () const
31       Widget dialog () const
32
33   Static Public Members
34       void acceptCallback ( Widget, XtPointer client_data, XtPointer )
35       void rejectCallback ( Widget, XtPointer client_data, XtPointer )
36

DESCRIPTION

38       This class is defined in the Qt Motif Extension, which can be found in
39       the qt/extensions directory. It is not included in the main Qt API.
40
41       The QMotifDialog class provides the QDialog API for Motif-based
42       dialogs.
43
44       QMotifDialog provides two separate modes of operation. The application
45       programmer can use QMotifDialog with an existing Motif-based dialog and
46       a QWidget parent, or the application programmer can use QMotifDialog
47       with a custom Qt-based dialog and a Motif-based parent. Modality
48       continues to work as expected.
49
50       Motif-based dialogs must have a Shell widget parent with a single
51       child, due to requirements of the Motif toolkit. The Shell widget,
52       which is a special subclass of XmDialogShell, is created during
53       construction. It can be accessed using the shell() member function.
54
55       The single child of the Shell can be accessed using the dialog() member
56       function after it has been created.
57
58       The acceptCallback() and rejectCallback() functions provide a
59       convenient way to call QDialog::accept() and QDialog::reject() through
60       callbacks. A pointer to the QMotifDialog should be passed as the
61       client_data argument to the callback.
62
63       The API and behavior QMotifDialog is identical to that of QDialog when
64       using a custom Qt-based dialog with a Motif-based parent. The only
65       difference is that a Motif-based parent argument is passed to the
66       constructor, instead of a QWidget parent.
67
68   Member Type Documentation

QMotifDialog::DialogType

70       This function is obsolete. It is provided to keep old source working.
71       We strongly advise against using it in new code.
72
73       This enum lists the predefined Motif dialog types.
74
75       QMotifDialog::Prompt
76
77       QMotifDialog::Selection
78
79       QMotifDialog::Command
80
81       QMotifDialog::FileSelection
82
83       QMotifDialog::Template
84
85       QMotifDialog::Error
86
87       QMotifDialog::Information
88
89       QMotifDialog::Message
90
91       QMotifDialog::Question
92
93       QMotifDialog::Warning
94
95       QMotifDialog::Working
96

MEMBER FUNCTION DOCUMENTATION

QMotifDialog::QMotifDialog ( DialogType dialogtype, Widget parent, ArgList

99       args = NULL, Cardinal argcount = 0, const char * name = 0, bool modal =
100       FALSE, WFlags flags = 0 )
101       This function is obsolete. It is provided to keep old source working.
102       We strongly advise against using it in new code.
103
104       Creates a QMotifDialog using one of the predefined Motif dialog types.
105       The name, modal and flags arguments are passed to the QDialog
106       constructor.
107
108       This constructor creates a Shell widget, which is a special subclass of
109       XmDialogShell. The parent, args and argcount arguments are passed to
110       XtCreatePopupShell() when creating the subclass. You can access the
111       Shell widget with the shell() member function.
112
113       This constructor also creates the dialog widget with the Shell widget
114       as its parent. The type of the dialog created is specified by the
115       dialogtype argument. See the DialogType enum for a list of available
116       dialog types. You can access the dialog widget with the dialog() member
117       function.
118
119       Warning: QMotifDialog takes ownership of the child widget and destroys
120       it during destruction. You should not destroy the dialog widget
121       yourself.
122
123       See also DialogType, shell(), and dialog().
124

QMotifDialog::QMotifDialog ( Widget parent, ArgList args = NULL, Cardinal

126       argcount = 0, const char * name = 0, bool modal = FALSE, WFlags flags =
127       0 )
128       This function is obsolete. It is provided to keep old source working.
129       We strongly advise against using it in new code.
130
131       Creates a QMotifDialog which allows the application programmer to use
132       the Motif-based parent for a custom QDialog. The name, modal and flags
133       arguments are passed to the QDialog constructor.
134
135       This constructor creates a Shell widget, which is a special subclass of
136       XmDialogShell. The args and argcount arguments are passed to
137       XtCreatePopupShell() when creating the subclass. You can access the
138       Shell widget with the shell() member function.
139
140       The dialog widget is not created by the constructor. You must create
141       the dialog widget as a child of the the widget returned by shell(). You
142       can access the child widget with the dialog() member function.
143
144       A dialog widget is not created by this constructor. Instead, you should
145       create the dialog widget as a child of this dialog. QMotifDialog will
146       take ownership of your custom dialog, and you can access it with the
147       dialog() member function.
148
149       Warning: QMotifDialog takes ownership of the child widget and destroys
150       it during destruction. You should not destroy the dialog widget
151       yourself.
152
153       See also shell() and dialog().
154

QMotifDialog::QMotifDialog ( Widget parent, const char * name = 0, bool modal

156       = FALSE, WFlags flags = 0 )
157       Creates a QMotifDialog which allows the application programmer to use
158       the Motif-based parent for a custom QDialog. The name, modal and flags
159       arguments are passed to the QDialog constructor.
160
161       This constructor creates a Shell widget, which is a special subclass of
162       XmDialogShell. You can access the Shell widget with the shell() member
163       function.
164
165       See also shell().
166

QMotifDialog::QMotifDialog ( QWidget * parent, const char * name = 0, bool

168       modal = FALSE, WFlags flags = 0 )
169       Creates a QMotifDialog which allows the application programmer to use a
170       QWidget parent for an existing Motif-based dialog. The parent, name,
171       modal and flags arguments are passed to the QDialog constructor.
172
173       This constructor creates a Shell widget, which is a special subclass of
174       XmDialogShell. You can access the Shell widget with the shell() member
175       functon.
176
177       A dialog widget is not created by this constructor. Instead, you should
178       create the dialog widget as a child of this dialog. QMotifDialog will
179       take ownership of your custom dialog, and you can access it with the
180       dialog() member function.
181
182       Warning: QMotifDialog takes ownership of the child widget and destroys
183       it during destruction. You should not destroy the dialog widget
184       yourself.
185
186       See also shell() and dialog().
187

QMotifDialog::~QMotifDialog () [virtual]

189       Destroys the QDialog, dialog widget and Shell widget.
190

void QMotifDialog::acceptCallback ( Widget, XtPointer client_data, XtPointer )

192       [static]
193       Convenient Xt/Motif callback to accept the QMotifDialog.
194
195       The data is passed in client_data.
196

Widget QMotifDialog::dialog () const

198       Returns the Motif widget embedded in this dialog.
199

void QMotifDialog::rejectCallback ( Widget, XtPointer client_data, XtPointer )

201       [static]
202       Convenient Xt/Motif callback to reject the QMotifDialog.
203
204       The data is passed in client_data.
205

Widget QMotifDialog::shell () const

207       Returns the Shell widget embedded in this dialog.
208
209       Example: dialog/mainwindow.cpp.
210
211

COPYRIGHT

217       Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com.  See the
218       license file included in the distribution for a complete license
219       statement.
220

AUTHOR

222       Generated automatically from the source code.
223

BUGS

225       If you find a bug in Qt, please report it as described in
226       http://doc.trolltech.com/bughowto.html.  Good bug reports help us to
227       help you. Thank you.
228
229       The definitive Qt documentation is provided in HTML format; it is
230       located at $QTDIR/doc/html and can be read using Qt Assistant or with a
231       web browser. This man page is provided as a convenience for those users
232       who prefer man pages, although this format is not officially supported
233       by Trolltech.
234
235       If you find errors in this manual page, please report them to qt-
236       bugs@trolltech.com.  Please include the name of the manual page
237       (qmotifdialog.3qt) and the Qt version (3.3.8).
238
239
240
241Trolltech AS                    2 February 2007              QMotifDialog(3qt)