Roku Object Reference - imaginArt

oRegistry ()
The registry is an area of memory where a small number of persistent settings can be stored. Access to the
registry is available through the roRegistry object.
This object is created with no parameters.
• CreateObject("roRegistry")
The following methods are supported:
• GetSectionList() As roList
o returns a list with one entry for each registry section.
• Delete(section As String) As Boolean
o deletes the specified section and returns an indication of success.
• Flush() As Boolean
o flushes the registry out to persistent storage.
roRegistrySection ()
A section of the registry, enabling the organization of settings within the registry.
This object must be supplied with a "section" name on creation.
• CreateObject("roRegistrySection", section As String)
The roRegistrySection object implements the ifRegistrySection interface. This interface provides:
• Read(key As String) As String
o reads and returns the value of the specified key.
• Write(key As String, value As String) As Boolean
o replaces the value of the specified key.
• Delete(key As String) As Boolean
o deletes the specified key.
• Exists(key As String) As Boolean
o returns true if the specified key exists.
• Flush() As Boolean
o flushes the contents of the registry out to persistent storage.
• GetKeyList() As roList
o returns a list containing one entry per registry key in this section.
Example:
registrySection = CreateObject("roRegistrySection", "widget-usage")
' An empty entry will read as the null string and therefore be
converted to zero.
hits = val(registrySection.Read("big-red-button-hits"))
hits = hits + 1
registrySection.Write("big-red-button-hits", strI(hits))
Writes do not always take immediate effect to prevent the system from exceeding the maximum number of
writes on the I2C ROM. At most sixty seconds after a write to the registry it will automatically be written
out to persistent storage. If for some reason the change must be written immediately then one of the flush
functions should be called. Changes are automatically written prior to application exit.
33