QGIS API Documentation 3.28.0-Firenze (ed3ad0430f)
Signals | Public Member Functions | List of all members
QgsLayoutViewToolAddItem Class Reference

Layout view tool for adding items to a layout. More...

#include <qgslayoutviewtooladditem.h>

Inheritance diagram for QgsLayoutViewToolAddItem:
Inheritance graph
[legend]

Signals

void createdItem ()
 Emitted when an item has been created using the tool. More...
 
- Signals inherited from QgsLayoutViewTool
void activated ()
 Emitted when the tool is activated. More...
 
void deactivated ()
 Emitted when the tool is deactivated. More...
 
void itemFocused (QgsLayoutItem *item)
 Emitted when an item is "focused" by the tool, i.e. More...
 

Public Member Functions

 QgsLayoutViewToolAddItem (QgsLayoutView *view)
 Constructs a QgsLayoutViewToolAddItem for the given layout view. More...
 
void activate () override
 Called when tool is set as the currently active layout tool. More...
 
QVariantMap customProperties () const
 Returns any custom properties set for the tool. More...
 
void deactivate () override
 Called when tool is deactivated. More...
 
int itemMetadataId () const
 Returns the item metadata id for items created by the tool. More...
 
void layoutMoveEvent (QgsLayoutViewMouseEvent *event) override
 Mouse move event for overriding. More...
 
void layoutPressEvent (QgsLayoutViewMouseEvent *event) override
 Mouse press event for overriding. More...
 
void layoutReleaseEvent (QgsLayoutViewMouseEvent *event) override
 Mouse release event for overriding. More...
 
void setCustomProperties (const QVariantMap &properties)
 Sets custom properties for the tool. More...
 
void setItemMetadataId (int metadataId)
 Sets the item metadata metadataId for items created by the tool. More...
 
- Public Member Functions inherited from QgsLayoutViewTool
 ~QgsLayoutViewTool () override
 
QAction * action ()
 Returns the action associated with the tool or nullptr if no action is associated. More...
 
virtual void activate ()
 Called when tool is set as the currently active layout tool. More...
 
virtual void deactivate ()
 Called when tool is deactivated. More...
 
QgsLayoutViewTool::Flags flags () const
 Returns the current combination of flags set for the tool. More...
 
virtual QList< QgsLayoutItem * > ignoredSnapItems () const
 Returns a list of items which should be ignored while snapping events for this tool. More...
 
virtual void keyPressEvent (QKeyEvent *event)
 Key press event for overriding. More...
 
virtual void keyReleaseEvent (QKeyEvent *event)
 Key release event for overriding. More...
 
QgsLayoutlayout () const
 Returns the layout associated with the tool. More...
 
virtual void layoutDoubleClickEvent (QgsLayoutViewMouseEvent *event)
 Mouse double-click event for overriding. More...
 
virtual void layoutMoveEvent (QgsLayoutViewMouseEvent *event)
 Mouse move event for overriding. More...
 
virtual void layoutPressEvent (QgsLayoutViewMouseEvent *event)
 Mouse press event for overriding. More...
 
virtual void layoutReleaseEvent (QgsLayoutViewMouseEvent *event)
 Mouse release event for overriding. More...
 
void setAction (QAction *action)
 Associates an action with this tool. More...
 
void setCursor (const QCursor &cursor)
 Sets a user defined cursor for use when the tool is active. More...
 
QString toolName () const
 Returns a user-visible, translated name for the tool. More...
 
QgsLayoutViewview () const
 Returns the view associated with the tool. More...
 
virtual void wheelEvent (QWheelEvent *event)
 Mouse wheel event for overriding. More...
 

Additional Inherited Members

- Public Types inherited from QgsLayoutViewTool
enum  Flag { FlagSnaps = 1 << 1 }
 Flags for controlling how a tool behaves. More...
 
- Protected Member Functions inherited from QgsLayoutViewTool
 QgsLayoutViewTool (QgsLayoutView *view, const QString &name)
 Constructor for QgsLayoutViewTool, taking a layout view and tool name as parameters. More...
 
bool isClickAndDrag (QPoint startViewPoint, QPoint endViewPoint) const
 Returns true if a mouse press/release operation which started at startViewPoint and ended at endViewPoint should be considered a "click and drag". More...
 
void setFlags (QgsLayoutViewTool::Flags flags)
 Sets the combination of flags that will be used for the tool. More...
 

Detailed Description

Layout view tool for adding items to a layout.

Since
QGIS 3.0

Definition at line 30 of file qgslayoutviewtooladditem.h.

Constructor & Destructor Documentation

◆ QgsLayoutViewToolAddItem()

QgsLayoutViewToolAddItem::QgsLayoutViewToolAddItem ( QgsLayoutView view)

Constructs a QgsLayoutViewToolAddItem for the given layout view.

Definition at line 34 of file qgslayoutviewtooladditem.cpp.

Member Function Documentation

◆ activate()

void QgsLayoutViewToolAddItem::activate ( )
overridevirtual

Called when tool is set as the currently active layout tool.

Overridden implementations must take care to call the base class implementation.

Reimplemented from QgsLayoutViewTool.

Definition at line 161 of file qgslayoutviewtooladditem.cpp.

◆ createdItem

void QgsLayoutViewToolAddItem::createdItem ( )
signal

Emitted when an item has been created using the tool.

◆ customProperties()

QVariantMap QgsLayoutViewToolAddItem::customProperties ( ) const

Returns any custom properties set for the tool.

See also
setCustomProperties()
Since
QGIS 3.18

Definition at line 179 of file qgslayoutviewtooladditem.cpp.

◆ deactivate()

void QgsLayoutViewToolAddItem::deactivate ( )
overridevirtual

Called when tool is deactivated.

Overridden implementations must take care to call the base class implementation.

Reimplemented from QgsLayoutViewTool.

Definition at line 167 of file qgslayoutviewtooladditem.cpp.

◆ itemMetadataId()

int QgsLayoutViewToolAddItem::itemMetadataId ( ) const

Returns the item metadata id for items created by the tool.

See also
setItemMetadataId()

Definition at line 189 of file qgslayoutviewtooladditem.cpp.

◆ layoutMoveEvent()

void QgsLayoutViewToolAddItem::layoutMoveEvent ( QgsLayoutViewMouseEvent event)
overridevirtual

Mouse move event for overriding.

Default implementation does nothing.

Reimplemented from QgsLayoutViewTool.

Definition at line 68 of file qgslayoutviewtooladditem.cpp.

◆ layoutPressEvent()

void QgsLayoutViewToolAddItem::layoutPressEvent ( QgsLayoutViewMouseEvent event)
overridevirtual

Mouse press event for overriding.

Default implementation does nothing. Note that subclasses must ensure that they correctly handle cases when a layoutPressEvent is called without a corresponding layoutReleaseEvent (e.g. due to tool being changed mid way through a press-release operation).

Reimplemented from QgsLayoutViewTool.

Definition at line 46 of file qgslayoutviewtooladditem.cpp.

◆ layoutReleaseEvent()

void QgsLayoutViewToolAddItem::layoutReleaseEvent ( QgsLayoutViewMouseEvent event)
overridevirtual

Mouse release event for overriding.

Default implementation does nothing. Note that subclasses must ensure that they correctly handle cases when a layoutPressEvent is called without a corresponding layoutReleaseEvent (e.g. due to tool being changed mid way through a press-release operation).

Reimplemented from QgsLayoutViewTool.

Definition at line 80 of file qgslayoutviewtooladditem.cpp.

◆ setCustomProperties()

void QgsLayoutViewToolAddItem::setCustomProperties ( const QVariantMap &  properties)

Sets custom properties for the tool.

These properties are transient, and are cleared whenever the tool is activated. Callers must ensure that the properties are set only after the tool is activated.

See also
customProperties()
Since
QGIS 3.18

Definition at line 184 of file qgslayoutviewtooladditem.cpp.

◆ setItemMetadataId()

void QgsLayoutViewToolAddItem::setItemMetadataId ( int  metadataId)

Sets the item metadata metadataId for items created by the tool.

The metadataId associates the current tool behavior with a metadata entry from QgsLayoutItemGuiRegistry.

See also
itemMetadataId()

Definition at line 41 of file qgslayoutviewtooladditem.cpp.


The documentation for this class was generated from the following files: