PortFolioCreate(String,PdfPortFolioType) Method

In This Topic

Converts a common PDF document into a PDF Portfolio file. You need to specify the file name of that embedded file you want to display on opening the PDF Portfolio and the view mode users can view the component files in.

Please note that your source PDF document must contain at least one embedded (attached) file, otherwise this method will fail. It is also not allowed to create a PDF Portfolio file if your source PDF document is PDF/A compliant.

Syntax

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

'Declaration
 
Public Overloads Function PortFolioCreate( _
   ByVal FirstFileNameToShow As String, _
   ByVal ViewMode As PdfPortFolioType _
) As GdPictureStatus

public GdPictureStatus PortFolioCreate( 
   string FirstFileNameToShow,
   PdfPortFolioType ViewMode
)

public function PortFolioCreate( 
    FirstFileNameToShow: String;
    ViewMode: PdfPortFolioType
): GdPictureStatus;

public function PortFolioCreate( 
   FirstFileNameToShow : String,
   ViewMode : PdfPortFolioType
) : GdPictureStatus;

public: GdPictureStatus PortFolioCreate( 
   string* FirstFileNameToShow,
   PdfPortFolioType ViewMode
)

public:
GdPictureStatus PortFolioCreate( 
   String^ FirstFileNameToShow,
   PdfPortFolioType ViewMode
)

Parameters

FirstFileNameToShow: The file name of that embedded file, which is initially presented in the user interface on opening the PDF Portfolio.
ViewMode: A member of the PdfPortFolioType enumeration. Sets the view mode users can view the component files in.

Return Value

A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK.

We strongly recommend always checking this status first.

Remarks

This method is only allowed for use with non-encrypted documents.

The PDF version of the newly created PDF Portfolio is 1.7.

Example

How to create a PDF Portfolio containing a collection of three files.

VB.NET
C#

Dim caption As String = "Example: PortFolioCreate"
Dim gdpicturePDF As New GdPicturePDF()
'Creating a new common PDF file.
If (gdpicturePDF.NewPDF() <> GdPictureStatus.OK) OrElse (gdpicturePDF.NewPage(PdfPageSizes.PdfPageSizeLetter) <> GdPictureStatus.OK) Then
    MessageBox.Show("The new PDF document can't be created.", caption)
Else
    'Embedding the files into the created PDF file.
    If (gdpicturePDF.EmbedFile("textfile.txt", "1st attachmment") <> GdPictureStatus.OK) OrElse (gdpicturePDF.EmbedFile("docfile.docx", "2nd attachment") <> GdPictureStatus.OK) OrElse (gdpicturePDF.EmbedFile("pdffile.pdf", "3rd attachment") <> GdPictureStatus.OK) Then
        MessageBox.Show("The files can't be attached.", caption)
    Else
        'Creating a PDF Portfolio.
        Dim status As GdPictureStatus = gdpicturePDF.PortFolioCreate("textfile.txt", PdfPortFolioType.Detail)
        If status = GdPictureStatus.OK Then
            If gdpicturePDF.SaveToFile("gdpicturepdf_portfolio.pdf") = GdPictureStatus.OK Then
                MessageBox.Show("The PDF Portfolio file has been created and saved successfully.", caption)
            End If
        Else
            MessageBox.Show("The PortFolioCreate() method has failed with the status: " + status.ToString(), caption)
        End If
    End If
End If
gdpicturePDF.Dispose()

string caption = "Example: PortFolioCreate";
GdPicturePDF gdpicturePDF = new GdPicturePDF();
//Creating a new common PDF file.
if ((gdpicturePDF.NewPDF() != GdPictureStatus.OK) ||
    (gdpicturePDF.NewPage(PdfPageSizes.PdfPageSizeLetter) != GdPictureStatus.OK))
{
    MessageBox.Show("The new PDF document can't be created.", caption);
}
else
{
    //Embedding the files into the created PDF file.
    if ((gdpicturePDF.EmbedFile("textfile.txt", "1st attachmment") != GdPictureStatus.OK) ||
        (gdpicturePDF.EmbedFile("docfile.docx", "2nd attachment") != GdPictureStatus.OK) ||
        (gdpicturePDF.EmbedFile("pdffile.pdf", "3rd attachment") != GdPictureStatus.OK))
    {
        MessageBox.Show("The files can't be attached.", caption);
    }
    else
    {
        //Creating a PDF Portfolio.
        GdPictureStatus status = gdpicturePDF.PortFolioCreate("textfile.txt", PdfPortFolioType.Detail);
        if (status == GdPictureStatus.OK)
        {
            if (gdpicturePDF.SaveToFile("gdpicturepdf_portfolio.pdf") == GdPictureStatus.OK)
            {
                MessageBox.Show("The PDF Portfolio file has been created and saved successfully.", caption);
            }
        }
        else
        {
            MessageBox.Show("The PortFolioCreate() method has failed with the status: " + status.ToString(), caption);
        }
     }
}
gdpicturePDF.Dispose();

Reference

GdPicturePDF Class
GdPicturePDF Members
Overload List
GetPDFAConformance Method
IsPortFolio Method
EmbedFile(String,String) Method
DeleteEmbeddedFile Method
GetEmbeddedFileCount Method
NewPDF Method
SaveToFile(String) Method