Represents a property. More...

Inheritance diagram for IProperty:

Public Member Functions
HRESULT	GetAngleValue ([in] enum AngleUnit unit, [out, retval] double *pValue)
	Returns the property value as an angle.

HRESULT	GetAreaValue ([in] enum AreaUnit unit, [out, retval] double *pValue)
	Returns the property value as an area.

HRESULT	GetBooleanValue ([out, retval] VARIANT_BOOL *pValue)
	Returns the property value as a boolean.

HRESULT	GetDoubleValue ([out, retval] double *pValue)
	Returns the property value as a `double`.

HRESULT	GetEnumerationValue ([out, retval] BSTR *pValue)
	Returns the property value as an enumeration.

HRESULT	GetIntegerValue ([out, retval] int *pValue)
	Returns the property value as an integer.

HRESULT	GetLengthValue ([in] enum LengthUnit unit, [out, retval] double *pValue)
	Returns the property value as a length.

HRESULT	GetLogicalValue ([out, retval] enum Logical *pValue)
	Returns the property value as a tree-state logical value.

HRESULT	GetMassValue ([in] enum MassUnit unit, [out, retval] double *pValue)
	Returns the property value as a mass.

HRESULT	GetStringValue ([out, retval] BSTR *pValue)
	Returns the property value as a `string`.

HRESULT	GetVolumeValue ([in] enum VolumeUnit unit, [out, retval] double *pValue)
	Returns the property value as a volume.

HRESULT	HasValue ([out, retval] VARIANT_BOOL *pResult)
	Indicates if the property has a value.

HRESULT	ResetValue ()
	Resets the value of the property. Marks the property as unset, so that subsequent calls to HasValue() return FALSE.

HRESULT	SetAngleValue ([in] double value_, [in] enum AngleUnit unit)
	Sets the property value as an angle.

HRESULT	SetAreaValue ([in] double value_, [in] enum AreaUnit unit)
	Sets the property value as an area.

HRESULT	SetBooleanValue ([in] VARIANT_BOOL value_)
	Sets the property value as a boolean.

HRESULT	SetDoubleValue ([in] double value_)
	Sets the property value as a `double`.

HRESULT	SetEnumerationValue ([in] BSTR value_)
	Sets the property value as an enumeration.

HRESULT	SetIntegerValue ([in] int value_)
	Sets the property value as an integer.

HRESULT	SetLengthValue ([in] double value_, [in] enum LengthUnit unit)
	Sets the property value as a length.

HRESULT	SetLogicalValue ([in] enum Logical value_)
	Sets the property value as a tree-state logical value.

HRESULT	SetMassValue ([in] double value_, [in] enum MassUnit unit)
	Sets the property value as a mass.

HRESULT	SetStringValue ([in] BSTR value_)
	Sets the property value as a `string`.

HRESULT	SetVolumeValue ([in] double value_, [in] enum VolumeUnit unit)
	Sets the property value as a volume.

Properties
GUID	Id `[get]`
	The unique identifier of the property.

BSTR	IdS `[get]`
	The unique identifier of the property as a string.

BSTR	Name `[get]`
	The name of the property.

PropertyType	Type `[get]`
	The type of property.

Detailed Description

Represents a property.

This interface can be obtained through IPropertyContainer.

Member Function Documentation

◆ GetAngleValue()

HRESULT GetAngleValue	(	[in] enum AngleUnit	unit,
		[out, retval] double *	pValue )

Returns the property value as an angle.

It is an error to call this method on a property of type other than PropertyType_Angle.

Parameters

[in] unit Unit of measure for the angle.

Returns: Value of the property.

◆ GetAreaValue()

HRESULT GetAreaValue	(	[in] enum AreaUnit	unit,
		[out, retval] double *	pValue )

Returns the property value as an area.

It is an error to call this method on a property of type other than PropertyType_Area.

Parameters

[in] unit Unit of measure for the area.

Returns: Value of the property.

◆ GetBooleanValue()

HRESULT GetBooleanValue ( [out, retval] VARIANT_BOOL * pValue )

Returns the property value as a boolean.

It is an error to call this method on a property of type other than PropertyType_Boolean.

Returns: Value of the property.

◆ GetDoubleValue()

HRESULT GetDoubleValue ( [out, retval] double * pValue )

Returns the property value as a double.

It is an error to call this method on a property of type other than PropertyType_Double.

Returns: Value of the property.

◆ GetEnumerationValue()

HRESULT GetEnumerationValue ( [out, retval] BSTR * pValue )

Returns the property value as an enumeration.

It is an error to call this method on a property of type other than PropertyType_Enumeration.

Returns: Value of the property.

◆ GetIntegerValue()

HRESULT GetIntegerValue ( [out, retval] int * pValue )

Returns the property value as an integer.

It is an error to call this method on a property of type other than PropertyType_Integer.

Returns: Value of the property.

◆ GetLengthValue()

HRESULT GetLengthValue	(	[in] enum LengthUnit	unit,
		[out, retval] double *	pValue )

Returns the property value as a length.

It is an error to call this method on a property of type other than PropertyType_Length.

Parameters

[in] unit Unit of measure for the length.

Returns: Value of the property.

◆ GetLogicalValue()

HRESULT GetLogicalValue ( [out, retval] enum Logical * pValue )

Returns the property value as a tree-state logical value.

It is an error to call this method on a property of type other than PropertyType_Logical.

Returns: Value of the property.

◆ GetMassValue()

HRESULT GetMassValue	(	[in] enum MassUnit	unit,
		[out, retval] double *	pValue )

Returns the property value as a mass.

It is an error to call this method on a property of type other than PropertyType_Mass. [in] enum MassUnit unit

Returns: Value of the property.

◆ GetStringValue()

HRESULT GetStringValue ( [out, retval] BSTR * pValue )

Returns the property value as a string.

It is an error to call this method on a property of type other than PropertyType_String.

Returns: Value of the property.

◆ GetVolumeValue()

HRESULT GetVolumeValue	(	[in] enum VolumeUnit	unit,
		[out, retval] double *	pValue )

Returns the property value as a volume.

It is an error to call this method on a property of type other than PropertyType_Volume.

Parameters

[in] unit Unit of measure for the volume.

Returns: Value of the property.

◆ HasValue()

HRESULT HasValue ( [out, retval] VARIANT_BOOL * pResult )

Indicates if the property has a value.

Returns: TRUE if the property has a value; otherwise returns FALSE.

◆ SetAngleValue()

HRESULT SetAngleValue	(	[in] double	value_,
		[in] enum AngleUnit	unit )

Sets the property value as an angle.

It is an error to call this method on a property of type other than PropertyType_Angle.

Parameters

[in]	value_	New value of the property.
[in]	unit	Unit of measure for the angle.

◆ SetAreaValue()

HRESULT SetAreaValue	(	[in] double	value_,
		[in] enum AreaUnit	unit )

Sets the property value as an area.

It is an error to call this method on a property of type other than PropertyType_Area.

Parameters

[in]	value_	New value of the property.
[in]	unit	Unit of measure for the area.

◆ SetBooleanValue()

HRESULT SetBooleanValue ( [in] VARIANT_BOOL value_ )

Sets the property value as a boolean.

It is an error to call this method on a property of type other than PropertyType_Boolean.

Parameters

[in] value_ New value of the property.

◆ SetDoubleValue()

HRESULT SetDoubleValue ( [in] double value_ )

Sets the property value as a double.

It is an error to call this method on a property of type other than PropertyType_Double.

Parameters

[in] value_ New value of the property.

◆ SetEnumerationValue()

HRESULT SetEnumerationValue ( [in] BSTR value_ )

Sets the property value as an enumeration.

It is an error to call this method on a property of type other than PropertyType_Enumeration.

Parameters

[in] value_ New value of the property.

◆ SetIntegerValue()

HRESULT SetIntegerValue ( [in] int value_ )

Sets the property value as an integer.

It is an error to call this method on a property of type other than PropertyType_Integer.

Parameters

[in] value_ New value of the property.

◆ SetLengthValue()

HRESULT SetLengthValue	(	[in] double	value_,
		[in] enum LengthUnit	unit )

Sets the property value as a length.

It is an error to call this method on a property of type other than PropertyType_Length.

Parameters

[in]	value_	New value of the property.
[in]	unit	Unit of measure for the length.

◆ SetLogicalValue()

HRESULT SetLogicalValue ( [in] enum Logical value_ )

Sets the property value as a tree-state logical value.

It is an error to call this method on a property of type other than PropertyType_Logical.

Parameters

[in] value_ New value of the property.

◆ SetMassValue()

HRESULT SetMassValue	(	[in] double	value_,
		[in] enum MassUnit	unit )

Sets the property value as a mass.

It is an error to call this method on a property of type other than PropertyType_Mass.

Parameters

[in]	value_	New value of the property.
[in]	unit	Unit of measure for the mass.

◆ SetStringValue()

HRESULT SetStringValue ( [in] BSTR value_ )

Sets the property value as a string.

It is an error to call this method on a property of type other than PropertyType_String.

Parameters

[in] value_ New value of the property.

◆ SetVolumeValue()

HRESULT SetVolumeValue	(	[in] double	value_,
		[in] enum VolumeUnit	unit )

Sets the property value as a volume.

It is an error to call this method on a property of type other than PropertyType_Volume.

Parameters

[in]	value_	New value of the property.
[in]	unit	Unit of measure for the volume.

Public Member Functions

Properties

Detailed Description

Member Function Documentation

◆ GetAngleValue()

◆ GetAreaValue()

◆ GetBooleanValue()

◆ GetDoubleValue()

◆ GetEnumerationValue()

◆ GetIntegerValue()

◆ GetLengthValue()

◆ GetLogicalValue()

◆ GetMassValue()

◆ GetStringValue()

◆ GetVolumeValue()

◆ HasValue()

◆ SetAngleValue()

◆ SetAreaValue()

◆ SetBooleanValue()

◆ SetDoubleValue()

◆ SetEnumerationValue()

◆ SetIntegerValue()

◆ SetLengthValue()

◆ SetLogicalValue()

◆ SetMassValue()

◆ SetStringValue()

◆ SetVolumeValue()