GetTargetFormat Method

Visual Basic
C#
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Function GetTargetFormat() As ImGearFormats

'Usage
 
Dim instance As ImGearMetadataHead
Dim value As ImGearFormats
 
value = instance.GetTargetFormat()

public ImGearFormats GetTargetFormat()

public: ImGearFormats GetTargetFormat();

public:
ImGearFormats GetTargetFormat();

Return Value

ImageGear.Formats.ImGearFormats enumeration object that is a copy of the current instance.

The target format is the file format to which the current metadata tree can be saved. For example, if ImGearPage has been loaded from a JFIF JPEG image, its target format is JPEG. The application can modify metadata tags and save the image back to JPEG; modified metadata will be saved to the resultant file. However, if target format is JPEG, and the image is saved to BMP, metadata modifications will not be saved to the result file, because of incompatibilities with the metadata formats.

The target format can affect the functionality of the Simplified Metadata API. A simplified metadata accessor can be initialized for the metadata tree only if it has a compatible target format. For example, if the target format is TIFF or JPEG, the application can initialize an IPTC accessor for the metadata tree and add IPTC tags. But if target format is BMP, adding an IPTC accessor will result in an exception.

Reference

ImGearMetadataHead Class
ImGearMetadataHead Members
ImGearFormats Enumeration