Base class for properties. More...

#include <Property.h>

Inheritance diagram for Mantid::Kernel::Property:

Public Member Functions
virtual std::vector< std::string >	allowedValues () const
	Returns the set of valid values for this property, if such a set exists.

bool	autoTrim () const
	Returns if the property is set to automatically trim string unput values of whitespace.

void	clearSettings ()
	Deletes the PropertySettings object contained.

virtual Property *	clone () const =0
	'Virtual copy constructor'

virtual const PropertyHistory	createHistory () const
	Create a PropertyHistory object representing the current state of the Property.

void	createTemporaryValue ()
	Create a temporary value for this property.

unsigned int	direction () const
	returns the direction of the property

bool	disableReplaceWSButton () const
	Returns if the property is set to disable the creation of the "Replace Workspace" button.

const std::string &	documentation () const
	Get the property's documentation string.

virtual std::string	getDefault () const =0
	Get the default value for the property which is the value the property was initialised with.

const std::string &	getGroup ()

virtual size_t	getMemorySize () const

IPropertySettings *	getSettings ()

const IPropertySettings *	getSettings () const

bool	hasTemporaryValue () const
	Property is using a temporary value for this property.

virtual bool	isDefault () const =0
	Overriden function that returns if property has the same value that it was initialised with, if applicable.

bool	isDynamicDefault () const
	Returns a flag indicating that the property's value has been set programmatically, for example, if the property has a default value which depends on the value of an upstream property.

virtual bool	isMultipleSelectionAllowed ()
	Is Multiple Selection Allowed.

virtual std::string	isValid () const
	Overridden function that checks whether the property, if not overriden returns "".

virtual bool	isValueSerializable () const
	Whether the string returned by value() can be used for serialization.

virtual Property &	merge (Property *)
	Just returns the property (*this) unless overridden.

const std::string &	name () const
	Get the property's name.

virtual Property &	operator+= (Property const *rhs)=0
	Add to this.

bool	remember () const
	Whether to save input values.

virtual void	saveProperty (Nexus::File *)

void	setAutoTrim (const bool &setting)
	Sets if the property is set to automatically trim string unput values of whitespace.

virtual std::string	setDataItem (const std::shared_ptr< DataItem > &)=0
	Set the value of the property via a DataItem pointer.

void	setDisableReplaceWSButton (const bool &disable)
	Sets the property to disable the creation of the "Replace Workspace" button.

void	setDocumentation (const std::string &documentation)
	Sets the user level description of the property.

void	setGroup (const std::string &group)
	Set the group this property belongs to.

void	setIsDynamicDefault (const bool &flag)
	Set or clear the flag indicating whether or not the property's value has been set programmatically.

void	setName (const std::string &name)
	Set the property's name.

void	setRemember (bool)
	Set wheter to remeber this property input.

void	setSettings (std::unique_ptr< IPropertySettings > settings)
	Set the PropertySettings object.

virtual void	setUnits (const std::string &unit)
	Sets the units of the property, as a string.

virtual std::string	setValue (const std::string &)=0
	Set the value of the property via a string.

virtual std::string	setValueFromJson (const Json::Value &)=0
	Set the value of the property via a Json object.

virtual std::string	setValueFromProperty (const Property &right)=0
	Set the value of the property via a reference to another property.

virtual int	size () const
	Return the size of this property.

const std::string	type () const
	Returns the type of the property as a string.

const std::type_info *	type_info () const
	Get the property type_info.

virtual const std::string &	units () const
	Returns the units of the property, if any, as a string.

virtual std::string	value () const =0
	Returns the value of the property as a string.

virtual Json::Value	valueAsJson () const =0
	Returns the value of the property as a Json::Value.

virtual std::string	valueAsPrettyStr (const size_t maxLength=0, const bool collapseLists=true) const
	Returns the value of the property as a pretty printed string.

virtual	~Property ()
	Virtual destructor.

Protected Member Functions
	Property (const Property &right)
	Copy constructor.

	Property (std::string name, const std::type_info &type, const unsigned int &direction=Direction::Input)
	Constructor.

Protected Attributes
std::string	m_name
	The name of the property.

Private Member Functions
Property &	operator= (const Property &right)
	Private, unimplemented copy assignment operator.

	Property ()
	Private default constructor.

Private Attributes
bool	m_autotrim
	Flag to determine if string inputs to the property should be automatically trimmed of whitespace.

const unsigned int	m_direction
	Whether the property is used as input, output or both to an algorithm.

bool	m_disableReplaceWSButton
	Flag to disable the generation of the "Replace Workspace" button on the OutputWorkspace property.

std::string	m_documentation
	Longer, optional description of property.

std::string	m_group
	Name of the "group" of this property, for grouping in the GUI. Default "".

bool	m_isDynamicDefault
	Flag to indicate that the property's value has been set programmatically, for example, when a default value is dynamic and depends on an upstream property.

bool	m_remember
	Flag whether to save input values.

std::unique_ptr< IPropertySettings >	m_settings
	Property settings (enabled/visible)

const std::type_info *	m_typeinfo
	The type of the property.

std::string	m_units
	Units of the property (optional)

Detailed Description

Base class for properties.

Allows access without reference to templated concrete type.

Author: Russell Taylor, Tessella Support Services plc; Based on the Gaudi class of the same name (see http://proj-gaudi.web.cern.ch/proj-gaudi/)

Date: 13/11/2007

Definition at line 94 of file Property.h.

Constructor & Destructor Documentation

◆ ~Property()

Mantid::Kernel::Property::~Property ( )

virtualdefault

Virtual destructor.

◆ Property() [1/3]

Mantid::Kernel::Property::Property	(	std::string	name,
		const std::type_info &	type,
		const unsigned int &	direction = `Direction::Input`
	)

protected

Constructor.

Parameters

name	:: The name of the property
type	:: The type of the property
direction	:: Whether this is a Direction::Input, Direction::Output or Direction::InOut (Input & Output) property

Exceptions

std::invalid_argument if the name is empty

Definition at line 29 of file Property.cpp.

References m_direction, and m_name.

◆ Property() [2/3]

Mantid::Kernel::Property::Property ( const Property & right )

protected

Copy constructor.

Definition at line 43 of file Property.cpp.

References m_name, m_settings, and right.

◆ Property() [3/3]

Mantid::Kernel::Property::Property ( )

private

Private default constructor.

Member Function Documentation

◆ allowedValues()

std::vector< std::string > Mantid::Kernel::Property::allowedValues ( ) const

virtual

Returns the set of valid values for this property, if such a set exists.

If not, it returns an empty set.

Returns: the set of valid values for this property or an empty set

Definition at line 152 of file Property.cpp.

Referenced by MantidQt::API::PropertyWidgetFactory::createWidget(), MantidQt::CustomDialogs::LoadDialog::createWidgetsForProperty(), export_Property(), MantidQt::CustomDialogs::FitDialog::getAllowedPropertyValues(), MantidQt::CustomDialogs::LoadRawDialog::initLayout(), MantidQt::API::ListPropertyWidget::ListPropertyWidget(), and MantidQt::API::OptionsPropertyWidget::OptionsPropertyWidget().

◆ autoTrim()

bool Mantid::Kernel::Property::autoTrim ( ) const

Returns if the property is set to automatically trim string unput values of whitespace.

Returns: True/False

Definition at line 355 of file Property.cpp.

References m_autotrim.

Referenced by export_Property(), and Mantid::API::MultipleFileProperty::setValueAsMultipleFiles().

◆ clearSettings()

void Mantid::Kernel::Property::clearSettings ( )

Deletes the PropertySettings object contained.

Definition at line 115 of file Property.cpp.

References m_settings.

◆ clone()

virtual Property * Mantid::Kernel::Property::clone ( ) const

pure virtual

'Virtual copy constructor'

Referenced by Mantid::Algorithms::SampleLogsBehaviour::addPropertyForList(), Mantid::Algorithms::SampleLogsBehaviour::addPropertyForTimeSeries(), Mantid::Kernel::LogParser::createAllPeriodsLog(), Mantid::DataHandling::Load::declareLoaderProperties(), Mantid::PythonInterface::AlgorithmAdapter< BaseAlgorithm >::declarePyAlgProperty(), Mantid::DataHandling::RenameLog::exec(), Mantid::Algorithms::SampleLogsBehaviour::setSampleMap(), Mantid::Algorithms::SampleLogsBehaviour::setUpdatedSampleLogs(), and Mantid::Algorithms::SampleLogsBehaviour::updateTimeSeriesProperty().

◆ createHistory()

const PropertyHistory Mantid::Kernel::Property::createHistory ( ) const

virtual

Create a PropertyHistory object representing the current state of the Property.

Reimplemented in Mantid::API::FunctionProperty, Mantid::API::WorkspaceProperty< TYPE >, and Mantid::Kernel::MaskedProperty< TYPE >.

Definition at line 156 of file Property.cpp.

◆ createTemporaryValue()

void Mantid::Kernel::Property::createTemporaryValue ( )

Create a temporary value for this property.

Creates a temporary property value based on the memory address of the property.

Definition at line 161 of file Property.cpp.

References setValue().

◆ direction()

unsigned int Mantid::Kernel::Property::direction ( ) const

inline

returns the direction of the property

Definition at line 177 of file Property.h.

Referenced by MantidQt::API::PropertyWidget::addReplaceWSButton(), export_Property(), MantidQt::API::haveInputWS(), Mantid::API::FunctionProperty::isValid(), MantidQt::API::PropertyWidget::PropertyWidget(), MantidQt::API::AlgorithmPropertiesWidget::replaceWSClicked(), MantidQt::API::AlgorithmDialog::setAlgorithm(), and Mantid::DataHandling::LoadNexus::setOutputWorkspace().

◆ disableReplaceWSButton()

bool Mantid::Kernel::Property::disableReplaceWSButton ( ) const

Returns if the property is set to disable the creation of the "Replace Workspace" button.

Returns: True/False

Definition at line 368 of file Property.cpp.

References m_disableReplaceWSButton.

◆ documentation()

const std::string & Mantid::Kernel::Property::documentation ( ) const

Get the property's documentation string.

Returns: The documentation string

Definition at line 76 of file Property.cpp.

References m_documentation.

Referenced by MantidQt::MantidWidgets::FitOptionsBrowser::createPropertyProperty(), MantidQt::CustomDialogs::LoadDialog::createWidgetsForProperty(), Mantid::DataHandling::Load::declareLoaderProperties(), export_Property(), MantidQt::API::PropertyWidget::PropertyWidget(), setDocumentation(), and MantidQt::API::AlgorithmDialog::tie().

◆ getDefault()

virtual std::string Mantid::Kernel::Property::getDefault ( ) const

pure virtual

Get the default value for the property which is the value the property was initialised with.

Referenced by MantidQt::API::OptionsPropertyWidget::editingFinished(), export_Property(), MantidQt::API::AlgorithmDialog::getInputValue(), MantidQt::API::PropertyWidget::setPreviousValue(), MantidQt::API::BoolPropertyWidget::setValueImpl(), MantidQt::API::ListPropertyWidget::setValueImpl(), MantidQt::API::OptionsPropertyWidget::setValueImpl(), and MantidQt::API::PropertyWidget::updateIconVisibility().

◆ getGroup()

const std::string & Mantid::Kernel::Property::getGroup ( )

inline

Returns: the group this property belongs to

Definition at line 199 of file Property.h.

Referenced by export_Property().

◆ getMemorySize()

virtual size_t Mantid::Kernel::Property::getMemorySize ( ) const

inlinevirtual

Reimplemented in Mantid::Kernel::TimeSeriesProperty< TYPE >, Mantid::Kernel::TimeSeriesProperty< bool >, Mantid::Kernel::TimeSeriesProperty< double >, Mantid::Kernel::TimeSeriesProperty< HeldType >, and Mantid::Kernel::TimeSeriesProperty< int >.

Definition at line 188 of file Property.h.

◆ getSettings() [1/2]

IPropertySettings * Mantid::Kernel::Property::getSettings ( )

Definition at line 110 of file Property.cpp.

References m_settings.

◆ getSettings() [2/2]

const IPropertySettings * Mantid::Kernel::Property::getSettings ( ) const

Returns: the PropertySettings for this property

Definition at line 109 of file Property.cpp.

References m_settings.

Referenced by Mantid::Kernel::PropertyManager::asJson(), export_Property(), MantidQt::API::AlgorithmPropertiesWidget::hideOrDisableProperties(), and MantidQt::API::AlgorithmPropertiesWidget::isWidgetEnabled().

◆ hasTemporaryValue()

bool Mantid::Kernel::Property::hasTemporaryValue ( ) const

Property is using a temporary value for this property.

Checks if the property value is a temporary one based on the memory address of the property.

Definition at line 171 of file Property.cpp.

◆ isDefault()

virtual bool Mantid::Kernel::Property::isDefault ( ) const

pure virtual

Overriden function that returns if property has the same value that it was initialised with, if applicable.

Referenced by Mantid::Kernel::PropertyManager::asJson(), Mantid::MDAlgorithms::ConvertToMD::buildTargetWSDescription(), Mantid::Kernel::EnabledWhenProperty::checkCriterion(), Mantid::Algorithms::NormaliseToMonitor::checkProperties(), Mantid::CurveFitting::Algorithms::PawleyFit::exec(), Mantid::DataHandling::LoadInstrument::exec(), Mantid::DataHandling::LoadParameterFile::exec(), Mantid::MDAlgorithms::IntegrateEllipsoidsV2::exec(), Mantid::MDAlgorithms::TransposeMD::exec(), Mantid::DataHandling::LoadNexusProcessed::execLoader(), export_Property(), Mantid::Algorithms::Stitch1D::getEndOverlap(), Mantid::Algorithms::Stitch1D::getRebinParams(), Mantid::Algorithms::Stitch1D::getStartOverlap(), Mantid::API::Algorithm::isDefault(), Mantid::DataHandling::LoadILLSANS::loadMetaData(), MantidQt::API::AlgorithmDialog::saveInput(), Mantid::API::BoxControllerSettingsAlgorithm::takeDefaultsFromInstrument(), Mantid::Algorithms::Bin2DPowderDiffraction::validateInputs(), Mantid::Algorithms::NormaliseToMonitor::validateInputs(), and Mantid::MDAlgorithms::IntegrateEllipsoidsV2::validateInputs().

◆ isDynamicDefault()

bool Mantid::Kernel::Property::isDynamicDefault ( ) const

Returns a flag indicating that the property's value has been set programmatically, for example, if the property has a default value which depends on the value of an upstream property.

Definition at line 380 of file Property.cpp.

References m_isDynamicDefault.

Referenced by export_Property(), MantidQt::API::AlgorithmDialog::saveInput(), MantidQt::API::PropertyWidget::setPreviousValue(), MantidQt::API::PropertyWidget::toggleUseHistory(), MantidQt::API::PropertyWidget::transferHistoryState(), and MantidQt::API::PropertyWidget::userEditedProperty().

◆ isMultipleSelectionAllowed()

virtual bool Mantid::Kernel::Property::isMultipleSelectionAllowed ( )

inlinevirtual

Is Multiple Selection Allowed.

Returns: true if multiple selection is allowed

Definition at line 165 of file Property.h.

Referenced by MantidQt::API::PropertyWidgetFactory::createWidget().

◆ isValid()

std::string Mantid::Kernel::Property::isValid ( ) const

virtual

Overridden function that checks whether the property, if not overriden returns "".

Overridden functions checks whether the property has a valid value.

Returns: empty string ""

Definition at line 93 of file Property.cpp.

Referenced by Mantid::API::AlgorithmHasProperty::checkValidity(), export_Property(), and MantidQt::API::AlgorithmDialog::setPropertyValues().

◆ isValueSerializable()

virtual bool Mantid::Kernel::Property::isValueSerializable ( ) const

inlinevirtual

Whether the string returned by value() can be used for serialization.

Reimplemented in Mantid::API::WorkspaceProperty< TYPE >.

Definition at line 143 of file Property.h.

Referenced by Mantid::Kernel::PropertyManager::asJson().

◆ merge()

virtual Property & Mantid::Kernel::Property::merge ( Property * )

inlinevirtual

Just returns the property (*this) unless overridden.

Returns: a property with the value

Reimplemented in Mantid::Kernel::TimeSeriesProperty< TYPE >, Mantid::Kernel::TimeSeriesProperty< bool >, Mantid::Kernel::TimeSeriesProperty< double >, Mantid::Kernel::TimeSeriesProperty< HeldType >, and Mantid::Kernel::TimeSeriesProperty< int >.

Definition at line 193 of file Property.h.

Referenced by Mantid::API::Run::mergeMergables().

◆ name()

const std::string & Mantid::Kernel::Property::name ( ) const

Get the property's name.

Returns: The name of the property

Definition at line 61 of file Property.cpp.

References m_name.

◆ operator+=()

virtual Property & Mantid::Kernel::Property::operator+= ( Property const * rhs )

pure virtual

Add to this.

◆ operator=()

Property & Mantid::Kernel::Property::operator= ( const Property & right )

private

Private, unimplemented copy assignment operator.

◆ remember()

bool Mantid::Kernel::Property::remember ( ) const

Whether to save input values.

Whether to remember this property input.

Returns: whether to remember this property's input

Definition at line 121 of file Property.cpp.

References m_remember.

Referenced by MantidQt::API::AlgorithmDialog::saveInput(), and setRemember().

◆ saveProperty()

virtual void Mantid::Kernel::Property::saveProperty ( Nexus::File * )

inlinevirtual

Definition at line 132 of file Property.h.

References name.

◆ setAutoTrim()

void Mantid::Kernel::Property::setAutoTrim ( const bool & setting )

Sets if the property is set to automatically trim string unput values of whitespace.

Parameters

setting The new setting value

Definition at line 362 of file Property.cpp.

References m_autotrim.

Referenced by export_Property(), Mantid::DataHandling::SaveAscii::init(), Mantid::DataHandling::SaveAscii2::init(), Mantid::DataHandling::SaveCSV::init(), and Mantid::MDAlgorithms::ConvertToMDParent::init().

◆ setDataItem()

virtual std::string Mantid::Kernel::Property::setDataItem ( const std::shared_ptr< DataItem > & )

pure virtual

Set the value of the property via a DataItem pointer.

If the value is unacceptable the value is not changed but a string is returned

◆ setDisableReplaceWSButton()

void Mantid::Kernel::Property::setDisableReplaceWSButton ( const bool & disable )

Sets the property to disable the creation of the "Replace Workspace" button.

Parameters

disable The option to disable or not

Definition at line 374 of file Property.cpp.

References m_disableReplaceWSButton.

Referenced by export_Property().

◆ setDocumentation()

void Mantid::Kernel::Property::setDocumentation ( const std::string & documentation )

Sets the user level description of the property.

In addition, if the brief documentation string is empty it will be set to the portion of the provided string up to the first period (or the entire string if no period is found).

Parameters

documentation The string containing the descriptive comment

Definition at line 146 of file Property.cpp.

References documentation(), and m_documentation.

Referenced by Mantid::Algorithms::ExponentialCorrection::defineProperties(), export_Property(), Mantid::CurveFitting::Algorithms::DoublePulseFit::initConcrete(), Mantid::CurveFitting::Algorithms::Fit::initConcrete(), and Mantid::CurveFitting::Algorithms::QENSFitSimultaneous::initConcrete().

◆ setGroup()

void Mantid::Kernel::Property::setGroup ( const std::string & group )

inline

Set the group this property belongs to.

Definition at line 196 of file Property.h.

References group.

Referenced by Mantid::Kernel::IPropertyManager::setPropertyGroup().

◆ setIsDynamicDefault()

void Mantid::Kernel::Property::setIsDynamicDefault ( const bool & flag )

Set or clear the flag indicating whether or not the property's value has been set programmatically.

Definition at line 385 of file Property.cpp.

References m_isDynamicDefault.

Referenced by Mantid::Kernel::SetDefaultWhenProperty::applyChanges(), export_Property(), MantidQt::API::PropertyWidget::setPrevious_isDynamicDefault(), MantidQt::API::PropertyWidget::toggleUseHistory(), and MantidQt::API::PropertyWidget::userEditedProperty().

◆ setName()

void Mantid::Kernel::Property::setName ( const std::string & name )

Set the property's name.

Parameters

name	:: The name of the property

Definition at line 66 of file Property.cpp.

References m_name, and name().

◆ setRemember()

void Mantid::Kernel::Property::setRemember ( bool remember )

Set wheter to remeber this property input.

Parameters

remember :: true to remember

Definition at line 127 of file Property.cpp.

References m_remember, and remember().

Referenced by Mantid::Kernel::MaskedProperty< TYPE >::MaskedProperty(), and Mantid::Kernel::MaskedProperty< TYPE >::MaskedProperty().

◆ setSettings()

void Mantid::Kernel::Property::setSettings ( std::unique_ptr< IPropertySettings > settings )

Set the PropertySettings object.

Set the PropertySettings determining when this property is visible/enabled.

Takes ownership of the given object

Parameters

settings A pointer to an object specifying the settings type

Definition at line 103 of file Property.cpp.

References m_settings.

◆ setUnits()

void Mantid::Kernel::Property::setUnits ( const std::string & unit )

virtual

Sets the units of the property, as a string.

This is optional.

Parameters

unit	:: string to set for the units.

Definition at line 198 of file Property.cpp.

References m_units.

Referenced by Mantid::Algorithms::SampleLogsBehaviour::addPropertyForList(), Mantid::Algorithms::SampleLogsBehaviour::addPropertyForTimeSeries(), Mantid::Algorithms::AddSampleLog::addSingleValueProperty(), Mantid::Algorithms::AddSampleLog::addStringLog(), Mantid::Algorithms::AddSampleLog::addTimeSeriesProperty(), Mantid::MDAlgorithms::LoadDNSSCD::exec(), Mantid::DataHandling::LoadNexusLogs::execLoader(), export_Property(), Mantid::DataHandling::LoadNexusLogs::loadVetoPulses(), Mantid::API::Run::setDuration(), Mantid::API::Run::setProtonCharge(), Mantid::DataHandling::LoadEventPreNexus2::setProtonCharge(), and Mantid::MDAlgorithms::LoadDNSSCD::updateProperties().

◆ setValue()

virtual std::string Mantid::Kernel::Property::setValue ( const std::string & )

pure virtual

Set the value of the property via a string.

If the value is unacceptable the value is not changed but a string is returned

Referenced by createTemporaryValue(), export_Property(), Mantid::API::Run::operator+=(), Mantid::DataHandling::LegacyLoadHelper::recurseAndAddNexusFieldsToWsRun(), Mantid::DataHandling::LoadHelper::recurseAndAddNexusFieldsToWsRun(), Mantid::API::Run::setDuration(), Mantid::Kernel::PropertyManager::setPropertyOrdinal(), Mantid::API::Run::setProtonCharge(), and MantidQt::API::PropertyWidget::updateIconVisibility().

◆ setValueFromJson()

virtual std::string Mantid::Kernel::Property::setValueFromJson ( const Json::Value & )

pure virtual

Set the value of the property via a Json object.

If the value is unacceptable the value is not changed but a string is returned A const char * can be implicitly converted to both Json::Value and std::string so using simple setValue for both functions causes an abiguity error

◆ setValueFromProperty()

virtual std::string Mantid::Kernel::Property::setValueFromProperty ( const Property & right )

pure virtual

Set the value of the property via a reference to another property.

◆ size()

int Mantid::Kernel::Property::size ( ) const

virtual

Return the size of this property.

Single-Value properties return 1. TimeSeriesProperties return the # of entries.

Returns: the size of the property

Definition at line 183 of file Property.cpp.

◆ type()

const std::string Mantid::Kernel::Property::type ( ) const

Returns the type of the property as a string.

Note that this is implementation dependent.

Returns: The property type

Definition at line 87 of file Property.cpp.

References Mantid::Kernel::getUnmangledTypeName(), and m_typeinfo.

Referenced by Mantid::Algorithms::CreateLogPropertyTable::exec(), export_Property(), Mantid::API::IndexProperty::getIndices(), Mantid::API::IndexTypeProperty::operator=(), Mantid::Kernel::operator==(), MantidQt::API::OptionsPropertyWidget::OptionsPropertyWidget(), and Mantid::Kernel::PropertyManager::setPropertyOrdinal().

◆ type_info()

const std::type_info * Mantid::Kernel::Property::type_info ( ) const

Get the property type_info.

Returns: The type of the property

Definition at line 81 of file Property.cpp.

References m_typeinfo.

◆ units()

const std::string & Mantid::Kernel::Property::units ( ) const

virtual

Returns the units of the property, if any, as a string.

Units are optional, and will return empty string if they have not been set before.

Returns: the property's units

Definition at line 191 of file Property.cpp.

References m_units.

Referenced by Mantid::Algorithms::SampleLogsBehaviour::addPropertyForList(), Mantid::Algorithms::SampleLogsBehaviour::addPropertyForTimeSeries(), Mantid::Algorithms::PDDetermineCharacterizations::getLogValue(), Mantid::API::Run::integrateProtonCharge(), and Mantid::Algorithms::SampleLogsBehaviour::mergeSampleLogs().

◆ value()

virtual std::string Mantid::Kernel::Property::value ( ) const

pure virtual

Returns the value of the property as a string.

◆ valueAsJson()

virtual Json::Value Mantid::Kernel::Property::valueAsJson ( ) const

pure virtual

Returns the value of the property as a Json::Value.

Referenced by Mantid::Kernel::PropertyManager::asJson().

◆ valueAsPrettyStr()

std::string Mantid::Kernel::Property::valueAsPrettyStr	(	const size_t	maxLength = `0`,
		const bool	collapseLists = `true`
	)		const

virtual

Returns the value of the property as a pretty printed string.

Returns the value as a pretty printed string The default implementation just returns the value with the size limit applied.

Parameters

maxLength	:: The Max length of the returned string
collapseLists	:: Whether to collapse 1,2,3 into 1-3

Definition at line 135 of file Property.cpp.

References Mantid::Kernel::Strings::shorten(), UNUSED_ARG, and value().

Referenced by export_Property().

Member Data Documentation

◆ m_autotrim

bool Mantid::Kernel::Property::m_autotrim

private

Flag to determine if string inputs to the property should be automatically trimmed of whitespace.

Definition at line 245 of file Property.h.

Referenced by autoTrim(), and setAutoTrim().

◆ m_direction

const unsigned int Mantid::Kernel::Property::m_direction

private

Whether the property is used as input, output or both to an algorithm.

Definition at line 227 of file Property.h.

Referenced by Property().

◆ m_disableReplaceWSButton

bool Mantid::Kernel::Property::m_disableReplaceWSButton

private

Flag to disable the generation of the "Replace Workspace" button on the OutputWorkspace property.

Definition at line 248 of file Property.h.

Referenced by disableReplaceWSButton(), and setDisableReplaceWSButton().

◆ m_documentation

std::string Mantid::Kernel::Property::m_documentation

private

Longer, optional description of property.

Definition at line 223 of file Property.h.

Referenced by documentation(), and setDocumentation().

◆ m_group

std::string Mantid::Kernel::Property::m_group

private

Name of the "group" of this property, for grouping in the GUI. Default "".

Definition at line 235 of file Property.h.

◆ m_isDynamicDefault

bool Mantid::Kernel::Property::m_isDynamicDefault

private

Flag to indicate that the property's value has been set programmatically, for example, when a default value is dynamic and depends on an upstream property.

Definition at line 252 of file Property.h.

Referenced by isDynamicDefault(), and setIsDynamicDefault().

◆ m_name

std::string Mantid::Kernel::Property::m_name

protected

The name of the property.

Definition at line 216 of file Property.h.

Referenced by name(), Property(), Property(), and setName().

◆ m_remember

bool Mantid::Kernel::Property::m_remember

private

Flag whether to save input values.

Definition at line 241 of file Property.h.

Referenced by remember(), and setRemember().

◆ m_settings

std::unique_ptr<IPropertySettings> Mantid::Kernel::Property::m_settings

private

Property settings (enabled/visible)

Definition at line 232 of file Property.h.

Referenced by clearSettings(), getSettings(), getSettings(), Property(), and setSettings().

◆ m_typeinfo

const std::type_info* Mantid::Kernel::Property::m_typeinfo

private

The type of the property.

Definition at line 225 of file Property.h.

Referenced by type(), and type_info().

◆ m_units

std::string Mantid::Kernel::Property::m_units

private

Units of the property (optional)

Definition at line 229 of file Property.h.

Referenced by setUnits(), and units().

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

Framework/Kernel/inc/MantidKernel/Property.h
Framework/Kernel/src/Property.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ~Property()

◆ Property() [1/3]

◆ Property() [2/3]

◆ Property() [3/3]

Member Function Documentation

◆ allowedValues()

◆ autoTrim()

◆ clearSettings()

◆ clone()

◆ createHistory()

◆ createTemporaryValue()

◆ direction()

◆ disableReplaceWSButton()

◆ documentation()

◆ getDefault()

◆ getGroup()

◆ getMemorySize()

◆ getSettings() [1/2]

◆ getSettings() [2/2]

◆ hasTemporaryValue()

◆ isDefault()

◆ isDynamicDefault()

◆ isMultipleSelectionAllowed()

◆ isValid()

◆ isValueSerializable()

◆ merge()

◆ name()

◆ operator+=()

◆ operator=()

◆ remember()

◆ saveProperty()

◆ setAutoTrim()

◆ setDataItem()

◆ setDisableReplaceWSButton()

◆ setDocumentation()

◆ setGroup()

◆ setIsDynamicDefault()

◆ setName()

◆ setRemember()

◆ setSettings()

◆ setUnits()

◆ setValue()

◆ setValueFromJson()

◆ setValueFromProperty()

◆ size()

◆ type()

◆ type_info()

◆ units()

◆ value()

◆ valueAsJson()

◆ valueAsPrettyStr()

Member Data Documentation

◆ m_autotrim

◆ m_direction

◆ m_disableReplaceWSButton

◆ m_documentation

◆ m_group

◆ m_isDynamicDefault

◆ m_name

◆ m_remember

◆ m_settings

◆ m_typeinfo

◆ m_units