OCC Main Page | DataExchange | Toolkits | Packages | Class Hierarchy | Data Structures | File List | Data Fields | Globals

DataExchange
TKXSBase
MoniTool


MoniTool_Option Class Reference

An Option gives a way of recording an enumerated list of
instances of a given class, each instance being identified
by a case name.

Also, an Option allows to manage basic types through a Typed
Value (which also applies to Static Parameter). It may record
an enumerated list of values for a TypedValue or Static
Parameter, each of them is recorded as a string (HAsciiString)

An Option is defined by the type of the class to be optioned,
or (mutually exclusive) the TypedValue/Static of which values
are to be optioned, a specific name, a list of named values.
It brings a current case with its name and value
It may also have a default case (the first recorded one if not
precised)

An Option may be created from another one, by sharing its Type
and its list of Items (one per case), with the same name or
another one. It may then be duplicated to break this sharing.
.

#include <MoniTool_Option.hxx>


Public Member Functions

Standard_EXPORT MoniTool_Option (const Handle(Standard_Type)&atype, const Standard_CString aname)
 Creates an Option from scratch, with a Type and a Name
.
Standard_EXPORT MoniTool_Option (const Handle(MoniTool_TypedValue)&aval, const Standard_CString aname="")
 Creates an Option for a TypedValue (for basic, non-cdl-typed,
value : integer, real, string ...)
If <name> is not given, the name of the TypedValue is taken
Remark that Type is then enforced to TCollection_HAsciiString
.
Standard_EXPORT MoniTool_Option (const Handle(MoniTool_Option)&other, const Standard_CString aname="")
 Creates an Option from another one, the name can be redefined
The Type remains the same. The list of Items, too, it can also
be later duplicated by call to Duplicate
.
Standard_EXPORT Standard_Boolean Add (const Standard_CString name, const Handle(Standard_Transient)&val)
 Adds an item : value and name (replaces it if name is already
recorded)
Returns True when done, False if <val> is not Kind of the
definition Type
For a TypedValue, val must be a HAsciiString, its content must
satisfy the definition of the TypedValue
.
Standard_EXPORT Standard_Boolean AddBasic (const Standard_CString name, const Standard_CString val="")
 Short-cut to add an item for a TypedValue (basic type) : name
is the name of the case, val is its value as a CString
If val is not provided, val = name is assumed
Returns True when done, False if this Option is not for a
TypedValue or if the new value does not satisfy the definition
of the TypedValue
.
Standard_EXPORT void Duplicate ()
 Duplicates the list of items
It starts with the same definitions as before Duplicate, but
it is not longer shared with other options
.
Standard_EXPORT const TCollection_AsciiString & Name () const
 Returns the Name of the Option
.
Standard_EXPORT Handle_Standard_Type Type () const
 Returns the Type of the Option
.
Standard_EXPORT Handle_MoniTool_TypedValue TypedValue () const
 Returns the TypedValue of the Option, or a Null Handle
.
Standard_EXPORT Standard_Boolean Item (const Standard_CString name, Handle(Standard_Transient)&val) const
 Gives the value bound with a name, in val
Returns True if <name> is found, False else
This way of returning a Transient, bound with the Type Control
avoids DownCast and ensures the value is directly usable
.
Standard_EXPORT Handle_TColStd_HSequenceOfAsciiString ItemList () const
 Returns the list of available item names
.
Standard_EXPORT Handle_TColStd_HSequenceOfAsciiString Aliases (const Standard_CString name, const Standard_Boolean exact=Standard_True) const
 Returns the list of cases, other than <name>, which bring the
same value as <name>
Empty list (not a Null Handle) if no alias, or <name> unknown
if <exact> is True (D), exact name is required, no completion
if <exact> is False and <name> is not complete, but addresses
only one item, completion is done and the list includes the
complete name
.
Standard_EXPORT Standard_Boolean Switch (const Standard_CString name)
 Commands the Option to switch on an item name
Returns True when done, False if <name> is not recorded
(in that case, former switch remains unchanged)
If no switch has been called, it is active on the last added
items
.
Standard_EXPORT const TCollection_AsciiString & CaseName () const
 Returns the Name of the currently switched item (Case)
.
Standard_EXPORT Handle_Standard_Transient CaseValue () const
 Returns the Value of the currently switch item
To be down-casted as needed before use
.
Standard_EXPORT void Value (Handle(Standard_Transient)&val) const
 Returns the Value of the currently switch item
This way of returning a Transient, bound with the Type Control
avoids DownCast and ensures the value is directly usable
For a TypedValue, returns the corresponding HAsciiString
.
Standard_EXPORT const Handle (Standard_Type)&DynamicType() const

Private Member Functions

Standard_EXPORT Handle_Dico_DictionaryOfTransient Items () const
 Returns the list of items, to be shared (to copy an option)
.

Private Attributes

TCollection_AsciiString thename
Handle_Standard_Type thetype
Handle_MoniTool_TypedValue thevalue
Handle_Dico_DictionaryOfTransient theitems
TCollection_AsciiString thecase
Handle_Standard_Transient theval


Constructor & Destructor Documentation

Standard_EXPORT MoniTool_Option::MoniTool_Option const Handle(Standard_Type)&  atype,
const Standard_CString  aname
 

Standard_EXPORT MoniTool_Option::MoniTool_Option const Handle(MoniTool_TypedValue)&  aval,
const Standard_CString  aname = ""
 

Standard_EXPORT MoniTool_Option::MoniTool_Option const Handle(MoniTool_Option)&  other,
const Standard_CString  aname = ""
 


Member Function Documentation

Standard_EXPORT Standard_Boolean MoniTool_Option::Add const Standard_CString  name,
const Handle(Standard_Transient)&  val
 

Standard_EXPORT Standard_Boolean MoniTool_Option::AddBasic const Standard_CString  name,
const Standard_CString  val = ""
 

Standard_EXPORT Handle_TColStd_HSequenceOfAsciiString MoniTool_Option::Aliases const Standard_CString  name,
const Standard_Boolean  exact = Standard_True
const
 

Standard_EXPORT const TCollection_AsciiString& MoniTool_Option::CaseName  )  const
 

Standard_EXPORT Handle_Standard_Transient MoniTool_Option::CaseValue  )  const
 

Standard_EXPORT void MoniTool_Option::Duplicate  ) 
 

Standard_EXPORT const MoniTool_Option::Handle Standard_Type   )  const
 

Standard_EXPORT Standard_Boolean MoniTool_Option::Item const Standard_CString  name,
Handle(Standard_Transient)&  val
const
 

Standard_EXPORT Handle_TColStd_HSequenceOfAsciiString MoniTool_Option::ItemList  )  const
 

Standard_EXPORT Handle_Dico_DictionaryOfTransient MoniTool_Option::Items  )  const [private]
 

Standard_EXPORT const TCollection_AsciiString& MoniTool_Option::Name  )  const
 

Standard_EXPORT Standard_Boolean MoniTool_Option::Switch const Standard_CString  name  ) 
 

Standard_EXPORT Handle_Standard_Type MoniTool_Option::Type  )  const
 

Standard_EXPORT Handle_MoniTool_TypedValue MoniTool_Option::TypedValue  )  const
 

Standard_EXPORT void MoniTool_Option::Value Handle(Standard_Transient)&  val  )  const
 


Field Documentation

TCollection_AsciiString MoniTool_Option::thecase [private]
 

Handle_Dico_DictionaryOfTransient MoniTool_Option::theitems [private]
 

TCollection_AsciiString MoniTool_Option::thename [private]
 

Handle_Standard_Type MoniTool_Option::thetype [private]
 

Handle_Standard_Transient MoniTool_Option::theval [private]
 

Handle_MoniTool_TypedValue MoniTool_Option::thevalue [private]
 


The documentation for this class was generated from the following file:
Generated on Mon Aug 25 14:41:40 2008 for OpenCASCADE by  doxygen 1.4.1