QfNumericField.H

/* QfNumericField.H */
/* $Id: QfNumericField.H,v 1.6 2003/11/21 14:41:11 vlad Exp $ */
#ifndef __QfNumericField_H
#define __QfNumericField_H

#include <float.h>
#include <limits.h>

#include <zm/qvfcdefs.h>
#include <zm/QfTextField.H>


/***********************************************************************
 * Numeric field object.  Provides way to enter or edit number.
 */
class QfNumericField: public QfTextField
{
protected:

  char      szTextBuf[QfNUMERIC_FIELD_LENGTH+1];
  AtomType  eType;      /* Type of pointer. */
  int       nfOptions;  /* ORed options passed to constructor */
  Widget    wScaler;    /* XmScale widget if QfNFM_SCALER is set */
  union     NumberValue {
#define VAR_VERIFY(T,I) \
    struct {\
      T *p; /* Pointer to variable. */\
      T min, max;   /* Allowed range. */\
    }   I
/* end def */

    VAR_VERIFY(Int1, int_1);
    VAR_VERIFY(Int2, int_2);
    VAR_VERIFY(Int4, int_4);
    VAR_VERIFY(Real4, real_4);
    VAR_VERIFY(Real8, real_8);
#undef VAR_VERIFY
  } t;

  /* Textfield verification callback. */
  static void   verify_text_cb (Widget w, XtPointer pUserData,
                XtPointer pCallData);

  /* Scaler tracking callback. */
  static void   scale_changed_cb (Widget w, XtPointer pUserData,
                  XtPointer pCallData);

  /* Put internal number content to scaler */
  virtual void  this_to_scaler (char* szBuf = NULL);

  /* Update internal number content from scaler */
  virtual void  scaler_to_this ();

  /* Add callbacks and scaler. */
  virtual void  create_self (Widget wParent);

  /* Called to parse user input to get number.  Returns 0 if OK and !0
     if user input is not a valid number. */
  virtual int   parse_input (char* szInput,
                 Int4* pIntNumber,
                 Real8* pRealNumber);

  /* Called when szInput contains already proposed number, entered
     by user.   Function calls *_fault() methods on demand.
     Returns 0 is OK, 1 for conversion error, 2 for range error. */
  virtual int   check_input (char* szInput);

  /* Called when numeric value is out of allowed range. */
  virtual void  numeric_range_fault ();

  /* Called when text can't be successfully converted to number. */
  virtual void  convert_to_number_fault (char* szInput);

public:

  /* In/out buffer: pNumVar; verifier is set by vMin and vMax. */
  QfNumericField (const char* szLabel, Int1* pNumVar,
          Int1 vMin = SCHAR_MIN, Int1 vMax = SCHAR_MAX,
          int mNFOptions = 0);
  QfNumericField (const char* szLabel, Int2* pNumVar,
          Int2 vMin = SHRT_MIN, Int2 vMax = SHRT_MAX,
          int mNFOptions = 0);
  QfNumericField (const char* szLabel, Int4* pNumVar,
          Int4 vMin = INT_MIN, Int4 vMax = INT_MAX,
          int mNFOptions = 0);
  QfNumericField (const char* szLabel, Real4* pNumVar,
          Real4 vMin = -FLT_MAX, Real4 vMax = FLT_MAX,
          int mNFOptions = 0);
  QfNumericField (const char* szLabel, Real8* pNumVar,
          Real8 vMin = -DBL_MAX, Real8 vMax = DBL_MAX,
          int mNFOptions = 0);

  /*
   *  Adjustable features.
   */

  virtual void  store_gui ();
  virtual void  load_gui ();

};


#endif /* QfNumericField.H */