SaveAsPDF(Int32,String,String,String,String,String,String,PdfEncryption,PdfRight,String,String) Method

In This Topic

Saves a GdPicture image as single page pdf with encryption.

Syntax

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

'Declaration
 
Public Overloads Function SaveAsPDF( _
   ByVal ImageID As Integer, _
   ByVal FilePath As String, _
   ByVal Title As String, _
   ByVal Author As String, _
   ByVal Subject As String, _
   ByVal Keywords As String, _
   ByVal Creator As String, _
   ByVal Encryption As PdfEncryption, _
   ByVal Rights As PdfRight, _
   ByVal UserPassword As String, _
   ByVal OwnerPassword As String _
) As GdPictureStatus

public GdPictureStatus SaveAsPDF( 
   int ImageID,
   string FilePath,
   string Title,
   string Author,
   string Subject,
   string Keywords,
   string Creator,
   PdfEncryption Encryption,
   PdfRight Rights,
   string UserPassword,
   string OwnerPassword
)

public function SaveAsPDF( 
    ImageID: Integer;
    FilePath: String;
    Title: String;
    Author: String;
    Subject: String;
    Keywords: String;
    Creator: String;
    Encryption: PdfEncryption;
    Rights: PdfRight;
    UserPassword: String;
    OwnerPassword: String
): GdPictureStatus;

public function SaveAsPDF( 
   ImageID : int,
   FilePath : String,
   Title : String,
   Author : String,
   Subject : String,
   Keywords : String,
   Creator : String,
   Encryption : PdfEncryption,
   Rights : PdfRight,
   UserPassword : String,
   OwnerPassword : String
) : GdPictureStatus;

public: GdPictureStatus SaveAsPDF( 
   int ImageID,
   string* FilePath,
   string* Title,
   string* Author,
   string* Subject,
   string* Keywords,
   string* Creator,
   PdfEncryption Encryption,
   PdfRight Rights,
   string* UserPassword,
   string* OwnerPassword
)

public:
GdPictureStatus SaveAsPDF( 
   int ImageID,
   String^ FilePath,
   String^ Title,
   String^ Author,
   String^ Subject,
   String^ Keywords,
   String^ Creator,
   PdfEncryption Encryption,
   PdfRight Rights,
   String^ UserPassword,
   String^ OwnerPassword
)

Parameters

ImageID: GdPicture image identifier.
FilePath: The complete PDF file path to save a GdPicture image. Can be an empty string. If empty, prompts the user to select a file. You can subsequently use the GetLastPath() method to retrieve the path of the selected file.
Title: The title of the PDF.
Author: The PDF Author.
Subject: The PDF Subject.
Keywords: The PDF Keywords.
Creator: The name of the application which creates the PDF.
Encryption: A member of the PdfEncryption enumeration. Note: AES 256 encyption is not yet available.
Rights: A value returned by the PdfCreateRights method.
UserPassword: The user password for the PDF. Can be an empty string.
OwnerPassword: The owner password for the PDF. Can be an empty string.

Return Value

A member of the GdPictureStatus enumeration.

Remarks

This method requires the PDF Processing component to run.

Example

Saving the image as a PDF document specifying document properties and pdf rights.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("");
    if (gdpictureImaging.GetStat() == GdPictureStatus.OK)
    {
        // Get the file path of the loaded image file.
        string filePath = gdpictureImaging.GetLastPath();
        string pdfPath = System.IO.Path.ChangeExtension(filePath, ".pdf");
 
        // Get the current version of the GdPicture.NET toolkit.
        string version = (gdpictureImaging.GetVersion()).ToString();
        version = version.Insert(version.IndexOf('.') + 2, ".");
        
        // Create pdf rights for saving.
        PdfRight pdfRights = gdpictureImaging.PdfCreateRights(true, false, true, true, false, false, false, true);
        
        // Define the document properties when saving, for example, the current version of the GdPicture.NET toolkit and the pdf rights.
        gdpictureImaging.SaveAsPDF(imageID, filepath, "Saving image as PDF", "GdPicture ver." + version.ToString(), "For test", "image, pdf", "Orpalis", PdfEncryption.PdfEncryption256BitAES, pdfRights, "userpassw", "ownerpassw");
 
        gdpictureImaging.ReleaseGdPictureImage(imageID);
    }
    else
        MessageBox.Show("An image can't be created.\nError: " + gdpictureImaging.GetStat().ToString(), "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List