source: trunk/doc/html/qmacstyle.html

Last change on this file was 190, checked in by rudi, 14 years ago

reference documentation added
File size: 8.6 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/styles/qmacstyle_mac.cpp:324 -->
3<html>
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
6<title>QMacStyle Class</title>
7<style type="text/css"><!--
8fn { margin-left: 1cm; text-indent: -1cm; }
9a:link { color: #004faf; text-decoration: none }
10a:visited { color: #672967; text-decoration: none }
11body { background: #ffffff; color: black; }
12--></style>
13</head>
14<body>
15
16<table border="0" cellpadding="0" cellspacing="0" width="100%">
17<tr bgcolor="#E5E5E5">
18<td valign=center>
19 <a href="index.html">
20<font color="#004faf">Home</font></a>
21 | <a href="classes.html">
22<font color="#004faf">All&nbsp;Classes</font></a>
23 | <a href="mainclasses.html">
24<font color="#004faf">Main&nbsp;Classes</font></a>
25 | <a href="annotated.html">
26<font color="#004faf">Annotated</font></a>
27 | <a href="groups.html">
28<font color="#004faf">Grouped&nbsp;Classes</font></a>
29 | <a href="functions.html">
30<font color="#004faf">Functions</font></a>
31</td>
32<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QMacStyle Class Reference</h1>
33
34<p>The QMacStyle class implements an Appearance Manager style.
35<a href="#details">More...</a>
36<p><tt>#include &lt;<a href="qmacstyle_mac-h.html">qmacstyle_mac.h</a>&gt;</tt>
37<p>Inherits <a href="qwindowsstyle.html">QWindowsStyle</a>.
38<p><a href="qmacstyle-members.html">List of all member functions.</a>
39<h2>Public Members</h2>
40<ul>
41<li class=fn><a href="#QMacStyle"><b>QMacStyle</b></a> ()</li>
42<li class=fn>virtual <a href="#~QMacStyle"><b>~QMacStyle</b></a> ()</li>
43<li class=fn>enum <a href="#FocusRectPolicy-enum"><b>FocusRectPolicy</b></a> { FocusEnabled, FocusDisabled, FocusDefault }</li>
44<li class=fn>enum <a href="#WidgetSizePolicy-enum"><b>WidgetSizePolicy</b></a> { SizeSmall, SizeLarge, SizeNone, SizeDefault }</li>
45</ul>
46<h2>Static Public Members</h2>
47<ul>
48<li class=fn>void <a href="#setFocusRectPolicy"><b>setFocusRectPolicy</b></a> ( QWidget&nbsp;*&nbsp;w, FocusRectPolicy&nbsp;policy )</li>
49<li class=fn>FocusRectPolicy <a href="#focusRectPolicy"><b>focusRectPolicy</b></a> ( QWidget&nbsp;*&nbsp;w )</li>
50<li class=fn>void <a href="#setWidgetSizePolicy"><b>setWidgetSizePolicy</b></a> ( QWidget&nbsp;*&nbsp;w, WidgetSizePolicy&nbsp;policy )</li>
51<li class=fn>WidgetSizePolicy <a href="#widgetSizePolicy"><b>widgetSizePolicy</b></a> ( QWidget&nbsp;*&nbsp;w )</li>
52</ul>
53<hr><a name="details"></a><h2>Detailed Description</h2>
54
55
56The QMacStyle class implements an Appearance Manager style.
57<p>
58<p> This class is implemented as a wrapper to the Apple Appearance
59Manager. This allows your application to be styled by whatever
60theme your Macintosh is using. This is done by having primitives
61in <a href="qstyle.html">QStyle</a> implemented in terms of what the Macintosh would
62normally theme (i.e. the Finder).
63<p> There are additional issues that should be taken
64into consideration to make an application compatible with the
65<a href="http://developer.apple.com/documentation/UserExperience/Conceptual/OSXHIGuidelines/index.html">Aqua Style Guidelines</a>. Some of these issues are outlined
66below.
67<p> <ul>
68<p> <li> Layout - The restrictions on window layout are such that some
69aspects of layout that are style-dependent cannot be achieved
70using <a href="qlayout.html">QLayout</a>. Changes are being considered (and feedback would be
71appreciated) to make layouts QStyle-able. Some of the restrictions
72involve horizontal and vertical widget alignment and widget size
73(covered below).
74<p> <li> Widget size - Aqua allows widgets to have specific fixed sizes. Qt
75does not fully implement this behaviour so as to maintain multiplatform
76compatibility. As a result some widgets sizes may be inappropriate (and
77subsequently not rendered correctly by the Appearance Manager).The
78<a href="qwidget.html#sizeHint">QWidget::sizeHint</a>() will return the appropriate size for many
79managed widgets (widgets enumerated in <a href="qstyle.html#ContentsType-enum">QStyle::ContentsType</a>).
80<p> <li> Effects - QMacStyle (in contrast to QAquaStyle) is not emulating
81(except where Appearance Manager does not provide certain
82capabilities), for example <a href="qpushbutton.html">QPushButton</a> pulsing effects. In this case a
83near matching emulation has been implemented, but naturally this will
84not be identical to the similar functionality built into the Appearance
85Manager. Please report any issues you see in effects or non-standard
86widgets.
87<p> </ul>
88<p> There are other issues that need to be considered in the feel of
89your application (including the general color scheme to match the
90Aqua colors). The Guidelines mentioned above will remain current
91with new advances and design suggestions for Mac OS X.
92<p> Note that the functions provided by QMacStyle are
93reimplementations of <a href="qstyle.html">QStyle</a> functions; see QStyle for their
94documentation.
95<p>See also <a href="appearance.html">Widget Appearance and Style</a>.
96
97<hr><h2>Member Type Documentation</h2>
98<h3 class=fn><a name="FocusRectPolicy-enum"></a>QMacStyle::FocusRectPolicy</h3>
99
100<p> This type is used to signify a widget's focus rectangle policy.
101<ul>
102<li><tt>QMacStyle::FocusEnabled</tt> - show a focus rectangle when the widget has focus.
103<li><tt>QMacStyle::FocusDisabled</tt> - never show a focus rectangle for the widget.
104<li><tt>QMacStyle::FocusDefault</tt> - show a focus rectangle when the widget has
105focus and the widget is a QSpinWidget, <a href="qdatetimeedit.html">QDateTimeEdit</a>, <a href="qlineedit.html">QLineEdit</a>,
106<a href="qlistbox.html">QListBox</a>, <a href="qlistview.html">QListView</a>, editable <a href="qtextedit.html">QTextEdit</a>, or one of their
107subclasses.
108</ul>
109<h3 class=fn><a name="WidgetSizePolicy-enum"></a>QMacStyle::WidgetSizePolicy</h3>
110
111<ul>
112<li><tt>QMacStyle::SizeSmall</tt>
113<li><tt>QMacStyle::SizeLarge</tt>
114<li><tt>QMacStyle::SizeNone</tt>
115<li><tt>QMacStyle::SizeDefault</tt>
116</ul>
117<hr><h2>Member Function Documentation</h2>
118<h3 class=fn><a name="QMacStyle"></a>QMacStyle::QMacStyle ()
119</h3>
120Constructs a QMacStyle object.
121
122<h3 class=fn><a name="~QMacStyle"></a>QMacStyle::~QMacStyle ()<tt> [virtual]</tt>
123</h3>
124Destructs a QMacStyle object.
125
126<h3 class=fn><a href="qmacstyle.html#FocusRectPolicy-enum">FocusRectPolicy</a> <a name="focusRectPolicy"></a>QMacStyle::focusRectPolicy ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;w )<tt> [static]</tt>
127</h3>
128Returns the focus rectangle policy for the widget <em>w</em>.
129<p> The focus rectangle policy can be one of <a href="#FocusRectPolicy-enum">QMacStyle::FocusRectPolicy</a>.
130<p> <p>See also <a href="#setFocusRectPolicy">setFocusRectPolicy</a>().
131
132<h3 class=fn>void <a name="setFocusRectPolicy"></a>QMacStyle::setFocusRectPolicy ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;w, <a href="qmacstyle.html#FocusRectPolicy-enum">FocusRectPolicy</a>&nbsp;policy )<tt> [static]</tt>
133</h3>
134Sets the focus rectangle policy of <em>w</em>. The <em>policy</em> can be one of
135<a href="#FocusRectPolicy-enum">QMacStyle::FocusRectPolicy</a>.
136<p> <p>See also <a href="#focusRectPolicy">focusRectPolicy</a>().
137
138<h3 class=fn>void <a name="setWidgetSizePolicy"></a>QMacStyle::setWidgetSizePolicy ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;w, <a href="qmacstyle.html#WidgetSizePolicy-enum">WidgetSizePolicy</a>&nbsp;policy )<tt> [static]</tt>
139</h3>
140Sets the widget size policy of <em>w</em>. The <em>policy</em> can be one of
141<a href="#WidgetSizePolicy-enum">QMacStyle::WidgetSizePolicy</a>.
142<p> <p>See also <a href="#widgetSizePolicy">widgetSizePolicy</a>().
143
144<h3 class=fn><a href="qmacstyle.html#WidgetSizePolicy-enum">WidgetSizePolicy</a> <a name="widgetSizePolicy"></a>QMacStyle::widgetSizePolicy ( <a href="qwidget.html">QWidget</a>&nbsp;*&nbsp;w )<tt> [static]</tt>
145</h3>
146Returns the widget size policy for the widget <em>w</em>.
147<p> The widget size policy can be one of <a href="#WidgetSizePolicy-enum">QMacStyle::WidgetSizePolicy</a>.
148<p> <p>See also <a href="#setWidgetSizePolicy">setWidgetSizePolicy</a>().
149
150<!-- eof -->
151<hr><p>
152This file is part of the <a href="index.html">Qt toolkit</a>.
153Copyright &copy; 1995-2007
154<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
155<table width=100% cellspacing=0 border=0><tr>
156<td>Copyright &copy; 2007
157<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
158<td align=right><div align=right>Qt 3.3.8</div>
159</table></div></address></body>
160</html>
Note: See TracBrowser for help on using the repository browser.