IWMEncDataViewCollection Object
.gif) |
The IWMEncDataViewCollection object contains a collection of data view objects, which are used to display preview and postview objects. A preview object displays a specific multimedia stream before it is compressed. A postview object displays the same stream after compression and decompression. Postviews, therefore, more closely resemble the image rendered in the player on a client computer.
A single data view object is generally associated with only one source stream in one source group but can be shared by multiple sources. For example, you can render both a live presentation and a bitmap intermission slide in the same video window by sharing a data view object between the two sources.
You can add multiple data view objects to a single source. For instance, one object might simply render a video or audio stream, and another object might use periods of inactivity in the encoded stream to send an e-mail message.
All of the data view objects associated with a stream are grouped together in a collection. Multiple collections exist if multiple streams are associated with data view objects. A data view collection is acquired from the IWMEncSource object.
Note To display previews and postviews, you must add the Windows Media Encoder Preview Control reference to the project. For more information, see Programming in Visual Basic.
The IWMEncDataViewCollection object exposes the following properties and methods.
| Property | Description |
| Count | Retrieves the number of IWMEncDataView objects in the collection. |
| length | Retrieves the number of IWMEncDataView objects in the collection. |
| Method | Description |
| Add | Adds an IWMEncDataView object to the collection. |
| Item | Retrieves a specific IWMEncDataView object from the collection. |
| Remove | Removes a specific IWMEncDataView object from the collection. |
| RemoveAll | Removes all IWMEncDataView objects from the collection. |
See Also