Profile Object

The Profile object controls document interface, protection and optimization options used for document conversion.

Remarks

The Profile object allows you to control all those options that can be setup in Document Options window when converting documents manually but at programmatic conversion. These options include interface, protection and optimization options. In addition, this object can be used to change default document options shown in Default Document Options window.

There are three possible scenarios of using Profile object:

• For specifying special (ad hoc) options applied to a single conversion or series of conversion. In such a case you should create a Profile object, setup its properties and pass it to ConvertFile or ConvertDir methods as a Profile argument;
• For changing default document options applied to all document conversions performed via a single Server object instance. In such a case you should obtain reference to the default profile using DefaultProfile property and change its properties. Then you may convert files with this Server object instance and all the options you setup will be applied to all document conversions via this instance;
• For changing default document options shown in Default Document Options window.  In such a case you should obtain a reference to the default profile using DefaultProfile property, change its properties and save the changes using ApplyChanges method. 

Object access

To create an ad hoc Profile object, you need to create it using "P2F.Profile" ProgID such as in the following example:

set MyProfile=CreateObject("P2F.Profile")

Set DefProfile=P2F.DefaultProfile

Here P2F refers to Server object instance.

Regardless of the method you obtained a profile, initially it contains the default document option settings as they have been setup in Default Document Options window. The difference between an ad hoc and default profile instances is that you cannot save an ad hoc profile and that default profile settings are used if no profile is specified at conversion. After you obtained a reference to Profile object using one of the methods above, you can access its properties and methods.

Properties
 

Methods
 

ApplyChanges

Method saves the default profile.

Signature

ApplyChanges()

Arguments

None

Remarks

Methods saves the default profile. The method should be called only for default profile obtained via DefaultProfile property of Server object. If you intend to change the global default profile properties, you need to call this method to save the changes.

Examples

The following example obtains a default profile, modifies some of its properties and save the changes back to default profile. The example assumes that enumeration constants file P2FAPIConst.vb from Print2Flash SDK is included:

Set DefProfile=P2F.DefaultProfile
DefProfile.InterfaceOptions = INTLOGO or NTZOOMSLIDER or INTFITWIDTH or INTFITPAGE or INTPREVPAGE or INTNEXTPAGE
DefProfile.ProtectionOptions = PROTDISPRINT or PROTDISTEXTCOPY
DefProfile.FlashVersion = 8
DefProfile.UseJpeg = True
DefProfile.JpegQuality = 80
DefProfile.ApplyChanges

Profile Object Examples

The sample below creates an ad hoc profile, sets its properties and use it for conversion of a document named C:\Docs\MyDoc.doc

Set MyProfile=CreateObject("P2F.Profile")
MyProfile.InterfaceOptions = INTLOGO or INTDRAG or INTSELTEXT or INTGOTOPAGE
MyProfile.ProtectionOptions = PROTENAPI
P2F.ConvertFile "C:\Docs\MyDoc.doc", , MyProfile

Set DefProfile=P2F.DefaultProfile
DefProfile.InterfcaeOptions = INTDRAG Or INTZOOMBOX Or INTFITWIDTH Or INTPREVPAGE Or INTNEXTPAGE or INTPRINT
DefProfile.UseJpeg = True
DefProfile.JpegQuality = 60
P2F.ConvertFile "C:\Docs\MyDoc.doc"
P2F.ConvertFile "C:\Docs\Finance.xls"