source: trunk/src/qt3support/widgets/q3gridview.cpp@ 1056

/****************************************************************************
**
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation ([email protected])
**
** This file is part of the Qt3Support module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** Commercial Usage
** Licensees holding valid Qt Commercial licenses may use this file in
** accordance with the Qt Commercial License Agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Nokia.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights.  These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU General Public License version 3.0 requirements will be
** met: http://www.gnu.org/copyleft/gpl.html.
**
** If you have questions regarding the use of this file, please contact
** Nokia at [email protected].
** $QT_END_LICENSE$
**
****************************************************************************/


#include "q3gridview.h"
#include "qpainter.h"

QT_BEGIN_NAMESPACE

using namespace Qt;

/*!
  \class Q3GridView
  \brief The Q3GridView class provides an abstract base for
  fixed-size grids.

  \compat

  A grid view consists of a number of abstract cells organized in
  rows and columns. The cells have a fixed size and are identified
  with a row index and a column index. The top-left cell is in row
  0, column 0. The bottom-right cell is in row numRows()-1, column
  numCols()-1.

  You can define \l{Q3GridView::numRows} {numRows},
  \l{Q3GridView::numCols} {numCols}, \l{Q3GridView::cellWidth}
  {cellWidth} and \l{Q3GridView::cellHeight} {cellHeight}. Reimplement
  the pure virtual function paintCell() to draw the contents of a
  cell.

  With ensureCellVisible(), you can ensure a certain cell is
  visible. With rowAt() and columnAt() you can find a cell based on
  the given x- and y-coordinates.

  If you need to monitor changes to the grid's dimensions (i.e. when
  numRows or numCols is changed), reimplement the dimensionChange()
  change handler.

  Note: the row and column indices are always given in the order,
  row (vertical offset) then column (horizontal offset). This order
  is the opposite of all pixel operations, which are given in the
  order x (horizontal offset), y (vertical offset).