QfTower.H

/* QfTower.H */
/* $Id: QfTower.H,v 1.7 2003/10/10 08:07:50 vlad Exp $ */
#ifndef __QfTower_H
#define __QfTower_H

#include <zm/QfBuilding.H>


/***********************************************************************
 * Container of vertically constrained objects with rich decoration
 * features.
 */
class QfTower: public QfBuilding
{
protected:

  /* Stored resource name */
  char      *resname;

  /* Form widget if frame is drawn as wSelf. */
  Widget    wForm;

  /* Temporal variable to store tower's decoration. */
  QfDecoration  decor;

  /* XmForm/{XmFrame,XmForm} creation. */
  virtual void  create_self (Widget wParent);

  /*
   *  Subobjects with internally predefined functionality.
   */

  /* Separator. */
  class QfHorSep : public QfBrick
    {
    protected:
      /* Create XmSeparator with horizontal orientation. */
      virtual void  create_self (Widget wParent);
    };

  /* Title and topic. */
  class QfLabel : public QfBrick
    {
    protected:
      char  *label;
      char  *resname;
      int   alignment;
      /* Create XmLabel with given alignment and resource name. */
      virtual void  create_self (Widget wParent);
    public:
      QfLabel (const char* szLabel, const char* szResName, int align);
    };

  /* Cummulative indent value in pixels. */
  int       iIndent;

  /* Actual indent value in pixels. */
  int       iLeftOffset;

public:

  /* Create general container that is main master.  Phases 1-3 take
     place here. */
  QfTower (Widget wParent, QfDecoration eDecor = QfDECOR_NONE,
       const char* szResName = QfKING_NAME);

  /* Create subcontrolled container to provide complicated form
     structure.  Only Phase 1 is here. */
  QfTower (QfDecoration eDecor = QfDECOR_NONE,
       const char* szResName = QfKING_NAME);

  /*
   *  Decoration.
   */

  /* Separator. */
  virtual QfBrick*  sep ();

  /* Title. */
  virtual QfBrick*  title (const char* szLabel);

  /* Left aligned label. */
  virtual QfBrick*  topic (const char* szLabel);

  /*
   *  Adjustable features.
   */

  /* Set current left offset in addition to usual behaviour. */
  virtual void  add (QfBrick* pBrick);

  /* Return Widget of container itself (XmForm). */
  virtual Widget    container () const;

  /* Manage tower and all bricks to display prepared GUI
     during phase 3: Phase 4. */
  virtual void      manage ();

  /*
   *  Quick access features.
   */

  /* Add brick in chain and provide chain facility. */
  QfTower&  operator << (QfBrick* pBrick)
    {
      iLeftOffset = iIndent;
      add(pBrick);
      iLeftOffset = 0;
      return *this;
    }

  /* Add topic. */
  QfTower&  operator << (const char* szLabel)
    {
      iLeftOffset = iIndent;
      add(topic(szLabel));
      iLeftOffset = 0;
      return *this;
    }

  /* Add indentation (see QfINDENT). */
  QfTower&  operator << (int iOffset)
    {
      if(iOffset + iIndent < 0)
    iIndent = 0;
      else
    iIndent += iOffset;
      return *this;
    }

};


#endif /* QfTower.H */