Classe per la gestione di uno slider di selezione per l'impostazione di un orario generico. More...

#include <Slider.h>

Collaboration diagram for Slider:

Public Types
enum class	TimeFormat { _12HOURS , _24HOURS , INVALID_REFERENCE }
	Enumerazione per la gestione del formato di visualizzazione dell'ora corrente. More...

enum class	TimePeriod { NOT_USED , AM , PM }
	Enumerazione per la gestione del periodo durante la visualizzazione dell'ora corrente. More...

Static Public Member Functions
static bool	Init (const TimeFormat &t_Format)
	Metodo di inizializzazione dei componenti della classe.

static unsigned int	get_Hour ()
	Permette di ottenere il valore dell'ora 'h' impostata nello slider.

static unsigned int	get_Minute ()
	Permette di ottenere il valore dell'ora 'm' impostata nello slider.

static const TimePeriod	get_Period ()
	Permette di ottenere il valore del periodo impostato nello slider.

static const TimeFormat	get_Format ()
	Permette di ottenere il valore del formato impostato nello slider.

static const String	get_SliderValue ()
	Permette di ottenere il valore corrente dello slider 'hh:mm periodo se in uso'.

static bool	set_SliderValue (const String &t_SliderValue, const TimePeriod &t_Period=Slider::TimePeriod::NOT_USED)
	Permette di impostare il valore dello slider.

static bool	inc_Hour ()
	Incrementa di una unità (1) il valore dell'ora 'h' impostata nello slider.

static bool	inc_Minute ()
	Incrementa di una unità (1) il valore dell'ora 'm' impostata nello slider.

static bool	ChangeFormat (const TimeFormat &t_Format)
	Permette di cambiare il formato di visualizzazione e impostazione dell'ora 'h' e 'm' impostata nella sveglia.

static const int &	get_Invalidator ()
	Permette di ottenere l'invalidatore della classe.

Private Member Functions
	Slider ()=default
	Costruttore di default della classe Slider.

	~Slider ()=default
	Distruttore della classe Slider.

Static Private Attributes
static unsigned int	m_Hour

static unsigned int	m_Minute

static TimeFormat	m_Format

static TimePeriod	m_Period

static bool	m_isReady

static const int	m_Invalidator = Slider__file::_invalidvalue

Detailed Description

Classe per la gestione di uno slider di selezione per l'impostazione di un orario generico.

La seguente classe fornisce tutti i metodi necessari alla gestione di uno slider di selezione per l'impostazione di un orario generico

Definition at line 80 of file Slider.h.

Member Enumeration Documentation

◆ TimeFormat

enum class Slider::TimeFormat

strong

Enumerazione per la gestione del formato di visualizzazione dell'ora corrente.

Formati disponibili: 12 ORE 24 ORE

Enumerator
_12HOURS
_24HOURS
INVALID_REFERENCE

Definition at line 126 of file Slider.h.

◆ TimePeriod

enum class Slider::TimePeriod

strong

Enumerazione per la gestione del periodo durante la visualizzazione dell'ora corrente.

Stati possibili: NOT_USED Il periodo non � in uso AM Il periodo � impostato sullo stato AM (Ante Meridiem) PM Il periodo � impostato sullo stato PM (Post Meridiem)

Enumerator
NOT_USED
AM
PM

Definition at line 143 of file Slider.h.

Constructor & Destructor Documentation

◆ Slider()

Slider::Slider ( )

privatedefault

Costruttore di default della classe Slider.

Costruttore di default equivalente al costruttore trivial della seguente classe. Il seguente costruttore non sar� accessibile durante l'utilizzo della classe.

◆ ~Slider()

Slider::~Slider ( )

privatedefault

Distruttore della classe Slider.

Distruttore equivalente al distruttore trivial della seguente classe. Il seguente distruttore non sar� accessibile durante l'utilizzo della classe.

Member Function Documentation

◆ ChangeFormat()

bool Slider::ChangeFormat ( const TimeFormat & t_Format )

static

Permette di cambiare il formato di visualizzazione e impostazione dell'ora 'h' e 'm' impostata nella sveglia.

Questo metodo permette di cambiare il formato di visualizzazione e impostazione dell'ora impostata nella sveglia. Gestisce ed ignora eventuali operazioni ridondanti Gestisce tutte le conversioni necessarie durante il cambio di formato

Parameters

[in] t_Format Il nuovo valore da assegnare al formato dello slider

Precondition: L'inizializzazione della classe deve essere già stata eseguita.

Returns: Un valore booleano indicante la corretta eseguzione dell'operazione di assegnamento del formato dello slider

Return values

true	Operazione di assegnamento del formato dello slider eseguito correttamente
false	Errore durante l'operazione di assegnamento del formato dello slider

See also: m_isReady; m_Hour; m_Minute; m_Format; Slider::TimePeriod (m_Period)

Definition at line 257 of file Slider.cpp.

◆ get_Format()

const Slider::TimeFormat Slider::get_Format ( )

static

Permette di ottenere il valore del formato impostato nello slider.

Questo metodo permette di ottenere come valore di ritorno il valore del formato impostato nello slider

Precondition: L'inizializzazione della classe deve essere già stata eseguita.

Returns: Il valore del formato impostato nello slider

See also: m_isReady; m_Format; m_Invalidator

Definition at line 69 of file Slider.cpp.

◆ get_Hour()

unsigned int Slider::get_Hour ( )

static

Permette di ottenere il valore dell'ora 'h' impostata nello slider.

Questo metodo permette di ottenere come valore di ritorno il valore dell'ora 'h' impostata nello slider

Precondition: L'inizializzazione della classe deve essere già stata eseguita.

Returns: Il valore dell'ora 'h' impostata nello slider

See also: m_isReady; m_Hour; m_Invalidator

Definition at line 42 of file Slider.cpp.

◆ get_Invalidator()

const int & Slider::get_Invalidator ( )

inlinestatic

Permette di ottenere l'invalidatore della classe.

Questo metodo permette di ottenere come valore di ritorno il valore dell'invalidatore utilizzato per questa classe. Questo valore dovrebbe essere usato in confronti con i valori di ritorno dei metodi getter per controllare l'eventuale presenza di errori.

Returns: L'invalidatore della classe Slider

See also: Slider::m_Invalidator

Definition at line 319 of file Slider.cpp.

◆ get_Minute()

unsigned int Slider::get_Minute ( )

static

Permette di ottenere il valore dell'ora 'm' impostata nello slider.

Questo metodo permette di ottenere come valore di ritorno il valore dell'ora 'm' impostata nello slider

Precondition: L'inizializzazione della classe deve essere già stata eseguita.

Returns: Il valore dell'ora 'm' impostata nello slider

See also: m_isReady; m_Minute; m_Invalidator

Definition at line 51 of file Slider.cpp.

◆ get_Period()

const Slider::TimePeriod Slider::get_Period ( )

static

Permette di ottenere il valore del periodo impostato nello slider.

Questo metodo permette di ottenere come valore di ritorno il valore del periodo impostato nello slider

Precondition: L'inizializzazione della classe deve essere già stata eseguita.

Returns: Il valore del periodo impostato nello slider

See also: m_isReady; m_Period; m_Invalidator

Definition at line 60 of file Slider.cpp.

◆ get_SliderValue()

const String Slider::get_SliderValue ( )

static

Permette di ottenere il valore corrente dello slider 'hh:mm periodo se in uso'.

Questo metodo permette di ottenere come valore di ritorno il valore corrente dello slider

Precondition: L'inizializzazione della classe deve essere già stata eseguita.

Returns: Il valore corrente dello slider

See also: m_isReady; m_Hour; m_Minute; m_Format; m_Period; m_Invalidator

Definition at line 78 of file Slider.cpp.

◆ inc_Hour()

bool Slider::inc_Hour ( )

inlinestatic

Incrementa di una unità (1) il valore dell'ora 'h' impostata nello slider.

Questo metodo incrementa di una unità (1) il valore dell'ora 'h' impostata nello slider. Gestisce il riavvolgimento oltre il limite, in base al formato dell'ora

Precondition: L'inizializzazione della classe deve essere già stata eseguita.

Returns: Un valore booleano indicante la corretta o errata esecuzione del processo di incremento dell'ora 'h' impostata nello slider

Return values

true	Processo di incremento dell'ora 'h' impostata nello slider eseguito correttamente
false	Errore durante il processo di incremento dell'ora 'h' impostata nello slider

See also: m_isReady; m_Hour; Slider::TimeFormat; Slider::TimePeriod

Definition at line 205 of file Slider.cpp.

◆ inc_Minute()

bool Slider::inc_Minute ( )

inlinestatic

Incrementa di una unità (1) il valore dell'ora 'm' impostata nello slider.

Questo metodo incrementa di una unità (1) il valore dell'ora 'm' impostata nello slider. Gestisce il riavvolgimento oltre il limite

Precondition: L'inizializzazione della classe deve essere già stata eseguita.

Returns: Un valore booleano indicante la corretta o errata esecuzione del processo di incremento dell'ora 'm' impostata nello slider

Return values

true	Processo di incremento dell'ora 'm' impostata nello slider eseguita correttamente
false	Errore durante il processo di incremento dell'ora 'm' impostata nello slider

See also: m_isReady; m_Minute; Slider::TimeFormat; Slider::TimePeriod

Definition at line 241 of file Slider.cpp.

◆ Init()

bool Slider::Init ( const TimeFormat & t_Format )

static

Metodo di inizializzazione dei componenti della classe.

Questo metodo inizializza tutti i componenti della classe. Non presentando alcun riferimento ad oggetti esterni o strettamente correlati, non occorre alcuna allocazione e gestione della memoria. Verranno solamente inizializzati i valori degli attributi al valore di default e verrà informato il sistema dell'inizializzazione. Usare il seguente metodo anche per un reset dello slider.

Returns: Un valore booleano per comunicare la corretta o errata inizializzazione

Return values

true	Inizializzazione correttamente eseguita
false	Errore durante l'inizializzazione

Note: Questo è il primo metodo da richiamare per iniziare ad utilizzare la classe; Come funzione di "reset", utilizzare il seguente metodo rieseguendo una inizializzazione

See also: m_isReady; m_Hour; m_Minute; Slider::TimeFormat; Slider::TimePeriod

Definition at line 15 of file Slider.cpp.

◆ set_SliderValue()

bool Slider::set_SliderValue	(	const String &	t_SliderValue,
		const TimePeriod &	t_Period = `Slider::TimePeriod::NOT_USED`
	)

static

Permette di impostare il valore dello slider.

Questo metodo permette di impostare il valore dello slider, data come parametro una stringa con un formato fisso presentato di seguito E' necessario specificare anche il periodo per i valori di ora in formato 12h

Parameters

[in]	t_SliderValue	Il nuovo valore dello slider da impostare
[in]	t_Period	Se necessario, il valore del periodo dell'ora (solo per il formato 12h)

Precondition: L'inizializzazione della classe deve essere già stata eseguita.

Warning: Il formato della stringa è: "hh:mmperiod (facoltativo)". La maggior parte di altri formati verranno scartati, ma alcuni potrebbero causare comportamenti e risposte indefinite da parte del programma.

Returns: Un valore booleano per segnalare la corretta o errata esecuzione del processo di assegnazione

Return values

true	Processo di assegnazione eseguito correttamente
false	Errore durante il processo di assegnazione

See also: m_isReady; m_Hour; m_Minute; Slider::TimeFormat; Slider::TimePeriod

Definition at line 148 of file Slider.cpp.

Member Data Documentation

◆ m_Format

Slider::TimeFormat Slider::m_Format

staticprivate

Rappresenta il formato dell'ora impostato

See also: Slider::TimeFormat

Definition at line 160 of file Slider.h.

◆ m_Hour

unsigned int Slider::m_Hour

staticprivate

Rappresenta il valore dell'ora formato: 'h'

Definition at line 153 of file Slider.h.

◆ m_Invalidator

const int Slider::m_Invalidator = Slider__file::_invalidvalue

staticprivate

Rappresenta l'invalidatore della classe Slider

Definition at line 373 of file Slider.h.

◆ m_isReady

bool Slider::m_isReady

staticprivate

Rappresenta lo stato di inizializzazione della classe

Definition at line 167 of file Slider.h.

◆ m_Minute

unsigned int Slider::m_Minute

staticprivate

Rappresenta il valore dell'ora formato: 'm'

Definition at line 156 of file Slider.h.

◆ m_Period

Slider::TimePeriod Slider::m_Period

staticprivate

Rappresenta il periodo dell'ora impostato

See also: Slider::TimePeriod

Definition at line 164 of file Slider.h.

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

C:/RadioSvegliaGBE/PartialSourceCode/src/Slider/src/Slider.h
C:/RadioSvegliaGBE/PartialSourceCode/src/Slider/src/Slider.cpp

Public Types

Static Public Member Functions

Private Member Functions

Static Private Attributes

Detailed Description

Member Enumeration Documentation

◆ TimeFormat

◆ TimePeriod

Constructor & Destructor Documentation

◆ Slider()

◆ ~Slider()

Member Function Documentation

◆ ChangeFormat()

◆ get_Format()

◆ get_Hour()

◆ get_Invalidator()

◆ get_Minute()

◆ get_Period()

◆ get_SliderValue()

◆ inc_Hour()

◆ inc_Minute()

◆ Init()

◆ set_SliderValue()

Member Data Documentation

◆ m_Format

◆ m_Hour

◆ m_Invalidator

◆ m_isReady

◆ m_Minute

◆ m_Period