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 be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this 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
incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure to 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,
PostScript, 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.
PANTONE® 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 data and/or software which are licensed to Adobe Systems Incorporated to distribute for use only in combination with Adobe
FrameMaker. PANTONE Color Data and/or Software shall not be copied onto another disk or into memory unless as part of the execution 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 9/26/2011
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-Interface Tools” in
Guide.
• 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” 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 Guide.
• 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
• 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.
JavaScript Tools Guide.
JavaScript Tools Guide.
JavaScript Tools
JavaScript
JavaScript Tools Guide.
JavaScript Tools Guide
2
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Overview
Creating Scripts
Adobe provides ExtendScript Toolkit (ESTK) with its applications as a scripting utility. ESTK has many features that
make it easier to use than a text editor. ESTK has a built-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 10 in the pop-up menu.
2 Click .
If FrameMaker 10 is not already running, a message appears: “Target Adobe FrameMaker 10 is not running. Do you
want to launch Adobe FrameMaker 10?”
3
3 Click Yes.
FrameMaker 10 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 9/26/2011
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 9/26/2011
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 get triggered on an event.
• 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 9/26/2011
Chapter 2: 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 10.
Note: Sample scripts shipped with FrameMaker are at the following location: <FMINSTALL_DIR>\samples
Adding text to a document and enabling change bar
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 10 as the target application. Click the Play button to run the
script.
var doc = app.ActiveDoc;
var tl = new TextLoc();
var firstPgf = doc.MainFlowInDoc.FirstTextFrameInFlow.FirstPgf;
tl.obj = firstPgf;
doc.AddText (tl, "Hello");
doc.AutoChangeBars =1;
6
The script creates a text location using the new TextLoc()method. Assign the first page of the document as the text
location. Using the
AddText() method, add a sample text. Set the 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
TblLeftIndent()method to change
the left indentation.
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.
7
Last updated 9/26/2011
Chapter 3: 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 10 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.
8
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 9/26/2011
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 9/26/2011
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
11
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Differences between scripts and FDK
desired even occurs.(Similar to F_ApiNotify())
Syntax for this callback function is:
@params
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 of the affected file. If the notification is for text entry, sparm specifies the text the
user typed.)
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.
*/
function Notify(note, object, sparam, iparam)
{
switch (note) {
case FA_Note_PostOpenDoc:
alert("Opened document " + sparam);
break;
}
12
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 9/26/2011
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:
alert("Command1 executed");
break;
case 2:
alert("Command2 executed");
break;
}
}
13
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.
14
Last updated 9/26/2011
Chapter 4: 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.
15
AFrameIsFloatingboolIndicates whether the anchored frame is set to be
AlignmentintIndicates 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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
AnchorTypeintIndicates 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)
16
• 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)
BaselineOffsetintBaseline Offset
ElementElementIf the anchored frame is in a structured flow in a
InTextFrameTextFrameIndicates the text frame in which the anchored frame is
InTextObjFMObjectIndicates the 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.
SideOffsetintDenotes the near side offset.
TextLocTextLocContains the location of the anchor symbol.
FirstGraphicInFrameFMObjectContains 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.
AngleintIndicates the angle of rotation of the graphic object.
ArrowBaseAngleintDenotes the arrowhead base angle in degrees.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
17
ArrowLengthintDenotes the arrowhead length (always rounded down to
ArrowScaleFactorintIndicates the factor by which the arrowhead is scaled as
ArrowScaleHeadintSet to True if arrowhead is scaled as the line width
ArrowTipAngleintDenotes the arrowhead tip angle in degrees.
ArrowTypeintDenotes 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
False.
is
changes. Set to
False, otherwise.
• Constants.FV_ARROW_STICK (0x1)
• Constants.FV_ARROW_HOLLOW (0x2)
• Constants.FV_ARROW_FILLED (0x3)
BorderWidthintIndicates 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.
FillintDenotes 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.
GraphicCantBeSelectedintSet to True if the graphic object cannot be selected. Set
GraphicIsSelectedintSet to True, if the graphic object is selected. Else, set to
GroupParentGroupSpecifies the group to which the object belongs.
HeadArrowintSet to True if the line has an arrow head. Set to False,
HeightintDenotes the height of the object denoted in points. The
False, otherwise.
to
False.
Note: Anchored frames do NOT have this property.
otherwise.
permissible range is from 0.125 points to 3600 points.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
18
LineCapintSpecifies the type of the end of the line. The possible
values are:
• Constants.FV_CAP_BUTT (0x00)
• Constants.FV_CAP_ROUND (0x01)
• Constants.FV_CAP_SQUARE (0x02)
LocXintSpecifies the distance of the object from the left side of
LocYintDistance 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.
NextGraphicInGroupFMObjectDenotes the next graphic object in the group.
NextSelectedGraphicInDocFMObjectDenotes the next selected graphic object in the
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.
document.
ObjectAttributesStringsA list of strings. Each string expresses an attribute that is
OverprintintSpecifies the overprint settings for the object. The
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)
PenintSpecifies 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)
PrevGraphicInFrameFMObjectDenotes the previous graphic object in the frame.
PrevGraphicInGroupFMObjectDenotes the previous graphic object in the group.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
19
RunaroundintSpecifies 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)
RunaroundGapintDenotes the width of the runaround gap, if the object is a
TailArrowintSet to True if the arrowhead is enabled at the begining of
TintPercentintSpecifies the tint percentage.
UniqueintIndicates the graphic object's internal unique number.
WidthintDenotes the width of the object. The permissible range is
FirstGraphicInFrameFMObjectContains the first object in the anchored frame.
LastGraphicInFrameFMObjectContains the last object in the anchored frame.
runaround object.
the line; Set to
from 0.125 points to 3600 points.
False otherwise.
AFrame methods
Delete, GetProps, SetProps, ObjectValid.
Arc
Property nameData TypeDescription
DThetaintDenotes the arc angle length in degrees. The permissible
ThetaintSpecifies the start angle in degrees. The permissible
AngleintSpecifies the angle of the object's rotation.
ArrowBaseAngleintIndicates the arrowhead base angle in degrees.
ArrowLengthintDenotes the arrowhead length (always rounded down to
ArrowScaleHeadintSet to True if the arrowhead is scaled as the line width
ArrowScaleFactorintSpecifies the factor by which arrowhead is scaled as line
ArrowTipAngleintSpecifies the arrowhead tip angle in degrees.
range is –360 degrees to +360 degrees.
range is 0 degrees to 360 degrees.
the nearest 1/256 point).
changes. Set to
width changes (always rounded down to nearest 1/16
point). It is not used if the ArrowScaleHead property is set
False.
to
False, otherwise.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
ArrowTypeintDenotes the Arrowhead style. Possible values are:
• Constants.FV_ARROW_STICK (0x01)
• Constants.FV_ARROW_HOLLOW (0x02)
• Constants.FV_ARROW_FILLED (0x03)
20
BorderWidthintSpecifies the border width in points. The permissible
ColorColorIndicates the spot color.
DashMetricsSpecifies a dash pattern that is repeated for the length of
FillintDenotes 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.
GraphicCantBeSelectedintSet to True if the graphic object cannot be selected. Else,
GraphicIsSelectedintSet to True if the graphic object is selected, else set to
set to
False.
False.
GroupParentGroupIndicates the group to which the object belongs.
HeadArrowintSet to True if line has an arrowhead, set to False
HeightintSpecifies the height of the object in points. The
LineCapintIndicates the type of line end. The possible values are:
Anchored and unanchored frames do not have this
property.
otherwise.
permissible range is from 0.125 pt to 3600 pt.
• Constants.FV_CAP_BUTT (0x00)
• Constants.FV_CAP_ROUND (0x01)
• Constants.FV_CAP_SQUARE (0x02)
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
21
LocXintSpecifies the distance of the object from the left side of
LocYintSpecifies 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 \\.
OverprintintSpecifies the overprint settings for the object. The
possible values are:
• Constants.FV_KNOCKOUT (0x00)
• Constants.FV_OVERPRINT (0x01)
• Constants.FV_FROMCOLOR (0x02)
PenintIndicates 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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
22
RunaroundintSpecifies 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)
RunaroundGapintDenotes the width of the runaround gap, if the object is a
TailArrowintSet to True if the arrowhead is enabled at the beginning
TintPercentintSpecifies the tint percentage.
UniqueintDenotes the internal identifier of the graphic object.
WidthintSpecifies the width of the object in points. The
runaround object.
of the line. Set to
permissible range is 0.125 point to 3600 point.
False, 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.
23
allowuintAllow error as special case to suppress reporting by
validation.
Attribute methods
Attribute.
AttributeDef
Property nameData TypeDescription
namestringName of the attribute
requiredintSet to True if the attribute is required. Else, set to False.
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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
attrTypeintDenotes 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.
24
• 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 9/26/2011
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.
25
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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
BodyPage
Property nameData TypeDescription
26
MasterPagestringDenotes the name of the master page background for the
PageBackgroundintIndicates 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
Constants.FV_BGD_DEFAULT (0x00) or
to either
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),
PageIsRecto property.
query its
PageFrameUnanchoredFrameDenotes the page frame for the page.
PageHeightintIndicates the height of the page.
PageIsRectointSet to True if the page is a Right page; Set to False if the
page is a Left page.
PageNextBodyPageDenotes the next body page in the document.
PageNumintContains the current page number.
PageNumStringstringContains the page number string.
PagePrevBodyPageDenotes the previous body page in the document.
BookDontUpdateReferencesintSet to False if FrameMaker is set to update cross-
references when it opens the book; Set to
otherwise.
BookIsModifiedintSet to True if the book has been modified; Set to False,
otherwise.
BookIsSelectedintSet to True if the book icon in the book window is
selected; Set to False otherwise.
FirstComponentInBookBookComponentDenotes the first component in the book.
FirstSelectedComponentInBookBookComponentDenotes the first selected component in the book.
IsIconifiedintSet to True if the book window is iconified; set to False
otherwise.
IsInFrontintSet to True if the book window is in front of other
windows in the FrameMaker product session; Set to False
otherwise.
IsOnScreenintSet to True if the document is visible on the screen; Set
to False otherwise.
Note: The IsOnScreen property is always True for books,
and setting it to False has no effect.
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
of open books.
True,
StatusLinestringString that appears in the book status bar. Querying this
ScreenHeightintDenotes the height of the book window in pixels.
ScreenWidthintDenotes the width of the book window in pixels.
ScreenXintSpecifies the offset of the book window in pixels from the
ScreenYintIndicates the offset of the book window in pixels from the
string returns the status string.
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.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
28
TypeOfDisplayTextintSpecifies the type of text snippet to display for each icon
in the book window. The two possible values are:
• Constants.FV_BK_FILENAME (1)- displays the book
component's filename
• Constants.FV_BK_TEXT (2) - displays the first
paragraph of the component's first flow.
AcrobatBookmarkDisplayTagsintSet to True if the
DocAcrobatColumnArticleThreadsintSet to True if you want separate article threads for each
IncludeParagraphTagsinBookmarkText property
True (the paragraph tag is added before the
is set to
paragraph text in each bookmark); Set to False otherwise.
column; set to False if you want separate article threads
for each text frame.
Note: The DocPDFNoArticleThread property
must be set to FALSE, when setting this option.
DocAcrobatDefaultsChangedintSet to True if the default heuristics for determining the
DocAcrobatElementListStringsContains a list of the element tags and context labels to
paragraph level are disabled; Set to False, otherwise.
include in bookmarks.
Note: The DocPDFElementList property applies
only to structured FrameMaker documents.
DocAcrobatElementsintSet to True if elements rather than paragraphs are used
for bookmarks; Set to False otherwise.
Note: The DocPDFElements property applies only
to structured FrameMaker documents.
DocAcrobatNoArticleThreadsintSet to True if you do not want article threads in the
GenerateAcrobatInfointSet to True if the GenerateAdobeAcrobatData property
resulting PDF; Set to False otherwise.
is set to True. Else, set to False.
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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
29
PDFBookmarksOpenLevelintDenotes 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.
PDFConvertCMYKtoRGBintWhen set to True, the PDFConvertCMYKtoRGB property
PDFDestsMarkedintSet to True if the document has paragraphs or elements
corresponds with the setting "
to RGB
" in the Save As PDF dialog box.
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
PDFDistillerAbsentintA value of 1 indicates that there is no Acrobat Distiller
PDFDocInfoStringsContains a list of strings expressing 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
PDFJobOptionsAbsentintA value of 1 indicates that PDF Job Options are not
PDFOpenPagestringDenotes the PDF page number, in the FrameMaker
PDFPageHeightintDenotes the page height for the generated PDF
PDFPageWidthintIndicates the page width for the generated PDF
available. Any other value indicates that Acrobat Distiller
is available.
PDF Document Info dictionary when you save the book as
PDF. Each dictionary entry 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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
30
PDFPrintPageRangeintSpecifies the page range for generating the PDF
PDFRegistrationMarksintContains 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)
PDFSeparateFilesintSet to True, if a separate PDF file should be generated for
PDFStartPagestringDenotes the first page of the printing page range, in the
PDFZoomFactorintWhen the PDFZoomType property is set to
PDFZoomTypeintDenotes the PDF zoom setting at which Acrobat opens
each document in a book; Set to False 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.
PDFAllNamedDestinationsintSet to True if the generated PDF document should
PrintBlankPagesintSet to True if the PageRounding property is set to allow
PrintCollatedintSet to True if Collate is enabled; Set to False otherwise.
include Named Destinations for every paragraph and
FrameMaker structure element in the book. This results in
a larger PDF filesize.
If set to False, 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 False
otherwise.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
31
PrintEmulsionintDenotes the direction of the print emulsion. The possible
value are:
• Constants.FV_EMUL_UP (0) - Emulsion side up
• Constants.FV_EMUL_DOWN (1) - Emulsion side down
PrinterNamestringThis property has no effect.
PrintEvenPagesintSet to True if Print Even-Numbered Pages is enabled.
PrintFileNamestringSpecifies the filename to print to. You can set the
PrintImagingintDenotes the type of print imaging. The permissible values
filename to be the default filename by specifying the
PrintFileName value as null.
are:
• Constants.FV_IMG_POSITIVE (0)
• Constants.FV_IMG_NEGATIVE (1)
PrintLastSheetFirstintSet to True to print the last sheet first. Else, set to False.
PrintLowResintSet to True to print in low resolution. Else, set to False.
PrintNumCopiesintDenotes the number of copies to print.
PrintOddPagesintSet to True if Print Odd-Numbered Pages is enabled.
PrintPaperHeightintSpecifies the height of the printing paper.
PrintPaperWidthintIndicates the width of the printing paper.
PrintRegistrationMarksintSet to True if Registration Marks is enabled; Set to False
PrintScaleintDenotes the Print scale factor expressed as a percentage
PrintSepsintSet to True if Print Separations is enabled.
PrintToFileintSet to True if Print Only to File is enabled.
SkipBlankSepsintSet to True if Skip Blank Separations (do not print blank
CustomElementListStringsContains the list of tags to display when
ElementCatalogElementCatalogEnt
ries
otherwise.
metric (0% to 100%).
For print scale percentages, the value 1<<16 or 0x10000
specifies 100%.
color separations) is enabled.
ElementCatalogDisplay is set to
Constants.FV_ELCAT_CUSTOM (0x04).
Contains a list of elements in the Element Catalog.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
ElementCatalogDisplayintCatalog display options. Show tags for:
• 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.
32
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
NewElemAttrDisplayintSpecifies 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.
NewElemAttrEditingintSpecifies 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)
SeparateInclusionsintSet to True if inclusions are listed separately in the
StructuredApplicationstringContains the name of the structured application that is
UseInitialStructureintSet to True if FrameMaker inserts the initial structure for
element catalog; set to False otherwise.
associated with the book. If the book has no associated
structure application,
string.
new elements; set to False otherwise.
GetString() returns an empty
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
XmlDocTypestringContains the DOCTYPE parameter from the source XML.
33
XmlEncodingstringSpecifies the encoding parameter of the XML Declaration
XmlFileEncodingstringSpecifies the encoding that is detected for the source
XmlPublicIdstringContains the DOCTYPE public identifier for the source
XmlStandAloneintIndicates an integer that specifies the XML standalone
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.
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 delimiters, <?
?>. For example, the string you supply for my.css may
and
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.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
34
XmlStyleSheetListStringsContains a list of stylesheet processing instructions for
XmlSystemIdstringContains the DOCTYPE system identifier for the source
XmlUseBOMintIndicates whether a byte order mark was detected when
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.
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
XmlWellFormedintIndicates whether the source XML is qualified as well
Declaration when the file is opened. If no XML version is
specified,
If this string contains an invalid XML declaration, a
parsing error occurs when the book is saved as XML.
formed. The permissible values are:
GetString() returns an empty string.
• Constants.FV_XML_WELLFORMED_YES (1)
• Constants.FV_XML_WELLFORMED_NO (2)
BookIsViewOnlyintSet to True if the book is view-only; set to False otherwise.
ViewOnlyDeadCodesUIntsContains a list of F-codes that cannot be executed in the
ViewOnlyWinBordersintSet to True if the book has normal window borders; Set to
ViewOnlyWinPopupintSet to True if the book window pop-up menu is available;
book.
False if the book's border buttons are suppressed.
set to False otherwise.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
35
PDFGenerateForReviewintThis property is used to generate a PDF for review
ShowElementDescriptiveNamesboolSet to True to show descriptive names for elements; 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.
GenerateIncludeintSet to True if the document appears in the scroll list of
ImportFmtIncludeintSet to True if the book component is included in the list of
InsertLinksintSet to True if hypertext links are automatically inserted in
NamestringIndicates the path of the document that the component
files to be generated by the Generate/Update command
for the book; otherwise set to False.
components to be updated with imported formats or
element definitions, when the user or a client executes
Import Formats or Import Element Definitions; otherwise
set to False.
generated files; otherwise set to False.
represents.
NextComponentInBookBookComponentSpecifies the next component in the book file.
NextSelectedComponentInBookBookComponentSpecifies the next selected component in the book
PageNumComputeMethodintThe 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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
PageNumStyleintPage 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
40
• Constants.FV_PAGE_NUM_KANJI_KAZU (0x09) - Kazu
• Constants.FV_PAGE_NUM_DAIJI (0x0a) - Daiji
PageSideintSpecifies 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)
PgfNumComputeMethodintThe 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.
PrintIncludeintSet to True if the component document is included in the
list of book files to be printed; otherwise set to False.
TblFnCustNumStringstringSpecifies the characters for custom table footnote
numbers.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
TblFnNumStyleintTable footnote numbering style. The possible values are:
CapitalizationintThe 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
ChangeBarintReturns True if Change Bars are on.
CharTagstringDenotes the character format's tag name.
ColorColorIndicates the spot color ((FO_Color ID).
CombinedFontFamilyCombinedFontDefnDenotes the combined font definition
FontAngleintRepresents the font angle (specifies an index into the
FontEncodingNamestringIndicates the encoding of the font.
FontFamilyintSpecifies the font family (specifies an index into the array
FontPlatformNamestringName that uniquely identifies a font on a specific
(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.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
48
FontPostScriptNamestringName given to a font when it is sent to a PostScript
WesternFontPlatformNamestringName that uniquely identifies the Roman component of
WesternFontPostScriptNamestringName given to the Roman component of a combined
FontSizeintDenotes the font size (2 point to 400 point).
FontVariationintIndicates the font variation (specifies an index into the
FontWeightintIndicates the font weight (specifies an index into the array
LanguageintDenotes the hyphenation and spell-checking language
printer. For combined fonts, the name is the Asian font
name.
a 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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
49
KernXintHorizontal kern value for manual kerning expressed as a
KernYintVertical kern value for manual kerning expressed as a
NamestringSpecifies the character format's name.
NextCharFmtInDocCharFmtDenotes the next character format in the document
OverlineintReturns True if Overline is enabled; returns False
PairKernintReturns True if PairKern is enabled; returns False
PositionintDenotes 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).
otherwise.
otherwise.
values are:
• Constants.FV_POS_NORM (0) - Normal
• Constants.FV_POS_SUPER (1) - Superscript
• Constants.FV_POS_SUB (2) - Subscript
StretchintDenotes the character stretch (set width) expressed as a
percentage of normal stretch for the font (metric –10% to
1000%).
StrikethroughintReturns True if Strikethrough is enabled; otherwise
UnderliningintIndicates the character tracking expressed as a
UseCapitalizationintReturns True if the Capitalization property overrides
UseChangeBarintReturns True if the ChangeBar property overrides the
UseColorintReturns True if the Color property overrides the default
UseFontAngleintReturns True if the FontAngle property overrides the
UseFontFamilyintReturns True if the FontFamily property overrides the
UseFontSizeintReturns True if the FontSize property overrides the
UseFontVariationintReturns True if the FontVariation property overrides
UseFontWeightintReturns True if the FontWeight property overrides the
returns False.
percentage of an em (metric –100% to 1000%).
the default value; returns False if the "
used.
default value; returns False if the "
value; returns False if the "
default value; returns False if the "
default value; returns False if the "
default value; returns False if the "
the default value; returns False if the "
used.
default value; returns False if the "
As Is" setting is used.
As Is" setting is
As Is" setting is used.
As Is" setting is used.
As Is" setting is used.
As Is" setting is used.
As Is" setting is
As Is" setting is used.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
50
UseKernXintReturns True if the KernX property overrides the default
UseKernYintReturns True if the KernY property overrides the default
UseOverlineintReturns True if the Overline property overrides the
UsePairKernintReturns True if the PairKern property overrides the
UsePositionintReturns True if the Position property overrides the
UseStretchintReturns True if the Stretch property overrides the
UseStrikethroughintReturns True if the Strikethrough property overrides
UseUnderliningintReturns True 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 False if the "
value; returns False if the "
default value; returns False if the "
default value; returns False if the "
default value; returns False if the "
default value; returns False if the "
the default value; returns False if the "
used.
default value; returns False 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 background 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.
As Is" setting is used.
As Is" setting is used.
As Is" setting is used.
As Is" setting is used.
As Is" setting is used.
As Is" setting is
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.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Color
Property nameData TypeDescription
BlackintRepresents the percentage of black (metric 0% to 100%).
ColorOverprintintOverprint setting for the color. Possible values are:
• Constants.FV_COLOR_KNOCKOUT (0x00)
• Constants.FV_COLOR_OVERPRINT (0x01)
51
ColorPrintCtlintIndicates 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)
ColorTintPercentintSpecifies the percentage of the TintBaseColor to use
ColorViewCtlintA 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)
CyanintIndicates 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
MagentaintRepresents 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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
ReservedColorintColor 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)
52
TintBaseColorColorDenotes the color from which the tint is derived
YellowintPercentage 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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
CombinedFontDefn
Property nameData TypeDescription
53
NextCombinedFontDefnInDocCombinedFontDefnRepresents the next combined font definition instance in
NamestringIndicates the name of the combined font.
BaseFamilyintAsian font family (specifies index into the arrays of font
WesternFamilyintSpecifies the western font family (specifies index into the
WesternSizeintRepresents the scaling factor for Roman text expressed as
WesternShiftintIndicates the baseline offset of Roman text expressed as a
FontEncodingNamestringSpecifies the combined font's encoding, based on the
UserStringstringRepresents a string 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).
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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Command
Property nameData TypeDescription
54
CanHaveCheckMarkintReturns True if the menu item can have a check mark. If
CheckMarkIsOnintReturns True if the menu item can have a check mark and
CommandNumintRepresents the integer that you specified for the cmd
EnabledWhenintThe 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.
the check mark is on. If the menu item is defined by
FrameMaker, you can read this property, but not set it.
parameter of
DefineCommand(). When the user executes the
command, FrameMaker passes this integer to your
client's
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.
DefineAndAddCommand() or
Command() function.
• 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 9/26/2011
• 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.
55
• 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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
56
HasShiftOrUnshiftCommandintSpecifies 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
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.
gotopage.
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 contexts,
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 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
MenuItemTypeintThe 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.
57
ModeintThe 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.
MenuItemIsEnabledintReturns True if the menu or menu item is enabled.
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.
Returns False 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.
Command methods
Delete, Delete, GetProps, ObjectValid, SetProps.
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
CompareRet
Property nameData TypeDescription
sumDocSpecifies the summary document.
compDocSpecifies the composite document.
CompareRet methods
CompareRet.
CondFmt
Property nameData TypeDescription
58
CondFmtIsShownintReturns True if the condition is shown. To hide text with a
specified condition, set this property and the
property of the Doc object to False.
NamestringDenotes the name of the condition format.
NextCondFmtInDocCondFmtDenotes the next condition format in the document
(FO_CondFmt ID).
SepOverrideColorIndicates the color separation format override (FO_Color
ID).
StyleOverrideintThe style condition indicators for conditional text. The
possible values are:
ShowAll
• 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)
Last updated 9/26/2011
ADOBE FRAMEMAKER SCRIPTING GUIDE
Object Reference
Property nameData TypeDescription
59
UseSepOverrideintReturns True if color specified by the SepOverride
BkColorColorBkColor is the text background color property whose
UseBkColorboolThe UseBkColor is a Boolean flag which indicates
property is used instead of the default color.
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
indicates the text has some background color.