177 lines
4.4 KiB
Plaintext
177 lines
4.4 KiB
Plaintext
|
/*!
|
||
|
|
\class QskPlacementPolicy QskPlacementPolicy.h
|
||
|
|
|
||
|
|
\ingroup Framework
|
||
|
|
|
||
|
|
QskPlacementPolicy is a hint for layout code how to deal with
|
||
|
|
the geometry of an item when being visible or hidden.
|
||
|
|
|
||
|
|
\sa QskControl::placementPolicy(), qskPlacementPolicy()
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*!
|
||
|
|
\enum QskPlacementPolicy::Policy
|
||
|
|
|
||
|
|
Hint for the layout code how to deal with the geometry of an
|
||
|
|
item. QskPlacementPolicy has two values one for the visible,
|
||
|
|
the other for the hidden state.
|
||
|
|
|
||
|
|
\var QskPlacementPolicy::Ignore
|
||
|
|
|
||
|
|
Ignore the item for all type of layout calculations.
|
||
|
|
|
||
|
|
\var QskPlacementPolicy::Reserve
|
||
|
|
|
||
|
|
Reseve space without giving the item its geometry.
|
||
|
|
|
||
|
|
\var QskPlacementPolicy::Adjust
|
||
|
|
|
||
|
|
Reserve space and adjust the geometry of the item
|
||
|
|
|
||
|
|
\note QskPlacementPolicy::Reserve as hiddenPolicy() is equivalent
|
||
|
|
to what is offered by QSizePolicy::retainSizeWhenHidden().
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*!
|
||
|
|
\property QskPlacementPolicy::Policy QskPlacementPolicy::visiblePolicy
|
||
|
|
|
||
|
|
\brief Policy for the item, when being visible ( to its parent )
|
||
|
|
|
||
|
|
- QskPlacementPolicy::Ignore
|
||
|
|
|
||
|
|
For situations where a parent takes care of the geometry for its children,
|
||
|
|
but exceptions need to be defined. F.e a focus indicator.
|
||
|
|
|
||
|
|
- QskPlacementPolicy::Reserve:
|
||
|
|
|
||
|
|
There are not many relevant scenarios for this value. An
|
||
|
|
example might be when an item is inside of a grid layout, where all the
|
||
|
|
size hints should have an effect, but the final alignment of the item
|
||
|
|
inside of the cell has to be done manually.
|
||
|
|
|
||
|
|
- QskPlacementPolicy::Adjust:
|
||
|
|
|
||
|
|
The default value
|
||
|
|
|
||
|
|
\accessors visiblePolicy(), setVisiblePolicy()
|
||
|
|
\sa hiddenPolicy, qskIsVisibleToParent()
|
||
|
|
|
||
|
|
\note QskPlacementPolicy::Ignore is stored in the transparentForPositioner
|
||
|
|
bit in QQuickItem and might have an impact on Qt/Quick layout code.
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*!
|
||
|
|
\property QskPlacementPolicy::Policy QskPlacementPolicy::hiddenPolicy
|
||
|
|
|
||
|
|
\brief Policy for the item, when being hidden ( to its parent )
|
||
|
|
|
||
|
|
- QskPlacementPolicy::Ignore
|
||
|
|
|
||
|
|
The default value
|
||
|
|
|
||
|
|
- QskPlacementPolicy::Reserve:
|
||
|
|
|
||
|
|
In combination with a visiblePolicy != QskPlacementPolicy::Ignore
|
||
|
|
the layout of the parent does not change, when the item is shown/hidden.
|
||
|
|
|
||
|
|
- QskPlacementPolicy::Adjust:
|
||
|
|
|
||
|
|
Sometimes an item wants to have its proper size even when being hidden.
|
||
|
|
|
||
|
|
\accessors visiblePolicy(), setVisiblePolicy()
|
||
|
|
\sa qskIsVisibleToParent()
|
||
|
|
|
||
|
|
\note QskPlacementPolicy::Ignore is stored in the transparentForPositioner
|
||
|
|
bit in QQuickItem and might have an impact on Qt/Quick layout code.
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*!
|
||
|
|
\fn QskPlacementPolicy::QskPlacementPolicy()
|
||
|
|
|
||
|
|
visiblePolicy is set to QskPlacementPolicy::Adjust,
|
||
|
|
hiddenPolicy to QskPlacementPolicy::Ignore.
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*!
|
||
|
|
\fn QskPlacementPolicy::QskPlacementPolicy( Policy policy )
|
||
|
|
|
||
|
|
visiblePolicy and hiddenPolicy are set to policy
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*!
|
||
|
|
\fn QskPlacementPolicy::QskPlacementPolicy( Policy visiblePolicy, Policy hiddenPolicy )
|
||
|
|
|
||
|
|
Initialization from visiblePolicy and hiddenPolicy
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*!
|
||
|
|
\fn QskPlacementPolicy::QskPlacementPolicy( Qsk::Visibilities visiblities, Policy policy )
|
||
|
|
|
||
|
|
Initialize visiblePolicy and hiddenPolicy depending on visiblities
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
\fn QskPlacementPolicy::operator==( const QskPlacementPolicy& )
|
||
|
|
|
||
|
|
"Equal to" operator
|
||
|
|
\sa operator!=(), operator<()
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
\fn QskPlacementPolicy::operator!=( const QskPlacementPolicy& )
|
||
|
|
|
||
|
|
"Not equal to" operator
|
||
|
|
\sa operator==(), operator<()
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
\fn QskPlacementPolicy::setPolicy( Qsk::Visibilities, Policy )
|
||
|
|
*/
|
||
|
|
|
||
|
|
*/
|
||
|
|
\fn QskPlacementPolicy::policy( Qsk::Visibility )
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
\fn QskPlacementPolicy::isEffective()
|
||
|
|
|
||
|
|
\return true, when visiblePolicy or hiddenPolicy is not QskPlacementPolicy::Ignore
|
||
|
|
\sa isIgnoring()
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
\fn QskPlacementPolicy::isIgnoring( Qsk::Visibility )
|
||
|
|
\return true, when visiblePolicy and hiddenPolicy is QskPlacementPolicy::Ignore
|
||
|
|
\sa isEffective()
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
\fn QskPlacementPolicy::isAdjusting( Qsk::Visibility )
|
||
|
|
|
||
|
|
\return true, when QskPlacementPolicy::Adjust is set for the visibility
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
\fn QskPlacementPolicy::setVisiblePolicy( Policy )
|
||
|
|
|
||
|
|
\sa visiblePolicy(), setHiddenPolicy()
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
\fn QskPlacementPolicy::visiblePolicy()
|
||
|
|
|
||
|
|
\sa setVisiblePolicy(), hiddenPolicy()
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
\fn QskPlacementPolicy::setHiddenPolicy( Policy )
|
||
|
|
|
||
|
|
\sa hiddenPolicy(), setVisiblePolicy()
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*
|
||
|
|
\fn QskPlacementPolicy::hiddenPolicy()
|
||
|
|
|
||
|
|
\sa setHiddenPolicy(), visiblePolicy()
|
||
|
|
*/
|