Difference between revisions of "ISDBApplication::Objects"

From MediaMonkey Wiki
Jump to: navigation, search
(Added note about CollectGarbage in JS.)
(Example JScript code)
Line 29: Line 29:
 
</source>
 
</source>
  
To release the object from global storage, you cannot call <tt>delete SDB.Objects('MyWindowRef')</tt> nor do <tt>SDB.Objects('MyWindowRef') = null</tt>. Best way is to reassign the storage key with empty JScript object. Later on, if you want to access the object from global storage, you should additionally check for the empty object presence as shown below.
+
To release the object from global storage, you cannot call <tt>delete SDB.Objects('MyWindowRef')</tt>, but you have to reassing the value. For example with <tt>null</tt>. However note that the object *may* be destroyed when *there are no references left* (thus SDB.Objects was the last one holding the object). If you want to destroy the object right now, consider calling <tt>CollectGarbage()</tt> method.
  
 
<source lang="javascript">
 
<source lang="javascript">
var ref = SDB.Objects('MyWindowRef'); // Get the reference...
+
SDB.Objects('MyWindowRef') = null; // Release instance from the collection.
if (!ref || (ref && !!ref.__empty)) { // If the object isn't in collection yet or there is the empty object instead...
+
CollectGarbage(); // Consider calling garbage collector when needing object disposal right now.
  SDB.Objects('MyWindowRef') = my_window; // add it to the collection.
 
}
 
 
 
// Some code here
 
 
 
SDB.Objects('MyWindowRef') = {'__empty': true}; // And now remove it from the collection by replacing with special empty object.
 
// CollectGarbage(); // Consider calling garbage collector when needing object disposal right now.
 
 
</source>
 
</source>
  

Revision as of 23:03, 25 November 2014

CoClass SDBApplication, Interface ISDBApplication

Property Get/Let Objects(Name As String) As Object


Parameters

Name Type Description
Name String An identifier for object storage.


Property description

A collection for temporary storage of any type of object during MediaMonkey running time. For example if a window is created by script that should remain visible while the script isn't running, the window object can be put into this collection in order to keep a reference to it. The keys of this collection are strings, the values can be only objects.

Some MediaMonkey objects are destroyed when last reference to them is deleted (such as form or progress bar). In JScript there may be a delay between last reference removal and object disposal. In this case you might want to consider calling CollectGarbage() method to tell the interpret to dispose objects right now.

Example VBScript code

If SDB.Objects("MyWindowRef") Is Nothing Then    ' If the object isn't in collection yet...
  Set SDB.Objects("MyWindowRef") = MyWindow      ' ... add it to the collection (using Set for objects)...
End If

' Some code here

SDB.Objects("MyWindowRef") = Nothing             '  ... and now remove it from the collection.

Example JScript code

if (!SDB.Objects('MyWindowRef')) { // If the object isn't in collection yet...
  SDB.Objects('MyWindowRef') = my_window; // add it to the collection.
}

To release the object from global storage, you cannot call delete SDB.Objects('MyWindowRef'), but you have to reassing the value. For example with null. However note that the object *may* be destroyed when *there are no references left* (thus SDB.Objects was the last one holding the object). If you want to destroy the object right now, consider calling CollectGarbage() method.

SDB.Objects('MyWindowRef') = null; // Release instance from the collection.
CollectGarbage(); // Consider calling garbage collector when needing object disposal right now.