doc/src/snippets/code/doc_src_layout.qdoc
changeset 0 1918ee327afb
equal deleted inserted replaced
-1:000000000000 0:1918ee327afb
       
     1 /****************************************************************************
       
     2 **
       
     3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
       
     4 ** All rights reserved.
       
     5 ** Contact: Nokia Corporation (qt-info@nokia.com)
       
     6 **
       
     7 ** This file is part of the documentation of the Qt Toolkit.
       
     8 **
       
     9 ** $QT_BEGIN_LICENSE:LGPL$
       
    10 ** No Commercial Usage
       
    11 ** This file contains pre-release code and may not be distributed.
       
    12 ** You may use this file in accordance with the terms and conditions
       
    13 ** contained in the Technology Preview License Agreement accompanying
       
    14 ** this package.
       
    15 **
       
    16 ** GNU Lesser General Public License Usage
       
    17 ** Alternatively, this file may be used under the terms of the GNU Lesser
       
    18 ** General Public License version 2.1 as published by the Free Software
       
    19 ** Foundation and appearing in the file LICENSE.LGPL included in the
       
    20 ** packaging of this file.  Please review the following information to
       
    21 ** ensure the GNU Lesser General Public License version 2.1 requirements
       
    22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
       
    23 **
       
    24 ** In addition, as a special exception, Nokia gives you certain additional
       
    25 ** rights.  These rights are described in the Nokia Qt LGPL Exception
       
    26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
       
    27 **
       
    28 ** If you have questions regarding the use of this file, please contact
       
    29 ** Nokia at qt-info@nokia.com.
       
    30 **
       
    31 **
       
    32 **
       
    33 **
       
    34 **
       
    35 **
       
    36 **
       
    37 **
       
    38 ** $QT_END_LICENSE$
       
    39 **
       
    40 ****************************************************************************/
       
    41 
       
    42 //! [0]
       
    43 #ifndef CARD_H
       
    44 #define CARD_H
       
    45 
       
    46 #include <QtGui>
       
    47 #include <QList>
       
    48 
       
    49 class CardLayout : public QLayout
       
    50 {
       
    51 public:
       
    52     CardLayout(QWidget *parent, int dist): QLayout(parent, 0, dist) {}
       
    53     CardLayout(QLayout *parent, int dist): QLayout(parent, dist) {}
       
    54     CardLayout(int dist): QLayout(dist) {}
       
    55     ~CardLayout();
       
    56 
       
    57     void addItem(QLayoutItem *item);
       
    58     QSize sizeHint() const;
       
    59     QSize minimumSize() const;
       
    60 	QLayoutItem *count() const;
       
    61     QLayoutItem *itemAt(int) const;
       
    62     QLayoutItem *takeAt(int);
       
    63     void setGeometry(const QRect &rect);
       
    64 
       
    65 private:
       
    66     QList<QLayoutItem*> list;
       
    67 };
       
    68 #endif
       
    69 //! [0]
       
    70 
       
    71 
       
    72 //! [1]
       
    73 //#include "card.h"
       
    74 //! [1]
       
    75 
       
    76 //! [2]
       
    77 QLayoutItem *CardLayout::count() const
       
    78 {
       
    79 	// QList::size() returns the number of QLayoutItems in the list
       
    80     return list.size();
       
    81 }
       
    82 //! [2]
       
    83 
       
    84 //! [3]
       
    85 QLayoutItem *CardLayout::itemAt(int idx) const
       
    86 {
       
    87     // QList::value() performs index checking, and returns 0 if we are
       
    88     // outside the valid range
       
    89     return list.value(idx);
       
    90 }
       
    91 
       
    92 QLayoutItem *CardLayout::takeAt(int idx)
       
    93 {
       
    94     // QList::take does not do index checking
       
    95     return idx >= 0 && idx < list.size() ? list.takeAt(idx) : 0;
       
    96 }
       
    97 //! [3]
       
    98 
       
    99 
       
   100 //! [4]
       
   101 void CardLayout::addItem(QLayoutItem *item)
       
   102 {
       
   103     list.append(item);
       
   104 }
       
   105 //! [4]
       
   106 
       
   107 
       
   108 //! [5]
       
   109 CardLayout::~CardLayout()
       
   110 {
       
   111      QLayoutItem *item;
       
   112      while ((item = takeAt(0)))
       
   113          delete item;
       
   114 }
       
   115 //! [5]
       
   116 
       
   117 
       
   118 //! [6]
       
   119 void CardLayout::setGeometry(const QRect &r)
       
   120 {
       
   121     QLayout::setGeometry(r);
       
   122 
       
   123     if (list.size() == 0)
       
   124         return;
       
   125 
       
   126     int w = r.width() - (list.count() - 1) * spacing();
       
   127     int h = r.height() - (list.count() - 1) * spacing();
       
   128     int i = 0;
       
   129     while (i < list.size()) {
       
   130         QLayoutItem *o = list.at(i);
       
   131         QRect geom(r.x() + i * spacing(), r.y() + i * spacing(), w, h);
       
   132         o->setGeometry(geom);
       
   133         ++i;
       
   134     }
       
   135 }
       
   136 //! [6]
       
   137 
       
   138 
       
   139 //! [7]
       
   140 QSize CardLayout::sizeHint() const
       
   141 {
       
   142     QSize s(0,0);
       
   143     int n = list.count();
       
   144     if (n > 0)
       
   145         s = QSize(100,70); //start with a nice default size
       
   146     int i = 0;
       
   147     while (i < n) {
       
   148         QLayoutItem *o = list.at(i);
       
   149         s = s.expandedTo(o->sizeHint());
       
   150         ++i;
       
   151     }
       
   152     return s + n*QSize(spacing(), spacing());
       
   153 }
       
   154 
       
   155 QSize CardLayout::minimumSize() const
       
   156 {
       
   157     QSize s(0,0);
       
   158     int n = list.count();
       
   159     int i = 0;
       
   160     while (i < n) {
       
   161         QLayoutItem *o = list.at(i);
       
   162         s = s.expandedTo(o->minimumSize());
       
   163         ++i;
       
   164     }
       
   165     return s + n*QSize(spacing(), spacing());
       
   166 }
       
   167 //! [7]