Features: Nested Objects

Nesting objects for editing is easy - it just works. It allows re-using of options patterns and is also useful for creating groups of options, which also simplifies definitions when using conditions.

Compound Object Property

This demonstrates the use of an existing plain regular class as editable property, even though it is recommended to use classes derived from EditableOptionsBase for nesting.

[DisplayName("Compound Object Property")]
[Description("This demonstrates the use of an existing plain regular class as editable property, even though "
                + "it is recommended to use classes derived from EditableOptionsBase for nesting.")]
public ImageOption LimitedString { get; set; } = new ImageOption();

EditableObject Properties

Having classes derived from EditableObject as property values allow re-using optionpatterns in multiple places or - like here - for repeated entry.

Child Class

public class ChildOptionExample : EditableOptionsBase
{
    public enum ImportMode
    {
        [Description("Manually Only")]
        Manually,

        [Description("Daily")]
        OncePerDay,

        [Description("Hourly")]
        OncePerHour,
    }

    public override string EditorTitle => "Child Option";

    [DisplayName("File Path")]
    [Description("Choose a source file")]
    [EditFilePicker]
    public string File { get; set; }

    [DisplayName("Import Mode")]
    [Description("Choose an import schedule")]
    public ImportMode ImportModeValue { get; set; }
}

Multiple Usages of Child Class

[DisplayName("File Import 1")]
public ChildOptionExample ChildOption1 { get; set; } = new ChildOptionExample();

[DisplayName("File Import 2")]
public ChildOptionExample ChildOption2 { get; set; } = new ChildOptionExample();

Using EditableObjectCollection

When the repetition count is not fixed, it is also possible to use the EditableObjectCollection class to have a dynamic number of child options. The members of the collection are not even required to be of the same type.

Child Class

see ChildOptionExample above.

Multiple Usages of Child Class

[DisplayName("Collection of 3 Child Options")]
public EditableObjectCollection Collection { get; set; } = new EditableObjectCollection
                            {
                                new ChildOptionExample(),
                                new ChildOptionExample(),
                                new ChildOptionExample(),
                            };