IDataObject 介面 (objidl.h)
啟用數據變更的數據傳輸和通知。 數據傳輸方法會指定傳輸的數據格式,以及傳輸數據的媒體。 您可以選擇性地針對特定目標裝置轉譯數據。 除了擷取和儲存數據的方法之外, IDataObject 介面還會指定列舉可用格式的方法,以及管理處理變更通知之諮詢接收的連接。
數據物件一詞用來表示支援 IDataObject 介面實作的任何物件。 實作會根據需要執行的數據物件而有所不同;在某些數據物件中,物件不支援之某些方法的實作可能只是傳回E_NOTIMPL。 例如,某些數據對象不允許呼叫端傳送數據。 其他數據物件不支持諮詢連線和變更通知。 不過,對於支援變更通知的數據物件,OLE 會提供稱為數據建議持有者的物件。 這個持有者的介面指標可透過呼叫 Helper 函式 CreateDataAdviseHolder 取得。 數據物件可以有多個連接,每個連接都有自己的一組屬性。 OLE 數據建議持有者可簡化管理這些連線和傳送適當通知的工作。
繼承
IDataObject 介面繼承自 IUnknown 介面。 IDataObject 也有下列類型的成員:
方法
IDataObject 介面具有這些方法。
IDataObject::D Advise 由支持建議接收的物件呼叫,以建立數據對象與建議接收之間的連線。 這可讓建議接收收到對象數據變更的通知。 |
IDataObject::D Unadvise 終結先前設定的通知連線。 |
IDataObject::EnumDAdvise 建立可以用來列舉目前諮詢連接的物件。 |
IDataObject::EnumFormatEtc 建立物件以列舉數據物件所支援的格式。 |
IDataObject::GetCanonicalFormatEtc 提供可能不同的但邏輯上相等的 FORMATETC 結構。 您可以使用這個方法來判斷兩個不同的 FORMATETC 結構是否會傳回相同的數據,並移除重複轉譯的需求。 |
IDataObject::GetData 由數據取用者呼叫,以從源數據物件取得數據。 |
IDataObject::GetDataHere 由數據取用者呼叫,以從源數據物件取得數據。 這個方法與 GetData 方法不同,因為呼叫端必須配置並釋放指定的儲存媒體。 |
IDataObject::QueryGetData 判斷數據物件是否能夠依指定轉譯數據。 嘗試貼上或卸除作業的物件可以在呼叫 IDataObject::GetData 之前呼叫此方法,以取得作業是否可能成功的指示。 |
IDataObject::SetData 由包含數據源的物件呼叫,以將數據傳送至實作這個方法的物件。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | objidl.h |