This is the legacy 4D documentation web site. Documentations are progressively being moved to developer.4d.com

Home

 
4D v20 R7
Importing 4D Write documents

Importing 4D Write documents    


 

 

One of the main features of the new 4D Write Pro object is the ability to import and convert existing 4D Write documents. This will allow you to migrate applications that currently rely on the 4D Write plug-in.

Compatibility notes:

  • Only 4D Write documents of the last generation ("4D Write v7") are supported.
  • Copying-pasting from a 4D Write document to a 4D Write Pro area is not supported for the moment. A 4D Write document can only be imported using 4D Write Pro language commands.
  • Carriage returns (CR) in formulas behave differently in 4D Write and 4D Write Pro. In 4D Write, they are always interpreted as paragraph breaks, whereas in 4D Write Pro they are interpreted as line breaks by default. To maintain CR in formulas as paragraph breaks in imported 4D Write documents, after conversion use:

    For more information, see Managing formulas.

4D Write Pro objects offer two ways to import 4D Write documents:

  • For 4D Write files stored on disk, you use the WP Import document command,
  • For 4D Write areas stored in BLOB fields, you use the WP New command.

For more information, please refer to the description of these commands.

To facilitate your migration from the 4D Write plug-in to 4D Write Pro, we want to support as many 4D Write features as possible in 4D Write Pro objects.

This paragraph lists the 4D Write plug-in properties that are currently recovered in a 4D Write Pro area after an import using the WP Import document or WP New commands.

Note however that a few differences can be seen, which are not considered as bugs. This is due, for example, to the default font used in 4D Write Pro for bullets, or small conversions in the Underline type.

4D Write plug-in4D Write Pro
Creation date & timeAvailable
Modification date & timeAvailable
LockedNot available (use read-only object property)
TitleAvailable
SubjectAvailable (only plain text)
AuthorAvailable
CompanyAvailable
NotesAvailable

4D Write plug-in4D Write Pro
View page modeNot imported (use Document/Page view mode in the context menu)
View rulersNot imported (use object property)
View framesNot imported (use object property)
View headerNot imported (use object property)
View footerNot imported (use object property)
View first page headerNot available
View first page footerNot available
View picturesNot available
View HScrollbarNot imported (use hor. scrollbar object property)
View VScrollbarNot imported (use vert. scrollbar object property)
View invisible charactersNot imported (use object property)
View referencesNot imported (use ST SET OPTIONS)
View column separatorsAvailable (starting with v17)
View H SplitterNot available
View V SplitterNot available
View WysiwygNot available
View zoomNot imported (use Document/Zoom in the context menu)

4D Write plug-in4D Write Pro
UnitNot imported (use Document/Measurement unit in the context menu)
LanguageNot available
Count of columnsAvailable (starting with v17)
Column spacingAvailable (starting with v17)
Widows & orphansAvailable
Default tabAvailable
Leading tabAvailable
URL colorNot available
URL visited colorNot available

Note: The system separator (as returned by GET SYSTEM FORMAT) is used as decimal separator for decimal tabs. You can change this parameter using the WP SET ATTRIBUTES command. 

4D Write plug-in4D Write Pro
Page widthAvailable
Page heightAvailable
First page numberAvailable
First page header & footer are differentAvailable
Left & right page header & footer are differentAvailable
Page bindingAvailable
Opposite pagesAvailable
Page marginsAvailable
Header top marginAvailable
Header bottom marginAvailable
Footer top marginAvailable
Footer bottom marginAvailable
First page top marginAvailable
First page bottom marginAvailable
Header first page top marginAvailable
Header first page bottom marginAvailable
Footer first page top marginAvailable
Footer first page bottom marginAvailable
First page is rightAvailable

4D Write plug-in4D Write Pro
Kind of paperNot available
LandscapeNot available
WidthNot available
HeightNot available
User marginsNot available
ScaleNot available
X resolutionNot available
Y resolutionNot available
Images  

Compatibility notes: 

  • Picture display modes are automatically imported as of 4D Write Pro v19 R2, using WP Import document. You can restore the previous behavior (all images are scaled to fit) using the importDisplayMode attribute. 
  • On Windows, images having the Mac OS PICT format are imported but cannot be rendered in 4D Write Pro. If you import a document containing images of this type, you need to convert them to another format. Support of PICT format has been removed since 4D v18 and can no longer be used.
4D Write plug-in4D Write Pro
X (left)(& position :absolute) (for images in page only)
Y (top)(& position :absolute) (for images in page only)
WidthAvailable
HeightAvailable
Page numberAvailable (starting with v16 R6)
BehindAvailable (starting with v16 R6)
Not in first pageAvailable (starting with v16 R6)
Viewport mode (scale to fit, etc.)Available
Is expressionAvailable for inline pictures (starting with v16 R5)
Keep sizeNot imported (automatic in 4D Write Pro)

4D Write plug-in4D Write Pro (span properties)
ItalicAvailable
BoldAvailable
StrikeoutAvailable
UnderlineAvailable
ShadowAvailable
Exponent (superscript or subscript)Available
Capitals (uppercase or small uppercase)Available
Font FamilyAvailable
Font SizeAvailable
Text ColorAvailable
Text Back ColorAvailable
Underline ColorAvailable
Strikeout ColorAvailable
Shadow colorAvailable
User propertyNot available
Spell checking (syntax & grammar on or off)Not imported (area property)
AppearanceNot available
Style sheetAvailable (starting with 4D v18)

4D Write plug-in4D Write Pro
JustificationAvailable
InterlineAvailable
BulletAvailable
Left marginAvailable
Right marginAvailable
Text indentAvailable
Border line styleAvailable
Border line colorAvailable
Border back colorAvailable
Left borderAvailable
Right borderAvailable
Top border & top inside borderAvailable
Bottom border & bottom inside borderAvailable
Border spacingAvailable
Style SheetAvailable
TabulationsAvailable

4D Write plug-in4D Write Pro
URL linkAvailable (*)
4D method linkAvailable (**) (starting with v17 R5)
Open document linkAvailable (converted to a local file URL)
  • (*) Starting with 4D v16 R4, URL links are converted to editable attributes. For more information, please refer to Link commands.
  • (**) You need to adapt parameters received within the called methods:
    Parameters4D Write plug-in 4D Write Pro
    $1Longint - 4D Write area referenceText - 4D Write Pro area name
    $2Text - Link labelObject - Link description:
    • .method - Link's method name. Must be be allowed with the SET ALLOWED METHODS command.
    • .parameter - User parameter value passed to the method (if used)
    • .range - Range of the link's label. See Range handling commands
    $3Longint - User parameter (methodRef)-

4D Write plug-in4D Write Pro
4D expressionAvailable*
Date & TimeAvailable
HTML expressionNot available**
RTF expressionNot available

*Use the WP SET ATTRIBUTES command with the wk break paragraphs in formulas attribute to transform CR returned by formulas into paragraph breaks in the imported document (line breaks by default). (See Managing formulas

**can be imported as text between ##htmlBegin## and ##htmlEnd## tags if you use the wk import html expressions as text constant.

4D Write plug-in4D Write Pro
Main text dataAvailable
Header text dataAvailable
Footer text dataAvailable

 
 



See also 

Migrate 4D Write documents stored in picture fields

 
PROPERTIES 

Product: 4D
Theme: Importing 4D Write documents

 
PAGE CONTENTS 
 
HISTORY 

Modified: 4D v16
Modified: 4D v16 R4
Modified: 4D v16 R5
Modified: 4D v16 R6
Modified: 4D v17
Modified: 4D v17 R5
Modified: 4D v18 R5
Modified: 4D v19 R2

 
ARTICLE USAGE

4D Write Pro Reference ( 4D v20 R7)