Image::SetPropertyItem 메서드(gdiplusheaders.h)

아티클
02/29/2024

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