ImageItemData 클래스(gdiplusimaging.h)

ImageItemData 클래스는 사용자 지정 이미지 메타데이터를 저장하고 검색하는 데 사용됩니다. Windows GDI+는 JPEG, PNG 및 GIF 이미지 파일에 대한 사용자 지정 메타데이터를 지원합니다.

ImageItemData 에는 다음과 같은 유형의 멤버가 있습니다.

설명

이미지 파일에서 사용자 지정 메타데이터를 검색하려면 Image::GetItemData를 호출합니다. 이미지 파일에 사용자 지정 메타데이터를 저장하려면 다음 단계를 수행합니다.

1. ImageItemData 개체를 만들고 초기화합니다.
2. 하나 이상의 EncoderParameter 개체 배열이 있는 EncoderParameters 개체를 만듭니다.
3. 배열의 EncoderParameter 개체 중 하나에 대해 Value 멤버를 ImageItemData 개체의 주소로 설정합니다. Guid = EncoderImageItems, Type = EncoderParameterValueTypePointer, NumberOfValues = 1과 같이 다른 멤버를 설정합니다.
4. EncoderParameters 개체의 주소를 Image 개체의 Image::Save 메서드에 전달합니다.

예제

다음 예제에서는 사용자 지정 메타데이터의 일부를 JPEG 파일에 저장합니다. 이 코드는 도우미 함수인 GetEncoderClsid를 사용하여 JPEG 인코더에 대한 클래스 식별자를 가져옵니다. GetEncoderClsid의 소스 코드를 보려면 인코더에 대한 클래스 식별자 검색을 참조하세요.

CHAR myData[] = "Byte sequence of your choice";
BYTE description = 0xE4;

ImageItemData itemData;
itemData.Size = sizeof(itemData);
itemData.DescSize = 1;
itemData.Desc = &description;
itemData.DataSize = 28;
itemData.Data = (VOID*)myData;
itemData.Position = ItemDataPositionAfterHeader;

// Get the Clsid of the JPEG encoder.
CLSID encoderClsid;
GetEncoderClsid(L"image/jpeg", &encoderClsid);

EncoderParameters encoderParameters;
encoderParameters.Count = 1;
encoderParameters.Parameter[0].Guid = EncoderImageItems;
encoderParameters.Parameter[0].Type = EncoderParameterValueTypePointer;
encoderParameters.Parameter[0].NumberOfValues = 1; 
encoderParameters.Parameter[0].Value = &itemData;

Image image(L"River.jpg");
image.Save(L"River2.jpg", &encoderClsid, &encoderParameters);

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	gdiplusimaging.h(Gdiplus.h 포함)