Export (0) Print
Expand All

IEnumFORMATETC interface

Enumerates the FORMATETC structures that define the formats and media supported by a given data object.

When to implement

IEnumFORMATETC must be implemented by all data objects to support calls to IDataObject::EnumFormatEtc, which supplies a pointer to the enumerator's IEnumFORMATETC interface. If the data object supports a different set of FORMATETC information depending on the direction of the data (whether a call is intended for the SetData or GetData method of IDataObject), the implementation of IEnumFORMATETC must be able to operate on both.

The order of formats enumerated through the IEnumFORMATETC object should be the same as the order that the formats would be in when placed on the clipboard. Typically, this order starts with private data formats and ends with presentation formats such as CF_METAFILEPICT.

When to use

Call the methods of IEnumFORMATETC to enumerate the FORMATETC structures defining the formats and media supported by a given data object. This is necessary in most data transfer operations, such as clipboard and drag-and-drop, so the object on the other end of the data transfer can determine whether the appropriate format and media for the data is supported.

Members

The IEnumFORMATETC interface inherits from the IUnknown interface. IEnumFORMATETC also has these types of members:

Methods

The IEnumFORMATETC interface has these methods.

MethodDescription
Clone

Creates a new enumerator that contains the same enumeration state as the current one.

Next

Retrieves the specified number of items in the enumeration sequence.

Reset

Resets the enumeration sequence to the beginning.

Skip

Skips over the specified number of items in the enumeration sequence.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IEnumFORMATETC is defined as 00000103-0000-0000-C000-000000000046

 

 

Community Additions

ADD
Show:
© 2014 Microsoft