QGIS API Documentation 3.34.0-Prizren (ffbdd678812)
Loading...
Searching...
No Matches
Signals | Public Member Functions | List of all members
QgsLayoutItemMapItemClipPathSettings Class Reference

Contains settings relating to clipping a layout map by another layout item. More...

#include <qgslayoutitemmap.h>

Inheritance diagram for QgsLayoutItemMapItemClipPathSettings:
Inheritance graph
[legend]

Signals

void changed ()
 Emitted when the item clipping settings are changed.
 

Public Member Functions

 QgsLayoutItemMapItemClipPathSettings (QgsLayoutItemMap *map=nullptr)
 Constructor for QgsLayoutItemMapItemClipPathSettings, with the specified map parent.
 
QgsGeometry clipPathInMapItemCoordinates () const
 Returns the clipping path geometry, in the map item's coordinate space.
 
QgsGeometry clippedMapExtent () const
 Returns the geometry to use for clipping the parent map, in the map item's CRS.
 
bool enabled () const
 Returns true if the map content should be clipped to the associated item.
 
QgsMapClippingRegion::FeatureClippingType featureClippingType () const
 Returns the feature clipping type to apply when clipping to the associated item.
 
void finalizeRestoreFromXml ()
 To be called after all pending items have been restored from XML.
 
bool forceLabelsInsideClipPath () const
 Returns true if labels should only be placed inside the clip path geometry.
 
bool isActive () const
 Returns true if the item clipping is enabled and set to a valid source item.
 
bool readXml (const QDomElement &element, const QDomDocument &doc, const QgsReadWriteContext &context)
 Sets the setting's state from a DOM document, where element is the DOM node corresponding to a 'LayoutMap' tag.
 
void setEnabled (bool enabled)
 Sets whether the map content should be clipped to the associated item.
 
void setFeatureClippingType (QgsMapClippingRegion::FeatureClippingType type)
 Sets the feature clipping type to apply when clipping to the associated item.
 
void setForceLabelsInsideClipPath (bool forceInside)
 Sets whether labels should only be placed inside the clip path geometry.
 
void setSourceItem (QgsLayoutItem *item)
 Sets the source item which will provide the clipping path for the map.
 
QgsLayoutItemsourceItem ()
 Returns the source item which will provide the clipping path for the map, or nullptr if no item is set.
 
QgsMapClippingRegion toMapClippingRegion () const
 Returns the clip path as a map clipping region.
 
bool writeXml (QDomElement &element, QDomDocument &document, const QgsReadWriteContext &context) const
 Stores settings in a DOM element, where element is the DOM element corresponding to a 'LayoutMap' tag.
 

Detailed Description

Contains settings relating to clipping a layout map by another layout item.

Since
QGIS 3.16

Definition at line 170 of file qgslayoutitemmap.h.

Constructor & Destructor Documentation

◆ QgsLayoutItemMapItemClipPathSettings()

QgsLayoutItemMapItemClipPathSettings::QgsLayoutItemMapItemClipPathSettings ( QgsLayoutItemMap map = nullptr)

Constructor for QgsLayoutItemMapItemClipPathSettings, with the specified map parent.

Definition at line 3144 of file qgslayoutitemmap.cpp.

Member Function Documentation

◆ changed

void QgsLayoutItemMapItemClipPathSettings::changed ( )
signal

Emitted when the item clipping settings are changed.

◆ clipPathInMapItemCoordinates()

QgsGeometry QgsLayoutItemMapItemClipPathSettings::clipPathInMapItemCoordinates ( ) const

Returns the clipping path geometry, in the map item's coordinate space.

Warning
The return path is not in geographic coordinates, rather the map layout item's QGraphicsItem coordinate space. Use clippedMapExtent() to retrieve the clip path in the map's CRS.
See also
clippedMapExtent()

Definition at line 3186 of file qgslayoutitemmap.cpp.

◆ clippedMapExtent()

QgsGeometry QgsLayoutItemMapItemClipPathSettings::clippedMapExtent ( ) const

Returns the geometry to use for clipping the parent map, in the map item's CRS.

See also
clipPathInMapItemCoordinates()

Definition at line 3175 of file qgslayoutitemmap.cpp.

◆ enabled()

bool QgsLayoutItemMapItemClipPathSettings::enabled ( ) const

Returns true if the map content should be clipped to the associated item.

See also
setEnabled()

Definition at line 3155 of file qgslayoutitemmap.cpp.

◆ featureClippingType()

QgsMapClippingRegion::FeatureClippingType QgsLayoutItemMapItemClipPathSettings::featureClippingType ( ) const

Returns the feature clipping type to apply when clipping to the associated item.

See also
setFeatureClippingType()

Definition at line 3246 of file qgslayoutitemmap.cpp.

◆ finalizeRestoreFromXml()

void QgsLayoutItemMapItemClipPathSettings::finalizeRestoreFromXml ( )

To be called after all pending items have been restored from XML.

See also
readXml()

Definition at line 3301 of file qgslayoutitemmap.cpp.

◆ forceLabelsInsideClipPath()

bool QgsLayoutItemMapItemClipPathSettings::forceLabelsInsideClipPath ( ) const

Returns true if labels should only be placed inside the clip path geometry.

See also
setForceLabelsInsideClipPath()

Definition at line 3260 of file qgslayoutitemmap.cpp.

◆ isActive()

bool QgsLayoutItemMapItemClipPathSettings::isActive ( ) const

Returns true if the item clipping is enabled and set to a valid source item.

See also
enabled()
sourceItem()

Definition at line 3150 of file qgslayoutitemmap.cpp.

◆ readXml()

bool QgsLayoutItemMapItemClipPathSettings::readXml ( const QDomElement &  element,
const QDomDocument &  doc,
const QgsReadWriteContext context 
)

Sets the setting's state from a DOM document, where element is the DOM node corresponding to a 'LayoutMap' tag.

See also
writeXml()
finalizeRestoreFromXml()

Definition at line 3289 of file qgslayoutitemmap.cpp.

◆ setEnabled()

void QgsLayoutItemMapItemClipPathSettings::setEnabled ( bool  enabled)

Sets whether the map content should be clipped to the associated item.

See also
enabled()

Definition at line 3160 of file qgslayoutitemmap.cpp.

◆ setFeatureClippingType()

void QgsLayoutItemMapItemClipPathSettings::setFeatureClippingType ( QgsMapClippingRegion::FeatureClippingType  type)

Sets the feature clipping type to apply when clipping to the associated item.

See also
featureClippingType()

Definition at line 3251 of file qgslayoutitemmap.cpp.

◆ setForceLabelsInsideClipPath()

void QgsLayoutItemMapItemClipPathSettings::setForceLabelsInsideClipPath ( bool  forceInside)

Sets whether labels should only be placed inside the clip path geometry.

See also
forceLabelsInsideClipPath()

Definition at line 3265 of file qgslayoutitemmap.cpp.

◆ setSourceItem()

void QgsLayoutItemMapItemClipPathSettings::setSourceItem ( QgsLayoutItem item)

Sets the source item which will provide the clipping path for the map.

The specified item must return the QgsLayoutItem::FlagProvidesClipPath flag.

See also
sourceItem()

Definition at line 3204 of file qgslayoutitemmap.cpp.

◆ sourceItem()

QgsLayoutItem * QgsLayoutItemMapItemClipPathSettings::sourceItem ( )

Returns the source item which will provide the clipping path for the map, or nullptr if no item is set.

See also
setSourceItem()

Definition at line 3241 of file qgslayoutitemmap.cpp.

◆ toMapClippingRegion()

QgsMapClippingRegion QgsLayoutItemMapItemClipPathSettings::toMapClippingRegion ( ) const

Returns the clip path as a map clipping region.

Definition at line 3197 of file qgslayoutitemmap.cpp.

◆ writeXml()

bool QgsLayoutItemMapItemClipPathSettings::writeXml ( QDomElement &  element,
QDomDocument &  document,
const QgsReadWriteContext context 
) const

Stores settings in a DOM element, where element is the DOM element corresponding to a 'LayoutMap' tag.

See also
readXml()

Definition at line 3274 of file qgslayoutitemmap.cpp.


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