formcoord.h

Go to the documentation of this file.

/** 
 * \file mgui/formcoord.h 
 * \brief Definitions for MGUI::FORM_EDIT_COORD class.
 *
 * \if NODOC
 * $Id: formcoord.h_v 1.1 2004/09/10 19:25:40 dwilliss Exp $
 *
 * $Log: formcoord.h_v $
 * Revision 1.1  2004/09/10 19:25:40  dwilliss
 * Initial revision
 *
 * \endif
**/

#ifndef  INC_MGUI_FORM_EDIT_COORD_H
#define  INC_MGUI_FORM_EDIT_COORD_H

#ifndef INC_MGUI_FORM_H
#include <mgui/form.h>
#endif

#ifndef  INC_MGUI_CTRL_H
#include <mgui/ctrl.h>
#endif

#ifndef  INC_MGUI_FORMBTXT_H
#include <mgui/formbtxt.h>
#endif

#ifndef  INC_MGUI_COMBOBOX_H
#include <mgui/combobox.h>
#endif

#ifndef  INC_MI32_SPATREF_H
#include <mi32/spatref.h>
#endif

namespace MGUI {

//:>===================================================================================================================
//! Form consisting of label and edit fields for editing a single coordinate
class FORM_EDIT_COORD : public MGUI::FORM_COMPOSITE {
   public:

      //! Constructor.
      FORM_EDIT_COORD (
         );

      //! Destructor.
      virtual ~FORM_EDIT_COORD (
         );

      //! Clear range edit controls.
      void Clear (
         bool notify = true
         );

      //! Create form with label from resource lookup.
      void Create (
         MGUI::LAYOUT_PANE_BASE& ParentPane,    //!< Parent pane
         MGUI::LAYOUT_SIZEALIGN sizealign = MGUI::LAYOUT_SIZEALIGN_FixedSize
         );

      //! Get the extents of the form
      const DPOINT3D& GetValue (
         ) const { return (m_Point); }
         
      //! Get the projection to use for extents selection.
      const SPATREF::COORDREFSYS& GetCoordRefSys (
         ) const { return (m_CoordRefSys); }

      //! Determine if user has entered values for both x and y (and z if enabled)
      bool HasValues (
         );

      //! Set the coordinate of the form
      //! Do this after the call to SetProjection() or the call to the method will alter the point
      void SetValue (
         const DPOINT2D& Point,
         bool notify = true
         );

      //! Set the coordinate of the form
      //! Do this after the call to SetProjection() or the call to the method will alter the point
      void SetValue (
         const DPOINT3D& Point,
         bool notify = true
         );

      //! Set the projection to use for coordinate selection.
      //! If a projection and value coordinates exists, the coordinate will be converted to the new projection
      void SetCoordRefSys (
         const SPATREF::COORDREFSYS& CoordRefSys,
         bool notify = true
         );


   private:
      #ifndef GENERATING_DOXYGEN_OUTPUT
      SPATREF::COORDREFSYS m_CoordRefSys;
      DPOINT3D m_Point;
      bool m_bIs3D;
      
      LAYOUT_PANE m_XPane;
      CTRL_LABEL m_XLabel;
      CTRL_EDIT_NUMBER_T<FORM_EDIT_COORD> m_XPrompt;
      
      LAYOUT_PANE m_YPane;
      CTRL_LABEL m_YLabel;
      CTRL_EDIT_NUMBER_T<FORM_EDIT_COORD> m_YPrompt;
      
      LAYOUT_PANE m_ZPane;
      CTRL_LABEL m_ZLabel;
      CTRL_EDIT_NUMBER_T<FORM_EDIT_COORD> m_ZPrompt;
      
      virtual void v_OnChangeValue ();

      void OnValueChanged ();
      void UpdateProjection ();
      #endif // GENERATING_DOXYGEN_OUTPUT
   };

//:>-------------------------------------------------------------------------------------------------------------------
// Convenience template for FORM_EDIT_COORD to allow method in container class to be called.
template <class _CT> class FORM_EDIT_COORD_T : public MGUI::FORM_EDIT_COORD {
   public:

      //! Constructor.
      explicit FORM_EDIT_COORD_T (
         _CT *pContainer
         ): m_pContainer(pContainer), m_pfOnChangeValue(0), m_pfOnChangeCoordRefSys(0) 
         { }

      //! Set container pointer.
      //! Container may also be specified in constructor.
      void SetContainer (
         _CT *pContainer
         ) { m_pContainer = pContainer; }

      //! Set container method to call for OnChangeValue().
      void SetFuncChangePoint (
         void (_CT::*pfOnChangeValue)()
         ) { m_pfOnChangeValue = pfOnChangeValue; };

      //! Set container method to call for OnChangeProjection()
      void SetFuncChangeCoordRefSys (
         void (_CT::*pfOnChangeCoordRefSys)()
         ) { m_pfOnChangeCoordRefSys = pfOnChangeCoordRefSys; };

   private:

      #ifndef GENERATING_DOXYGEN_OUTPUT
      _CT *m_pContainer;
      void (_CT::*m_pfOnChangeValue)();
      void (_CT::*m_pfOnChangeCoordRefSys)();

      virtual void v_OnChangeValue (
         ) { if (m_pfOnChangeValue != 0) (m_pContainer->*m_pfOnChangeValue)(); }

      virtual void v_OnChangeCoordRefSys (
         ) { if (m_pfOnChangeCoordRefSys != 0) (m_pContainer->*m_pfOnChangeCoordRefSys)(); }
      #endif // GENERATING_DOXYGEN_OUTPUT
   };

}  // End of MGUI namespace

#endif      // INC_MGUI_FORM_COORD_H

---