共用方式為


FORMATETC 結構 (objidl.h)

代表一般剪貼簿格式。 它經過增強,包含目標裝置、資料的方面或視圖,以及儲存媒體指示器。 在人們可能期望找到剪貼簿格式的地方,OLE 會改用 FORMATETC 資料結構。 此結構會做為需要資料格式資訊的 OLE 函式和方法中的參數。

語法

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

Members

cfFormat

感興趣的剪貼簿格式。 OLE 可辨識的格式有三種類型:

  • 標準交換格式,例如 CF_TEXT。
  • 只有提供該格式的應用程式或提供類似功能的其他應用程式才能理解的專用應用程式格式。
  • OLE 格式,用來建立連結或內嵌物件。

ptd

DVTARGETDEVICE 結構的指標,其中包含正在撰寫資料之目標裝置的相關資訊。 每當指定的資料格式與目標裝置無關,或呼叫端不在乎使用什麼裝置時,就會使用 NULL 值。 在後一種情況下,如果數據需要目標裝置,物件應該挑選適當的預設裝置 (通常是視覺元件的顯示) 。 從具有 NULL 目標裝置的物件取得的資料,例如大部分的中繼檔,與目標裝置無關。 產生的資料通常與使用者從 [檔案] 功能表中選擇 [另存新檔] 命令並選取交換格式時相同。

dwAspect

指出彩現中應包含多少細節。 此參數應該是其中一個 DVASPECT 列舉值。 單一剪貼簿格式可以支援物件的多個層面或視圖。 大部分的資料和簡報傳輸和快取方法都會傳遞方面資訊。 例如,呼叫端可能會要求物件的圖示圖片,並使用中繼檔案剪貼簿格式來擷取它。 請注意,dwAspect 中只能使用一個 DVASPECT 值。 也就是說, dwAspect 不能是數個 DVASPECT 值布林值 OR 運算的結果。

lindex

資料必須跨頁面邊界分割的部分方面。 最常見的值是 -1,它識別所有資料。 零開始的索引應該用於 CFSTR_FILECONTENTS 格式。 對於DVASPECT_THUMBNAIL和DVASPECT_ICON的方面,lindex 被忽略。

tymed

其中一個 TYMED 列舉常數,指出用來傳輸物件資料的儲存媒體類型。 可以使用對對象有意義的任何介質來傳輸數據。 例如,可以使用全域記憶體、磁碟檔案或結構化儲存物件來傳遞資料。 如需詳細資訊,請參閱 TYMED 列舉。

備註

資料傳輸及呈現介面中的方法會使用 FORMATETC 結構,做為指定所傳輸資料的參數。 例如, IDataObject::GetData 方法會使用 FORMATETC 結構來指出呼叫端所要求的資料類型。

需求

Requirement 價值觀
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
Header objidl.h

另請參閱

DV方面

IData建議持有人

IData物件

IEnumFORMAT等

IOleCache

奧爾創造

OleCreateFromData

OleCreateLink

OleCreateLinkFromData

OleCreateLinkToFile

OleCreateStaticFromData

統計數據

STG介質

泰姆德