LoadOptions type holds level of abstraction on individual load options More...

#include "LoadOptions.h"

Inherits System::Object.

Inherited by Aspose::Pdf::ApsLoadOptions, Aspose::Pdf::CdrLoadOptions, Aspose::Pdf::CgmLoadOptions, Aspose::Pdf::DjvuLoadOptions, Aspose::Pdf::EpubLoadOptions, Aspose::Pdf::HtmlLoadOptions, Aspose::Pdf::MdLoadOptions, Aspose::Pdf::MhtLoadOptions, Aspose::Pdf::OfdLoadOptions, Aspose::Pdf::PclLoadOptions, Aspose::Pdf::PdfXmlLoadOptions, Aspose::Pdf::PsLoadOptions, Aspose::Pdf::SvgLoadOptions, Aspose::Pdf::TeXLoadOptions, Aspose::Pdf::TxtLoadOptions, Aspose::Pdf::XmlLoadOptions, and Aspose::Pdf::XpsLoadOptions.

Classes

class  ResourceLoadingResult
 Result of custom loading of resource More...
 

Public Types

enum  MarginsAreaUsageModes { MarginsAreaUsageModes::PutContentOnMarginAreaIfNecessary = 0, MarginsAreaUsageModes::NeverPutContentOnMarginArea = 1 }
 Represents mode of usage of margins area during conversion (like HTML, EPUB etc), defines treatement of instructions of imported format related to usage of margins. More...
 
enum  PageSizeAdjustmentModes { PageSizeAdjustmentModes::NoAjustmentAllwaysUsePredefinedSize = 0, PageSizeAdjustmentModes::EnlargeRequiredViewportWidthAndDoConversionAgain = 1 }
 ATTENTION! The feature implemented but did not put yet to public API since blocker issue in OSHARED layer revealed for sample document. More...
 
using ResourceLoadingStrategy = System::MulticastDelegate< System::SharedPtr< LoadOptions::ResourceLoadingResult >(System::String)>
 
- Public Types inherited from System::Object
typedef SmartPtr< Objectptr
 Alias for smart pointer type. More...
 

Public Member Functions

ASPOSE_PDF_SHARED_API System::SharedPtr< IWarningCallbackget_WarningHandler () const
 Callback to handle any warnings generated. The WarningHandler returns ReturnAction enum item specifying either Continue or Abort. Continue is the default action and the Load operation continues, however the user may also return Abort in which case the Load operation should cease. More...
 
ASPOSE_PDF_SHARED_API void set_WarningHandler (System::SharedPtr< IWarningCallback > value)
 Callback to handle any warnings generated. The WarningHandler returns ReturnAction enum item specifying either Continue or Abort. Continue is the default action and the Load operation continues, however the user may also return Abort in which case the Load operation should cease. More...
 
ASPOSE_PDF_SHARED_API Aspose::Pdf::LoadFormat get_LoadFormat () const
 Represents file format which LoadOptions describes. More...
 
ASPOSE_PDF_SHARED_API bool get_DisableFontLicenseVerifications () const
 Gets flag to disable any license restrictions for all fonts while loading the file. When , allows to execute operations with font that are prohibited by a license of this font, for example allows to embed a font into a PDF document even if license rules disable embedding for this font. By default . More...
 
ASPOSE_PDF_SHARED_API void set_DisableFontLicenseVerifications (bool value)
 Sets flag to disable any license restrictions for all fonts while loading the file. When , allows to execute operations with font that are prohibited by a license of this font, for example allows to embed a font into a PDF document even if license rules disable embedding for this font. By default . More...
 
ASPOSE_PDF_SHARED_API LoadOptions ()
 
- Public Member Functions inherited from System::Object
ASPOSECPP_SHARED_API Object ()
 Creates object. Initializes all internal data structures. More...
 
virtual ASPOSECPP_SHARED_API ~Object ()
 Destroys object. Frees all internal data structures. More...
 
ASPOSECPP_SHARED_API Object (Object const &x)
 Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
Objectoperator= (Object const &x)
 Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
ObjectSharedRefAdded ()
 Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int SharedRefRemovedSafe ()
 Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int RemovedSharedRefs (int count)
 Decreases shared reference count by specified value. More...
 
Detail::SmartPtrCounter * WeakRefAdded ()
 Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
void WeakRefRemoved ()
 Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
Detail::SmartPtrCounter * GetCounter ()
 Gets reference counter data structure associated with the object. More...
 
int SharedCount () const
 Gets current value of shared reference counter. More...
 
ASPOSECPP_SHARED_API void Lock ()
 Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...
 
ASPOSECPP_SHARED_API void Unlock ()
 Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...
 
virtual ASPOSECPP_SHARED_API bool Equals (ptr obj)
 Compares objects using C# Object.Equals semantics. More...
 
virtual ASPOSECPP_SHARED_API int32_t GetHashCode () const
 Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...
 
virtual ASPOSECPP_SHARED_API String ToString () const
 Analog of C# Object.ToString() method. Enables converting custom objects to string. More...
 
virtual ASPOSECPP_SHARED_API ptr MemberwiseClone () const
 Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...
 
virtual ASPOSECPP_SHARED_API const TypeInfoGetType () const
 Gets actual type of object. Analog of C# System.Object.GetType() call. More...
 
virtual ASPOSECPP_SHARED_API bool Is (const TypeInfo &targetType) const
 Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...
 
virtual ASPOSECPP_SHARED_API void SetTemplateWeakPtr (uint32_t argument)
 Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...
 
virtual ASPOSECPP_SHARED_API bool FastCast (const Details::FastRttiBase &helper, void **out_ptr) const
 For internal purposes only. More...
 
template<>
bool Equals (float const &objA, float const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 
template<>
bool Equals (double const &objA, double const &objB)
 Emulates C#-style floating point comparison where two NaNs are considered equal even though according to IEC 60559:1989 NaN is not equal to any value, including NaN. More...
 
template<>
bool ReferenceEquals (String const &str, std::nullptr_t)
 Specialization of Object::ReferenceEquals for case of string and nullptr. More...
 
template<>
bool ReferenceEquals (String const &str1, String const &str2)
 Specialization of Object::ReferenceEquals for case of strings. More...
 

Protected Attributes

Aspose::Pdf::LoadFormat _loadFormat
 
UsageMode _usageMode
 
System::String ApsIntermediateFileIfAny
 
System::String XpsIntermediateFileIfAny
 
System::String PngIntermediateFileIfAny
 
ApsToXpsSavingMode ApsAsXpsSavingType
 
System::String PlainApsIntermediateTempFileIfAny
 Sometimes we need use temp file to save APS during conversion to avoid OOM exceptions in PalZipWriter For such hard tests can be used this parameter - it will force usage of ile instead of MemoryStream More...
 
bool UseAreaClipping
 
System::SharedPtr< Aspose::Pdf::PagePage
 

Static Protected Attributes

static const int32_t DefaultBatchSize
 

Additional Inherited Members

- Static Public Member Functions inherited from System::Object
static bool ReferenceEquals (ptr const &objA, ptr const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, T const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, std::nullptr_t)
 Reference-compares value type object with nullptr. More...
 
template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares reference type objects in C# style. More...
 
template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares value type objects in C# style. More...
 
static const TypeInfoType ()
 Implements C# typeof(System.Object) construct. More...
 

Detailed Description

LoadOptions type holds level of abstraction on individual load options

Member Typedef Documentation

◆ ResourceLoadingStrategy

Member Enumeration Documentation

◆ MarginsAreaUsageModes

Represents mode of usage of margins area during conversion (like HTML, EPUB etc), defines treatement of instructions of imported format related to usage of margins.

Enumerator
PutContentOnMarginAreaIfNecessary 

In this mode converter obeyes format of imported document (f.e. CSS of imported HTML) in usage of margins area.So, if format of imported document requires usage of margins area for rendering , converter will allow that

NeverPutContentOnMarginArea 

This mode strictly forbids usage of margins area, so, converter will never use area of margins for rendering, even if CSS or format of source document allows or requirs that

◆ PageSizeAdjustmentModes

ATTENTION! The feature implemented but did not put yet to public API since blocker issue in OSHARED layer revealed for sample document.

Represents mode of usage of page size during conversion. Formats (like HTML, EPUB etc), usually have float design, so, it allows to fit required pagesize. But sometimes content has specifies horizontal positions or size that does not allow put content into required page size. In such case we can define what should be done in this case (i.e when size of content does not fit required initial page size of result PDF document).

Enumerator
NoAjustmentAllwaysUsePredefinedSize 

In this mode result pages will have required pagesize defined in LoadOptions, no matter whether content after conversion goes out of page boundaries or no.

EnlargeRequiredViewportWidthAndDoConversionAgain 

This mode defines such behaviour: after getting of conversion result , and detecting of fact that some content has been truncated, width of portview is enlarged to fit content and conversion is repeated. This mode allows getting of less pages in result in such case but requires repeated rendering(and therefore more processing time).

Constructor & Destructor Documentation

◆ LoadOptions()

ASPOSE_PDF_SHARED_API Aspose::Pdf::LoadOptions::LoadOptions ( )

Member Function Documentation

◆ get_DisableFontLicenseVerifications()

ASPOSE_PDF_SHARED_API bool Aspose::Pdf::LoadOptions::get_DisableFontLicenseVerifications ( ) const

Gets flag to disable any license restrictions for all fonts while loading the file. When , allows to execute operations with font that are prohibited by a license of this font, for example allows to embed a font into a PDF document even if license rules disable embedding for this font. By default .

Be careful when using this flag. When it is set it means that person who sets this flag, takes all responsibility of possible license/law violations on himself. So he takes it on it's own risk. It's strongly recommended to use this flag only when you are fully confident that you are not breaking the copyright law.

◆ get_LoadFormat()

ASPOSE_PDF_SHARED_API Aspose::Pdf::LoadFormat Aspose::Pdf::LoadOptions::get_LoadFormat ( ) const

Represents file format which LoadOptions describes.

◆ get_WarningHandler()

ASPOSE_PDF_SHARED_API System::SharedPtr<IWarningCallback> Aspose::Pdf::LoadOptions::get_WarningHandler ( ) const

Callback to handle any warnings generated. The WarningHandler returns ReturnAction enum item specifying either Continue or Abort. Continue is the default action and the Load operation continues, however the user may also return Abort in which case the Load operation should cease.

◆ set_DisableFontLicenseVerifications()

ASPOSE_PDF_SHARED_API void Aspose::Pdf::LoadOptions::set_DisableFontLicenseVerifications ( bool  value)

Sets flag to disable any license restrictions for all fonts while loading the file. When , allows to execute operations with font that are prohibited by a license of this font, for example allows to embed a font into a PDF document even if license rules disable embedding for this font. By default .

Be careful when using this flag. When it is set it means that person who sets this flag, takes all responsibility of possible license/law violations on himself. So he takes it on it's own risk. It's strongly recommended to use this flag only when you are fully confident that you are not breaking the copyright law.

◆ set_WarningHandler()

ASPOSE_PDF_SHARED_API void Aspose::Pdf::LoadOptions::set_WarningHandler ( System::SharedPtr< IWarningCallback value)

Callback to handle any warnings generated. The WarningHandler returns ReturnAction enum item specifying either Continue or Abort. Continue is the default action and the Load operation continues, however the user may also return Abort in which case the Load operation should cease.

Member Data Documentation

◆ _loadFormat

Aspose::Pdf::LoadFormat Aspose::Pdf::LoadOptions::_loadFormat
protected

◆ _usageMode

UsageMode Aspose::Pdf::LoadOptions::_usageMode
protected

◆ ApsAsXpsSavingType

ApsToXpsSavingMode Aspose::Pdf::LoadOptions::ApsAsXpsSavingType
protected

◆ ApsIntermediateFileIfAny

System::String Aspose::Pdf::LoadOptions::ApsIntermediateFileIfAny
protected

◆ DefaultBatchSize

const int32_t Aspose::Pdf::LoadOptions::DefaultBatchSize
staticprotected

◆ Page

System::SharedPtr<Aspose::Pdf::Page> Aspose::Pdf::LoadOptions::Page
protected

◆ PlainApsIntermediateTempFileIfAny

System::String Aspose::Pdf::LoadOptions::PlainApsIntermediateTempFileIfAny
protected

Sometimes we need use temp file to save APS during conversion to avoid OOM exceptions in PalZipWriter For such hard tests can be used this parameter - it will force usage of ile instead of MemoryStream

◆ PngIntermediateFileIfAny

System::String Aspose::Pdf::LoadOptions::PngIntermediateFileIfAny
protected

◆ UseAreaClipping

bool Aspose::Pdf::LoadOptions::UseAreaClipping
protected

◆ XpsIntermediateFileIfAny

System::String Aspose::Pdf::LoadOptions::XpsIntermediateFileIfAny
protected