Note : The Filters collection is only supported by Internet Explorer 4.0.
The Filters collection is an ordered, indexed array, containing a reference to all filter objects for a particular element. For information about the Visual Filters supported in Internet Explorer 4.0, see the Visual Filters topic.
Filter Objects can be retrieved by their index in the filters collection, or by the names by which they are applied to an element.
E.g.
MyImg.filters.transition.status
would return the current status of the 'transition' filter that has been applied to the element object referenced by 'MyImg'.
length
The length
property returns the number of elements in the collection. Note that the length
count starts at 1, not 0 as the filters collection index does. Therefore, the length
property may return a value of 5, but to access the 3rd element, you'd need to use element.filters(2).property
item
The item
method retrieves single items, or sub-collections from the filters collection. It accepts the following arguments:
all.item(index, sub-index)
If index
is a number, then the method returns a reference to the filter object at that position in the filter collections index, for the referenced element. I.e.
strTag=MyImg.filters.item(2).duration
would make strTag
equal the value of the duration
property of the 3rd filter applied to the element.
If the index
property is a string value, then the item
method returns a sub-collection, containing a reference to every filter attached to the element that has the same name as the value of the string that is the index
argument. To retrieve certain element objects from this sub-collection, the sub-index
argument must be used.
© 1995-1998, Stephen Le Hunte