QwtLegend Class Reference

The legend widget. More...

#include <qwt_legend.h>

List of all members.

Public Types

enum  LegendDisplayPolicy {
  NoIdentifier = 0,
  FixedIdentifier = 1,
  AutoIdentifier = 2
}
enum  LegendItemMode {
  ReadOnlyItem,
  ClickableItem,
  CheckableItem
}

Public Member Functions

 QwtLegend (QWidget *parent=NULL)
virtual ~QwtLegend ()
void setDisplayPolicy (LegendDisplayPolicy policy, int mode)
LegendDisplayPolicy displayPolicy () const
void setItemMode (LegendItemMode)
LegendItemMode itemMode () const
int identifierMode () const
QWidget * contentsWidget ()
const QWidget * contentsWidget () const
void insert (const QwtLegendItemManager *, QWidget *)
void remove (const QwtLegendItemManager *)
QWidget * find (const QwtLegendItemManager *) const
QwtLegendItemManagerfind (const QWidget *) const
virtual QList< QWidget * > legendItems () const
void clear ()
bool isEmpty () const
uint itemCount () const
virtual bool eventFilter (QObject *, QEvent *)
virtual QSize sizeHint () const
virtual int heightForWidth (int w) const
QScrollBar * horizontalScrollBar () const
QScrollBar * verticalScrollBar () const

Protected Member Functions

virtual void resizeEvent (QResizeEvent *)
virtual void layoutContents ()

Detailed Description

The legend widget.

The QwtLegend widget is a tabular arrangement of legend items. Legend items might be any type of widget, but in general they will be a QwtLegendItem.

See also:
QwtLegendItem, QwtLegendItemManager QwtPlot

Member Enumeration Documentation

Display policy.

  • NoIdentifier
    The client code is responsible how to display of each legend item. The Qwt library will not interfere.
  • AutoIdentifier
    Each legend item is displayed with a mode that is a bitwise or of
    • QwtLegendItem::ShowLine (if its curve is drawn with a line) and
    • QwtLegendItem::ShowSymbol (if its curve is drawn with symbols) and
    • QwtLegendItem::ShowText (if the has a title).

Default is AutoIdentifier.

See also:
setDisplayPolicy(), displayPolicy(), QwtLegendItem::IdentifierMode

Interaction mode for the legend items.

  • ReadOnlyItem
    The legend item is not interactive, like a label
  • ClickableItem
    The legend item is clickable, like a push button
  • CheckableItem
    The legend item is checkable, like a checkable button

Default is ReadOnlyItem.

See also:
setItemMode(), itemMode(), QwtLegendItem::IdentifierMode QwtLegendItem::clicked(), QwtLegendItem::checked(), QwtPlot::legendClicked(), QwtPlot::legendChecked()

Constructor & Destructor Documentation

QwtLegend::QwtLegend ( QWidget *  parent = NULL  )  [explicit]

Constructor

Parameters:
parent Parent widget
QwtLegend::~QwtLegend (  )  [virtual]

Destructor.


Member Function Documentation

void QwtLegend::clear (  ) 

Remove all items.

const QWidget * QwtLegend::contentsWidget (  )  const

The contents widget is the only child of the viewport() and the parent widget of all legend items.

QWidget * QwtLegend::contentsWidget (  ) 

The contents widget is the only child of the viewport() and the parent widget of all legend items.

QwtLegend::LegendDisplayPolicy QwtLegend::displayPolicy (  )  const
Returns:
the legend display policy. Default is LegendDisplayPolicy::Auto.
See also:
setDisplayPolicy(), LegendDisplayPolicy
bool QwtLegend::eventFilter ( QObject *  o,
QEvent *  e 
) [virtual]

Filter layout related events of QwtLegend::contentsWidget().

Parameters:
o Object to be filtered
e Event
QwtLegendItemManager * QwtLegend::find ( const QWidget *  legendItem  )  const

Find the widget that represents a plot item

Parameters:
legendItem Legend item
Returns:
Widget on the legend, or NULL
QWidget * QwtLegend::find ( const QwtLegendItemManager plotItem  )  const

Find the widget that represents a plot item

Parameters:
plotItem Plot item
Returns:
Widget on the legend, or NULL
int QwtLegend::heightForWidth ( int  width  )  const [virtual]
Returns:
The preferred height, for the width w.
Parameters:
width Width
QScrollBar * QwtLegend::horizontalScrollBar (  )  const
Returns:
Horizontal scrollbar
See also:
verticalScrollBar()
int QwtLegend::identifierMode (  )  const
Returns:
the IdentifierMode to be used in combination with LegendDisplayPolicy::Fixed.

Default is ShowLine | ShowSymbol | ShowText.

void QwtLegend::insert ( const QwtLegendItemManager plotItem,
QWidget *  legendItem 
)

Insert a new item for a plot item

Parameters:
plotItem Plot item
legendItem New legend item
Note:
The parent of item will be changed to QwtLegend::contentsWidget()
bool QwtLegend::isEmpty (  )  const

Return true, if there are no legend items.

uint QwtLegend::itemCount (  )  const

Return the number of legend items.

QwtLegend::LegendItemMode QwtLegend::itemMode (  )  const
See also:
LegendItemMode
void QwtLegend::layoutContents (  )  [protected, virtual]

Adjust contents widget and item layout to the size of the viewport().

QList< QWidget * > QwtLegend::legendItems (  )  const [virtual]

Return a list of all legend items.

void QwtLegend::remove ( const QwtLegendItemManager plotItem  ) 

Find the corresponding item for a plotItem and remove it from the item list.

Parameters:
plotItem Plot item
void QwtLegend::resizeEvent ( QResizeEvent *  e  )  [protected, virtual]

Resize event

Parameters:
e Resize event
void QwtLegend::setDisplayPolicy ( LegendDisplayPolicy  policy,
int  mode 
)

Set the legend display policy to:

Parameters:
policy Legend display policy
mode Identifier mode (or'd ShowLine, ShowSymbol, ShowText)
See also:
displayPolicy(), LegendDisplayPolicy
void QwtLegend::setItemMode ( LegendItemMode  mode  ) 
See also:
LegendItemMode
QSize QwtLegend::sizeHint (  )  const [virtual]

Return a size hint.

QScrollBar * QwtLegend::verticalScrollBar (  )  const
Returns:
Vertical scrollbar
See also:
horizontalScrollBar()
Generated on Sun Apr 11 11:55:39 2010 for Qwt User's Guide by  doxygen 1.6.3