summaryrefslogtreecommitdiffstats
path: root/doc/html/qmotifwidget.html
blob: 50112a3840f9acc65b84e9045667976f13edc56d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/extensions/motif/src/qmotifwidget.cpp:272 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QMotifWidget Class</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>

<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
 <a href="index.html">
<font color="#004faf">Home</font></a>
 | <a href="classes.html">
<font color="#004faf">All&nbsp;Classes</font></a>
 | <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
 | <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
 | <a href="groups.html">
<font color="#004faf">Grouped&nbsp;Classes</font></a>
 | <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QMotifWidget Class Reference</h1>

<p>The QMotifWidget class provides the QWidget API for Xt/Motif widgets.
<a href="#details">More...</a>
<p>This class is part of the <b>Qt Motif Extension</b>.
<p><tt>#include &lt;<a href="qmotifwidget-h.html">qmotifwidget.h</a>&gt;</tt>
<p>Inherits <a href="qwidget.html">QWidget</a>.
<p><a href="qmotifwidget-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn><a href="#QMotifWidget"><b>QMotifWidget</b></a> ( QWidget&nbsp;*&nbsp;parent, WidgetClass&nbsp;widgetclass, ArgList&nbsp;args = NULL, Cardinal&nbsp;argcount = 0, const&nbsp;char&nbsp;*&nbsp;name = 0, WFlags&nbsp;flags = 0 )</li>
<li class=fn>virtual <a href="#~QMotifWidget"><b>~QMotifWidget</b></a> ()</li>
<li class=fn>Widget <a href="#motifWidget"><b>motifWidget</b></a> () const</li>
</ul>
<h2>Protected Members</h2>
<ul>
<li class=fn>virtual bool <b>x11Event</b> ( XEvent&nbsp;*&nbsp;event )</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>
<p> This class is defined in the <b>Qt <a href="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 Qt API.
<p>

The QMotifWidget class provides the <a href="qwidget.html">QWidget</a> API for Xt/Motif widgets.

<p> 
<p> QMotifWidget exists to provide a QWidget that can act as a parent
for any Xt/Motif widget. Since the QMotifWidget is a proper
QWidget, it can be used as a top-level widget (e.g. 0 parent) or
as a child of any other QWidget. Note: Since QMotifWidget acts as
a parent for Xt/Motif widgets, you should not create QWidgets with
a QMotifWidget parent.
<p> An Xt/Motif widget with a top-level QMotifWidget parent can begin
using the standard Qt dialogs and custom QDialogs while keeping
the main Xt/Motif interface of the application. Using a
QMotifWidget as the parent for the various QDialogs will ensure
that modality and stacking works properly throughout the entire
application.
<p> 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 QMotifWidget with QWidget parents. This
allows the application's interface to be replaced gradually.
<p> <b>Warning:</b> QMotifWidget uses the X11 window ID of the Motif widget
directly, instead of creating its own.  Because ot this,
<a href="qwidget.html#reparent">QWidget::reparent</a>() will not work.  This includes the functions
<a href="qwidget.html#showFullScreen">QWidget::showFullScreen</a>() and <a href="qwidget.html#showNormal">QWidget::showNormal</a>(), which use
QWidget::reparent().

<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="QMotifWidget"></a>QMotifWidget::QMotifWidget ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;parent, WidgetClass&nbsp;widgetclass, ArgList&nbsp;args = NULL, Cardinal&nbsp;argcount = 0, const&nbsp;char&nbsp;*&nbsp;name = 0, WFlags&nbsp;flags = 0 )
</h3>
Creates a QMotifWidget of the given <em>widgetclass</em> as a child of
<em>parent</em>, with the name <em>name</em> and widget flags <em>flags</em>.
<p> The <em>args</em> and <em>argcount</em> arguments are passed on to
XtCreateWidget.
<p> The <a href="#motifWidget">motifWidget</a>() function returns the resulting Xt/Motif widget.
This widget can be used as a parent for any other Xt/Motif widget.
<p> If <em>parent</em> is a QMotifWidget, the Xt/Motif widget is created as
a child of the parent's motifWidget(). If &#92; parent is 0 or a
normal <a href="qwidget.html">QWidget</a>, the Xt/Motif widget is created as a child of a
special TopLevelShell widget. Xt/Motif widgets can use this
special TopLevelShell parent as the parent for existing
Xt/Motif dialogs or QMotifDialogs.

<h3 class=fn><a name="~QMotifWidget"></a>QMotifWidget::~QMotifWidget ()<tt> [virtual]</tt>
</h3>
Destroys the QMotifWidget. The special TopLevelShell is also
destroyed, if it was created during construction.

<h3 class=fn>Widget <a name="motifWidget"></a>QMotifWidget::motifWidget () const
</h3>
Returns the embedded Xt/Motif widget. If a Shell widget was
created by the constructor, you can access it with XtParent().

<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">Qt toolkit</a>.
Copyright &copy; 1995-2007
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt 3.3.8</div>
</table></div></address></body>
</html>