qwt_text.h

/******************************************************************************
 * Qwt Widget Library
 * Copyright (C) 1997   Josef Wilgen
 * Copyright (C) 2002   Uwe Rathmann
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the Qwt License, Version 1.0
 *
 * Modified by ChenZongYan in 2024 <czy.t@163.com>
 *   Summary of major modifications (see ChangeLog.md for full history):
 *   1. CMake build system & C++11 throughout.
 *   2. Core panner/ zoomer refactored:
 *        - QwtPanner → QwtCachePanner (pixmap-cache version)
 *        - New real-time QwtPlotPanner derived from QwtPicker.
 *   3. Zoomer supports multi-axis.
 *   4. Parasite-plot framework:
 *        - QwtFigure, QwtPlotParasiteLayout, QwtPlotTransparentCanvas,
 *        - QwtPlotScaleEventDispatcher, built-in pan/zoom on axis.
 *   5. New picker: QwtPlotSeriesDataPicker (works with date axis).
 *   6. Raster & color-map extensions:
 *        - QwtGridRasterData (2-D table + interpolation)
 *        - QwtLinearColorMap::stopColors(), stopPos() API rename.
 *   7. Bar-chart: expose pen/brush control.
 *   8. Amalgamated build: single QwtPlot.h / QwtPlot.cpp pair in src-amalgamate.
 *****************************************************************************/
 
#ifndef QWT_TEXT_H
#define QWT_TEXT_H
 
#include "qwt_global.h"
#include <qmetatype.h>
 
class QFont;
class QString;
class QColor;
class QPen;
class QBrush;
class QSizeF;
class QRectF;
class QPainter;
class QwtTextEngine;
 
class QWT_EXPORT QwtText
{
public:
    enum TextFormat
    {
        AutoText = 0,
 
        PlainText,
 
        RichText,
 
        MathMLText,
 
        TeXText,
 
        OtherFormat = 100
    };
 
    enum PaintAttribute
    {
        PaintUsingTextFont = 0x01,
 
        PaintUsingTextColor = 0x02,
 
        PaintBackground = 0x04
    };
 
    Q_DECLARE_FLAGS(PaintAttributes, PaintAttribute)
 
    
    enum LayoutAttribute
    {
        MinimumLayout = 0x01
    };
 
    Q_DECLARE_FLAGS(LayoutAttributes, LayoutAttribute)
 
    // Default constructor
    QwtText();
    // Constructor with text and format
    QwtText(const QString&, TextFormat textFormat = AutoText);
    // Copy constructor
    QwtText(const QwtText&);
    // Move constructor
    QwtText(QwtText&&) noexcept;
 
    // Destructor
    ~QwtText();
 
    // Assignment operator
    QwtText& operator=(const QwtText&);
    // Move assignment
    QwtText& operator=(QwtText&&) noexcept;
 
    // Equality operator
    bool operator==(const QwtText&) const;
    // Inequality operator
    bool operator!=(const QwtText&) const;
 
    // Set text content and format
    void setText(const QString&, QwtText::TextFormat textFormat = AutoText);
    // Get text content
    QString text() const;
 
    // Check if text is null
    bool isNull() const;
    // Check if text is empty
    bool isEmpty() const;
 
    // Set font
    void setFont(const QFont&);
    // Get font
    QFont font() const;
 
    // Get used font (with fallback)
    QFont usedFont(const QFont&) const;
 
    // Get the current format
    TextFormat format() const;
 
    // Set render flags
    void setRenderFlags(int);
    // Get render flags
    int renderFlags() const;
 
    // Set text color
    void setColor(const QColor&);
    // Get text color
    QColor color() const;
 
    // Get used color (with fallback)
    QColor usedColor(const QColor&) const;
 
    // Set border radius
    void setBorderRadius(double);
    // Get border radius
    double borderRadius() const;
 
    // Set border pen
    void setBorderPen(const QPen&);
    // Get border pen
    QPen borderPen() const;
 
    // Set background brush
    void setBackgroundBrush(const QBrush&);
    // Get background brush
    QBrush backgroundBrush() const;
 
    // Set paint attribute
    void setPaintAttribute(PaintAttribute, bool on = true);
    // Test paint attribute
    bool testPaintAttribute(PaintAttribute) const;
 
    // Set layout attribute
    void setLayoutAttribute(LayoutAttribute, bool on = true);
    // Test layout attribute
    bool testLayoutAttribute(LayoutAttribute) const;
 
    // Get height for width
    double heightForWidth(double width) const;
    // Get height for width with font
    double heightForWidth(double width, const QFont&) const;
 
    // Get text size
    QSizeF textSize() const;
    // Get text size with font
    QSizeF textSize(const QFont&) const;
 
    // Draw text into rectangle
    void draw(QPainter* painter, const QRectF& rect) const;
 
    // Get text engine for text and format
    static const QwtTextEngine* textEngine(const QString& text, QwtText::TextFormat = AutoText);
 
    // Get text engine for format
    static const QwtTextEngine* textEngine(QwtText::TextFormat);
    // Set text engine for format
    static void setTextEngine(QwtText::TextFormat, QwtTextEngine*);
 
private:
    QWT_DECLARE_PRIVATE(QwtText)
 
    class LayoutCache;
    LayoutCache* m_layoutCache;
};
 
Q_DECLARE_OPERATORS_FOR_FLAGS(QwtText::PaintAttributes)
Q_DECLARE_OPERATORS_FOR_FLAGS(QwtText::LayoutAttributes)
 
Q_DECLARE_METATYPE(QwtText)
 
#endif