QGIS API Documentation
2.18.21-Las Palmas (9fba24a)
|
A item that forms part of a map composition. More...
#include <qgscomposeritem.h>
Public Slots | |
virtual void | refreshDataDefinedProperty (const QgsComposerObject::DataDefinedProperty property=QgsComposerObject::AllProperties, const QgsExpressionContext *context=nullptr) override |
Refreshes a data defined property for the item by reevaluating the property's value and redrawing the item with this new value. More... | |
void | repaint () override |
virtual void | setItemRotation (const double r, const bool adjustPosition=false) |
Sets the item rotation. More... | |
virtual void | setRotation (double r) |
Sets the item rotation. More... | |
Public Slots inherited from QgsComposerObject | |
virtual void | refreshDataDefinedProperty (const DataDefinedProperty property=AllProperties, const QgsExpressionContext *context=nullptr) |
Refreshes a data defined property for the item by reevaluating the property's value and redrawing the item with this new value. More... | |
virtual void | repaint () |
Triggers a redraw for the item. More... | |
Signals | |
void | frameChanged () |
Emitted if the item's frame style changes. More... | |
void | itemRotationChanged (double newRotation) |
Is emitted on item rotation change. More... | |
void | lockChanged () |
Emitted if the item's lock status changes. More... | |
void | sizeChanged () |
Emitted if the rectangle changes. More... | |
Signals inherited from QgsComposerObject | |
void | itemChanged () |
Emitted when the item changes. More... | |
Public Member Functions | |
QgsComposerItem (QgsComposition *composition, bool manageZValue=true) | |
Constructor. More... | |
QgsComposerItem (qreal x, qreal y, qreal width, qreal height, QgsComposition *composition, bool manageZValue=true) | |
Constructor with box position and composer object. More... | |
virtual | ~QgsComposerItem () |
bool | _readXML (const QDomElement &itemElem, const QDomDocument &doc) |
Reads parameter that are not subclass specific in document. More... | |
bool | _writeXML (QDomElement &itemElem, QDomDocument &doc) const |
Writes parameter that are not subclass specific in document. More... | |
virtual void | addItem (QgsComposerItem *item) |
Composite operations for item groups do nothing per default. More... | |
QColor | backgroundColor () const |
Gets the background color for this item. More... | |
void | beginCommand (const QString &commandText, QgsComposerMergeCommand::Context c=QgsComposerMergeCommand::Unknown) |
Starts new composer undo command. More... | |
virtual void | beginItemCommand (const QString &text) |
QPainter::CompositionMode | blendMode () const |
Returns the item's composition blending mode. More... | |
void | cancelCommand () |
virtual QgsExpressionContext * | createExpressionContext () const override |
Creates an expression context relating to the item's current state. More... | |
virtual QString | displayName () const |
Get item display name. More... | |
Q_DECL_DEPRECATED void | drawText (QPainter *p, double x, double y, const QString &text, const QFont &font, const QColor &c=QColor()) const |
Draws Text. More... | |
Q_DECL_DEPRECATED void | drawText (QPainter *p, const QRectF &rect, const QString &text, const QFont &font, Qt::AlignmentFlag halignment=Qt::AlignLeft, Qt::AlignmentFlag valignment=Qt::AlignTop, int flags=Qt::TextWordWrap) const |
Like the above, but with a rectangle for multiline text. More... | |
bool | effectsEnabled () const |
Returns whether effects (eg blend modes) are enabled for the item. More... | |
void | endCommand () |
Finish current command and push it onto the undo stack. More... | |
virtual void | endItemCommand () |
virtual double | estimatedFrameBleed () const |
Returns the estimated amount the item's frame bleeds outside the item's actual rectangle. More... | |
bool | excludeFromExports (const QgsComposerObject::PropertyValueType valueType=QgsComposerObject::EvaluatedValue) |
Returns whether the item should be excluded from composer exports and prints. More... | |
Q_DECL_DEPRECATED double | fontAscentMillimeters (const QFont &font) const |
Returns the font ascent in Millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE. More... | |
Q_DECL_DEPRECATED double | fontDescentMillimeters (const QFont &font) const |
Returns the font descent in Millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE. More... | |
Q_DECL_DEPRECATED double | fontHeightCharacterMM (const QFont &font, QChar c) const |
Returns the font height of a character in millimeters. More... | |
Q_DECL_DEPRECATED double | fontHeightMillimeters (const QFont &font) const |
Returns the font height in Millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE. More... | |
Qt::PenJoinStyle | frameJoinStyle () const |
Returns the join style used for drawing the item's frame. More... | |
QColor | frameOutlineColor () const |
Returns the frame's outline color. More... | |
double | frameOutlineWidth () const |
Returns the frame's outline width. More... | |
bool | hasBackground () const |
Whether this item has a Background or not. More... | |
bool | hasFrame () const |
Whether this item has a frame or not. More... | |
QString | id () const |
Get item's id (which is not necessarly unique) More... | |
bool | isGroupMember () const |
Returns whether this item is part of a group. More... | |
virtual bool | isRemoved () const |
Returns whether this item has been removed from the composition. More... | |
double | itemRotation (const QgsComposerObject::PropertyValueType valueType=QgsComposerObject::EvaluatedValue) const |
Returns the current rotation for the composer item. More... | |
ItemPositionMode | lastUsedPositionMode () |
Returns item's last used position mode. More... | |
void | move (double dx, double dy) |
Moves item in canvas coordinates. More... | |
virtual void | moveContent (double dx, double dy) |
Move Content of item. More... | |
virtual int | numberExportLayers () const |
Get the number of layers that this item requires for exporting as layers. More... | |
int | page () const |
Gets the page the item is currently on. More... | |
QPointF | pagePos () const |
Returns the item's position relative to its current page. More... | |
Q_DECL_DEPRECATED double | pixelFontSize (double pointSize) const |
Calculates font size in mm from a font point size. More... | |
bool | positionLock () const |
Returns whether position lock for mouse drags is enabled returns true if item is locked for mouse movement and resizing. More... | |
virtual QRectF | rectWithFrame () const |
Returns the item's rectangular bounds, including any bleed caused by the item's frame. More... | |
virtual void | removeItems () |
Q_DECL_DEPRECATED double | rotation () const |
Returns the rotation for the composer item. More... | |
Q_DECL_DEPRECATED QFont | scaledFontPixelSize (const QFont &font) const |
Returns a font where size is in pixel and font size is upscaled with FONT_WORKAROUND_SCALE. More... | |
virtual bool | selected () const |
Is selected. More... | |
void | setBackgroundColor (const QColor &backgroundColor) |
Sets the background color for this item. More... | |
void | setBackgroundEnabled (const bool drawBackground) |
Set whether this item has a Background drawn around it or not. More... | |
void | setBlendMode (const QPainter::CompositionMode blendMode) |
Sets the item's composition blending mode. More... | |
virtual void | setCurrentExportLayer (const int layerIdx=-1) |
Sets the current layer to draw for exporting. More... | |
void | setEffectsEnabled (const bool effectsEnabled) |
Sets whether effects (eg blend modes) are enabled for the item. More... | |
virtual void | setExcludeFromExports (const bool exclude) |
Sets whether the item should be excluded from composer exports and prints. More... | |
virtual void | setFrameEnabled (const bool drawFrame) |
Set whether this item has a frame drawn around it or not. More... | |
void | setFrameJoinStyle (const Qt::PenJoinStyle style) |
Sets join style used when drawing the item's frame. More... | |
virtual void | setFrameOutlineColor (const QColor &color) |
Sets frame outline color. More... | |
virtual void | setFrameOutlineWidth (const double outlineWidth) |
Sets frame outline width. More... | |
virtual void | setId (const QString &id) |
Set item's id (which is not necessarly unique) More... | |
void | setIsGroupMember (const bool isGroupMember) |
Sets whether this item is part of a group. More... | |
void | setIsRemoved (const bool removed) |
Sets whether this item has been removed from the composition. More... | |
void | setItemPosition (double x, double y, ItemPositionMode itemPoint=UpperLeft, int page=-1) |
Moves the item to a new position (in canvas coordinates) More... | |
void | setItemPosition (double x, double y, double width, double height, ItemPositionMode itemPoint=UpperLeft, bool posIncludesFrame=false, int page=-1) |
Sets item position and width / height in one go. More... | |
void | setPositionLock (const bool lock) |
Locks / unlocks the item position for mouse drags. More... | |
virtual void | setSceneRect (const QRectF &rectangle) |
Sets this items bound in scene coordinates such that 1 item size units corresponds to 1 scene size unit. More... | |
virtual void | setSelected (bool s) |
Set selected, selected item should be highlighted. More... | |
void | setTransparency (const int transparency) |
Sets the item's transparency. More... | |
virtual void | setVisibility (const bool visible) |
Sets visibility for item. More... | |
Q_DECL_DEPRECATED double | textWidthMillimeters (const QFont &font, const QString &text) const |
Returns the font width in millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE. More... | |
int | transparency () const |
Returns the item's transparency. More... | |
virtual int | type () const override |
Return correct graphics item type. More... | |
virtual void | updateItem () |
Updates item, with the possibility to do custom update for subclasses. More... | |
void | updatePagePos (double newPageWidth, double newPageHeight) |
Moves the item so that it retains its relative position on the page when the paper size changes. More... | |
QString | uuid () const |
Get item identification name. More... | |
virtual Q_DECL_DEPRECATED void | zoomContent (int delta, double x, double y) |
Zoom content of item. More... | |
virtual void | zoomContent (const double factor, const QPointF point, const ZoomMode mode=QgsComposerItem::Zoom) |
Zoom content of item. More... | |
Public Member Functions inherited from QgsComposerObject | |
QgsComposerObject (QgsComposition *composition) | |
Constructor. More... | |
virtual | ~QgsComposerObject () |
const QgsComposition * | composition () const |
Returns the composition the item is attached to. More... | |
QgsComposition * | composition () |
QStringList | customProperties () const |
Return list of keys stored in custom properties for the object. More... | |
QVariant | customProperty (const QString &key, const QVariant &defaultValue=QVariant()) const |
Read a custom property from the object. More... | |
QgsDataDefined * | dataDefinedProperty (const DataDefinedProperty property) const |
Returns a reference to the data defined settings for one of the item's data defined properties. More... | |
virtual bool | readXML (const QDomElement &itemElem, const QDomDocument &doc) |
Sets item state from DOM element. More... | |
void | removeCustomProperty (const QString &key) |
Remove a custom property from the object. More... | |
void | setCustomProperty (const QString &key, const QVariant &value) |
Set a custom property for the object. More... | |
void | setDataDefinedProperty (const DataDefinedProperty property, const bool active, const bool useExpression, const QString &expression, const QString &field) |
Sets parameters for a data defined property for the item. More... | |
virtual bool | writeXML (QDomElement &elem, QDomDocument &doc) const |
Stores item state in DOM element. More... | |
Public Member Functions inherited from QObject | |
QObject (QObject *parent) | |
QObject (QObject *parent, const char *name) | |
virtual | ~QObject () |
bool | blockSignals (bool block) |
QObject * | child (const char *objName, const char *inheritsClass, bool recursiveSearch) const |
const QObjectList & | children () const |
const char * | className () const |
bool | connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const |
void | deleteLater () |
void | destroyed (QObject *obj) |
bool | disconnect (const QObject *receiver, const char *method) |
bool | disconnect (const char *signal, const QObject *receiver, const char *method) |
void | dumpObjectInfo () |
void | dumpObjectTree () |
QList< QByteArray > | dynamicPropertyNames () const |
virtual bool | event (QEvent *e) |
virtual bool | eventFilter (QObject *watched, QEvent *event) |
T | findChild (const QString &name) const |
QList< T > | findChildren (const QRegExp ®Exp) const |
QList< T > | findChildren (const QString &name) const |
bool | inherits (const char *className) const |
void | insertChild (QObject *object) |
void | installEventFilter (QObject *filterObj) |
bool | isA (const char *className) const |
bool | isWidgetType () const |
void | killTimer (int id) |
virtual const QMetaObject * | metaObject () const |
void | moveToThread (QThread *targetThread) |
const char * | name () const |
const char * | name (const char *defaultName) const |
QString | objectName () const |
QObject * | parent () const |
QVariant | property (const char *name) const |
void | removeChild (QObject *object) |
void | removeEventFilter (QObject *obj) |
void | setName (const char *name) |
void | setObjectName (const QString &name) |
void | setParent (QObject *parent) |
bool | setProperty (const char *name, const QVariant &value) |
bool | signalsBlocked () const |
int | startTimer (int interval) |
QThread * | thread () const |
Public Member Functions inherited from QGraphicsRectItem | |
QGraphicsRectItem (QGraphicsItem *parent) | |
QGraphicsRectItem (const QRectF &rect, QGraphicsItem *parent) | |
QGraphicsRectItem (qreal x, qreal y, qreal width, qreal height, QGraphicsItem *parent) | |
~QGraphicsRectItem () | |
virtual QRectF | boundingRect () const |
virtual bool | contains (const QPointF &point) const |
virtual bool | isObscuredBy (const QGraphicsItem *item) const |
virtual QPainterPath | opaqueArea () const |
virtual void | paint (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) |
QRectF | rect () const |
void | setRect (const QRectF &rectangle) |
void | setRect (qreal x, qreal y, qreal width, qreal height) |
virtual QPainterPath | shape () const |
Public Member Functions inherited from QAbstractGraphicsShapeItem | |
QAbstractGraphicsShapeItem (QGraphicsItem *parent) | |
~QAbstractGraphicsShapeItem () | |
QBrush | brush () const |
QPen | pen () const |
void | setBrush (const QBrush &brush) |
void | setPen (const QPen &pen) |
Public Member Functions inherited from QGraphicsItem | |
QGraphicsItem (QGraphicsItem *parent) | |
virtual | ~QGraphicsItem () |
bool | acceptDrops () const |
Qt::MouseButtons | acceptedMouseButtons () const |
bool | acceptHoverEvents () const |
bool | acceptsHoverEvents () const |
bool | acceptTouchEvents () const |
virtual void | advance (int phase) |
virtual QRectF | boundingRect () const=0 |
QRegion | boundingRegion (const QTransform &itemToDeviceTransform) const |
qreal | boundingRegionGranularity () const |
CacheMode | cacheMode () const |
QList< QGraphicsItem * > | childItems () const |
QList< QGraphicsItem * > | children () const |
QRectF | childrenBoundingRect () const |
void | clearFocus () |
QPainterPath | clipPath () const |
virtual bool | collidesWithItem (const QGraphicsItem *other, Qt::ItemSelectionMode mode) const |
virtual bool | collidesWithPath (const QPainterPath &path, Qt::ItemSelectionMode mode) const |
QList< QGraphicsItem * > | collidingItems (Qt::ItemSelectionMode mode) const |
QGraphicsItem * | commonAncestorItem (const QGraphicsItem *other) const |
QCursor | cursor () const |
QVariant | data (int key) const |
QTransform | deviceTransform (const QTransform &viewportTransform) const |
qreal | effectiveOpacity () const |
void | ensureVisible (const QRectF &rect, int xmargin, int ymargin) |
void | ensureVisible (qreal x, qreal y, qreal w, qreal h, int xmargin, int ymargin) |
bool | filtersChildEvents () const |
GraphicsItemFlags | flags () const |
QGraphicsItem * | focusItem () const |
QGraphicsItem * | focusProxy () const |
void | grabKeyboard () |
void | grabMouse () |
QGraphicsEffect * | graphicsEffect () const |
QGraphicsItemGroup * | group () const |
bool | handlesChildEvents () const |
bool | hasCursor () const |
bool | hasFocus () const |
void | hide () |
Qt::InputMethodHints | inputMethodHints () const |
void | installSceneEventFilter (QGraphicsItem *filterItem) |
bool | isActive () const |
bool | isAncestorOf (const QGraphicsItem *child) const |
bool | isBlockedByModalPanel (QGraphicsItem **blockingPanel) const |
bool | isClipped () const |
bool | isEnabled () const |
bool | isObscured () const |
bool | isObscured (const QRectF &rect) const |
bool | isObscured (qreal x, qreal y, qreal w, qreal h) const |
bool | isPanel () const |
bool | isSelected () const |
bool | isUnderMouse () const |
bool | isVisible () const |
bool | isVisibleTo (const QGraphicsItem *parent) const |
bool | isWidget () const |
bool | isWindow () const |
QTransform | itemTransform (const QGraphicsItem *other, bool *ok) const |
QPointF | mapFromItem (const QGraphicsItem *item, const QPointF &point) const |
QPolygonF | mapFromItem (const QGraphicsItem *item, const QRectF &rect) const |
QPolygonF | mapFromItem (const QGraphicsItem *item, const QPolygonF &polygon) const |
QPainterPath | mapFromItem (const QGraphicsItem *item, const QPainterPath &path) const |
QPointF | mapFromItem (const QGraphicsItem *item, qreal x, qreal y) const |
QPolygonF | mapFromItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const |
QPointF | mapFromParent (const QPointF &point) const |
QPolygonF | mapFromParent (const QRectF &rect) const |
QPolygonF | mapFromParent (const QPolygonF &polygon) const |
QPainterPath | mapFromParent (const QPainterPath &path) const |
QPointF | mapFromParent (qreal x, qreal y) const |
QPolygonF | mapFromParent (qreal x, qreal y, qreal w, qreal h) const |
QPolygonF | mapFromScene (const QPolygonF &polygon) const |
QPointF | mapFromScene (const QPointF &point) const |
QPolygonF | mapFromScene (const QRectF &rect) const |
QPainterPath | mapFromScene (const QPainterPath &path) const |
QPointF | mapFromScene (qreal x, qreal y) const |
QPolygonF | mapFromScene (qreal x, qreal y, qreal w, qreal h) const |
QRectF | mapRectFromItem (const QGraphicsItem *item, const QRectF &rect) const |
QRectF | mapRectFromItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const |
QRectF | mapRectFromParent (const QRectF &rect) const |
QRectF | mapRectFromParent (qreal x, qreal y, qreal w, qreal h) const |
QRectF | mapRectFromScene (qreal x, qreal y, qreal w, qreal h) const |
QRectF | mapRectFromScene (const QRectF &rect) const |
QRectF | mapRectToItem (const QGraphicsItem *item, const QRectF &rect) const |
QRectF | mapRectToItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const |
QRectF | mapRectToParent (const QRectF &rect) const |
QRectF | mapRectToParent (qreal x, qreal y, qreal w, qreal h) const |
QRectF | mapRectToScene (const QRectF &rect) const |
QRectF | mapRectToScene (qreal x, qreal y, qreal w, qreal h) const |
QPointF | mapToItem (const QGraphicsItem *item, const QPointF &point) const |
QPolygonF | mapToItem (const QGraphicsItem *item, const QRectF &rect) const |
QPolygonF | mapToItem (const QGraphicsItem *item, const QPolygonF &polygon) const |
QPainterPath | mapToItem (const QGraphicsItem *item, const QPainterPath &path) const |
QPointF | mapToItem (const QGraphicsItem *item, qreal x, qreal y) const |
QPolygonF | mapToItem (const QGraphicsItem *item, qreal x, qreal y, qreal w, qreal h) const |
QPointF | mapToParent (const QPointF &point) const |
QPolygonF | mapToParent (const QRectF &rect) const |
QPainterPath | mapToParent (const QPainterPath &path) const |
QPointF | mapToParent (qreal x, qreal y) const |
QPolygonF | mapToParent (qreal x, qreal y, qreal w, qreal h) const |
QPolygonF | mapToParent (const QPolygonF &polygon) const |
QPolygonF | mapToScene (const QRectF &rect) const |
QPainterPath | mapToScene (const QPainterPath &path) const |
QPointF | mapToScene (qreal x, qreal y) const |
QPolygonF | mapToScene (qreal x, qreal y, qreal w, qreal h) const |
QPolygonF | mapToScene (const QPolygonF &polygon) const |
QPointF | mapToScene (const QPointF &point) const |
QMatrix | matrix () const |
void | moveBy (qreal dx, qreal dy) |
qreal | opacity () const |
virtual void | paint (QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)=0 |
QGraphicsItem * | panel () const |
PanelModality | panelModality () const |
QGraphicsItem * | parentItem () const |
QGraphicsObject * | parentObject () const |
QGraphicsWidget * | parentWidget () const |
QPointF | pos () const |
void | removeSceneEventFilter (QGraphicsItem *filterItem) |
void | resetMatrix () |
void | resetTransform () |
void | rotate (qreal angle) |
qreal | rotation () const |
void | scale (qreal sx, qreal sy) |
qreal | scale () const |
QGraphicsScene * | scene () const |
QRectF | sceneBoundingRect () const |
QMatrix | sceneMatrix () const |
QPointF | scenePos () const |
QTransform | sceneTransform () const |
void | scroll (qreal dx, qreal dy, const QRectF &rect) |
void | setAcceptDrops (bool on) |
void | setAcceptedMouseButtons (QFlags< Qt::MouseButton > buttons) |
void | setAcceptHoverEvents (bool enabled) |
void | setAcceptsHoverEvents (bool enabled) |
void | setAcceptTouchEvents (bool enabled) |
void | setActive (bool active) |
void | setBoundingRegionGranularity (qreal granularity) |
void | setCacheMode (CacheMode mode, const QSize &logicalCacheSize) |
void | setCursor (const QCursor &cursor) |
void | setData (int key, const QVariant &value) |
void | setEnabled (bool enabled) |
void | setFiltersChildEvents (bool enabled) |
void | setFlag (GraphicsItemFlag flag, bool enabled) |
void | setFlags (QFlags< QGraphicsItem::GraphicsItemFlag > flags) |
void | setFocus (Qt::FocusReason focusReason) |
void | setFocusProxy (QGraphicsItem *item) |
void | setGraphicsEffect (QGraphicsEffect *effect) |
void | setGroup (QGraphicsItemGroup *group) |
void | setHandlesChildEvents (bool enabled) |
void | setInputMethodHints (QFlags< Qt::InputMethodHint > hints) |
void | setMatrix (const QMatrix &matrix, bool combine) |
void | setOpacity (qreal opacity) |
void | setPanelModality (PanelModality panelModality) |
void | setParentItem (QGraphicsItem *newParent) |
void | setPos (const QPointF &pos) |
void | setPos (qreal x, qreal y) |
void | setRotation (qreal angle) |
void | setScale (qreal factor) |
void | setSelected (bool selected) |
void | setToolTip (const QString &toolTip) |
void | setTransform (const QTransform &matrix, bool combine) |
void | setTransformations (const QList< QGraphicsTransform * > &transformations) |
void | setTransformOriginPoint (qreal x, qreal y) |
void | setTransformOriginPoint (const QPointF &origin) |
void | setVisible (bool visible) |
void | setX (qreal x) |
void | setY (qreal y) |
void | setZValue (qreal z) |
void | shear (qreal sh, qreal sv) |
void | show () |
void | stackBefore (const QGraphicsItem *sibling) |
QGraphicsObject * | toGraphicsObject () |
const QGraphicsObject * | toGraphicsObject () const |
QString | toolTip () const |
QGraphicsItem * | topLevelItem () const |
QGraphicsWidget * | topLevelWidget () const |
QTransform | transform () const |
QList< QGraphicsTransform * > | transformations () const |
QPointF | transformOriginPoint () const |
void | translate (qreal dx, qreal dy) |
void | ungrabKeyboard () |
void | ungrabMouse () |
void | unsetCursor () |
void | update (qreal x, qreal y, qreal width, qreal height) |
void | update (const QRectF &rect) |
QGraphicsWidget * | window () const |
qreal | x () const |
qreal | y () const |
qreal | zValue () const |
Protected Member Functions | |
Q_DECL_DEPRECATED double | angle (QPointF p1, QPointF p2) const |
Returns angle of the line from p1 to p2 (clockwise, starting at N) More... | |
Q_DECL_DEPRECATED bool | cornerPointOnRotatedAndScaledRect (double &x, double &y, double width, double height, double rotation) const |
Calculates corner point after rotation and scaling. More... | |
Q_DECL_DEPRECATED bool | cornerPointOnRotatedAndScaledRect (double &x, double &y, double width, double height) const |
Calculates corner point after rotation and scaling. More... | |
void | deleteAlignItems () |
void | deleteHAlignSnapItem () |
void | deleteVAlignSnapItem () |
Q_DECL_DEPRECATED void | drawArrowHead (QPainter *p, double x, double y, double angle, double arrowHeadWidth) const |
Draws arrowhead. More... | |
virtual void | drawBackground (QPainter *p) |
Draw background. More... | |
virtual void | drawFrame (QPainter *p) |
Draw black frame around item. More... | |
virtual void | drawSelectionBoxes (QPainter *p) |
Draws additional graphics on selected items. More... | |
QRectF | evalItemRect (const QRectF &newRect, const bool resizeOnly=false, const QgsExpressionContext *context=nullptr) |
Evaluates an item's bounding rect to consider data defined position and size of item and reference point. More... | |
QGraphicsLineItem * | hAlignSnapItem () |
Return horizontal align snap item. More... | |
double | horizontalViewScaleFactor () const |
Returns the zoom factor of the graphics view. More... | |
Q_DECL_DEPRECATED bool | imageSizeConsideringRotation (double &width, double &height, double rotation) const |
Calculates width and hight of the picture (in mm) such that it fits into the item frame with the given rotation. More... | |
Q_DECL_DEPRECATED bool | imageSizeConsideringRotation (double &width, double &height) const |
Calculates width and hight of the picture (in mm) such that it fits into the item frame with the given rotation. More... | |
Q_DECL_DEPRECATED QRectF | largestRotatedRectWithinBounds (const QRectF &originalRect, const QRectF &boundsRect, double rotation) const |
Calculates the largest scaled version of originalRect which fits within boundsRect, when it is rotated by a specified amount. More... | |
Q_DECL_DEPRECATED double | lockSymbolSize () const |
Returns the size of the lock symbol depending on the composer zoom level and the item size. More... | |
double | rectHandlerBorderTolerance () const |
Returns the current (zoom level dependent) tolerance to decide if mouse position is close enough to the item border for resizing. More... | |
Q_DECL_DEPRECATED void | rotate (double angle, double &x, double &y) const |
Rotates a point / vector. More... | |
bool | shouldDrawItem () const |
Returns whether the item should be drawn in the current context. More... | |
Q_DECL_DEPRECATED void | sizeChangedByRotation (double &width, double &height, double rotation) |
Calculates width / height of the bounding box of a rotated rectangle. More... | |
Q_DECL_DEPRECATED void | sizeChangedByRotation (double &width, double &height) |
Calculates width / height of the bounding box of a rotated rectangle. More... | |
QGraphicsLineItem * | vAlignSnapItem () |
Return vertical align snap item. More... | |
Protected Member Functions inherited from QgsComposerObject | |
bool | dataDefinedEvaluate (const QgsComposerObject::DataDefinedProperty property, QVariant &expressionValue, const QgsExpressionContext &context=QgsExpressionContext()) const |
Evaluate a data defined property and return the calculated value. More... | |
Protected Member Functions inherited from QObject | |
bool | checkConnectArgs (const char *signal, const QObject *object, const char *method) |
virtual void | childEvent (QChildEvent *event) |
virtual void | connectNotify (const char *signal) |
virtual void | customEvent (QEvent *event) |
virtual void | disconnectNotify (const char *signal) |
int | receivers (const char *signal) const |
QObject * | sender () const |
int | senderSignalIndex () const |
virtual void | timerEvent (QTimerEvent *event) |
Protected Member Functions inherited from QGraphicsItem | |
virtual void | contextMenuEvent (QGraphicsSceneContextMenuEvent *event) |
virtual void | dragEnterEvent (QGraphicsSceneDragDropEvent *event) |
virtual void | dragLeaveEvent (QGraphicsSceneDragDropEvent *event) |
virtual void | dragMoveEvent (QGraphicsSceneDragDropEvent *event) |
virtual void | dropEvent (QGraphicsSceneDragDropEvent *event) |
virtual void | focusInEvent (QFocusEvent *event) |
virtual void | focusOutEvent (QFocusEvent *event) |
virtual void | hoverEnterEvent (QGraphicsSceneHoverEvent *event) |
virtual void | hoverLeaveEvent (QGraphicsSceneHoverEvent *event) |
virtual void | hoverMoveEvent (QGraphicsSceneHoverEvent *event) |
virtual void | inputMethodEvent (QInputMethodEvent *event) |
virtual QVariant | inputMethodQuery (Qt::InputMethodQuery query) const |
virtual QVariant | itemChange (GraphicsItemChange change, const QVariant &value) |
virtual void | keyPressEvent (QKeyEvent *event) |
virtual void | keyReleaseEvent (QKeyEvent *event) |
virtual void | mouseDoubleClickEvent (QGraphicsSceneMouseEvent *event) |
virtual void | mouseMoveEvent (QGraphicsSceneMouseEvent *event) |
virtual void | mousePressEvent (QGraphicsSceneMouseEvent *event) |
virtual void | mouseReleaseEvent (QGraphicsSceneMouseEvent *event) |
void | prepareGeometryChange () |
virtual bool | sceneEvent (QEvent *event) |
virtual bool | sceneEventFilter (QGraphicsItem *watched, QEvent *event) |
void | updateMicroFocus () |
virtual void | wheelEvent (QGraphicsSceneWheelEvent *event) |
Protected Attributes | |
bool | mBackground |
True if item background needs to be painted. More... | |
QColor | mBackgroundColor |
Background color. More... | |
QPainter::CompositionMode | mBlendMode |
Composition blend mode for item. More... | |
QGraphicsRectItem * | mBoundingResizeRectangle |
Rectangle used during move and resize actions. More... | |
int | mCurrentExportLayer |
The layer that needs to be exported. More... | |
QgsComposerItem::MouseMoveAction | mCurrentMouseMoveAction |
QgsComposerEffect * | mEffect |
bool | mEffectsEnabled |
bool | mEvaluatedExcludeFromExports |
Temporary evaluated item exclusion. More... | |
double | mEvaluatedItemRotation |
Temporary evaluated item rotation in degrees, clockwise. More... | |
bool | mExcludeFromExports |
Whether item should be excluded in exports. More... | |
bool | mFrame |
True if item fram needs to be painted. More... | |
Qt::PenJoinStyle | mFrameJoinStyle |
Frame join style. More... | |
QGraphicsLineItem * | mHAlignSnapItem |
bool | mIsGroupMember |
Whether or not this item is part of a group. More... | |
bool | mItemPositionLocked |
True if item position and size cannot be changed with mouse move. More... | |
double | mItemRotation |
Item rotation in degrees, clockwise. More... | |
QPointF | mLastMouseEventPos |
Position of the last mouse move event (in scene coordinates) More... | |
ItemPositionMode | mLastUsedPositionMode |
The item's position mode. More... | |
double | mLastValidViewScaleFactor |
Backup to restore item appearance if no view scale factor is available. More... | |
QPointF | mMouseMoveStartPos |
Start point of the last mouse move action (in scene coordinates) More... | |
bool | mRemovedFromComposition |
True if item has been removed from the composition. More... | |
int | mTransparency |
Item transparency. More... | |
QGraphicsLineItem * | mVAlignSnapItem |
Protected Attributes inherited from QgsComposerObject | |
QgsComposition * | mComposition |
QgsObjectCustomProperties | mCustomProperties |
Custom properties for object. More... | |
QMap< QgsComposerObject::DataDefinedProperty, QString > | mDataDefinedNames |
Map of data defined properties for the item to string name to use when exporting item to xml. More... | |
Friends | |
class | QgsComposerItemGroup |
Additional Inherited Members | |
Static Public Member Functions inherited from QObject | |
bool | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type) |
bool | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type) |
bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method) |
bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method) |
QString | tr (const char *sourceText, const char *disambiguation, int n) |
QString | trUtf8 (const char *sourceText, const char *disambiguation, int n) |
Public Attributes inherited from QGraphicsItem | |
typedef | GraphicsItemFlags |
Static Protected Member Functions inherited from QObject | |
QByteArray | normalizeSignalSlot (const char *signalSlot) |
Properties inherited from QObject | |
objectName | |
A item that forms part of a map composition.
Definition at line 39 of file qgscomposeritem.h.
Enumerator | |
---|---|
UpperLeft | |
UpperMiddle | |
UpperRight | |
MiddleLeft | |
Middle | |
MiddleRight | |
LowerLeft | |
LowerMiddle | |
LowerRight |
Definition at line 82 of file qgscomposeritem.h.
Definition at line 44 of file qgscomposeritem.h.
Describes the action (move or resize in different directon) to be done during mouse move.
Enumerator | |
---|---|
MoveItem | |
ResizeUp | |
ResizeDown | |
ResizeLeft | |
ResizeRight | |
ResizeLeftUp | |
ResizeRightUp | |
ResizeLeftDown | |
ResizeRightDown | |
NoAction |
Definition at line 68 of file qgscomposeritem.h.
Modes for zooming item content.
Enumerator | |
---|---|
Zoom | Zoom to center of content |
ZoomRecenter | Zoom and recenter content to point |
ZoomToPoint | Zoom while maintaining relative position of point |
NoZoom | No zoom |
Definition at line 99 of file qgscomposeritem.h.
QgsComposerItem::QgsComposerItem | ( | QgsComposition * | composition, |
bool | manageZValue = true |
||
) |
Constructor.
composition | parent composition |
manageZValue | true if the z-Value of this object should be managed by mComposition |
Definition at line 47 of file qgscomposeritem.cpp.
QgsComposerItem::QgsComposerItem | ( | qreal | x, |
qreal | y, | ||
qreal | width, | ||
qreal | height, | ||
QgsComposition * | composition, | ||
bool | manageZValue = true |
||
) |
Constructor with box position and composer object.
x | x coordinate of item |
y | y coordinate of item |
width | width of item |
height | height of item |
composition | parent composition |
manageZValue | true if the z-Value of this object should be managed by mComposition |
Definition at line 76 of file qgscomposeritem.cpp.
|
virtual |
Definition at line 142 of file qgscomposeritem.cpp.
bool QgsComposerItem::_readXML | ( | const QDomElement & | itemElem, |
const QDomDocument & | doc | ||
) |
Reads parameter that are not subclass specific in document.
Usually called from readXML methods of subclasses
Definition at line 256 of file qgscomposeritem.cpp.
bool QgsComposerItem::_writeXML | ( | QDomElement & | itemElem, |
QDomDocument & | doc | ||
) | const |
Writes parameter that are not subclass specific in document.
Usually called from writeXML methods of subclasses
Definition at line 166 of file qgscomposeritem.cpp.
|
inlinevirtual |
Composite operations for item groups do nothing per default.
Reimplemented in QgsComposerItemGroup.
Definition at line 401 of file qgscomposeritem.h.
Returns angle of the line from p1 to p2 (clockwise, starting at N)
Definition at line 884 of file qgscomposeritem.cpp.
|
inline |
Gets the background color for this item.
Definition at line 350 of file qgscomposeritem.h.
void QgsComposerItem::beginCommand | ( | const QString & | commandText, |
QgsComposerMergeCommand::Context | c = QgsComposerMergeCommand::Unknown |
||
) |
Starts new composer undo command.
commandText | command title |
c | context for mergeable commands (unknown for non-mergeable commands |
Definition at line 476 of file qgscomposeritem.cpp.
|
inlinevirtual |
Reimplemented in QgsComposerFrame.
Definition at line 404 of file qgscomposeritem.h.
|
inline |
Returns the item's composition blending mode.
Definition at line 364 of file qgscomposeritem.h.
void QgsComposerItem::cancelCommand | ( | ) |
Definition at line 492 of file qgscomposeritem.cpp.
|
protected |
Calculates corner point after rotation and scaling.
Definition at line 1218 of file qgscomposeritem.cpp.
|
protected |
Calculates corner point after rotation and scaling.
Definition at line 1210 of file qgscomposeritem.cpp.
|
overridevirtual |
Creates an expression context relating to the item's current state.
The context includes scopes for global, project, composition, atlas and item properties.
Reimplemented from QgsComposerObject.
Reimplemented in QgsComposerMap, and QgsComposerFrame.
Definition at line 859 of file qgscomposeritem.cpp.
|
protected |
Definition at line 1349 of file qgscomposeritem.cpp.
|
protected |
Definition at line 1329 of file qgscomposeritem.cpp.
|
protected |
Definition at line 1339 of file qgscomposeritem.cpp.
|
virtual |
Get item display name.
This is the item's id if set, and if not, a user-friendly string identifying item type.
Reimplemented in QgsComposerMap, QgsComposerLegend, QgsComposerLabel, QgsComposerShape, QgsComposerPolygon, QgsComposerPolyline, and QgsComposerFrame.
Definition at line 1436 of file qgscomposeritem.cpp.
|
protected |
Draws arrowhead.
Definition at line 879 of file qgscomposeritem.cpp.
|
protectedvirtual |
Draw background.
Reimplemented in QgsComposerShape.
Definition at line 866 of file qgscomposeritem.cpp.
|
protectedvirtual |
Draw black frame around item.
Reimplemented in QgsComposerShape, and QgsComposerItemGroup.
Definition at line 539 of file qgscomposeritem.cpp.
|
protectedvirtual |
Draws additional graphics on selected items.
The base implementation has no effect.
Definition at line 500 of file qgscomposeritem.cpp.
void QgsComposerItem::drawText | ( | QPainter * | p, |
double | x, | ||
double | y, | ||
const QString & | text, | ||
const QFont & | font, | ||
const QColor & | c = QColor() |
||
) | const |
Draws Text.
Takes care about all the composer specific issues (calculation to pixel, scaling of font and painter to work around the Qt font bug)
Definition at line 962 of file qgscomposeritem.cpp.
void QgsComposerItem::drawText | ( | QPainter * | p, |
const QRectF & | rect, | ||
const QString & | text, | ||
const QFont & | font, | ||
Qt::AlignmentFlag | halignment = Qt::AlignLeft , |
||
Qt::AlignmentFlag | valignment = Qt::AlignTop , |
||
int | flags = Qt::TextWordWrap |
||
) | const |
Like the above, but with a rectangle for multiline text.
p | painter to use |
rect | rectangle to draw into |
text | text to draw |
font | font to use |
halignment | optional horizontal alignment |
valignment | optional vertical alignment |
flags | allows for passing Qt::TextFlags to control appearance of rendered text |
Definition at line 967 of file qgscomposeritem.cpp.
|
inline |
Returns whether effects (eg blend modes) are enabled for the item.
Definition at line 390 of file qgscomposeritem.h.
void QgsComposerItem::endCommand | ( | ) |
Finish current command and push it onto the undo stack.
Definition at line 484 of file qgscomposeritem.cpp.
|
inlinevirtual |
Reimplemented in QgsComposerFrame.
Definition at line 411 of file qgscomposeritem.h.
|
virtual |
Returns the estimated amount the item's frame bleeds outside the item's actual rectangle.
For instance, if the item has a 2mm frame outline, then 1mm of this frame is drawn outside the item's rect. In this case the return value will be 1.0
Reimplemented in QgsComposerShape.
Definition at line 460 of file qgscomposeritem.cpp.
|
protected |
Evaluates an item's bounding rect to consider data defined position and size of item and reference point.
newRect | target bouding rect for item |
resizeOnly | set to true if the item is only being resized. If true then the position of the returned rect will be adjusted to account for the item's position mode |
context | expression context for evaluating data defined expressions |
Definition at line 711 of file qgscomposeritem.cpp.
bool QgsComposerItem::excludeFromExports | ( | const QgsComposerObject::PropertyValueType | valueType = QgsComposerObject::EvaluatedValue | ) |
Returns whether the item should be excluded from composer exports and prints.
valueType | controls whether the returned value is the user specified vaule, or the current evaluated value (which may be affected by data driven settings). |
Definition at line 1494 of file qgscomposeritem.cpp.
double QgsComposerItem::fontAscentMillimeters | ( | const QFont & | font | ) | const |
Returns the font ascent in Millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE.
Definition at line 981 of file qgscomposeritem.cpp.
double QgsComposerItem::fontDescentMillimeters | ( | const QFont & | font | ) | const |
Returns the font descent in Millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE.
Definition at line 986 of file qgscomposeritem.cpp.
Returns the font height of a character in millimeters.
Definition at line 976 of file qgscomposeritem.cpp.
double QgsComposerItem::fontHeightMillimeters | ( | const QFont & | font | ) | const |
Returns the font height in Millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE.
Font height equals the font ascent+descent+1 (for baseline).
Definition at line 991 of file qgscomposeritem.cpp.
|
signal |
Emitted if the item's frame style changes.
|
inline |
Returns the join style used for drawing the item's frame.
Definition at line 299 of file qgscomposeritem.h.
|
inline |
Returns the frame's outline color.
Only used if hasFrame is true.
Definition at line 269 of file qgscomposeritem.h.
|
inline |
Returns the frame's outline width.
Only used if hasFrame is true.
Definition at line 289 of file qgscomposeritem.h.
|
protected |
Return horizontal align snap item.
Creates a new graphics line if 0
Definition at line 1305 of file qgscomposeritem.cpp.
|
inline |
Whether this item has a Background or not.
Definition at line 335 of file qgscomposeritem.h.
|
inline |
Whether this item has a frame or not.
Definition at line 240 of file qgscomposeritem.h.
|
protected |
Returns the zoom factor of the graphics view.
Definition at line 1006 of file qgscomposeritem.cpp.
|
inline |
Get item's id (which is not necessarly unique)
Definition at line 508 of file qgscomposeritem.h.
|
protected |
Calculates width and hight of the picture (in mm) such that it fits into the item frame with the given rotation.
Definition at line 1139 of file qgscomposeritem.cpp.
|
protected |
Calculates width and hight of the picture (in mm) such that it fits into the item frame with the given rotation.
Definition at line 1131 of file qgscomposeritem.cpp.
|
inline |
Returns whether this item is part of a group.
Definition at line 563 of file qgscomposeritem.h.
|
inlinevirtual |
Returns whether this item has been removed from the composition.
Items removed from the composition are not deleted so that they can be restored via an undo command.
Definition at line 131 of file qgscomposeritem.h.
double QgsComposerItem::itemRotation | ( | const QgsComposerObject::PropertyValueType | valueType = QgsComposerObject::EvaluatedValue | ) | const |
Returns the current rotation for the composer item.
valueType | controls whether the returned value is the user specified rotation, or the current evaluated rotation (which may be affected by data driven rotation settings). |
Definition at line 570 of file qgscomposeritem.cpp.
|
signal |
Is emitted on item rotation change.
|
protected |
Calculates the largest scaled version of originalRect which fits within boundsRect, when it is rotated by a specified amount.
originalRect | QRectF to be rotated and scaled |
boundsRect | QRectF specifying the bounds which the rotated and scaled rectangle must fit within |
rotation | the rotation in degrees to be applied to the rectangle |
Definition at line 1205 of file qgscomposeritem.cpp.
|
inline |
Returns item's last used position mode.
Definition at line 221 of file qgscomposeritem.h.
|
signal |
Emitted if the item's lock status changes.
|
protected |
Returns the size of the lock symbol depending on the composer zoom level and the item size.
Definition at line 1043 of file qgscomposeritem.cpp.
void QgsComposerItem::move | ( | double | dx, |
double | dy | ||
) |
Moves item in canvas coordinates.
Definition at line 575 of file qgscomposeritem.cpp.
|
inlinevirtual |
Move Content of item.
Does nothing per default (but implemented in composer map)
dx | move in x-direction (canvas coordinates) |
dy | move in y-direction(canvas coordinates) |
Reimplemented in QgsComposerMap.
Definition at line 154 of file qgscomposeritem.h.
|
inlinevirtual |
Get the number of layers that this item requires for exporting as layers.
Reimplemented in QgsComposerMap.
Definition at line 578 of file qgscomposeritem.h.
int QgsComposerItem::page | ( | ) | const |
Gets the page the item is currently on.
Definition at line 581 of file qgscomposeritem.cpp.
QPointF QgsComposerItem::pagePos | ( | ) | const |
Returns the item's position relative to its current page.
Definition at line 594 of file qgscomposeritem.cpp.
double QgsComposerItem::pixelFontSize | ( | double | pointSize | ) | const |
Calculates font size in mm from a font point size.
Definition at line 996 of file qgscomposeritem.cpp.
|
inline |
Returns whether position lock for mouse drags is enabled returns true if item is locked for mouse movement and resizing.
Definition at line 484 of file qgscomposeritem.h.
|
protected |
Returns the current (zoom level dependent) tolerance to decide if mouse position is close enough to the item border for resizing.
Definition at line 1025 of file qgscomposeritem.cpp.
|
virtual |
Returns the item's rectangular bounds, including any bleed caused by the item's frame.
The bounds are returned in the item's coordinate system (see Qt's QGraphicsItem docs for more details about QGraphicsItem coordinate systems). The results differ from Qt's rect() function, as rect() makes no allowances for the portion of outlines which are drawn outside of the item.
Definition at line 470 of file qgscomposeritem.cpp.
|
overridevirtualslot |
Refreshes a data defined property for the item by reevaluating the property's value and redrawing the item with this new value.
property | data defined property to refresh. If property is set to QgsComposerItem::AllProperties then all data defined properties for the item will be refreshed. |
context | expression context for evaluating data defined expressions |
Definition at line 1360 of file qgscomposeritem.cpp.
|
inlinevirtual |
Reimplemented in QgsComposerItemGroup.
Definition at line 402 of file qgscomposeritem.h.
|
overrideslot |
Definition at line 1355 of file qgscomposeritem.cpp.
|
protected |
Rotates a point / vector.
angle | rotation angle in degrees, counterclockwise |
x | in/out: x coordinate before / after the rotation |
y | in/out: y cooreinate before / after the rotation |
Definition at line 1300 of file qgscomposeritem.cpp.
|
inline |
Returns the rotation for the composer item.
Definition at line 499 of file qgscomposeritem.h.
Returns a font where size is in pixel and font size is upscaled with FONT_WORKAROUND_SCALE.
Definition at line 1001 of file qgscomposeritem.cpp.
|
inlinevirtual |
Is selected.
Definition at line 146 of file qgscomposeritem.h.
void QgsComposerItem::setBackgroundColor | ( | const QColor & | backgroundColor | ) |
Sets the background color for this item.
backgroundColor | new background color |
Definition at line 889 of file qgscomposeritem.cpp.
|
inline |
Set whether this item has a Background drawn around it or not.
drawBackground | draw Background |
Definition at line 343 of file qgscomposeritem.h.
void QgsComposerItem::setBlendMode | ( | const QPainter::CompositionMode | blendMode | ) |
Sets the item's composition blending mode.
blendMode | blending mode for item |
Definition at line 895 of file qgscomposeritem.cpp.
|
inlinevirtual |
Sets the current layer to draw for exporting.
layerIdx | can be set to -1 to draw all item layers, and must be less than numberExportLayers() |
Definition at line 585 of file qgscomposeritem.h.
void QgsComposerItem::setEffectsEnabled | ( | const bool | effectsEnabled | ) |
Sets whether effects (eg blend modes) are enabled for the item.
effectsEnabled | set to true to enable effects |
Definition at line 955 of file qgscomposeritem.cpp.
|
virtual |
Sets whether the item should be excluded from composer exports and prints.
exclude | set to true to exclude the item from exports |
Definition at line 1499 of file qgscomposeritem.cpp.
|
virtual |
Set whether this item has a frame drawn around it or not.
drawFrame | draw frame |
Reimplemented in QgsComposerLabel.
Definition at line 407 of file qgscomposeritem.cpp.
void QgsComposerItem::setFrameJoinStyle | ( | const Qt::PenJoinStyle | style | ) |
Sets join style used when drawing the item's frame.
style | Join style for outline frame |
Definition at line 445 of file qgscomposeritem.cpp.
|
virtual |
Sets frame outline color.
color | new color for outline frame |
Definition at line 419 of file qgscomposeritem.cpp.
|
virtual |
Sets frame outline width.
outlineWidth | new width for outline frame |
Reimplemented in QgsComposerMap, and QgsComposerLabel.
Definition at line 432 of file qgscomposeritem.cpp.
|
virtual |
Set item's id (which is not necessarly unique)
id | new id for item |
Definition at line 1411 of file qgscomposeritem.cpp.
void QgsComposerItem::setIsGroupMember | ( | const bool | isGroupMember | ) |
Sets whether this item is part of a group.
isGroupMember | set to true if item is in a group |
Definition at line 1430 of file qgscomposeritem.cpp.
|
inline |
Sets whether this item has been removed from the composition.
Items removed from the composition are not deleted so that they can be restored via an undo command.
removed | set to true if the item has been removed from the composition |
Definition at line 140 of file qgscomposeritem.h.
void QgsComposerItem::setItemPosition | ( | double | x, |
double | y, | ||
ItemPositionMode | itemPoint = UpperLeft , |
||
int | page = -1 |
||
) |
Moves the item to a new position (in canvas coordinates)
x | item position x (mm) |
y | item position y (mm) |
itemPoint | reference point which coincides with specified position |
page | if page > 0, y is interpreted as relative to the origin of the specified page, if page <= 0, y is in absolute canvas coordinates. a page number of 1 corresponds to the first page. |
Definition at line 615 of file qgscomposeritem.cpp.
void QgsComposerItem::setItemPosition | ( | double | x, |
double | y, | ||
double | width, | ||
double | height, | ||
ItemPositionMode | itemPoint = UpperLeft , |
||
bool | posIncludesFrame = false , |
||
int | page = -1 |
||
) |
Sets item position and width / height in one go.
x | item position x (mm) |
y | item position y (mm) |
width | item width (mm) |
height | item height (mm) |
itemPoint | reference point which coincides with specified position |
posIncludesFrame | set to true if the position and size arguments include the item's frame border |
page | if page > 0, y is interpreted as relative to the origin of the specified page, if page <= 0, y is in absolute canvas coordinates. a page number of 1 corresponds to the first page. |
Definition at line 622 of file qgscomposeritem.cpp.
|
virtualslot |
Sets the item rotation.
r | item rotation in degrees |
adjustPosition | set to true if item should be shifted so that rotation occurs around item center. If false, rotation occurs around item origin |
Definition at line 1065 of file qgscomposeritem.cpp.
void QgsComposerItem::setPositionLock | ( | const bool | lock | ) |
Locks / unlocks the item position for mouse drags.
lock | set to true to prevent item movement and resizing via the mouse |
Definition at line 552 of file qgscomposeritem.cpp.
|
virtualslot |
Sets the item rotation.
Reimplemented in QgsComposerMap.
Definition at line 1058 of file qgscomposeritem.cpp.
|
virtual |
Sets this items bound in scene coordinates such that 1 item size units corresponds to 1 scene size unit.
Reimplemented in QgsComposerScaleBar, QgsComposerAttributeTable, QgsComposerMap, QgsComposerPicture, QgsComposerShape, QgsPaperItem, QgsComposerArrow, QgsComposerFrame, and QgsComposerItemGroup.
Definition at line 684 of file qgscomposeritem.cpp.
|
virtual |
Set selected, selected item should be highlighted.
Definition at line 155 of file qgscomposeritem.cpp.
void QgsComposerItem::setTransparency | ( | const int | transparency | ) |
Sets the item's transparency.
transparency | integer between 0 (transparent) and 255 (opaque) |
Definition at line 922 of file qgscomposeritem.cpp.
|
virtual |
Sets visibility for item.
visible | set to true to show item, false to hide item |
Reimplemented in QgsComposerItemGroup.
Definition at line 1477 of file qgscomposeritem.cpp.
|
protected |
Returns whether the item should be drawn in the current context.
Definition at line 847 of file qgscomposeritem.cpp.
|
signal |
Emitted if the rectangle changes.
|
protected |
Calculates width / height of the bounding box of a rotated rectangle.
Definition at line 1263 of file qgscomposeritem.cpp.
|
protected |
Calculates width / height of the bounding box of a rotated rectangle.
Definition at line 1255 of file qgscomposeritem.cpp.
Returns the font width in millimeters (considers upscaling and downscaling with FONT_WORKAROUND_SCALE.
Definition at line 971 of file qgscomposeritem.cpp.
|
inline |
Returns the item's transparency.
Definition at line 376 of file qgscomposeritem.h.
|
inlineoverridevirtual |
Return correct graphics item type.
Reimplemented from QGraphicsRectItem.
Reimplemented in QgsComposerLegend, QgsComposerPicture, QgsComposerAttributeTable, QgsComposerScaleBar, QgsComposerPolygon, QgsComposerMap, QgsComposerPolyline, QgsComposerFrame, QgsComposerArrow, QgsComposerTable, QgsPaperItem, QgsComposerShape, QgsComposerLabel, QgsComposerTextTable, and QgsComposerItemGroup.
Definition at line 122 of file qgscomposeritem.h.
|
inlinevirtual |
Updates item, with the possibility to do custom update for subclasses.
Reimplemented in QgsComposerMap, and QgsComposerLegend.
Definition at line 502 of file qgscomposeritem.h.
void QgsComposerItem::updatePagePos | ( | double | newPageWidth, |
double | newPageHeight | ||
) |
Moves the item so that it retains its relative position on the page when the paper size changes.
newPageWidth | new width of the page in mm |
newPageHeight | new height of the page in mm |
Definition at line 602 of file qgscomposeritem.cpp.
|
inline |
Get item identification name.
Definition at line 522 of file qgscomposeritem.h.
|
protected |
Return vertical align snap item.
Creates a new graphics line if 0
Definition at line 1317 of file qgscomposeritem.cpp.
|
inlinevirtual |
Zoom content of item.
Does nothing per default (but implemented in composer map)
delta | value from wheel event that describes direction (positive /negative number) |
x | x-position of mouse cursor (in item coordinates) |
y | y-position of mouse cursor (in item coordinates) |
Reimplemented in QgsComposerMap.
Definition at line 162 of file qgscomposeritem.h.
|
inlinevirtual |
Zoom content of item.
Does nothing per default (but implemented in composer map)
factor | zoom factor, where > 1 results in a zoom in and < 1 results in a zoom out |
point | item point for zoom center |
mode | zoom mode |
Reimplemented in QgsComposerMap.
Definition at line 170 of file qgscomposeritem.h.
|
friend |
Definition at line 845 of file qgscomposeritem.h.
|
protected |
True if item background needs to be painted.
Definition at line 638 of file qgscomposeritem.h.
|
protected |
Background color.
Definition at line 640 of file qgscomposeritem.h.
|
protected |
Composition blend mode for item.
Definition at line 659 of file qgscomposeritem.h.
|
protected |
Rectangle used during move and resize actions.
Definition at line 631 of file qgscomposeritem.h.
|
protected |
The layer that needs to be exported.
Definition at line 684 of file qgscomposeritem.h.
|
protected |
Definition at line 624 of file qgscomposeritem.h.
|
protected |
Definition at line 661 of file qgscomposeritem.h.
|
protected |
Definition at line 660 of file qgscomposeritem.h.
|
protected |
Temporary evaluated item exclusion.
Data defined properties may mean this value differs from mExcludeFromExports.
Definition at line 672 of file qgscomposeritem.h.
|
protected |
Temporary evaluated item rotation in degrees, clockwise.
Data defined rotation may mean this value differs from mItemRotation.
Definition at line 656 of file qgscomposeritem.h.
|
protected |
Whether item should be excluded in exports.
Definition at line 667 of file qgscomposeritem.h.
|
protected |
True if item fram needs to be painted.
Definition at line 636 of file qgscomposeritem.h.
|
protected |
Frame join style.
Definition at line 642 of file qgscomposeritem.h.
|
protected |
Definition at line 632 of file qgscomposeritem.h.
|
protected |
Whether or not this item is part of a group.
Definition at line 678 of file qgscomposeritem.h.
|
protected |
True if item position and size cannot be changed with mouse move.
Definition at line 646 of file qgscomposeritem.h.
|
protected |
Item rotation in degrees, clockwise.
Definition at line 652 of file qgscomposeritem.h.
|
protected |
Position of the last mouse move event (in scene coordinates)
Definition at line 628 of file qgscomposeritem.h.
|
protected |
The item's position mode.
Definition at line 675 of file qgscomposeritem.h.
|
mutableprotected |
Backup to restore item appearance if no view scale factor is available.
Definition at line 649 of file qgscomposeritem.h.
|
protected |
Start point of the last mouse move action (in scene coordinates)
Definition at line 626 of file qgscomposeritem.h.
|
protected |
True if item has been removed from the composition.
Definition at line 622 of file qgscomposeritem.h.
|
protected |
Item transparency.
Definition at line 664 of file qgscomposeritem.h.
|
protected |
Definition at line 633 of file qgscomposeritem.h.