QSkinny 0.8.0
C++/Qt UI toolkit
|
Base class of all controls. More...
#include <QskControl.h>
Base class of all controls.
QskControl combines the themeability implemented in QskSkinnable with what is needed to support a layout system, that is on par with what is known from Qt/Widgets.
Definition at line 22 of file QskControl.h.
Inherits QskItem, and QskSkinnable.
Inherited by QskAbstractButton, QskBoundedControl, QskBox, QskComboBox, QskFocusIndicator, QskGraphicLabel, QskInputGrabber, QskInputPanel, QskPageIndicator, QskPopup, QskRadioBox, QskScrollBox, QskSegmentedBar, QskSeparator, QskStatusIndicator, QskSubWindowArea, QskTabView, QskTextInput, and QskTextLabel.
Public Slots | |
void | setLocale (const QLocale &) |
Public Slots inherited from QskItem | |
void | setGeometry (const QRectF &) |
void | show () |
void | hide () |
void | setHidden (bool) |
void | setDisabled (bool) |
void | resetImplicitSize () |
Signals | |
void | backgroundChanged () |
void | sectionChanged (QskAspect::Section) |
void | marginsChanged (const QMarginsF &) |
void | focusIndicatorRectChanged () |
void | localeChanged (const QLocale &) |
Signals inherited from QskItem | |
void | wheelEnabledChanged (bool) |
void | focusPolicyChanged (Qt::FocusPolicy) |
void | itemFlagsChanged () |
void | updateFlagsChanged (UpdateFlags) |
Public Member Functions | |
QskControl (QQuickItem *parent=nullptr) | |
~QskControl () override | |
void | setMargins (qreal) |
void | setMargins (qreal, qreal, qreal, qreal) |
void | setMargins (const QMarginsF &) |
void | resetMargins () |
QMarginsF | margins () const |
void | setBackground (const QskGradient &) |
void | resetBackground () |
QskGradient | background () const |
void | setBackgroundColor (const QColor &) |
QRectF | contentsRect () const |
QRectF | layoutRect () const |
virtual QRectF | layoutRectForSize (const QSizeF &) const |
virtual QRectF | focusIndicatorRect () const |
virtual QRectF | focusIndicatorClipRect () const |
QRectF | subControlRect (QskAspect::Subcontrol) const |
QRectF | subControlRect (const QSizeF &, QskAspect::Subcontrol) const |
QRectF | subControlContentsRect (QskAspect::Subcontrol) const |
QRectF | subControlContentsRect (const QSizeF &, QskAspect::Subcontrol) const |
void | setAutoLayoutChildren (bool) |
bool | autoLayoutChildren () const |
void | setSection (QskAspect::Section) |
void | resetSection () |
QskAspect::Section | section () const override final |
void | setSizePolicy (QskSizePolicy) |
void | setSizePolicy (QskSizePolicy::Policy, QskSizePolicy::Policy) |
void | setSizePolicy (Qt::Orientation, QskSizePolicy::Policy) |
QskSizePolicy | sizePolicy () const |
QskSizePolicy::Policy | sizePolicy (Qt::Orientation) const |
void | setLayoutAlignmentHint (Qt::Alignment) |
Qt::Alignment | layoutAlignmentHint () const |
void | setPlacementPolicy (QskPlacementPolicy) |
void | setPlacementPolicy (QskPlacementPolicy::Policy, QskPlacementPolicy::Policy) |
void | setPlacementPolicy (Qsk::Visibilities, QskPlacementPolicy::Policy) |
void | resetPlacementPolicy () |
QskPlacementPolicy | placementPolicy () const |
QskPlacementPolicy::Policy | placementPolicy (Qsk::Visibility) const |
QskPlacementPolicy::Policy | effectivePlacementPolicy () const |
bool | isVisibleToLayout () const |
void | setMinimumSize (const QSizeF &) |
void | setMinimumSize (qreal width, qreal height) |
void | setMinimumWidth (qreal width) |
void | setMinimumHeight (qreal height) |
void | setMaximumSize (const QSizeF &) |
void | setMaximumSize (qreal width, qreal height) |
void | setMaximumWidth (qreal width) |
void | setMaximumHeight (qreal height) |
void | setPreferredSize (const QSizeF &) |
void | setPreferredSize (qreal width, qreal height) |
void | setPreferredWidth (qreal width) |
void | setPreferredHeight (qreal height) |
void | setFixedSize (const QSizeF &) |
void | setFixedSize (qreal width, qreal height) |
void | setFixedWidth (qreal width) |
void | setFixedHeight (qreal height) |
void | setExplicitSizeHint (Qt::SizeHint, const QSizeF &) |
void | setExplicitSizeHint (Qt::SizeHint, qreal width, qreal height) |
void | resetExplicitSizeHint (Qt::SizeHint) |
QSizeF | minimumSize () const |
QSizeF | maximumSize () const |
QSizeF | preferredSize () const |
QSizeF | explicitSizeHint (Qt::SizeHint) const |
QSizeF | implicitSizeHint (Qt::SizeHint, const QSizeF &constraint) const |
QSizeF | sizeHint () const |
qreal | heightForWidth (qreal width) const |
qreal | widthForHeight (qreal height) const |
QSizeF | effectiveSizeHint (Qt::SizeHint, const QSizeF &constraint=QSizeF()) const |
QSizeF | sizeConstraint (Qt::SizeHint, const QSizeF &constraint=QSizeF()) const |
QSizeF | sizeConstraint () const |
QLocale | locale () const |
void | resetLocale () |
QVector< QskAspect::Subcontrol > | subControls () const |
QRectF | subControlRect (const QRectF &, QskAspect::Subcontrol) const |
Calculate position and size of a subControl. | |
QRectF | subControlContentsRect (const QRectF &, QskAspect::Subcontrol) const |
Calculate the inner rectangle for subControl. | |
Public Member Functions inherited from QskItem | |
const char * | className () const |
bool | isVisibleTo (const QQuickItem *) const |
bool | isVisibleToParent () const |
bool | hasChildItems () const |
QRectF | rect () const |
QSizeF | implicitSize () const |
void | setGeometry (qreal x, qreal y, qreal width, qreal height) |
void | setGeometry (const QPointF &, const QSizeF &) |
QRectF | geometry () const |
void | setPosition (qreal x, qreal y) |
void | setSize (qreal width, qreal height) |
void | setPolishOnResize (bool) |
bool | polishOnResize () const |
void | setPolishOnParentResize (bool) |
bool | polishOnParentResize () const |
void | setFocusPolicy (Qt::FocusPolicy) |
Qt::FocusPolicy | focusPolicy () const |
void | setTabFence (bool) |
bool | isTabFence () const |
void | setWheelEnabled (bool) |
bool | isWheelEnabled () const |
void | setLayoutMirroring (bool on, bool childrenInherit=false) |
void | resetLayoutMirroring () |
bool | layoutMirroring () const |
void | resetUpdateFlags () |
UpdateFlags | updateFlags () const |
void | setUpdateFlag (UpdateFlag, bool on=true) |
void | resetUpdateFlag (UpdateFlag) |
bool | testUpdateFlag (UpdateFlag) const |
void | classBegin () override |
void | componentComplete () override |
void | releaseResources () override |
bool | isPolishScheduled () const |
bool | isUpdateNodeScheduled () const |
bool | isInitiallyPainted () const |
bool | maybeUnresized () const |
Public Member Functions inherited from QskSkinnable | |
QskSkinnable () | |
virtual | ~QskSkinnable () |
void | setSkinlet (const QskSkinlet *) |
Set an individual skinlet to render/display the content. | |
const QskSkinlet * | skinlet () const |
QFont | effectiveFont (QskAspect) const |
qreal | effectiveFontHeight (QskAspect) const |
QskColorFilter | effectiveGraphicFilter (QskAspect::Subcontrol) const |
void | setSubcontrolProxy (QskAspect::Subcontrol, QskAspect::Subcontrol proxy) |
void | resetSubcontrolProxy (QskAspect::Subcontrol) |
QskAspect::Subcontrol | subcontrolProxy (QskAspect::Subcontrol) const |
bool | setAnimationHint (QskAspect, QskAnimationHint) |
QskAnimationHint | animationHint (QskAspect, QskSkinHintStatus *=nullptr) const |
bool | hasAnimationHint (QskAspect) const |
bool | setSkinHint (QskAspect, const QVariant &) |
Insert a hint into the local hint table. | |
bool | resetSkinHint (QskAspect) |
Remove a hint from the local hint table. | |
bool | moveSkinHint (QskAspect, const QVariant &) |
bool | moveSkinHint (QskAspect, const QVariant &, const QVariant &) |
QskAnimationHint | effectiveAnimation (QskAspect::Type, QskAspect::Subcontrol, QskAspect::States, QskSkinHintStatus *status=nullptr) const |
QVariant | effectiveSkinHint (QskAspect, QskSkinHintStatus *=nullptr) const |
Find the value for a specific aspect. | |
virtual QskAspect::Variation | effectiveVariation () const |
QskSkinHintStatus | hintStatus (QskAspect) const |
QRectF | subControlRect (const QRectF &, QskAspect::Subcontrol) const |
Calculate position and size of a subControl. | |
QRectF | subControlContentsRect (const QRectF &, QskAspect::Subcontrol) const |
Calculate the inner rectangle for subControl. | |
QSizeF | outerBoxSize (QskAspect, const QSizeF &innerBoxSize) const |
Calculate the size, when being expanded by paddings, indentations. | |
QSizeF | innerBoxSize (QskAspect, const QSizeF &outerBoxSize) const |
Calculate the size, with paddings, indentations being subtracted. | |
QRectF | innerBox (QskAspect, const QRectF &outerBox) const |
Calculate the rectangle, whith paddings, indentations being subtracted. | |
QRectF | outerBox (QskAspect, const QRectF &innerBox) const |
Calculate the rectangle, when being expanded by paddings, indentations. | |
QMarginsF | innerPadding (QskAspect, const QSizeF &) const |
Calculate the padding from attributes for the given aspect. | |
const QskSkinlet * | effectiveSkinlet () const |
QskSkin * | effectiveSkin () const |
void | startTransition (QskAspect, QskAnimationHint, const QVariant &from, const QVariant &to) |
void | startTransition (QskAspect, int index, QskAnimationHint, const QVariant &from, const QVariant &to) |
QskAspect::Subcontrol | effectiveSubcontrol (QskAspect::Subcontrol) const |
QskControl * | controlCast () |
const QskControl * | controlCast () const |
virtual const QMetaObject * | metaObject () const =0 |
void | debug (QskAspect) const |
void | debug (QskAspect::State) const |
void | debug (QDebug, QskAspect) const |
void | debug (QDebug, QskAspect::State) const |
void | setSkinStates (QskAspect::States) |
void | setSkinStateFlag (QskAspect::State, bool on=true) |
void | addSkinStates (QskAspect::States) |
void | clearSkinStates (QskAspect::States) |
bool | hasSkinState (QskAspect::State) const |
QskAspect::States | skinStates () const |
const char * | skinStatesAsPrintable () const |
const char * | skinStatesAsPrintable (QskAspect::States) const |
bool | setColor (QskAspect, Qt::GlobalColor) |
Sets a color hint. | |
bool | setColor (QskAspect, QRgb) |
Sets a color hint. | |
bool | setColor (QskAspect, const QColor &) |
Sets a color hint. | |
bool | moveColor (QskAspect, Qt::GlobalColor) |
bool | moveColor (QskAspect, QRgb) |
bool | moveColor (QskAspect, const QColor &) |
bool | resetColor (QskAspect) |
Removes a color hint from the local table. | |
QColor | color (QskAspect, QskSkinHintStatus *=nullptr) const |
Retrieves a color hint. | |
bool | setMetric (QskAspect, qreal) |
Sets a metric hint. | |
bool | moveMetric (QskAspect, qreal) |
bool | resetMetric (QskAspect) |
Removes a metric hint from the local table. | |
qreal | metric (QskAspect, QskSkinHintStatus *=nullptr) const |
Retrieves a metric hint. | |
bool | setFlagHint (QskAspect, int flag) |
Sets a flag hint. | |
template<typename T > | |
T | flagHint (QskAspect, T=T()) const |
Retrieves a flag hint. | |
bool | setPositionHint (QskAspect, qreal) |
bool | movePositionHint (QskAspect, qreal) |
bool | movePositionHint (QskAspect, qreal from, qreal to) |
bool | resetPositionHint (QskAspect) |
qreal | positionHint (QskAspect, QskSkinHintStatus *=nullptr) const |
bool | setStrutSizeHint (QskAspect, const QSizeF &) |
Sets a metric hint. | |
bool | setStrutSizeHint (QskAspect, qreal width, qreal height) |
Sets a strut size hint. | |
bool | resetStrutSizeHint (QskAspect) |
Removes a strut size hint from the local table. | |
QSizeF | strutSizeHint (QskAspect, QskSkinHintStatus *=nullptr) const |
Retrieves a strut size hint. | |
bool | setMarginHint (QskAspect, qreal) |
Sets a margin hint. | |
bool | setMarginHint (QskAspect, const QMarginsF &) |
Sets a margin hint. | |
bool | resetMarginHint (QskAspect) |
Removes a margin hint from the local table. | |
QMarginsF | marginHint (QskAspect, QskSkinHintStatus *=nullptr) const |
Retrieves a margin hint. | |
bool | setPaddingHint (QskAspect, qreal) |
Sets a padding hint. | |
bool | setPaddingHint (QskAspect, const QMarginsF &) |
Sets a padding hint. | |
bool | resetPaddingHint (QskAspect) |
Removes a padding hint from the local table. | |
QMarginsF | paddingHint (QskAspect, QskSkinHintStatus *=nullptr) const |
Retrieves a padding hint. | |
bool | setGradientHint (QskAspect, const QskGradient &) |
Sets a gradient as color hint. | |
QskGradient | gradientHint (QskAspect, QskSkinHintStatus *=nullptr) const |
Retrieves a color hint as gradient. | |
bool | setBoxShapeHint (QskAspect, const QskBoxShapeMetrics &) |
Sets a shape hint. | |
bool | resetBoxShapeHint (QskAspect) |
Removes a shape hint from the local table. | |
QskBoxShapeMetrics | boxShapeHint (QskAspect, QskSkinHintStatus *=nullptr) const |
Retrieves a shape hint. | |
bool | setBoxBorderMetricsHint (QskAspect, const QskBoxBorderMetrics &) |
Sets a border metrics hint. | |
bool | resetBoxBorderMetricsHint (QskAspect) |
Removes a border metrics hint from the local table. | |
QskBoxBorderMetrics | boxBorderMetricsHint (QskAspect, QskSkinHintStatus *=nullptr) const |
Retrieves a border hint. | |
bool | setBoxBorderColorsHint (QskAspect, const QskBoxBorderColors &) |
Sets a border colors hint. | |
bool | resetBoxBorderColorsHint (QskAspect) |
Removes a border colors hint from the local table. | |
QskBoxBorderColors | boxBorderColorsHint (QskAspect, QskSkinHintStatus *=nullptr) const |
Retrieves border colors hint. | |
bool | setShadowMetricsHint (QskAspect, const QskShadowMetrics &) |
bool | resetShadowMetricsHint (QskAspect) |
QskShadowMetrics | shadowMetricsHint (QskAspect, QskSkinHintStatus *=nullptr) const |
bool | setShadowColorHint (QskAspect, const QColor &) |
bool | resetShadowColorHint (QskAspect) |
QColor | shadowColorHint (QskAspect, QskSkinHintStatus *=nullptr) const |
QskBoxHints | boxHints (QskAspect) const |
bool | setArcMetricsHint (QskAspect, const QskArcMetrics &) |
bool | resetArcMetricsHint (QskAspect) |
QskArcMetrics | arcMetricsHint (QskAspect, QskSkinHintStatus *=nullptr) const |
bool | setStippleMetricsHint (QskAspect, const QskStippleMetrics &) |
bool | resetStippleMetricsHint (QskAspect) |
QskStippleMetrics | stippleMetricsHint (QskAspect, QskSkinHintStatus *=nullptr) const |
bool | setSpacingHint (QskAspect, qreal) |
Sets a spacing hint. | |
bool | resetSpacingHint (QskAspect) |
Removes a spacing hint from the local table. | |
qreal | spacingHint (QskAspect, QskSkinHintStatus *=nullptr) const |
Retrieves a spacing hint. | |
bool | setAlignmentHint (QskAspect, Qt::Alignment) |
Sets an alignment hint. | |
bool | resetAlignmentHint (QskAspect) |
Removes an alignment hint from the local table. | |
Qt::Alignment | alignmentHint (QskAspect, Qt::Alignment=Qt::Alignment()) const |
Retrieves an alignment hint. | |
bool | setTextOptionsHint (QskAspect, const QskTextOptions &) |
bool | resetTextOptionsHint (QskAspect) |
QskTextOptions | textOptionsHint (QskAspect, QskSkinHintStatus *=nullptr) const |
bool | setFontRoleHint (QskAspect, const QskFontRole &) |
Sets a font role hint. | |
bool | resetFontRoleHint (QskAspect) |
Removes a font role hint from the local table. | |
QskFontRole | fontRoleHint (QskAspect, QskSkinHintStatus *=nullptr) const |
Retrieves a font role hint. | |
bool | setGraphicRoleHint (QskAspect, int role) |
Sets a graphic role hint. | |
bool | resetGraphicRoleHint (QskAspect) |
Removes a graphic role hint from the local table. | |
int | graphicRoleHint (QskAspect, QskSkinHintStatus *=nullptr) const |
A Retrieves a graphic role hint. | |
bool | setSymbolHint (const QskAspect, const QskGraphic &) |
bool | resetSymbolHint (const QskAspect) |
QskGraphic | symbolHint (const QskAspect, QskSkinHintStatus *=nullptr) const |
const QskSkinHintTable & | hintTable () const |
Accessor for local skin hint table. | |
bool | startHintTransitions (QskAspect::States, QskAspect::States, int index=-1) |
bool | startHintTransitions (const QVector< QskAspect::Subcontrol > &, QskAspect::States, QskAspect::States, int index=-1) |
const QskHintAnimator * | runningHintAnimator (QskAspect, int index=-1) const |
Static Public Attributes | |
static const QskAspect::Subcontrol | Background |
static const QskAspect::State | Disabled |
static const QskAspect::State | Hovered |
static const QskAspect::State | Focused |
Protected Member Functions | |
bool | event (QEvent *) override |
virtual void | gestureEvent (QskGestureEvent *) |
void | hoverEnterEvent (QHoverEvent *) override |
void | hoverLeaveEvent (QHoverEvent *) override |
bool | childMouseEventFilter (QQuickItem *, QEvent *) override |
void | itemChange (ItemChange, const ItemChangeData &) override |
void | geometryChange (const QRectF &, const QRectF &) override |
void | initSizePolicy (QskSizePolicy::Policy, QskSizePolicy::Policy) |
virtual void | updateResources () |
virtual void | updateLayout () |
virtual QSizeF | contentsSizeHint (Qt::SizeHint, const QSizeF &) const |
virtual QSizeF | layoutSizeHint (Qt::SizeHint, const QSizeF &) const |
Protected Member Functions inherited from QskItem | |
QskItem (QskItemPrivate &, QQuickItem *=nullptr) | |
bool | event (QEvent *) override |
virtual void | changeEvent (QEvent *) |
virtual void | geometryChangeEvent (QskGeometryChangeEvent *) |
virtual void | windowChangeEvent (QskWindowChangeEvent *) |
void | mouseUngrabEvent () override |
void | touchUngrabEvent () override |
void | itemChange (ItemChange, const ItemChangeData &) override |
void | geometryChange (const QRectF &, const QRectF &) override |
virtual void | aboutToShow () |
Protected Member Functions inherited from QskSkinnable | |
virtual void | updateNode (QSGNode *) |
virtual bool | isTransitionAccepted (QskAspect) const |
Additional check if an transition should be started. | |
virtual QskAspect::Subcontrol | substitutedSubcontrol (QskAspect::Subcontrol) const |
QskSkinHintTable & | hintTable () |
Accessor for local skin hint table. | |
Properties | |
QLocale | locale |
QskAspect::Section | section |
bool | autoLayoutChildren |
bool | visibleToLayout |
QskMargins | margins |
QskGradient | background |
QskSizePolicy | sizePolicy |
QskPlacementPolicy | placementPolicy |
QSizeF | minimumSize |
QSizeF | maximumSize |
QSizeF | preferredSize |
QSizeF | sizeConstraint |
Properties inherited from QskItem | |
QRectF | geometry |
QRectF | rect |
bool | tabFence |
bool | polishOnResize |
bool | polishOnParentResize |
Qt::FocusPolicy | focusPolicy |
bool | wheelEnabled |
bool | visibleToParent |
bool | hasChildItems |
bool | initiallyPainted |
UpdateFlags | updateFlags |
Additional Inherited Members | |
Public Types inherited from QskItem | |
enum | UpdateFlag { DeferredUpdate = 1 << 0 , DeferredPolish = 1 << 1 , DeferredLayout = 1 << 2 , CleanupOnVisibility = 1 << 3 , PreferRasterForTextures = 1 << 4 , DebugForceBackground = 1 << 7 } |
QskControl::QskControl | ( | QQuickItem * | parent = nullptr | ) |
Initializes focusPolicy to Qt::NoFocus and disables processing of wheel events. The default sizePolicy is QskSizePolicy::Preferred in vertical and horizontal direction.
Definition at line 49 of file QskControl.cpp.
|
override |
Destructor
Definition at line 60 of file QskControl.cpp.
bool QskControl::autoLayoutChildren | ( | ) | const |
Definition at line 87 of file QskControl.cpp.
QskGradient QskControl::background | ( | ) | const |
Definition at line 109 of file QskControl.cpp.
|
signal |
Signal indicating, that the value of the background property has changed
|
overrideprotected |
Definition at line 805 of file QskControl.cpp.
QRectF QskControl::contentsRect | ( | ) | const |
Returns the area inside the controls's margins.
contentsRect() is a rectangle being used for laying out scene graph nodes, while layoutRect() is used for child items.
Definition at line 149 of file QskControl.cpp.
|
protectedvirtual |
Definition at line 975 of file QskControl.cpp.
QskPlacementPolicy::Policy QskControl::effectivePlacementPolicy | ( | ) | const |
Definition at line 395 of file QskControl.cpp.
QSizeF QskControl::effectiveSizeHint | ( | Qt::SizeHint | which, |
const QSizeF & | constraint = QSizeF() |
||
) | const |
Definition at line 609 of file QskControl.cpp.
|
overrideprotected |
Definition at line 710 of file QskControl.cpp.
QSizeF QskControl::explicitSizeHint | ( | Qt::SizeHint | whichHint | ) | const |
Definition at line 573 of file QskControl.cpp.
|
virtual |
This is a specific rectangle, that can be returned to clip the focus indicator being displayed for a child item.
The default implementation return QQuickItem::contentsRect()
Definition at line 962 of file QskControl.cpp.
|
virtual |
Returns the rectangle where to draw the focus indicator
For controls, that implement some sort of internal focus chain ( list boxes, sliders with more handles ... ) the rectangle might change according to the state of the control.
The default implementation return contentsRect()
Reimplemented in QskListView, QskMenu, QskRadioBox, and QskSegmentedBar.
Definition at line 957 of file QskControl.cpp.
|
signal |
Signal indicating that the value of the focusIndicatorRect() has changed.
|
overrideprotected |
Overload, that schedules a re-layouting of the child items when autoLayoutChildren() is enabled.
Definition at line 890 of file QskControl.cpp.
|
protectedvirtual |
Definition at line 828 of file QskControl.cpp.
qreal QskControl::heightForWidth | ( | qreal | width | ) | const |
Definition at line 688 of file QskControl.cpp.
|
overrideprotected |
Sets the Hovered state
Definition at line 832 of file QskControl.cpp.
|
overrideprotected |
Clears the Hovered state
Definition at line 838 of file QskControl.cpp.
QSizeF QskControl::implicitSizeHint | ( | Qt::SizeHint | whichHint, |
const QSizeF & | constraint | ||
) | const |
Definition at line 581 of file QskControl.cpp.
|
protected |
A simpler version of setSizePolicy(), that does not send a QEvent::LayouRequest to the parentItem(). It is used in constructors of derived controls.
Definition at line 256 of file QskControl.cpp.
bool QskControl::isVisibleToLayout | ( | ) | const |
Return true, when the control is relevant for layout calculations
A control has an impact on the layout calutaions, when:
Definition at line 400 of file QskControl.cpp.
|
overrideprotected |
Overload, that updates certain QSkinny specific attributes
Definition at line 844 of file QskControl.cpp.
Qt::Alignment QskControl::layoutAlignmentHint | ( | ) | const |
Definition at line 344 of file QskControl.cpp.
QRectF QskControl::layoutRect | ( | ) | const |
Returns the area for laying out child items
layoutRect() is a rectangle being used for laying out child items, while contentsRect() is used for scene graph nodes.
F.e QskBox::layoutRect() returns an area that fits inside the ( maybe rounded ) borders, while the borders itself are rendered into the contentsRect().
The implementation relies on layoutRectForSize()
Definition at line 941 of file QskControl.cpp.
|
virtual |
Returns the geometry where to lay out child items for a given size.
layoutRectForSize() is intended to be overloaded, when layoutRect() is supposed differ from contentsRect()
size | Size Bounding size for the control |
Reimplemented in QskBox, QskDrawer, QskPushButton, QskSubWindow, and QskTabButton.
Definition at line 951 of file QskControl.cpp.
|
protectedvirtual |
Definition at line 981 of file QskControl.cpp.
QLocale QskControl::locale | ( | ) | const |
Definition at line 182 of file QskControl.cpp.
|
signal |
QMarginsF QskControl::margins | ( | ) | const |
Definition at line 144 of file QskControl.cpp.
|
signal |
|
inline |
Definition at line 224 of file QskControl.h.
|
inline |
Definition at line 219 of file QskControl.h.
|
finaloverrideprivatevirtual |
Implements QskSkinnable.
Definition at line 936 of file QskControl.cpp.
QskPlacementPolicy QskControl::placementPolicy | ( | ) | const |
Definition at line 382 of file QskControl.cpp.
QskPlacementPolicy::Policy QskControl::placementPolicy | ( | Qsk::Visibility | visiblity | ) | const |
Definition at line 390 of file QskControl.cpp.
|
inline |
Definition at line 229 of file QskControl.h.
void QskControl::resetBackground | ( | ) |
Reset the background gradient to the default colors from the skin
Definition at line 103 of file QskControl.cpp.
void QskControl::resetExplicitSizeHint | ( | Qt::SizeHint | whichHint | ) |
Definition at line 536 of file QskControl.cpp.
void QskControl::resetLocale | ( | ) |
Reset the locale to be inherited from the parentItem()
Definition at line 204 of file QskControl.cpp.
void QskControl::resetMargins | ( | ) |
Reset the margins to the default value provided from the skin
Definition at line 135 of file QskControl.cpp.
void QskControl::resetPlacementPolicy | ( | ) |
Definition at line 377 of file QskControl.cpp.
void QskControl::resetSection | ( | ) |
Definition at line 240 of file QskControl.cpp.
|
finaloverridevirtual |
Reimplemented from QskSkinnable.
Definition at line 251 of file QskControl.cpp.
void QskControl::setAutoLayoutChildren | ( | bool | on | ) |
Set or clear the autoLayoutChildren property
Definition at line 76 of file QskControl.cpp.
void QskControl::setBackground | ( | const QskGradient & | gradient | ) |
Set the gradient that is used to fill the background,
Definition at line 97 of file QskControl.cpp.
void QskControl::setBackgroundColor | ( | const QColor & | color | ) |
A conveninece method for setting a monochrome gradient as background. Often used for debugging layout problems.
Definition at line 92 of file QskControl.cpp.
void QskControl::setExplicitSizeHint | ( | Qt::SizeHint | whichHint, |
const QSizeF & | size | ||
) |
Definition at line 550 of file QskControl.cpp.
void QskControl::setExplicitSizeHint | ( | Qt::SizeHint | whichHint, |
qreal | width, | ||
qreal | height | ||
) |
Definition at line 567 of file QskControl.cpp.
void QskControl::setFixedHeight | ( | qreal | height | ) |
Sets the height of the explicit size hint for Qt::PreferredSize and changes the vertical size policy to QskSizePolicy::Fixed.
Definition at line 515 of file QskControl.cpp.
void QskControl::setFixedSize | ( | const QSizeF & | size | ) |
Sets the explicit size hint for Qt::PreferredSize and changes the size policy to QskSizePolicy::Fixed for both orientations.
Definition at line 471 of file QskControl.cpp.
void QskControl::setFixedSize | ( | qreal | width, |
qreal | height | ||
) |
Sets the explicit size hint for Qt::PreferredSize and changes the size policy to QskSizePolicy::Fixed for both orientations.
Definition at line 489 of file QskControl.cpp.
void QskControl::setFixedWidth | ( | qreal | width | ) |
Sets the width of the explicit size hint for Qt::PreferredSize and changes the horizontal size policy to QskSizePolicy::Fixed.
Definition at line 494 of file QskControl.cpp.
void QskControl::setLayoutAlignmentHint | ( | Qt::Alignment | alignment | ) |
QskControl::setPlacementPolicy( QskPlacementPolicy::Policy, QskPlacementPolicy::Policy ) \sa placementPolicy, effectivePlacementPolicy
/*! void QskControl::setPlacementPolicy( Qsk::Visibilities, QskPlacementPolicy::Policy );
QskControl::placementPolicy() const;
QskControl::placementPolicy( Qsk::Visibility ) const;
QskControl::effectivePlacementPolicy() const;
Definition at line 333 of file QskControl.cpp.
|
slot |
Set the locale for the control and all its descendents, that do not have their own locale
Definition at line 187 of file QskControl.cpp.
void QskControl::setMargins | ( | const QMarginsF & | margins | ) |
Sets the margins around the contents of the control
margins | Margins |
Definition at line 124 of file QskControl.cpp.
void QskControl::setMargins | ( | qreal | margin | ) |
Sets the margins around the contents of the control
margin | Margin for all sides |
Definition at line 114 of file QskControl.cpp.
void QskControl::setMargins | ( | qreal | left, |
qreal | top, | ||
qreal | right, | ||
qreal | bottom | ||
) |
Sets the margins around the contents of the control
left | Left margin |
top | Top margin |
right | Right margin |
bottom | Bottom margin |
Definition at line 119 of file QskControl.cpp.
void QskControl::setMaximumHeight | ( | qreal | height | ) |
Sets the maximum height.
The maximum height is a synonym for the height of the explicit size hint for Qt::MaximumSize.
Definition at line 465 of file QskControl.cpp.
void QskControl::setMaximumSize | ( | const QSizeF & | size | ) |
Sets the maximum size.
The maximum size is a synonym for the explicit size hint for Qt::MaximumSize.
Definition at line 449 of file QskControl.cpp.
void QskControl::setMaximumSize | ( | qreal | width, |
qreal | height | ||
) |
Sets the maximum size.
The maximum size is a synonym for the explicit size hint for Qt::MaximumSize.
Definition at line 454 of file QskControl.cpp.
void QskControl::setMaximumWidth | ( | qreal | width | ) |
Sets the maximum width.
The minimum width is a synonym for the width of the explicit size hint for Qt::MaximumSize.
Definition at line 459 of file QskControl.cpp.
void QskControl::setMinimumHeight | ( | qreal | height | ) |
Sets the minimum height.
The minimum height is a synonym for the height of the explicit size hint for Qt::MinimumSize.
Definition at line 443 of file QskControl.cpp.
void QskControl::setMinimumSize | ( | const QSizeF & | size | ) |
Sets the minimum size.
The minimum size is a synonym for the explicit size hint for Qt::MinimumSize.
Definition at line 427 of file QskControl.cpp.
void QskControl::setMinimumSize | ( | qreal | width, |
qreal | height | ||
) |
Sets the minimum size.
The minimum size is a synonym for the explicit size hint for Qt::MinimumSize.
Definition at line 432 of file QskControl.cpp.
void QskControl::setMinimumWidth | ( | qreal | width | ) |
Sets the minimum width.
The minimum width is a synonym for the width of the explicit size hint for Qt::MinimumSize.
Definition at line 437 of file QskControl.cpp.
void QskControl::setPlacementPolicy | ( | Qsk::Visibilities | visibilities, |
QskPlacementPolicy::Policy | policy | ||
) |
Definition at line 349 of file QskControl.cpp.
void QskControl::setPlacementPolicy | ( | QskPlacementPolicy | policy | ) |
Definition at line 364 of file QskControl.cpp.
void QskControl::setPlacementPolicy | ( | QskPlacementPolicy::Policy | visiblePolicy, |
QskPlacementPolicy::Policy | hiddenPolicy | ||
) |
Definition at line 358 of file QskControl.cpp.
void QskControl::setPreferredHeight | ( | qreal | height | ) |
Sets the preferred height.
The preferred height is a synonym for the height of the explicit size hint for Qt::PreferredSize.
Definition at line 421 of file QskControl.cpp.
void QskControl::setPreferredSize | ( | const QSizeF & | size | ) |
Sets the preferred size.
The preferred size is a synonym for the explicit size hint for Qt::PreferredSize.
Definition at line 405 of file QskControl.cpp.
void QskControl::setPreferredSize | ( | qreal | width, |
qreal | height | ||
) |
Sets the preferred size.
The preferred size is a synonym for the explicit size hint for Qt::PreferredSize.
Definition at line 410 of file QskControl.cpp.
void QskControl::setPreferredWidth | ( | qreal | width | ) |
Sets the preferred width.
The preferred width is a synonym for the width of the explicit size hint for Qt::PreferredSize.
Definition at line 415 of file QskControl.cpp.
void QskControl::setSection | ( | QskAspect::Section | section | ) |
Definition at line 215 of file QskControl.cpp.
void QskControl::setSizePolicy | ( | QskSizePolicy | policy | ) |
Set the value for the sizePolicy property
Definition at line 279 of file QskControl.cpp.
void QskControl::setSizePolicy | ( | QskSizePolicy::Policy | horizontalPolicy, |
QskSizePolicy::Policy | verticalPolicy | ||
) |
Set the value for the sizePolicy property
horizontalPolicy | Policy for the width |
verticalPolicy | Policy for the height |
Definition at line 296 of file QskControl.cpp.
void QskControl::setSizePolicy | ( | Qt::Orientation | orientation, |
QskSizePolicy::Policy | policy | ||
) |
Modifies the value for the sizePolicy property
orientation | Specifies which part of the policy should be changed |
policy | Policy for height or width |
Definition at line 303 of file QskControl.cpp.
|
inline |
Definition at line 209 of file QskControl.h.
QSizeF QskControl::sizeConstraint | ( | Qt::SizeHint | which, |
const QSizeF & | constraint = QSizeF() |
||
) | const |
Definition at line 704 of file QskControl.cpp.
|
inline |
Definition at line 214 of file QskControl.h.
QskSizePolicy QskControl::sizePolicy | ( | ) | const |
Definition at line 315 of file QskControl.cpp.
QskSizePolicy::Policy QskControl::sizePolicy | ( | Qt::Orientation | orientation | ) | const |
orientation | Specifies the part of the policy |
Definition at line 320 of file QskControl.cpp.
QRectF QskSkinnable::subControlContentsRect | ( | const QRectF & | contentsRect, |
QskAspect::Subcontrol | subControl | ||
) | const |
Calculate the inner rectangle for subControl.
The inner rectangle a subcontrol is its geometry with paddings, indentations being subtracted. F.e. the inner rectangle of QskPushButton::Panel is the bounding rectangle for laying out the QskPushButton::Text and QskPushButton::Graphic subcontrols.
contentsRect | Bounding rectangle for laying out the nodes of the skinnable |
subControl | Unsubstituted subcontrol |
Definition at line 117 of file QskSkinnable.cpp.
QRectF QskControl::subControlContentsRect | ( | const QSizeF & | size, |
QskAspect::Subcontrol | subControl | ||
) | const |
Calculate the inner rectangle for subControl for a rectangle at the position 0, 0 for the given size
subControl | Subcontrol |
size | Size for the control |
Definition at line 173 of file QskControl.cpp.
QRectF QskControl::subControlContentsRect | ( | QskAspect::Subcontrol | subControl | ) | const |
Calculate the inner rectangle for subControl calculated from contentsRect.
subControl | Subcontrol |
Definition at line 168 of file QskControl.cpp.
QRectF QskSkinnable::subControlRect | ( | const QRectF & | contentsRect, |
QskAspect::Subcontrol | subControl | ||
) | const |
Calculate position and size of a subControl.
A convenience method that forwards the calculation to the skinlet
contentsRect | Bounding rectangle for laying out the nodes of the skinnable |
subControl | Unsubstituted subcontrol |
Definition at line 116 of file QskSkinnable.cpp.
QRectF QskControl::subControlRect | ( | const QSizeF & | size, |
QskAspect::Subcontrol | subControl | ||
) | const |
Calculates the rectangle for a subcontrol inside a rectangle at the position 0, 0 for the given size
subControl | Subcontrol |
size | Size for the control |
Definition at line 159 of file QskControl.cpp.
QRectF QskControl::subControlRect | ( | QskAspect::Subcontrol | subControl | ) | const |
Calculates the rectangle for a subcontrol from contentsRect().
subControl | Subcontrol |
Definition at line 154 of file QskControl.cpp.
QVector< QskAspect::Subcontrol > QskControl::subControls | ( | ) | const |
Calculates and returns a list of all effective subcontrols, that have been defined for the corresponding metaObject(). This list can be used to decide if a skin hint for specific subControl might have an impact on a control.
Definition at line 1021 of file QskControl.cpp.
|
finaloverrideprivatevirtual |
Reimplemented from QskItem.
Definition at line 927 of file QskControl.cpp.
|
finaloverrideprivatevirtual |
Reimplemented from QskItem.
Definition at line 902 of file QskControl.cpp.
|
protectedvirtual |
Definition at line 967 of file QskControl.cpp.
|
protectedvirtual |
Definition at line 971 of file QskControl.cpp.
qreal QskControl::widthForHeight | ( | qreal | height | ) | const |
Definition at line 696 of file QskControl.cpp.
|
static |
Definition at line 55 of file QskControl.h.
|
static |
A state bit that is set, when QQuickItem::isEnabled() == false.
Definition at line 56 of file QskControl.h.
|
static |
A state bit that is set, when the item is the active focus item
Definition at line 56 of file QskControl.h.
|
static |
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()
Definition at line 56 of file QskControl.h.
|
readwrite |
QskControl offers basic layout functionalities that can be enabled be setting the autoLayoutChildren flag. The default setting is false
.
Auto layouting calculates and assignes the geometries of childItems()
Child items, where the transparentForPositioners flag is set, are excluded.
Definition at line 32 of file QskControl.h.
|
readwrite |
Definition at line 40 of file QskControl.h.
|
readwrite |
The locale of the control
As long as no special locale has been set, this is the locale of the parentItem(). If none of the ancestors has a special locale it is the locale of the window ( in case it is a QskWindow ). Otherwise it is is the default locale.
Definition at line 26 of file QskControl.h.
|
readwrite |
Definition at line 37 of file QskControl.h.
|
readwrite |
Definition at line 48 of file QskControl.h.
|
readwrite |
Definition at line 47 of file QskControl.h.
|
readwrite |
Definition at line 44 of file QskControl.h.
|
readwrite |
Definition at line 49 of file QskControl.h.
|
readwrite |
Definition at line 29 of file QskControl.h.
|
read |
Definition at line 50 of file QskControl.h.
|
readwrite |
Definition at line 43 of file QskControl.h.
|
read |
Allows calling isVisibleToLayout() as a property.
Definition at line 35 of file QskControl.h.