FORMATTC-Struktur (objidl.h)

Artikel
03/06/2024

Stellt ein generalisiertes Zwischenablageformat dar. Es wird erweitert, um ein Zielgerät, den Aspekt oder die Ansicht der Daten und einen Speichermediumindikator zu umfassen. Wo man möglicherweise ein Zwischenablageformat erwartet, verwendet OLE stattdessen eine FORMATTC-Datenstruktur . Diese Struktur wird als Parameter in OLE-Funktionen und -Methoden verwendet, die Datenformatinformationen erfordern.

Syntax

typedef struct tagFORMATETC {
  CLIPFORMAT     cfFormat;
  DVTARGETDEVICE *ptd;
  DWORD          dwAspect;
  LONG           lindex;
  DWORD          tymed;
} FORMATETC, *LPFORMATETC;

Member

cfFormat

Das gewünschte Zwischenablageformat. Es gibt drei Typen von Formaten, die von OLE erkannt werden:

Standardaustauschformate, z. B. CF_TEXT.
Private Anwendungsformate, die nur von der Anwendung verstanden werden, die das Format anbietet, oder von anderen Anwendungen, die ähnliche Funktionen bieten.
OLE-Formate, die zum Erstellen von verknüpften oder eingebetteten Objekten verwendet werden.

ptd

Ein Zeiger auf eine DVTARGETDEVICE-Struktur , die Informationen über das Zielgerät enthält, für das die Daten erstellt werden. Ein NULL-Wert wird immer dann verwendet, wenn das angegebene Datenformat unabhängig vom Zielgerät ist oder wenn es dem Aufrufer egal ist, welches Gerät verwendet wird. Wenn die Daten ein Zielgerät erfordern, sollte das Objekt ein geeignetes Standardgerät auswählen (häufig die Anzeige für visuelle Komponenten). Daten, die von einem Objekt mit einem NULL-Zielgerät abgerufen werden, z. B. die meisten Metadateien, sind vom Zielgerät unabhängig. Die resultierenden Daten sind in der Regel identisch mit dem, wenn der Benutzer im Menü Datei den Befehl Speichern unter und ein Austauschformat ausgewählt hätte.

dwAspect

Gibt an, wie viele Details im Rendering enthalten sein sollen. Dieser Parameter sollte einer der DVASPECT-Enumerationswerte sein. Ein einzelnes Zwischenablageformat kann mehrere Aspekte oder Ansichten des Objekts unterstützen. Die meisten Daten- und Präsentationsübertragungs- und -zwischenspeicherungsmethoden übergeben Aspektinformationen. Beispielsweise kann ein Aufrufer das ikonische Bild eines Objekts anfordern, indem er das Metadatei-Zwischenablageformat verwendet, um es abzurufen. Beachten Sie, dass in dwAspect nur ein DVASPECT-Wert verwendet werden kann. Das heißt, dwAspect kann nicht das Ergebnis eines booleschen OR-Vorgangs für mehrere DVASPECT-Werte sein.

lindex

Teil des Aspekts, wenn die Daten über Seitengrenzen hinweg aufgeteilt werden müssen. Der gebräuchlichste Wert ist -1, der alle Daten identifiziert. Für die Aspekte DVASPECT_THUMBNAIL und DVASPECT_ICON wird lindex ignoriert.

tymed

Eine der TYMED-Enumerationskonstanten, die den Typ des Speichermediums angibt, das zum Übertragen der Daten des Objekts verwendet wird. Daten können mit jedem für das Objekt sinnvollen Medium übertragen werden. Beispielsweise können Daten mithilfe des globalen Arbeitsspeichers, einer Datenträgerdatei oder strukturierter Speicherobjekte übergeben werden. Weitere Informationen finden Sie in der TYMED-Enumeration .

Hinweise

Die FORMATTC-Struktur wird von Methoden in den Datenübertragungs- und Präsentationsschnittstellen als Parameter verwendet, der die übertragenen Daten angibt. Die IDataObject::GetData-Methode verwendet beispielsweise die FORMATTC-Struktur , um genau anzugeben, welche Art von Daten der Aufrufer anfordert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Kopfzeile	objidl.h