PDFCreator Control Properties

The properties of the PDFCreator control allow the user to change different aspects of its behavior.

 

Property

Description

Type

Values

Default Value

Copyright

*ReadOnly

Return’s the assembly’s copyright attitude.

String

    

Document

*ReadOnly

Returns a reference to the Document object.

IacDocument

    

GridCtrlInterface

*WriteOnly

Specifies  the Grid control to use when the option is enabled.

IacGridCtrl

    

HorizontalScrollBar

Displays a horizontal scroll bar when true.

Boolean

True/False

True

MeasurementUnit

Unit of measurement used for the ruler bars and status bar.

Integer

0x0000: Millimeters

0x0001: Inches

0x0002: Twips

0x0000: Millimeters

PropertiesCtrlInterface

*WriteOnly

Specifies  the Properties control to use when the option is selected in the Contextual Menu of the object.

IacPropertiesCtrl

    

ReportView

Specifies the type of view.

enum IacReportViewType

0: acReportViewPage.

1: acReportViewTable.

2: acReportViewPageContinuous.

3: acReportViewFacingPages.

4: acReportViewFacingPagesContinuous.

0: acReportViewPage

RulerBackColor

Background color for rulers.

Color

  

LightGray (system dependent)

RulerSize

Height of horizontal ruler and width of vertical ruler in Pixels.

Integer

>= 0

25 pixels

ShowMargins

When set to True, show page margins as thin lines around the page.

Boolean

True/False

False

StatusBar

Hide/Display status bar.

Boolean

True/False

True

TooltipText

Tooltip text shows when the mouse hovers over the control.

String

    

VerticalNavigationBar

Hide/Display vertical navigation bar.

Boolean

True/False

True

VerticalScrollBar

When set to False, hide vertical scroll bar.

Boolean

True/False

True

WantsTab

When True, Tab keys are handled by the control.

Boolean

True/False

True

 

 

Properties Whose values are Simple Data Types

These could be strings, integers, or floating point values. Below is a small example that hides the status bar, and changes the look of the rulers on the control.

 

Boolean properties are actually integers. In C++ they are treated the same. If you are programming in .NET, an integer value needs to be used and a direct Boolean will cause a compile error.

 

Example

Public Sub Sample()


    ' Constants for Activation codes


    Const strLicenseTo As String = "Amyuni PDF Creator .NET Evaluation"


    Const strActivationCode As String = "07EFCDAB0100010025C3B7B351579FF94C49112EAF7368612744C7237C2F6A215A53E83A9ECCFFE54C52063CB05338BDE555773D7B1B"


 


    ' Initialize library


    ' This should be done once


    acPDFCreatorLib.Initialize()


 


    ' set license key This is needed only with licensed version


    acPDFCreatorLib.SetLicenseKey(strLicenseTo, strActivationCode)


 


    ' Display properties from PDFCreator Object in the form


    MsgBox(PdfCreator1.HorizontalScrollBar)


    MsgBox(PdfCreator1.ReportView)


    MsgBox(PdfCreator1.RulerSize)


    MsgBox(PdfCreator1.StatusBar)


 


    ' terminate library to free resources


    acPDFCreatorLib.Terminate()


End Sub


public void Sample()


{


    // Constants for Activation codes


    const string strLicenseTo = "Amyuni PDF Creator .NET Evaluation";


    const string strActivationCode = "07EFCDAB0100010025C3B7B351579FF94C49112EAF7368612744C7237C2F6A215A53E83A9ECCFFE54C52063CB05338BDE555773D7B1B";


 


    // Initialize library


    // This should be done once


    acPDFCreatorLib.Initialize();


 


    // set license key This is needed only with licensed version


    acPDFCreatorLib.SetLicenseKey(strLicenseTo, strActivationCode);


 


    // Display properties from PDFCreator Object in the form


    MessageBox.Show(PdfCreator1.HorizontalScrollBar.ToString());


    MessageBox.Show(PdfCreator1.ReportView.ToString());


    MessageBox.Show(PdfCreator1.RulerSize.ToString());


    MessageBox.Show(PdfCreator1.StatusBar.ToString());


 


    // terminate library to free resources


    acPDFCreatorLib.Terminate();


}