FORMATETC 구조체(objidl.h)

아티클
08/25/2023

일반화된 클립보드 형식을 나타냅니다. 대상 디바이스, 데이터의 측면 또는 보기 및 스토리지 중간 표시기를 포함하도록 향상되었습니다. 클립보드 형식을 찾을 것으로 예상되는 경우 OLE는 FORMATETC 데이터 구조를 대신 사용합니다. 이 구조체는 데이터 형식 정보가 필요한 OLE 함수 및 메서드에서 매개 변수로 사용됩니다.

구문

typedef struct tagFORMATETC {
  CLIPFORMAT     cfFormat;
  DVTARGETDEVICE *ptd;
  DWORD          dwAspect;
  LONG           lindex;
  DWORD          tymed;
} FORMATETC, *LPFORMATETC;

멤버

cfFormat

관심 있는 클립보드 형식입니다. OLE에서 인식하는 형식에는 다음 세 가지 유형이 있습니다.

표준 교환 형식(예: CF_TEXT)
전용 애플리케이션 형식 또는 유사한 기능을 제공 하는 다른 애플리케이션 형식을 제공 하는 애플리케이션에 의해서만 이해 합니다.
연결된 개체 또는 포함된 개체를 만드는 데 사용되는 OLE 형식입니다.

ptd

데이터가 구성되는 대상 디바이스에 대한 정보를 포함하는 DVTARGETDEVICE 구조체에 대한 포인터입니다. NULL 값은 지정된 데이터 형식이 대상 디바이스와 독립적이거나 호출자가 사용되는 디바이스를 신경 쓰지 않을 때마다 사용됩니다. 후자의 경우, 데이터 대상 디바이스를 요구 하는 경우 개체는 해당 하는 기본 디바이스 (종종 시각적 구성 요소에 대 한 디스플레이)를 선택 해야 합니다. 대부분의 메타파일과 같이 NULL 대상 디바이스가 있는 개체에서 가져온 데이터는 대상 디바이스와 독립적입니다. 결과 데이터는 일반적으로 사용자가 파일 메뉴에서 다른 이름으로 저장 명령을 선택하고 교환 형식을 선택한 경우와 동일합니다.

dwAspect

렌더링에 포함해야 하는 세부 정보를 나타냅니다. 이 매개 변수는 DVASPECT 열거형 값 중 하나여야 합니다. 단일 클립보드 형식은 개체의 여러 측면 또는 보기를 지원할 수 있습니다. 대부분의 데이터 및 프레젠테이션 전송 및 캐싱 메서드는 측면 정보를 전달합니다. 예를 들어 호출자는 메타파일 클립보드 형식을 사용하여 개체의 상징적인 그림을 검색하도록 요청할 수 있습니다. DVASPECT 값은 dwAspect에서 하나만 사용할 수 있습니다. 즉, dwAspect 은 여러 DVASPECT 값에 대한 부울 OR 작업의 결과일 수 없습니다.

lindex

데이터가 페이지 경계를 넘어 분할되어야 하는 경우 측면의 일부입니다. 가장 일반적인 값은 모든 데이터를 식별하는 -1입니다. DVASPECT_THUMBNAIL 및 DVASPECT_ICON 측면의 경우 린덱스는 무시됩니다.

tymed

개체의 데이터를 전송하는 데 사용되는 스토리지 매체의 유형을 나타내는 TYMED 열거형 상수 중 하나입니다. 개체에 적합한 매체를 사용하여 데이터를 전송할 수 있습니다. 예를 들어 글로벌 메모리, 디스크 파일 또는 구조화된 스토리지 개체를 사용하여 데이터를 전달할 수 있습니다. 자세한 내용은 TYMED 열거형을 참조하세요.

설명

FORMATETC 구조는 데이터 전송 및 프레젠테이션 인터페이스의 메서드에서 전송되는 데이터를 지정하는 매개 변수로 사용됩니다. 예를 들어 IDataObject::GetData 메서드는 FORMATETC 구조를 사용하여 호출자가 요청하는 데이터의 종류를 정확히 나타냅니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
머리글	objidl.h