src/hbwidgets/itemviews/hbgridview.cpp
changeset 2 06ff229162e9
parent 1 f7ac710697a9
child 6 c3690ec91ef8
equal deleted inserted replaced
1:f7ac710697a9 2:06ff229162e9
    79     Q_D( HbGridView );
    79     Q_D( HbGridView );
    80     d->q_ptr = this;
    80     d->q_ptr = this;
    81     d->init();
    81     d->init();
    82 }
    82 }
    83 
    83 
       
    84 /*!
       
    85     Constructs a grid view with a private class object \a dd, 
       
    86     \a container and \a parent.
       
    87  */
    84 HbGridView::HbGridView(HbGridViewPrivate &dd, HbAbstractItemContainer *container, QGraphicsItem *parent) :
    88 HbGridView::HbGridView(HbGridViewPrivate &dd, HbAbstractItemContainer *container, QGraphicsItem *parent) :
    85     HbAbstractItemView(dd, container, new HbModelIterator(), parent)
    89     HbAbstractItemView(dd, container, new HbModelIterator(), parent)
    86 {
    90 {
    87     Q_D( HbGridView );
    91     Q_D( HbGridView );
    88     d->q_ptr = this;
    92     d->q_ptr = this;
    89     d->init();
    93     d->init();
    90 }
    94 }
    91 
    95 
       
    96 /*!
       
    97     \reimp
       
    98 */
    92 HbGridView::~HbGridView()
    99 HbGridView::~HbGridView()
    93 {
   100 {
    94 }
   101 }
    95 
   102 
    96 /*!
   103 /*!
    97  \property HbGridView::rowCount()
   104     Returns the total number of rows in the view.
    98  \brief Returns the total number of rows in the view.
   105 
    99  \sa HbGridView::setRowCount()
   106     \sa setRowCount()
   100  */
   107  */
   101 int HbGridView::rowCount() const
   108 int HbGridView::rowCount() const
   102 {
   109 {
   103     Q_D(const HbGridView);
   110     Q_D(const HbGridView);
   104     return d->itemContainer()->rowCount();
   111     return d->itemContainer()->rowCount();
   105 }
   112 }
   106 
   113 
   107 /*!
   114 /*!
   108  \property HbGridView::setRowCount()
   115     Sets the total number of rows to \a rowCount.
   109  \brief Sets the total number of rows to \a rowCount.
   116 
   110  \sa HbGridView::rowCount()
   117     \sa HbGridView::rowCount()
   111  */
   118  */
   112 void HbGridView::setRowCount(int rowCount)
   119 void HbGridView::setRowCount(int rowCount)
   113 {
   120 {
   114     Q_D(HbGridView);
   121     Q_D(HbGridView);
   115 
   122 
   119 
   126 
   120     scrollTo(d->mVisibleIndex, HbAbstractItemView::PositionAtCenter);
   127     scrollTo(d->mVisibleIndex, HbAbstractItemView::PositionAtCenter);
   121 }
   128 }
   122 
   129 
   123 /*!
   130 /*!
   124  \property HbGridView::columnCount
   131     Returns the total number of columns in the view.
   125  \brief Returns the total number of columns in the view.
   132 
   126  \sa HbGridView::setColumnCount()
   133     \sa setColumnCount()
   127  */
   134  */
   128 int HbGridView::columnCount() const
   135 int HbGridView::columnCount() const
   129 {
   136 {
   130     Q_D(const HbGridView);
   137     Q_D(const HbGridView);
   131     return d->itemContainer()->columnCount();
   138     return d->itemContainer()->columnCount();
   132 }
   139 }
   133 
   140 
   134 /*!
   141 /*!
   135  \property HbGridView::setColumnCount
   142     Sets the total number of columns to \a columnCount.
   136  \brief Sets the total number of columns to \a columnCount.
   143 
   137   \sa HbGridView::columnCount()
   144     \sa columnCount()
   138  */
   145  */
   139 void HbGridView::setColumnCount(int columnCount)
   146 void HbGridView::setColumnCount(int columnCount)
   140 {
   147 {
   141     Q_D(HbGridView);
   148     Q_D(HbGridView);
   142 
   149 
   147     scrollTo(d->mVisibleIndex, HbAbstractItemView::PositionAtCenter);
   154     scrollTo(d->mVisibleIndex, HbAbstractItemView::PositionAtCenter);
   148 }
   155 }
   149 
   156 
   150 
   157 
   151 /*!
   158 /*!
   152  \property HbGridView::iconVisible()
   159     Returns true if icons are currently displayed in GridView.
   153  \brief Returns true if icons are currently displayed in GridView.
   160  
   154  \sa HbGridView::setIconVisible()
   161     \sa setIconVisible()
   155  */
   162  */
   156 bool HbGridView::iconVisible() const
   163 bool HbGridView::iconVisible() const
   157 {
   164 {
   158     Q_D(const HbGridView);
   165     Q_D(const HbGridView);
   159     return d->mIconVisible;
   166     return d->mIconVisible;
   160 }
   167 }
   161 
   168 
   162 /*!
   169 /*!
   163  \property HbGridView::setIconVisible()
   170     Set visibility of icons in grid view to \a visible. All view items are updated.
   164  \brief Set visibility of icons in GridView to \a visible.
   171 
   165         All view items are updated automatically.
   172     By default icons are visible.
   166  \sa HbGridView::iconVisible()
   173 
       
   174     \sa iconVisible()
   167  */
   175  */
   168 void HbGridView::setIconVisible(bool visible)
   176 void HbGridView::setIconVisible(bool visible)
   169 {
   177 {
   170     Q_D(HbGridView);
   178     Q_D(HbGridView);
   171     d->setIconVisible(visible);
   179     d->setIconVisible(visible);
   172 }
   180 }
   173 
   181 
   174 /*!
   182 /*!
   175  \property HbGridView::textVisible()
   183     Returns visibility of text in grid view.
   176  \brief  Returns visibility of labels in GridView.
   184 
   177  \sa HbGridView::setTextVisible()
   185     \sa setTextVisible()
   178  */
   186  */
   179 bool HbGridView::textVisible() const
   187 bool HbGridView::textVisible() const
   180 {
   188 {
   181     Q_D(const HbGridView);
   189     Q_D(const HbGridView);
   182     return d->mTextVisible;
   190     return d->mTextVisible;
   183 }
   191 }
   184 
   192 
   185 /*!
   193 /*!
   186  \property HbGridView::setTextVisible()
   194     Sets visibility of text in grid view to \a visible. All view items are updated.
   187  \brief  Sets visibility of labels in GridView to \a visible.
   195 
   188          All view items are updated automatically.
   196     By default text is visible.
   189  \sa HbGridView::textVisible()
   197 
       
   198     \sa HbGridView::textVisible()
   190  */
   199  */
   191 void HbGridView::setTextVisible(bool visible)
   200 void HbGridView::setTextVisible(bool visible)
   192 {
   201 {
   193     Q_D(HbGridView);
   202     Q_D(HbGridView);
   194     d->setTextVisible(visible);
   203     d->setTextVisible(visible);
   195 }
   204 }
   196 
   205 
   197 /*!
   206 /*!
   198  Returns item at \a row and \a column.
   207     Returns item at \a row and \a column.
   199  */
   208  */
   200 HbAbstractViewItem *HbGridView::itemAt(int row, int column) const
   209 HbAbstractViewItem *HbGridView::itemAt(int row, int column) const
   201 {
   210 {
   202     Q_D(const HbGridView);
   211     Q_D(const HbGridView);
   203    if (     row >= 0
   212    if (     row >= 0
   209    }
   218    }
   210    return 0;
   219    return 0;
   211 }
   220 }
   212 
   221 
   213 /*!
   222 /*!
   214  Returns item at \a index.
       
   215  Ownership of the item is not transferred.
       
   216 
       
   217  \deprecated HbGridView::itemAt(int) const
       
   218      is deprecated. Please use HbAbstractItemView::itemByIndex(const QModelIndex &index) instead.
       
   219 
       
   220  \sa HbAbstractItemView::itemByIndex(const QModelIndex &index)
       
   221 
       
   222  */
       
   223 HbAbstractViewItem *HbGridView::itemAt(int index) const
       
   224 {
       
   225     Q_D(const HbGridView);
       
   226 
       
   227     if (d->mModelIterator->model()) {
       
   228         return d->itemContainer()->itemByIndex(d->mModelIterator->index(index));
       
   229     }
       
   230     return 0;
       
   231 }
       
   232 
       
   233 /*!
       
   234  \reimp
   223  \reimp
   235  */
   224  */
   236 void HbGridView::scrollTo(const QModelIndex &index, ScrollHint hint)
   225 void HbGridView::scrollTo(const QModelIndex &index, ScrollHint hint)
   237 {
   226 {
   238     Q_D(HbGridView);
   227     Q_D(HbGridView);
   256     HbScrollArea::mouseMoveEvent( event );
   245     HbScrollArea::mouseMoveEvent( event );
   257     event->accept();
   246     event->accept();
   258 }
   247 }
   259 
   248 
   260 /*!
   249 /*!
   261  \reimp
   250     \reimp
   262  */
   251  */
   263 void HbGridView::orientationAboutToBeChanged()
   252 void HbGridView::orientationAboutToBeChanged()
   264 {
   253 {
   265     Q_D(HbGridView);
   254     Q_D(HbGridView);
   266     d->mVisibleIndex = d->indexInTheCenter();
   255     d->mVisibleIndex = d->indexInTheCenter();
   267 }
   256 }
   268 
   257 
   269 /*!
   258 /*!
   270  \reimp
   259     \reimp
   271  */
   260  */
   272 void HbGridView::orientationChanged(Qt::Orientation newOrientation)
   261 void HbGridView::orientationChanged(Qt::Orientation newOrientation)
   273 {
   262 {
   274     Q_D(HbGridView);
   263     Q_D(HbGridView);
   275     d->mContainer->setPos(0,0);
   264     d->mContainer->setPos(0,0);