DataObjectFormats

A DataObjectFormats object is the read-only collection of DataObjectFormat descriptors a DataObject currently exposes — one element per clipboard format the object holds a value in. The collection is returned by the AvailableFormats method and is the only general way to discover, at run time, which formats a DataObject received from another application has on offer.

Members

Count

Returns the number of formats in the collection.

Syntax: object.Count

object
required An object expression that evaluates to a DataObjectFormats object.

The value is a Long. Valid indexes for Item run from 1 to Count.

Item

Returns a single format descriptor from the collection by its one-based position.

Syntax: object.Item( Index )

object
required An object expression that evaluates to a DataObjectFormats object.
Index
required A Long giving the one-based position of the descriptor to return. Must be between 1 and Count; otherwise an error occurs.

The result is a DataObjectFormat.

For Each iteration

A DataObjectFormats object can be iterated with the For Each…Next statement, which yields each DataObjectFormat in turn. The hidden _NewEnum member supplies the enumerator and is not called directly from user code.

Dim F As DataObjectFormat
For Each F In Data.AvailableFormats
    Debug.Print F.Name, F.FormatType
Next F

See Also