TextFontRemove

Purpose

Removes all fonts in text, or removes the font specified by fontToRemove or the combination of fontToRemove and fontScript.

Format

TextFontRemove(text{;fontToRemove;fontScript})

Parameters

text - any text expression or text field.

fontToRemove - any font name expressed in text.

fontScript - the name of a character set that contains characters required for writing in the specified language.

Parameters in curly braces { } are optional.

Note The fontScript parameter is not enclosed in quotation marks (“ “), and can have any of the values listed below in Description.

Data type returned

text

Originated in

FileMaker Pro 8.0

Description

Use this function to revert text to the default for the field. If you don’t specify a font, all of the text displays in the default font that was set in Layout mode for the field. When the font is specified by fontToRemove or the combination of fontToRemove and fontScript, only the specified font is removed from every portion of the text displayed in that font and these same portions of the text are then displayed in the field's default font.

Spellings for font names must be correct. Text formatting options will be lost if the field type that is returned is something other than text.

FileMaker Pro looks for a font that matches the specified font name and font script character set. If no matches exist, FileMaker Pro looks for a default font with the font script specified in the Fonts tab of the Preferences dialog box. If this fails, then the TextFontRemove function uses the default font for the system script specified in the Fonts tab of the Preferences dialog box. This font might not be the same as the font script provided.

The following font scripts are available:

•

Roman

•

Greek

•

Cyrillic

•	CentralEurope

•

ShiftJIS

•	TraditionalChinese

•	SimplifiedChinese

•

OEM

•

Symbol

•

Other

Examples

TextFontRemove(“Arial Text and Courier Text”) returns Arial Text and Courier Text displayed in the field’s default font.

TextFontRemove(“Arial Text and Courier Text”;“Arial”) returns Arial Text and Courier Text with the Arial font removed from the words Arial Text for all fontScripts that use the Arial font.

TextFontRemove(“Arial Text and Courier Text”;“Arial”;Cyrillic) returns Arial Text and Courier Text with the Arial font removed from Cyrillic character sets.