[composer] Add api method for toggling visibility of composer items

python/core/composer/qgscomposeritem.sip

@@ -517,6 +517,15 @@ class QgsComposerItem : QgsComposerObject, QGraphicsRectItem
     */
     virtual QString displayName() const;
 
+    /**Sets visibility for item.
+     * @param visible set to true to show item, false to hide item
+     * @note QGraphicsItem::setVisible should not be called directly
+     * on a QgsComposerItem, as some item types (eg groups) need to override
+     * the visibility toggle.
+     * @note added in version 2.5
+    */
+    virtual void setVisibility( const bool visible );   
+
     /**Returns whether this item is part of a group
      * @returns true if item is in a group
      * @note added in version 2.5

python/core/composer/qgscomposeritemgroup.sip

@@ -20,6 +20,9 @@ class QgsComposerItemGroup: QgsComposerItem
     /**Sets this items bound in scene coordinates such that 1 item size units
        corresponds to 1 scene size unit*/
     void setSceneRect( const QRectF& rectangle );
+
+    //overridden to also hide grouped items
+    virtual void setVisibility( const bool visible );
 
     /** stores state in Dom node
        * @param elem is Dom element corresponding to 'Composer' tag

src/core/composer/qgscomposeritem.cpp

@@ -185,7 +185,7 @@ bool QgsComposerItem::_writeXML( QDomElement& itemElem, QDomDocument& doc ) cons
     composerItemElem.setAttribute( "frame", "false" );
   }
 
-  //frame
+  //background
   if ( mBackground )
   {
     composerItemElem.setAttribute( "background", "true" );
@@ -211,6 +211,7 @@ bool QgsComposerItem::_writeXML( QDomElement& itemElem, QDomDocument& doc ) cons
   composerItemElem.setAttribute( "itemRotation",  QString::number( mItemRotation ) );
   composerItemElem.setAttribute( "uuid", mUuid );
   composerItemElem.setAttribute( "id", mId );
+  composerItemElem.setAttribute( "visibility", isVisible() );
   //position lock for mouse moves/resizes
   if ( mItemPositionLocked )
   {
@@ -223,7 +224,6 @@ bool QgsComposerItem::_writeXML( QDomElement& itemElem, QDomDocument& doc ) cons
 
   composerItemElem.setAttribute( "lastValidViewScaleFactor", QString::number( mLastValidViewScaleFactor ) );
 
-
   //frame color
   QDomElement frameColorElem = doc.createElement( "FrameColor" );
   QColor frameColor = pen().color();
@@ -310,6 +310,9 @@ bool QgsComposerItem::_readXML( const QDomElement& itemElem, const QDomDocument&
     setPositionLock( false );
   }
 
+  //visibility
+  setVisibility( itemElem.attribute( "visibility", "1" ) != "0" );
+
   //position
   int page;
   double x, y, pagex, pagey, width, height;
@@ -1329,3 +1332,8 @@ QString QgsComposerItem::displayName() const
 
   return tr( "<item>" );
 }
+
+void QgsComposerItem::setVisibility( const bool visible )
+{
+  QGraphicsItem::setVisible( visible );
+}

src/core/composer/qgscomposeritem.h

@@ -473,6 +473,15 @@ class CORE_EXPORT QgsComposerItem: public QgsComposerObject, public QGraphicsRec
     */
     virtual QString displayName() const;
 
+    /**Sets visibility for item.
+     * @param visible set to true to show item, false to hide item
+     * @note QGraphicsItem::setVisible should not be called directly
+     * on a QgsComposerItem, as some item types (eg groups) need to override
+     * the visibility toggle.
+     * @note added in version 2.5
+    */
+    virtual void setVisibility( const bool visible );
+
     /**Returns whether this item is part of a group
      * @returns true if item is in a group
      * @note added in version 2.5

src/core/composer/qgscomposeritemgroup.cpp

@@ -144,6 +144,18 @@ void QgsComposerItemGroup::setSceneRect( const QRectF& rectangle )
   QgsComposerItem::setSceneRect( rectangle );
 }
 
+void QgsComposerItemGroup::setVisibility( const bool visible )
+{
+  //also set visibility for all items within the group
+  QSet<QgsComposerItem*>::iterator item_it = mItems.begin();
+  for ( ; item_it != mItems.end(); ++item_it )
+  {
+    ( *item_it )->setVisibility( visible );
+  }
+  //lastly set visibility for group item itself
+  QgsComposerItem::setVisibility( visible );
+}
+
 void QgsComposerItemGroup::drawFrame( QPainter* p )
 {
   if ( !mComposition )

src/core/composer/qgscomposeritemgroup.h

@@ -42,6 +42,9 @@ class CORE_EXPORT QgsComposerItemGroup: public QgsComposerItem
        corresponds to 1 scene size unit*/
     void setSceneRect( const QRectF& rectangle );
 
+    //overridden to also hide grouped items
+    virtual void setVisibility( const bool visible );
+
     /** stores state in Dom node
        * @param elem is Dom element corresponding to 'Composer' tag
        * @param doc is the Dom document