The legend widget.  
 More...
#include <qwt_legend.h>
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 QwtLegendLabel.
- See also
- QwtLegendLabel, QwtPlotItem, QwtPlot 
  
  | 
        
          | QwtLegend::QwtLegend | ( | QWidget * | parent = NULL | ) |  |  | explicit | 
 
 
  
  | 
        
          | void QwtLegend::checked | ( | const QVariant & | itemInfo, |  
          |  |  | bool | on, |  
          |  |  | int | index |  
          |  | ) |  |  |  | signal | 
 
A signal which is emitted when the user has clicked on a legend label, which is in QwtLegendData::Checkable mode
- Parameters
- 
  
    | itemInfo | Info for the item of the selected legend label |  | index | Index of the legend label in the list of widgets that are associated with the plot item |  | on | True when the legend label is checked |  
 
- Note
- clicks are disabled as default 
- See also
- setDefaultItemMode(), defaultItemMode(), QwtPlot::itemToInfo() 
 
 
  
  | 
        
          | void QwtLegend::clicked | ( | const QVariant & | itemInfo, |  
          |  |  | int | index |  
          |  | ) |  |  |  | signal | 
 
 
      
        
          | QWidget * QwtLegend::contentsWidget | ( |  | ) |  | 
      
 
The contents widget is the only child of the viewport of the internal QScrollArea and the parent widget of all legend items.
- Returns
- Container widget of the legend items 
 
 
      
        
          | const QWidget * QwtLegend::contentsWidget | ( |  | ) | const | 
      
 
The contents widget is the only child of the viewport of the internal QScrollArea and the parent widget of all legend items.
- Returns
- Container widget of the legend items 
 
 
  
  | 
        
          | QWidget * QwtLegend::createWidget | ( | const QwtLegendData & | data | ) | const |  | protectedvirtual | 
 
Create a widget to be inserted into the legend. 
The default implementation returns a QwtLegendLabel.
- Parameters
- 
  
    | data | Attributes of the legend entry |  
 
- Returns
- Widget representing data on the legend
- Note
- updateWidget() will called soon after createWidget() with the same attributes. 
 
 
  
  | 
        
          | bool QwtLegend::eventFilter | ( | QObject * | object, |  
          |  |  | QEvent * | event |  
          |  | ) |  |  |  | virtual | 
 
Handle QEvent::ChildRemoved andQEvent::LayoutRequest events for the contentsWidget().
- Parameters
- 
  
    | object | Object to be filtered |  | event | Event |  
 
- Returns
- Forwarded to QwtAbstractLegend::eventFilter() 
 
 
  
  | 
        
          | int QwtLegend::heightForWidth | ( | int | width | ) | const |  | virtual | 
 
- Returns
- The preferred height, for a width. 
- Parameters
- 
  
  
 
 
      
        
          | QScrollBar * QwtLegend::horizontalScrollBar | ( |  | ) | const | 
      
 
 
  
  | 
        
          | bool QwtLegend::isEmpty | ( |  | ) | const |  | virtual | 
 
 
  
  | 
        
          | void QwtLegend::itemChecked | ( | bool | on | ) |  |  | protectedslot | 
 
Called internally when the legend has been checked Emits a checked() signal. 
 
 
  
  | 
        
          | void QwtLegend::itemClicked | ( |  | ) |  |  | protectedslot | 
 
Called internally when the legend has been clicked on. Emits a clicked() signal. 
 
 
      
        
          | QVariant QwtLegend::itemInfo | ( | const QWidget * | widget | ) | const | 
      
 
Find the item that is associated to a widget
- Parameters
- 
  
    | widget | Widget on the legend |  
 
- Returns
- Associated item info 
- See also
- legendWidget() 
 
 
      
        
          | QWidget * QwtLegend::legendWidget | ( | const QVariant & | itemInfo | ) | const | 
      
 
- Returns
- First widget in the list of widgets associated to an item 
- Parameters
- 
  
    | itemInfo | Info about an item |  
 
- See also
- itemInfo(), QwtPlot::itemToInfo() 
- Note
- Almost all types of items have only one widget 
 
 
      
        
          | QList< QWidget * > QwtLegend::legendWidgets | ( | const QVariant & | itemInfo | ) | const | 
      
 
 
      
        
          | uint QwtLegend::maxColumns | ( |  | ) | const | 
      
 
 
  
  | 
        
          | void QwtLegend::renderItem | ( | QPainter * | painter, |  
          |  |  | const QWidget * | widget, |  
          |  |  | const QRectF & | rect, |  
          |  |  | bool | fillBackground |  
          |  | ) |  | const |  | virtual | 
 
Render a legend entry into a given rectangle.
- Parameters
- 
  
    | painter | Painter |  | widget | Widget representing a legend entry |  | rect | Bounding rectangle |  | fillBackground | When true, fill rect with the widget background |  
 
- Note
- When widget is not derived from QwtLegendLabel renderItem does nothing beside the background 
 
 
  
  | 
        
          | void QwtLegend::renderLegend | ( | QPainter * | painter, |  
          |  |  | const QRectF & | rect, |  
          |  |  | bool | fillBackground |  
          |  | ) |  | const |  | virtual | 
 
 
  
  | 
        
          | int QwtLegend::scrollExtent | ( | Qt::Orientation | orientation | ) | const |  | virtual | 
 
Return the extent, that is needed for the scrollbars
- Parameters
- 
  
  
- Returns
- The width of the vertical scrollbar for Qt::Horizontal and v.v. 
Reimplemented from QwtAbstractLegend.
 
 
Set the default mode for legend labels. 
Legend labels will be constructed according to the attributes in a QwtLegendData object. When it doesn't contain a value for the QwtLegendData::ModeRole the label will be initialized with the default mode of the legend.
- Parameters
- 
  
  
- See also
- itemMode(), QwtLegendData::value(), QwtPlotItem::legendData() 
- Note
- Changing the mode doesn't have any effect on existing labels. 
 
 
      
        
          | void QwtLegend::setMaxColumns | ( | uint | numColums | ) |  | 
      
 
Set the maximum number of entries in a row. 
F.e when the maximum is set to 1 all items are aligned vertically. 0 means unlimited
- Parameters
- 
  
    | numColums | Maximum number of entries in a row |  
 
- See also
- maxColumns(), QwtDynGridLayout::setMaxColumns() 
 
 
  
  | 
        
          | void QwtLegend::updateLegend | ( | const QVariant & | itemInfo, |  
          |  |  | const QList< QwtLegendData > & | data |  
          |  | ) |  |  |  | virtualslot | 
 
Update the entries for an item. 
- Parameters
- 
  
    | itemInfo | Info for an item |  | data | List of legend entry attributes for the item |  
 
 
 
  
  | 
        
          | void QwtLegend::updateWidget | ( | QWidget * | widget, |  
          |  |  | const QwtLegendData & | data |  
          |  | ) |  |  |  | protectedvirtual | 
 
 
      
        
          | QScrollBar * QwtLegend::verticalScrollBar | ( |  | ) | const |