[internal] An implementation of xiiTypedMemberProperty that uses custom getter / setter functions to access a property. More...

#include <ResourceHandleReflection.h>

Inheritance diagram for xiiResourceAccessorProperty< Class, Type >:

[legend]

Public Types
using	RealType = xiiStringView

using	HandleType = typename xiiTypeTraits<Type>::NonConstReferenceType

using	ResourceType = typename HandleType::ResourceType

using	GetterFunc = Type (Class::*)() const

using	SetterFunc = void (Class::*)(Type value)

Public Member Functions
	xiiResourceAccessorProperty (xiiStringView sPropertyName, GetterFunc getter, SetterFunc setter)

virtual void *	GetPropertyPointer (const void *pInstance) const override
	Returns a pointer to the property data or nullptr. If a valid pointer is returned, that pointer and the information from GetSpecificType() can be used to step deeper into the type (if required).

virtual RealType	GetValue (const void *pInstance) const override
	Returns the value of the property. Pass the instance pointer to the surrounding class along.

virtual void	SetValue (void *pInstance, RealType value) const override
	Modifies the value of the property. Pass the instance pointer to the surrounding class along.

Public Member Functions inherited from xiiTypedMemberProperty< xiiStringView >
	xiiTypedMemberProperty (xiiStringView sPropertyName)
	Passes the property name through to xiiAbstractMemberProperty.

virtual const xiiRTTI *	GetSpecificType () const override
	Returns the actual type of the property. You can then compare that with known types, eg. compare it to xiiGetStaticRTTI<int>() to see whether this is an int property.

virtual void	GetValuePtr (const void pInstance, void pObject) const override
	Writes the value of this property in pInstance to pObject. pObject needs to point to an instance of this property's type.

virtual void	SetValuePtr (void pInstance, const void pObject) const override
	Sets the value of pObject to the property in pInstance. pObject needs to point to an instance of this property's type.

Public Member Functions inherited from xiiAbstractMemberProperty
	xiiAbstractMemberProperty (xiiStringView sPropertyName)
	Passes the property name through to xiiAbstractProperty.

virtual xiiPropertyCategory::Enum	GetCategory () const override
	Returns xiiPropertyCategory::Member.

Public Member Functions inherited from xiiAbstractProperty
	xiiAbstractProperty (xiiStringView sPropertyName)
	The constructor must get the name of the property. The string must be a compile-time constant.

xiiStringView	GetPropertyName () const
	Returns the name of the property.

const xiiBitflags< xiiPropertyFlags > &	GetFlags () const
	Returns the flags of the property.

xiiAbstractProperty *	AddFlags (xiiBitflags< xiiPropertyFlags > flags)
	Adds flags to the property. Returns itself to allow to be called during initialization.

xiiAbstractProperty *	AddAttributes (xiiPropertyAttribute pAttrib1, xiiPropertyAttribute pAttrib2=nullptr, xiiPropertyAttribute pAttrib3=nullptr, xiiPropertyAttribute pAttrib4=nullptr, xiiPropertyAttribute pAttrib5=nullptr, xiiPropertyAttribute pAttrib6=nullptr)
	Adds attributes to the property. Returns itself to allow to be called during initialization. Allocate an attribute using standard 'new'.

xiiArrayPtr< const xiiPropertyAttribute *const >	GetAttributes () const
	Returns the array of property attributes.

template<typename Type>
const Type *	GetAttributeByType () const
	Returns the first attribute that derives from the given type, or nullptr if nothing is found.

Additional Inherited Members
Protected Attributes inherited from xiiAbstractProperty
xiiBitflags< xiiPropertyFlags >	m_Flags

xiiStringView	m_sPropertyName

xiiHybridArray< const xiiPropertyAttribute *, 2U, xiiStaticAllocatorWrapper >	m_Attributes

Detailed Description

template<typename Class, typename Type>
class xiiResourceAccessorProperty< Class, Type >

[internal] An implementation of xiiTypedMemberProperty that uses custom getter / setter functions to access a property.

Member Function Documentation

◆ GetPropertyPointer()

template<typename Class, typename Type>

virtual void * xiiResourceAccessorProperty< Class, Type >::GetPropertyPointer ( const void * pInstance ) const

inlineoverridevirtual

Returns a pointer to the property data or nullptr. If a valid pointer is returned, that pointer and the information from GetSpecificType() can be used to step deeper into the type (if required).

You need to pass the pointer to an object on which you are operating. This function is mostly of interest when the property itself is a compound type (a struct or class). If it is a simple type (int, float, etc.) it doesn't make much sense to retrieve the pointer.

For example GetSpecificType() might return that a property is of type xiiVec3. In that case one might either stop and just use the code to handle xiiVec3 types, or one might continue and enumerate all sub-properties (x, y and z) as well.

Note: There is no guarantee that this function returns a non-nullptr pointer, independent of the type. When a property uses custom 'accessors' (functions to get / set the property value), it is not possible (or useful) to get the property pointer.

Implements xiiAbstractMemberProperty.

◆ GetValue()

template<typename Class, typename Type>

virtual RealType xiiResourceAccessorProperty< Class, Type >::GetValue ( const void * pInstance ) const

inlineoverridevirtual

Returns the value of the property. Pass the instance pointer to the surrounding class along.

Implements xiiTypedMemberProperty< xiiStringView >.

◆ SetValue()

template<typename Class, typename Type>

virtual void xiiResourceAccessorProperty< Class, Type >::SetValue	(	void *	pInstance,
		RealType	value ) const

inlineoverridevirtual

Modifies the value of the property. Pass the instance pointer to the surrounding class along.

Note: Make sure the property is not read-only before calling this, otherwise an assert will fire.

Implements xiiTypedMemberProperty< xiiStringView >.

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

/home/runner/work/XII/XII/Source/Engine/Core/ResourceManager/Implementation/ResourceHandleReflection.h

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ GetPropertyPointer()

◆ GetValue()

◆ SetValue()