QfBrick.H

/* QfBrick.H */
/* $Id: QfBrick.H,v 1.9 2005/05/16 13:56:33 vlad Exp $ */
#ifndef __QfBrick_H
#define __QfBrick_H


#include <X11/Intrinsic.h>

#include <mix/Types.h>
#include <mix/Exceptions.h>
#include <mix/misc.h>
#include <mix/wenv.h>

#include <zm/Qmisc.H>


/***********************************************************************

                  Main concept of form creation.

 Phase 1: Object creation.

 Programmer need to specify where external storage will reside.  This
 method helps to use statically allocated variables to store application
 specific data.

 Phase 2: Object linking.

 Then object needs to be embedded into master structure to be part of
 visual form.

 Phase 3: Widget creation.

 Then object creates owb GUI widgets/gadgets and represents the most
 chargable (top in parent-child hierarchy) to own parent - master.
 Radio and other behaviors must be initiated here.

 Phase 4: Managing.

 Master decides to manage children to display them and provide
 interaction.

 **********************************************************************/


class QfBuilding;   /* Forwarding */


/***********************************************************************
 * Entry object in form.  Common XToolkit object (Widget/Gadget, never
 * mind) controlled by XtSetValues/XtGetValues.  Needs to be overridden
 * to provide any functionality.
 */
class QfBrick
{
  friend class  QfBuilding;

protected:

  Widget    wSelf;  /* Reference to the XToolkit object. */

  virtual void  create_self (Widget wParent) = 0;

  virtual void  radio_activity ();

  QCBDescrAr    cbList; 

  QRadioActive  *qRA;

public:

  QfBrick ();

  virtual ~QfBrick ();

  operator Widget () const
    {  return wSelf;  }

  Widget    widget () const
    {  return wSelf;  }

  /*
   *  Adjustable features.
   */

  virtual QfType    type () const;

  virtual void  manage ();

  virtual void  store_gui ();

  virtual void  load_gui ();

  virtual void  radio_sensitive ();

  virtual void  set_sensitive (Logic flag);

  virtual Logic get_sensitive ();

  virtual void  add_callback (const QCallback& qcb);
  friend QfBrick*   operator+ (QfBrick* qControl, const QCallback& qcb);

  virtual void  be_radio_active (const QRadioActive& qra);
  friend QfBrick*   operator+ (QfBrick* pThis,
                   const QRadioActive& qra);

  virtual void  realized ();

};


/***********************************************************************
 * Template way to create array of bricks.
 */
#define PtrType QfBrick*
#define PtrAr   BricksAr
#include <mix/PtrAr.H>


#endif /* QfBrick.H */