DynaPDF.BeginContinueText
-------------------------

This function prepares the output of multiple text lines with [DynaPDF.AddContinueText](DynaPDFAddContinueText.md).

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [DynaPDF](component_DynaPDF.md) | [3.1](newinversion31.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "DynaPDF.BeginContinueText"; PDF; PosX; PosY ) 

**MBS**( **"DynaPDF.BeginContinueText";** /\* This function prepares the output of multiple text lines with DynaPDF.AddContinueText. \*/  
**$PDF**; /\* The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). \*/   
**$PosX**; /\* X-Coordinate of the first text linee.g. $x \*/   
**$PosY**) /\* Y-Coordinate of the first text linee.g. $y \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| PDF | The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). | $pdf |
| PosX | X-Coordinate of the first text line | $x |
| PosY | Y-Coordinate of the first text line | $y |

### Result

Returns OK or error message.

### Description

This function prepares the output of multiple text lines with [DynaPDF.AddContinueText](DynaPDFAddContinueText.md).   
The distance between two text lines can be adjusted with [DynaPDF.SetLeading](DynaPDFSetLeading.md). If no leading was defined it will be set to the font size. Note that the function changes the leading of the graphics state if it was not defined beforehand. Subsequent calls use then the leading that was set in a prior call. If the font or font size will be changed it is strongly recommended to set the leading to a correct value. The default leading is the font size. The leading, font, character spacing, word spacing, text scaling, or the text color can be changed before calling [DynaPDF.AddContinueText](DynaPDFAddContinueText.md) the next time.  
The point PosX, PosY defines the baseline of the first text line if the coordinate system is bottom-up, otherwise the top-left corner of the text's bounding box. The origin can be changed with the function [DynaPDF.SetFontOrigin](DynaPDFSetFontOrigin.md).  
If the font uses horizontal writing mode the text cursor moves from top to bottom. In vertical writing mode the text cursor moves from left to right.  
See also [BeginContinueText](https://www.monkeybreadsoftware.com/DynaPDF-Manual/BeginContinueText.shtml) function in DynaPDF manual.

### Examples

Use continued text:

 Set Variable \[ $PDF ; Value: MBS ("[DynaPDF.New](DynaPDFNew.md)") \]   
Set Variable \[ $r ; Value: MBS ( "[DynaPDF.AppendPage](DynaPDFAppendPage.md)"; $PDF ) \]   
Set Variable \[ $r ; Value: MBS ( "DynaPDF.BeginContinueText"; $PDF ; 100; 100 ) \]   
Set Variable \[ $r ; Value: MBS ("[DynaPDF.AddContinueText](DynaPDFAddContinueText.md)"; $PDF ; "Hello World 123" ) \]   
Set Variable \[ $r ; Value: MBS ("[DynaPDF.AddContinueText](DynaPDFAddContinueText.md)"; $PDF ; "ABCDEFGHIJK" ) \]   
Set Field \[ Examples::Barcode ; MBS ( "[DynaPDF.Save](DynaPDFSave.md)"; $PDF ) \]   
Set Variable \[ $r ; Value: MBS ( "[DynaPDF.Release](DynaPDFRelease.md)"; $PDF ) \]  
### See also

- [DynaPDF.AddContinueText](DynaPDFAddContinueText.md)
- [DynaPDF.AppendPage](DynaPDFAppendPage.md)
- [DynaPDF.New](DynaPDFNew.md)
- [DynaPDF.Release](DynaPDFRelease.md)
- [DynaPDF.Save](DynaPDFSave.md)
- [DynaPDF.SetFont](DynaPDFSetFont.md)
- [DynaPDF.SetFontOrigin](DynaPDFSetFontOrigin.md)
- [DynaPDF.SetLeading](DynaPDFSetLeading.md)

### Example Databases

- [DynaPDF/Create Text as PDFA](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/DynaPDF/Create%20Text%20as%20PDFA.shtml#3ScriptAnchor_)

This function checks for a license.

Created 18th August 2014 , last changed 13th January 2021

  
[DynaPDF.AttachFileText](DynaPDFAttachFileText.md) - [DynaPDF.BeginLayer](DynaPDFBeginLayer.md)

[HTML Version](DynaPDFBeginContinueText.shtml)