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[]

    에 대 한 참조는 FORMATETC 구조, 형식, 매체 및 호출자와 같은 후속 호출에서 데이터를 검색 하는 데 사용 하려는 대상 장치를 정의 하는 참조로 전달 된 IDataObject.GetData. 이 경우 tymed 멤버는 중요하지 않으므로 무시됩니다.

  • pformatetcOut
    형식: array<FORMATETC[]

    이 메서드가 반환될 때 특정 렌더링에 사용할 수 있는 가장 일반적인 정보가 들어 있는 FORMATETC 구조체에 대한 포인터를 pformatectIn과 같은 형식으로 포함합니다. 호출자는 이 구조체를 할당하고 GetCanonicalFormatEtc 메서드가 데이터를 채워야 합니다. 와 같은 후속 호출에서 데이터를 검색할 수 IDataObject.GetData, 제공 된 값을 사용 하는 호출자가 pformatetcOut, 제공 된 값이 nullNull 참조(Visual Basic의 경우 Nothing). 메서드가 반환 하는 경우이 값이 DATA_S_SAMEFORMATETC. 이 경우 tymed 멤버는 중요하지 않으므로 무시됩니다. 이 매개 변수는 초기화되지 않은 상태로 전달됩니다.

반환 값

형식: Int32
이 메서드는 표준 반환 값 지원 E_INVALIDARG, E_FAIL, E_UNEXPECTED, 및 E_OUTOFMEMORY, 뿐만 아니라 다음.

값

설명

S_OK

반환 된 FORMATETC 구조체는 전달 된 것과에서 다릅니다.

DATA_S_SAMEFORMATETC

FORMATETC 구조는 동일 하 고에 null 참조가 반환 되는 pformatetcOut 매개 변수입니다.

DV_E_LINDEX

에 대 한 잘못 된 값이 lindex. 현재-1만 지원 됩니다.

DV_E_FORMATETC

pformatectIn 매개 변수의 값이 잘못된 경우

OLE_E_NOTRUNNING

응용 프로그램이 실행되고 있지 않은 경우

구현

IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

설명

기존의 clipboard 개체 래핑하는 경우 IDataObject (에서 Microsoft.VisualStudio.OLE.Interop 네임 스페이스),이 메서드는 해당 호출을 위임 GetCanonicalFormatEtc 해당 네임 스페이스에서입니다. 그렇지 않으면 변환에 대 한 호출을 시도 GetCanonicalFormatEtc 에서 System.Runtime.InteropServices.ComTypes 네임 스페이스를 clipboard 개체의 경우 수 배치는 기존 IDataObject.

.NET Framework 보안

참고 항목

참조

ClipboardObject 클래스

Microsoft.VisualStudio.Data.Framework 네임스페이스