openshot-audio  0.1.7
Classes | Public Types | Public Member Functions | Protected Member Functions | List of all members
juce::PropertiesFile Class Reference

#include <juce_data_structures.h>

Inheritance diagram for juce::PropertiesFile:
juce::PropertySet juce::ChangeBroadcaster juce::Timer

Classes

struct  Options
 

Public Types

enum  StorageFormat { storeAsBinary, storeAsCompressedBinary, storeAsXML }
 

Public Member Functions

 PropertiesFile (const Options &options)
 
 PropertiesFile (const File &file, const Options &options)
 
 ~PropertiesFile ()
 
bool isValidFile () const noexcept
 
bool saveIfNeeded ()
 
bool save ()
 
bool needsToBeSaved () const
 
void setNeedsToBeSaved (bool needsToBeSaved)
 
bool reload ()
 
const FilegetFile () const noexcept
 
- Public Member Functions inherited from juce::PropertySet
 PropertySet (bool ignoreCaseOfKeyNames=false)
 
 PropertySet (const PropertySet &other)
 
PropertySetoperator= (const PropertySet &other)
 
virtual ~PropertySet ()
 
String getValue (StringRef keyName, const String &defaultReturnValue=String()) const noexcept
 
int getIntValue (StringRef keyName, int defaultReturnValue=0) const noexcept
 
double getDoubleValue (StringRef keyName, double defaultReturnValue=0.0) const noexcept
 
bool getBoolValue (StringRef keyName, bool defaultReturnValue=false) const noexcept
 
XmlElementgetXmlValue (StringRef keyName) const
 
void setValue (const String &keyName, const var &value)
 
void setValue (const String &keyName, const XmlElement *xml)
 
void addAllPropertiesFrom (const PropertySet &source)
 
void removeValue (StringRef keyName)
 
bool containsKey (StringRef keyName) const noexcept
 
void clear ()
 
StringPairArraygetAllProperties () noexcept
 
const CriticalSectiongetLock () const noexcept
 
XmlElementcreateXml (const String &nodeName) const
 
void restoreFromXml (const XmlElement &xml)
 
void setFallbackPropertySet (PropertySet *fallbackProperties) noexcept
 
PropertySetgetFallbackPropertySet () const noexcept
 
- Public Member Functions inherited from juce::ChangeBroadcaster
 ChangeBroadcaster () noexcept
 
virtual ~ChangeBroadcaster ()
 
void addChangeListener (ChangeListener *listener)
 
void removeChangeListener (ChangeListener *listener)
 
void removeAllChangeListeners ()
 
void sendChangeMessage ()
 
void sendSynchronousChangeMessage ()
 
void dispatchPendingMessages ()
 

Protected Member Functions

void propertyChanged () override
 

Detailed Description

Wrapper on a file that stores a list of key/value data pairs.

Useful for storing application settings, etc. See the PropertySet class for the interfaces that read and write values.

Not designed for very large amounts of data, as it keeps all the values in memory and writes them out to disk lazily when they are changed.

Because this class derives from ChangeBroadcaster, ChangeListeners can be registered with it, and these will be signalled when a value changes.

See Also
PropertySet

Member Enumeration Documentation

Enumerator
storeAsBinary 
storeAsCompressedBinary 
storeAsXML 

Constructor & Destructor Documentation

PropertiesFile::PropertiesFile ( const Options options)
explicit

Creates a PropertiesFile object. The file used will be chosen by calling PropertiesFile::Options::getDefaultFile() for the options provided. To set the file explicitly, use the other constructor.

PropertiesFile::PropertiesFile ( const File file,
const Options options 
)

Creates a PropertiesFile object. Unlike the other constructor, this one allows you to explicitly set the file that you want to be used, rather than using the default one.

PropertiesFile::~PropertiesFile ( )

Destructor. When deleted, the file will first call saveIfNeeded() to flush any changes to disk.

Member Function Documentation

const File& juce::PropertiesFile::getFile ( ) const
inlinenoexcept

Returns the file that's being used.

bool juce::PropertiesFile::isValidFile ( ) const
inlinenoexcept

Returns true if this file was created from a valid (or non-existent) file. If the file failed to load correctly because it was corrupt or had insufficient access, this will be false.

bool PropertiesFile::needsToBeSaved ( ) const

Returns true if the properties have been altered since the last time they were saved. The file is flagged as needing to be saved when you change a value, but you can explicitly set this flag with setNeedsToBeSaved().

void PropertiesFile::propertyChanged ( )
overrideprotectedvirtual

Subclasses can override this to be told when one of the properies has been changed.

Reimplemented from juce::PropertySet.

bool PropertiesFile::reload ( )

Attempts to reload the settings from the file.

bool PropertiesFile::save ( )

This will force a write-to-disk of the current values, regardless of whether anything has changed since the last save.

Returns false if it fails to write to the file for some reason (maybe because it's read-only or the directory doesn't exist or something).

See Also
saveIfNeeded
bool PropertiesFile::saveIfNeeded ( )

This will flush all the values to disk if they've changed since the last time they were saved.

Returns false if it fails to write to the file for some reason (maybe because it's read-only or the directory doesn't exist or something).

See Also
save
void PropertiesFile::setNeedsToBeSaved ( bool  needsToBeSaved)

Explicitly sets the flag to indicate whether the file needs saving or not.

See Also
needsToBeSaved

The documentation for this class was generated from the following files: