1 /****************************************************************************
3 ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
4 ** All rights reserved.
5 ** Contact: http://www.qt-project.org/
7 ** This file is part of the QtDeclarative module of the Qt Toolkit.
9 ** $QT_BEGIN_LICENSE:LGPL$
10 ** GNU Lesser General Public License Usage
11 ** This file may be used under the terms of the GNU Lesser General Public
12 ** License version 2.1 as published by the Free Software Foundation and
13 ** appearing in the file LICENSE.LGPL included in the packaging of this
14 ** file. Please review the following information to ensure the GNU Lesser
15 ** General Public License version 2.1 requirements will be met:
16 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
18 ** In addition, as a special exception, Nokia gives you certain additional
19 ** rights. These rights are described in the Nokia Qt LGPL Exception
20 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
22 ** GNU General Public License Usage
23 ** Alternatively, this file may be used under the terms of the GNU General
24 ** Public License version 3.0 as published by the Free Software Foundation
25 ** and appearing in the file LICENSE.GPL included in the packaging of this
26 ** file. Please review the following information to ensure the GNU General
27 ** Public License version 3.0 requirements will be met:
28 ** http://www.gnu.org/copyleft/gpl.html.
31 ** Alternatively, this file may be used in accordance with the terms and
32 ** conditions contained in a signed written agreement between you and Nokia.
40 ****************************************************************************/
42 #include "private/qdeclarativelayoutitem_p.h"
53 \qmlclass LayoutItem QDeclarative1LayoutItem
54 \inqmlmodule QtQuick 1
55 \ingroup qml-utility-elements
57 \brief The LayoutItem element allows declarative UI elements to be placed inside Qt's Graphics View layouts.
59 LayoutItem is a variant of \l Item with additional size hint properties. These properties provide the size hints
60 necessary for items to work in conjunction with Qt \l{Graphics View Framework}{Graphics View} layout classes
61 such as QGraphicsLinearLayout and QGraphicsGridLayout. The Qt layout mechanisms will resize the LayoutItem as appropriate,
62 taking its size hints into account, and you can propagate this to the other elements in your UI via anchors and bindings.
64 This is a QGraphicsLayoutItem subclass, and its properties merely expose the QGraphicsLayoutItem functionality to QML.
66 The \l{declarative/cppextensions/qgraphicslayouts/layoutitem}{LayoutItem example}
67 demonstrates how a LayoutItem can be used within a \l{Graphics View Framework}{Graphics View}
72 \qmlproperty QSizeF QtQuick1::LayoutItem::maximumSize
74 The maximumSize property can be set to specify the maximum desired size of this LayoutItem
78 \qmlproperty QSizeF QtQuick1::LayoutItem::minimumSize
80 The minimumSize property can be set to specify the minimum desired size of this LayoutItem
84 \qmlproperty QSizeF QtQuick1::LayoutItem::preferredSize
86 The preferredSize property can be set to specify the preferred size of this LayoutItem
89 QDeclarative1LayoutItem::QDeclarative1LayoutItem(QDeclarativeItem* parent)
90 : QDeclarativeItem(parent), m_maximumSize(INT_MAX,INT_MAX), m_minimumSize(0,0), m_preferredSize(0,0)
92 setGraphicsItem(this);
95 void QDeclarative1LayoutItem::setGeometry(const QRectF & rect)
99 setWidth(rect.width());
100 setHeight(rect.height());
103 QSizeF QDeclarative1LayoutItem::sizeHint(Qt::SizeHint w, const QSizeF &constraint) const
105 Q_UNUSED(constraint);
106 if(w == Qt::MinimumSize){
107 return m_minimumSize;
108 }else if(w == Qt::MaximumSize){
109 return m_maximumSize;
111 return m_preferredSize;