共用方式為

ClipboardObject.IDataObject.GetCanonicalFormatEtc 方法

  • 發行項

提供標準的 FORMATETC 結構，這個結構在邏輯上相當於更複雜的結構。 使用這個方法會判斷兩個 FORMATETC 結構是否傳回相同的資料，而不需要重複呈現。

命名空間：  Microsoft.VisualStudio.Data.Framework
組件：  Microsoft.VisualStudio.Data.Framework (在 Microsoft.VisualStudio.Data.Framework.dll 中)

語法

'宣告
Private Function GetCanonicalFormatEtc ( _
    pformatectIn As FORMATETC(), _
    pformatetcOut As FORMATETC() _
) As Integer Implements IDataObject.GetCanonicalFormatEtc

int IDataObject.GetCanonicalFormatEtc(
    FORMATETC[] pformatectIn,
    FORMATETC[] pformatetcOut
)

private:
virtual int GetCanonicalFormatEtc(
    array<FORMATETC>^ pformatectIn, 
    array<FORMATETC>^ pformatetcOut
) sealed = IDataObject::GetCanonicalFormatEtc

private abstract GetCanonicalFormatEtc : 
        pformatectIn:FORMATETC[] * 
        pformatetcOut:FORMATETC[] -> int  
private override GetCanonicalFormatEtc : 
        pformatectIn:FORMATETC[] * 
        pformatetcOut:FORMATETC[] -> int

JScript 不支援明確介面實作。

參數

  • pformatectIn
    類型：array<FORMATETC[]

    in FORMATETC 結構的參考，以傳址方式傳遞的，定義格式、媒體和目標裝置呼叫端要用來擷取在後續的資料，例如 IDataObject.GetData。 tymed 成員在這種情況下並不重要，可以略過。

  • pformatetcOut
    類型：array<FORMATETC[]

    當這個方法傳回時，會包含 FORMATETC 結構的指標，結構中含有特定呈現可能適用的最普遍資訊，使它在標準上相當於 pformatectIn。 呼叫端必須配置這個結構，而且 GetCanonicalFormatEtc 方法必須填入資料。 擷取在後續的資料，例如 IDataObject.GetData，呼叫端會使用 pformatetcOut的提供值，，除非提供值為 nullnull 參考 (即 Visual Basic 中的 Nothing)。 如果方法傳回 DATA_S_SAMEFORMATETC，這個值為 null。 tymed 成員在這種情況下並不重要，可以略過。 這個參數會以未初始化的狀態傳遞。

傳回值

類型：Int32
這個方法支援標準傳回值 E_INVALIDARG、 E_FAIL、 E_UNEXPECTED和 E_OUTOFMEMORY，以及下列值:

值

Description

S_OK

傳回的 FORMATETC 結構與傳遞的結構不同。

DATA_S_SAMEFORMATETC

FORMATETC 結構相同，且此參考傳回在 pformatetcOut 參數。

DV_E_LINDEX

lindex 有一個無效的值；目前只支援 -1。

DV_E_FORMATETC

pformatectIn 參數有一個無效的值。

OLE_E_NOTRUNNING

沒有執行應用程式。

實作

IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

備註

如果剪貼簿物件包裝現有的 IDataObject (從 Microsoft.VisualStudio.OLE.Interop 命名空間)，這個方法委派給對應的 GetCanonicalFormatEtc 呼叫該命名空間。 否則，，以免 Clipboard 物件可以在現有的 IDataObject，它會嘗試呼叫轉譯為從 System.Runtime.InteropServices.ComTypes 命名空間的 GetCanonicalFormatEtc 。

.NET Framework 安全性

請參閱

參考

ClipboardObject 類別

Microsoft.VisualStudio.Data.Framework 命名空間