Image::SetPropertyItem 메서드(gdiplusheaders.h)
Image::SetPropertyItem 메서드는 이 Image 개체에 대한 속성 항목(메타데이터 조각)을 설정합니다. 항목이 이미 있는 경우 해당 내용이 업데이트됩니다. 그렇지 않으면 새 항목이 추가됩니다.
구문
Status SetPropertyItem(
[in] const PropertyItem *item
);
매개 변수
[in] item
형식: const PropertyItem*
설정할 속성 항목을 지정하는 PropertyItem 개체에 대한 포인터입니다.
반환 값
형식: 상태
메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.
메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.
설명
특정 이미지 형식(예: ICON 및 EMF)은 속성을 지원하지 않습니다. 속성을 지원하지 않는 이미지에서 Image::SetPropertyItem 메서드를 호출하면 PropertyNotSupported가 반환됩니다.
예제
다음 콘솔 애플리케이션은 JPEG 파일을 기반으로 Image 개체를 만듭니다. 코드는 해당 Image 개체의 Image::SetPropertyItem 메서드를 호출하여 이미지의 제목을 설정합니다. 그런 다음 코드는 새 제목을 검색하고 표시합니다.
#include <windows.h>
#include <gdiplus.h>
#include <stdio.h>
using namespace Gdiplus;
INT main()
{
GdiplusStartupInput gdiplusStartupInput;
ULONG_PTR gdiplusToken;
GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, NULL);
// Create an Image object based on a JPEG file.
Image* image = new Image(L"FakePhoto.jpg");
// Set the image title.
PropertyItem* propItem = new PropertyItem;
CHAR newTitleValue[] = "Fake Photograph 2";
propItem->id = PropertyTagImageTitle;
propItem->length = 18; // includes null terminator
propItem->type = PropertyTagTypeASCII;
propItem->value = newTitleValue;
image->SetPropertyItem(propItem);
// Get and display the new image title.
UINT size = image->GetPropertyItemSize(PropertyTagImageTitle);
PropertyItem* title = (PropertyItem*)malloc(size);
image->GetPropertyItem(PropertyTagImageTitle, size, title);
printf("The image title is %s.\n", title->value);
free(title);
delete propItem;
delete image;
GdiplusShutdown(gdiplusToken);
return 0;
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP, Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | gdiplusheaders.h(Gdiplus.h 포함) |
| 라이브러리 | Gdiplus.lib |
| DLL | Gdiplus.dll |