From bd0f3345a938b35ce6a12f6150373b0955b8dd12 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Sun, 10 Jul 2011 15:24:15 -0500 Subject: Add Qt3 development HEAD version --- doc/html/qmacstyle.html | 160 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 160 insertions(+) create mode 100644 doc/html/qmacstyle.html (limited to 'doc/html/qmacstyle.html') diff --git a/doc/html/qmacstyle.html b/doc/html/qmacstyle.html new file mode 100644 index 0000000..85aa464 --- /dev/null +++ b/doc/html/qmacstyle.html @@ -0,0 +1,160 @@ + + + + + +QMacStyle Class + + + + + + + +

QMacStyle Class Reference

+ +

The QMacStyle class implements an Appearance Manager style. +More... +

#include <qmacstyle_mac.h> +

Inherits QWindowsStyle. +

List of all member functions. +

Public Members

QMacStyle ()
virtual ~QMacStyle ()
enum FocusRectPolicy { FocusEnabled, FocusDisabled, FocusDefault }
enum WidgetSizePolicy { SizeSmall, SizeLarge, SizeNone, SizeDefault }

Static Public Members

void setFocusRectPolicy ( QWidget * w, FocusRectPolicy policy )
FocusRectPolicy focusRectPolicy ( QWidget * w )
void setWidgetSizePolicy ( QWidget * w, WidgetSizePolicy policy )
WidgetSizePolicy widgetSizePolicy ( QWidget * w )

Detailed Description

+ + +The QMacStyle class implements an Appearance Manager style. +

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 QStyle implemented in terms of what the Macintosh would +normally theme (i.e. the Finder). +

There are additional issues that should be taken +into consideration to make an application compatible with the +Aqua Style Guidelines. Some of these issues are outlined +below. +

Layout - The restrictions on window layout are such that some +aspects of layout that are style-dependent cannot be achieved +using QLayout. Changes are being considered (and feedback would be +appreciated) to make layouts QStyle-able. Some of the restrictions +involve horizontal and vertical widget alignment and widget size +(covered below). +
Widget size - Aqua allows widgets to have specific fixed sizes. Qt +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 +QWidget::sizeHint() will return the appropriate size for many +managed widgets (widgets enumerated in QStyle::ContentsType). +
Effects - QMacStyle (in contrast to QAquaStyle) is not emulating +(except where Appearance Manager does not provide certain +capabilities), for example QPushButton 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. +

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. +

Note that the functions provided by QMacStyle are +reimplementations of QStyle functions; see QStyle for their +documentation. +

See also Widget Appearance and Style. + +

Member Type Documentation

QMacStyle::FocusRectPolicy

+ +

This type is used to signify a widget's focus rectangle policy. +

QMacStyle::FocusEnabled - show a focus rectangle when the widget has focus. +
QMacStyle::FocusDisabled - never show a focus rectangle for the widget. +
QMacStyle::FocusDefault - show a focus rectangle when the widget has +focus and the widget is a QSpinWidget, QDateTimeEdit, QLineEdit, +QListBox, QListView, editable QTextEdit, or one of their +subclasses. +

QMacStyle::WidgetSizePolicy

+ +

QMacStyle::SizeSmall +
QMacStyle::SizeLarge +
QMacStyle::SizeNone +
QMacStyle::SizeDefault +

Member Function Documentation

QMacStyle::QMacStyle () +

+Constructs a QMacStyle object. + +

QMacStyle::~QMacStyle () `[virtual]` +

+Destructs a QMacStyle object. + +

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

+Returns the focus rectangle policy for the widget w. +

The focus rectangle policy can be one of QMacStyle::FocusRectPolicy. +

void QMacStyle::setFocusRectPolicy ( QWidget * w, FocusRectPolicy policy ) `[static]` +

+Sets the focus rectangle policy of w. The policy can be one of +QMacStyle::FocusRectPolicy. +

void QMacStyle::setWidgetSizePolicy ( QWidget * w, WidgetSizePolicy policy ) `[static]` +

+Sets the widget size policy of w. The policy can be one of +QMacStyle::WidgetSizePolicy. +

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

+Returns the widget size policy for the widget w. +

The widget size policy can be one of QMacStyle::WidgetSizePolicy. +