135 std::initializer_list<NamedValueSet::NamedValue> properties,
136 std::initializer_list<ValueTree> subTrees = {});
159 bool operator== (
const ValueTree&)
const noexcept;
165 bool operator!= (
const ValueTree&)
const noexcept;
173 bool isEquivalentTo (
const ValueTree&)
const;
179 bool isValid() const noexcept {
return object !=
nullptr; }
208 bool hasType (
const Identifier& typeName)
const noexcept;
216 const var& getProperty (
const Identifier& name)
const noexcept;
223 var getProperty (
const Identifier& name,
const var& defaultReturnValue)
const;
229 const var* getPropertyPointer (
const Identifier& name)
const noexcept;
236 const var& operator[] (
const Identifier& name)
const noexcept;
248 bool hasProperty (
const Identifier& name)
const noexcept;
260 void removeAllProperties (
UndoManager* undoManager);
265 int getNumProperties()
const noexcept;
273 Identifier getPropertyName (
int index)
const noexcept;
284 bool shouldUpdateSynchronously =
false);
290 int getNumChildren()
const noexcept;
349 void removeChild (
int childIndex,
UndoManager* undoManager);
369 void moveChild (
int currentIndex,
int newIndex,
UndoManager* undoManager);
374 bool isAChildOf (
const ValueTree& possibleParent)
const noexcept;
379 int indexOf (
const ValueTree& child)
const noexcept;
398 ValueTree getSibling (
int delta)
const noexcept;
410 bool operator== (
const Iterator&)
const;
411 bool operator!= (
const Iterator&)
const;
414 using difference_type = std::ptrdiff_t;
418 using iterator_category = std::forward_iterator_tag;
449 String toXmlString()
const;
465 static ValueTree readFromData (
const void* data,
size_t numBytes);
470 static ValueTree readFromGZIPData (
const void* data,
size_t numBytes);
490 virtual void valueTreePropertyChanged (
ValueTree& treeWhosePropertyHasChanged,
499 virtual void valueTreeChildAdded (
ValueTree& parentTree,
509 virtual void valueTreeChildRemoved (
ValueTree& parentTree,
511 int indexFromWhichChildWasRemoved) = 0;
520 virtual void valueTreeChildOrderChanged (
ValueTree& parentTreeWhoseChildrenHaveMoved,
521 int oldIndex,
int newIndex) = 0;
529 virtual void valueTreeParentChanged (
ValueTree& treeWhoseParentHasChanged) = 0;
535 virtual void valueTreeRedirected (
ValueTree& treeWhichHasBeenChanged);
552 void addListener (
Listener* listener);
555 void removeListener (
Listener* listener);
567 void sendPropertyChangeMessage (
const Identifier& property);
591 template <
typename ElementComparator>
592 void sort (ElementComparator& comparator,
UndoManager* undoManager,
bool retainOrderOfEquivalentItems)
594 if (
object !=
nullptr)
597 createListOfChildren (sortedList);
598 ComparatorAdapter<ElementComparator> adapter (comparator);
599 sortedList.
sort (adapter, retainOrderOfEquivalentItems);
600 reorderChildren (sortedList, undoManager);
607 int getReferenceCount()
const noexcept;
612 JUCE_DEPRECATED_STATIC (
static const ValueTree invalid;)
622 template <
typename ElementComparator>
623 struct ComparatorAdapter
625 ComparatorAdapter (ElementComparator& comp) noexcept : comparator (comp) {}
629 return comparator.compareElements (*first, *second);
633 ElementComparator& comparator;
634 JUCE_DECLARE_NON_COPYABLE (ComparatorAdapter)
#define JUCE_API
This macro is added to all JUCE public class declarations.
A powerful tree structure that can be used to hold free-form data, and which can handle its own undo ...
Represents a string identifier, designed for accessing properties by name.
A variant class, that can be used to hold a range of primitive values.
Used to build a tree of elements representing an XML document.
Iterator for a ValueTree.
void sort(ElementComparator &comparator, bool retainOrderOfEquivalentItems=false) const noexcept
Sorts the elements in the array.
void sort(ElementComparator &comparator, UndoManager *undoManager, bool retainOrderOfEquivalentItems)
This method uses a comparator object to sort the tree's children into order.
Holds a set of objects and can invoke a member function callback on each object in the set with a sin...
bool isValid() const noexcept
Returns true if this tree refers to some valid data.
Represents a shared variant value.
The base class for streams that write data to some kind of destination.
A smart-pointer class which points to a reference-counted object.
Listener class for events that happen to a ValueTree.
Manages a list of undo/redo commands.
An array designed for holding objects.