| 
    QGIS API Documentation
    3.26.3-Buenos Aires (65e4edfdad)
    
   | 
 
 
 
 
Go to the documentation of this file.
   30   return QStringLiteral( 
"hollow" );
 
   35   return QObject::tr( 
"Hollow" );
 
   68   QPainter *painter = context.
painter();
 
   79   std::unique_ptr< QgsLineSymbol > lineSymbol( settings.
lineSymbol()->
clone() );
 
   80   lineSymbol->startRender( context );
 
   82   std::unique_ptr< QgsFillSymbol > fillSymbol1( settings.
fillSymbol()->
clone() );
 
   83   fillSymbol1->startRender( context );
 
   86   fillSymbol2->startRender( context );
 
   88   painter->setPen( Qt::NoPen );
 
   89   painter->setBrush( Qt::NoBrush );
 
   94   const QList<double> positions = 
segmentPositions( context, scaleContext, settings );
 
   95   const QList<double> widths = 
segmentWidths( scaleContext, settings );
 
  101   for ( 
int i = 0; i < positions.size(); ++i )
 
  105       currentSymbol = fillSymbol1.get();
 
  109       currentSymbol = fillSymbol2.get();
 
  117     if ( i == positions.size() - 1 )
 
  118       maxX = thisX + thisWidth;
 
  120     const QRectF segmentRect( thisX, barTopPosition, thisWidth, barHeight );
 
  122                                   << segmentRect.topLeft()
 
  123                                   << segmentRect.topRight()
 
  124                                   << segmentRect.bottomRight()
 
  125                                   << segmentRect.bottomLeft()
 
  126                                   << segmentRect.topLeft(), 
nullptr, 
nullptr, context );
 
  127     useColor = !useColor;
 
  132   for ( 
int layer = 0; layer < lineSymbol->symbolLayerCount(); ++layer )
 
  135     bool drawLine = 
false;
 
  136     for ( 
int i = 0; i < positions.size(); ++i )
 
  138       drawLine = !drawLine;
 
  144       lineSymbol->renderPolyline( QPolygonF()
 
  145                                   << QPointF( lineX, barTopPosition + barHeight / 2.0 )
 
  146                                   << QPointF( lineX + lineLength, barTopPosition + barHeight / 2.0 ),
 
  147                                   nullptr, context, layer );
 
  151     for ( 
int i = 1; i < positions.size(); ++i )
 
  154       lineSymbol->renderPolyline( QPolygonF()
 
  155                                   << QPointF( lineX, barTopPosition )
 
  156                                   << QPointF( lineX, barTopPosition + barHeight ),
 
  157                                   nullptr, context, layer );
 
  161     lineSymbol->renderPolyline( QPolygonF()
 
  162                                 << QPointF( minX, barTopPosition )
 
  163                                 << QPointF( maxX, barTopPosition )
 
  164                                 << QPointF( maxX, barTopPosition + barHeight )
 
  165                                 << QPointF( minX, barTopPosition + barHeight )
 
  166                                 << QPointF( minX, barTopPosition ),
 
  167                                 nullptr, context, layer );
 
  170   lineSymbol->stopRender( context );
 
  171   fillSymbol1->stopRender( context );
 
  172   fillSymbol2->stopRender( context );
 
  182   std::unique_ptr< QgsFillSymbol > fillSymbol = std::make_unique< QgsFillSymbol >();
 
  183   std::unique_ptr< QgsSimpleFillSymbolLayer > fillSymbolLayer = std::make_unique< QgsSimpleFillSymbolLayer >();
 
  184   fillSymbolLayer->setColor( QColor( 0, 0, 0 ) );
 
  185   fillSymbolLayer->setBrushStyle( Qt::NoBrush );
 
  186   fillSymbolLayer->setStrokeStyle( Qt::NoPen );
 
  187   fillSymbol->changeSymbolLayer( 0, fillSymbolLayer->clone() );
 
  190   fillSymbol = std::make_unique< QgsFillSymbol >();
 
  191   fillSymbolLayer->setColor( QColor( 255, 255, 255 ) );
 
  192   fillSymbol->changeSymbolLayer( 0, fillSymbolLayer.release() );
 
  
double height() const
Returns the scalebar height (in millimeters).
 
QgsLineSymbol * lineSymbol() const
Returns the line symbol used to render the scalebar (only used for some scalebar types).
 
void setPainterFlagsUsingContext(QPainter *painter=nullptr) const
Sets relevant flags on a destination painter, using the flags and settings currently defined for the ...
 
Contains parameters regarding scalebar calculations.
 
@ FlagUsesUnitLabel
Renderer uses the QgsScaleBarSettings::unitLabel() setting.
 
QString id() const override
Returns the unique ID for this renderer.
 
Flags flags() const override
Returns the scalebar rendering flags, which dictates the renderer's behavior.
 
QList< double > segmentWidths(const QgsScaleBarRenderer::ScaleBarContext &scaleContext, const QgsScaleBarSettings &settings) const
Returns a list of widths of each segment of the scalebar.
 
QgsLineSymbol * clone() const override
Returns a deep copy of this symbol.
 
@ FlagUsesFillSymbol
Renderer utilizes the scalebar fill symbol (see QgsScaleBarSettings::fillSymbol() )
 
@ FlagUsesAlternateFillSymbol
Renderer utilizes the alternate scalebar fill symbol (see QgsScaleBarSettings::alternateFillSymbol() ...
 
static QFontMetricsF fontMetrics(QgsRenderContext &context, const QgsTextFormat &format, double scaleFactor=1.0)
Returns the font metrics for the given text format, when rendered in the specified render context.
 
Contains information about the context of a rendering operation.
 
QgsFillSymbol * fillSymbol() const
Returns the primary fill symbol used to render the scalebar (only used for some scalebar types).
 
@ RenderMillimeters
Millimeters.
 
@ FlagUsesLabelHorizontalPlacement
Renderer uses the QgsScaleBarSettings::labelHorizontalPlacement() setting.
 
int sortKey() const override
Returns a sorting key value, where renderers with a lower sort key will be shown earlier in lists.
 
QgsHollowScaleBarRenderer * clone() const override
Returns a clone of the renderer.
 
QgsHollowScaleBarRenderer()=default
Constructor for QgsHollowScaleBarRenderer.
 
QString visibleName() const override
Returns the user friendly, translated name for the renderer.
 
double labelBarSpace() const
Returns the spacing (in millimeters) between labels and the scalebar.
 
@ FlagUsesLabelVerticalPlacement
Renderer uses the QgsScaleBarSettings::labelVerticalPlacement() setting.
 
double boxContentSpace() const
Returns the spacing (margin) between the scalebar box and content in millimeters.
 
LabelVerticalPlacement labelVerticalPlacement() const
Returns the vertical placement of text labels.
 
QgsTextFormat & textFormat()
Returns the text format used for drawing text in the scalebar.
 
@ FlagUsesLineSymbol
Renderer utilizes the scalebar line symbol (see QgsScaleBarSettings::lineSymbol() )
 
The QgsScaleBarSettings class stores the appearance and layout settings for scalebar drawing with Qgs...
 
@ FlagRespectsMapUnitsPerScaleBarUnit
Renderer respects the QgsScaleBarSettings::mapUnitsPerScaleBarUnit() setting.
 
void draw(QgsRenderContext &context, const QgsScaleBarSettings &settings, const QgsScaleBarRenderer::ScaleBarContext &scaleContext) const override
Draws the scalebar using the specified settings and scaleContext to a destination render context.
 
Q_DECL_DEPRECATED double firstLabelXOffset(const QgsScaleBarSettings &settings) const
Returns the x-offset (in millimeters) used for the first label in the scalebar.
 
void renderPolygon(const QPolygonF &points, const QVector< QPolygonF > *rings, const QgsFeature *f, QgsRenderContext &context, int layer=-1, bool selected=false)
Renders the symbol using the given render context.
 
double convertToPainterUnits(double size, QgsUnitTypes::RenderUnit unit, const QgsMapUnitScale &scale=QgsMapUnitScale(), Qgis::RenderSubcomponentProperty property=Qgis::RenderSubcomponentProperty::Generic) const
Converts a size from the specified units to painter units (pixels).
 
@ LabelAboveSegment
Labels are drawn above the scalebar.
 
bool applyDefaultSettings(QgsScaleBarSettings &settings) const override
Applies any default settings relating to the scalebar to the passed settings object.
 
void drawDefaultLabels(QgsRenderContext &context, const QgsScaleBarSettings &settings, const QgsScaleBarRenderer::ScaleBarContext &scaleContext) const
Draws default scalebar labels using the specified settings and scaleContext to a destination render c...
 
@ FlagRespectsUnits
Renderer respects the QgsScaleBarSettings::units() setting.
 
void setFillSymbol(QgsFillSymbol *symbol)
Sets the primary fill symbol used to render the scalebar (only used for some scalebar types).
 
QgsFillSymbol * clone() const override
Returns a deep copy of this symbol.
 
A fill symbol type, for rendering Polygon and MultiPolygon geometries.
 
@ FlagUsesLabelBarSpace
Renderer uses the QgsScaleBarSettings::labelBarSpace() setting.
 
@ FlagUsesSegments
Renderer uses the scalebar segments.
 
QPainter * painter()
Returns the destination QPainter for the render operation.
 
void setAlternateFillSymbol(QgsFillSymbol *symbol)
Sets the secondary fill symbol used to render the scalebar (only used for some scalebar types).
 
QgsFillSymbol * alternateFillSymbol() const
Returns the secondary fill symbol used to render the scalebar (only used for some scalebar types).
 
Scalebar style that draws a single box with alternating color for the segments, with horizontal lines...
 
Q_DECL_DEPRECATED QList< double > segmentPositions(const QgsScaleBarRenderer::ScaleBarContext &scaleContext, const QgsScaleBarSettings &settings) const
Returns a list of positions for each segment within the scalebar.