Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Replaces a text with a new text.

Component Version macOS Windows Linux Server iOS SDK
DynaPDF 3.4 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "DynaPDF.ReplacePattern"; PDF; Text; NewText { ; Alignment; NewFontSize; NewFontStyle; NewCharacterSpacing; NewTextScaling; NewTextRise; NewTextColor } )   More


Parameter Description Example Flags
PDF The PDF reference returned from DynaPDF.New. $pdf
Text The text to search. "Hello"
NewText The text to replace the found location with. "World"
Alignment The new alignment you want. 0 = Left, 1 = Center and 2 = Right. May not work with rotated text. 0 Optional
NewFontSize The new font size to use. Use -1 to keep whatever it is. Due to matrix scaling in pdf, the size here may be far off. Optional
NewFontStyle The new font style. Use -1 to keep whatever it is. e.g. 4 for underline, 2 for bold, 1 for italic or a combination. See dynapdf manual for more values for font styles. 0 Optional
NewCharacterSpacing The new character spacing value. See also DynaPDF.SetCharacterSpacing.
If undefined, keeps current character spacing.
2 Optional
NewTextScaling The text scaling to use. Optional
NewTextRise The text rise to use.
In percent of text height as plugin multipies y by given factor.
NewTextColor Available in MBS FileMaker Plugin 9.1 or newer.
The new stroke & fill color.
Pass negative number to keep existing color.
MBS( "DynaPDF.RGB"; 0; 0; 255 ) Optional


Returns number of locations found.


Replaces a text with a new text.
You need to have an open page. you can use DynaPDF.EditPage to edit an existing one.
Needs DynaPDF Pro license.

The replace pattern function is great to replace small place holder with real values in a text. But it doesn't do much formatting except parameters below and won't work with multi line texts. For bigger texts, please consider drawing a white rectangle and then use DynaPDF.WriteStyledText or similar functions to draw text on top.


Replace placeholder with text:

MBS("DynaPDF.ReplacePattern"; $pdf; "<<PLZ Ort>>"; "56645 Nickenich")

Replace some texts with different alignment:

Set Variable [ $r1 ; Value: MBS("DynaPDF.ReplacePattern"; $pdf; "Hello1"; "Hello World"; 0) ]
Set Variable [ $r2 ; Value: MBS("DynaPDF.ReplacePattern"; $pdf; "Hello3"; "Hello World"; 1) ]
Set Variable [ $r3 ; Value: MBS("DynaPDF.ReplacePattern"; $pdf; "Hello5"; "Hello World"; 2) ]

Replace text, make it centered and underlined:

MBS("DynaPDF.ReplacePattern"; $pdf; "Hello3"; "Hello World"; 1; -1; 4)

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 18th October 2023

DynaPDF.ReplaceImage - DynaPDF.ResetAnnotAP