다음을 통해 공유


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

Image::RemovePropertyItem 메서드는 이 Image 개체에서 속성 항목(메타데이터 조각)을 제거합니다.

구문

Status RemovePropertyItem(
  [in] PROPID propId
);

매개 변수

[in] propId

형식: PROPID

제거할 속성 항목을 식별하는 정수입니다.

반환 값

형식: 상태

메서드가 성공하면 Status 열거형의 요소인 Ok를 반환합니다.

메서드가 실패하면 Status 열거형의 다른 요소 중 하나를 반환합니다.

설명

Image::RemovePropertyItem 메서드는 Image 개체에서 지정된 속성을 제거하지만 해당 속성 항목은 Image 개체를 생성하는 데 사용된 파일 또는 스트림에서 제거되지 않습니다. 이미지(속성 항목이 제거됨)를 새 JPEG 파일 또는 스트림에 저장하려면 Image 개체의 Save 메서드를 호출합니다.

예제

다음 예제에서는 JPEG 파일을 기반으로 Image 개체를 만듭니다. 이 코드는 Image::RemovePropertyItem 메서드를 호출하여 Image 개체에서 PropertyTagEquipMake 속성 항목을 제거합니다. 이 코드는 Image::GetPropertyItemSize 를 두 번(항목을 제거하기 전과 제거 후 한 번) 호출하여 PropertyTagEquipMake 속성 항목의 크기를 확인합니다. 코드는 이미지 파일에서 속성 항목을 제거하지 않습니다. Image 개체에서만 속성 항목을 제거합니다.

#include <windows.h>
#include <gdiplus.h>
#include <stdio.h>
using namespace Gdiplus;

INT main()
{
   GdiplusStartupInput gdiplusStartupInput;
   ULONG_PTR gdiplusToken;
   GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, NULL);

   Image* image = new Image(L"FakePhoto3.jpg");
   UINT size = 0;

   size = image->GetPropertyItemSize(PropertyTagEquipMake);
   printf("The size of the PropertyTagEquipMake item is %u.\n", size);

   image->RemovePropertyItem(PropertyTagEquipMake);   

   size = image->GetPropertyItemSize(PropertyTagEquipMake);
   printf("The size of the PropertyTagEquipMake item is %u.\n", size);

   delete image;
   GdiplusShutdown(gdiplusToken);
   return 0;
}

위의 코드는 특정 파일과 함께 FakePhoto3.jpg 다음 출력을 생성했습니다.

The size of the PropertyTagEquipMake item is 33.
The size of the PropertyTagEquipMake item is 0.

요구 사항

   
지원되는 최소 클라이언트 Windows XP, Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 gdiplusheaders.h(Gdiplus.h 포함)
라이브러리 Gdiplus.lib
DLL Gdiplus.dll

참고 항목

이미지

이미지::GetAllPropertyItems

이미지::GetPropertyCount

이미지::GetPropertyIdList

이미지::GetPropertyItem

이미지::GetPropertyItemSize

이미지::GetPropertySize

이미지::SetPropertyItem

PropertyItem

메타데이터 읽기 및 쓰기