IacDocument.StartSave Method

The StartSave method is used to start page by page saving of a document.

 

Syntax

Visual Basic .NET:

Public Function StartSave(stream As System.IO.Stream, option As Amyuni.PDFCreator.IacFileSaveOption) As Boolean  

C#:

public bool StartSave(System.IO.Stream stream , Amyuni.PDFCreator.IacFileSaveOption option)

 

Parameters

stream

.NET stream object where the PDF document will be stored.

option

Part of the document to save.

 

This method, only the acFileSaveView option of FileSaveOptionConstants is supported.

Option

Value

Description

acFileSaveView

1

Save only the document view.

The document can be viewed with any PDF viewer including Amyuni PDF Creator, but all design data such as database connection, OLE objects, is lost.

 

 

Return Value

Returns Value True if the call succeeded and False otherwise. This method launches an exception if an error occurs while saving the document.

 

Remarks

If the option parameter is not specified, the default acFileSaveDefault value is used.

 

Member of Amyuni.PDFCreator.IacDocument.

Example

Sub Sample()
    ' Constants for Activation codes
    Const strLicenseTo As String = "Amyuni PDF Creator .NET Evaluation"
    Const strActivationCode As String = "07EFCDAB0100010025C3B7B3DF579FF94C49112EAF736861254447237C2F6A215A53E83A9ECCFFE54C52063CB05338BDE555773D7B1B"
 
    ' Initialize library
    ' This should be done once
    acPDFCreatorLib.Initialize()
 
    ' set license key This is needed only with licensed version
    acPDFCreatorLib.SetLicenseKey(strLicenseTo, strActivationCode)
 
    ' Create a new PDF document
    Dim doc As New Amyuni.PDFCreator.IacDocument()
 
    ' Switch to design mode before adding objects to the document
    doc.ReportState = Amyuni.PDFCreator.IacReportState.acReportStateDesign
 
    ' Create 4 additional pages
    For pageNumber = 2 To 5
        doc.AddPage(pageNumber)
    Next
 
    ' Create page object
    Dim page As Amyuni.PDFCreator.IacPage
 
    ' Create object in each Page
    For pageNumber = 1 To 5
        ' Define first page of PDF document
        page = doc.GetPage(pageNumber)
 
        ' Create a text
        With page.CreateObject(Amyuni.PDFCreator.IacObjectType.acObjectTypeText, "acObjectTypeText")
            .Attribute("Left").Value = 1000
            .Attribute("Top").Value = 0
            .Attribute("Right").Value = 3250
            .Attribute("Bottom").Value = 500
            .Attribute("BackColor").Value = 192
            .Attribute("Hyperlink").Value = "http://www.amyuni.com"
            .Attribute("Text").Value = "Amyuni Technologies"
        End With
 
    Next
    ' Switch to run mode after objects to the document
    doc.ReportState = Amyuni.PDFCreator.IacReportState.acReportStateRun
 
    ' Create new stream object
    Dim fileWrite As System.IO.Stream = System.IO.File.OpenWrite("C:\temp\CreatePDFDocument_resulting.pdf")
 
    ' Save PDF File
    doc.StartSave(fileWrite, Amyuni.PDFCreator.IacFileSaveOption.acFileSaveView)
 
    ' Save the first 5 pages
    For pageNumber = 1 To 5
        doc.SavePageNumber(pageNumber)
    Next
 
    ' End Save
    doc.EndSave()
 
    ' Close the stream
    fileWrite.Close()
 
    ' terminate library to free resources
    acPDFCreatorLib.Terminate()
 
    ' destroy objects
    doc.Dispose()
End Sub
static void Sample()
{
    // Constants for Activation codes
    const string strLicenseTo = "Amyuni PDF Creator .NET Evaluation";
    const string strActivationCode = "07EFCDAB0100010025C3B7B3DF579FF94C49112EAF736861254447237C2F6A215A53E83A9ECCFFE54C52063CB05338BDE555773D7B1B";
 
    // Initialize library
    // This should be done once
    acPDFCreatorLib.Initialize();
 
    // set license key This is needed only with licensed version
    acPDFCreatorLib.SetLicenseKey(strLicenseTo, strActivationCode);
 
    // Create a new PDF document
    Amyuni.PDFCreator.IacDocument doc = new Amyuni.PDFCreator.IacDocument();
 
    // Switch to design mode before adding objects to the document
    doc.ReportState = Amyuni.PDFCreator.IacReportState.acReportStateDesign;
 
    // Create 4 additional pages
    for (int pageNumber = 2; pageNumber <= 5; pageNumber++)
    {
        doc.AddPage(pageNumber);
    }
 
    // Create page object
    Amyuni.PDFCreator.IacPage page;
 
    // Create object in each Page
    for (int pageNumber = 2; pageNumber <= 5; pageNumber++)
    {
        // Define first page of PDF document
        page = doc.GetPage(pageNumber);
 
        // Create a text
        using (Amyuni.PDFCreator.IacObject oText =
            page.CreateObject(Amyuni.PDFCreator.IacObjectType.acObjectTypeText, "Text1"))
        {
            oText.Attribute("Left").Value = 1000;
            oText.Attribute("Top").Value = 0;
            oText.Attribute("Right").Value = 3250;
            oText.Attribute("Bottom").Value = 500;
            oText.Attribute("BackColor").Value = 192;
            oText.Attribute("Hyperlink").Value = "http://www.amyuni.com";
            oText.Attribute("Text").Value = "Amyuni Technologies";
        }
    }
 
    // Switch to run mode after objects to the document
    doc.ReportState = Amyuni.PDFCreator.IacReportState.acReportStateRun;
 
    // Create new stream object
    System.IO.FileStream fileWrite = new System.IO.FileStream(@"C:\temp\CreatePDFDocument_resulting.pdf",
        System.IO.FileMode.Create,
        System.IO.FileAccess.Write,
        System.IO.FileShare.Read);
 
    // Save PDF File
    doc.StartSave(fileWrite, Amyuni.PDFCreator.IacFileSaveOption.acFileSaveView);
 
    // Save the first 5 pages
    for (int pageNumber = 1; pageNumber <= 5; pageNumber++)
    {
        doc.SavePageNumber(pageNumber);
    }
 
    // End Save
    doc.EndSave();
 
    // Close the stream
    fileWrite.Close();
 
    // terminate library to free resources
    acPDFCreatorLib.Terminate();
 
    // destroy objects
    doc.Dispose();
}