675 lines
11 KiB
Plaintext
675 lines
11 KiB
Plaintext
/*!
|
|
\class QskControl QskControl.h
|
|
\ingroup Framework Controls
|
|
|
|
\brief Base class of all controls
|
|
|
|
\states QskControl::Disabled, QskControl::Hovered, QskControl::Focused
|
|
*/
|
|
|
|
/*!
|
|
\var QskControl::Disabled
|
|
|
|
A state bit that is set, when QQuickItem::isEnabled() == false.
|
|
|
|
\extends QskAspect::State
|
|
\sa QskQuickItem::setDisabled()
|
|
\saqt QQuickItem::enabled
|
|
|
|
\var QskControl::Hovered
|
|
|
|
A state bit that is set, when the item is hovered
|
|
It allows to define a specific representation in the skin,
|
|
when being hovered.
|
|
|
|
\saqt QQuickItem::acceptHoverEvents(), QQuickItem::hoverEnterEvent(),
|
|
QQuickItem::hoverLeaveEvent()
|
|
|
|
\var QskControl::Focused
|
|
|
|
A state bit that is set, when the item is the active focus item
|
|
|
|
\sa focusPolicy
|
|
\saqt QQuickItem::acceptHoverEvents(), QQuickItem::focusInEvent()
|
|
QQuickItem::focusOutEvent()
|
|
*/
|
|
|
|
/*!
|
|
\enum QskControl::LayoutHint
|
|
|
|
Hints, that can be used by the layout code
|
|
|
|
\sa setLayoutHint(), testLayoutHint(), setLayoutHints(), layoutHints()
|
|
setAutoLayoutChildren(), QskLinearBox, QskGridBox, QskStackBox
|
|
|
|
\var QskControl::RetainSizeWhenHidden
|
|
|
|
When being enabled the layout code should retain the necessary space
|
|
for the control even when it is hidden.
|
|
|
|
\saqt QSizePolicy::retainSizeWhenHidden()
|
|
|
|
\var QskControl::LayoutWhenHidden
|
|
|
|
When being enabled the layout code should set the geometry
|
|
to the control - even if it is not visible.
|
|
*/
|
|
|
|
/*!
|
|
\property QLocale QskControl::locale
|
|
|
|
\accessors locale(), setLocale(), resetLocale(), localeChanged()
|
|
*/
|
|
|
|
/*!
|
|
\property bool QskControl::autoFillBackground
|
|
|
|
This property holds whether the background is filled automatically
|
|
with the background gradient.
|
|
|
|
\accessors autoFillBackground(), setAutoFillBackground()
|
|
|
|
\sa background()
|
|
\saqt QWidget::autoFillBackground
|
|
|
|
*/
|
|
|
|
/*!
|
|
\property bool QskControl::autoLayoutChildren
|
|
|
|
\accessors autoLayoutChildren(), setAutoLayoutChildren()
|
|
*/
|
|
|
|
/*!
|
|
\property Qt::FocusPolicy QskControl::focusPolicy
|
|
|
|
\accessors focusPolicy(), setFocusPolicy(), focusPolicyChanged()
|
|
*/
|
|
|
|
/*!
|
|
\property bool QskControl::wheelEnabled
|
|
|
|
\accessors isWheelEnabled(), setWheelEnabled(), wheelEnabledChanged()
|
|
*/
|
|
|
|
/*!
|
|
\property bool QskControl::visibleToLayout
|
|
|
|
\accessors isVisibleToLayout()
|
|
*/
|
|
|
|
/*!
|
|
\property QskMargins QskControl::margins
|
|
|
|
\accessors margins(), setMargins(), resetMargins(), marginsChanged()
|
|
*/
|
|
|
|
/*!
|
|
\property QskGradient QskControl::background
|
|
|
|
\accessors background(), setBackground(), resetBackground(), backgroundChanged()
|
|
*/
|
|
|
|
/*!
|
|
\property QskSizePolicy QskControl::sizePolicy
|
|
|
|
\accessors sizePolicy(), setSizePolicy()
|
|
*/
|
|
|
|
/*!
|
|
\property bool QskControl::autoLayoutChildren
|
|
|
|
\accessors autoLayoutChildren(), setAutoLayoutChildren()
|
|
*/
|
|
|
|
/*!
|
|
\property QSizeF QskControl::minimumSize
|
|
|
|
\accessors minimumSize(), setMinimumSize()
|
|
\sa effectiveSizeHint(), setExplicitSizeHint()
|
|
setMinimumWidth(), setMinimumHeight()
|
|
*/
|
|
|
|
/*!
|
|
\property QSizeF QskControl::maximumSize
|
|
|
|
\accessors maximumSize(), setMaximumSize()
|
|
\sa effectiveSizeHint(), setExplicitSizeHint()
|
|
setMaximumWidth(), setMaximumHeight()
|
|
*/
|
|
|
|
/*!
|
|
\property QSizeF QskControl::preferredSize
|
|
|
|
\accessors preferredSize(), setPreferredSize()
|
|
\sa effectiveSizeHint(), setExplicitSizeHint(),
|
|
setPreferredWidth(), setPreferredHeight()
|
|
*/
|
|
|
|
/*!
|
|
\property QSizeF QskControl::sizeConstraint
|
|
|
|
\accessors sizeConstraint()
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::QskControl
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::~QskControl
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setMargins( qreal )
|
|
|
|
Sets the margins around the contents of the control
|
|
|
|
The value is stored in the local hint table for the aspect:
|
|
QskControl::Control | QskAspect::Metric | QskAspect::Margin
|
|
|
|
\param margin Margin for all sides
|
|
\aspect QskControl::Control | QskAspect::Metric | QskAspect::Margin
|
|
|
|
\sa contentsRect(), margins(), QskSkinnable::setMarginHint()
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setMargins( const QMarginsF& )
|
|
|
|
Sets the margins around the contents of the control
|
|
|
|
\param margins Margins
|
|
\aspect QskControl::Control | QskAspect::Metric | QskAspect::Margin
|
|
|
|
\sa contentsRect(), margins()
|
|
\saqt QEvent::ContentsRectChange
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::resetMargins
|
|
|
|
Reset the margins to the default value provided from the skin
|
|
|
|
\aspect QskControl::Control | QskAspect::Metric | QskAspect::Margin
|
|
|
|
\sa contentsRect(), setMargins(), margins()
|
|
\saqt QEvent::ContentsRectChange
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::margins() const
|
|
|
|
\return margins around the contents of the control
|
|
\aspect QskControl::Control | QskAspect::Metric | QskAspect::Margin
|
|
|
|
\sa contentsRect(), setMargins()
|
|
\saqt QEvent::ContentsRectChange
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setBackgroundColor
|
|
|
|
A conveninece method that enables the autoFillBackground property
|
|
and sets a solid color as background. Usually used for debugging
|
|
layout problems.
|
|
|
|
\sa setBackground(), setAutoFillBackground()
|
|
\sa QskQuickItem::DebugForceBackground
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setBackground
|
|
|
|
Set the gradient that is used to fill the background,
|
|
when autoFillBackground is enabled.
|
|
|
|
\aspect QskControl::Control | QskAspect::Color
|
|
\sa resetBackground(), background(), autoFillBackground()
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::resetBackground
|
|
|
|
Reset the background gradient to the default colors from the skin
|
|
|
|
\aspect QskControl::Control | QskAspect::Color
|
|
\sa setBackground(), background(), autoFillBackground()
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::background() const
|
|
|
|
\return Gradient that is used to fill the background,
|
|
when autoFillBackground is enabled.
|
|
|
|
\aspect QskControl::Control | QskAspect::Color
|
|
\sa setBackground(), resetBackground(), autoFillBackground()
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::contentsRect
|
|
|
|
\sa margins(), setMargins(),
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::layoutRect
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::layoutRectForSize
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::gestureRect
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::focusIndicatorRect
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::focusIndicatorClipRect
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::subControlRect( QskAspect::Subcontrol ) const
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::subControlRect( const QSizeF&, QskAspect::Subcontrol ) const
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::subControlContentsRect( QskAspect::Subcontrol ) const
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::subControlContentsRect( const QSizeF&, QskAspect::Subcontrol ) const
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setAutoFillBackground
|
|
|
|
Set or clear the autoFillBackground property
|
|
\sa autoFillBackground()
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::autoFillBackground() const
|
|
|
|
\return Value of the autoFillBackground property
|
|
\sa setAutoFillBackground()
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setAutoLayoutChildren
|
|
|
|
Set or clear the autoLayoutChildren property
|
|
\sa autoFillBackground()
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::autoLayoutChildren() const
|
|
|
|
\return Value of the autoLayoutChildren property
|
|
\sa autoLayoutChildren()
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setWheelEnabled
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::isWheelEnabled
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setFocusPolicy
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::focusPolicy() const
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setSizePolicy( QskSizePolicy );
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setSizePolicy( QskSizePolicy::Policy, QskSizePolicy::Policy )
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setSizePolicy( Qt::Orientation, QskSizePolicy::Policy )
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::sizePolicy() const
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::sizePolicy( Qt::Orientation ) const
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setLayoutAlignmentHint
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::layoutAlignmentHint
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setLayoutHint
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::testLayoutHint
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setLayoutHints
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::layoutHints
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::isVisibleToLayout
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setMinimumSize( const QSizeF& )
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setMinimumSize( qreal, qreal )
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setMinimumWidth
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setMinimumHeight
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setMaximumSize( const QSizeF& )
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setMaximumSize( qreal, qreal )
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setMaximumWidth
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setMaximumHeight
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setPreferredSize( const QSizeF& )
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setPreferredSize( qreal, qreal )
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setPreferredWidth
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setPreferredHeight
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setFixedSize( const QSizeF& );
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setFixedSize( qreal width, qreal height );
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setFixedWidth
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setFixedHeight
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setExplicitSizeHint( Qt::SizeHint, const QSizeF& );
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::setExplicitSizeHint( Qt::SizeHint, qreal width, qreal height );
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::resetExplicitSizeHint
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::minimumSize() const;
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::maximumSize() const;
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::preferredSize() const;
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::explicitSizeHint
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::implicitSizeHint
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::sizeHint
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::heightForWidth
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::widthForHeight
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::effectiveSizeHint
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::sizeConstraint( Qt::SizeHint, const QSizeF& ) const
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::sizeConstraint() const
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::locale() const
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::resetLocale
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn QskControl::subControls
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::backgroundChanged
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::marginsChanged
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::focusIndicatorRectChanged
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::localeChanged
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::focusPolicyChanged
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::wheelEnabledChanged
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::setLocale
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn bool QskControl::event
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn virtual void QskControl::gestureEvent
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::hoverEnterEvent
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::hoverLeaveEvent
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn bool QskControl::childMouseEventFilter
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn virtual bool QskControl::gestureFilter
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::itemChange
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::geometryChange
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn void QskControl::initSizePolicy
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn virtual void QskControl::updateResources
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn virtual void QskControl::updateLayout
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn virtual QSizeF QskControl::contentsSizeHint
|
|
|
|
*/
|
|
|
|
/*!
|
|
\fn virtual QSizeF QskControl::layoutSizeHint
|
|
|
|
*/
|