QMacStyle(3qt)

1QMacStyle(3qt)                                                  QMacStyle(3qt)
2
3
4

NAME

6       QMacStyle - Implements an Appearance Manager style
7

SYNOPSIS

9       #include <qmacstyle_mac.h>
10
11       Inherits QWindowsStyle.
12
13   Public Members
14       QMacStyle ()
15       virtual ~QMacStyle ()
16       enum FocusRectPolicy { FocusEnabled, FocusDisabled, FocusDefault }
17       enum WidgetSizePolicy { SizeSmall, SizeLarge, SizeNone, SizeDefault }
18
19   Static Public Members
20       void setFocusRectPolicy ( QWidget * w, FocusRectPolicy policy )
21       FocusRectPolicy focusRectPolicy ( QWidget * w )
22       void setWidgetSizePolicy ( QWidget * w, WidgetSizePolicy policy )
23       WidgetSizePolicy widgetSizePolicy ( QWidget * w )
24

DESCRIPTION

26       The QMacStyle class implements an Appearance Manager style.
27
28       This class is implemented as a wrapper to the Apple Appearance Manager.
29       This allows your application to be styled by whatever theme your
30       Macintosh is using. This is done by having primitives in QStyle
31       implemented in terms of what the Macintosh would normally theme (i.e.
32       the Finder).
33
34       There are additional issues that should be taken into consideration to
35       make an application compatible with the Aqua Style Guidelines. Some of
36       these issues are outlined below.
37
38       Layout - The restrictions on window layout are such that some aspects
39       of layout that are style-dependent cannot be achieved using QLayout.
40       Changes are being considered (and feedback would be appreciated) to
41       make layouts QStyle-able. Some of the restrictions involve horizontal
42       and vertical widget alignment and widget size (covered below).
43
44       Widget size - Aqua allows widgets to have specific fixed sizes. Qt does
45       not fully implement this behaviour so as to maintain multiplatform
46       compatibility. As a result some widgets sizes may be inappropriate (and
47       subsequently not rendered correctly by the Appearance Manager).The
48       QWidget::sizeHint() will return the appropriate size for many managed
49       widgets (widgets enumerated in QStyle::ContentsType).
50
51       Effects - QMacStyle (in contrast to QAquaStyle) is not emulating
52       (except where Appearance Manager does not provide certain
53       capabilities), for example QPushButton pulsing effects. In this case a
54       near matching emulation has been implemented, but naturally this will
55       not be identical to the similar functionality built into the Appearance
56       Manager. Please report any issues you see in effects or non-standard
57       widgets.
58
59       There are other issues that need to be considered in the feel of your
60       application (including the general color scheme to match the Aqua
61       colors). The Guidelines mentioned above will remain current with new
62       advances and design suggestions for Mac OS X.
63
64       Note that the functions provided by QMacStyle are reimplementations of
65       QStyle functions; see QStyle for their documentation.
66
67       See also Widget Appearance and Style.
68
69   Member Type Documentation

QMacStyle::FocusRectPolicy

71       This type is used to signify a widget's focus rectangle policy.
72
73       QMacStyle::FocusEnabled - show a focus rectangle when the widget has
74       focus.
75
76       QMacStyle::FocusDisabled - never show a focus rectangle for the widget.
77
78       QMacStyle::FocusDefault - show a focus rectangle when the widget has
79       focus and the widget is a QSpinWidget, QDateTimeEdit, QLineEdit,
80       QListBox, QListView, editable QTextEdit, or one of their subclasses.
81

QMacStyle::WidgetSizePolicy

83       QMacStyle::SizeSmall
84
85       QMacStyle::SizeLarge
86
87       QMacStyle::SizeNone
88
89       QMacStyle::SizeDefault
90

MEMBER FUNCTION DOCUMENTATION

QMacStyle::QMacStyle ()

93       Constructs a QMacStyle object.
94

QMacStyle::~QMacStyle () [virtual]

96       Destructs a QMacStyle object.
97

FocusRectPolicy QMacStyle::focusRectPolicy ( QWidget * w ) [static]

99       Returns the focus rectangle policy for the widget w.
100
101       The focus rectangle policy can be one of QMacStyle::FocusRectPolicy.
102
103       See also setFocusRectPolicy().
104

void QMacStyle::setFocusRectPolicy ( QWidget * w, FocusRectPolicy policy )

106       [static]
107       Sets the focus rectangle policy of w. The policy can be one of
108       QMacStyle::FocusRectPolicy.
109
110       See also focusRectPolicy().
111

void QMacStyle::setWidgetSizePolicy ( QWidget * w, WidgetSizePolicy policy )

113       [static]
114       Sets the widget size policy of w. The policy can be one of
115       QMacStyle::WidgetSizePolicy.
116
117       See also widgetSizePolicy().
118

WidgetSizePolicy QMacStyle::widgetSizePolicy ( QWidget * w ) [static]

120       Returns the widget size policy for the widget w.
121
122       The widget size policy can be one of QMacStyle::WidgetSizePolicy.
123
124       See also setWidgetSizePolicy().
125
126

COPYRIGHT

132       Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com.  See the
133       license file included in the distribution for a complete license
134       statement.
135

AUTHOR

137       Generated automatically from the source code.
138

BUGS

140       If you find a bug in Qt, please report it as described in
141       http://doc.trolltech.com/bughowto.html.  Good bug reports help us to
142       help you. Thank you.
143
144       The definitive Qt documentation is provided in HTML format; it is
145       located at $QTDIR/doc/html and can be read using Qt Assistant or with a
146       web browser. This man page is provided as a convenience for those users
147       who prefer man pages, although this format is not officially supported
148       by Trolltech.
149
150       If you find errors in this manual page, please report them to qt-
151       bugs@trolltech.com.  Please include the name of the manual page
152       (qmacstyle.3qt) and the Qt version (3.3.8).
153
154
155
156Trolltech AS                    2 February 2007                 QMacStyle(3qt)