qt_demoe/qwtdemo/qwt/qwt_plot_legenditem.h

137 lines
3.6 KiB
C++

/* -*- mode: C++ ; c-file-style: "stroustrup" -*- *****************************
* 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
*****************************************************************************/
#ifndef QWT_PLOT_LEGEND_ITEM_H
#define QWT_PLOT_LEGEND_ITEM_H
#include "qwt_global.h"
#include "qwt_plot_item.h"
#include "qwt_legend_data.h"
class QFont;
/*!
\brief A class which draws a legend inside the plot canvas
QwtPlotLegendItem can be used to draw a inside the plot canvas.
It can be used together with a QwtLegend or instead of it
to have more space for the plot canvas.
In opposite to QwtLegend the legend item is not interactive.
To identify mouse clicks on a legend item an event filter
needs to be installed catching mouse events ob the plot canvas.
The geometries of the legend items are available using
legendGeometries().
The legend item is aligned to plot canvas according to
its alignment() flags. It might have a background for the
complete legend ( usually semi transparent ) or for
each legend item.
\note An external QwtLegend with a transparent background
on top the plot canvas might be another option
with a similar effect.
*/
class QWT_EXPORT QwtPlotLegendItem: public QwtPlotItem
{
public:
/*!
\brief Background mode
Depending on the mode the complete legend or each item
might have an background.
The default setting is LegendBackground.
\sa setBackgroundMode(), setBackgroundBrush(), drawBackground()
*/
enum BackgroundMode
{
//! The legend has a background
LegendBackground,
//! Each item has a background
ItemBackground
};
explicit QwtPlotLegendItem();
virtual ~QwtPlotLegendItem();
virtual int rtti() const;
void setAlignment( Qt::Alignment );
Qt::Alignment alignment() const;
void setMaxColumns( uint );
uint maxColumns() const;
void setMargin( int );
int margin() const;
void setSpacing( int );
int spacing() const;
void setItemMargin( int );
int itemMargin() const;
void setItemSpacing( int );
int itemSpacing() const;
void setFont( const QFont& );
QFont font() const;
void setBorderDistance( int numPixels );
int borderDistance() const;
void setBorderRadius( double );
double borderRadius() const;
void setBorderPen( const QPen & );
QPen borderPen() const;
void setBackgroundBrush( const QBrush & );
QBrush backgroundBrush() const;
void setBackgroundMode( BackgroundMode );
BackgroundMode backgroundMode() const;
void setTextPen( const QPen & );
QPen textPen() const;
virtual void draw( QPainter *p,
const QwtScaleMap &xMap, const QwtScaleMap &yMap,
const QRectF &rect ) const;
void clearLegend();
virtual void updateLegend( const QwtPlotItem *,
const QList<QwtLegendData> & );
virtual QRect geometry( const QRectF &canvasRect ) const;
virtual QSize minimumSize( const QwtLegendData & ) const;
virtual int heightForWidth( const QwtLegendData &, int w ) const;
QList< const QwtPlotItem * > plotItems() const;
QList< QRect > legendGeometries( const QwtPlotItem * ) const;
protected:
virtual void drawLegendData( QPainter *painter,
const QwtPlotItem *, const QwtLegendData &, const QRectF & ) const;
virtual void drawBackground( QPainter *, const QRectF &rect ) const;
private:
class PrivateData;
PrivateData *d_data;
};
#endif