mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-27 00:33:48 -05:00
a57080cc71
If negative margins are set for a label, the label contents will begin outside the bounds of the label. This is desirable for aligning label items with other items while allowing for optical margin alignment for the label type.
148 lines
4.7 KiB
Plaintext
148 lines
4.7 KiB
Plaintext
/** \ingroup MapComposer
|
|
* A label that can be placed onto a map composition.
|
|
*/
|
|
class QgsComposerLabel : QgsComposerItem
|
|
{
|
|
%TypeHeaderCode
|
|
#include "qgscomposerlabel.h"
|
|
%End
|
|
public:
|
|
QgsComposerLabel( QgsComposition *composition /TransferThis/);
|
|
~QgsComposerLabel();
|
|
|
|
/** return correct graphics item type. Added in v1.7 */
|
|
virtual int type() const;
|
|
|
|
/** \brief Reimplementation of QCanvasItem::paint*/
|
|
void paint( QPainter* painter, const QStyleOptionGraphicsItem* itemStyle, QWidget* pWidget );
|
|
|
|
/**resizes the widget such that the text fits to the item. Keeps top left point*/
|
|
void adjustSizeToText();
|
|
|
|
QString text();
|
|
void setText( const QString& text );
|
|
|
|
int htmlState();
|
|
void setHtmlState( int state );
|
|
|
|
/**Returns the text as it appears on screen (with replaced data field)
|
|
@note this function was added in version 1.2*/
|
|
QString displayText() const;
|
|
|
|
/** Sets the current feature, the current layer and a list of local variable substitutions for evaluating expressions */
|
|
void setExpressionContext( QgsFeature* feature, QgsVectorLayer* layer, QMap<QString, QVariant> substitutions = QMap<QString, QVariant>() );
|
|
|
|
QFont font() const;
|
|
void setFont( const QFont& f );
|
|
/** Accessor for the vertical alignment of the label
|
|
* @returns Qt::AlignmentFlag
|
|
*/
|
|
Qt::AlignmentFlag vAlign() const;
|
|
/** Accessor for the horizontal alignment of the label
|
|
* @returns Qt::AlignmentFlag
|
|
*/
|
|
Qt::AlignmentFlag hAlign() const;
|
|
/** Mutator for the horizontal alignment of the label
|
|
* @param a alignment
|
|
* @returns void
|
|
*/
|
|
void setHAlign( Qt::AlignmentFlag a );
|
|
/** Mutator for the vertical alignment of the label
|
|
* @param a alignment
|
|
* @returns void
|
|
*/
|
|
void setVAlign( Qt::AlignmentFlag a );
|
|
|
|
/**Returns the margin between the edge of the frame and the label contents
|
|
* @returns margin in mm
|
|
* @deprecated use marginX and marginY instead
|
|
*/
|
|
double margin() /Deprecated/;
|
|
|
|
/**Returns the horizontal margin between the edge of the frame and the label
|
|
* contents.
|
|
* @returns horizontal margin in mm
|
|
* @note added in QGIS 2.7
|
|
*/
|
|
double marginX() const;
|
|
|
|
/**Returns the vertical margin between the edge of the frame and the label
|
|
* contents.
|
|
* @returns vertical margin in mm
|
|
* @note added in QGIS 2.7
|
|
*/
|
|
double marginY() const;
|
|
|
|
/**Sets the margin between the edge of the frame and the label contents.
|
|
* This method sets both the horizontal and vertical margins to the same
|
|
* value. The margins can be individually controlled using the setMarginX
|
|
* and setMarginY methods.
|
|
* @param m margin in mm
|
|
* @see setMarginX
|
|
* @see setMarginY
|
|
*/
|
|
void setMargin( const double m );
|
|
|
|
/**Sets the horizontal margin between the edge of the frame and the label
|
|
* contents.
|
|
* @param margin horizontal margin in mm
|
|
* @see setMargin
|
|
* @see setMarginY
|
|
* @note added in QGIS 2.7
|
|
*/
|
|
void setMarginX( const double margin );
|
|
|
|
/**Sets the vertical margin between the edge of the frame and the label
|
|
* contents.
|
|
* @param margin vertical margin in mm
|
|
* @see setMargin
|
|
* @see setMarginX
|
|
* @note added in QGIS 2.7
|
|
*/
|
|
void setMarginY( const double margin );
|
|
|
|
/**Sets text color
|
|
@note: this function was added in version 1.4*/
|
|
void setFontColor( const QColor& c );
|
|
/**Get font color
|
|
@note: this function was added in version 1.4*/
|
|
QColor fontColor() const;
|
|
|
|
/** stores state in Dom element
|
|
* @param elem is Dom element corresponding to 'Composer' tag
|
|
* @param doc document
|
|
*/
|
|
bool writeXML( QDomElement& elem, QDomDocument & doc ) const;
|
|
|
|
/** sets state from Dom document
|
|
* @param itemElem is Dom element corresponding to 'ComposerLabel' tag
|
|
* @param doc document
|
|
*/
|
|
bool readXML( const QDomElement& itemElem, const QDomDocument& doc );
|
|
|
|
//Overriden to contain part of label's text
|
|
virtual QString displayName() const;
|
|
|
|
/**In case of negative margins, the bounding rect may be larger than the
|
|
* label's frame
|
|
*/
|
|
QRectF boundingRect() const;
|
|
|
|
/**Reimplemented to call prepareGeometryChange after toggling frame
|
|
*/
|
|
virtual void setFrameEnabled( const bool drawFrame );
|
|
|
|
/**Reimplemented to call prepareGeometryChange after changing outline width
|
|
*/
|
|
virtual void setFrameOutlineWidth( const double outlineWidth );
|
|
|
|
public slots:
|
|
/* Sets rotation for the label
|
|
* @deprecated Use setItemRotation( double rotation ) instead
|
|
*/
|
|
virtual void setRotation( double r );
|
|
|
|
/* Sets rotation for the label */
|
|
virtual void setItemRotation( double r );
|
|
};
|