If this guide is distributed with software that includes an end-user agreement, this guide, as well as the software described in it, is furnished under license and
may b e used or copied on ly in accordan ce with the te rms of such lic ense. Ex cept as p ermitte d by any su ch license, no part of t his guide may be reproduced, stored
in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe
Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an enduser license agreement.
The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Adobe
Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational
content contained in this guide.
Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The unauthorized
in corp orat ion of such mate rial into your new w ork c ould be a v iol ation of th e rig hts of the copy rig ht own er. Pl ease be s ure t o obtain any permission required from
the copyright owner.
Any references to company names in sample templates are for demonstration purposes only and are not intended to refer to any actual organization.
This work is licensed under the Creative Commons Attribution Non-Commercial 3.0 License. To view a copy of this license, visit
http://creativecommons.org/licenses/by-nc/3.0/us/
Adobe, the Adobe logo, Adobe AIR, Adobe Captivate, Adobe Type Manager, Acrobat, Distiller, Flash, FrameMaker, Illustrator, PageMaker, Photoshop, PostS cript,
Reader, RoboHelp, and RoboScreenCapture are trademarks of Adobe Systems Incorporated in the United States and/or other countries.
Microsoft, Windows, and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
SVG is a trademark of the World Wide Web Consortium; marks of the W3C are registered and held by its host institutions MIT, INRIA, and Keio. Helvetica is a
registered trademark of is a trademark of Heidelberger Druckmaschinen AG exclusively licensed through Linotype Library GmbH, and may be registered in
certain jurisdictions. ITC Zapf Dingbats is a trademark of International Typeface Corporation. Times New Roman is a registered trademark of The Monotype
Corporation registered in the U.S. Patent and Trademark Office and may be registered in certain other jurisdictions. All other trademarks are the property of their
respective owners.
This product contains either BSAFE and/or TIPEM software by RSA Data Security, Inc.
This product contains color data and/or the Licensed Trademark of The Focoltone Colour System.
PAN TO N E® Colors displayed in the software application or in the user documentation may not match PANTONE-identified standards. Consult current
PANTONE Color Publications for accurate color. PANTONE
Inc. is the copyright owner of color dat a and/or softwar e which a re licensed t o Adobe Sy stems Inc orporated to d istribu te for us e only in combination with Adobe
Fra meMa ker. PAN TONE Colo r Dat a and /or S oftw are s hall not b e cop ied o nto a nothe r di sk or i nto m emor y un less as pa rt of the e xec ution of Adobe FrameMaker
software.
Portions of Adobe Acrobat include technology used under license from Autonomy, and are copyrighted.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
Notice to U.S. government end users. The software and documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101, consisting of
“Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as
applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial
Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial items and (b) with only those rights as are granted
to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States. For U.S.
Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as
amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as
amended, and the regulations at 41 CFR Parts 60-1 through 60-60, 60-250, and 60-741. The affirmative action clause and regulations contained in the preceding
sentence shall be incorporated by reference.
A script is a series of commands that instructs Adobe® FrameMaker® to perform a set of specified actions. Scripts
automate repetitive tasks, such as counting the images in a book or adding an indent to all the para tags in a file. Use
scripts as a creative tool to streamline time-consuming tasks.
If you are new to scripting, you can acquaint yourself with the basic scripting concepts provided in the Introduction to
Scripting manual.
About this document
Naming conventions
To help you identify the structures, constants, and functions defined by the ESTK, this document adheres to the
following naming conventions:
Notice the use of different fonts to represent different types of information:
• What you type is shown in text like this.
• Function names, property names, structure names, returned values, constants, filter names, program names, paths,
and filenames are also shown in
text like this.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Overview
Scripting support in FrameMaker
FrameMaker supports ExtendScript, which is an extended implementation of JavaScript. While JavaScript files have .js
extension, ExtendScript files have .jsx extension.
For more information on JavaScript modules, tools, utilities, and features that are available to all JavaScript-enabled
Adobe applications, see
Development and debugging tools in ExtendScript toolkit
For assistance in developing, debugging, and testing scripts, Adobe provides the ExtendScript Toolkit. ExtendScript
Toolkit is an interactive development and testing environment for ExtendScript, which is installed with FrameMaker
and all JavaScript-enabled applications. For details, see Chapter 2, “The ExtendScript Toolkit” and Chapter 8,
“ExtendScript Tools and Features ” in
ExtendScript capabilities
Using ExtendScript Toolkit, you can develop and debug ExtendScript. ExtendScript provides the following features that
make scripting easy:
• User interface development tools: The ScriptUI module defines Window objects that represent platform-specific
windows and various control elements, such as buttons and static text. Resource specification allows you to create
user-interface elements. Using the event-handling callback functions, you can define the behavior of your userinteraction controls. ScriptUI provides a rich set of containers (such as Group, Panel, and TabbedPanel) and user
interface controls (such as Button, Image, Scrollbar, Treeview, and FlashPlayer). ScriptUI works with the
ExtendScript JavaScript interpreter to provide JavaScript programs with the ability to create and interact with user
interface elements. The Graphic customization objects provide the ability to customize the appearance of userinterface controls before they are drawn. For details, see Chapter 4, “User-Inter face Tools” in
JavaScript Tools Guide.
JavaScript Tools Guide.
JavaScript Tools Guide.
2
• Extensions:
• ExtendScript offers tools for communicating with other computers or the Internet using standard protocols. The
Socket object supports low-level TCP connections. For details, see Chapter 6, “External Communication Tools”
JavaScript Tools Guide.
in
• Adobe ExtendScript defines classes that simplify cross-platform file-system access. These classes are available to
all applications that support a JavaScript interface. For details, see Chapter 3, “File System Access” in
Tools Guid e .
JavaScript
• You can extend the JavaScript DOM for an application. To extend the JavaScript DOM, write a C or C++ shared
library, compile it for the relevant platform, and load it into JavaScript as an ExternalObject instance. A shared
library is implemented by a DLL in Windows, a bundle or framework in Mac OS, or a SharedObject in UNIX.
For details, see Chapter 7, “Integrating External Libraries” in
JavaScript Tools Guide.
• Inter-application communication and messaging: ExtendScript provides a common scripting environment for all
Adobe JavaScript-enabled applications. The cross-DOM API allows implementation of functions, such as open files
and execute scripts, that are common across message-enabled applications. Using simple syntax you can implement
application-specific functionality for message-enabled application. The BridgeTalk class of the messaging API has
globally available static properties and functions that provide access to environmental information relevant for
communication between applications. The error codes defined by the interapplication messaging protocol are
compatible with the ExtendScript error codes. For details, see Chapter 5, “Interapplication Communication with
Scripts” in
JavaScript Tools Guide
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Overview
Creating Scripts
Adobe provides ExtendScript Toolkit (ESTK) with its applications as a scripting utility. ESTK has many features that
ma ke it e asi er t o us e than a text e dit or. ESTK h as a bui lt-in syntax checker that identifies where the problems are in your
script and tries to explain how to fix them. You can run your scripts right from the ESTK without saving the file.
Running scripts without saving them first saves you time, especially when you are learning to work with ESTK.
Accessing ESTK
Connect ESTK to FrameMaker
When you launch ExtendScript Toolkit from FrameMaker (File > Script ...), ExtendScript Toolkit is already connected
to FrameMaker. Only when you launch ExtendScript Toolkit from Windows (Start > Programs...), complete the
following steps to connect ESTK to FrameMaker.
1 In the ExtendScript Toolkit, select Adobe FrameMaker <Version#> in the pop-up menu.
2 Click .
If FrameMaker is not already running, a message appears: “Target Adobe FrameMaker <Version#> is not running. Do
you want to launch Adobe FrameMaker <Version#>?”
3
3 Click Ye s .
FrameMaker is launched and connected to ESTK.
To write, edit, and run scripts
In FrameMaker, do the following:
1 Click File > Script > New Script.
The ESTK editor opens.
2 Write the script in the editor.
3 To run the script, click the Play button.
You can also start ExtendScript Toolkit from Windows (Start > Programs). When you start ExtendScript Toolkit from
Windows, connect ESTK to FrameMaker.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Overview
Using script library
In FrameMaker, select File > Script > Catalog to display the script library.
4
Using the script catalog, you can manage your existing scripts:
• Favorites: Scripts you tag as your favorite appear here.
• Autorun: These scripts run when FrameMaker is launched.
• Registered: Scripts that run on certain triggers, such as on opening a file or saving a file.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Overview
Using object model viewer
Object Model Viewer in ESTK helps you to get the information on different classes and the methods in ExtendScript.
Press F1 or click Help > Object Model Viewer to open Object Model Viewer.
5
In the Object Model Viewer, select an object model under Browse to you can do the following to locate information:
• Under Browser, select the object model for which you want the information. Object Model Viewer displays the
classes in the object model and details such as type, properties, method, and description of the class.
• Search for a class, method, or property.
• Bookmark a class, method, or property. It then appears under the Bookmarks section.
ExtendScript use cases
Some of the ExtendScript use cases can be:
• Scripts to automate repetitive tasks: You can write utilities to automate repetitive tasks, such as change alignment
of all the tables in a FrameMaker document.
• Notification-based scripts: You can write scripts that are triggered on FrameMaker events such as such as opening,
printing, or saving a document.
• Menu command scripts/scripts to extend FrameMaker functionality: Using these scripts, you can add menus and
commands in FrameMaker.
• Startup scripts: These scripts get executed when FrameMaker starts. You can set up scripts to run at startup by
copying them at the following location: <FMINSTALL_DIR>\startup. Alternatively, you can use the Script Library
dialog to register Autorun scripts.
Last updated 4/8/2014
Chapter 2: What’s new in ESTK 12
Support MathML
ESTK 12 provides support for the MathML “MathML” on page 386 object. Using the ESTK, you can now create and
work with MathML equations.
To create a new MathML object instance, use “NewMathML” on page 560.
CMS connector framework
The “CMSObject” on page 499 now extends support for the new “CMSShowPropertyUIWithTitle” on page 507method.
Support for background color in objects
6
ESTK 12 supports background color:
• FmtChangeList
Support for paragraph background color in objects
ESTK 12 supports background color:
• FmtChangeList
• Pgf
• PgfFmt
New properties
ESTK 12 provides the following new object properties:
ObjectProperties
CommandProduct: Specifies the Product (Structured, unstructured, XML Author) to add the command.
View: Specifies the View (WYSIWYG, Author, XML) to add the command.
Window: Specifies the Window (Doc, Book , Ditamap) to add the command.
“app” on
page 447
CharacterReferencesOnXMLExport: If there are leading/trailing whitespaces (spaces and tabs)
in elements, save the whitespaces as character references to enable round-tripping.
UserSettingsDir: Name of the FrameMaker app directory.
ProductFamily: The FrameMaker product family name (FrameMaker, FrameMaker XML Author)
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
What’s new in ESTK 12
7
Last updated 4/8/2014
Chapter 3: Sample ESTK scripts
ExtendScript is similar to JavaScript. You can easily develop ExtendScript for any of the applications in FrameMaker if
you are familiar with JavaScript.
Following are examples for scripts that automate specific activities in FrameMaker.
Note: Sample scripts shipped with FrameMaker are at the following location: <FMINSTALL_DIR>\samples
Adding text to a document and enabling change bars
The following script adds a sample text to a FrameMaker document and then enables the change bar. Open a
FrameMaker document before running the script.
Copy and paste the script to ESTK and select FrameMaker <Version#> as the target application. Click the Play button
to run the script.
var doc = app.ActiveDoc;
var firstPgf = doc.MainFlowInDoc.FirstTextFrameInFlow.FirstPgf;
var tl = new TextLoc(firstPgf, 0);
doc.AddText (tl, "Hello");
doc.AutoChangeBars = 1;
8
The script creates a text location using the
location. Using the
AddText()
method, add a sample text. Set the
new TextLoc()
method. Assign the first page of the document as the text
AutoChangeBars
property to 1 to enable the change bar.
Changing the table properties in a document
The following script changes the left indentation of all the tables in a FrameMaker body page by 1 inch. It also changes
the width of the columns to 2 inches. Open a FrameMaker document that has tables with two columns before running
the script.
var doc = app.ActiveDoc;
var flow = doc.MainFlowInDoc;
var tbl = 0;
var textItems = flow.GetText(Constants.FTI_TblAnchor);
for (var i = 0; i < textItems.len; i += 1)
{
tbl = textItems[i].obj;
The script creates the document’s main flow using the MainFlowInDoc method. Use the GetText(FTI_TblAnchor)
method to list all tables in the main flow. Using a for loop, for each table, use the
the left indentation.
TblLeftIndent()method to change
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Sample ESTK scripts
Use the TblColWidths() method to change the width of the column. This method accepts the argument in a metric
form. So, create the arguments as a metric object using the
new Metrics()method.
Note: By convention, there are 72 points per inch. Multiply the inch value with 65536 to get the correct value. 1 inch is equal
to 1 * 72 * 65536 points.
9
Last updated 4/8/2014
Chapter 4: Differences between scripts and
FDK
If you are familiar with the FDK (FrameMaker Developer Kit) object model, this chapter will help you get quickly get
familiarized with ESTK. Adobe FrameMaker scripts are modeled closely on the FrameMaker FDK. These scripts act as
wrappers to the FDK and hide the complexity of using FDK functions from users.
This chapter documents the differences between using scripts and using FDK.
Naming differences between scripts and FDK
FDKScripts
Every FDK object is identified by an object ID. Every script entity is identified as an object.
10
Every property in FDK starts with FP_.
For example, FP_CharTag.
Properties are used directly, in scripts. Remove the FP_ prefix before using the properties
in scripts.
For example, FP_CharTag in FDK becomes just CharTag in scripts.
Every property has its own data type. The properties can either be read-only or readwrite.
Note: All FDK properties can be used in FrameMaker scripts.
Every API in FDK starts with F_APImethodname.Methods are used directly in scripts. Remove the F_API prefix before using the methods
Every object in FDK starts with FO_.
For example, FO_Doc.
in scripts.
For example, F_ApiSplitElement becomes just SplitElement in scripts.
Use objects directly in scripts. Remove the FO_ prefix before using the objects in scripts.
For example, FO_Doc in FDK becomes just Doc in scripts.
Note: FDK object FO_Session is mapped to app and not to Session. This
app script object is readily available for all FrameMaker scripts to use.
Every structure in FDK starts with F_ and ends with a
T.
For example, F_AttributeT.
FDK uses data types such as StrngT for strings and
IntT, UintT for numbers.
Structures are used directly in scripts. Remove the F_ prefix and the ending ‘T ’ before
using the structures in scripts.
For example, F_AttributeT in FDK becomes just Attribute in scripts.
Some FDK structures contain other FDK structures within themselves. In a script, the
structures within a structure are treated as an object data type.
See the F_TextRangeT structure in Example 3 below.
Scripts map the FDK data types as follows:
StringT is mapped to Javascript String.
IntT and UinT are mapped to Javascript Number.
ObjHandleT is mapped to Javascript Object.
The following examples clearly highlight the differences between scripts and the FDK.
Example 1:
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Differences between scripts and FDK
The app property is readily available to all FrameMaker scripts and maps to the FO_Session object in FDK.
In this example, you query the ActiveDoc property that returns the Active Document Object(Doc) in the current
FrameMaker Session. The reference to this object is stored in the variable
As discussed in the table above, Example 1 demonstrates how FDK properties [FP_ActiveDoc, FP_MainFlowInDoc
FP_FlowIsSynchronized] are mapped to script properties [ActiveDoc, MainFlowInDoc and
and
FlowIsSynchronized].
Example 2:
Example 2 builds on Example 1 and shows how methods are called in scripts.
Every object has some methods of its own. These methods can be invoked in the same way as properties are invoked.
In Example 1, you created the doc object. To invoke a method, use doc.methodname(). For example,
doc.UpdateVariables();
This code calls the UpdateVariables method of the doc object.
FDK users can relate these methods to FDK APIs. The same code in FDK becomes:
F_ApiUpdateVariables(FV_SessionId, docId);
Notice how the FDK API F_ApiUpdateVariables becomes the method name UpdateVariables in scripts, as
mentioned in the table above.
Global Methods:
Not every method is accessible through a specific object. There are some methods that are not called through any
objects but are called directly. These methods are called Global Methods. Examples of Global Methods include
ChooseFile(), CallClent() and Sleep().
In addition to these methods, all FDK Variables and Macros are available as Global Methods. These Variables usually
start with
Every FDK Structure such as F_TextItemT, and F_TextLocT are also mapped to objects in scripts. All the fields of
these structures are mapped to the read or write properties of these objects.
Lines 6, 7, 8 can be combined and written by passing parameters in the constructor of the TextLoc object as:
textLoc = new TextLoc(pgf, 0);
Scripts have advanced features such as notifications and commands.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Differences between scripts and FDK
Notifications
Notifications is the internal mechanism through which a script registered for a particular event is run when the event
is triggered.
As an example, consider the following script:
/*
Sample script to demonstrate how to use notification mechanism of FrameMaker though
ExtendScript
*/
/*
There are basically two parts to a notification script.
1. Registering for a desired notification. (This is done by calling 'Notification()' with
desired notifications as argument.)
2. Implement a handler for these notifications in your script. ( Implement 'Notify()' in
script)
*/
/*
Part 1. Registering for Notifications
Notification()' is a global function and is available readily in scripting. (Similar to
F_ApiNotification())
The Syntax for Notification() is: Notification(int, int,.....,int, bool);
it takes:
a.) list of notifications(FA_Note_PreOpenDoc, FA_Note_PostOpenDoc etc.) and
b.) param bool: true = register for provided notification list, false = unregister for provided
notification list.
(This parameter is optional and by default 'true')
Note: for more details please see F_ApiNotification() in FDK reference guide.
*/
/*
Notification(FA_Note_PreOpenDoc,true);
This is same as Notification(FA_Note_PreSaveDoc)
or you can register for more than one notification at once
Notification(FA_Note_PostOpenDoc,FA_Note_PreSaveDoc);
Here we register for the notification: FA_Note_PostOpenDoc - this notification is
triggered just after a document is opened.
Notification(FA_Note_PostOpenDoc,true);
*/
/*
Part 2: handler
This can be done by implementing function 'Notify()' that are called by FrameMaker when any
13
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Differences between scripts and FDK
14
desired even occurs.(Similar to F_ApiNotify())
Syntax for this callback function is:
@params
of the affected file. If the notification is for text entry, sparm specifies the text the user
typed.)
*/
function Notify(note, object, sparam, iparam)
{
switch (note) {
}
note: notification id to identify the event.
object: current document or book object which generated the event.
sparam: The string, if any, associated with the notification
(For example, if the notification is for an Open or Save operation, sparm specifies the pathname
iparam: The Integer, if any, associated with the notification. Probably the fcode or bit flags.
Notify(note, doc, sparam, iparam)
Note: for more details please see F_ApiNotify() in FDK reference guide.
case FA_Note_PostOpenDoc:
alert("Opened document " + sparam);
break;
The line of code:
Notification(FA_Note_PostOpenDoc,true);
registers this script for the FA_Note_PostOpenDoc notification. This notification is triggered just after any document
is opened in FrameMaker.
The lines of code:
function Notify(note, object, sparam, iparam)
{
switch (note) {
case FA_Note_PostOpenDoc:
alert("Opened document " + sparam);
break;
}
pops up an alert with the file name just after the file is opened.
Menus and Commands
Scripting allows you to add custom menus and associate commands with these menus. In addition, you can implement
your own handlers for commands in a similar way as the FDK.
The following script adds two menus and associated commands to the FrameMaker main menu.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Differences between scripts and FDK
/*
In this script, we add two menu items to FrameMaker Session and associate two different
commands to these menu items
*/
// Main menu bar
/* First we get the object associated with Main menubar in FrameMaker*/
mMenu = app.GetNamedMenu("!MakerMainMenu") ;
// F_ApiGetNamedMenu(FV_SessionId, FO_Menu, (ConStringT)"!MakerMainMenu")
/*
Defining new menu items
DefineAndAddMenu(name, label)
FDK equivalent : F_ApiDefineAndAddMenu(F_ObjHandleT toMenuId, StringT name, StringT label)
*/
nMenu1 = mMenu.DefineAndAddMenu("Menu1", "Menu1");
nMenu2 = mMenu.DefineAndAddMenu("Menu2", "Menu2");
// Adding command to menus
/*
DefineAndAddCommand(cmdID, name, label, shortcut)
FDK equivalent: F_ApiDefineAndAddCommand(IntT cmdID, F_ObjHandleT toMenuId, StringT name,
StringT label, StringT shortcut)
cmdID is a integer that will be passed to Command() function defined in your script. It should
be unique to the script.
*/
nMenu1.DefineAndAddCommand(1,"cmd1","command1","");
nMenu2.DefineAndAddCommand(2,"cmd2","command2","");
// Another way for creating a command and adding it to menu items.
//cmd3 = DefineCommand(3, "cmd3", "cmd3", "");
// FDK equivalent : F_ApiDefineCommand(IntT cmdID, StringT name, StringT label, StringT shortcut)
// add the command to different menu items
//nMenu1.AddCommandToMenu(cmd3);
// FDK equivalent : ApiAddCommandToMenu(F_ObjHandleT toMenuId, F_ObjHandleT commandId)
//nMenu2.AddCommandToMenu(cmd3);
// must call if script has been run through ESTK, redundant otherwise.
UpdateMenus();
// Call back equivalent to F_ApiCommand(command)
function Command(cmd){
switch(cmd) {
case 1:
case 2:
}
}
alert("Command1 executed");
break;
alert("Command2 executed");
break;
15
Let us examine the script in detail:
1 The line: mMenu = app.GetNamedMenu("!MakerMainMenu") ; fetches the name of the FrameMaker main menu
The first value within the parenthesis is the menuID. This value is passed to the case statement.
The system pops up the relevant alert when the corresponding menu entry is clicked.
16
Last updated 4/8/2014
Chapter 5: Object Reference
AFrame
Property nameData TypeDescription
AFrameIsCroppedboolIndicates whether the anchored frame is cropped or not.
Possible values are:
0 - (Default) Indicates the frame is not cropped.
1 - Indicates the frame is cropped.
17
AFrameIsFloatingboolIndicates whether the anchored frame is set to be
AlignmentnumberIndicates how the anchored frame is aligned.
floatable or not.
Possible values are:
0 - (Default) Indicates the frame is not floatable.
1 - Indicates the frame is floatable.
Possible values are:
• Constants.FV_ALIGN_LEFT (0)
• Constants.FV_ALIGN_CENTER (1)
• Constants.FV_ALIGN_RIGHT (2)
• Constants.FV_ALIGN_INSIDE (3)
• Constants.FV_ALIGN_OUTSIDE (4)
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
AnchorTypenumberIndicates the location where the frame is anchored.
Possible values are:
• Constants.FV_ANCHOR_INLINE (1)
• Constants.FV_ANCHOR_TOP (2)
• Constants.FV_ANCHOR_BELOW (3)
• Constants.FV_ANCHOR_BOTTOM (4)
• Constants.FV_ANCHOR_SUBCOL_LEFT (5)
• Constants.FV_ANCHOR_SUBCOL_RIGHT (6)
• Constants.FV_ANCHOR_SUBCOL_NEAREST (7)
• Constants.FV_ANCHOR_SUBCOL_FARTHEST (8)
• Constants.FV_ANCHOR_SUBCOL_INSIDE (9)
• Constants.FV_ANCHOR_SUBCOL_OUTSIDE (10)
• Constants.FV_ANCHOR_TEXTFRAME_LEFT (11)
18
• Constants.FV_ANCHOR_TEXTFRAME_RIGHT (12)
• Constants.FV_ANCHOR_TEXTFRAME_NEAREST (13)
• Constants.FV_ANCHOR_TEXTFRAME_FARTHEST (14)
• Constants.FV_ANCHOR_TEXTFRAME_INSIDE (15)
• Constants.FV_ANCHOR_TEXTFRAME_OUTSIDE (16)
• Constants.FV_ANCHOR_RUN_INTO_PARAGRAPH (17)
BaselineOffsetnumberBaseline Offset
ElementElementIf the anchored frame is in a structured flow in a
InTextFrameTextFrameIndicates the text frame in which the anchored frame is
InTextObjFMObjectIndicates th e column or text frame in which the anchored
NextAFrameAFrameContains the next anchored frame in the text frame.
PrevAFrameAFrameContains the previous anchored frame in the text frame.
SideOffsetnumberDenotes the near side offset.
Tex t LocTextLocContains the location of the anchor symbol.
FirstGraphicInFra meFMObjectContains the first object in the anchored frame.
FrameMaker document, Element indicates the element
containing the anchored frame.
placed.
frame is placed.
LastGraphicInFrameFMObjectContains the last object in the anchored frame.
AnglenumberIndicates the angle of rotation of the graphic object.
ArrowBaseAnglenumberDenotes the arrowhead base angle in degrees.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
19
ArrowLengthnumberDenotes the arrowhead length (always rounded down to
ArrowScaleFactornumberIndicates the factor by which the arrowhead is scaled as
ArrowScaleHeadnumberSet to 1 if arrowhead is scaled as the line width changes.
ArrowTipAnglenumberDenotes the arrowhead tip angle in degrees.
ArrowTypenumberDenotes the style of the arrowhead. Possible values are:
the nearest 1/256 point).
line width changes (always rounded down to nearest
1/16 point). It is not used if the ArrowScaleHead property
is False.
Set to 0, otherwise.
• Constants.FV_ARROW_STICK (0x1)
• Constants.FV_ARROW_HOLLOW (0x2)
• Constants.FV_ARROW_FILLED (0x3)
BorderWidthnumberIndicates the border width specified in points. The
ColorColorDenotes the spot color.
DashMetricsSpecifies a dash pattern that is repeated for the length of
permissible range is 0.015 pt to 360 points.
an object's border. The pattern is stored in a MetricsT
structure. The 0th element of the MetricsT.MetricsT_val
array stores the length of the first dash; the 1st element
stores the following space; the 2nd element stores the
next dash; and so on for an even number of elements.
FillnumberDenotes the fill pattern (numbers between 0 and 15).
Constants are provided for fill patterns 0, 7 and 15, as
follows:
• Constants.FV_FILL_BLACK (0)
• Constants.FV_FILL_WHITE (7)
• Constants.FV_FILL_CLEAR (15)
FrameParentFMObjectDenotes the frame containing the graphic object.
GraphicCantBeSelectednumberSet to 1 if the graphic object cannot be selected. Set to 0,
GraphicIsSelectednumberSet to 1, if the graphic object is selected. Else, set to 0.
GroupParentGroupSpecifies the group to which the object belongs.
HeadArrownumberSet to 1 if the line has an arrow head. Set to 0, otherwise.
HeightnumberDenotes the height of the object denoted in points. The
HotspotCmdStrStringTThe command string for a hotspot. Thismust be a valid
HotspotTitleStringTThe tooltip text for the hotspot in the outputs that
otherwise.
Note: Anchored frames do NOT have this property.
permissible range is from 0.125 points to 3600 points.
hypertext command string.
support it (for example HTML). This property is 0ptional.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
20
IsHotspotBoolWhether the object is a hotspot or not. If this property is
LineCapnumberSpecifies the type of the end of the line. The possible
turned off, the object is no longer a hotspot even if
command string is non-empty.
values are:
• Constants.FV_CAP_BUTT (0x00)
• Constants.FV_CAP_ROUND (0x01)
• Constants.FV_CAP_SQUARE (0x02)
LocXnumberSpecifies the distance of the object from the left side of
LocYnumberDistance of the object from the top of the parent frame (in
NextGraphicInDocFMObjectDenotes the next graphic object in the document.
NextGraphicInFrameFMObjectDenotes the next graphic object in the frame.
the parent frame (in inches). The permissible range is –
216 inches to 216 inches.
If the graphic object is an anchored frame, the distance is
automatically calculated from the left side of the page
frame. You cannot set this value manually for anchored
frames.
inches) The permissible range is –216 inches to 216
inches.
If the graphic object is an anchored frame, the distance is
automatically calculated from the top of the page frame.
You cannot set this value manually for anchored frames.
NextGraphicInGroupFMObjectDenotes the next graphic object in the group.
NextSelectedGraphicInDocFMObjectDenotes the next selected graphic object in the
ObjectAttributesStringsA list of strings. Each string expresses an attribute that is
OverprintnumberSpecifies the overprint settings for the object. The
document.
specified for an anchored frame in the Object Properties
> Object Attributes dialog box. Each string is in the form
of string_text.You can use the backslash to escape
characters such as \n, \r, or \t for newline, carriage return,
and tab, respectively. For a backslash character in the
string text, type \\.
possible values are:
• Constants.FV_KNOCKOUT (0x00)
• Constants.FV_OVERPRINT (0x01)
• Constants.FV_FROMCOLOR (0x02)
PennumberSpecifies the pen pattern (numbers between 0 and 7).
Constants are provided for pen patterns 0, 7 and 15, as
follows:
• Constants.FV_FILL_BLACK (0)
• Constants. FV_FILL_WHITE (7)
• Constants.FV_FILL_CLEAR (15)
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
PrevGraphicInFrameFMObjectDenotes the previous graphic object in the frame.
PrevGraphicInGroupFMObjectDenotes the previous graphic object in the group.
21
RunaroundnumberSpecifies whether text can flow around the object and, if
so, whether the text follows the contour of the object or a
box shape surrounding the object. The possible values
are:
• Constants.FV_TR_NONE (0x01)
• Constants.FV_TR_CONTOUR (0x02)
• Constants.FV_TR_BBOX (0x03)
RunaroundGapnumberDenotes the width of the runaround gap, if the object is a
TailArrownumberSet to 1 if the arrowhead is enabled at the begining of the
TintPercentnumberSpecifies the tint percentage.
UniquenumberIndicates the graphic object's internal unique number.
WidthnumberDenotes the width of the object. The permissible range is
FirstGraphicInFra meFMObjectContains the first object in the anchored frame.
LastGraphicInFrameFMObjectContains the last object in the anchored frame.
runaround object.
line; Set to
from 0.125 points to 3600 points.
0 otherwise.
AFrame methods
Delete, GetProps, SetProps, ObjectValid.
Arc
Property nameData TypeDescription
DThetanumberDenotes the arc angle length in degrees. The permissible
ThetanumberSpecifies the start angle in degrees. The permissible
AnglenumberSpecifies the angle of the object's rotation.
ArrowBaseAnglenumberIndicates the arrowhead base angle in degrees.
ArrowLengthnumberDenotes the arrowhead length (always rounded down to
ArrowScaleHeadnumberSet to 1 if the arrowhead is scaled as the line width
ArrowScaleFactornumberSpecifies the factor by which arrowhead is scaled as line
Last updated 4/8/2014
range is –360 degrees to +360 degrees.
range is 0 degrees to 360 degrees.
the nearest 1/256 point).
changes. Set to 0, otherwise.
width changes (always rounded down to nearest 1/16
point). It is not used if the ArrowScaleHead property is set
to False.
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
ArrowTipAnglenumberSpecifies the arrowhead tip angle in degrees.
ArrowTypenumberDenotes the Arrowhead style. Possible values are:
• Constants.FV_ARROW_STICK (0x01)
• Constants.FV_ARROW_HOLLOW (0x02)
• Constants.FV_ARROW_FILLED (0x03)
22
BorderWidthnumberSpecifies the border width in points. The permissible
ColorColorIndicates the spot color.
DashMetricsSpecifies a dash pattern that is repeated for the length of
FillnumberDenotes the fill pattern. The patterns are denoted by
range is 0.015 point to 360 point.
an object's border. The pattern is stored in a Metrics
object. The 0
MetricsT.MetricsT_val array stores the length of
the first dash; the 1st element stores the following space;
the 2nd element stores the next dash; and so on for an
even number of elements.
numbers between 0 and 15.
The following constants are provided for the fill patterns
0, 7 and 15:
th
element of the
• Constants.FV_FILL_BLACK (0)
• Constants.FV_FILL_WHITE (7)
• Constants.FV_FILL_CLEAR (15)
FrameParentFMObjectSpecifies the frame containing the graphic object.
GraphicCantBeSelectednumberSet to 1 if the graphic object cannot be selected. Else, set
GraphicIsSelectednumberSet to 1 if the graphic object is selected, else set to 0.
GroupParentGroupIndicates the group to which the object belongs.
to 0.
Anchored and unanchored frames do not have this
property.
HeadArrownumberSet to 1 if line has an arrowhead, set to 0 otherwise.
HeightnumberSpecifies the height of the object in points. The
HotspotCmdStrStringTThe command string for a hotspot. Thismust be a valid
HotspotTitleStringTThe tooltip text for the hotspot in the outputs that
IsHotspotBoolWhether the object is a hotspot or not. If this property is
permissible range is from 0.125 pt to 3600 pt.
hypertext command string.
support it (for example HTML). This property is 0ptional.
turned off, the object is no longer a hotspot even if
command string is non-empty.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
LineCapnumberIndicates the type of line end. The possible values are:
• Constants.FV_CAP_BUTT (0x00)
• Constants.FV_CAP_ROUND (0x01)
• Constants.FV_CAP_SQUARE (0x02)
23
LocXnumberSpecifies the distance of the object from the left side of
LocYnumberSpecifies the distance of the object from the top of the
NextGraphicInDocFMObjectIndicates the next graphic object in the document.
NextGraphicInFrameFMObjectDenotes the next graphic object in the frame.
NextGraphicInGroupFMObjectIndicates the next graphic object in the group.
NextSelectedGraphicInDocFMObjectSpecifies the next selected graphic object in the
ObjectAttributesStringsContains a list of strings, each string expressing an
the parent, in inches. The permissible range is from –216
inches to 216 inches.
If the graphic object is an anchored frame, the distance is
automatically calculated from the left side of the page
frame. You cannot set the LocX property for anchored
frames.
parent frame, in inches. The permissible range is from –
216 inches to 216 inches.
If the graphic object is an anchored frame, the distance is
automatically calculated from the top of the page frame.
You CANNOT set the LocY property for anchored frames.
document.
attribute that is specified for an anchored frame in the
Object Properties > Object Attributes dialog box. Each
string is in the form of string_text .You can use the
backslash to escape characters such as \n, \r, or \t for
newline, carriage return, and tab, respectively. For a
backslash character in the string text, type \\.
OverprintnumberSpecifies the overprint settings for the object. The
possible values are:
• Constants.FV_KNOCKOUT (0x00)
• Constants.FV_OVERPRINT (0x01)
• Constants.FV_FROMCOLOR (0x02)
PennumberIndicates the pen pattern, denoted by numbers between
0 and 7.
Constants are provided for some of the fill patterns:
• Constants.FV_FILL_BLACK (0)
• Constants.FV_FILL_WHITE (7)
• Constants.FV_FILL_CLEAR (15)
PrevGraphicInFrameFMObjectSpecifies the previous graphic object in the frame.
PrevGraphicInGroupFMObjectIndicates the previous graphic object in the group.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
24
RunaroundnumberSpecifies whether text can flow around the object and, if
so, whether the text follows the contour of the object or a
box shape surrounding the object. Possible values are:
• Constants.FV_TR_NONE (0x01)
• Constants.FV_TR_CONTOUR (0x02)
• Constants.FV_TR_BBOX (0x03)
RunaroundGapnumberDenotes the width of the runaround gap, if the object is a
TailArrownumberSet to 1 if the arrowhead is enabled at the beginning of
TintPercentnumberSpecifies the tint percentage.
UniquenumberDenotes the internal identifier of the graphic object.
WidthnumberSpecifies the width of the object in points. The
runaround object.
the line. Set to
permissible range is 0.125 point to 3600 point.
0, otherwise.
Arc methods
Delete, GetProps, ObjectValid, SetProps.
AttrCondExpr
Property nameData TypeDescription
NextAttrCondExprInDocAttrCondExprIndicates the pointer to the next AttrCondExpr object
AttrCondExprStrstringThe AttrCondExpr expression in string format.
AttrCondExprIsActiveboolSet to True if this expression is applied to the document.
in the document.
(Application will mean filtering the document according
the constraints in the expression). Set to False, otherwise.
valflagsuintThe validation error flags. This property is read only.
25
allowuintAllow error as special case to suppress reporting by
validation.
Attribute methods
Attribute.
AttributeDef
Property nameData TypeDescription
namestringName of the attribute
requirednumberSet to 1 if the attribute is required. Else, set to 0.
flagsuintThe flag value determines whether an attribute is hidden,
read-only or neither.
The following are the values that an attribute can have:
• Constants.FV_AF_READ_ONLY (0x0001) - The attribute
value is read-only.
• Constants.FV_AF_HIDDEN (0x0002) - The attribute
value is hidden.
• NULL - The attribute value is neither read-only nor
hidden.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
attrTypenumberDenotes the attribute value’s type. The value is one of:
• Constants.FV_AT_STRING (0) - Any arbitratry text string.
• Constants.FV_AT_STRINGS (1) - One or more arbitrary
text strings.
• Constants.FV_AT_CHOICES (2) - A value from a list of
choices.
• Constants.FV_AT_INTEGER (3) - A signed whole
number (optionally restricted to a range of values).
• Constants.FV_AT_INTEGERS (4) - One or more integers
(optionally restricted to a range of values).
• Constants.FV_AT_REAL (5) - A real number (optionally
restricted to a range of values).
• Constants. FV_AT_REALS (6) - One or more real
numbers (optionally restricted to a range of values).
• Constants.FV_AT_UNIQUE_ID (7) - A string that
uniquely identifies an element.
26
• Constants.FV_AT_UNIQUE_IDREF (8) - A reference to a
UniqueID attribute.
• Constants.FV_AT_UNIQUE_IDREFS (9) - One or more
references to a UniqueID attribute.
choicesStringsThe choices from which to select, if the Type parameter is
defValuesStringsDefalut value of the attribute.
rangeMinstringThe minimum permissible value, if any.
rangeMaxstringThe maximmum permissible value, if any.
Constants.FV_AT_CHOICES (2).
set to
AttributeDef methods
AttributeDef.
AttributeDefs
An Array of AttributeDef objects with integer indexing and a length property.
Property nameData TypeDescription
lengthnumberThe length of the array
AttributeDefs methods
concat, pop, push.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
AttributeEx
Property nameData TypeDescription
namestringThe name of the attribute.
valuesStringsThe attribute value.
valflagsuintThe validation error flags. This property is read only.
27
allowuintAllow error as special case to suppress reporting by
validation.
Attributes
An Array of Attribute objects with integer indexing and a length property.
Property nameData TypeDescription
lengthnumberThe length of the array.
Attributes methods
concat, pop, push.
AttributesEx
An Array of AttributeEx objects with integer indexing and a length property.
Property nameData TypeDescription
lengthnumberThe length of the array.
AttributesEx methods
concat, pop, push.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
BodyPage
Property nameData TypeDescription
28
MasterPagestringDenotes the name of the master page background for the
PageBackgroundnumberIndicates the type of master page background. The
body page if the PageBackground property is set to
Constants.FV_BGD_OTHER (0x02).
The value is null if the PageBackground property is set
to either Constants.FV_BGD_DEFAULT (0x00) or
Constants.FV_BGD_NONE (0x01).
possible values are:
• Constants.FV_BGD_DEFAULT (0x00): The page has a
Left or Right master page background if the document
is double-sided, or a Right master page background if
the document is single-sided.
• Constants.FV_BGD_NONE (0x01): The page has no
master page background.
• Constants.FV_BGD_OTHER (0x02): The page has the
custom master page background specified by the
MasterPage property.
To determine whether a body page has a Left or a Right
master page background, when its PageBackground
property is set to Constants.FV_BGD_DEFAULT (0x00),
query its PageIsRecto property.
PageFrameUnanchoredFrameDenotes the page frame for the page.
PageH eightnumberIndicates the height of the page.
PageI sRectonumberSet to 1 if the page is a Right page; Set to 0 if the page is a
Left page.
PageN extBodyPageDenotes the next body page in the document.
PageN umnumberContains the current page number.
PageNumStringstringContains the page number string.
PagePrevBodyPageDenotes the previous body page in the document.
PageW idthnumberDenotes the width of the page.
PointPageNumnumberIndicates the point page number.
BookDontUpdateReferencesnumberSet to 0 if FrameMaker is set to update cross-references
BookIsModifiednumberSet to 1 if the book has been modified; Set to 0, otherwise.
BookIsSelectednumberSet to 1 if the book icon in the book window is selected;
FirstComponentInBookBookComponentDenotes the first component in the book.
FirstSelectedComponentInBookBookComponentDenotes the first selected component in the book.
IsIconifiednumberSet to 1 if the book window is iconified; set to 0 otherwise.
IsInFrontnumberSet to 1 if the book window is in front of other windows in
IsOnScreennumberSet to 1 if the document is visible on the screen; Set to 0
LabelstringDenotes the title in the book window title bar.
NamestringIndicates the path of the book.
NextOpenBookInSessionBookDenotes the next open book in FrameMaker session's list
StatusLinestringString that appears in the book status bar. Querying this
when it opens the book; Set to 1, otherwise.
Set to 0 otherwise.
the FrameMaker product session; Set to 0 otherwise.
otherwise.
Note: The IsOnScreen property is always 1 for books, and
setting it to 0 has no effect.
of open books.
string returns the status string.
ScreenHeightnumberDenotes the height of the book window in pixels.
ScreenWidthnumberDenotes the width of the book window in pixels.
ScreenXnumberSpecifies the offset of the book window in pixels from the
ScreenYnumberIndicates the offset of the book window in pixels from the
Type OfDi spla yTextnumberSpecifies the type of text snippet to display for each icon
left side of the screen (or the left of the FrameMaker
product application window).
If you set a value that results in the book window being
off the screen, that value is ignored and the old value is
retained.
top of the screen (or the top of the FrameMaker product
application window ).
If you set a value that results in the book window being
off the screen, that value is ignored and the old value is
retained.
in the book window. The two possible values are:
• Constants.FV_BK_FILENAME (1)- displays the book
component's filename
• Constants.FV_BK_TEX T (2) - displays the first paragraph
of the component's first flow.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
30
AcrobatBookmarkDisplayTagsnumberSet to 1 if the
DocAcrobatColumnArticleThreadsnumberSet to 1 if you want separate article threads for each
IncludeParagraphTagsinBookmarkText property
1 (the paragraph tag is added before the
is set to
paragraph text in each bookmark); Set to 0 otherwise.
column; set to 0 if you want separate article threads for
each text frame.
Note: The DocPDFNoArticleThread property
must be set to FALSE, when setting this option.
DocAcrobatDefaultsChangednumberSet to 1 if the default heuristics for determining the
DocAcrobatElementListStringsContains a list of the element tags and context labels to
paragraph level are disabled; Set to 0, otherwise.
include in bookmarks.
Note: The DocPDFElementList property applies
only to structured FrameMaker documents.
DocAcrobatElementsnumberSet to 1 if elements rather than paragraphs are used for
bookmarks; Set to 0 otherwise.
Note: The DocPDFElements property applies only
to structured FrameMaker documents.
DocAcrobatNoArticleThreadsnumberSet to 1 if you do not want ar ticle threads in the resulting
GenerateAcrobatInfonumberSet to 1 if the GenerateAdobeAcrobatData property is set
PDF; Set to 0 otherwise.
to True. Else, set to 0.
To generate PDF data, you must set the other document
print properties as follows:
• PrintToFile - True
• PrintThumbnails - False
• PrintSeps - False
• PrintBlankPages - True
• PrintLastSheetFirst - False
• PrintNumCopies - 1
• PrintOddPages - True
• PrintEvenPages - True
• PrintScale - 100%
PDFBookmarkboolSet to True if FrameMaker is set to generate bookmarks
when saving as PDF. Set to False, otherwise.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
31
PDFBookmarksOpenLevelnumberDenotes the level of bookmarks to be expanded when
Acrobat opens the generated PDF document. The value
can be any integer, or one of the following constants:
• Constants.FV_PDFBookmarksOpenDefaultLevel (-1)
• Constants.FV_PDFBookmarksOpenAllLevels (-2)
• Constants.FV_PDFBookmarksOpenNoneLevel (-3)
If you specify an integer that is greater than the number
of levels in the Bookmarks Settings, the
Constants.PDFBookmarksOpenAllLevels (-2) value takes
effect.
PDFConvertCMYKtoRGBnumberWhen set to 1, the PDFConvertCMYKtoRGB property
PDFDestsMarkednumberSet to 1 if the document has paragraphs or elements
corresponds with the setting "
" in the Save As PDF dialog box.
to RGB
marked through the
property.
One of two things must occur in order for this property to
be True:
1. The document must have been created and opened in
FrameMaker 6.0 or later.
2. The PDF FileSize Optimization client must have
been run over it to mark all paragraphs or elements that
are targets of hypertext links.
Convert CMYK colors
MarkedForNamedDestination
PDFDistillerAbsentnumberA value of 1 indicates that there is no Acrobat Distiller
PDFDocInfoStringsContains a list of strings expres sing values to be set in the
PDFEndPagestringDenotes the last page in the range of pages to be printed,
PDFJobOptionstringSpecifies the name of the Distiller Job Options. If the
PDFJobOptionsAbsentnumberA value of 1 indicates that PDF Job Options are not
PDFOpenPagestringDenotes the PDF page number, in the FrameMaker
PDFPageHeightnumberDenotes the page height for the generated PDF
PDFPageWidthnumberIndicates the page width for the generated PDF
available. Any other value indicates that Acrobat Distiller
is available.
PDF Document Info dictionary wh en you save the book as
PDF. Each dictionary entr y is expressed as a pair of strings;
the first string expresses the field name, and the second
string expresses the field value.
in the FrameMaker numbering style.
specified name does not exist in the Distiller Job Options
list, then the first Distiller Job Option in the list is used.
available. Any other value indicates that PDF Job Options
are available.
numbering style, at which Acrobat opens the generated
PDF document.
document.
document.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
32
PDFPrintPageRangenumberSpecifies the page range for generating the PDF
PDFRegistrationMarksnumberContains the registration marks for the generated PDF.
document. If set, the PDF file contains only the specified
pages. Else, FrameMaker generates PDF for the entire
document or book.
The permissible values are:
• Constants.FV_PDFRegistrationMarksNone (0)
• Constants.FV_PDFRegistrationMarksWestern (1)
• Constants.FV_PDFRegistrationMarksTombo (2)
PDFSeparateFilesnumberSet to 1, if a separate PDF file should be generated for
PDFStartPagestringDenotes the first page of the printing page range, in the
PDFZoomFactornumberWhen the PDFZoomType property is set to
PDFZoomTypenumberDenotes the PDF zoom setting at which Acrobat opens
each document in a book; Set to 0 otherwise. This
property can be set for single documents, but is ignored
in that case.
FrameMaker numbering style.
Constants.FV_PDFZoomNone (0), the
PDFZoomFactor property denotes the zoom
percentage of the PDF document (metric 25% to 1600%).
If the value is negative or zero, the value of
Constants.FV_PDFZoomDefault (1) takes effect.
the generated PDF document. Permissible values are:
• Constants.FV_PDFZoomNone (0)
• Constants.FV_PDFZoomDefault (1)
• Constants.FV_PDFZoomPage (2)
• Constants.FV_PDFZoomWidth (3)
• Constants.FV_PDFZoomHeight (4)
If a value other than these is specified,
Constants.FV_PDFZoomDefault (1) takes effect.
PDFAllNamedDestinationsnumberSet to 1 if the generated PDF document should include
PrintBlankPagesnumberSet to 1 if the PageRounding property is set to allow
PrintCollatednumberSet to 1 if Collate is enabled; Set to 0 otherwise.
PrintEmulsionnumberDenotes the direction of the print emulsion. The possible
Named Destinations for every paragraph and
FrameMaker structure element in the book. This results in
a larger PDF filesize.
If set to 0, the generated PDF document will have Named
Destinations only for those paragraphs and objects that
have already been marked with PDFDestsMarked set to
True.
empty pages at the end of documents; set to 0 otherwise.
value are:
• Constants.FV_EMUL_UP (0) - Emulsion side up
Last updated 4/8/2014
• Constants.FV_EMUL_DOWN (1) - Emulsion side down
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
PrinterNamestringThis property has no effect.
PrintEvenPagesnumberSet to 1 if Print Even-Numbered Pages is enabled.
33
PrintFileNamestringSpecif ies the filename to print to. You can set the filename
PrintImagingnumberDenotes the type of print imaging. The permissible values
to be the default filename by specifying the
PrintFileName value as null.
are:
• Constants.FV_IMG_POSITIVE (0)
• Constants.FV_IMG_NEGATIVE (1)
PrintLastSheetFirstnumberSet to 1 to print the last sheet first. Else, set to 0.
PrintLowResnumberSet to 1 to print in low resolution. Else, set to 0.
PrintNumCopiesnumberDenotes the number of copies to print.
PrintOddPagesnumberSet to 1 if Print Odd-Numbered Pages is enabled.
PrintPaperHeightnumberSpecifies the height of the printing paper.
PrintPaperWidthnumberIndicates the width of the printing paper.
PrintRegistrationMarksnumberSet to 1 if Registration Marks is enabled; Set to 0
PrintScalenumberDenotes the Print scale factor expressed as a percentage
PrintSepsnumberSet to 1 if Print Separations is enabled.
otherwise.
metric (0% to 100%).
For print scale percentages, the value 1<<16 or 0x10000
specifies 100%.
PrintToFilenumberSet to 1 if Print Only to File is enabled.
SkipBlankSepsnumberSet to 1 if Skip Blank Separations (do not print blank color
CustomElementListStringsContains the list of tags to display when
ElementCatalogElementCatalogEnt
ries
ElementCatalogDisplaynumberCatalog display options. Show tags for:
separations) is enabled.
ElementCatalogDisplay is set to
Constants.FV_ELCAT_CUSTOM (0x04).
Contains a list of elements in the Element Catalog.
• Constants.FV_ELCAT_STRICT (0x00): Valid children for
working from start to finish.
• Constants.FV_ELCAT_LOOSE (0x01): Valid children for
working in any order.
• Constants.FV_ELCAT_CHILDREN (0x02): Children
allowed anywhere in parent.
• Constants.FV_ELCAT_ALL (0x03): All elements.
• Constants.FV_ELCAT_CUSTOM (0x04): List of tags
specified by the CustomElementList property.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
34
FileExtensionOverridestringDenotes the filename extension to use when saving the
ElementSelectionElementRangeIndicates the currently selected element range in the
FirstFmtChangeListInDocFmtChangeListSpecifies the ID of the first format change list in the list of
FirstElementDefInDocElementDefDenotes the first element definition in the list of element
HighestLevelElementElementDenotes the top most element for a structured
NewElemAttrDisplaynumberSpecifies the attribute display properties for new
document as XML. Typically, this property is used to save
XHTML with a .htm extension rather than .xml. This
setting should be set in the structure application for the
document's DOCTYPE.
book.
format change lists in the book.
definitions in the document (FO_ElementDef ID).
book/document.
elements. The permissible values are:
• Constants.FV_ATTR_DISP_NONE (1): Do not display
attributes.
• Constants.FV_ATTR_DISP_REQSPEC (2): Display
required and specified attributes.
• Constants.FV_ATTR_DISP_ALL (3): Display all
attributes.
NewElemAttrEditingnumberSpecifies when the Edit Attributes dialog box appears for
new elements. The permissible values are:
• Constants.FV_ATTR_EDIT_NONE (0)
• Constants.FV_ATTR_EDIT_REQUIRED (1)
• Constants.FV_ATTR_EDIT_ALWAYS (2)
SeparateInclusionsnumberSet to 1 if inclusions are listed separately in the element
StructuredApplicationstringContains the name of the structured application that is
UseInitialStructurenumberSet to 1 if FrameMaker inserts the initial structure for new
XmlDocTypestringContains the DOCTYPE parameter from the source XML.
XmlEncodingstringSpecifies the encoding parameter of the XML Declaration
XmlFileEncodingstringSpecifies the encoding that is detected for the source
catalog; set to 0 otherwise.
associated with the book. If the book has no associated
structure application, GetString() returns an empty
string.
elements; set to 0 otherwise.
for the source XML. The string is empty if no encoding is
specified. If this property is set, the XML Declaration
contains the encoding parameter with this value on Save
As XML.
XML book. If no encoding is specified for the source XML,
XmlEncoding is an empty string. In that case, if this value
is set, it determines the encoding to use when saving as
XML. If XmlEncoding has a value, this string may be
empty.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
35
XmlPublicIdstringContains the DOCTYPE public identifier for the source
XmlStandAlonenumberIndicates an integer that specifies the XML standalone
XML document.
parameter for the XML document, that is the source of the
current document. The permissible values are:
• Constants.FV_XML_STANDALONE_YES (1)
• Constants.FV_XML_STANDALONE_NO (2)
• Constants.FV_XML_STANDALONE_NONE (3)
• Constants.FV_XML_STANDALONE_NODEC (4)
The standalone parameter is declared in the XML
Declaration. For a file with no XML declaration, the value
is Constants.FV_XML_STANDALONE_NODEC (4). For an
XML declaration with no standalone parameter, this value
is Constants.FV_XML_STANDALONE_NONE (3).
XmlStyleSheetstringSpecifies the XML stylesheet processing instruction to
write out to XML when saving the book as XML.
Note; The ESTK does not verify that you are using the
correct syntax in this string.
The string you set should not include the PI de limiters, <?
and ?>. For example, the string you supply for my.css may
be:
"type=\"text\\css\" href=\"my.css\""
Only use this string to set a specific stylesheet
specification. GetString() always returns null for this
parameter. To get the list of stylesheet specifications
associated with a book, use XmlStyleSheetList.
XmlStyleSheetListStringsContains a list of stylesheet processing instructions for
XmlSystemIdstringContains the DOCTYPE system identifier for the source
the current book. One book can have more than one
stylesheet specification associated with it.
Note: The ESTK does not verify that you are using the
correct syntax in these strings.
The strings should not include the PI delimiters, <? and
?>.
For example, the string you supply for my.css may be:
"type=\"text\\css\" href=\"my.css\""
Setting a list as the value to the XmlStyleSheetList
property completely overwrites the preceding list.
XML document.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
36
XmlUseBOMnumberIndicates whether a byte order mark was detected when
opening the source XML. The permissible values are:
• Constants.FV_XML_USEBOM_YES (1)
• Constants.FV_XML_USEBOM_NO (2)
• Constants.FV_XML_USEBOM_UTF8 (3)
• Constants.FV_XML_USEBOM_UTF16BE (4)
• Constants.FV_XML_USEBOM_UTF16LE (5)
• Constants.FV_XML_USEBOM_UTF32BE (6)
• Constants.FV_XML_USEBOM_UTF32LE (7)
When saving as XML, if this property is set to
Constants.FV_XML_USEBOM_YES (1), FrameMaker writes
a byte order mark in the resulting XML.
XmlVersionstringDepicts the XML Version that is specified in the XML
XmlWellFormednumberIndicates whether the source XML is qualified as well
Declaration when the file is opened. If no XML version is
specified, GetString() returns an empty string.
If this string contains an invalid XML declaration, a parsing
error occurs when the book is saved as XML.
formed. The permissible values are:
• Constants.FV_XML_WELLFORMED_YES (1)
• Constants.FV_XML_WELLFORMED_NO (2)
BookIsViewOnlynumberSet to 1 if the book is view-only; set to 0 otherwise.
ViewOnlyDeadCodesUIntsContains a list of F-codes that cannot be executed in the
ViewOnlyWinBordersnumberSet to 1 if the book has normal window borders; Set to 0
ViewOnlyWinPopupnumberSet to 1 if the book window pop-up menu is available; set
book.
if the book's border buttons are suppressed.
to 0 otherwise.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
37
PDFGenerateForReviewnumberThis property is used to generate a PDF for review
ShowElementDescriptiveNamesboolSet to True to show descriptive names for el ements; Set to
workflow that is getting review comments in PDF and
importing them back to FrameMaker document.
The property helps in importing back the comments
correctly. When this flag is turned ON, the behavior is
same as if the "Generate for review only" checkbox is ON
in the PDF setup dialog.
False, otherwise.
Note: The ShowElementDescriptiveNames
property is applicable only for structured
FrameMaker.
UseInitialStructureOfAutoInsertedElementsboolIf set to True, auto-insertion rules will be processed
recursively. For example: If an element is inserted
automatically, and auto-insertion rules exist for this
element, in the element definition, then those rules
would also be processed.
• Constants.FV_NUM_READ_FROM_FILE (0x00) - Use the
numbering properties from the document associated
with this book component.
• Constants.FV_NUM_CONTINUE (0x01) - Continue
numbering from the previous file.
• Constants.FV_NUM_RESTART (0x02) - Use the number
specified by the FnFirstNum property.
• Constants.FV_NUM_PER_PAGE (0x03) - Restart
numbering on each page.
GenerateIncludenumberSe t to 1 if the document appears in the scroll list of files to
ImportFmtIncludenumberSet to 1 if the book component is included in the list of
InsertLinksnumberSet to 1 if hypertext links are automatically inserted in
NamestringIndicates the path of the document that the component
be generated by the Generate/Update command for the
book; otherwise set to 0.
components to be updated with imported formats or
element definitions, when the user or a client executes
Import Formats or Import Element Def initions; otherwise
set to 0.
generated files; otherwise set to 0.
represents.
NextComponentInBookBookComponentSpecifies the next component in the book file.
NextSelectedComponentInBookBookComponentSpecifies the next selected component in the book
PageNumComputeMethodnumberThe component document's page numbering type. The
window.
possible values are:
• Constants.FV_NUM_READ_FROM_FILE (0x00) - Use the
numbering properties from the document associated
with this book component.
• Constants.FV_NUM_CONTINUE (0x01) - Continue the
numbering from the previous file.
• Constants.FV_NUM_RESTART (0x02) - Restart
numbering at the value specified by the
FirstPageNum property.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
PageNumStylenumberPage numbering style. The possible values are:
• Constants.FV_PAGE_NUM_NUMERIC (0x00) - Arabic
• Constants.FV_PAGE_NUM_ROMAN_UC (0x01) - Roman
uppercase
• Constants.FV_PAGE_NUM_ROMAN_LC (0x02) - Roman
lowercase
• Constants.FV_PAGE_NUM_ALPHA_UC (0x03) -
Alphabetic uppercase
• Constants.FV_PAGE_NUM_ALPHA_LC (0x04) -
Alphabetic lowercase
• Constants.FV_PAGE_NUM_KANJI (0x05) - Kanji
characters
• Constants.FV_PAGE_NUM_ZENKAKU (0x06) - Zenkaku
• Constants.FV_PAGE_NUM_ZENKAKU_UC (0x07) -
Zenkaku uppercase
• Constants.FV_PAGE_NUM_ZENKAKU_LC (0x08) -
Zenkaku lowercase
42
• Constants.FV_PAGE_NUM_KANJI_KAZU (0x09) - Kazu
• Constants.FV_PAGE_NUM_DAIJI (0x0a) - Daiji
PageS idenumberSpecifies the page side on which to start the component
document. The possible values are:
• Constants.FV_BK_START_FROM_FILE (0x01)
• Constants.FV_BK_START_NEXT_AVAILABLE (0x02)
• Constants.FV_BK_START_LEFT (0x03)
• Constants.FV_BK_START_RIGHT (0x04)
PgfNumComputeMethodnumberThe type of numbering for the component document's
paragraph. Possible values are:
• Constants.FV_NUM_READ_FROM_FILE (0x00) - Use the
numbering properties from the document associated
with this book component.
• Constants.FV_NUM_CONTINUE (0x01) - Continue the
numbering from the previous file.
• Constants.FV_NUM_RESTART (0x02) - Restart
numbering at 1.
PrevComponentInBookBookComponentDenotes the previous component in the book file.
PrintIncludenumberSet to 1 if the component document is included in the list
of book files to be printed; otherwise set to 0.
TblFnCustNumStringstringSpecifies the characters for custom table footnote
numbers.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
TblFnNumStylenumberTable footnote numbering style. The possible values are:
CapitalizationnumberThe capitalization type. The possible values are:
• Constants.FV_CAPITAL_CASE_NORM (0) - Normal
capitalization (mixed uppercase and lowercase)
• Constants.FV_CAPITAL_CASE_SMALL (1) - Small caps
• Constants.FV_CAPITAL_CASE_LOWER (2) - Lowercase
letters only
• Constants.FV_CAPITAL_CASE_UPPER (3) - Uppercase
letters only
ChangeBarnumberReturns 1 if Change Bars are on.
CharTagstringDenotes the character format's tag name.
ColorColorIndicates the spot color ((FO_Color ID).
CombinedFontFamilyCombinedFontDefnDenotes the combined font definition
FontAnglenumberRepresents the font angle (specifies an index into the
FontEncodingNamestringIndicates the encoding of the font.
FontFamilynumberSpecifies the font family (specifies an index into the array
FontPlatformNamestringName that uniquely identifies a font on a specific
FontPostScriptNamestringName given to a font when it is sent to a PostScript
(FO_CombinedFontDefn).
array of font angles provided by the session property
FontAngleNames).
of font families provided by the session property
FontFamilyNames).
platform. For combined fonts, the name is the Asian font
name.
printer. For combined fonts, the name is the Asian font
name.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
50
WesternFontPlatformNamestringName that uniquely identifies t he Roman component of a
WesternFontPostScriptNamestringName given to the Roman component of a combined
FontSizenumberDenotes the font size (2 point to 400 point).
FontVariationnumberIndicates the font variation (specifies an index into the
FontWeightnumberIndicates the font weight (specifies an index into the array
LanguagenumberDenotes the hyphenation and spell-checking language
combined font on a specific platform.
font when it is sent to a PostScript printer.
array of font variations provided by the session property
FontVariationNames).
of font weights provided by the session property
FontWeightNames).
to use. The possible languages are:
• Constants.FV_LANG_NOLANGUAGE (0x00)
• Constants.FV_LANG_ENGLISH (0x01)
• Constants.FV_LANG_BRITISH (0x02)
• Constants.FV_LANG_GERMAN (0x03)
• Constants.FV_LANG_SWISS_GERMAN (0x04)
• Constants.FV_LANG_FRENCH (0x05)
• Constants.FV_LANG_CANADIAN_FRENCH (0x06)
• Constants.FV_LANG_SPANISH (0x07)
• Constants.FV_LANG_CATALAN (0x08)
• Constants.FV_LANG_ITALIAN (0x09)
• Constants.FV_LANG_FINNISH (0x10)
• Constants.FV_LANG_SWEDISH (0x11)
• Constants.FV_LANG_JAPANESE (0x12)
• Constants.FV_LANG_TRADITIONAL_CHINESE (0x13)
• Constants.FV_LANG_SIMPLIFIED_CHINESE (0x14)
• Constants.FV_LANG_KOREAN (0x15)
• Constants.FV_LANG_PORTUGUESE (0x0A)
• Constants.FV_LANG_BRAZILIAN (0x0B)
• Constants.FV_LANG_DANISH (0x0C)
• Constants.FV_LANG_DUTCH (0x0D)
• Constants.FV_LANG_NORWEGIAN (0x0E)
• Constants.FV_LANG_NYNORSK (0x0F)
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
51
KernXnumberHorizontal kern value for manual kerning expressed as a
KernYnumberVertical kern value for manual kerning expressed as a
NamestringSpecifies the character format's name.
NextCharFmtInDocCharFmtDenotes the next character format in the document
OverlinenumberReturns 1 if Overline is enabled; returns 0 otherwise.
PairKernnumberReturns 1 if PairKern is enabled; returns 0 otherwise.
PositionnumberDenotes the vertical position of the character. Possible
percentage of an em (metric –1000% to 1000%). A
positive value moves a character right and a negative
value moves a character left.
percentage of an em (metric –1000% to 1000%). A
positive value moves characters up and a negative value
moves characters down.
(FO_CharFmt ID).
values are:
• Constants.FV_POS_NORM (0) - Normal
• Constants.FV_POS_SUPER (1) - Superscript
• Constants.FV_POS_SUB (2) - Subscript
StretchnumberDenotes the character stretch (set width) expressed as a
StrikethroughnumberReturns True if Strikethrough is enabled; otherwise
percentage of normal stretch for the font (metric –10% to
1000%).
returns False.
UnderliningnumberIndicates the character tracking expressed as a
UseCapitalizationnumberReturns 1 if the Capitalization property overrides the
UseChangeBarnumberReturns 1 if the ChangeBar property overrides the
UseColornumberReturns 1 if the Color property overrides the default
UseFontAnglenumberReturns 1 if the FontAngle property overrides the
UseFontFamilynumberReturns 1 if the FontFamily property overrides the
UseFontSizenumberReturns 1 if the FontSize property overrides the default
UseFontVariationnumberReturns 1 if the FontVariation property overrides the
UseFontWeightnumberReturns 1 if the FontWeight property overrides the
UseKernXnumberReturns 1 if the KernX property overrides the default
percentage of an em (metric –100% to 1000%).
default value; returns 0 if the "As Is" setting is used.
default value; returns 0 if the "As Is" setting is used.
value; returns 0 if the "As Is" setting is used.
default value; returns 0 if the "As Is" setting is used.
default value; returns 0 if the "As Is" setting is used.
value; returns 0 if the "As Is" setting is used.
default value; returns 0 if the "As Is" setting is used.
default value; returns 0 if the "As Is" setting is used.
value; returns 0 if the "As Is" setting is used.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
52
UseKernYnumberReturns 1 if the KernY property overrides the default
UseOverlinenumberReturns 1 if the Overline property overrides the default
UsePairKernnumberReturns 1 if the PairKern property overrides the default
UsePositionnumberReturns 1 if the Position property overrides the default
UseStretchnumberReturns 1 if the Stretch property overrides the default
UseStrikethroughnumberReturns 1 if the Strikethrough property overrides the
UseUnderliningnumberReturns 1 if the Underlining property overrides the
BkColorFMObjectDenotes the text background color. If this property is
UseBkColorboolThe UseBkColor is a Boolean flag which indicates
value; returns 0 if the "As Is" setting is used.
value; returns 0 if the "As Is" setting is used.
value; returns 0 if the "As Is" setting is used.
value; returns 0 if the "As Is" setting is used.
value; returns 0 if the "As Is" setting is used.
default value; returns 0 if the "As Is" setting is used.
default value; returns 0 if the "
applied on a paragraph format, it denotes the
background color of the whole paragraph; if it is applied
on a character format, it denotes the backgroun d color of
the text over which the character format is applied.
whether the
indicates the text has some background color. A value of
0 indicates a transparent background.
BkColor property is set or not. A value of 1
As Is" setting is used.
Note: When the UseBkColor property is set to 0,
BkColor value is not used.
the
CharFmt methods
Delete, GetProps, ObjectValid, SetProps.
CMSCheckinParam
Property nameData TypeDescription
versionintDenotes the version of the checked-in document. This
versionLabelstringSpecifies the label of the document version
Last updated 4/8/2014
property uses values from the CMSVersioningStrategy
enumeration:
CMSSameVersion: Same version
CMSMinorVersion: Minor version
CMSMajorVersion: Major version
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
descriptionstringSpecifies the description of the document version
53
checkinCommentstringSpecifies the check-in comments of the document
makeThisCurrentVersionboolDetermines whether the specified version is the current
version
version. Set to True to make this checked-in document
the current version; else set to False
CMSDeleteParam
Property nameData TypeDescription
deleteAllVersionboolDetermines whether to delete all versions of the current
deleteAllDependentsboolDetermines whether to delete all dependents of the
document. Set to True if user want to delete all the version
of a file.; else set to False.
current document. True if user wants to delete all the
dependents of a file; else set to False
CMSInfo
Property nameData TypeDescription
cmsNamestringSpecifies the name of the content management system.
userFieldsstringSpecifies the list of optional user fields. If no user fields is
userLoginUiboolDetermines if the default Connection manager dialog is
specified then its value is NULL.
used for login. False if default Connection manager dialog
is used for login; else set to True.
CMSMenuItem
Property nameData TypeDescription
idintSpecifies the ID of the menu item.
namestringSpecifies the name of the menu item.
flagsintSpecifies the type of menu. Uses the values from the
following enumeration:
FV_CMSMenu_Is_Item: Custom menu is single item
FV_CMSMenu_Is_Disabled: Custom menu is disabled
FV_CMSMenu_Is_Separator: Custom menu is separator
FV_CMSMenu_Is_SubMenu: Custom menu is of type
submenu
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
CMSProperty
Property nameData TypeDescription
propintSpecifies the CMS Property Id.
Use the value of enum F_CMSItemPropertyT (See
following enum) or custom property added by the user
(pending - peterb)
labelstringSpecifies the label of the property
54
isMultiValueboolDetermines if the property is multivalue. Set to True if the
isEditableboolDetermines if the property is editable. Set to True if the
valuesTypedValsSpecifies the values of the property
property is multivalue; else set to False.
property is editable; else set to False.
CMSProperties
An Array ofobjects with integer indexing and a length property.
Property nameData TypeDescription
lengthnumberThe length of the array
CMSRegistration
Property nameData TypeDescription
CapitalizationnumberThe capitalization type. The possible values are:
• Constants.FV_CAPITAL_CASE_NORM (0)
Last updated 4/8/2014
• Constants.FV_CAPITAL_CASE_SMALL (1)
• Constants.FV_CAPITAL_CASE_LOWER (2)
• Constants.FV_CAPITAL_CASE_UPPER (3)
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
CMSResult
Property nameData TypeDescription
statusStatusTSpecifies the Command status
opResultintSpecifies the Operation result.
If CMS Command needs CMSTree update, assign
F_CMSOpResultT values (See following enum),else can
return any value depending on operation.
For example:
opResult = True/False for FA_CMSIsValidCommand,
opResult = CMSPropertyNewMaxOpCode for
FA_CMSGetPropertyMaxOpCode. etc.
55
messagestringIf operation fails, user can send error message to
cmsItemsCMSResultList of CMS objects
FrameMaker.For FA_CMSObjectOpenReadOnly,
FA_CMSObjectEdit command, user can return file-name
which is downloaded
CMSSession
Property nameData TypeDescription
CapitalizationnumberThe capitalization type. The possible values are:
• Constants.FV_CAPITAL_CASE_NORM (0)
• Constants.FV_CAPITAL_CASE_SMALL (1)
• Constants.FV_CAPITAL_CASE_LOWER (2)
• Constants.FV_CAPITAL_CASE_UPPER (3)
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Color
Property nameData TypeDescription
BlacknumberRepresents the percentage of black (metric 0% to 100%).
ColorOverprintnumberOverprint setting for the color. Possible values are:
• Constants.FV_COLOR_KNOCKOUT (0x00)
• Constants.FV_COLOR_OVERPRINT (0x01)
56
ColorPrintCtlnumberIndicates the type of color printing used in the document.
Possible values are:
• Constants.FV_PRINT_SPOT (0x0)
• Constants.FV_PRINT_PROCESS (0x1)
• Constants.FV_PRINT_NO (0x2)
ColorTintPercentnumberSpecifies the percentage of the TintBaseColor to use
ColorViewCtlnumberA 12-bit number for spot color views. The least significant
for tinting.
Possible values are the tint percentage (0% to 100%) or
Constants.FV_COLOR_NOT_TINTED (0x7fffffff)
if the color is not a tint.
2 bits are View 1, the next 2 bits are View 2, and so on. The
values of each 2-bit setting are one of the following:
• Constants.FV_SEP_NORMAL (0x0)
• Constants.FV_SEP_NONE (0x1)
• Constants.FV_SEP_WHITE (0x2)
CyannumberIndicates the percentage of cyan (metric 0% to 100%).
FamilyNamestringColor library name. Note that you must specify the full ink
name, including any trademark symbols. For example,
use "MUNSELL\xa8 Book of Color’ for "MUNSELL® Book of
Color."
InkNamestringSpecifies the name of the color library pigment. Use this
MagentanumberRepresents the percentage of magenta (metric 0% to
NamestringDenotes the name of the color.
NextColorInDocColorIndicates the next color in the document (FO_Color ID).
name instead of Pantone.
100%).
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
ReservedColornumberColor names reserved by FrameMaker. The values are:
• Constants.FV_COLOR_NOT_RESERVED (0)
• Constants.FV_COLOR_CYAN (1)
• Constants.FV_COLOR_MAGENTA (2)
• Constants.FV_COLOR_YELLOW (3)
• Constants.FV_COLOR_BLACK (4)
• Constants.FV_COLOR_WHITE (5)
• Constants.FV_COLOR_RED (6)
• Constants.FV_COLOR_GREEN (7)
• Constants.FV_COLOR_BLUE (8)
57
TintBaseColorColorDenotes the color from which the tint is derived
Yel l ownumberPercentage of yellow (metric 0% to 100%).
(FO_Color ID), or Constants.FV_NO_BASE_COLOR (0x00)
if the color is not a tint.
Color methods
Delete, GetProps, ObjectValid, SetProps.
CombinedFont
Property nameData TypeDescription
combinedFontCombinedFontDefnID of the combined font.
variationuintIndex of the font variation.
weightuintIndex of the font weight.
angleuintIndex of the font angle.
CombinedFont methods
CombinedFont.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
CombinedFontDefn
Property nameData TypeDescription
58
NextCombinedFontDefnInDocCombinedFontDefnRepresents the next combined font definition instance in
NamestringIndicates the name of the combined font.
BaseFamilynumberAsian font family (specifies index into the arrays of font
WesternFamilynumberSpecifies the western font family (specifies index into the
ViewHotspotIndicatorsBoolTurns on hotspot indicators. Hotspot indicators are small
Weste rnSizenumberRepresents the scaling factor for Roman text expressed as
WesternShiftnumberIndicates the baseline o ffset of Roman text expressed as a
FontEncodingNamestringSpecifies the combined font's encoding, based on the
UserStringstringRepresents a s tring that your client can set as the value for
the document (FO_CombinedFontDefn ID).
families provided by the session property,
FontFamilyNames)
arrays of font families provided by the session property,
FontFamilyNames).
square boxes at the centre of an object to indicate that
the object is actually a hotspot.
a percentage of base font size (metric 1% to 1000%).
percentage of base font size (metric 1% to 1000%).
An Array of CombinedFont objects with integer indexing and a length property.
Property nameData TypeDescription
lengthnumberThe length of the array.
CombinedFonts methods
concat, pop, push.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Command
Property nameData TypeDescription
59
CanHaveCheckMarknumberReturns True if the menu item can have a check mark. If
CheckMarkIsOnnumberReturns 1 if the menu item can have a check mark and the
CommandNumnumberRepresents the integer that you specified for the cmd
EnabledWhennumberThe context in which the menu item is enabled.. If the
the menu item is defined by FrameMaker, you can read
this property, but not set it.
check mark is on. If the menu item is defined by
FrameMaker, you can read this property, but not set it.
parameter of DefineAndAddCommand() or
DefineCommand(). When the user executes the
command, FrameMaker passes this integer to your
client's
Command() function.
If the menu item is defined by FrameMaker, you can read
this property, but not set it.
menu item is defined by FrameMaker, you can read this
property, but not set it.
The following are the values that the EnabledWhen
property can have and the corresponding contexts in
which a menu item is active.
• Constants.FV_ENABLE_OBJ_PROPS (8) - The insertion
point is in text, a table, or a math object, or a graphic
object is selected.
• Constants.FV_ENABLE_IN_TABLE (9) - The insertion
point or selection is in any part of a table.
• Constants.FV_ENABLE_IN_TABLE_TITLE (10) - The
insertion point or selection is in the table title.
Last updated 4/8/2014
• Constants.FV_ENABLE_IN_CELL_TEXT (11) - The
insertion point or selection is in a table cell.
• Constants.FV_ENABLE_IS_CELL (12) - A single cell in a
table is selected.
• Constants.FV_ENABLE_IS_CELLS (13) - One or more
cells in a table are selected.
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
• Constants.FV_ENABLE_IS_TABLE(14) - An entire table is
selected.
• Constants.FV_ENABLE_IS_OBJ (15) - An object is
selected.
• Constants.FV_ENABLE_IS_TEXT_FRAME (16) - A text
frame is selected.
• Constants.FV_ENABLE_IS_OR_IN_FRAME (17) - The
selected object is a graphic frame or is in a graphic
frame that is not a page frame.
• Constants.FV_ENABLE_IS_AFRAME (18) - The first
selected object is an anchored frame.
• Constants.FV_ENABLE_IS_TEXT_INSET (19) - The first
selected object is a text inset.
• Constants.FV_ENABLE_IS_GRAPHIC_INSET (20) - The
first selected object is a graphic inset.
• Constants.FV_ENABLE_IN_FLOW (21) - A text frame is
selected, or the insertion point or selection is in a
paragraph.
60
• Constants.FV_ENABLE_COPY (22) - Some text or an
object is selected.
• Constants.FV_ENABLE_COPY_FONT (23) - The
insertion point or selection is in the text of a paragraph,
a math object, a table, or a text line.
• Constants.FV_ENABLE_CAN_PASTE(24) - The Clipboard
contains an object or text that can be pasted at the
insertion point.
• Constants.FV_ENABLE_IS_VIEW_ONLY (25) - The
current document is locked.
• Constants.FV_ENABLE_NEEDS_DOCP_ONLY (26) - A
document is open.
• Constants.FV_ENABLE_NEEDS_BOOKP_ONLY (27) - A
book is open.
• Constants.FV_ENABLE_NEEDS_DOCP_OR_BOOKP (28)
- A document or a book is open.
ExpandOMaticParentCommandDenotes the virtual parent object, if the menu item is an
FcodeuintSpecifies an f-code that FrameMaker executes when the
FcodesUIntsThe list of f-codes that the FrameMaker product executes
expandomatic menu item.
user chooses the menu item or presses the keyboard
shortcut.
when the user chooses the menu item or presses the
keyboard shortcut.
Normally, the first f-code in the list is the same as the fcode specified by the Fcode property.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
61
HasShiftOrUnshiftCommandnumberSpecifies whether a command has an accompanying shift
command or unshift command. The value is one of:
• Constants.FV_ITEM_HAS_SHIFT_COMMAND (1)
• Constants.FV_ITEM_HAS_UNSHIFT_COMMAND (2)
• Constants.FV_ITEM_HAS_NO_SHIFT_OR_UNSHIFT_CO
MMAND (3)
HelpLinkstringThe hypertext link to call when the user requests context-
sensitive help for the command.
If you set the HelpLink property, specify the destination
file and an optional page number or linkname. For
example, specify foo.doc:lastpage. Do not specify
hypertext commands such as gotopage.
FrameMaker automatically prefixes the appropriate
hypertext command to the HelpLink string when the user
requests context-sensitive help.
If the destination file is not in the client directory,
FrameMaker looks for the file in the FrameMaker product
help directory.
Note: The HelpLink property is valid only for
commands created by clients, and is not valid for
commands created directly by FrameMaker.
KeyboardShortcutLabelstringThe keyboard shortcut string that appears on the menu.
This string need not be one of the actual shortcuts
specified by the KeyboardShortcuts property.
KeyboardShortcutsStringsThe list of keyboard shortcuts that the user can press to
execute the command. To add a shortcut, append it to the
list.
Note: ESTK does not allow you to delete
shortcuts from the list.
LabelsStringsIf the command is a menu item, the Labels property
depicts the list of labels the menu item can have in
different contexts. If the menu item has only one label in
all contexts, Labels specifies only the string for that
specific label.
If the menu item has different labels in different contex ts,
Labels specifies pairs of strings with the following format:
Context,Label
where Label specifies the menu item label
and Context specifies the context in which the label
appears on the menu.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
MenuItemTypenumberThe type of command or menu item. The value is one of:
• Constants.FV_MENUITEM_FRAME (1) - the command is
a menu item defined by FrameMaker.
• Constants.FV_MENUITEM_API (2) - the command is a
menu item defined by a client.
• Constants.FV_MENUITEM_MACRO (3) - the menu item
is not a command; it calls a macro.
• Constants.FV_MENUITEM_EXPANDOMATIC (4) - the
menu item is an expandomatic menu item (such as
!ShowParagraphTags) defined by FrameMaker.
62
ModenumberThe mode in which keyboard shortcuts are recorded. The
value is one of:
• Constants.FV_MODE_MATH (1)
• Constants.FV_MODE_NONMATH (2)
• Constants.FV_MODE_ALL (3)
NextCommandInSessionCommandRepresents the next command in the list of commands in
ShiftOrUnshiftCommandCommandIf the HasShiftOrUnshiftCommand property is set to
LabelstringIndicates the dialog box title.
MenuItemIsEnablednumberReturns 1 if the menu or menu item is enabled. Returns 0
NamestringRepresents the name of the command, menu, or menu
NextMenuItemInMenuFMObjectIndicates the next menu item, menu, or separator in the
the session.
Constants.FV_ITEM_HAS_SHIFT_COMMAND (1), the
ShiftOrUnshiftCommand property, represents the
command to use when the user holds down the Shift key.
If the HasShiftOrUnshiftCommand property is set to
Constants.FV_ITEM_HAS_UNSHIFT_COMMAND (2), the
ShiftOrUnshiftCommand denotes the command to
use when the user is not holding down the Shift key.
if the menu or menu item is disabled (dimmed).
item separator.
menu.
NextMenuItemInSessionFMObjectSpecifies the next menu item, menu, or separator in the
PrevMenuItemInMenuFMObjectSpecifies the previous menu item, menu, or separator in
list of menu items, menus, and separators in the session.
the list of menu items, menus, and separators in the
session.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
ProductintSpecifies the Product to add the command.
Valu es:
Constants.FV_PRODUCT_UNSTRUCTURED
Constants.FV_PRODUCT_STRUCTURED
Constants.FV_PRODUCT_XMLAUTHOR
Constants.FV_PRODUCT_ALL (Equivalent to:
Constants.FV_PRODUCT_UNSTRUCTURED |
Constants.FV_PRODUCT_STRUCTURED |
Constants.FV_PRODUCT_XMLAUTHOR)
ViewintSpecifies the View to add the command.
Valu es:
Constants.FV_VIEW_WYSIWYG
Constants.FV_VIEW_AUTHOR
Constants.FV_VIEW_XML
Constants.FV_VIEW_ALL (Equivalent to:
Constants.FV_VIEW_WYSIWYG |
Constants.FV_VIEW_AUTHOR | Constants.FV_VIEW_XML)
63
WindowintSpecifies the Window to add the command.
Valu es:
Constants.FV_WINDOW_DOC
Constants.FV_WINDOW_BOOK
Constants.FV_WINDOW_DITAMAP
Constants.FV_WINDOW_ALL (Equivalent to:
Constants.FV_WINDOW_DOC |
Constants.FV_WINDOW_BOOK |
Constants.FV_WINDOW_DITAMAP)
Command methods
Delete, Delete, GetProps, ObjectValid, SetProps.
CompareRet
Property nameData TypeDescription
sumDocSpecifies the summary document.
compDocSpecifies the composite document.
CompareRet methods
CompareRet.
Last updated 4/8/2014
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
CondFmt
Property nameData TypeDescription
64
CondFmtIsShownnumberReturns True if the condition is shown. To hide text with a
NamestringDenotes the name of the condition format.
NextCondFmtInDocCondFmtDenotes the next condition format in the document
SepOverrideColorIndicates the color separation format override (FO_Color
StyleOverridenumberThe style condition indicators for conditional text. The
specified condition, set this property and the ShowAll
property of the Doc object to False.
(FO_CondFmt ID).
ID).
possible values are:
• Constants.FV_CN_NO_OVERRIDE (0)
• Constants.FV_CN_OVERLINE (1)
• Constants.FV_CN_STRIKETHROUGH (2)
• Constants.FV_CN_SINGLE_UNDERLINE (3)
• Constants.FV_CN_DOUBLE_UNDERLINE (4)
• Constants.FV_CN_CHANGEBAR (5)
• Constants.FV_CN_NUMERIC_UNDERLINE (6)
• Constants.FV_CN_NMRIC_AND_CHNGBAR (7)
UseSepOverridenumberReturns 1 if color specified by the SepOverride
property is used instead of the default color.
BkColorColorBkColor is the text background color property whose
UseBkColorboolThe UseBkColor is a Boolean flag which indicates
value is the color to be used.
If this property is applied on a paragraph format, the color
is applied as the background color of the whole
paragraph.
If this property is applied on a character format, the color
is applied as the background color of the text over which
the character format is applied.
whether the BkColor is set or not. UseBkColor=1
indicates the text has some background color.