ClipboardObject.IDataObject.GetCanonicalFormatEtc メソッド
より複雑な構造体と論理的に等価な、標準の FORMATETC 構造体を提供します。FORMATETC の 2 個の構造体が同じデータを返すかどうかを判断するには、このメソッドを使用して、重複するレンダリングする必要性を削除します。
名前空間: Microsoft.VisualStudio.Data.Framework
アセンブリ: Microsoft.VisualStudio.Data.Framework (Microsoft.VisualStudio.Data.Framework.dll 内)
構文
'宣言
Private Function GetCanonicalFormatEtc ( _
ByRef formatIn As FORMATETC, _
<OutAttribute> ByRef formatOut As FORMATETC _
) As Integer Implements IDataObject.GetCanonicalFormatEtc
int IDataObject.GetCanonicalFormatEtc(
ref FORMATETC formatIn,
out FORMATETC formatOut
)
private:
virtual int GetCanonicalFormatEtc(
FORMATETC% formatIn,
[OutAttribute] FORMATETC% formatOut
) sealed = IDataObject::GetCanonicalFormatEtc
private abstract GetCanonicalFormatEtc :
formatIn:FORMATETC byref *
formatOut:FORMATETC byref -> int
private override GetCanonicalFormatEtc :
formatIn:FORMATETC byref *
formatOut:FORMATETC byref -> int
JScript では、明示的なインターフェイスの実装はサポートされません。
パラメーター
- formatIn
型 : System.Runtime.InteropServices.ComTypes.FORMATETC%
以降の呼び出しのデータを取得するために使用する、呼び出し元の形式が、中間結果とターゲット デバイスを定義する IDataObject.GetDataなど、参照渡し FORMATETC の構造体への参照。tymed メンバーは、この場合には重要ではないため、無視する必要があります。
- formatOut
型 : System.Runtime.InteropServices.ComTypes.FORMATETC%
このメソッドが返されるとき、このパラメーターに固有のレンダリングに適したできる一般的な情報を含む pformatectInには、それを標準的にする FORMATETC の構造体へのポインターが格納されます。呼び出し元は、この構造を割り当て GetCanonicalFormatEtc のメソッドはデータを入力する必要があります。指定された値が nullnull 参照 (Visual Basic では Nothing)でない場合、後続のデータを、IDataObject.GetDataなど、呼び出し元の使用 pformatetcOutの指定された値取得します。この値は、メソッドがを返した場合 DATA_S_SAMEFORMATETCnull です。tymed メンバーは、この場合には重要ではないため、無視する必要があります。このパラメーターは初期化せずに渡されます。
戻り値
型 : System.Int32
このメソッドは、標準の戻り値 E_INVALIDARG、E_UNEXPECTEDと E_OUTOFMEMORY、次をサポートします:
値 |
説明 |
|---|---|
S_OK |
返された FORMATETC の構造は渡されたものとは異なります。 |
DATA_S_SAMEFORMATETC |
FORMATETC の構造は同じであり、formatOut のパラメーターに null 参照を返します。 |
DV_E_LINDEX |
lindex に無効な値があります。現在は -1 だけがサポートされています。 |
DV_E_FORMATETC |
formatIn パラメーターに無効な値があります。 |
OLE_E_NOTRUNNING |
アプリケーションが実行されていません。 |
実装
IDataObject.GetCanonicalFormatEtc(FORMATETC%, FORMATETC%)
解説
このメソッドは、クリップボードのオブジェクトが既存の IDataObjectをラップしていると仮定する System.Runtime.InteropServices.ComTypes の名前空間からの対応する GetCanonicalFormatEtc の呼び出しに委任します。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。