File indexing completed on 2024-04-21 14:47:02

 /*
     SPDX-FileCopyrightText: 2001-2002 Pablo de Vicente <vicente@oan.es>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #pragma once
 
 #include "dms.h"
 
 #include <QFocusEvent>
 #include <QLineEdit>
 
 /**
  * @class dmsBox
  *
  * A QLineEdit which is capable of displaying and parsing angle values
  * flexibly and robustly.  Angle values can be displayed and parsed as
  * Degrees or Hours.  When displaying a value, it uses a space-delimited
  * triplet of integers representing the degrees, arcminutes, and arcseconds
  * of the angle (or hours, minutes, seconds).  For example, "-34 45 57".
  * When parsing a value input by the user, it can also understand
  * a number of other formats:
  * @li colon-delimited fields ("-34:45:57")
  * @li one or two fields ("-35"; "-34 46")
  * @li fields with unit-labels ("-34d 45m 57s")
  * @li floating-point numbers ("-34.76583")
  *
  * @note Inherits QLineEdit.
  * @author Pablo de Vicente
  * @version 1.0
  */
 class dmsBox : public QLineEdit
 {
         Q_OBJECT
         Q_PROPERTY(Unit units READ getUnits WRITE setUnits)
 
     public:
 
         typedef enum
         {
             HOURS,
             DEGREES
         } Unit;
         /**
          * Constructor for the dmsBox object.
          *
          * @param parent Pointer to the parent QWidget
          * @param unit Units to use (Degree/Arcmin/Arcsec or Hour/Min/Sec)
          */
         explicit dmsBox(QWidget *parent, Unit unit);
 
         /**
          * Deprecated delegating constructor for backwards compatibility
          *
          * @param parent Pointer to the parent QWidget
          * @param isDegree If true, use Unit::DEGREES; if false, use Unit::HOURS
          */
         explicit dmsBox(QWidget *parent, bool isDegree = true)
             : dmsBox(parent, isDegree ? Unit::DEGREES : Unit::HOURS) {}
 
         virtual ~dmsBox() override = default;
 
         /**
          * Display an angle.
          *
          * @param d the dms object which is to be displayed.
          */
         void show(const dms &d);
 
         /**
          * Display an angle.This behaves essentially like the above
          * function.  It differs only in the data type of its argument.
          *
          * @param t the dms object which is to be displayed.
          */
         inline void show(const dms *t)
         {
             show(*t);
         }
 
         /**
          * Parse the text in the dmsBox as an angle. The text may be an integer
          * or double value, or it may be a triplet of integer values (separated by spaces
          * or colons) representing deg/hrs, min, sec.  It is also possible to have two
          * fields.  In this case, if the second field is a double, it is converted
          * to decimal min and double sec.
          *
          * @param ok set to true if a dms object was successfully created.
          * @return a dms object constructed from the fields of the dmsbox
          */
         dms createDms(bool *ok = nullptr);
 
         /**
          * @return the unit being used (DEGREES or HOURS)
          */
         inline Unit getUnits() const
         {
             return m_unit;
         }
 
         /**
          * @short set the dmsBox to Degrees or Hours
          *
          * @param unit If Unit::DEGREES, then the display and
          * interpretation of text is in degrees, if Unit::HOURS then in
          * hours.
          */
         void setUnits(Unit unit);
 
         /** Clears the QLineEdit */
         inline void clearFields(void)
         {
             setText(QString());
         }
 
         inline bool isEmpty() const
         {
             return text().isEmpty();
         }
 
     private:
 
         void setPlaceholderText();
 
         Unit m_unit;
 };