ClipboardObject.IDataObject.GetCanonicalFormatEtc メソッド

より複雑な構造体と論理的に等価な、標準の FORMATETC 構造体を提供します。FORMATETC の 2 個の構造体が同じデータを返すかどうかを判断するには、このメソッドを使用して、重複するレンダリングする必要性を削除します。

名前空間:  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<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
    以降の呼び出しのデータを取得するために使用する、呼び出し元の形式が、中間結果とターゲット デバイスを定義する IDataObject.GetDataなど、参照渡し FORMATETC の構造体への参照。tymed メンバーは、この場合には重要ではないため、無視する必要があります。
  • pformatetcOut
    型 : array<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
    このメソッドから制御が戻るときに、特定の表示で最も一般的な情報を格納している FORMATETC 構造体へのポインターを格納し、pformatectIn と規準的等価にします。呼び出し元でこの構造体を割り当て、GetCanonicalFormatEtc メソッドでデータを格納する必要があります。指定された値が nullnull 参照 (Visual Basic では Nothing)でない場合、後続のデータを、IDataObject.GetDataなど、呼び出し元の使用 pformatetcOutの指定された値取得します。この値は、メソッドがを返した場合 DATA_S_SAMEFORMATETCnull です。tymed メンバーは、この場合には重要ではないため、無視する必要があります。このパラメーターは初期化せずに渡されます。

戻り値

型 : System.Int32
このメソッドは、標準の戻り値 E_INVALIDARG、E_FAIL、E_UNEXPECTEDと E_OUTOFMEMORY、次をサポートします:

値

説明

S_OK

返された FORMATETC の構造は渡されたものとは異なります。

DATA_S_SAMEFORMATETC

FORMATETC の構造は同じであり、pformatetcOut のパラメーターに null 参照を返します。

DV_E_LINDEX

lindex に無効な値があります。現在は -1 だけがサポートされています。

DV_E_FORMATETC

pformatectIn パラメーターに無効な値があります。

OLE_E_NOTRUNNING

アプリケーションが実行されていません。

実装

IDataObject.GetCanonicalFormatEtc(array<FORMATETC[], array<FORMATETC[])

解説

クリップボードのオブジェクトが既存の IDataObject ( Microsoft.VisualStudio.OLE.Interop の名前空間) でラップした場合、このメソッドはデリゲートその名前空間の対応する GetCanonicalFormatEtc の呼び出し。それ以外の場合は、クリップボードのオブジェクトが既存の IDataObjectをラップすることができます System.Runtime.InteropServices.ComTypes の名前空間からの呼び出しを GetCanonicalFormatEtc に変換しようとします。

.NET Framework セキュリティ

  • 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

ClipboardObject クラス

Microsoft.VisualStudio.Data.Framework 名前空間

  • Last updated on