A spin box for displaying/entering angular values. More...

#include <AngleSpinBox.hpp>

Inheritance diagram for AngleSpinBox:

Collaboration diagram for AngleSpinBox:

Public Types
enum	DisplayFormat { DMSLetters, DMSSymbols, DMSLettersUnsigned, DMSSymbolsUnsigned, HMSLetters, HMSSymbols, DecimalDeg }
	Used to decide how to display the angle. More...

enum	PrefixType { Normal, NormalPlus, Longitude, Latitude, Unknown }
	Determines how positive and negative values are indicated. More...

Public Slots
virtual void	clear ()
	Set the value to default 0 angle. More...

void	setRadians (double radians)
	Set the value of the spin box in radians. More...

void	setDegrees (double degrees)
	Set the value of the spin box in decimal degrees. More...

Signals
void	valueChanged ()
	Emitted when the value changes. More...

Public Member Functions
	AngleSpinBox (QWidget *parent=0, DisplayFormat format=DMSSymbols, PrefixType prefix=Normal)

virtual void	stepBy (int steps)

virtual QValidator::State	validate (QString &input, int &pos) const

double	valueRadians ()
	Get the angle held in the AngleSpinBox. More...

double	valueDegrees ()
	Get the angle held in the AngleSpinBox. More...

void	setDecimals (int places)
	Set the number of decimal places to express float values to (e.g. More...

int	decimals ()
	Get the number of decimal places to express float values to (e.g. More...

void	setDisplayFormat (DisplayFormat format)
	Set the display format. More...

DisplayFormat	displayFormat ()
	Get the current display format. More...

void	setPrefixType (PrefixType prefix)
	Set the prefix type. More...

PrefixType	prefixType ()
	Get the current display format. More...

void	setMinimum (const double min, const bool isDegrees=false)
	Set the minimum value. More...

double	getMinimum (const bool isDegrees)
	Get the minimum value. More...

void	setMaximum (const double max, const bool isDegrees=false)
	Set the maximum value. More...

double	getMaximum (const bool isDegrees)
	Get the maximum value. More...

Protected Member Functions
virtual StepEnabled	stepEnabled () const

Detailed Description

A spin box for displaying/entering angular values.

This class can accept angles in various formats commonly used in astronomy including decimal degrees, DMS and HMS. You should set upper and lower limits (maximum, minimum) and decide whether the values wrap around or are blocked at the limits (wrapping).

Definition at line 34 of file AngleSpinBox.hpp.

Member Enumeration Documentation

enum AngleSpinBox::DisplayFormat

Used to decide how to display the angle.

Enumerator
DMSLetters	Degrees, minutes and seconds, e.g. 180d 4m 8s, with negative values, [-360..360d].
DMSSymbols	Degrees, minutes and seconds, e.g. 180° 4' 8", with negative values, [-360..360°].
DMSLettersUnsigned	Degrees, minutes and seconds, e.g. 180d 4m 8s, [0..360d].
DMSSymbolsUnsigned	Degrees, minutes and seconds, e.g. 180° 4' 8", [0..360°].
HMSLetters	Hours, minutes and seconds, e.g. 12h 4m 6s.
HMSSymbols	Hours, minutes and seconds, e.g. 12h 4' 6s".
DecimalDeg	Decimal degrees, e.g. 180.06888.

Definition at line 41 of file AngleSpinBox.hpp.

enum AngleSpinBox::PrefixType

Determines how positive and negative values are indicated.

Enumerator
Normal	negative values have '-' prefix
NormalPlus	positive values have '+' prefix, negative values have '-' prefix.
Longitude	positive values have 'E' prefix, negative values have 'W' prefix.
Latitude	positive values have 'N' prefix, negative values have 'S' prefix.

Definition at line 54 of file AngleSpinBox.hpp.

Member Function Documentation

virtual void AngleSpinBox::clear ( )

virtualslot

Set the value to default 0 angle.

int AngleSpinBox::decimals ( )

inline

Get the number of decimal places to express float values to (e.g.

seconds in DMSLetters format).

Returns: the number of decimal places used.

Definition at line 83 of file AngleSpinBox.hpp.

DisplayFormat AngleSpinBox::displayFormat ( )

inline

Get the current display format.

Returns: the current DisplayFormat.

Definition at line 91 of file AngleSpinBox.hpp.

double AngleSpinBox::getMaximum ( const bool isDegrees )

inline

Get the maximum value.

Returns: the current maximum value

Parameters

isDegrees true if the maximum value is required in degrees, else max is returned as radians.

Definition at line 117 of file AngleSpinBox.hpp.

double AngleSpinBox::getMinimum ( const bool isDegrees )

inline

Get the minimum value.

Returns: the current minimum value

Parameters

isDegrees true if the minimum value is required in degrees, else min is returned as radians.

Definition at line 108 of file AngleSpinBox.hpp.

PrefixType AngleSpinBox::prefixType ( )

inline

Get the current display format.

Returns: the current DisplayFormat.

Definition at line 99 of file AngleSpinBox.hpp.

void AngleSpinBox::setDecimals ( int places )

inline

Set the number of decimal places to express float values to (e.g.

seconds in DMSLetters format).

Parameters

places the number of decimal places to use.

Definition at line 79 of file AngleSpinBox.hpp.

void AngleSpinBox::setDegrees ( double degrees )

slot

Set the value of the spin box in decimal degrees.

Parameters

degrees the value to set, in decimal degrees.

void AngleSpinBox::setDisplayFormat ( DisplayFormat format )

inline

Set the display format.

Parameters

format the new format to use.

Definition at line 87 of file AngleSpinBox.hpp.

void AngleSpinBox::setMaximum	(	const double	max,
		const bool	isDegrees = `false`
	)

inline

Set the maximum value.

Parameters

max	the new maximum value
isDegrees	true if the new maximum value is given in degrees, else max is understood as radians.

Definition at line 113 of file AngleSpinBox.hpp.

void AngleSpinBox::setMinimum	(	const double	min,
		const bool	isDegrees = `false`
	)

inline

Set the minimum value.

Parameters

min	the new minimum value
isDegrees	true if the new minimum value is given in degrees, else min is understood as radians.

Definition at line 104 of file AngleSpinBox.hpp.

void AngleSpinBox::setPrefixType ( PrefixType prefix )

inline

Set the prefix type.

Parameters

prefix the new prefix type to use.

Definition at line 95 of file AngleSpinBox.hpp.

void AngleSpinBox::setRadians ( double radians )

slot

Set the value of the spin box in radians.

Parameters

radians the value to set, in radians.

void AngleSpinBox::valueChanged ( )

signal

Emitted when the value changes.

double AngleSpinBox::valueDegrees ( )

Get the angle held in the AngleSpinBox.

Returns: the angle in degrees

double AngleSpinBox::valueRadians ( )

Get the angle held in the AngleSpinBox.

Returns: the angle in radians

The documentation for this class was generated from the following file:

/home/aw/devel/stellarium/0.15/src/gui/AngleSpinBox.hpp

Public Types

Public Slots

Signals

Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

Member Function Documentation