\printuntil }
\printuntil }
- We use the \l qsTr() command to mark the button labels translatable.
+ We use the \l[QML]{Qt::}{qsTr()} command to mark the button labels translatable.
- We use the \l lupdate tool to generate the translation source files and
- the \l lrelease tool to convert the translated strings to the QM files used
+ We use the \c lupdate() tool to generate the translation source files and
+ the \c lrelease() tool to convert the translated strings to the QM files used
by the application at runtime. These files are stored in the \c i18n
directory.
tagfile = ../../../doc/qtqml/qtqml.tags
-depends += qtcore qtxmlpatterns qtgui qtquick qtdoc qtlinguist qmake qtscript
+depends += qtcore qtxmlpatterns qtgui qtquick qtdoc qtlinguist qmake qtscript qtwidgets
headerdirs += .. \
../../imports/models
may also explicitly preserve the scarce resource by calling the
"preserve" method on the \c var property from within JavaScript.
- For more information regarding the usage of a scarce resource, please
- see \l{Scarce Resources in JavaScript}.
-
This basic type is provided by the QML language.
*/
"destroy" method on the \c variant property from within JavaScript. They
may also explicitly preserve the scarce resource by calling the
"preserve" method on the \c variant property from within JavaScript.
- For more information on the usage of a scarce resource, please
- see \l{Scarce Resources in JavaScript}.
\section1 Storing Arrays and Objects
\li New \l var property type. This is a general-purpose property type which obsoletes the \l variant type.
Properties of the \l var type may hold JavaScript references.
\li QML properties of type \l var and \l variant can now hold pixmaps.
- See \l {Scarce Resources in JavaScript} for more information.
\li Value type improvements:
\list
\li QML now supports defining properties of value type basic types within QML documents. Supported types include
\snippet package/Delegate.qml 0
These named items are used as the delegates by the two views who
- reference the special \l{VisualDataModel::parts} property to select
+ reference the special \l{DelegateModel::parts} property to select
a model which provides the chosen delegate.
\snippet package/view.qml 0
To move the items within the view we use a DelegateModel. The DelegateModel type is used by
the view types to instantiate delegate items from model data and when constructed explicitly can
be used to filter and re-order the model items provided to ListView. The
-\l {QtQuick::DelegateModel::items}{items} property of DelegateModel provides access to the
+\l [QML]{DelegateModel::}{items} property of DelegateModel provides access to the
view's items and allows us to change the visible order without modifying the source model. To
-determine the current visible index of the items we use \l {QtQuick::DelegateModel::itemsIndex}
+determine the current visible index of the items we use \l {DelegateModel::}{itemsIndex}
{itemsIndex} property on the DelegateModel attached property of the delegate item.
-To utilize a DelegateModel with a ListView we bind it to the \l {QtQuick::ListView::model}{model}
-property of the view and bind the \l {QtQuick::DelegateModel::model}{model} and
-\l {QtQuick::DelegateModel::delegate}{delegate} to the DelegateModel.
+To utilize a DelegateModel with a ListView we bind it to the \l {ListView::}{model}
+property of the view and bind the \l {DelegateModel::}{model} and
+\l {DelegateModel::}{delegate} to the DelegateModel.
\snippet tutorials/dynamicview/dynamicview3/dynamicview.qml 4
\section2 Walkthrough
Items in a DelegateModel are filtered into groups represented by the DelegateModelGroup type,
-normally all items in the model belong to a default \l {QtQuick::DelegateModel::items}{items}
+normally all items in the model belong to a default \l {DelegateModel::}{items}
group but this default can be changed with the includeByDefault property. To implement our sorting
we want items to first be added to an unsorted group from where we can transfer them to a sorted
position in the items group. To do that we clear includeByDefault on the items group and set it on
repeat until the unsorted group is empty.
To find the insert position for an item we request a handle for the item from the unsorted group
-with the \l {QtQuick::DelegateModel::get} {get} function. Through the model property on this
+with the \l {DelegateModel::}{get} function. Through the model property on this
handle we can access the same model data that is available in a delegate instance of that item and
compare against other items to determine relative position.
\snippet tutorials/dynamicview/dynamicview4/dynamicview.qml 4
A sort is triggered whenever new items are added to the unsorted DelegateModel which we are
-notified of by the \l {QtQuick::DelegateModelGroup::onChanged}{onChanged} handler. If no sort
+notified of by the \l {DelegateModelGroup} \c onChanged handler. If no sort
function is currently selected we simply transfer all items from the unsorted group to the items
group, otherwise we call sort with the selected sort function.
Finally when the selected sort order changes we can trigger a full re-sort of the list by moving
all items from the items group to the unsorted group, which will trigger the
-\l {QtQuick::DelegateModelGroup::onChanged}{onChanged} handler and transfer the items back to the
-items group in correct order. Note that the \l {QtQuick::DelegateModelGroup::onChanged}{onChanged}
+\l {DelegateModelGroup} \c onChanged handler and transfer the items back to the
+items group in correct order. Note that the \l {DelegateModelGroup} \c onChanged
handler will not be invoked recursively so there's no issue with it being invoked during a sort.
\snippet tutorials/dynamicview/dynamicview4/dynamicview.qml 6
\li VisualDataModel:
\list
\li Now has features to filter the items to be displayed in a view. This is supported by the new
- \l {VisualDataModel::}{groups}, \l {VisualDataModel::}{filterOnGroup}, \l {VisualDataModel::}{items}
- and \l {VisualDataModel::}{persistedItems} properties.
+ \l {DelegateModel::}{groups}, \l {DelegateModel::}{filterOnGroup}, \l {DelegateModel::}{items}
+ and \l {DelegateModel::}{persistedItems} properties.
\endlist
\li Changes common to both ListView and GridView:
\list
}
\endqml
The \l role is set to \c Button to indicate the type of control.
- \l Accessible.name is the most important information and bound to the text on the button.
+ \l {Accessible::}{name} is the most important information and bound to the text on the button.
The name is a short and consise description of the control and should reflect the visual label.
In this case it is not clear what the button does with the name only, so \l description contains
an explanation.
\li All interactive elements
\li \l focusable and \l focused
\li All elements that the user can interact with should have focusable set to \c true and
- set \l focus to \c true when they have the focus. This is important even for applications
+ set \c focus to \c true when they have the focus. This is important even for applications
that run on touch-only devices since screen readers often implement a virtual focus that
can be moved from item to item.
\row
\endlist
When using \c Drag.Automatic you should also define \l mimeData and bind the
- \l active property to the active property of \l MouseArea.drag.
- */
+ \l active property to the active property of MouseArea : \l {MouseArea::drag.active}
+*/
QQuickDrag::DragType QQuickDragAttached::dragType() const
{
QQmlProperty(), or QMetaProperty::write() when you need to modify those
properties from C++. This ensures that the QML engine knows about the
property change. Otherwise, the engine won't be able to carry out your
- requested animation. For example, if you call \l setPosition() directly,
- any behavior that reacts to changes in the x or y properties will not take
- effect, as you are bypassing Qt's meta-object system. Note that these
- functions incur a slight performance penalty. For more details, see
- \l {Accessing Members of a QML Object Type from C++}.
+ requested animation.
+ Note that these functions incur a slight performance penalty. For more
+ details, see \l {Accessing Members of a QML Object Type from C++}.
\sa QQuickWindow, QQuickPaintedItem
*/
\endqml
\endtable
- \sa transform, Rotation
+ \sa Transform, Rotation
*/
/*!
\property QQuickItem::rotation
\endqml
\endtable
- \sa transform, Rotation
+ \sa Transform, Rotation
*/
qreal QQuickItem::rotation() const
{
\endqml
\endtable
- \sa transform, Scale
+ \sa Transform, Scale
*/
/*!
\property QQuickItem::scale
\endqml
\endtable
- \sa transform, Scale
+ \sa Transform, Scale
*/
qreal QQuickItem::scale() const
{
(e.g. the user clicked the title bar close button). The CloseEvent contains
an accepted property which can be set to false to abort closing the window.
- \sa Window.closing()
+ \sa QQuickWindow::closing()
*/
/*!
This signal is emitted when the user tries to close the window.
- This signal includes a \a close parameter. The \a close \l accepted
+ This signal includes a \a close parameter. The \c {close.accepted}
property is true by default so that the window is allowed to close; but you
can implement an \c onClosing handler and set \c {close.accepted = false} if
you need to do something else before the window can be closed.
This is equivalent to calling showFullScreen(), showMaximized(), or showNormal(),
depending on the platform's default behavior for the window type and flags.
- \sa showFullScreen(), showMaximized(), showNormal(), hide(), flags()
+ \sa showFullScreen(), showMaximized(), showNormal(), hide(), QQuickItem::flags()
*/
/*!
\l {QQuickTextMetrics::advanceWidth}{advanceWidth} property of
\l {QQuickTextMetrics::advanceWidth}{TextMetrics}.
- \sa {QFontMetricsF::width()}, height()
+ \sa {QFontMetricsF::width()}, {QFontMetricsF::height()}
*/
qreal QQuickFontMetrics::advanceWidth(const QString &text) const
{
\li \c Qt::ElideRight - For example: "Hello..."
\endlist
- \sa elideWidth, elidedText
+ \sa elideWidth, QFontMetrics::elidedText
*/
Qt::TextElideMode QQuickTextMetrics::elide() const
{
This property holds the largest width the text can have (in pixels) before
eliding will occur.
- \sa elide, elidedText
+ \sa elide, QFontMetrics::elidedText
*/
qreal QQuickTextMetrics::elideWidth() const
{
projects / platform / upstream / qtdeclarative.git / commitdiff