summaryrefslogtreecommitdiffstats
path: root/doc/html/qmacstyle.html
blob: b9eb68d389e596b0db33a82483597d2a1343b2f4 (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
148
149
150
151
152
153
154
155
156
157
158
159
160
<!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/src/styles/qmacstyle_mac.cpp:324 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>TQMacStyle 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>TQMacStyle Class Reference</h1>

<p>The TQMacStyle class implements an Appearance Manager style.
<a href="#details">More...</a>
<p><tt>#include &lt;<a href="qmacstyle_mac-h.html">qmacstyle_mac.h</a>&gt;</tt>
<p>Inherits <a href="ntqwindowsstyle.html">TQWindowsStyle</a>.
<p><a href="qmacstyle-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn><a href="#TQMacStyle"><b>TQMacStyle</b></a> ()</li>
<li class=fn>virtual <a href="#~TQMacStyle"><b>~TQMacStyle</b></a> ()</li>
<li class=fn>enum <a href="#FocusRectPolicy-enum"><b>FocusRectPolicy</b></a> { FocusEnabled, FocusDisabled, FocusDefault }</li>
<li class=fn>enum <a href="#WidgetSizePolicy-enum"><b>WidgetSizePolicy</b></a> { SizeSmall, SizeLarge, SizeNone, SizeDefault }</li>
</ul>
<h2>Static Public Members</h2>
<ul>
<li class=fn>void <a href="#setFocusRectPolicy"><b>setFocusRectPolicy</b></a> ( TQWidget&nbsp;*&nbsp;w, FocusRectPolicy&nbsp;policy )</li>
<li class=fn>FocusRectPolicy <a href="#focusRectPolicy"><b>focusRectPolicy</b></a> ( TQWidget&nbsp;*&nbsp;w )</li>
<li class=fn>void <a href="#setWidgetSizePolicy"><b>setWidgetSizePolicy</b></a> ( TQWidget&nbsp;*&nbsp;w, WidgetSizePolicy&nbsp;policy )</li>
<li class=fn>WidgetSizePolicy <a href="#widgetSizePolicy"><b>widgetSizePolicy</b></a> ( TQWidget&nbsp;*&nbsp;w )</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>


The TQMacStyle class implements an Appearance Manager style.
<p> 
<p> This class is implemented as a wrapper to the Apple Appearance
Manager. This allows your application to be styled by whatever
theme your Macintosh is using. This is done by having primitives
in <a href="ntqstyle.html">TQStyle</a> implemented in terms of what the Macintosh would
normally theme (i.e. the Finder).
<p> There are additional issues that should be taken
into consideration to make an application compatible with the
<a href="http://developer.apple.com/documentation/UserExperience/Conceptual/OSXHIGuidelines/index.html">Aqua Style Guidelines</a>. Some of these issues are outlined
below.
<p> <ul>
<p> <li> Layout - The restrictions on window layout are such that some
aspects of layout that are style-dependent cannot be achieved
using <a href="ntqlayout.html">TQLayout</a>. Changes are being considered (and feedback would be
appreciated) to make layouts TQStyle-able. Some of the restrictions
involve horizontal and vertical widget alignment and widget size
(covered below).
<p> <li> Widget size - Aqua allows widgets to have specific fixed sizes.  TQt
does not fully implement this behaviour so as to maintain multiplatform
compatibility. As a result some widgets sizes may be inappropriate (and
subsequently not rendered correctly by the Appearance Manager).The
<a href="tqwidget.html#sizeHint">TQWidget::sizeHint</a>() will return the appropriate size for many
managed widgets (widgets enumerated in <a href="ntqstyle.html#ContentsType-enum">TQStyle::ContentsType</a>).
<p> <li> Effects - TQMacStyle (in contrast to TQAquaStyle) is not emulating
(except where Appearance Manager does not provide certain
capabilities), for example <a href="ntqpushbutton.html">TQPushButton</a> pulsing effects. In this case a
near matching emulation has been implemented, but naturally this will
not be identical to the similar functionality built into the Appearance
Manager. Please report any issues you see in effects or non-standard
widgets.
<p> </ul>
<p> There are other issues that need to be considered in the feel of
your application (including the general color scheme to match the
Aqua colors). The Guidelines mentioned above will remain current
with new advances and design suggestions for Mac OS X.
<p> Note that the functions provided by TQMacStyle are
reimplementations of <a href="ntqstyle.html">TQStyle</a> functions; see TQStyle for their
documentation.
<p>See also <a href="appearance.html">Widget Appearance and Style</a>.

<hr><h2>Member Type Documentation</h2>
<h3 class=fn><a name="FocusRectPolicy-enum"></a>TQMacStyle::FocusRectPolicy</h3>

<p> This type is used to signify a widget's focus rectangle policy.
<ul>
<li><tt>TQMacStyle::FocusEnabled</tt> - show a focus rectangle when the widget has focus.
<li><tt>TQMacStyle::FocusDisabled</tt> - never show a focus rectangle for the widget.
<li><tt>TQMacStyle::FocusDefault</tt> - show a focus rectangle when the widget has
focus and the widget is a TQSpinWidget, <a href="ntqdatetimeedit.html">TQDateTimeEdit</a>, <a href="ntqlineedit.html">TQLineEdit</a>,
<a href="ntqlistbox.html">TQListBox</a>, <a href="ntqlistview.html">TQListView</a>, editable <a href="ntqtextedit.html">TQTextEdit</a>, or one of their
subclasses.
</ul>
<h3 class=fn><a name="WidgetSizePolicy-enum"></a>TQMacStyle::WidgetSizePolicy</h3>

<ul>
<li><tt>TQMacStyle::SizeSmall</tt>
<li><tt>TQMacStyle::SizeLarge</tt>
<li><tt>TQMacStyle::SizeNone</tt>
<li><tt>TQMacStyle::SizeDefault</tt>
</ul>
<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="TQMacStyle"></a>TQMacStyle::TQMacStyle ()
</h3>
Constructs a TQMacStyle object.

<h3 class=fn><a name="~TQMacStyle"></a>TQMacStyle::~TQMacStyle ()<tt> [virtual]</tt>
</h3>
Destructs a TQMacStyle object.

<h3 class=fn><a href="qmacstyle.html#FocusRectPolicy-enum">FocusRectPolicy</a> <a name="focusRectPolicy"></a>TQMacStyle::focusRectPolicy ( <a href="tqwidget.html">TQWidget</a>&nbsp;*&nbsp;w )<tt> [static]</tt>
</h3>
Returns the focus rectangle policy for the widget <em>w</em>.
<p> The focus rectangle policy can be one of <a href="#FocusRectPolicy-enum">TQMacStyle::FocusRectPolicy</a>.
<p> <p>See also <a href="#setFocusRectPolicy">setFocusRectPolicy</a>().

<h3 class=fn>void <a name="setFocusRectPolicy"></a>TQMacStyle::setFocusRectPolicy ( <a href="tqwidget.html">TQWidget</a>&nbsp;*&nbsp;w, <a href="qmacstyle.html#FocusRectPolicy-enum">FocusRectPolicy</a>&nbsp;policy )<tt> [static]</tt>
</h3>
Sets the focus rectangle policy of <em>w</em>. The <em>policy</em> can be one of
<a href="#FocusRectPolicy-enum">TQMacStyle::FocusRectPolicy</a>.
<p> <p>See also <a href="#focusRectPolicy">focusRectPolicy</a>().

<h3 class=fn>void <a name="setWidgetSizePolicy"></a>TQMacStyle::setWidgetSizePolicy ( <a href="tqwidget.html">TQWidget</a>&nbsp;*&nbsp;w, <a href="qmacstyle.html#WidgetSizePolicy-enum">WidgetSizePolicy</a>&nbsp;policy )<tt> [static]</tt>
</h3>
Sets the widget size policy of <em>w</em>. The <em>policy</em> can be one of
<a href="#WidgetSizePolicy-enum">TQMacStyle::WidgetSizePolicy</a>.
<p> <p>See also <a href="#widgetSizePolicy">widgetSizePolicy</a>().

<h3 class=fn><a href="qmacstyle.html#WidgetSizePolicy-enum">WidgetSizePolicy</a> <a name="widgetSizePolicy"></a>TQMacStyle::widgetSizePolicy ( <a href="tqwidget.html">TQWidget</a>&nbsp;*&nbsp;w )<tt> [static]</tt>
</h3>
Returns the widget size policy for the widget <em>w</em>.
<p> The widget size policy can be one of <a href="#WidgetSizePolicy-enum">TQMacStyle::WidgetSizePolicy</a>.
<p> <p>See also <a href="#setWidgetSizePolicy">setWidgetSizePolicy</a>().

<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">TQt 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>TQt 3.3.8</div>
</table></div></address></body>
</html>