Freigeben über


Die FORMATETC-Struktur

Die FORMATETC-Struktur ist ein generalisiertes Zwischenablageformat, das erweitert wurde, um ein Zielgerät, einen Aspekt oder eine Ansicht der Daten und ein Speichermedium einzuschließen. Ein Datenverbraucher, z. B. eine OLE-Containeranwendung, übergibt die FORMATTC-Struktur als Argument in Aufrufen von IDataObject , um den gewünschten Datentyp aus einer Datenquelle anzugeben, z. B. ein zusammengesetztes Dokumentobjekt. Die Quelle verwendet die FORMATTC-Struktur , um zu beschreiben, welche Formate sie bereitstellen können.

FORMATETC kann praktisch alle Daten beschreiben, einschließlich anderer Objekte wie Moniker. Ein Container kann eines seiner eingebetteten Objekte auffordern, seine Datenformate auflisten zu können, indem IDataObject::EnumFormatEtc aufgerufen wird, das ein Enumerationsobjekt zurückgibt, das die IEnumFORMATETC-Schnittstelle implementiert. Anstatt nur darauf zu antworten, dass es "Text und eine Bitmap" enthält, kann das Objekt eine detaillierte Beschreibung der Daten bereitstellen, einschließlich des Geräts (normalerweise Bildschirm oder Drucker), für den er gerendert wird, der Aspekt, der dem Benutzer angezeigt werden soll (vollständiger Inhalt, Miniaturansicht, Symbol oder formatiert für den Druck), und das Speichermedium, das die Daten enthält (globaler Speicher, Datenträgerdatei, Speicherobjekt oder Datenstrom). Diese Möglichkeit, Daten eng zu beschreiben, führt rechtzeitig zu einer höheren Qualität des Druckers und der Bildschirmausgabe sowie zu einer effizienteren Datensuche, bei der eine Miniaturansichtsskizze viel schneller abgerufen und angezeigt werden kann als ein vollständig detailliertes Rendering.

In der folgenden Tabelle sind Felder der FORMATTC-Datenstruktur und die von ihnen angegebenen Informationen aufgeführt.

Feld Spezifiziert
cfFormat
Das Format, in dem die Daten gerendert werden sollen, kann ein Standard-Zwischenablageformat, ein proprietäres Format oder ein OLE-Format sein. Weitere Informationen zu OLE-Formaten finden Sie unter Zusammengesetzte Dokumente.
Ptd
Eine DVTARGETDEVICE-Struktur , die genügend Informationen zu einem Windows-Zielgerät enthält, z. B. einen Bildschirm oder Drucker, damit ein Handle für den Gerätekontext (hDC) mithilfe der CreateDC-Funktion erstellt werden kann.
dwAspect
Der Aspekt oder die Ansicht der zu rendernden Daten; kann der vollständige Inhalt, eine Miniaturansicht, ein Symbol oder für den Druck formatiert sein.
lindex
Der Teil des Aspekts, der von Interesse ist. Der häufigste Wert ist -1, der angibt, dass die gesamte Ansicht von Interesse ist. Nullbasierter Index sollte für CFSTR_FILECONTENTS Format verwendet werden.
tymed
Das Speichermedium der Daten, das globalen Speicher, eine Datei auf Datenträger oder eine Instanz einer strukturierten Speicherschnittstelle von COM sein kann.

Datenformate und Übertragungsmedien