Version: 2022.1
LanguageEnglish
  • C#

SerializedProperty.FindPropertyRelative

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public SerializedProperty FindPropertyRelative(string relativePropertyPath);

Description

Retrieves the SerializedProperty at a relative path to the current property.

When the SerializedProperty references a compound type, such as a struct, class or array, then this method can be used to lookup a child property by name.

using UnityEngine;
using UnityEditor;

public class SerializePropertyFindPropertyRelative : ScriptableObject { [System.Serializable] public struct NestedData { public int x; public int y; }; public NestedData m_data;

[MenuItem("Example/SerializedProperty FindPropertyRelative Example")] static void FindPropertyRelativeExample() { var scriptableObject = ScriptableObject.CreateInstance<SerializePropertyFindPropertyRelative>();

// Change the values of the struct using SerializedObject using (var serializedObject = new SerializedObject(scriptableObject)) { var data = serializedObject.FindProperty("m_data");

SerializedProperty x = data.FindPropertyRelative("x"); x.intValue = 1;

SerializedProperty y = data.FindPropertyRelative("y"); y.intValue = 2;

serializedObject.ApplyModifiedProperties(); }

Debug.Log($"Value of data after update: {scriptableObject.m_data.x}, {scriptableObject.m_data.y}"); } }