These options control the behavior of the Word converter used by Document Conversion Service. Table values in bold text are the default value for that setting.

 

Sample Profile

 

<?xml version="1.0" encoding="utf-8"?>

<Profile Type="0"

         DisplayName="TIFF 300dpi Word with Markup, replace dates "

         Description ="Prints Word documents with comments and tracking visible.">

  <Settings>

 

    <!-- Print Word with markup  and 2 pages per sheet -->

    <add Name ="Microsoft.Word.Document.PrintOut.Item"

         Value="DocumentAndMarkup"/>

    <add Name ="Microsoft.Word.PageSetup.TwoPagesOnOne"

         Value="True"/>

    

    <!-- Replace date fields with <AUTODATE> string -->

    <add Name ="Microsoft.Word.ReplaceFieldDateWith"

         Value="&lt;AUTODATE&gt;"/>

 

 

 

    <!-- Output file options -->

    <add Name="Devmode settings;Resolution" Value="300"/>

    <add Name="Save;Output File Format" Value="TIFF Multipaged"/>

    ...

    

  </Settings>

</Profile>

 

 

Code Sample - C#

 
PNDocConvQueueServiceLib.PNDocConvQueueItem item = null;
 
// Create the conversion item
item = new PNDocConvQueueServiceLib.PNDocConvQueueItem();
 
// Set conversion settings

item.Set("Microsoft.Word.Document.PrintOut.Item""DocumentAndMarkup");

item.Set("Microsoft.Word.PageSetup.TwoPagesOnOne""True");

item.Set("Microsoft.Word.ReplaceFieldDateWith""<AUTODATE>");
item.Set("Devmode settings;Resolution", "300");
item.Set("Save;Output File Format", "TIFF Multipaged");
...
// convert the file
item.Convert("Microsoft Word",
             @"C:\Test\Report.docx",
             @"C:\Test\Out\ConvertedReport");

 

Code Sample - VB.NET

 

Dim item As PNDocConvQueueServiceLib.IPNDocConvQueueItem

 

 ' Create the conversion item

item = New PNDocConvQueueServiceLib.PNDocConvQueueItem()

 

' Set conversion settings

item.Set("Microsoft.Word.Document.PrintOut.Item""DocumentAndMarkup")

item.Set("Microsoft.Word.PageSetup.TwoPagesOnOne""True")

item.Set("Microsoft.Word.ReplaceFieldDateWith""<AUTODATE>")

item.Set("Devmode settings;Resolution""300")

item.Set("Save;Output File Format""TIFF Multipaged")

...

' convert the file

item.Convert("Microsoft Word", _

             "C:\Test\Report.docx", _

             "C:\Test\Out\ConvertedReport")

 

 

Conversion Settings - Word Printing Options

Name:

Microsoft.Word.Document.PrintOut.Item

 

Choose what parts of the document to print.

 

Values:

Document - prints only the document.

DocumentAndMarkup - prints the document and any markup such as tracked changes and comments.

DocumentMarkup - prints only the markup.

DocumentProperties - prints only the document properties.

 

Name:

Microsoft.Word.Document.PrintOut.PageType

 

Choose if you want to print all pages, even pages or odd pages.

 

Values:

All

Even

Odd

 

Name:

Microsoft.Word.ActiveWindow.View.MarkupMode

 

Sets the display mode for tracked changes in the document. Applies when using the printing option Word.Document.PrintOut.Item set to DocumentAndMarkup or DocumentMarkup.

 

Values:

BalloonRevisions  - Displays revisions in balloons in the left or right margin.

InLineRevisions  - Displays revisions within the text using strikethrough for deletions and underlining for insertions.

MixedRevisions  - Shows only comments and formatting revisions in the document.

 

Name:

Microsoft.Word.ActiveWindow.View.RevisionsView (Office 2010 and earlier)

 

This setting is deprecated starting with Office 2013. Use Microsoft.Word.ActiveWindow.View.RevisionsFilter.View and Microsoft.Word.ActiveWindow.View.RevisionsFilter.Markup instead.

Specifies whether the original version of a document or a version with revisions and formatting changes applied are displayed.

 

Values:

ViewFinal  - Displays the document with formatting and content changes applied.

ViewOriginal - Displays the document before changes were made.

 

Name:

Microsoft.Word.ActiveWindow.View.RevisionsFilter.View (Office 2013 and later)

 

Specifies whether the original version of a document or a version with revisions and formatting changes applied are displayed. Replaces Microsoft.Word.ActiveWindow.View.RevisionsView in Office 2013 and later versions.

 

Values:

ViewFinal  - Displays the document with formatting and content changes applied.

ViewOriginal - Displays the document before changes were made.

 

Name:

Microsoft.Word.ActiveWindow.View.RevisionsFilter.Markup (Office 2013 and later)

 

Specifies the extent of reviewer markup displayed in the document. This setting is used starting with Office 2013.

 

Values:

NoMarkup - Displays the final document with no markup visible.

SimpleMarkup - Displays the final document in simple markup: with revisions incorporated, but with no markup visible.

AllMarkup - Displays the final document with all markup visible.

 

Name:

Microsoft.Word.ActiveWindow.View.ShowComments

 

Pass True to display any comments in the document. Must be used with Microsoft.Word.ActiveWindow.View.MarkupMode to display the comments as balloons or inline, and Microsoft.Word.Document.PrintOut.Item set to print document markup.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.ActiveWindow.View.ShowFormatChanges

 

Pass True to display any formatting changes made to a document with Track Changes enabled. Must be used with Microsoft.Word.ActiveWindow.View.MarkupMode to display the comments as balloons or inline, and Microsoft.Word.Document.PrintOut.Item set to print document markup.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.ActiveWindow.View.ShowHiddenText

 

Pass True to display any text that was formatted as hidden.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.ActiveWindow.View.ShowHighlight

 

Pass True to have highlighted text displayed with the highlighted background.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.ActiveWindow.View.ShowInkAnnotations

 

Pass True to to show handwritten ink annotations in the document. Must be used with Microsoft.Word.Document.PrintOut.Item set to print document markup.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.ActiveWindow.View.ShowInsertionsAndDeletions

 

Pass True to display any insertions and deletions made to a document with Track Changes enabled. Must be used with Microsoft.Word.ActiveWindow.View.MarkupMode set to display the changes as balloons or inline, and Microsoft.Word.Document.PrintOut.Item set to print document markup.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.ActiveWindow.View.ShowMarkupAreaHighlight

 

Pass True to have the markup area that shows revision and comment ballons displayed shaded. Applies only when Microsoft.Word.ActiveWindow.View.MarkupMode is set to display markup as balloons, and Microsoft.Word.Document.PrintOut.Item is set to print document markup.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.Options.AllowA4LetterResizing

 

Pass True to automatically adjust Letter-sized documents to fit A4 paper, or to adjust A4-sized documents to fit Letter paper. This only affects printing and happens when the paper size of the printer does not match the paper size that is set in Word.

 

Values:

String value "True" or "False".

 

 

Conversion Settings - Word Field Replacement

Name:

Microsoft.Word.ReplaceFieldDateWith

 

Replaces any DATE fields in the Word document with the provided string.

 

Values:

The string value to place in the field.

 

Name:

Microsoft.Word.ReplaceFieldTimeWith

 

Replaces any TIME fields in the Word document with the provided string.

 

Values:

The string value to place in the field.

 

Name:

Microsoft.Word.ReplaceFieldFileNameWith

 

Replaces any FILENAME fields in the Word document with the provided string.

 

Values:

A string value to replace the auto file name field.

 

 

Conversion Settings - Word Document Protection

Name:

Microsoft.Word.UnprotectPassword

 

The password to use to remove the protection on the the Word document and allow changes. This password is passed as clear text and is visible to anyone.

 

Values:

A string value containing the password.

 

Name:

Microsoft.Word.OpenPassword

 

The password to use to open a password-protected Word document. This password is passed as clear text and is visible to anyone.

 

Values:

A string value containing the password.

 

Name:

Microsoft.Word.WritePassword

 

The password to use to allow saving changes to the Word document. This password is passed as clear text and is visible to anyone.

 

Values:

A string value containing the password.

 

 

Conversion Settings - Word Page Setup Printing Options

Name:

Microsoft.Word.PageSetup.BookFoldPrinting

 

Pass True to print the document as a booklet.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.PageSetup.BookFoldPrintingSheets

 

The number pages to print in each booklet. This number must be a multiple of 4. If not, the default setting of "Auto" will be used.

 

When using "Auto", Word will automatically determine the number of sheets per booklet, splitting the sheets into separate booklets as necessary. Passing "All" will print all of your pages in a single booklet.  

 

Values:

String value "Auto", "All" or the number of pages to be printed in each booklet.

 

Name:

Microsoft.Word.PageSetup.BookFoldRevPrinting

 

Pass True to reverse the printing order for booklet printing, bidirectional or Asian language documents only.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.PageSetup.BottomMargin

 

Set the size of the bottom margin in points.

 

Values:

String value of the desired margin height.

 

Name:

Microsoft.Word.PageSetup.DifferentFirstPageHeaderFooter

 

Pass True to use a different header on the first page.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.PageSetup.FooterDistance

 

Set the distance (in points) between the top of the footer to the bottom of the page.

 

Values:

String value of the desired footer height.

 

Name:

Microsoft.Word.PageSetup.Gutter

 

Set the amount of extra margin space added for binding.

 

Values:

String value of the desired gutter width.

 

Name:

Microsoft.Word.PageSetup.GutterPos

 

Sets which side of the document the gutter is placed.

 

Values:

Left

Right

Top

 

Name:

Microsoft.Word.PageSetup.GutterStyle

 

Sets how the gutters are placed; on the left for left-to-right languages or on the right side of the document for right-to-left languages.

 

Values:

Bidi - use bidirectional gutters for right-to-left languages.

Latin - use Latin gutter for left-to-right text.

 

Name:

Microsoft.Word.PageSetup.HeaderDistance

 

Set the distance (in points) between the bottom of the header to the top of the page.

 

Values:

String value of the desired header height.

 

Name:

Microsoft.Word.PageSetup.LayoutMode

 

Sets the layout of the text in the document. Genko, Grid and LineGrid use the setting Microsoft.Word.PageSetup.LinesPage.

 

Values:

Default - No grid is used to lay out text.

Genko - Text is laid out on a grid with characters aligned on the gridlines.

Grid - Text is laid out on a grid but the characters are not aligned on the gridlines.

LineGrid - Text is laid out on a grid; only the number of lines is specified.

 

Name:

Microsoft.Word.PageSetup.LeftMargin

 

Set the size of the left margin in points.

 

Values:

String value of the desired margin height.

 

Name:

Microsoft.Word.PageSetup.LinesPage

 

The number of lines per page of the document. Used with the Microsoft.Word.PageSetup.LayoutMode setting.

 

Values:

String value of the desired number of lines per page.

 

Name:

Microsoft.Word.PageSetup.MirrorMargins

 

Pass True to have the inside and outside margins of facing pages to be the same width.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.PageSetup.OddAndEvenPagesHeaderFooter

 

Pass True to have different headers for odd-numbered and even-numbered pages.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.PageSetup.Orientation

 

Sets the orientation of the page.

 

Values:

Landscape

Portrait

 

Name:

Microsoft.Word.PageSetup.PageHeight

 

Sets the height of the page in points.

 

Values:

String value of the desired height.

 

Name:

Microsoft.Word.PageSetup.PageWidth

 

Sets the width of the page in points.

 

Values:

String value of the desired width.

 

Name:

Microsoft.Word.PageSetup.PaperSize

 

Sets the paper size.

 

Values:

Paper10x14 - 10 in. x 14 in.

Paper11x17 - 11 in. x 17 in.

PaperA3 - A3 (297 mm x 420 mm)

PaperA4 - A4 (210 mm x 297 mm)

PaperA4Small - A4 Small (210 mm x 297 mm)

PaperA5 - A5 (148 mm x 210 mm)

PaperB4 - B4 (250 mm x 354 mm)

PaperB5 - B5 (182 mm x 257 mm)

PaperCsheet - C size sheet

PaperEnvelope10 - Envelope #10 (4-1/8 in. x 9-1/2 in.)

PaperEnvelope11 - Envelope #11 (4-1/2 in. x 10-3/8 in.)

PaperEnvelope14 - Envelope #14 (5 in. x 11-1/2 in.)

PaperEnvelope9 - Envelope #9 (3-7/8 in. x 8-7/8 in.)

PaperEnvelopeB4 - Envelope B4 (250 mm x 353 mm)

PaperEnvelopeB5 - Envelope B5 (176 mm x 250 mm)

PaperEnvelopeB6 - Envelope B6 (176 mm x 125 mm)

PaperEnvelopeC3 - Envelope C3 (324 mm x 458 mm)

PaperEnvelopeC4 - Envelope C4 (229 mm x 324 mm)

PaperEnvelopeC5 - Envelope C5 (162 mm x 229 mm)

PaperEnvelopeC6 - Envelope C6 (114 mm x 162 mm)

PaperEnvelopeC65 - Envelope C65 (114 mm x 229 mm)

PaperEnvelopeDL - Envelope DL (110 mm x 220 mm)

PaperEnvelopeItaly - Envelope (110 mm x 230 mm)

PaperEnvelopeMonarch - Envelope Monarch (3-7/8 in. x 7-1/2 in.)

PaperEnvelopePersonal - Envelope (3-5/8 in. x 6-1/2 in.)

PaperExecutive - Executive (7-1/2 in. x 10-1/2 in.)

PaperFanfoldLegalGerman - German Legal Fanfold (8-1/2 in. x 13 in.)

PaperFanfoldStdGerman - German Standard Fanfold (8-1/2 in. x 12 in.)

PaperFolio - Folio (8-1/2 in. x 13 in.)

PaperLedger - Ledger (17 in. x 11 in.)

PaperLegal - Legal (8-1/2 in. x 14 in.)

PaperLetter - Letter (8-1/2 in. x 11 in.)

PaperLetterSmall - Letter Small (8-1/2 in. x 11 in.)

PaperNote - Note (8-1/2 in. x 11 in.)

PaperQuarto - Quarto (215 mm x 275 mm)

PaperStatement - Statement (5-1/2 in. x 8-1/2 in.)

PaperTabloid - Tabloid (11 in. x 17 in.)

 

Name:

Microsoft.Word.PageSetup.RightMargin

 

Set the size of the right margin in points.

 

Values:

String value of the desired margin width.

 

Name:

Microsoft.Word.PageSetup.SuppressEndnotes

 

Pass True to suppress any endnotes.

 

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.PageSetup.TopMargin

 

Set the size of the top margin in points.

 

 

Values:

String value of the desired margin height.

 

 

Name:

Microsoft.Word.PageSetup.TwoPagesOnOne

 

Pass True to split the paper right down the horizontal center (for portrait) and vertical center (for landscape) and print two "pages" per sheet of paper. This does not shrink two pages of the document onto each single output page but rather changes the text layout of the document to reflect each page size being one half of the currently selected paper size.

 

Values:

String value "True" or "False".

 

Name:

Microsoft.Word.PageSetup.VerticalAlignment

 

Sets the vertical alignment of the text on each page.

 

Values:

Bottom

Center

Justify

Top