510fc443e8
Required by platforms that will use mono under the hood for .Net 7 New `USE_CSHARP` define for C# ability Engine doesn't use `mono_*` apis directly but via MCore/MClass/MMethod/ apis
137 lines
4.5 KiB
C++
137 lines
4.5 KiB
C++
// Copyright (c) 2012-2023 Wojciech Figat. All rights reserved.
|
|
|
|
#pragma once
|
|
|
|
#include "Engine/Core/Collections/Array.h"
|
|
#include "MTypes.h"
|
|
|
|
/// <summary>
|
|
/// Encapsulates information about a single Mono managed property belonging to some managed class.
|
|
/// This object also allows you to set or retrieve values to or from specific instances containing the property.
|
|
/// </summary>
|
|
class FLAXENGINE_API MProperty
|
|
{
|
|
friend MClass;
|
|
|
|
protected:
|
|
#if USE_MONO
|
|
MonoProperty* _monoProperty;
|
|
#endif
|
|
|
|
mutable MMethod* _getMethod;
|
|
mutable MMethod* _setMethod;
|
|
MClass* _parentClass;
|
|
|
|
StringAnsi _name;
|
|
|
|
mutable int32 _hasCachedAttributes : 1;
|
|
mutable int32 _hasSetMethod : 1;
|
|
mutable int32 _hasGetMethod : 1;
|
|
|
|
mutable Array<MObject*> _attributes;
|
|
|
|
public:
|
|
#if USE_MONO
|
|
explicit MProperty(MonoProperty* monoProperty, const char* name, MClass* parentClass);
|
|
#elif USE_NETCORE
|
|
MProperty(MClass* parentClass, const char* name, void* getterHandle, void* setterHandle, MMethodAttributes getterAttributes, MMethodAttributes setterAttributes);
|
|
#endif
|
|
|
|
/// <summary>
|
|
/// Finalizes an instance of the <see cref="MProperty"/> class.
|
|
/// </summary>
|
|
~MProperty();
|
|
|
|
public:
|
|
/// <summary>
|
|
/// Gets the property name.
|
|
/// </summary>
|
|
FORCE_INLINE const StringAnsi& GetName() const
|
|
{
|
|
return _name;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns the parent class that this method is contained with.
|
|
/// </summary>
|
|
FORCE_INLINE MClass* GetParentClass() const
|
|
{
|
|
return _parentClass;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets property type class.
|
|
/// </summary>
|
|
MType* GetType() const;
|
|
|
|
/// <summary>
|
|
/// Gets property get method.
|
|
/// </summary>
|
|
MMethod* GetGetMethod() const;
|
|
|
|
/// <summary>
|
|
/// Gets property set method.
|
|
/// </summary>
|
|
MMethod* GetSetMethod() const;
|
|
|
|
/// <summary>
|
|
/// Gets property visibility in the class.
|
|
/// </summary>
|
|
MVisibility GetVisibility() const;
|
|
|
|
/// <summary>
|
|
/// Returns true if property is static.
|
|
/// </summary>
|
|
bool IsStatic() const;
|
|
|
|
public:
|
|
/// <summary>
|
|
/// Retrieves value currently set in the property on the specified object instance. If property is static object instance can be null.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Value will be a pointer to raw data type for value types (for example int, float), and a MObject* for reference types.
|
|
/// </remarks>
|
|
/// <param name="instance">The object of given type to get value from.</param>
|
|
/// <param name="exception">An optional pointer to the exception value to store exception object reference.</param>
|
|
/// <returns>The returned boxed value object.</returns>
|
|
MObject* GetValue(MObject* instance, MObject** exception) const;
|
|
|
|
/// <summary>
|
|
/// Sets a value for the property on the specified object instance. If property is static object instance can be null.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Value should be a pointer to raw data type for value types (for example int, float), and a MObject* for reference types.
|
|
/// </remarks>
|
|
/// <param name="instance">Object of given type to set value to.</param>
|
|
/// <param name="exception">An optional pointer to the exception value to store exception object reference.</param>
|
|
/// <param name="value">The value to set of undefined type.</param>
|
|
void SetValue(MObject* instance, void* value, MObject** exception) const;
|
|
|
|
public:
|
|
/// <summary>
|
|
/// Checks if property has an attribute of the specified type.
|
|
/// </summary>
|
|
/// <param name="monoClass">The attribute class to check.</param>
|
|
/// <returns>True if has attribute of that class type, otherwise false.</returns>
|
|
bool HasAttribute(MClass* monoClass) const;
|
|
|
|
/// <summary>
|
|
/// Checks if property has an attribute of any type.
|
|
/// </summary>
|
|
/// <returns>True if has any custom attribute, otherwise false.</returns>
|
|
bool HasAttribute() const;
|
|
|
|
/// <summary>
|
|
/// Returns an instance of an attribute of the specified type. Returns null if the property doesn't have such an attribute.
|
|
/// </summary>
|
|
/// <param name="monoClass">The attribute class to take.</param>
|
|
/// <returns>The attribute object.</returns>
|
|
MObject* GetAttribute(MClass* monoClass) const;
|
|
|
|
/// <summary>
|
|
/// Returns an instance of all attributes connected with given property. Returns null if the property doesn't have any attributes.
|
|
/// </summary>
|
|
/// <returns>The array of attribute objects.</returns>
|
|
const Array<MObject*>& GetAttributes() const;
|
|
};
|