summaryrefslogtreecommitdiffstats
path: root/doc/html/qxtwidget.html
blob: be90b9594bc210a93072902cb527583d590dfa6c (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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
<!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/qxtwidget.cpp:144 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>QXtWidget 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>QXtWidget Class Reference<br><small>[obsolete]</small></h1>

<p>The QXtWidget class allows mixing of Xt/Motif and Qt widgets.
<b>This class is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
<a href="#details">More...</a>
<p>This class is part of the <b>Qt Motif Extension</b>.
<p><tt>#include &lt;<a href="qxtwidget-h.html">qxtwidget.h</a>&gt;</tt>
<p>Inherits <a href="qwidget.html">QWidget</a>.
<p><a href="qxtwidget-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn><a href="#QXtWidget"><b>QXtWidget</b></a> ( const&nbsp;char&nbsp;*&nbsp;name, Widget&nbsp;parent, bool&nbsp;managed = FALSE )</li>
<li class=fn><a href="#QXtWidget-2"><b>QXtWidget</b></a> ( const&nbsp;char&nbsp;*&nbsp;name, WidgetClass&nbsp;widget_class, QWidget&nbsp;*&nbsp;parent = 0, ArgList&nbsp;args = 0, Cardinal&nbsp;num_args = 0, bool&nbsp;managed = FALSE )</li>
<li class=fn><a href="#~QXtWidget"><b>~QXtWidget</b></a> ()</li>
<li class=fn>Widget <a href="#xtWidget"><b>xtWidget</b></a> () const</li>
<li class=fn>bool <a href="#isActiveWindow"><b>isActiveWindow</b></a> () const</li>
<li class=fn>virtual void <a href="#setActiveWindow"><b>setActiveWindow</b></a> ()</li>
</ul>
<h2>Protected Members</h2>
<ul>
<li class=fn>virtual bool <a href="#x11Event"><b>x11Event</b></a> ( XEvent&nbsp;*&nbsp;e )</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 QXtWidget class allows mixing of Xt/Motif and Qt widgets.
<b>This class is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
<p> 
<p> QXtWidget acts as a bridge between Xt and Qt. For utilizing old Xt
widgets, it can be a <a href="qwidget.html">QWidget</a> based on a Xt widget class. For
including Qt widgets in an existing Xt/Motif application, it can be
a special Xt widget class that is a QWidget.  See the constructors
for the different behaviors.
<p> <h4> Known QXtWidget Problems
</h4>
<a name="1"></a><p> This class is unsupported and has many known problems and
limitations.  It is provided only to keep existing source working;
it should not be used in new code.  Note: These problems will <em>not</em>
be fixed in future releases.
<p> Below is an imcomplete list of know issues:
<p> <ol type=1>
<p> <li> <a href="focus.html#keyboard-focus">Keyboard focus</a> navigation is impossible when using QXtWidget.
The mouse must be used to focus widgets in both Qt and Xt/Motif
widgets.  For example, when embedding a QXtWidget into an Xt/Motif
widget, key events will go to the QXtWidget (and its children) while
the mouse is over the QXtWidget, regardless of where Xt/Motif has
placed the focus.
<p> <li> Reparenting does not work.  You cannot use
<a href="qwidget.html#reparent">QWidget::reparent</a>(). 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().
<p> </ol>

<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="QXtWidget"></a>QXtWidget::QXtWidget ( const&nbsp;char&nbsp;*&nbsp;name, Widget&nbsp;parent, bool&nbsp;managed = FALSE )
</h3>
Constructs a QXtWidget of the special Xt widget class known as
"QWidget" to the resource manager.
<p> Use this constructor to utilize Qt widgets in an Xt/Motif
application.  The QXtWidget is a <a href="qwidget.html">QWidget</a>, so you can create
subwidgets, layouts, etc. using Qt functionality.
<p> The <em>name</em> is the object name passed to the QWidget constructor.
The widget's parent is <em>parent</em>.
<p> If the <em>managed</em> parameter is TRUE and <em>parent</em> in not null,
XtManageChild it used to manage the child.

<h3 class=fn><a name="QXtWidget-2"></a>QXtWidget::QXtWidget ( const&nbsp;char&nbsp;*&nbsp;name, WidgetClass&nbsp;widget_class, <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;parent = 0, ArgList&nbsp;args = 0, Cardinal&nbsp;num_args = 0, bool&nbsp;managed = FALSE )
</h3>
Constructs a QXtWidget of the given <em>widget_class</em> called <em>name</em>.
<p> Use this constructor to utilize Xt or <a href="motif-extension.html#Motif">Motif</a> widgets in a Qt
application.  The QXtWidget looks and behaves
like the Xt class, but can be used like any <a href="qwidget.html">QWidget</a>.
<p> Note that Xt requires that the most top level Xt widget is a shell.
This means, if <em>parent</em> is a QXtWidget, the <em>widget_class</em> can be
of any kind. If there isn't a parent or the parent is just a normal
QWidget, <em>widget_class</em> should be something like <tt>topLevelShellWidgetClass</tt>.
<p> The arguments, <em>args</em>, <em>num_args</em> are passed on to XtCreateWidget.
<p> If the <em>managed</em> parameter is TRUE and <em>parent</em> in not null,
XtManageChild it used to manage the child.

<h3 class=fn><a name="~QXtWidget"></a>QXtWidget::~QXtWidget ()
</h3>
Destructs the QXtWidget.

<h3 class=fn>bool <a name="isActiveWindow"></a>QXtWidget::isActiveWindow () const
</h3>
Different from <a href="qwidget.html#isActiveWindow">QWidget::isActiveWindow</a>()

<h3 class=fn>void <a name="setActiveWindow"></a>QXtWidget::setActiveWindow ()<tt> [virtual]</tt>
</h3>
Implement a degree of focus handling for Xt widgets.

<p>Reimplemented from <a href="qwidget.html#setActiveWindow">QWidget</a>.
<h3 class=fn>bool <a name="x11Event"></a>QXtWidget::x11Event ( XEvent&nbsp;*&nbsp;e )<tt> [virtual protected]</tt>
</h3>
Reimplemented to produce the Xt effect of getting focus when the
mouse enters the widget. The event is passed in <em>e</em>.

<p>Reimplemented from <a href="qwidget.html#x11Event">QWidget</a>.
<h3 class=fn>Widget <a name="xtWidget"></a>QXtWidget::xtWidget () const
</h3>

<p> Returns the Xt widget equivalent for the Qt widget.

<!-- 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>