Aspose::Words::Settings Namespace Reference

Classes

class  CompatibilityOptions
 Contains compatibility options (that is, the user preferences entered on the Compatibility tab of the Options dialog in Microsoft Word). More...
 
class  HyphenationOptions
 Allows to configure document hyphenation options. More...
 
class  MailMergeSettings
 Specifies all of the mail merge information for a document. More...
 
class  Odso
 Specifies the Office Data Source Object (ODSO) settings for a mail merge data source. More...
 
class  OdsoFieldMapData
 Specifies how a column in the external data source shall be mapped to the predefined merge fields within the document. More...
 
class  OdsoFieldMapDataCollection
 A typed collection of the Aspose::Words::Settings::OdsoFieldMapData objects. More...
 
class  OdsoRecipientData
 Represents information about a single record within an external data source that is to be excluded from the mail merge. More...
 
class  OdsoRecipientDataCollection
 A typed collection of Aspose::Words::Settings::OdsoRecipientData More...
 
class  ViewOptions
 Provides various options that control how a document is shown in Microsoft Word. More...
 
class  WriteProtection
 Specifies write protection settings for a document. More...
 

Enumerations

enum  Compatibility {
  Compatibility::NoTabHangInd, Compatibility::NoSpaceRaiseLower, Compatibility::SuppressSpBfAfterPgBrk, Compatibility::WrapTrailSpaces,
  Compatibility::PrintColBlack, Compatibility::NoColumnBalance, Compatibility::ConvMailMergeEsc, Compatibility::SuppressTopSpacing,
  Compatibility::UseSingleBorderforContiguousCells, Compatibility::TransparentMetafiles, Compatibility::ShowBreaksInFrames, Compatibility::SwapBordersOddFacingPgs,
  Compatibility::DoNotLeaveBackslashAlone, Compatibility::DoNotExpandOnShiftReturn, Compatibility::UlTrailSpace, Compatibility::BalanceSingleByteDoubleByteWidth,
  Compatibility::SuppressTopSpacingAtTopOfPage, Compatibility::SpacingInWholePoints, Compatibility::PrintBodyTextBeforeHeader, Compatibility::NoLeading,
  Compatibility::SpaceForUL, Compatibility::MWSmallCaps, Compatibility::SuppressTopLineSpacingWP, Compatibility::TruncateFontHeightLikeWP6,
  Compatibility::SubFontBySize, Compatibility::LineWrapLikeWord6, Compatibility::DoNotSuppressParagraphBorder, Compatibility::NoExtraLineSpacing,
  Compatibility::SuppressBottomSpacing, Compatibility::WPSpaceWidth, Compatibility::WPJustification, Compatibility::UsePrinterMetrics,
  Compatibility::ShapeLayoutLikeWW8, Compatibility::FootnoteLayoutLikeWW8, Compatibility::DoNotUseHtmlParagraphAutoSpacing, Compatibility::AdjustLineHeightInTable,
  Compatibility::ForgetLastTabAlignment, Compatibility::AutoSpaceLikeWord95, Compatibility::AlignTableRowByRow, Compatibility::LayoutRawTableWidth,
  Compatibility::LayoutTableRowsApart, Compatibility::UseWord97LineBreakRules, Compatibility::DoNotBreakWrappedTables, Compatibility::doNotSnapToGridInCell,
  Compatibility::SelectFldWithFirstOrLastChar, Compatibility::ApplyBreakingRules, Compatibility::DoNotWrapTextWithPunct, Compatibility::DoNotUseEastAsianBreakRules,
  Compatibility::UseWord2002TableStyleRules, Compatibility::GrowAutofit, Compatibility::UseNormalStyleForList, Compatibility::DoNotUseIndentAsNumberingTabStop,
  Compatibility::UseAltKinsokuLineBreakRules, Compatibility::AllowSpaceOfSameStyleInTable, Compatibility::DoNotSuppressIndentation, Compatibility::DoNotAutofitConstrainedTables,
  Compatibility::AutofitToFirstFixedWidthCell, Compatibility::UnderlineTabInNumList, Compatibility::DisplayHangulFixedWidth, Compatibility::SplitPgBreakAndParaMark,
  Compatibility::DoNotVertAlignCellWithSp, Compatibility::DoNotBreakConstrainedForcedTable, Compatibility::DoNotVertAlignInTxbx, Compatibility::UseAnsiKerningPairs,
  Compatibility::CachedColBalance, Compatibility::UseFELayout, Compatibility::UICompat97To2003, Compatibility::OverrideTableStyleFontSizeAndJustification,
  Compatibility::DisableOpenTypeFontFormattingFeatures, Compatibility::SwapInsideAndOutsideForMirrorIndentsAndRelativePositioning, Compatibility::UseWord2010TableStyleRules
}
 Specifies names of compatibility options. More...
 
enum  MailMergeCheckErrors { MailMergeCheckErrors::Simulate = 1, MailMergeCheckErrors::PauseOnError = 2, MailMergeCheckErrors::CollectErrors = 3, MailMergeCheckErrors::Default = static_cast<int32_t>(PauseOnError) }
 Specifies how Microsoft Word will report errors detected during mail merge. More...
 
enum  MailMergeDataType {
  MailMergeDataType::None = -1, MailMergeDataType::TextFile = 0, MailMergeDataType::Database = 1, MailMergeDataType::Spreadsheet = 2,
  MailMergeDataType::Query = 3, MailMergeDataType::Odbc = 4, MailMergeDataType::Native = 5, MailMergeDataType::Default = static_cast<int32_t>(None)
}
 Specifies the type of an external mail merge data source. More...
 
enum  MailMergeDestination {
  MailMergeDestination::NewDocument = 0, MailMergeDestination::Printer = 1, MailMergeDestination::Email = 2, MailMergeDestination::Fax = 4,
  MailMergeDestination::Default = static_cast<int32_t>(NewDocument)
}
 Specifies the possible results which may be generated when a mail merge is carried out on a document. More...
 
enum  MailMergeMainDocumentType {
  MailMergeMainDocumentType::NotAMergeDocument = 0x00, MailMergeMainDocumentType::FormLetters = 0x01, MailMergeMainDocumentType::MailingLabels = 0x02, MailMergeMainDocumentType::Envelopes = 0x04,
  MailMergeMainDocumentType::Catalog = 0x08, MailMergeMainDocumentType::Email = 0x10, MailMergeMainDocumentType::Fax = 0x20, MailMergeMainDocumentType::Default = static_cast<int32_t>(NotAMergeDocument)
}
 Specifies the possible types for a mail merge source document. More...
 
enum  MsWordVersion {
  MsWordVersion::Word2000, MsWordVersion::Word2002, MsWordVersion::Word2003, MsWordVersion::Word2007,
  MsWordVersion::Word2010, MsWordVersion::Word2013, MsWordVersion::Word2016
}
 Allows Aspose.Wods to mimic MS Word version-specific application behavior. More...
 
enum  MultiplePagesType {
  MultiplePagesType::Normal, MultiplePagesType::MirrorMargins, MultiplePagesType::TwoPagesPerSheet, MultiplePagesType::BookFoldPrinting,
  MultiplePagesType::BookFoldPrintingReverse, MultiplePagesType::Default = static_cast<int32_t>(Normal)
}
 Specifies how document is printed out. More...
 
enum  OdsoDataSourceType {
  OdsoDataSourceType::Text = 0, OdsoDataSourceType::Database = 1, OdsoDataSourceType::AddressBook = 2, OdsoDataSourceType::Document1 = 3,
  OdsoDataSourceType::Document2 = 4, OdsoDataSourceType::Native = 5, OdsoDataSourceType::Email = 6, OdsoDataSourceType::None = 7,
  OdsoDataSourceType::Legacy = 8, OdsoDataSourceType::Master, OdsoDataSourceType::Default = static_cast<int32_t>(None)
}
 Specifies the type of the external data source to be connected to as part of the ODSO connection information. More...
 
enum  OdsoFieldMappingType { OdsoFieldMappingType::Column, OdsoFieldMappingType::Null, OdsoFieldMappingType::Default = static_cast<int32_t>(Null) }
 Specifies the possible types used to indicate if a given mail merge field has been mapped to a column in the given external data source. More...
 
enum  ViewType {
  ViewType::None = 0, ViewType::Reading = 0, ViewType::PageLayout = 1, ViewType::Outline = 3,
  ViewType::Normal = 4, ViewType::Web = 5
}
 Possible values for the view mode in Microsoft Word. More...
 
enum  ZoomType {
  ZoomType::Custom = 0, ZoomType::None = static_cast<int32_t>(Custom), ZoomType::FullPage = 1, ZoomType::PageWidth = 2,
  ZoomType::TextFit = 3
}
 Possible values for how large or small the document appears on the screen in Microsoft Word. More...
 

Detailed Description

The Aspose.Words.Settings namespace contains classes and enums that are used when specifying various settings and options stored in a document. These are mail merge, write protection, compatibility and other settings.

Enumeration Type Documentation

◆ Compatibility

Specifies names of compatibility options.

Enumerator
NoTabHangInd 
NoSpaceRaiseLower 
SuppressSpBfAfterPgBrk 
WrapTrailSpaces 
PrintColBlack 
NoColumnBalance 
ConvMailMergeEsc 
SuppressTopSpacing 
UseSingleBorderforContiguousCells 
TransparentMetafiles 
ShowBreaksInFrames 
SwapBordersOddFacingPgs 
DoNotLeaveBackslashAlone 
DoNotExpandOnShiftReturn 
UlTrailSpace 
BalanceSingleByteDoubleByteWidth 
SuppressTopSpacingAtTopOfPage 
SpacingInWholePoints 
PrintBodyTextBeforeHeader 
NoLeading 
SpaceForUL 
MWSmallCaps 
SuppressTopLineSpacingWP 
TruncateFontHeightLikeWP6 
SubFontBySize 
LineWrapLikeWord6 
DoNotSuppressParagraphBorder 
NoExtraLineSpacing 
SuppressBottomSpacing 
WPSpaceWidth 
WPJustification 
UsePrinterMetrics 
ShapeLayoutLikeWW8 
FootnoteLayoutLikeWW8 
DoNotUseHtmlParagraphAutoSpacing 
AdjustLineHeightInTable 
ForgetLastTabAlignment 
AutoSpaceLikeWord95 
AlignTableRowByRow 
LayoutRawTableWidth 
LayoutTableRowsApart 
UseWord97LineBreakRules 
DoNotBreakWrappedTables 
doNotSnapToGridInCell 
SelectFldWithFirstOrLastChar 
ApplyBreakingRules 
DoNotWrapTextWithPunct 
DoNotUseEastAsianBreakRules 
UseWord2002TableStyleRules 
GrowAutofit 
UseNormalStyleForList 
DoNotUseIndentAsNumberingTabStop 
UseAltKinsokuLineBreakRules 
AllowSpaceOfSameStyleInTable 
DoNotSuppressIndentation 
DoNotAutofitConstrainedTables 
AutofitToFirstFixedWidthCell 
UnderlineTabInNumList 
DisplayHangulFixedWidth 
SplitPgBreakAndParaMark 
DoNotVertAlignCellWithSp 
DoNotBreakConstrainedForcedTable 
DoNotVertAlignInTxbx 
UseAnsiKerningPairs 
CachedColBalance 
UseFELayout 
UICompat97To2003 
OverrideTableStyleFontSizeAndJustification 
DisableOpenTypeFontFormattingFeatures 
SwapInsideAndOutsideForMirrorIndentsAndRelativePositioning 
UseWord2010TableStyleRules 

◆ MailMergeCheckErrors

Specifies how Microsoft Word will report errors detected during mail merge.

See also
Aspose::Words::Settings::MailMergeSettings::get_CheckErrors
Enumerator
Simulate 

Simulate the merge and report errors in a new document.

PauseOnError 

Complete the merge and pause to report errors.

CollectErrors 

Complete the merge and report errors in a new document.

Default 

Equals to the Aspose::Words::Settings::MailMergeCheckErrors::PauseOnError value.

◆ MailMergeDataType

Specifies the type of an external mail merge data source.

See also
Aspose::Words::Settings::MailMergeSettings::get_DataType
Enumerator
None 

No mail merge data source is specified.

TextFile 

Specifies that a given document has been connected to a text file via the Dynamic Data Exchange (DDE) system.

Database 

Specifies that a given document has been connected to an Access database via the Dynamic Data Exchange (DDE) system.

Spreadsheet 

Specifies that a given document has been connected to an Excel spreadsheet via the Dynamic Data Exchange (DDE) system.

Query 

Specifies that a given document has been connected to an external data source using an external query tool.

Odbc 

Specifies that a given document has been connected to an external data source via the Open Database Connectivity interface.

Native 

Specifies that a given document has been connected to an external data source via the Office Data Source Object (ODSO) interface.

Default 

Equals to Aspose::Words::Settings::MailMergeDataType::None.

◆ MailMergeDestination

Specifies the possible results which may be generated when a mail merge is carried out on a document.

See also
Aspose::Words::Settings::MailMergeSettings::get_Destination
Enumerator
NewDocument 

Specifies that conforming hosting applications shall generate new documents by populating the fields within a given document with data from the specified external data source.

Printer 

Specifies that conforming hosting applications shall print the documents that result from populating the fields within a given document with external data from the specified external data source.

Email 

Specifies that conforming hosting applications shall generate emails using the documents that result from populating the fields within a given document with data from the specified external data source.

Fax 

Specifies that conforming hosting applications shall generate faxes using the documents that result from populating the fields within a given document with data from the specified external data source.

Default 

Equals to the Aspose::Words::Settings::MailMergeDestination::NewDocument value.

◆ MailMergeMainDocumentType

Specifies the possible types for a mail merge source document.

See also
Aspose::Words::Settings::MailMergeSettings::get_MainDocumentType
Enumerator
NotAMergeDocument 

This document is not a mail merge document.

FormLetters 

Specifies that the mail merge source document is of the form letter type.

MailingLabels 

Specifies that the mail merge source document is of the mailing label type.

Envelopes 

Specifies that the mail merge source document is of the envelope type.

Catalog 

Specifies that the mail merge source document is of the catalog type.

Email 

Specifies that the mail merge source document is of the e-mail message type.

Fax 

Specifies that the mail merge source document is of the fax type.

Default 

Equals to Aspose::Words::Settings::MailMergeMainDocumentType::NotAMergeDocument

◆ MsWordVersion

Allows Aspose.Wods to mimic MS Word version-specific application behavior.

Enumerator
Word2000 

Optimize Aspose.Words behavior to match MS Word 2000 version.

Word2002 

Optimize Aspose.Words behavior to match MS Word 2002 version.

Word2003 

Optimize Aspose.Words behavior to match MS Word 2003 version.

Word2007 

Optimize Aspose.Words behavior to match MS Word 2007 version.

Word2010 

Optimize Aspose.Words behavior to match MS Word 2010 version.

Word2013 

Optimize Aspose.Words behavior to match MS Word 2013 version.

Word2016 

Optimize Aspose.Words behavior to match MS Word 2016 version.

◆ MultiplePagesType

Specifies how document is printed out.

Enumerator
Normal 

Normal printing, no multiple pages specified.

MirrorMargins 

Swaps left and right margins on facing pages.

TwoPagesPerSheet 

Prints two pages per sheet.

BookFoldPrinting 

Specifies whether to print the document as a book fold.

BookFoldPrintingReverse 

Specifies whether to print the document as a reverse book fold.

Default 

Default value is Aspose::Words::Settings::MultiplePagesType::Normal

◆ OdsoDataSourceType

Specifies the type of the external data source to be connected to as part of the ODSO connection information.

The OOXML specification is very vague for this enum. I guess it might correspond to the WdMergeSubType enumeration http://msdn.microsoft.com/en-us/library/bb237801.aspx.

See also
Aspose::Words::Settings::Odso::get_DataSourceType
Enumerator
Text 

Specifies that a given document has been connected to a text file. Possibly wdMergeSubTypeOther.

Database 

Specifies that a given document has been connected to a database. Possibly wdMergeSubTypeAccess.

AddressBook 

Specifies that a given document has been connected to an address book of contacts. Possibly wdMergeSubTypeOAL.

Document1 

Specifies that a given document has been connected to another document format supported by the producing application. Possibly wdMergeSubTypeOLEDBWord.

Document2 

Specifies that a given document has been connected to another document format supported by the producing application. Possibly wdMergeSubTypeWorks.

Native 

Specifies that a given document has been connected to another document format native to the producing application. Possibly wdMergeSubTypeOLEDBText

Email 

Specifies that a given document has been connected to an e-mail application. Possibly wdMergeSubTypeOutlook.

None 

The type of the external data source is not specified. Possibly wdMergeSubTypeWord.

Legacy 

Specifies that a given document has been connected to a legacy document format supported by the producing application Possibly wdMergeSubTypeWord2000.

Master 

Specifies that a given document has been connected to a data source which aggregates other data sources.

Default 

Equals to Aspose::Words::Settings::OdsoDataSourceType::None.

◆ OdsoFieldMappingType

Specifies the possible types used to indicate if a given mail merge field has been mapped to a column in the given external data source.

See also
Aspose::Words::Settings::OdsoFieldMapData::get_Type
Enumerator
Column 

Specifies that the mail merge field has been mapped to a column in the given external data source.

Null 

Specifies that the mail merge field has not been mapped to a column in the given external data source.

Default 

Equals to Aspose::Words::Settings::OdsoFieldMappingType::Null.

◆ ViewType

Possible values for the view mode in Microsoft Word.

See also
Aspose::Words::Settings::ViewOptions, Aspose::Words::Settings::ViewOptions::get_ViewType
Enumerator
None 

The document shall be rendered in the default view of the application.

Reading 

The document shall be rendered in the default view of the application.

PageLayout 

The document shall be opened in a view that displays the document as it will print.

Outline 

The document shall be rendered in a view optimized for outlining or creating long documents.

Normal 

The document shall be rendered in a view optimized for outlining or creating long documents.

Web 

The document shall be rendered in a view mimicking the way this document would be displayed in a web page.

◆ ZoomType

Possible values for how large or small the document appears on the screen in Microsoft Word.

See also
Aspose::Words::Settings::ViewOptions, Aspose::Words::Settings::ViewOptions::get_ZoomType
Enumerator
Custom 

Zoom percentage is set explicitly. It is not recalculated automatically when control size changes.

None 

Indicates to use the explicit zoom percentage. Same as Aspose::Words::Settings::ZoomType::Custom.

FullPage 

Zoom percentage is automatically recalculated to fit one full page.

PageWidth 

Zoom percentage is automatically recalculated to fit page width.

TextFit 

Zoom percentage is automatically recalculated to fit text.