hdi::core::DashStyleMapPref Class Reference

Allows for storage of dash style maps. More...

#include <hdicoreDashStyleMapPref.h>

Inheritance diagram for hdi::core::DashStyleMapPref:

Collaboration diagram for hdi::core::DashStyleMapPref:

Public Member Functions
	DashStyleMapPref ()
	Constructs an empty DashStyleMapPref object.
	DashStyleMapPref (const DashStyleMapPref &ds_)
	Constructs a new DashStyleMapPref object from an existing DashStyleMapPref object (copy constructor)
	DashStyleMapPref (const DashStyle::Map &value_, const std::string &name_="")
	Constructs a DashStyleMapPref object, with new data, to be added to a container at a later time.
virtual	~DashStyleMapPref ()
	Destructs a DashStyleMapPref object.
virtual DashStyleMapPref &	operator= (const DashStyleMapPref &rhs_)
	Allows one DashStyleMapPref object to be assigned from another.
virtual DashStyleMapPref *	clone () const
	Convenience method to clone an DashStyleMapPref object on the heap.
virtual Type	dataType () const
	Gets the type of persistent data.
virtual DashStyle::Map	dashStyleMap () const
	Gets the dash style map value for this object.
virtual bool	setDashStyleMap (const DashStyle::Map &value_)
	Sets the dash style map value for this object.
Public Member Functions inherited from hdi::core::PrefData
	PrefData ()
	Constructs an empty PrefData object.
virtual	~PrefData ()
	Destructs a PrefData object.
virtual PrefData &	operator= (const PrefData &rhs_)
	Allows one PrefData object to be assigned from another.
virtual PrefData *	clone () const =0
	Convenience method to clone a PrefData object, taking its subclass type into account for proper memory management.
virtual bool	isEmpty () const
	Gets whether the target PrefData object is empty (constructed with the default ctor)
virtual bool	operator== (const PrefData &rhs_) const
	Tests whether a given PrefData object is the same as another.
virtual bool	operator!= (const PrefData &rhs_) const
	Tests whether a given PrefData object is not the same as another.
virtual Type	dataType () const
	Gets the type of persistent data.
virtual std::string	key () const
	Gets the persistent data object's key.
virtual void	setKey (const std::string &key_)
	Sets the persistent data object's key.
virtual std::string	stringify () const
	Recursively serializes the target object as a JSON data (sub)tree, returning the appropriate JSON string.

Friends
class	StrokeStyleMapPref

Additional Inherited Members
Public Types inherited from hdi::core::PrefData
enum	Type {   UnknownType = 0 , ArrayType = 10 , ArtboardPointType = 20 , ArtboardRectType = 30 ,   ArtColorType = 40 , BoolType = 50 , ColorType = 60 , DashStyleType = 70 ,   DashStyleMapType = 80 , DictionaryType = 90 , FillStyleType = 100 , FillStyleMapType = 110 ,   FontType = 120 , NumberType = 130 , PathType = 140 , PathStyleType = 150 ,   PathStyleMapType = 160 , PointType = 170 , RectType = 180 , SizeType = 190 ,   StringType = 200 , StrokeStyleType = 210 , StrokeStyleMapType = 220 , TransformMatrixType = 230 ,   CustomTypeOffset = 10000 }
	Describes the type of the data the PrefData object contains; useful for determining which subclass to cast a PrefData object to.
Static Public Member Functions inherited from hdi::core::PrefData
static std::unique_ptr< PrefData >	parse (const std::string &jsonStr_)
	Parses the given JSON string to a best-fit representation of PrefData subclass objects in a tree.
Protected Member Functions inherited from hdi::core::PrefData
void *	__impl () const
	Internal use only.
	PrefData (plat::PersistentData *&)
	Internal use only.
	PrefData (const PrefData &data_)
	Constructs a new PrefData object from an existing PrefData object (copy constructor)
Protected Attributes inherited from hdi::core::PrefData
void *	_data
	Private implementation data.

Detailed Description

Allows for storage of dash style maps.

Constructor & Destructor Documentation

DashStyleMapPref() [1/3]

hdi::core::DashStyleMapPref::DashStyleMapPref

(

)

Constructs an empty DashStyleMapPref object.

Author

GW

Date

11/2015

Note

To test if a DashStyleMapPref object is empty, call isEmpty() on it

Empty DashStyleMapPref objects do not relate to any actual preference data; they are designed to be "receivers" of some other DashStyleMapPref object via the overloaded assignment operator. Empty DashStyleMapPref objects are useless until such time (though it is safe to call any of their methods)

DashStyleMapPref() [2/3]

hdi::core::DashStyleMapPref::DashStyleMapPref

(

const DashStyleMapPref &

ds_

)

Constructs a new DashStyleMapPref object from an existing DashStyleMapPref object (copy constructor)

Author

GW

Date

11/2015

Parameters

ds_	Existing DashStyleMapPref object

DashStyleMapPref() [3/3]

hdi::core::DashStyleMapPref::DashStyleMapPref	(	const DashStyle::Map &	value_,
		const std::string &	name_ = ""
	)

Constructs a DashStyleMapPref object, with new data, to be added to a container at a later time.

Author

GW

Date

11/2015

Parameters

value_	Initial dash style map value
name_	Name for the data once it has been added to its container, as UTF-8

Note

The name_ argument can only be "" (omitted) if the object will be added directly to an ArrayPref object.

~DashStyleMapPref()

virtual hdi::core::DashStyleMapPref::~DashStyleMapPref ( )

virtual

Destructs a DashStyleMapPref object.

Author

GW

Date

11/2015

Member Function Documentation

clone()

virtual DashStyleMapPref * hdi::core::DashStyleMapPref::clone ( ) const

virtual

Convenience method to clone an DashStyleMapPref object on the heap.

Author

GW

Date

11/2015

Returns

A pointer to the new DashStyleMapPref object

Note

If you subclass DashStyleMapPref, you MUST overload this method yourself! If you don't and/or your clone() method does not return an instance of your DashStyleMapPref subclass, you will experience "object slicing" when adding the pref to a container.

Warning

The caller must manage the memory for the returned DashStyleMapPref object.

Implements hdi::core::PrefData.

dashStyleMap()

virtual DashStyle::Map hdi::core::DashStyleMapPref::dashStyleMap ( ) const

virtual

Gets the dash style map value for this object.

Author

GW

Date

11/2015

Returns

The dash style map value being described by this wrapper

dataType()

virtual Type hdi::core::DashStyleMapPref::dataType ( ) const

virtual

Gets the type of persistent data.

Author

GW

Date

11/2015

Returns

DashStyleMapType

Note

This is useful for knowing how to cast a PrefData object to its proper subclass

Reimplemented from hdi::core::PrefData.

operator=()

virtual DashStyleMapPref & hdi::core::DashStyleMapPref::operator= ( const DashStyleMapPref &  rhs_ )

virtual

Allows one DashStyleMapPref object to be assigned from another.

Author

GW

Date

11/2015

Parameters

rhs_	Righthand side of the = operator; the object to copy values from

Returns

The target DashStyleMapPref object, but with its value updated to match that of rhs_

setDashStyleMap()

virtual bool hdi::core::DashStyleMapPref::setDashStyleMap ( const DashStyle::Map &  value_ )

virtual

Sets the dash style map value for this object.

Author

GW

Date

11/2015

Parameters

value_

New dash style map value

Returns

true if the dash style map is successfully updated, or false otherwise