Quantum GIS API Documentation  1.7.4
Public Types | Public Slots | Signals | Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes
QgsComposerView Class Reference

Widget to display the composer items. More...

#include <qgscomposerview.h>

Collaboration diagram for QgsComposerView:
Collaboration graph
[legend]

List of all members.

Public Types

enum  Tool {
  Select = 0, AddArrow, AddMap, AddLegend,
  AddLabel, AddScalebar, AddPicture, AddShape,
  AddTable, MoveItemContent
}
 Current tool. More...

Public Slots

void sendItemAddedSignal (QgsComposerItem *item)
 Casts object to the proper subclass type and calls corresponding itemAdded signal.

Signals

void selectedItemChanged (QgsComposerItem *selected)
 Is emitted when selected item changed.
void composerArrowAdded (QgsComposerArrow *arrow)
 Is emitted when new composer arrow has been added to the view.
void composerLabelAdded (QgsComposerLabel *label)
 Is emitted when new composer label has been added to the view.
void composerMapAdded (QgsComposerMap *map)
 Is emitted when new composer map has been added to the view.
void composerScaleBarAdded (QgsComposerScaleBar *scalebar)
 Is emitted when new composer scale bar has been added.
void composerLegendAdded (QgsComposerLegend *legend)
 Is emitted when a new composer legend has been added.
void composerPictureAdded (QgsComposerPicture *picture)
 Is emitted when a new composer picture has been added.
void composerShapeAdded (QgsComposerShape *shape)
 Is emitted when a new composer shape has been added.
void composerTableAdded (QgsComposerAttributeTable *table)
 Is emitted when a new composer table has been added.
void itemRemoved (QgsComposerItem *)
 Is emitted when a composer item has been removed from the scene.
void actionFinished ()
 Current action (e.g.

Public Member Functions

 QgsComposerView (QWidget *parent=0, const char *name=0, Qt::WFlags f=0)
void groupItems ()
 Add an item group containing the selected items.
void ungroupItems ()
 Ungroups the selected items.
QgsComposerView::Tool currentTool () const
void setCurrentTool (QgsComposerView::Tool t)
void setComposition (QgsComposition *c)
 Sets composition (derived from QGraphicsScene)
QgsCompositioncomposition ()
 Returns the composition or 0 in case of error.
void addComposerArrow (QgsComposerArrow *arrow)
 Adds an arrow item to the graphics scene and advices composer to create a widget for it (through signal)
void addComposerLabel (QgsComposerLabel *label)
 Adds label to the graphics scene and advices composer to create a widget for it (through signal)
void addComposerMap (QgsComposerMap *map)
 Adds map to the graphics scene and advices composer to create a widget for it (through signal)
void addComposerScaleBar (QgsComposerScaleBar *scaleBar)
 Adds scale bar to the graphics scene and advices composer to create a widget for it (through signal)
void addComposerLegend (QgsComposerLegend *legend)
 Adds legend to the graphics scene and advices composer to create a widget for it (through signal)
void addComposerPicture (QgsComposerPicture *picture)
 Adds picture to the graphics scene and advices composer to create a widget for it (through signal)
void addComposerShape (QgsComposerShape *shape)
 Adds a composer shape to the graphics scene and advices composer to create a widget for it (through signal)
void addComposerTable (QgsComposerAttributeTable *table)
 Adds a composer table to the graphics scene and advices composer to create a widget for it (through signal)
QMainWindow * composerWindow ()
 Returns the composer main window.
void setPaintingEnabled (bool enabled)
bool paintingEnabled () const
void pushAddRemoveCommand (QgsComposerItem *item, const QString &text, QgsAddRemoveItemCommand::State state=QgsAddRemoveItemCommand::Added)
 Convenience function to create a QgsAddRemoveItemCommand, connect its signals and push it to the undo stack.

Protected Member Functions

void mousePressEvent (QMouseEvent *)
void mouseReleaseEvent (QMouseEvent *)
void mouseMoveEvent (QMouseEvent *)
void mouseDoubleClickEvent (QMouseEvent *e)
void keyPressEvent (QKeyEvent *e)
void keyReleaseEvent (QKeyEvent *e)
void wheelEvent (QWheelEvent *event)
void paintEvent (QPaintEvent *event)

Private Member Functions

void connectAddRemoveCommandSignals (QgsAddRemoveItemCommand *c)

Private Attributes

bool mShiftKeyPressed
 Status of shift key (used for multiple selection)
QgsComposerView::Tool mCurrentTool
 Current composer tool.
QGraphicsRectItem * mRubberBandItem
 Rubber band item.
QGraphicsLineItem * mRubberBandLineItem
 Rubber band item for arrows.
QgsComposerItemmMoveContentItem
 Item to move content.
QPointF mMoveContentStartPos
 Start position of content move.
QPointF mRubberBandStartPos
 Start of rubber band creation.
bool mPaintingEnabled

Detailed Description

Widget to display the composer items.

Manages the composer tools and the mouse/key events. Creates the composer items according to the current map tools and keeps track of the rubber band item.

Definition at line 45 of file qgscomposerview.h.


Member Enumeration Documentation

Current tool.

Enumerator:
Select 
AddArrow 
AddMap 
AddLegend 
AddLabel 
AddScalebar 
AddPicture 
AddShape 
AddTable 
MoveItemContent 

Definition at line 52 of file qgscomposerview.h.


Constructor & Destructor Documentation

QgsComposerView::QgsComposerView ( QWidget *  parent = 0,
const char *  name = 0,
Qt::WFlags  f = 0 
)

Definition at line 33 of file qgscomposerview.cpp.


Member Function Documentation

Current action (e.g.

adding composer map) has been finished. The purpose of this signal is that QgsComposer may set the selection tool again

Referenced by mousePressEvent(), and mouseReleaseEvent().

Adds an arrow item to the graphics scene and advices composer to create a widget for it (through signal)

Definition at line 512 of file qgscomposerview.cpp.

References composerArrowAdded(), composition(), pushAddRemoveCommand(), selectedItemChanged(), and QgsComposerItem::setSelected().

Referenced by mouseReleaseEvent().

Adds label to the graphics scene and advices composer to create a widget for it (through signal)

Definition at line 522 of file qgscomposerview.cpp.

References composerLabelAdded(), composition(), pushAddRemoveCommand(), selectedItemChanged(), and QgsComposerItem::setSelected().

Referenced by mousePressEvent().

Adds legend to the graphics scene and advices composer to create a widget for it (through signal)

Definition at line 562 of file qgscomposerview.cpp.

References composerLegendAdded(), QgsComposition::composerMapItems(), composition(), pushAddRemoveCommand(), selectedItemChanged(), QgsComposerLegend::setComposerMap(), and QgsComposerItem::setSelected().

Referenced by mousePressEvent().

Adds map to the graphics scene and advices composer to create a widget for it (through signal)

Definition at line 532 of file qgscomposerview.cpp.

References QgsComposerMap::Cache, QgsComposerMap::cache(), composerMapAdded(), pushAddRemoveCommand(), selectedItemChanged(), QgsComposerMap::setPreviewMode(), and QgsComposerItem::setSelected().

Referenced by mouseReleaseEvent().

Adds picture to the graphics scene and advices composer to create a widget for it (through signal)

Definition at line 578 of file qgscomposerview.cpp.

References composerPictureAdded(), pushAddRemoveCommand(), selectedItemChanged(), and QgsComposerItem::setSelected().

Referenced by mousePressEvent().

Adds scale bar to the graphics scene and advices composer to create a widget for it (through signal)

Definition at line 545 of file qgscomposerview.cpp.

References QgsComposerScaleBar::applyDefaultSize(), QgsComposition::composerMapItems(), composerScaleBarAdded(), composition(), pushAddRemoveCommand(), selectedItemChanged(), QgsComposerScaleBar::setComposerMap(), and QgsComposerItem::setSelected().

Referenced by mousePressEvent().

Adds a composer shape to the graphics scene and advices composer to create a widget for it (through signal)

Definition at line 588 of file qgscomposerview.cpp.

References composerShapeAdded(), pushAddRemoveCommand(), selectedItemChanged(), and QgsComposerItem::setSelected().

Referenced by mouseReleaseEvent().

Adds a composer table to the graphics scene and advices composer to create a widget for it (through signal)

Definition at line 598 of file qgscomposerview.cpp.

References composerTableAdded(), pushAddRemoveCommand(), selectedItemChanged(), and QgsComposerItem::setSelected().

Referenced by mousePressEvent().

Is emitted when new composer arrow has been added to the view.

Referenced by addComposerArrow(), and sendItemAddedSignal().

Is emitted when new composer label has been added to the view.

Referenced by addComposerLabel(), and sendItemAddedSignal().

Is emitted when a new composer legend has been added.

Referenced by addComposerLegend(), and sendItemAddedSignal().

Is emitted when new composer map has been added to the view.

Referenced by addComposerMap(), and sendItemAddedSignal().

Is emitted when a new composer picture has been added.

Referenced by addComposerPicture(), and sendItemAddedSignal().

Is emitted when new composer scale bar has been added.

Referenced by addComposerScaleBar(), and sendItemAddedSignal().

Is emitted when a new composer shape has been added.

Referenced by addComposerShape(), and sendItemAddedSignal().

Is emitted when a new composer table has been added.

Referenced by addComposerTable(), and sendItemAddedSignal().

Returns the composer main window.

Definition at line 717 of file qgscomposerview.cpp.

Definition at line 739 of file qgscomposerview.cpp.

References itemRemoved(), and sendItemAddedSignal().

Referenced by keyPressEvent(), and pushAddRemoveCommand().

Definition at line 74 of file qgscomposerview.h.

Add an item group containing the selected items.

Definition at line 608 of file qgscomposerview.cpp.

References QgsComposerItemGroup::addItem(), composition(), QgsComposition::selectedComposerItems(), selectedItemChanged(), and QgsComposerItem::setSelected().

Is emitted when a composer item has been removed from the scene.

Referenced by connectAddRemoveCommandSignals(), keyPressEvent(), and ungroupItems().

void QgsComposerView::keyPressEvent ( QKeyEvent *  e) [protected]
void QgsComposerView::keyReleaseEvent ( QKeyEvent *  e) [protected]

Definition at line 455 of file qgscomposerview.cpp.

References mShiftKeyPressed.

void QgsComposerView::mouseDoubleClickEvent ( QMouseEvent *  e) [protected]

Definition at line 368 of file qgscomposerview.cpp.

void QgsComposerView::mouseMoveEvent ( QMouseEvent *  e) [protected]
void QgsComposerView::mousePressEvent ( QMouseEvent *  e) [protected]
void QgsComposerView::mouseReleaseEvent ( QMouseEvent *  e) [protected]
void QgsComposerView::paintEvent ( QPaintEvent *  event) [protected]

Definition at line 481 of file qgscomposerview.cpp.

References mPaintingEnabled.

bool QgsComposerView::paintingEnabled ( ) const [inline]

Definition at line 103 of file qgscomposerview.h.

Sets composition (derived from QGraphicsScene)

Definition at line 494 of file qgscomposerview.cpp.

Definition at line 75 of file qgscomposerview.h.

void QgsComposerView::setPaintingEnabled ( bool  enabled) [inline]

Definition at line 102 of file qgscomposerview.h.

Ungroups the selected items.

Definition at line 633 of file qgscomposerview.cpp.

References composition(), itemRemoved(), QgsComposerItemGroup::removeItems(), and QgsComposition::selectedComposerItems().

void QgsComposerView::wheelEvent ( QWheelEvent *  event) [protected]

Member Data Documentation

Current composer tool.

Definition at line 126 of file qgscomposerview.h.

Referenced by mouseMoveEvent(), mousePressEvent(), and mouseReleaseEvent().

Item to move content.

Definition at line 132 of file qgscomposerview.h.

Referenced by mouseMoveEvent(), mousePressEvent(), and mouseReleaseEvent().

Start position of content move.

Definition at line 134 of file qgscomposerview.h.

Referenced by mouseMoveEvent(), mousePressEvent(), and mouseReleaseEvent().

Definition at line 138 of file qgscomposerview.h.

Referenced by paintEvent().

QGraphicsRectItem* QgsComposerView::mRubberBandItem [private]

Rubber band item.

Definition at line 128 of file qgscomposerview.h.

Referenced by mouseMoveEvent(), mousePressEvent(), and mouseReleaseEvent().

QGraphicsLineItem* QgsComposerView::mRubberBandLineItem [private]

Rubber band item for arrows.

Definition at line 130 of file qgscomposerview.h.

Referenced by mouseMoveEvent(), mousePressEvent(), and mouseReleaseEvent().

Start of rubber band creation.

Definition at line 136 of file qgscomposerview.h.

Referenced by mouseMoveEvent(), mousePressEvent(), and mouseReleaseEvent().

Status of shift key (used for multiple selection)

Definition at line 124 of file qgscomposerview.h.

Referenced by keyPressEvent(), keyReleaseEvent(), and mousePressEvent().


The documentation for this class was generated from the following files:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines