Módulo : xyleg.h

Desc : Declara classe XYLegend.
Autores : Carlos Henrique Levy e Jaudênia Cavalcante.
Data : 26 jun 96.

Classe que gerencia a apresentação da legenda para um determinado gráfico com o número de linhas e colunas definidos pelo usuário. Essa classe faz uso da mesma lista de máscaras válida para o gráfico ao qual ela está associada, medida que evita duplicação de informação. Seu layout é compos to por uma região delimitada pela presença ou não de uma moldura, nomes das séries envolvidas e seus ícones de representação.

class XYLegend : public XYObject

Construtores e Destrutor

Construtor da classe XYLegend

   XYLegend (
        XYCoordinate x,  // referência para a coordenada x
        XYCoordinate y,  // referência para a coordenada y
        int nlines,      // número de linhas
        int ncolumns,    // número de colunas
        bool box = true, // moldura (true or false)
        bool visible = true);  // visibilidade

Destrutor da classe XYLegend

   virtual ~XYLegend (void);

Define a lista de máscaras a ser representada

   virtual void mask (const XYList<XYMask>* mask);

Consulta a lista de máscaras a ser representada

   virtual const XYList<XYMask>* mask (void) const;

Define cor de fundo

   virtual void backgroundColor(long color);

Consulta cor de fundo

   virtual long backgroundColor(void) const;

Define cor da moldura

   virtual void frameColor(long color);

Consulta a cor da moldura

   virtual long frameColor(void) const;

Define o número de linhas

   virtual void lines (int nl);

Consulta o número de linhas

   virtual int lines (void) const;

Define o número de colunas

   virtual void columns (int nc);

Consulta o número de colunas

   virtual int columns (void) const;

Define se a legenda tem moldura

   virtual void box (bool b);

Consulta se a legenda tem moldura

   virtual bool box (void) const;

Retorna true se o ponto estiver sobre a legenda

   virtual bool pick (int px, int py);

Retorna a máscara cujo item representativo na legenda foi tocado

   virtual XYMask* pickItem (int px, int py);

Retorna true se a legenda estiver interior a região de "fence"

   virtual bool fence (int x0, int y0, int x1, int y1);

Limpa região onde a legenda é desenhada

   virtual void clear(void) const;
   virtual void clear(int xmin, int ymin, int xmax, int ymax) const;

Desenha

   virtual void draw (void);

Desenha numa região

   virtual void draw (int xmin, int ymin, int xmax, int ymax) const;

Retorna menor retângulo que contém a legenda, suas coordenadas são dadas em pixels

   virtual void boundingBox (int& bxmin, int& bymin, int& bxmax, int& bymax) const;