This invisible object used to store contents of data files in memory. It keeps dynamic array of elements (items), and every item may have different number of dynamically allocated 10-byte floating point values. Container provides full access to items collection and allows you to perform standard file I/O operations.
Returns number of items in Items collection. In general, there's no limitations how long is data array, really it depends on your computer's performance. My files usually have about 1000 points, but DM2000 easily processes files with ~100000 points and even more!
Provides access to indexed items collection (Index=0..ItemCount-1). According to OLE standards, data item must be represented as variant. When you read Items, you obtain variant array (aka VBArray), and each element of this array is double precision floating-point value. But when you write this property, you have an alternative: variant array or string of values separated by comma, tabstop or space. This is possible due to polymorphism of variants, and data will be automatically converted. See demos for more information.
In some cases it may be preferred to get string representation of data element. Values will be rounded that may cause precision losses.
Adds item to the end of Items collection. As mentioned above, Values may be variant array or string.
Works like previous method, but insert item at specified position (0..ItemCount-1).
Deletes selected item.
This procedure clears contents of data container. IDMContainer.Modified property automatically set to true.
Load data from disk file. Text-type file must contain values separated by commas, tabstops or spaces. Decimal point character always assumed to be point (.) independent on system locales, otherwise fractional part will be interpreted as separate value.
Save data to disk file. Values are separated by spaces, each item occupy separate line. IDMContainer.Modified property automatically cleared.
Returns full name of loaded file. Note that Load() and Save() methods implicitly modify this property.
This property used to track data modifications. When data implicitly modified by some method or you directly set this property, container fires internal event which will correctly update all worksheets and plots referenced this container. It takes a lot of calculations and painting job so don't change this property too frequently.
Notice: when you set Modified=true, and appropriate document window is in "recording" state, plot is not forced to refresh. This feature allows you to refresh worksheet (actually you must set Modified=true in order to update number of lines in the worksheet!) without repainting whole plot. See demos for more details how to dynamically visualize data stream.