GdPictureImaging.TiffInsertPageFromFile Method

Inserts a new page from file at the given position an editable multipage tiff image. Page has to be a number smaller or equal than the current number of pages available in the multipage tiff image.

public GdPictureStatus TiffInsertPageFromFile(
    int ImageID, 
    int Position, 
    String FilePath
);

Visual Basic

Public Function TiffInsertPageFromFile(
    ByVal ImageID As Integer, 
    ByVal Position As Integer, 
    ByVal FilePath As String
) As GdPictureStatus

Parameters

Parameters	Description
ImageID	GdPicture Image Identifier. The editable multipage tiff image in which the page will be inserted.
Position	The position to add the new page. Must be a value from 1 to the current number of pages available in the multipage tiff image.
FilePath	The path of the image to append within the editable multipage tiff image.

Returns

A member of the GdPictureStatus enumeration.

Remarks

This function can only be used with an editable multipage tiff image.

To check if an image is an editable multipage tiff image you can use the TiffIsEditableMultiPage() function.

To save modifications brought to the multipage tiff image you need to use the TiffSaveMultiPageToFile() function.

Supported formats are RAW, PICT, BMP, DIB, RLE, ICO, EMF, WMF, GIF, ANIMATED GIF, JPEG, JPG, JPE, JFIF, PNG, TIFF, MULTIPAGE TIFF, PNM, PPM, PBM, PGM, PFM, RPPM, RPGM, RPBM, PCX, XPM, XBM, WBMP, TGA, SGI, Sun RAS, PSD, MNG, Kodak PhotoCD files, KOALA files, JP2, J2K, JNG, JBIG, IFF, HDR, Raw Fax G3, EXR, DDS and Dr. Halo files.