// Copyright Epic Games, Inc. All Rights Reserved. #pragma once #include "Editor.h" #include "PropertyHandle.h" #include "Misc/EnumerateRange.h" struct FGuid; struct FSlateBrush; #define LOCTEXT_NAMESPACE "StateTreeEditor" namespace UE::StateTree::PropertyHelpers { /** * Dispatches PostEditChange to all FState * Assumes property chain head is member property of Owner. */ void DispatchPostEditToNodes(UObject& Owner, FPropertyChangedChainEvent& PropertyChangedEvent); /** Makes deterministic ID from the owners property path, a property path (or any string), and a seed value (e.g. array index). */ FGuid MakeDeterministicID(const UObject& Owner, const FString& PropertyPath, const uint64 Seed); /* @return true if the property handle points to struct property of specified type.*/ template bool IsScriptStruct(const TSharedPtr& PropertyHandle) { if (!PropertyHandle) { return false; } FStructProperty* StructProperty = CastField(PropertyHandle->GetProperty()); return StructProperty && StructProperty->Struct->IsA(TBaseStructure::Get()->GetClass()); } /** * @return true if provided Property contains "Optional" metadata */ bool HasOptionalMetadata(const FProperty& Property); /** * Gets a struct value from property handle, checks type before access. Expects T is struct. * @param ValueProperty Handle to property where value is got from. * @return Requested value as optional, in case of multiple values the optional is unset. */ template FPropertyAccess::Result GetStructValue(const TSharedPtr& ValueProperty, T& OutValue) { if (!ValueProperty) { return FPropertyAccess::Fail; } FStructProperty* StructProperty = CastFieldChecked(ValueProperty->GetProperty()); check(StructProperty); check(StructProperty->Struct == TBaseStructure::Get()); T Value = T(); bool bValueSet = false; TArray RawData; ValueProperty->AccessRawData(RawData); for (const void* Data : RawData) { if (Data) { const T& CurValue = *static_cast(Data); if (!bValueSet) { bValueSet = true; Value = CurValue; } else if (CurValue != Value) { // Multiple values return FPropertyAccess::MultipleValues; } } } OutValue = Value; return FPropertyAccess::Success; } /** * Sets a struct property to specific value, checks type before access. Expects T is struct. * @param ValueProperty Handle to property where value is got from. * @return Requested value as optional, in case of multiple values the optional is unset. */ template FPropertyAccess::Result SetStructValue(const TSharedPtr& ValueProperty, const T& NewValue, EPropertyValueSetFlags::Type Flags = 0) { if (!ValueProperty) { return FPropertyAccess::Fail; } FStructProperty* StructProperty = CastFieldChecked(ValueProperty->GetProperty()); if (!StructProperty) { return FPropertyAccess::Fail; } if (StructProperty->Struct != TBaseStructure::Get()) { return FPropertyAccess::Fail; } const bool bTransactable = (Flags & EPropertyValueSetFlags::NotTransactable) == 0; bool bNotifiedPreChange = false; TArray RawData; ValueProperty->AccessRawData(RawData); for (void* Data : RawData) { if (Data) { if (!bNotifiedPreChange) { if (bTransactable && GEditor) { GEditor->BeginTransaction(FText::Format(LOCTEXT("SetPropertyValue", "Set {0}"), ValueProperty->GetPropertyDisplayName())); } ValueProperty->NotifyPreChange(); bNotifiedPreChange = true; } T* Value = reinterpret_cast(Data); *Value = NewValue; } } if (bNotifiedPreChange) { ValueProperty->NotifyPostChange(EPropertyChangeType::ValueSet); if (bTransactable && GEditor) { GEditor->EndTransaction(); } } ValueProperty->NotifyFinishedChangingProperties(); return FPropertyAccess::Success; } }; // UE::StateTree::PropertyHelpers /** * Helper class to deal with relative property paths in PostEditChangeChainProperty(). */ struct FStateTreeEditPropertyPath { private: struct FStateTreeEditPropertySegment { FStateTreeEditPropertySegment() = default; FStateTreeEditPropertySegment(const FProperty* InProperty, const FName InPropertyName, const int32 InArrayIndex = INDEX_NONE) : Property(InProperty) , PropertyName(InPropertyName) , ArrayIndex(InArrayIndex) { } const FProperty* Property = nullptr; FName PropertyName = FName(); int32 ArrayIndex = INDEX_NONE; }; public: FStateTreeEditPropertyPath() = default; /** Makes property path relative to BaseStruct. Checks if the path is not part of the type. */ explicit FStateTreeEditPropertyPath(const UStruct* BaseStruct, const FString& InPath); /** Makes property path from property change event. */ explicit FStateTreeEditPropertyPath(const FPropertyChangedChainEvent& PropertyChangedEvent); /** Makes property path from property chain. */ explicit FStateTreeEditPropertyPath(const FEditPropertyChain& PropertyChain); /** @return true if the property path contains specified path. */ bool ContainsPath(const FStateTreeEditPropertyPath& InPath) const; /** @return true if the property path is exactly the specified path. */ bool IsPathExact(const FStateTreeEditPropertyPath& InPath) const; /** @return array index at specified property, or INDEX_NONE, if the property is not array or property not found. */ int32 GetPropertyArrayIndex(const FStateTreeEditPropertyPath& InPath) const { return ContainsPath(InPath) ? Path[InPath.Path.Num() - 1].ArrayIndex : INDEX_NONE; } private: TArray Path; }; #undef LOCTEXT_NAMESPACE