Image::GetPropertyItemSize-Methode (gdiplusheaders.h)

Artikel
08/24/2023

Die Image::GetPropertyItemSize-Methode ruft die Größe eines angegebenen Eigenschaftselements dieses Image-Objekts in Bytes ab.

Syntax

UINT GetPropertyItemSize(
  [in] PROPID propId
);

Parameter

[in] propId

Typ: PROPID

Ganze Zahl, die das Eigenschaftselement identifiziert.

Rückgabewert

Typ: UINT

Diese Methode gibt die Größe eines angegebenen Eigenschaftselements dieses Image-Objekts in Bytes zurück.

Hinweise

Die Image::GetPropertyItem-Methode gibt ein PropertyItem-Objekt zurück. Bevor Sie Image::GetPropertyItem aufrufen, müssen Sie einen Puffer zuordnen, der groß genug ist, um dieses Objekt zu empfangen. Die Größe variiert je nach Datentyp und Wert des Eigenschaftselements. Sie können die Image::GetPropertyItemSize-Methode eines Image-Objekts aufrufen, um die Größe des erforderlichen Puffers in Bytes abzurufen.

Beispiele

Im folgenden Beispiel wird ein Image-Objekt basierend auf einer JPEG-Datei erstellt. Der Code ruft die Image::GetPropertyItemSize-Methode des Image-Objekts auf, um die Größe des Eigenschaftselements abzurufen, das die Kamera enthält, die zum Erfassen des Bilds verwendet wird. Anschließend ruft der Code die Image::GetPropertyItem-Methode auf, um dieses Eigenschaftselement abzurufen.

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

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

   UINT size = 0;
   PropertyItem* propertyItem = NULL;
   Image* image = new Image(L"FakePhoto.jpg");

   // Assume that the image has a property item of type PropertyItemEquipMake.
   // Get the size of that property item.
   size = image->GetPropertyItemSize(PropertyTagEquipMake);

   // Allocate a buffer to receive the property item.
   propertyItem = (PropertyItem*)malloc(size);

   // Get the property item.
   image->GetPropertyItem(PropertyTagEquipMake, size, propertyItem);

   // Display the members of the retrieved PropertyItem object.
   printf("The length of the property item is %u.\n", propertyItem->length);
   printf("The data type of the property item is %u.\n", propertyItem->type);

   if(propertyItem->type == PropertyTagTypeASCII)
      printf("The value of the property item is %s.\n", propertyItem->value);

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

Der vorangehende Code hat zusammen mit einer bestimmten Datei FakePhoto.jpg die folgende Ausgabe erzeugt. Beachten Sie, dass der Datentyp 2 ist. Dies ist der Wert der PropertyTagTypeASCII-Konstante, die in Gdiplusimaging.h definiert ist.

The length of the property item is 17.
The data type of the property item is 2.
The value of the property item is Northwind Traders.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll