iTunes COM Interface: IITVisualCollection Interface Reference

iTunes COM

IITVisualCollection Interface Reference

List of all members.

Detailed Description

Represents a collection of visual plug-in objects.

The IiTunes::Visuals property returns the collection of visual plug-ins.

Public Member Functions

Properties
HRESULT Count ([out, retval] long *count)
 Returns the number of visual plug-ins in the collection.
HRESULT Item ([in] long index,[out, retval] IITVisual **iVisual)
 Returns an IITVisual object corresponding to the given index (1-based).
HRESULT ItemByName ([in] BSTR name,[out, retval] IITVisual **iVisual)
 Returns an IITVisual object with the specified name.
HRESULT _NewEnum ([out, retval] IUnknown **iEnumerator)
 Returns an IEnumVARIANT object which can enumerate the collection.

Member Function Documentation

HRESULT IITVisualCollection::_NewEnum [out, retval] IUnknown **  iEnumerator  ) 
 

Returns an IEnumVARIANT object which can enumerate the collection.

Note:
This property is available in iTunes 4.7 and later (iTunes type library 1.2 and later).
Parameters:
iEnumerator Returns an IEnumVARIANT object which can enumerate the collection.
Return values:
S_OK The operation was successful.
E_POINTER iEnumerator is NULL.
E_FAIL An unexpected error occurred.

HRESULT IITVisualCollection::Count [out, retval] long *  count  ) 
 

Returns the number of visual plug-ins in the collection.

Parameters:
count Returns the number of visual plug-ins in the collection.
Return values:
S_OK The operation was successful.
E_POINTER count is NULL.
E_FAIL An unexpected error occurred.

HRESULT IITVisualCollection::Item [in] long  index,
[out, retval] IITVisual **  iVisual
 

Returns an IITVisual object corresponding to the given index (1-based).

Parameters:
index 1-based index of IITVisual to retrieve.
iVisual Returns an IITVisual object corresponding to the specified index.
Return values:
S_OK The operation was successful.
S_FALSE index is too big.
E_INVALIDARG index is less than one.
E_POINTER iVisual is NULL.
E_FAIL An unexpected error occurred.

HRESULT IITVisualCollection::ItemByName [in] BSTR  name,
[out, retval] IITVisual **  iVisual
 

Returns an IITVisual object with the specified name.

Parameters:
name 1-based index of IITVisual to retrieve.
iVisual Returns an IITVisual object with the specified name.
Return values:
S_OK The operation was successful.
S_FALSE A visual plug-in with the specified name could not be found.
E_POINTER name or iVisual is NULL.
E_FAIL An unexpected error occurred.


Generated on Fri Mar 13 12:50:54 2009 for iTunes 8.1.0.52
©2004-2007 Apple Computer, Inc.