Page 2
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.
Page 3
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.
Chapter 1: Overview 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.
The Socket object supports low-level TCP connections. For details, see Chapter 6, “External Communication Tools” in JavaScript Tools Guide. • 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 JavaScript Tools Guide.
In the ExtendScript Toolkit, select Adobe FrameMaker 10 in the pop-up menu. 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?” Click Yes.
ADOBE FRAMEMAKER SCRIPTING GUIDE Overview Using script library In FrameMaker, select File > Script > Catalog to display the script library. Using the script catalog, you can manage your existing scripts: • Favorites: Scripts you tag as your favorite appear here.
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.
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.
Page 15
ADOBE FRAMEMAKER SCRIPTING GUIDE Sample ESTK scripts The script creates the document’s main flow using the method. Use the MainFlowInDoc GetText(FTI_TblAnchor) method to list all tables in the main flow. Using a for loop, for each table, use the method to change TblLeftIndent() the left indentation.
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.
Page 17
ADOBE FRAMEMAKER SCRIPTING GUIDE Differences between scripts and FDK property is readily available to all FrameMaker scripts and maps to the object in FDK. FO_Session In this example, you query the property that returns the in the current ActiveDoc Active Document Object(Doc) FrameMaker Session.
Page 18
ADOBE FRAMEMAKER SCRIPTING GUIDE Differences between scripts and FDK The same code can be written in scripts as follows: doc.Capitalization = FV_CAPITAL_CASE_SMALL; However, there is a separate class called that can be used to access these Global Methods. The script code...
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.
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.
Page 21
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") ;...
Page 22
ADOBE FRAMEMAKER SCRIPTING GUIDE Differences between scripts and FDK The commands: nMenu1.DefineAndAddCommand(1,"cmd1","command1",""); nMenu2.DefineAndAddCommand(2,"cmd2","command2",""); add two new menu entries called Command 1 and Command 2 under the menu entries Menu1 and Menu2, that were defined in step 2. Finally, the block of code: function Command(cmd) { case 1: alert("Command 1 executed");...
Chapter 4: Object Reference AFrame Property name Data Type Description AFrameIsCropped Indicates whether the anchored frame is cropped or not. bool Possible values are: 0 - (Default) Indicates the frame is not cropped. 1 - Indicates the frame is cropped. AFrameIsFloating Indicates whether the anchored frame is set to be bool...
Page 24
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description AnchorType Indicates 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) •...
Page 25
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ArrowLength Denotes the arrowhead length (always rounded down to the nearest 1/256 point). ArrowScaleFactor Indicates the factor by which the arrowhead is scaled as line width changes (always rounded down to nearest 1/16 point).
Page 26
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description LineCap Specifies 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) LocX Specifies the distance of the object from the left side of the parent frame (in inches).
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Runaround Specifies 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: •...
Page 28
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ArrowType Denotes the Arrowhead style. Possible values are: • Constants.FV_ARROW_STICK (0x01) • Constants.FV_ARROW_HOLLOW (0x02) • Constants.FV_ARROW_FILLED (0x03) BorderWidth Specifies the border width in points. The permissible range is 0.015 point to 360 point.
Page 29
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description LocX Specifies the distance of the object from the left side of 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.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Runaround Specifies 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: •...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description values Strings The attribute value. valflags The validation error flags. This property is read only. uint allow uint Allow error as special case to suppress reporting by validation. Attribute methods Attribute.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description attrType Denotes 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.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference AttributeEx Property name Data Type Description name string The name of the attribute. values The attribute value. Strings valflags uint The validation error flags. This property is read only. allow Allow error as special case to suppress reporting by uint validation.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference BodyPage Property name Data Type Description MasterPage string Denotes the name of the master page background for the body page if the PageBackground property is set to Constants.FV_BGD_OTHER (0x02) The value is null if the...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Book Property name Data Type Description BookDontUpdateReferences Set to False if FrameMaker is set to update cross- references when it opens the book; Set to True otherwise. BookIsModified Set to if the book has been modified; Set to False, True otherwise.
Page 36
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description TypeOfDisplayText Specifies 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 •...
Page 37
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PDFBookmarksOpenLevel Denotes 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: •...
Page 38
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PDFPrintPageRange Specifies the page range for generating the PDF document. If set, the PDF file contains only the specified pages. Else, FrameMaker generates PDF for the entire document or book.
Page 39
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PrintEmulsion Denotes 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 PrinterName string This property has no effect.
Page 40
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ElementCatalogDisplay Catalog 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. •...
Page 41
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description XmlDocType string Contains the DOCTYPE parameter from the source XML. XmlEncoding Specifies the encoding parameter of the XML Declaration string for the source XML. The string is empty if no encoding is specified.
Page 42
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description XmlStyleSheetList Strings Contains a list of stylesheet processing instructions for 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.
Page 43
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PDFGenerateForReview This property is used to generate a PDF for review workflow that is getting review comments in PDF and importing them back to FrameMaker document. The property helps in importing back the comments correctly.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference BookComponent Property name Data Type Description BookComponentIsGeneratable Set to True if the book component is a generated file (BookComponentType is not set to Constants.FV_BK_NOT_GENERATABLE (16)); set to False, otherwise. BookComponentType Depicts the type of the book component. The possible values are: •...
Page 45
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ChapNumComputeMethod The component document's chapter numbering type. The 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 numbering from the previous chapter.
Page 46
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ComponentDisplayText string Specifies the text that displays in the book window when the value of the TypeOfDisplayText property is set to Constants.FV_BK_TEXT (2) Set the ComponentDisplayText property to an empty string ( ""...
Page 47
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description FnNumComputeMethod The component document's footnote numbering type. The 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 numbering from the previous file.
Page 48
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PageNumStyle Page 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 •...
Page 49
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description TblFnNumStyle Table footnote numbering style. The possible values are: • Constants.FV_FN_NUM_NUMERIC (0x00) - Arabic • Constants.FV_FN_NUM_ROMAN_UC (0x01) - Roman uppercase • Constants.FV_FN_NUM_ROMAN_LC (0x02) - Roman lowercase • Constants.FV_FN_NUM_ALPHA_UC (0x03) - Alphabetic uppercase •...
Page 50
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description VolumeNumStyle The volume numbering style. The possible values are: • Constants.FV_NUMSTYLE_NUMERIC (0x00) - Arabic • Constants.FV_NUMSTYLE_ROMAN_UC (0x01) - Roman uppercase • Constants.FV_NUMSTYLE_ROMAN_LC (0x02) - Roman lowercase • Constants.FV_NUMSTYLE_ALPHA_UC (0x03) - Alphabetic uppercase •...
Page 51
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ComponentType Indicates whether the component is a folder, group, or a document. The value is one of: • Constants.FV_BK_FOLDER (0x02) - Folder • Constants.FV_BK_GROUP (0x40) - Group • Constants.FV_BK_FM (0x8) - FrameMaker document •...
Page 52
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description SubsecNumComputeMethod Indicates the type of numbering applied to a particular book component. The value is one of: • Constants.FV_NUM_CONTINUE (0x01) • Constants.FV_NUM_RESTART (0x02) • Constants.FV_NUM_SAME (0x03) SubsectionNumStyle Denotes the subsection numbering style. Possible values are: •...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description BookComponentIsFolderWithTemplate Determines whether a template is associated with a book. Returns True if the BookComponent is a folder and a template is associated with the component. Returns False, otherwise.
Page 54
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description CellOverrideFill Indicates the cell's fill pattern. The value is null if there is no override fill pattern. CellOverrideLeftRuling Indicates the cell's left ruling (FO_RulingFmt ID), if there is RulingFmt an override.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description NextCellInTbl Cell Represents the next cell from left to right (FO_Cell ID). If the cell is at the end of a row, the next cell is the first cell in the next row.
Page 56
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description FontPostScriptName string Name given to a font when it is sent to a PostScript printer. For combined fonts, the name is the Asian font name. WesternFontPlatformName Name that uniquely identifies the Roman component of string a combined font on a specific platform.
Page 57
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description KernX Horizontal kern value for manual kerning expressed as a percentage of an em (metric –1000% to 1000%). A positive value moves a character right and a negative value moves a character left.
Page 58
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description UseKernX Returns True if the KernX property overrides the default value; returns False if the " As Is " setting is used. UseKernY Returns True if the property overrides the default KernY value;...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Color Property name Data Type Description Black Represents the percentage of black (metric 0% to 100%). ColorOverprint Overprint setting for the color. Possible values are: • Constants.FV_COLOR_KNOCKOUT (0x00) • Constants.FV_COLOR_OVERPRINT (0x01) ColorPrintCtl Indicates the type of color printing used in the document.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference CombinedFontDefn Property name Data Type Description NextCombinedFontDefnInDoc CombinedFontDefn Represents the next combined font definition instance in the document (FO_CombinedFontDefn ID). Name Indicates the name of the combined font. string BaseFamily Asian font family (specifies index into the arrays of font...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Command Property name Data Type Description CanHaveCheckMark Returns True if the menu item can have a check mark. If the menu item is defined by FrameMaker, you can read this property, but not set it.
Page 63
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description • 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.
Page 64
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description HasShiftOrUnshiftCommand Specifies 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) HelpLink...
Page 65
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description MenuItemType The 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.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference CompareRet Property name Data Type Description Specifies the summary document. comp Specifies the composite document. CompareRet methods CompareRet. CondFmt Property name Data Type Description CondFmtIsShown Returns True if the condition is shown. To hide text with a...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description UseSepOverride Returns True if color specified by the SepOverride property is used instead of the default color. BkColor is the text background color property whose Color BkColor value is the color to be used.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Constants.FV_ListViewDeleteAllRows Value 4 Constants.FV_ListViewReSortAllRows Value 5 Constants.FV_ListViewActionMax Value 6 Constants.FV_ListViewInitNumParams Value 0 Constants.FV_ListViewAddColumnNumParams Value 4 Constants.FV_ListViewAddColumnParam1 Value 3 Constants.FV_ListViewAddColumnParam2 Value 1 Constants.FV_ListViewAddColumnParam3 Value 1 Constants.FV_ListViewAddColumnParam4 Value 1 Constants.FV_ListViewAddRowNumParams Value 1 Constants.FV_ListViewAddRowParam1...
Page 230
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description FirstCombinedFontDefnInDoc CombinedFontDefn Specifies the first combined font definition in the list of the document's combined font definitions. FirstCondFmtInDoc Indicates the first condition tag in the list of the CondFmt document's condition tags.
Page 231
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description FirstXRefInDoc XRef Specifies the first cross-reference [FO_XRef ID] in the list of the document's cross-references. HiddenPage Denotes a hidden page [FO_HiddenPage ID] in the HiddenPage document. LastBodyPageInDoc BodyPage Indicates the last body page [FO_BodyPage ID] in the document.
Page 232
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description GenerateAcrobatInfo Set to True if Generate Adobe Acrobat Data is on. To generate PDF data, you must set the other document print properties as follows: • PrintToFile - True •...
Page 233
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PDFDistillerAbsent A value of 1 indicates that Acrobat Distiller is not available. Any other value indicates that Acrobat Distiller is available. PDFDocInfo Contains a list of strings expressing values to be set in the...
Page 234
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PDFZoomType Indicates the PDF zoom setting with which Acrobat opens the generated PDF document. The value can be one of: • Constants.FV_PDFZoomDefault (1) • Constants.FV_PDFZoomPage (2) • Constants.FV_PDFZoomWidth (3) •...
Page 235
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ChapterNumStyle The numbering style. The possible value is one of: • Constants.FV_NUMSTYLE_NUMERIC (0x00): Arabic. • Constants.FV_NUMSTYLE_ROMAN_UC (0x01): Roman, uppercase. • Constants.FV_NUMSTYLE_ROMAN_LC (0x02): Roman,lowercase. • Constants.FV_NUMSTYLE_ALPHA_UC (0x03): Alphabetic, uppercase. •...
Page 236
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description DocSaveType Denotes the type of document saved. The possible values are: • Constants.FV_DOC_TYPE_BINARY (0x01): Frame binary document • Constants.FV_DOC_TYPE_TEXT (0x02): ASCII text document • Constants.FV_DOC_TYPE_MIF (0x03): MIF document •...
Page 237
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description StatusLine string Indicates the string that appears in the document status bar. Note: This property always returns an empty string when queried; it is effectively write-only. If you set the StatusLine property to a string other than an empty string (""), the string will remain in the status bar...
Page 238
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description VolumeNumStyle Denotes the volume numbering style. The value is one of: • Constants.FV_NUMSTYLE_NUMERIC (0x00): Arabic • Constants.FV_NUMSTYLE_ROMAN_UC (0x01): Roman numerals, uppercase. • Constants.FV_NUMSTYLE_ROMAN_LC (0x02): Roman numerals,lowercase. • Constants.FV_NUMSTYLE_ALPHA_UC (0x03): Alphabetic, uppercase.
Page 239
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description EqnIntegralSizeLarge Indicates the point size of integral symbol in large equations (2 pt to 400 pt). EqnIntegralSizeMed Indicates the point size of integral symbol in medium equations (2 pt to 400 pt).
Page 240
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description HypertextCommandText string Denotes the hypertext command to parse. Setting this value executes the parser. If the HypertextDoValidate property is True, the command is parsed and validated. HypertextParseErr Contains a non-zero value if there is a parser error.
Page 241
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description HypertextValidateErr Set to a non-zero value if the HypertextDoValidate property is set to True and there is a validation error. property is set to one of HypertextValidateErr the following values if there is a validation error: •...
Page 242
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description HypertextParseBadParam Denotes the index into the string list contained in the HypertextParsedArgs property, in case of a parser error. HypertextParseErrMsg Denotes the message that FrameMaker generates for a string parser error.
Page 243
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description HypertextParsedCmdCode Denotes the FrameMaker hypertext command in the HypertextCommandText property, as determined by the parser. The possible value for the HypertextParsedCmdCode property is one of: • Constants.FV_CmdError (1) -Parser is in an error state •...
Page 244
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description HypertextParsedCmdDest Denotes the destination type for link commands in the HypertextCommandText property, as determined by the parser. The possible value for the HypertextParsedCmdDes property is one of: • Constants.FV_DestNowhere (0) - No destination found •...
Page 245
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description HypertextParsedLinkName string Indicates either the value of a newlink command, or a keyword such as FirstPage or LastPage, for links to new targets. HypertextParsedPageName Denotes the pagenumber, for links to pages.
Page 246
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description FnNumComputeMethod The document's footnote numbering type. The value is one of: • 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 associated...
Page 247
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description DocIsDoubleSided Set to True if the layout of the document is a 2 sided page; False otherwise. FirstPageNum Indicates the page number of the first page. FirstPageVerso Set to False for right first page; True for left first page.
Page 248
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PageWidth Specifies the width of the document's pages. Note: Setting this property, automatically sets the page width for all the body pages of the document. PointPageNumStyle Denotes the point page numbering style. The value is one •...
Page 249
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PrintEndPage Specifies the number of the last page to print. Note: The value of the DocFluidFlow property must be 0, when you use the PrintEndPage property. You cannot print a range of pages when a document is in fluid view.
Page 250
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PrintScale Denotes the Print scale factor expressed as a percentage metric (0% to 100%).For print scale percentages, the value <<16 or 0x10000 specifies 100%. PrintScope Denotes the pages to print. The value is one of: •...
Page 251
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description NarrowRubiSpaceForOther Denotes the value for a composite ruby object. The value is one of: • Constants.FV_Wide (0) • Constants.FV_Narrow (1) • Constants.FV_Proportional (2) RubiOverhang Set to True if Rubi is allowed to overhang, else set to False.
Page 252
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ElementCatalogDisplay Indicates the catalog display options. The value is one of: • 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 •...
Page 253
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description MinFontSize Denotes the minimum font size allowed in the document. MinLeading Denotes the minimum leading allowed in the document. MinLeftIndent Denotes the minimum left indent allowed in the document.
Page 254
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description XmlEncoding string Contains the encoding parameter of the XML Declaration for the source XML document. The string is empty if no encoding is specified. If the property is set, the XML Declaration...
Page 255
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description XmlStyleSheetList Strings Contains a list of stylesheet processing instructions for the current document.A document can have more than one stylesheet specification associated with it. The ESTK does not verify that you use the correct syntax in these strings.
Page 256
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description TblFnNumStyle Denotes the footnote numbering style for tables in the document. The value is one of: • Constants.FV_FN_NUM_NUMERIC (0x00) - Arabic • Constants.FV_FN_NUM_ROMAN_UC (0x01) - Roman uppercase • Constants.FV_FN_NUM_ROMAN_LC (0x02) - Roman lowercase •...
Page 257
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description CondFmtIsShown Returns True if the document conditions are shown. Else, returns False. CombinedFontFamily Contains the Combined font definition CombinedFontDefn (FO_CombinedFontDefn) FontEncodingName string Specifies the font encoding. FontAngle Denotes the font angle (specifies an index into the array...
Page 258
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Strikethrough Returns True if Strikethrough style is enabled. Else, returns False. StyleOverrides Specifies the style condition indicators for conditional text. The value is one of: • Constants.FV_CN_NO_OVERRIDE (0) •...
Page 259
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Label string Denotes the title in the document window title bar. ScreenHeight Denotes the height of the document window in pixels. ScreenWidth Denotes the width of the document window in pixels.
Page 260
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description DocFluidFlow Flow Specifies the flow to set to fluid view. To turn this off, set the value of this property to 0. ViewOnlyDeadCodes Indicates the F-codes that cannot be executed in the UInts document.
Page 261
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description SecNumComputeMethod Denotes the type of numbering applied on a particular section of a document. The value is one of: • Constants.FV_NUM_CONTINUE (0x01) • Constants.FV_NUM_RESTART (0x02) • Constants.FV_NUM_SAME (0x03) SectionNumStyle Denotes the section numbering style.
Page 262
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description SubsectionNumStyle Denotes the subsection numbering style. The value is one • 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 •...
Page 263
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description BooleanConditionExpression string Denotes the actual conditional expression used in the document. BooleanConditionState Set to 1 to indicate that the conditional expression defined by the BooleanConditionExpression parameter is applied to the document.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Element Property name Data Type Description AttrDisplay Specifies element’s attribute display properties. The value is one of: • Constants.FV_ATTR_DISP_NONE (1) - Do not display attributes • Constants.FV_ATTR_DISP_REQSPEC (2) - Display required and specified attributes •...
Page 265
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description MatchingLastPgfClauses Objects IDs of the last paragraph clauses (FO_FmtRuleClause IDs) in the element’s definition that apply to the element. MatchingObjectClauses IDs of the object clauses (FO_FmtRuleClause IDs) in the Objects element’s definition that apply to the element.
Page 266
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Object FMObject ID of the object that an element contains. The type of object the ID specifies depends on the element definition as follows: • Constants.FV_FO_SYS_VAR (2): FO_Var •...
Page 267
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ContentIsStrictlyValid True if the content of the element is strictly valid. ContentMustBeEmpty True if the element cannot have any content. ContentNeededAtBegin True if content is needed at the beginning of the element.
Page 268
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description NextInvalidElement Element Next invalid element in the document (FO_Element ID). TextIsInvalidInElement True if the element contains only text and the element definition disallows it. is obsolete and is no TextIsInvalidInElement longer supported.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference ElementCatalogEntries An Array of ElementCatalogEntry objects with integer indexing and a length property. Property name Data Type Description length number The length of the array ElementCatalogEntries methods concat, pop, push. ElementCatalogEntry Property name Data Type Description Denotes the ID of the element definition.
Page 270
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ElementDefType Type of formatter object represented by the element with element definition.Constants.FV_FO_CONTAINER (1) identifies a container element. Other values identify object (non-container) elements. The value is one of: •...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PrefixRules Objects The IDs of the prefix format rules (FO_FmtRule IDs). SuffixRules The IDs of the suffix format rules (FO_FmtRule IDs). Objects TextFmtRules Objects The IDs of the text format rules (FO_FmtRule IDs).
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference ElementRange Property name Data Type Description ElementLoc Beginning of the element range. End of the element range. ElementLoc ElementRange methods ElementRange. Ellipse Property name Data Type Description RectangleIsSmoothed True if smoothing is enabled. This property is always True for Ellipse objects.
Page 273
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Fill The fill pattern (numbers between 0 and 15). The ESTK provides constants for the following fill patterns: • Constants.FV_FILL_BLACK (0) • Constants.FV_FILL_WHITE (7) • Constants.FV_FILL_CLEAR (15) FrameParent Denotes the frame containing the graphic object FMObject (AFrame or UnAnchoredFrame).
Page 274
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Overprint Specifies the overprint settings for the objec. The value is one of: • Constants.FV_KNOCKOUT (0x00) • Constants.FV_OVERPRINT (0x01) • Constants.FV_FROMCOLOR (0x02) The fill pattern (numbers between 0 and 15). The ESTK provides constants for the following fill patterns: •...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference FCodes Property name Data Type FCodes.NULLINPUT Value -1 FCodes.KBD_INPUT Value 1 FCodes.START_DIALOG Value 0xC100 FCodes.END_DIALOG Value 0xC200 FCodes.START_WINDOW Value 0xC400 FCodes.END_WINDOW Value 0xC500 FCodes.LEAVE_DOC Value 0xC600 FCodes.SERVER_CANCEL Value 0xC001 FCodes.SERVER_QUERY Value 0xC002 FCodes.MENU_BARSTART Value 0xC301 FCodes.MENU_WAITBIT...
Page 276
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type FCodes.CSR_HOME Value 0x100 FCodes.CSR_UP Value 0x101 FCodes.CSR_DOWN Value 0x102 FCodes.CSR_RIGHT Value 0x103 FCodes.CSR_LEFT Value 0x104 FCodes.CSR_BOL Value 0x105 FCodes.CSR_EOL Value 0x106 FCodes.CSR_BOW Value 0x107 FCodes.CSR_EOW Value 0x108 FCodes.CSR_BOS Value 0x109 FCodes.CSR_EOS...
Page 277
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type FCodes.DEL_CHARFWD Value 0x113 FCodes.DEL_BOW Value 0x114 FCodes.DEL_EOW Value: 0x115 FCodes.DEL_EOL Value: 0x116 FCodes.DEL_EOS Value: 0x117 FCodes.DEL_SEL Value: 0x118 FCodes.DEL_BOL Value: 0x119 FCodes.KBD_KERNUP Value: 0x11A FCodes.KBD_KERNDOWN Value: 0x11B FCodes.KBD_KERNLEFT Value: 0x11C FCodes.KBD_KERNRIGHT...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type FCodes.KBD_NEW_XML Value: 0x803 FCodes.KBD_CMS_PREFERENCE Value: 0x804 FCodes.KBD_CMS_UPLOAD_DOC_OR_BOOK Value: 0x805 FCodes.KBD_REFRESH_DITAMAP_RMVIEW Value: 0x807 FilterArgs Property name Data Type Description infile The file to filter. string outfile string The filter output file.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description MaxInterPgfPadding Maximum interparagraph spacing. MinHang Maximum character height for synchronization of first line in column. If characters exceed this height, FrameMaker does not synchronize the first line. Name string Name of flow tag.
Page 337
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description MaxSpace Maximum word spacing (percentage of an em space in current font). MinSpace Minimum word spacing (percentage of an em space in current font). OptSpace Optimum word spacing. TopSeparator Name of frame to put above paragraph.
Page 338
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description MoveTabs Amount by which to move all tab positions in the paragraph. NumTabs The number of tabs in the paragraph. To clear all the tabs in the paragraph, set to 0.
Page 339
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Language The hyphenation and spell-checking language to use. The value is one of: • Constants.FV_LANG_BRAZILIAN (0x0B) • Constants.FV_LANG_BRITISH (0x02) • Constants.FV_LANG_CANADIAN_FRENCH (0x06) • Constants.FV_LANG_CATALAN (0x08) • Constants.FV_LANG_DANISH (0x0C) •...
Page 340
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description KernY Vertical kern value for manual kerning expressed as a percentage of an em (metric – 100% to 1000%). A positive value moves characters up and a negative value moves characters down.
Page 341
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Start Denotes the Vertical placement of a paragraph. The value is one of: • Constants.FV_PGF_ANYWHERE () • Constants.FV_PGF_TOP_OF_COL () • Constants.FV_PGF_TOP_OF_PAGE () • Constants.FV_PGF_TOP_OF_LEFT_PAGE () • Constants.FV_PGF_TOP_OF_RIGHT_PAGE () CellBottomMargin Amount added to default bottom margin of table cell.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference FmtRule Property name Data Type Description CountElements Strings The list of element tags to count among the element’s ancestors, if the format rule is a level rule. The tags are specified by the Count ancestors named element of the format rule.
Page 343
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description FmtChangeListTag string Denotes the change list’s tag, if If the format rule clause specifies a change list ( RuleClauseType specifies Constants.FV_RC_CHANGELIST_TAG (3) FmtRule The ID of the format rule containing the format rule FmtRule clause (FO_FmtRule ID).
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description InTextFrame TextFrame Text frame containing the footnote (FO_TextFrame ID). InTextObj Sub column that contains the footnote (FO_SubCol). SubCol LastPgf Last paragraph in the footnote (FO_Pgf ID). NextFnInDoc Next footnote (FO_Fn ID) in the document.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Fonts methods concat, pop, push. Group Property name Data Type Description FirstGraphicInGroup First object in the group. FMObject LastGraphicInGroup FMObject Last object in the group. Angle Angle of the object’s rotation. ArrowBaseAngle Arrowhead base angle in degrees.
Page 346
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description GraphicIsSelected True if the graphic object is selected; False, otherwise. GroupParent Group that the object is in (FO_Group ID). Group Note: Anchored and unanchored frames do not have this property.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description PrevGraphicInGroup FMObject Previous graphic object in the group Runaround Specifies 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.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Inset Property name Data Type Description InsetDpi Specifies the scaling information for bitmap file (corresponds to the value specified in the Image File Scaling Options dialog box when the graphics file is imported). ImportHint Record identifying the filter used to import the graphic.
Page 349
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ArrowType Arrowhead style. The value is one of: • Constants.FV_ARROW_STICK (0x1) • Constants.FV_ARROW_HOLLOW (0x2) • Constants.FV_ARROW_FILLED (0x3) BorderWidth Denotes the border width (0.015 points to 360 points). Color Color...
Page 350
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description NextGraphicInFrame FMObject Next graphic object in the frame. NextGraphicInGroup Next graphic object in the group. FMObject NextSelectedGraphicInDoc FMObject Next selected graphic object in document. ObjectAttributes A list of strings, each string expressing an attribute that is...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Ints An Array ofobjects with integer indexing and a length property. Property name Data Type Description length number The length of the array Ints methods concat, pop, push. Line Property name Data Type Description NumPoints Specifies the number of vertices.
Page 352
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Fill The fill pattern (numbers between 0 and 15). The ESTK provides constants for the following fill patterns: • Constants.FV_FILL_BLACK (0) • Constants.FV_FILL_WHITE (7) • Constants.FV_FILL_CLEAR(15) FrameParent Frame containing the graphic object (FO_AFrame or FMObject FO_UnanchoredFrame ID).
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description The pen pattern (numbers between 0 and 7). The ESTK provides constants for the following values: • Constants.FV_FILL_BLACK (0) • Constants.FV_FILL_WHITE (7) • Constants.FV_FILL_CLEAR (15) PrevGraphicInFrame Previous graphic object in the frame.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Marker methods Delete, GetProps, ObjectValid, SetProps. MarkerType Property name Data Type Description NextMarkerTypeInDoc Denotes the next marker type (FO_MarkerType ID). MarkerType Name string The name of this marker type, as it appears in the user interface.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Math Property name Data Type Description BasePointX Horizontal placement of text line base point relative to the left side of the frame. BasePointY Vertical placement of text line base point relative to top of the frame.
Page 356
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Dash Metrics Specifies a dash pattern that is repeated for the length of an object's border. The pattern is stored in a Metrics object. The 0th element of the MetricsT.MetricsT_val...
Page 357
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description NextGraphicInGroup FMObject Indicates the next graphic object in the group. NextSelectedGraphicInDoc Specifies the next selected graphic object in the FMObject document. ObjectAttributes Strings Contains a list of strings, each string expressing an attribute that is specified for an anchored frame in the Object Properties >...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Menu Property name Data Type Description FirstMenuItemInMenu FMObject The first menu item in the menu. MenuType Type of menu. The value is one of: • Constants.FV_MENU_MENUBAR (1) - Amenu bar defined by the FrameMaker product.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description NextMenuItemInMenu FMObject The next menu item separator in the menu. NextMenuItemInSession The next menu item separator in the list of menu items, FMObject menus, and separators in the session.
Page 360
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description NumAtEnd True if numbering position is End of Paragraph; False if it is Beginning of Paragraph. PgfIsAutoNum True if autonumbering is enabled. PgfNumber string The formatted string representation of the paragraph number;...
Page 361
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Position Specifies position relative to baseline of text. The value is one of: • Constants.FV_POS_NORM (0): Normal • Constants.FV_POS_SUPER (1): Superscript • Constants.FV_POS_SUB (2): Subscript Stretch Character stretch (set width) expressed as a percentage of normal stretch for the font (metric –10% to 1000%).
Page 362
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Locked True if the paragraph is part of a text inset that retains formatting information from the source document. The paragraph is not affected by global formatting performed on the document.
Page 363
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Unique The paragraph’s user ID. FirstIndent First-line left margin, measured from left side of current text column (0 cm to 100 cm). LeftIndent Left margin, measured from left side of current text column (0 cm to 100 cm).
Page 364
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Start Vertical placement of paragraph. The value is one of: • Constants.FV_PGF_ANYWHERE (0x00) • Constants.FV_PGF_TOP_OF_COL (0x01) • Constants.FV_PGF_TOP_OF_PAGE (0x02) • Constants.FV_PGF_TOP_OF_LEFT_PAGE (0x03) • Constants.FV_PGF_TOP_OF_RIGHT_PAGE (0x04) InTextFrame Text frame containing the paragraph (FO_TextFrame ID).
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference PgfFmt Property name Data Type Description AcrobatLevel Retained in Version 6.0 or later for backward compatibility. Use PDFStructureLevel instead. PgfMarkedForNamedDestination If True, this paragraph will have a corresponding Named Destination in the generated PDF.
Page 366
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description FontAngle Font angle (specifies an index into the array of font angles provided by the session property FontAngleNames FontEncodingName The font’s encoding. string FontFamily Font family (specifies an index into the array of font...
Page 367
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description HyphMinPrefix Minimum number of letters that must precede hyphen. HyphMinSuffix Minimum number of letters that must follow a hyphen. HyphMinWord Minimum length of a hyphenated word. Language Hyphenation and spell-checking language to use. The value is one of: •...
Page 368
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description LineSpacing Space between lines in a paragraph measured from baseline to baseline. The value is one of: • Constants.FV_PGF_FIXED (0x00): default font size • Constants.FV_PGF_PROPORTIONAL (0x01): largest font in line •...
Page 369
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description BkColor Color Denotes the text background color. If this property is 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.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description UseNextTag True if Next Paragraph Tag is enabled. LetterSpace True if Word Spacing is enabled. MaxSpace Maximum word spacing (percentage of an em space in current font). MinSpace Minimum word spacing (percentage of an em space in current font).
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Polygon Property name Data Type Description NumPoints Number of polygon vertices. Points Array of x-y coordinate pairs that specify the polygon’s Points vertices. PolyIsBezier True if polygon is smoothed. Angle Indicates the angle of rotation of the graphic object.
Page 372
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description GroupParent Group Specifies the group to which the object belongs. Note: Anchored frames do NOT have this property. HeadArrow Set to if the line has an arrow head. Set to...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Specifies 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) •...
Page 374
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ArrowScaleFactor Indicates the factor by which the arrowhead is scaled as line width changes (always rounded down to nearest 1/16 point). It is not used if the ArrowScaleHead property...
Page 375
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description LineCap Specifies 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) LocX Specifies the distance of the object from the left side of the parent frame (in inches).
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Runaround Specifies 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: •...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference PropVals An Array of PropVal objects with integer indexing and a length property. Property name Data Type Description length number The length of the array PropVals methods concat, pop, push. Rectangle Property name Data Type...
Page 378
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Fill Denotes 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) •...
Page 379
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ObjectAttributes Strings A list of strings. Each string expresses an 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...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference RefPage Property name Data Type Description Name string Name of the reference page. PageFrame Page frame (FO_UnanchoredFrame ID) UnanchoredFrame PageHeight Height of the page. PageNext Next reference page (FO_RefPage ID) in the document. RefPage PageNum Page number.
Page 381
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Dash Metrics Specifies a dash pattern that is repeated for the length of 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;...
Page 382
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description NextSelectedGraphicInDoc FMObject Denotes the next selected graphic object in the document. ObjectAttributes A list of strings. Each string expresses an attribute that is Strings specified for an anchored frame in the Object Properties >...
Page 383
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description CondFmtIsShown True if the condition is shown. Element The ID of the element containing the row in a Element FrameMaker document. FirstCellInRow Cell First cell in row (FO_Cell ID).
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference RulingFmt Property name Data Type Description Name string Ruling format name. NextRulingFmtInDoc Next ruling format in document (FO_RulingFmt ID). RulingFmt Specifies the pen pattern (numbers between 0 and 7). Constants are provided for pen patterns 0, 7 and 15, as follows: •...
Page 386
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description FirstPgf First paragraph in the column (FO_Pgf ID). FrameParent ID of text frame that contains the column (FO_TextFrame TextFrame ID). Height Column Height. LastAFrame Last anchored frame in the column (FO_AFrame ID).
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Offset from the left margin. type Type of tab. The value is one of: uint • Constants.FV_TAB_LEFT (0x1) - Left tab. • Constants.FV_TAB_CENTER (0x2) - Center tab. • Constants.FV_TAB_RIGHT (0x3) - Right tab.
Page 388
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ContentHeight The height of the table title. Locked True if the table is part of a text inset that retains formatting information from the source document. The table is not affected by global formatting performed on the document.
Page 389
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description TblCatalogEntry True if the table’s format is in the Table Catalog. TblColWidths List of column widths. Metrics TblNumbering Direction of autonumbering for the table. The value is one of: •...
Page 390
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description LeftColNum Number of the leftmost selected column, if a table is selected (columns are numbered from left to right, starting with 0). RightColNum Number of rightmost selected column, if a table is selected (columns are numbered from left to right, starting with 0).
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description LastPgf The last paragraph in the title, if the table has a title. TblTitleGap Gap between the title and top or bottom row of the table. TblTitlePosition The placement of the table title. The value is one of: •...
Page 392
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description TblTitleGap Gap between title and top or bottom row. TblTitlePosition The placement of the table title. The value is one of: • Constants.FV_TBL_NO_TITLE (0) - Table has no title •...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description TblOtherBodyRowRuling RulingFmt Ruling applied to body rows specified by TblBodyRowRulingPeriod FO_RulingFmt ID TblOtherColRuling Ruling applied to table columns specified by RulingFmt TblColRulingPeriod FO_RulingFmt ID TblRightRuling RulingFmt Ruling for the right side of the table (...
Page 394
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description LastAFrame AFrame Last anchored frame in the text frame (FO_AFrame ID). LastCell Last table cell in the text frame (FO_Cell ID). Cell LastFn Last footnote in the text frame (FO_Fn ID).
Page 395
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Dash Metrics Specifies a dash pattern that is repeated for the length of 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;...
Page 396
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description NextSelectedGraphicInDoc FMObject Denotes the next selected graphic object in the document. ObjectAttributes A list of strings. Each string expresses an attribute that is Strings specified for an anchored frame in the Object Properties >...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference TextItem Property name Data Type Description offset Offset from the beginning of the paragraph or the text line. dataType Type of the text item. sdata string Denotes the text item if the text item is a string.
Page 398
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Text Item Type Text Item Represents Text Item Data FTI_VarEnd The end of a variable. FO_Var FTI_ElementBegin The beginning of a container structural element. FO_Element FTI_ElementEnd The end of a container structural element. FO_Element FTI_ElemPrefixBegin The beginning of an element’s prefix.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Flags Meaning FTF_SHADOW The shadow characteristic has changed. FTF_SIZE The font size has changed. FTF_SPREAD The font spread has changed. FTF_STRETCH The font stretch value has changed. FTF_STRIKETHROUGH The strikethrough characteristic has changed. FTF_TSUME The Tsume setting has changed.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference TextLine Property name Data Type Description BasePointX Horizontal placement of text line base point relative to left side of the frame. BasePointY Vertical placement of text line base point relative to top of the frame.
Page 401
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ArrowBaseAngle Denotes the arrowhead base angle in degrees. ArrowLength Denotes the arrowhead length (always rounded down to the nearemichael.and.st 1/256 point). ArrowScaleFactor Indicates the factor by which the arrowhead is scaled as line width changes (always rounded down to nearest 1/16 point).
Page 402
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description LineCap Specifies 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) LocX Specifies the distance of the object from the left side of the parent frame (in inches).
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Runaround Specifies 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: •...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference TiApiClient Property name Data Type Description TiClientData string Data used by the client (for example, an SQL query). TiClientName The registered name of the client that created the inset. string TiClientSource string The name that appears as the source in the Text Inset Properties dialog box.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference TiFlow Property name Data Type Description TiFlowName string The name of the imported flow if TiMainFlow False TiFlowPageSpace The type of pages the imported flow is on: • Constants.FV_BODY_PAGE(0x00) • Constants.FV_REFERENCE_PAGE (0x02) TiFormat Source of the imported text’s format: •...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description TiFileModDate string The modification date of the text inset’s source file. LastUpdate Time when the inset was last updated, expressed in seconds since 1 January, 1970. Unique The text inset’s UID.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference TiText methods ConvertToText, Delete, DeletePropByName, DeleteTextInsetContents, GetProps, GetText, ObjectValid, SetProps, UpdateTextInset. TiTextTable Property name Data Type Description TiByRows True if each paragraph in the imported text is converted to a row of table cells;...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description TiFileModDate string The modification date of the text inset’s source file. LastUpdate Time when the inset was last updated, expressed in seconds since 1 January, 1970. Unique The text inset’s UID.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description length The length of the array number TypedVals methods concat, pop, push. UBytes An Array ofobjects with integer indexing and a length property. Property name Data Type Description length...
Page 410
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ArrowLength Denotes the arrowhead length (always rounded down to the nearest 1/256 point). ArrowScaleFactor Indicates the factor by which the arrowhead is scaled as line width changes (always rounded down to nearest 1/16 point).
Page 411
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description LineCap Specifies 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) LocX Specifies the distance of the object from the left side of the parent frame (in inches).
Page 412
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description Runaround Specifies 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: •...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference VarFmt Property name Data Type Description string The variable format definition; the building blocks and text strings used to create a variable instance with the variable format. Name The variable format’s name. string NextVarFmtInDoc VarFmt Next variable format (FO_VarFmt ID) in the document’s...
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference XRef Property name Data Type Description Element Element The associated element, if the cross reference is in a FrameMaker document. Locked True if the cross-reference is part of a text inset that retains formatting information from the source document.
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference XRef methods Delete, GetProps, GetText, ObjectValid, SetProps. XRefFmt Property name Data Type Description The cross-reference format (a string that specifies text string and building blocks). Name string The cross-reference format’s name. NextXRefFmtInDoc XRefFmt Denotes the next cross-reference format (FO_XRefFmt ID).
Page 416
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description FirstOpenDoc First open document ( FO_Doc ID) in session. BinDir Directory path of string $FMHOME/bin CurrentDir string Name of the directory from which the FrameMaker product was started CurrentMenuSet Type of menu set.
Page 417
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description IsInFront True if the FrameMaker product window is in front of other application windows. You can use this property to bring the FrameMaker product to the front or back.
Page 418
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description ProductName string The FrameMaker product name. The names for FrameMaker+SGML indicate FrameMaker running under the structured product interface. FrameViewer is retained for backward compatibility. Can be one of: •...
Page 419
ADOBE FRAMEMAKER SCRIPTING GUIDE Object Reference Property name Data Type Description NoFlashInPDF bool When True , the Flash content in the PDF becomes static. When False , Flash objects get embedded in the PDF and are playable. Default is False...
Chapter 5: Function Summary AFrame Delete Description method is used to delete an object from a document. When you delete an object that contains another Delete() object, all child objects are also deleted with the parent object. For example, if you delete a frame, all objects within the frame are also deleted.
Page 421
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_WrongProduct (-60) Current FrameMaker version does not support the specified operation. Returns PropVals Syntax GetProps() SetProps Description method sets the properties of a specified object. SetProps() The method takes one argument - An array containing the values of the object to be set.
Page 422
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_InvContextSpec () The API encountered an invalid context specification in a FrameMaker document. Constants.FE_NotBookComponent (-26) The specified value must be a book component (FO_BookComponent). Constants.FE_NotFrame (-12) The specified value must be a frame.
Page 423
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Delete Description Deletes the Arc object. Delete under the AFrame class for more information. Returns Syntax Delete() GetProps Description method retrieves the properties of the Arc object. GetProps() SetProps under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary ObjectValid Description Returns if the Arc object is valid, else returns True False ObjectValid under the AFrame class for more information. Returns Syntax ObjectValid() AttrCondExpr ApplyAttributeExpression Description is the method to apply the attribute expression to the document.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal PropVals The property list. ObjectValid Description Returns if the attribute expression is valid, else returns...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description name string Attribute name. values Attribute values. Strings valflags uint Validation error flags. allow uint Allow error as special case. AttributeDef AttributeDef Description Describes a single attribute function.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Value Meaning Constants.FV_AT_STRING(0) Any arbitrary 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).
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns AttributeDef Syntax pop() push Description Returns the new length of the array. Returns number Syntax push(value) Parameters Parameter name Data Type Optional Description value AttributeDe Value to push into the array. Attributes An Array of Attribute objects with integer indexing and a length property.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Description Removes the last element from the array. Returns Attribute Syntax pop() push Description Returns the new length of the array. Returns number Syntax push(value) Parameters Parameter name Data Type Optional Description value Attribute Value to push into the array.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description value AttributesE Can also be arrays. Description Removes the last element from the array. Returns AttributeEx Syntax pop() push Description Returns the new length of the array.
Page 431
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax Delete() GetProps Description method retrieves the properties of the specified Body Page. GetProps() GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description method sets the properties of the specified Body Page.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary ApplyPageLayout Description method applies the layout of one page to another page. ApplyPageLayout() The method returns on success, and sets with one of the following values on error: FE_Success FA_errno Error Reason Constants.FE_WrongProduct (-60)
Page 433
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary The method returns the comparison results in the object on success. On failure, the method assigns one CompareRet of the following values to FA_errno Error Reason Constants.FE_BadDocId (-2) Invalid document. Constants.FE_BadCompare (-35) Older and newer documents are not the same types of files.
Page 434
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadBookId (-66) Invalid book. Constants.FE_BadCompPath (-68) Component name specified for compName is invalid. Constants.FE_BadNew (-23) The object cannot be created. Constants.FE_BookUnStructured (-67) The specified book is unstructured. Returns Element Syntax NewBookComponentInHierarchy(compName, elemLoc)
Page 435
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary The method returns on success, and assigns with one of the following values on failure: FE_Success FA_errno Error Reason Constants.FE_BadOperation (-27) The book is not self-consistent (book generates data in one file that is source data for another generated file, or page count continually changes for this operation);...
Page 436
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Flag What to Import Constants.FF_UFF_REMOVE_EXCEPTIONS Remove exception formats from target documents (0x8000) Constants.FF_UFF_REMOVE_PAGE_BREAKS Remove all forced page breaks from target documents (0x4000) Constants.FF_UFF_TABLE (0x0008) Table Catalog formats Constants.FF_UFF_VAR (0x0040) Variable formats Constants.FF_UFF_XREF (0x0080) Cross-reference formats The method returns on success.
Page 437
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Flag Meaning Constants.FF_IED_DO_NOT_IMPORT_EDD If the source document is an EDD, setting this value does NOT treat it as an EDD; instead the (0x0004) method just imports its element catalog. Constants.FF_IED_NO_NOTIFY (0x0008) Do not issue the Constants.FA_Note_PreImportElemDefs (64) or Constants.FA_Note_PostImportElemDefs (65) notifications.
Page 438
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description objType The type of object (for example, FO_Pgf). unique The unique ID of the object. Close Description Closes a document, book, dialog box, or Frame session. parameter specifies whether to abort or to close open documents or books if they have unsaved changes.
Page 439
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary If you set the parameter to , FrameMaker displays the Save dialog box and allows the user to choose interactive True a filename. The book's current name appears as the default file name. method returns the book it saved, on success.
Page 440
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary NewSeriesObject Description method creates a series object. Series objects include the following object types: NewSeriesObject() • BodyPage • BookComponent • Pgf The method allows you to specify the position in the series at which to add the new object.
Page 441
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns BookComponent Syntax NewSeriesBookComponent(previous) Parameters Parameter name Data Type Optional Description previous Object The location of the object in the series after which to add the new Book Component. To add a paragraph at the start of a flow, specify the location of the flow.
Page 442
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary The method returns the document it saved, on success. On failure the method sets to one of the following values: FA_errno Error Reason • • Constants.FE_Canceled (-44) Constants.FV_FileNotWritable (33) - File was not writable.
Page 443
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description saveAsName string The path for saving the document or book. saveParams A property list that tells FrameMaker how to save the file and PropVals how to respond to errors and other conditions. Use GetSaveDefaultParams() or AllocatePropVals() to create and allocate memory for this property list.
Page 444
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Meaning Constants.FS_AllowNonFMFiles (1) Allow the FrameMaker product to update numbering, text insets, and other properties of all the FrameMaker documents in the book, even if there are documents in the book that were not created by FrameMaker. The permissible values are as follows: •...
Page 445
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Meaning Constants.FS_UpdateBookTextReferences (10) Update text insets in all the documents of the book. Takes the value True or False. • True - Update text insets. • False - Do not update text insets.
Page 446
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax UpdateBook(updateParams, updateReturnParams) Parameters Parameter name Data Type Optional Description updateParams PropVals A property list specifying how to update the book and how to respond to errors and other conditions. To use the default list,...
Page 447
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Meaning Constants.FS_DisallowDoc (8) Disallow importing FrameMaker binary documents. Set to either True or False. • True - Do not allow importing FrameMaker binary documents. • False - Allow importing FrameMaker binary documents. Constants.FS_DisallowFilterTypes (11) Disallow importing filterable files.
Page 448
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Meaning Constants.FS_FileIsXmlDoc (37) File is an XML document. The possible values are: • Constants.FV_DoOK (1) - Import it anyway. • Constants.FV_DoCancel (0) - Cancel the import operation. • Constants.FV_DoShowDialog (4) - Show a dialog box and let the user decide.
Page 449
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary record_vers vendor format_id platform filter_vers filter_name Note: The fields in the record are not separated by spaces. Spaces are significant data except those that appear in the filter_name field. For example: 0001PGRFPICTMAC61.0 Built-in PICT reader0001ORBLSVGIAll Platform SVG reader for 7.0 Each field of the record (except ) specifies a four-byte code.
Page 450
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Code Meaning IGES Initial Graphics Exchange Specification (CAD files) IMG4 Image to CCITT Group 4 (UNIX) MooV QuickTime Movie Object Linking and Embedding Client (Microsoft) PC Paintbrush PICT QuickDraw PICT PNTG MacPaint SNRF Sun Raster File...
Page 451
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Meaning Constants.FS_FormatImportedText (22) Format the imported text. The possible values are: • Constants.FV_EnclosingDoc (1) - Use formatting in the enclosing document. • Constants.FV_PlainText (2) - Format the imported text as plain text. •...
Page 452
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Meaning Constants.FS_RasterImageHeight (40) Specifies the height of the rectangle in which to import the graphic, when importing SVG data. Note: You should always specify this value in points. This property corresponds to the height for the Fit in Selected Rectangle setting in the Imported Graphic Scaling dialog box.
Page 453
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Meaning Constants.FS_TreatParaAsRow (28) Convert each line in the text file into a row of table cells and use Constants.FS_CellSeparator (29) and Constants.FS_NumCellSeparators (30) to determine how to divide the line into separate cells, if Constants.FS_FileIsText (16) is set to Constants.FV_DoImportAsTable (8).
Page 454
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Both the property and the global variable indicate the result of Constants.FS_ImportNativeError (2) FA_errno a call to the method. The following table lists the possible status flags and the reasons associated with them: Import()
Page 455
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Status Flag Reason Constants.FE_Canceled (-44) • Constants.FV_CancelFileText (32) - The file is text, so the user or the Import script canceled the Import operation. • Constants.FV_CancelFileGraphic (36) - The source file is a graphic, so the user or the Import script canceled the Import operation.
Page 456
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetProps Description Retrieves the properties of the specified Book. GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description Sets the value of the specified property of the Book. See “SetProps” on page 413 under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary BookComponent Delete Description Deletes the specified BookComponent object. See “Delete” on page 412 under the AFrame class for more information. Returns Syntax Delete() MoveComponent Description Moves a particular book component up and down in the book components sequence. In addition , you can promote and demote operations of a component in a hierarchy using this method.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps Description Sets the property of the BookComponent object. See “SetProps” on page 413 under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The value of the property to be set.
Page 459
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_WrongProduct (-60) Current FrameMaker product does not support tables. Constants.FE_BadOperation (-27) Parameters specify an action that is invalid. Constants.FE_BadDocId (-2) Invalid document. Constants.FE_BadParameter (-43) Parameter has an invalid value. Constants.FE_BadObjId (-3) Invalid cell.
Page 460
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description heightInRows The number of cells to unstraddle vertically. widthInCols The number of cells to unstraddle horizontally. GetText Description method gets the text from the following types of objects: GetText() •...
Page 461
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Text Item Type Text Item Represents Text Item Data FTI_ElementEnd The end of a container structural element FO_Element FTI_ElemPrefixBegin The beginning of an element’s prefix FO_Element FTI_ElemPrefixEnd The end of an element’s prefix FO_Element FTI_ElemSuffixBegin The beginning of an element’s suffix...
Page 462
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Flags Meaning FTF_ALL OR of all the flags FTF_ANGLE The font angle has changed. FTF_CAPITALIZATION The capitalization has changed. FTF_CHANGEBAR The change bars have changed. FTF_CHARTAG The Character Catalog format has changed. FTF_COLOR The color has changed.
Page 463
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary If you call for an object (FO_Element object), the returned information depends on the type of element, GetText() as shown: Value Information Returned Constants.FV_FO_CONTAINER (1) All the text items from the beginning to the end of the element.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps Description Sets the desired property of the cell object. See “SetProps” on page 413 under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The value of the property to set.
Page 465
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetProps Description Get the properties of the specified CharFmt object. See “GetProps” on page 412 under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description Sets the value of the property for the specified CharFmt object.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Color Delete Description Deletes the specified color object. See “Delete” on page 412 under the AFrame class for more information. Returns Syntax Delete() GetProps Description Retrieves the properties of the specified color object. See “GetProps” on page 412 under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary ObjectValid Description Determines whether a color object is valid. Returns if the Color object is valid, else returns True False See “ObjectValid” on page 414 under the AFrame class for more information. Returns Syntax...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary CombinedFontDefn CombinedFamilyFonts Description Returns the permutations of angles, variations, and weights available for a specified combined font definition. The method does not take any arguments. method returns a CombinedFonts object that provides a list of the permutations of CombinedFamilyFonts() angles, variations, and weights available for the specified combined font definition.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps Description Sets the value of the desired property of the CombinedFonts object. See “SetProps” on page 413 under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax concat(value) Parameters Parameter name Data Type Optional Description value Can also be arrays. CombinedFon Description Removes the last element from the array. Returns CombinedFont Syntax pop() push Description Returns the new length of the array.
Page 471
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax Delete() GetProps Description Retrieves the properties of the specified Command object. See “GetProps” on page 412 under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description Sets the value of the specified Command property.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax ObjectValid() Delete Description Deletes the specified Command object. The method does not take any arguments. Call the Delete() method directly on the object to be deleted. Returns Syntax Delete() CompareRet CompareRet Description provides the results of a call to the method.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary CondFmt Delete Description Deletes the specified object. CondFmt See “Delete” on page 412 under the AFrame class for more information. Returns Syntax Delete() GetProps Description Retrieves the properties of the specified object. CondFmt See “GetProps” on page 412 under the AFrame class for more information.
Page 474
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary ObjectValid Description Identifies whether a object is valid or not. Returns if the CondFmt object is valid, else returns CondFmt True False See “ObjectValid” on page 414 under the AFrame class for more information.
Page 475
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax AddText(textLoc, text) Parameters Parameter name Data Type Optional Description textLoc The text location at which to add the text. TextLoc text string The text to add. CenterOnText Description Centers a range of text such that the middle of the text appears in the middle of the document window.
Page 476
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Flags Meaning Constants.FF_CUT_TBL_CELLS (0x0002) Remove cleared table cells. Constants.FF_VISIBLE_ONLY (0x0010) Clear only the visible portion of the selection. Constants.FF_DONT_DELETE_HIDDEN_TEXT (0x0004) Do not delete hidden text. flag takes precedence over other flags. If you specify Constants.FF_INTERACTIVE...
Page 477
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax ClearAllChangebars() Compare Description Compares two documents or two books. You can OR the values shown in the following table into the flags argument. Flags Meaning Constants.FF_CMP_SUMMARY_ONLY Generate a summary document, but not a composite document.
Page 478
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description newerDoc The newer version of the document to be compared. flags Bit flags that specify how to generate the summary and composite documents. Specify 0 for the default flags.
Page 479
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax Copy(flags) Parameters Parameter name Data Type Optional Description flags Bit field that specifies how to copy the text and how to handle interactive alerts. For default settings, specify 0. Description Cuts the current selection to the FrameMaker Clipboard.
Page 480
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description flags Bit field that specifies how to cut the text and how to handle interactive alerts. For default settings, specify 0. DeleteText Description Deletes a specified text range from a document.
Page 481
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadDocId (-2) Invalid document. Constants.FE_BadSelectionForOperation (-59) Current text selection is invalid for this operation. Returns Void Syntax DemoteElement() GetTextForRange Description Gets the text for a specified text range. Call the method on the document as follows: document.GetTextForRange()
Page 482
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Text Item Type Text Item Represents Text Item Data Constants.FTI_LineEnd The end of a line and the line end type If the line end is a normal line end, the value is 0; (0x00000004) if it is a forced line end, the FTI_HardLineEnd flag is set;...
Page 483
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Flags Meaning Constants.FTF_ANGLE The font angle has changed. (0x10000000) Constants.FTF_CAPITALIZATION The capitalization has changed. (0x000040000) Constants.FTF_CHANGEBAR The change bars have changed. (0x01000000) Constants.FTF_CHARTAG The Character Catalog format has changed. (0x00008000) Constants.FTF_COLOR The color has changed.
Page 484
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Flags Meaning Constants.FTF_UNDERLINING The underlining has changed. (0x08000000) Constants.FTF_VARIATION The font variation has changed. (0x40000000) Constants.FTF_WEIGHT The font weight has changed. (0x20000000) On success, the method returns a structure containing the array of text items of the requested types.
Page 485
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary On failure, the method sets the field of the returned structure to 0, and returns one of the following TextItems values to FA_errno Error Reason Constants.FE_BadDocId (-2) Invalid document. Constants.FE_BadObjId (-3) Invalid Object Constants.FE_NotTextObject (-41) Object specified for the text range is not an object that contains text.
Page 486
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadObjId (-3) Invalid Object Constants.FE_NotTextObject (-41) Object specified for the text range is not an object that contains text. Constants.FE_OffsetNotFound (-21) Offset specified for the text location could not be found in the specified paragraph or text line.
Page 487
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description textLoc TextLoc The text location of the character for which you want to get the the text property. The returned property applies to the character to the right of this location.
Page 488
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary HypertextCommand Description Simulates a user-invoked hypertext command. Note: Calling the HypertextCommand() method has the same effect as a user clicking on a hypertext marker containing the specified text. The method returns on success. FE_Success...
Page 489
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary MergeIntoLast Description Merges the selected structural elements into the last element in the selection. Note: At least two structural elements must be selected in the document before calling the MergeIntoLast() method. On success, the method does not return any value.
Page 490
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadDocId (-2) Invalid document. Constants.FE_BadObjId (-3) Invalid Object Constants.FE_NotTextObject (-41) Object specified for the text location is not a paragraph (FO_Pgf). Constants.FE_OffsetNotFound (-21) Offset specified for the text location could not be found in the specified paragraph or text line.
Page 491
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Flags Meaning Constants.FF_VISIBLE_ONLY (0x0010) Cut only the visible portion of the selection. Constants.FF_DONT_DELETE_HIDDEN_TEXT (0x0004) Do not replace hidden text. Constants.FF_DONT_APPLY_ALL_ROWS (0x0040) Do no’t apply condition setting on the Clipboard to all rows. If whole table is selected and the Clipboard contains condition setting, cancel the paste operation.
Page 492
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description flags Bit field that specifies how to paste the text and how to handle interactive alerts. For default settings, specify 0. PromoteElement Description Promotes the selected structural element. The selected element becomes a sibling of its former parent and appears immediately after its former parent.
Page 493
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_Transport (-1) A transport error occurred. Constants.FE_BadDocId (-2) Invalid document. Returns Syntax QuickSelect(prompt, stringlist) Parameters Parameter name Data Type Optional Description prompt The prompt that appears in the Tag area string stringlist...
Page 494
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax Reformat() Rehyphenate Description Rehyphenates a specified document based on changes the user has made to words’ hyphenation points. The method returns on success. On failure, the method returns one of the following values to...
Page 495
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary ResetReferenceFrames Description Resets the reference frames in the specified document. This method is useful for updating a document after you have programmatically changed a reference frame that is referenced by paragraphs in the document.
Page 496
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadDocId (-2) Invalid document. Constants.FE_BadObjId (-3) Invalid Object Constants.FE_NotTextObject (-41) Object specified for the text location is not a paragraph (FO_Pgf) or a flow (FO_Flow). Constants.FE_OffsetNotFound (-21) Offset specified for the text range could not be found in the specified paragraph or text line.
Page 497
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_OutOfRange (-7) Specified property value is out of the legal range for the specified property. Constants.FE_ReadOnly (-6) Property is read-only and cannot be set. Constants.FE_WrongProduct (-60) Current FrameMaker version does not support this operation.
Page 498
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_OutOfRange (-7) Specified property value is out of the legal range for the specified property. Constants.FE_ReadOnly (-6) Property is read-only and cannot be set. Constants.FE_WrongProduct (-60) Current FrameMaker version does not support this operation.
Page 499
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_OutOfRange (-7) Specified property value is out of the legal range for the specified property. Constants.FE_ReadOnly (-6) Property is read-only and cannot be set. Constants.FE_WrongProduct (-60) Current FrameMaker version does not support this operation.
Page 500
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SimpleImportFormats Description Imports formats from a document to a document or a book. If you import formats to a book, the method imports formats to each book component for which the property is set to...
Page 501
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description fromDoc The document or book from which to import formats. formatFlags Bit field specifying which formats to import. Specify 0 for the default flags. You can OR the following values into the parameter to specify which formats to import.
Page 502
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax SplitElement() TextLocToElementLoc Description Returns the element location structure that corresponds to the current text location. On success, the method returns an structure containing the element location. ElementLoc On failure, the method returns one of the following values to...
Page 503
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Void Syntax UnWrapElement() UpdateXRefs Description Updates the cross-references in a document. The method performs the same operation as clicking Update in the Cross- Reference window. You can OR the following values into the...
Page 504
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Note: If you import element definitions to a book,the SimpleImportElementDefs() method imports element definitions to each book component for which the ImportFmtInclude property is set to True. You can OR the following flags into the...
Page 505
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadDocId (-2) Invalid document Constants.FE_TypeUnNamed (-19) Objects of the specifies type are not identified by UIDs Constants.FE_NameNotFound (-20) Objects with the specified UID could not be found Returns Object Syntax GetUniqueObject(objType, unique)
Page 506
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SimpleSave Description Saves a document or book. If you set the parameter to and specify the document or book’s current name for interactive False saveAsName FrameMaker saves the document or book under its current name.
Page 507
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax SimpleSave(saveAsName, interactive) Parameters Parameter name Data Type Optional Description saveAsName The absolute path in which to save the document or book. string interactive Specifies whether the FrameMaker product displays messages and warnings to the user. Setting this to True displays messages and warnings.
Page 508
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_NotFrame (-12) Specified parent object is not a frame. Constants.FE_BadNew (-23) Object cannot be created. Returns Object Syntax NewGraphicObject(objType, parent) Parameters Parameter name Data Type Optional Description objType The type of ESTK graphic object to create (for example, FO_Rectangle or FO_Line).
Page 509
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Ellipse Syntax NewEllipse(parent) Parameters Parameter name Data Type Optional Description parent The parent frame in which to create the ellipse. FrameMaker Graphic Object NewFlow Description Creates a flow object. NewGraphicObject for more information.
Page 510
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description parent The parent frame in which to create the group. FrameMaker Graphic Object NewInset Description Creates an inset object. NewGraphicObject for more information. Returns Inset Syntax NewInset(parent)
Page 511
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary NewMath Description Creates a math object. NewGraphicObject for more information. Returns Math Syntax NewMath(parent) Parameters Parameter name Data Type Optional Description parent The parent frame in which to create the math object. FrameMaker Graphic...
Page 512
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Polygon Syntax NewPolygon(parent) Parameters Parameter name Data Type Optional Description parent The parent frame in which to create the polygon. FrameMaker Graphic Object NewRectangle Description Creates a rectangle object. NewGraphicObject for more information.
Page 513
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description parent The parent frame in which to create the round rectangle. FrameMaker Graphic Object NewTextFrame Description Creates a text frame object. NewGraphicObject for more information. Returns TextFrame...
Page 514
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary NewUnanchoredFrame Description Creates an unanchored frame object. NewGraphicObject for more information. Returns UnanchoredFrame Syntax NewUnanchoredFrame(parent) Parameters Parameter name Data Type Optional Description parent The parent frame in which to create the unanchored frame. FrameMaker...
Page 515
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Object Syntax NewAnchoredFormattedObject(objType, format, textLoc) Parameters Parameter name Data Type Optional Description objType The type of object to create (for example, FO_XRef). format The string that specifies the object’s format (for example, string...
Page 516
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax NewAnchoredFormattedXRef(format, textLoc) Parameters Parameter name Data Type Optional Description format The string that specifies the object’s format (for example, string for a cross-reference, for a table, Heading & Page Format A for a variable).
Page 517
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary The method returns the created anchored object on success. On failure, the method assigns one of the following values to FA_errno Error Reason Constants.FE_BadDocId(-2) Invalid document. Constants.FE_BadNew(-23) Object cannot be created. Constants.FE_BadObjId(-3) Invalid object.
Page 518
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary NewAnchoredFn Description Creates an anchored Fn object. NewAnchoredObject under the Doc class for more information. Returns Syntax NewAnchoredFn(textloc) Parameters Parameter name Data Type Optional Description textloc The text location at which to insert the anchored Fn object.
Page 519
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax NewAnchoredTiApiClient(textloc) Parameters Parameter name Data Type Optional Description textloc The text location at which to insert the anchored TiApiClient TextLoc object. NewAnchoredTbl Description Creates an anchored table object. NewAnchoredObject under the Doc class for more information.
Page 520
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_NotBodyPgf (-25) prevId parameter must specify a paragraph.. Constants.FE_NotBookComponent (-26) parameter must specify a book component.. prevId Returns One of the following objects: Body page, Pgf and Book Component Syntax NewSeriesObject(objType, previous)
Page 521
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax NewSeriesPgf(previous) Parameters Parameter name Data Type Optional Description previous The object in the series after which to add the new paragraph. To add a paragraph at the start of a flow, specify the flow. To add a paragraph at the beginning of any other series, specify 0.
Page 522
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadDocId (-2) Invalid document. Constants.FE_TypeUnNamed (-19) Objects of the specified type do not have names. Constants.NameNotFound (-20) Object with the specified name and type does not exist in the specified document. Returns...
Page 523
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax GetNamedCharFmt(name) Parameters Parameter name Data Type Optional Description name The name of the CharFmt object you want to get. string GetNamedColor Description Gets a Color object. GetNamedObject under the Doc class for more information.
Page 524
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetNamedCondFmt Description Gets a Conditional Format object. GetNamedObject under the Doc class for more information. Returns CondFmt Syntax GetNamedCondFmt(name) Parameters Parameter name Data Type Optional Description name The name of the CondFmt object you want to get.
Page 525
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax GetNamedFmtChangeList(name) Parameters Parameter name Data Type Optional Description name The name of the FmtChangeList object you want to get. string GetNamedMasterPage Description Gets a MasterPage object. GetNamedObject under the Doc class for more information.
Page 526
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetNamedRefPage Description Gets a Reference Page object. GetNamedObject under the Doc class for more information. Returns RefPage Syntax GetNamedRefPage(name) Parameters Parameter name Data Type Optional Description name The name of the RefPage object you want to get.
Page 527
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax GetNamedTblFmt(name) Parameters Parameter name Data Type Optional Description name The name of the TblFmt object you want to get. string GetNamedUnanchoredFrame Description Gets an Unanchored Frame object. GetNamedObject under the Doc class for more information.
Page 528
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetNamedXRefFmt Description Gets a Cross Reference Format object. GetNamedObject under the Doc class for more information. Returns XRefFmt Syntax GetNamedXRefFmt(name) Parameters Parameter name Data Type Optional Description name The name of the Cross Reference Format object you want to get.
Page 529
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary • CondFmt • ElementDef • FmtChangeList • MasterPage • Menu • MenuItemSeparator • PgfFmt • RefPage • RulingFmt • TblFmt • VarFmt • XRefFmt • MarkerType This method uses arbitrary default properties for the objects it creates.
Page 530
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary NewNamedAttrCondExpr Description Creates a named Attribute Conditional Expression. NewNamedObject under the Doc class for more information. Returns AttrCondExpr Syntax NewNamedAttrCondExpr(name) Parameters Parameter name Data Type Optional Description name The name to be assigned to the created Attribute Conditional string Expression.
Page 531
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax NewNamedCombinedFontDefn(name) Parameters Parameter name Data Type Optional Description name The name to be assigned to the created Combined Font string Definition. NewNamedColor Description Creates a named Color. NewNamedObject under the Doc class for more information.
Page 532
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary NewNamedElementDef Description Creates a named Element Definition. NewNamedObject under the Doc class for more information. Returns ElementDef Syntax NewNamedElementDef(name) Parameters Parameter name Data Type Optional Description name The name to be assigned to the created Element Definition.
Page 533
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax NewNamedMasterPage(name) Parameters Parameter name Data Type Optional Description name The name to be assigned to the created Master Page. string NewNamedPgfFmt Description Creates a named Paragraph Format. NewNamedObject under the Doc class for more information.
Page 534
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary NewNamedRulingFmt Description Creates a named Ruling Format. NewNamedObject under the Doc class for more information. Returns RulingFmt Syntax NewNamedRulingFmt(name) Parameters Parameter name Data Type Optional Description name The name to be assigned to the created Ruling Format.
Page 535
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax NewNamedVarFmt(name) Parameters Parameter name Data Type Optional Description name The name to be assigned to the created Variable Format. string NewNamedXRefFmt Description Creates a named Cross Reference Format. NewNamedObject under the Doc class for more information.
Page 536
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary DeleteUnusedFmts Description Deletes unused formats (character, paragraph or table) from the document. The method returns on success. Constants.FE_Success On failure, the method sets to one of the following values: FA_errno Error Reason Invalid document.
Page 537
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax DeleteUnusedPgfFmt() DeleteUnusedTblFmt Description Deletes the unused Table Formats. DeleteUnusedFmts under the Doc class for more information. Returns Syntax DeleteUnusedTblFmt() Find Description Performs the same actions as using the Find dialog box to search a document for text or other types of content.
Page 538
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Meaning and Possible Values Constants.FS_FindCharFmt (3) No associated property. One or more of the following additional properties should be specified to tailor the search. • FontFamily • CombinedFont • FontSize • FontAngle •...
Page 539
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Meaning and Possible Values Constants.FS_FindObject (8) Value is one of: • Constants.FV_FindAnyMarker (0) • Constants.FV_FindAnyXRef (1) • Constants.FV_FindUnresolvedXRef (2) • Constants.FV_FindAnyTextInset (3) • Constants.FV_FindUnresolvedTextInset (4) • Constants.FV_FindAnyPub (5) • Constants.FV_FindAnyVariable (6) • Constants.FV_FindAnchoredFrame (7) •...
Page 540
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary • Table foot • Table body • Table row • Table cell When the method finds a structure element for one of these objects, it returns an empty structure Find() TextRange and sets . In this case, you can get the document’s...
Page 541
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Void Syntax SetElementRange(propNum, setVal) Parameters Parameter name Data Type Optional Description propNum The property to set. Specify an ESTK defined property, such as ElementSelection setVal The element range to which the property must be set.
Page 542
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Invalid document. Constants.FE_BadDocId (-2) Constants.FE_WrongProduct (-60) Product does not support the operation. Could not allocate memory. Constants.FE_SystemError (-42) Returns Syntax UpdateVariables() TrackChangesAcceptAll Description Accepts all the track changes in the specified document.
Page 543
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary UpdateXRef Description Updates the cross-references in a document. It performs the same operation as clicking Update in the Cross-Reference window. You can OR the values listed in the following tables into the argument. updateXRefFlags...
Page 544
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax Save(saveAsName, saveParams, saveReturnParams) Parameters Parameter name Data Type Optional Description saveAsName The path for saving the document or book. string saveParams PropVals A property list that tells FrameMaker how to save the file and how to respond to errors and other conditions.
Page 545
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Invalid document. Constants.FE_BadDocId (-2) Constants.FE_ReadOnly (-6) Document is read-only. Boolean conditional expression string is invalid. Constants.FE_BadName (-33) Returns Syntax AddNewBuildExpr(exprName, exprCondition) Parameters Parameter name Data Type Optional Description exprName string The name of the Boolean conditional expression.
Page 546
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetActiveBuildExpr Description Applies the Boolean conditional expression to the document. The method returns , on success. FE_Success On failure, the method sets to one of the following values: FA_errno Error Reason Invalid document. Constants.FE_BadDocId (-2) Constants.FE_ReadOnly (-6)
Page 547
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Invalid document. Constants.FE_BadDocId (-2) Constants.FE_BadName () The parameter specified by exprName is invalid. Returns string Syntax GetBuildExpr(exprName) Parameters Parameter name Data Type Optional Description exprName The name of Boolean conditional expression. string...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps Description method sets the properties of the Doc object. SetProps() SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The property list.
Page 549
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason This attribute is required, but it has no value assigned to it. Constants.FV_AV_REQUIRED (1) Constants.FV_AV_INVALID_CHOICE (2) At least one value for the attribute is not one of the allowed choices. The attribute value is of the wrong type for the attribute.
Page 550
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns TextItems Syntax GetText(flags) Parameters Parameter name Data Type Optional Description flags Denotes the various bit flags that specify the items to be retrieved. GetProps Description Retrieves the properties of the element object. GetProps under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary ObjectValid under the AFrame class for more information. Returns Syntax ObjectValid() ElementCatalogEntries An Array of ElementCatalogEntry objects with integer indexing and a length property. concat Description The original array is unchanged. If an array is provided as a parameter to concat(), each of its elements are appended as separate array elements at the end of the new array.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary push Description Returns the new length of the array. Returns number Syntax push(value) Parameters Parameter name Data Type Optional Description value ElementCata The value to be pushed. logEntry ElementCatalogEntry ElementCatalogEntry Description Describes a catalog entry in an Element Catalog in FrameMaker.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary If no flags are set, the element is invalid at its current position. ElementDef NewTextFmtRules Description Creates a object. The method allows you to associate the created object with a specified property of the TextFmtRules parent object.
Page 554
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadDocId(-2) Invalid document. Constants.FE_BadObjId(-3) Invalid object. Constants.FE_BadNew(-23) Object cannot be created. Constants.FE_BadPropNum(-4) The property number is invalid. Constants.FE_WrongProduct(-60) Current product interface is not Structured Framemaker. Returns FmtRule Syntax NewObjectFmtRules() NewPrefixRules Description Creates a object.
Page 555
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary The following table shows the parent object and the type of the object created by the method: Parent Type of Object Number of Instances That Can be Created ElementDef FmtRule Multiple The method returns the created object, on success. On failure, the method assigns one of the following values to...
Page 556
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax NewFirstPgfRules() NewLastPgfRules Description Creates a object. LastPgfRules The following table shows the parent object and the type of the object created by the method: Parent Type of Object Number of Instances That Can be Created...
Page 557
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax ElementDefIsText() NewElement Description Creates a structural element in a FrameMaker document. (FO_Element) inserts the new element at the specified location in text, using the specified element definition. NewElement() For object (noncontainer) elements, inserts the appropriate type of object for the element. If there is a...
Page 558
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary NewElementInHierarchy Description Creates a structural element ( ) at a specified location in the element hierarchy of a structured FrameMaker FO_Element document or book. To create the root element for a book, you must use .
Page 559
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary WrapElement Description Inserts a structural element around the selected text and structural elements in a document. If the flow that contains the selection is unstructured and the selection does not include the entire flow contents,...
Page 560
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Constant Value Constants.FV_AT_UNIQUE_IDREFS (9) One or more references to UniqueID attributes. On failure, the method returns one of the following values to FA_errno Error Reason Invalid document. Constants.FE_BadDocId (-2) Constants.FE_WrongProduct (-60) Current product interface is not Structured FrameMaker.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps Description method sets the properties of an element definition. SetProps() SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The property list.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description parent Element Parent element. child Child element. Element offset Offset within the child or parent element. ElementRange ElementRange Description A structure specifying an element’s range. Returns ElementRange...
Page 563
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetProps Description Retrieves the properties of an ellipse. GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description Sets the properties of an ellipse. SetProps under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary FilterArgs FilterArgs Description FilterArgs stores information that is used in the notification for a file-to-file filter ( ). The FA_Note_FilterFileToFile notification handler receives a pointer to this structure. Returns FilterArgs Definition FilterArgs{infile, outfile, clname, informat, outformat, binname, args}...
Page 565
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetText Description Gets the text from the flow. GetText under the Cell class for more information. Returns TextItems Syntax GetText(flags) Parameters Parameter name Data Type Optional Description flags Denotes the various bit flags that specify the items to be retrieved.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description setVal PropVals The property list. ObjectValid Description Returns if the flow is valid, else returns True False ObjectValid under the AFrame class for more information. Returns Syntax...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps Description Sets the properties of a format change list. SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The property list. PropVals...
Page 568
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadDocId(-2) Invalid document. Constants.FE_BadObjId(-3) Invalid object. Constants.FE_BadNew(-23) Object cannot be created. Constants.FE_BadPropNum(-4) The property number is invalid. Constants.FE_WrongProduct(-60) Current product interface is not Structured Framemaker. Returns FmtRuleClause Syntax NewFmtRuleClauses() Delete Description Deletes a format rule.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal PropVals The property list. ObjectValid Description Returns if the format rule is valid, else returns True False ObjectValid under the AFrame class for more information.
Page 570
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_WrongProduct(-60) Current product interface is not Structured Framemaker. Returns FmtRule Syntax NewSubFmtRule() NewFmtChangeList Description Creates a object. FmtChangeList The following table shows the parent object and the type of the object created by the method:...
Page 571
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax Delete() GetProps Description Retrieves the properties of a format rule clause. GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description Sets the properties of a format rule clause.
Page 572
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Delete Description Deletes a footnote. Delete under the AFrame class for more information. Returns Syntax Delete() GetText Description Gets the text from the footnote. GetText under the Cell class for more information. Returns TextItems...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps Description Sets the properties of a footnote. SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The property list. PropVals ObjectValid Description...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax Font(family, variation, weight, angle) Parameters Parameter name Data Type Optional Description family Index of the font family. uint variation uint Index of the font variation. weight Index of the font weight. uint angle uint Index of the font angle.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary push Description Pushes the font on the array and the returns the new length of the array. Returns number Syntax push(value) Parameters Parameter name Data Type Optional Description value Font Group A Group object represents a set of grouped objects. Group objects have the following methods.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps Description Sets the properties of the group. SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The property list. PropVals ObjectValid Description...
Page 577
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps Description Sets the properties of the hidden page. SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The property list. PropVals ObjectValid...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax ApplyPageLayout(srcPage) Parameters Parameter name Data Type Optional Description srcPage PageObject The page to which the layout must be applied. Inset GetIntByName Description Queries an integer facet. uses a transaction model to query facets. After you have finished a series of queries, you must...
Page 579
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetMetricByName Description Queries a metric facet. uses a transaction model to query facets. After you have finished a series of queries, you must GetMetricByName() commit the transaction by calling to query a facet named GetIntByName() "...
Page 580
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Invalid document. Constants.FE_BadDocId (-2) Constants.FE_BadObjId (-3) Invalid object. Specified property name is invalid. Constants.FE_BadPropNum (-4) Constants.FE_BadPropType (-5) Incorrect property type. Current FrameMaker does not support this operation. Constants.FE_WrongProduct (-60) Note: The returned object references memory that is allocated by the API.
Page 581
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description propName string The name of the facet to set. setVal The value to which the facet must be set. SetMetricByName Description Sets a metric facet. uses a transaction model to set facets. After you have finished setting facets, you must commit...
Page 582
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary To set a UBytes facet: Call to set the facet data. SetUBytesByName() If you are setting a facet with less than 10K of data, you need to call only once. SetUBytesByName() If you are setting the facet with more than 10K of data, you should call...
Page 583
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary DeletePropByName Description Deletes an inset facet. Except for inset facets, all properties are identified by integer constants. Facets are the only properties identified by name. The method does not return anything on success. On failure, the method returns one of the following values to...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal PropVals The property list. ObjectValid Description Returns if the inset is valid, else returns True False ObjectValid under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Description Removes the last element from the array. Returns Syntax pop() push Description Returns the new length of the array. Returns number Syntax push(value) Parameters Parameter name Data Type Optional Description value Line Delete Description Deletes a line.
Page 586
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetProps Description Retrieves the properties of the line. GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description Sets the properties of the line. SetProps under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Marker Delete Description Deletes a marker. Delete under the AFrame class for more information. Returns Syntax Delete() GetProps Description Retrieves the properties of the marker. GetProps under the AFrame class for more information. Returns...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary ObjectValid Description Returns if the marker is valid, else returns True False ObjectValid under the AFrame class for more information. Returns Syntax ObjectValid() MarkerType Delete Description Deletes a marker type. Delete under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal PropVals The property list. ObjectValid Description Returns if the marker type is valid, else returns...
Page 590
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description Sets the properties of the master page. SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax ApplyPageLayout(srcPage) Parameters Parameter name Data Type Optional Description srcPage PageObject The page to which the layout is to be applied. Math Delete Description Deletes a math object. Delete under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal PropVals The property list. ObjectValid Description Returns if the math object is valid, else returns True False ObjectValid under the AFrame class for more information.
Page 593
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary If you call and specify the name of a command that is already defined in the user’s menu DefineAndAddCommand() configuration files, FrameMaker gives precedence to the definition in the configuration files. If the configuration files assign a label or a shortcut to the command, then FrameMaker uses it instead of the one you specify.If the command is already a menu item, FrameMaker ignores the menu that you specify and leaves the menu...
Page 594
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary AddCommandToMenu Description Adds a FrameMaker product command or a client-defined command to a menu. adds the command at the bottom of the specified menu. To change a command’s position on AddCommandToMenu() a menu, set its properties.
Page 595
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Type of menu or menu bar How FrameMaker implements the FrameMaker product adds the menu you are adding a menu to added menu Menu bar Pull-down menu At the right of the menu bar.
Page 596
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary FrameMaker menubar Menubar string Menu bar for documents (quick menus) !QuickMakerMainMenu Menu bar for documents (custom menus) !CustomMakerMainMenu Menu bar for books (complete menus) !BookMainMenu Menu bar for books (quick menus) !QuickBookMainMenu Structure menu bar (structured product interface only) !StructureViewMainMenu Pop-up menu for documents (complete menus;...
Page 597
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax DefineAndAddMenu(name, label) Parameters Parameter name Data Type Optional Description name A unique name for the new menu. If the user or an ESTK client string has already defined a command or menu with this name, the new menu replaces it.
Page 598
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax Delete() GetProps Description Retrieves the properties of the menu or menu item. GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description Sets the properties of the menu or menu item.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax ObjectValid() Delete Description Deletes a menu or menu item. Delete under the AFrame class for more information. Returns Syntax Delete() MenuItemSeparator GetProps Description Retrieves the properties of the menu item separator. GetProps under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description setVal PropVals The property list. ObjectValid Description Returns if the menu item spearator is valid, else returns True False ObjectValid under the AFrame class for more information.
Page 601
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax concat(value) Parameters Parameter name Data Type Optional Description value Can also be arrays. Metrics Description Removes the last element from the array. Returns Syntax pop() push Description Returns the new length of the array.
Page 602
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax Delete() GetText Description Gets the text from the paragraph. GetText under the Cell class for more information. Returns TextItems Syntax GetText(flags) Parameters Parameter name Data Type Optional Description flags Denotes the various bit flags that specify the items to be retrieved.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The property list. PropVals ObjectValid Description Returns if the paragraph is valid, else returns True False ObjectValid under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax GetProps() SetProps Description Sets the properties of the paragraph format. SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The property list.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax Point(x, y) Parameters Parameter name Data Type Optional Description X coordinate Y coordinate Points An Array of Point objects with integer indexing and a length property. concat Description The original array is unchanged. If an array is provided as a parameter to concat(), each of its elements are appended as separate array elements at the end of the new array.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary push Description Returns the new length of the array. Returns number Syntax push(value) Parameters Parameter name Data Type Optional Description value Point The value to push into the array. Polygon Delete Description Deletes a polygon.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps Description Sets the properties of the polygon. SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The property list. PropVals ObjectValid Description...
Page 608
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetProps Description Retrieves the properties of the polyline. GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description Sets the properties of the polyline. SetProps under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary PropIdent PropIdent Description PropIdent provides a property identifier. Properties can be identified by either a name or a number (integer constant). ESTK provides defined constants for property numbers (for example, Fill and Height). Only inset properties (facets) are identified by names.If a property is identified by a name,...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary PropVals An Array of PropVal objects with integer indexing and a length property. concat Description The original array is unchanged. If an array is provided as a parameter to concat(), each of its elements are appended as separate array elements at the end of the new array.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description value PropVal The value to push into the array. Rectangle Delete Description Deletes a rectangle. Delete under the AFrame class for more information. Returns Syntax Delete() GetProps Description Retrieves the properties of the rectangle.
Page 612
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description setVal PropVals The property list. ObjectValid Description Returns if the rectangle is valid, else returns True False ObjectValid under the AFrame class for more information. Returns Syntax...
Page 613
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps Description Sets the properties of the reference page. SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The property list. PropVals ObjectValid...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description srcPage PageObject The page to which the layout is to be applied. RoundRect Delete Description Deletes a round rectangle. Delete under the AFrame class for more information.
Page 615
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description setVal PropVals The property list. ObjectValid Description Returns if the rounded rectangle is valid, else returns True False ObjectValid under the AFrame class for more information. Returns...
Page 616
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadParameter (-43) Parameter has an invalid value. Returns Syntax AddRows(direction, numNewRows) Parameters Parameter name Data Type Optional Description direction The direction from the reference row in which to add rows. numNewRows The number of rows to add.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal PropVals The property list. ObjectValid Description Returns if the row is valid, else returns...
Page 618
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetText2 Description Gets the text from all the objects available to , as well as an extended set of document objects that includes GetText() the rubi object. can be one of the following constants (in addition to the constants returned by TextItems.dataType...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax GetProps() SetProps Description Sets the properties of the rubi object. SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal The property list.
Page 620
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax Delete() GetProps Description Retrieves the properties of the ruling format. GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description Sets the properties of the ruling format. SetProps under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Strings An Array of objects with integer indexing and a length property. concat Description The original array is unchanged. If an array is provided as a parameter to concat(), each of its elements are appended as separate array elements at the end of the new array.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description value string The value to push into the array. SubCol Delete Description Deletes a subcol object. Delete under the AFrame class for more information. Returns Syntax Delete()
Page 623
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns PropVals Syntax GetProps() SetProps Description Sets the properties of the subcol object. SetProps under the AFrame class for more information. Returns Void Syntax SetProps(setVal) Parameters Parameter name Data Type Optional Description setVal PropVals The property list.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Constant Tab Type Constants.FV_TAB_LEFT (0x1) Left tab. Constants.FV_TAB_CENTER (0x2) Center tab. Constants.FV_TAB_RIGHT (0x3) Right tab. Constants.FV_TAB_DECIMAL (0x4). Decimal tab. Constants.FV_TAB_RELATIVE_LEFT (0x5) Relative left tab (allowed only for format change lists). Constants.FV_TAB_RELATIVE_CENTER (0x6) elative center tab (allowed only for format change lists).
Page 625
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description value Tabs Can also be arrays. Description Removes the last element from the array. Returns Syntax pop() push Description Returns the new length of the array. Returns...
Page 626
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadParameter (-43) A parameter specified is invalid. Constants.FE_BadObjId (-3) Invalid object. Constants.FE_BadOperation (-27) The method specified an invalid operation. Returns Syntax AddCols(refColNum, direction, numNewCols) Parameters Parameter name Data Type Optional Description refColNum The column at which to start adding columns.
Page 627
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description delColNum The first column to delete. Columns are numbered from left to right, starting with 0. numDelCols The number of columns to delete. DeleteRows Description Deletes rows from a table. Like the Delete command in the FrameMaker product user interface, DeleteRows() does not allow you to delete more than one type of row at time.
Page 628
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary To select an entire table, including the table title, set the topRow parameter to Constants.FF_SELECT_WHOLE_TABLE ignores the values for the other parameters. (0x80000000) MakeTblSelection() Note: cannot select different types of rows at the same time, unless you set...
Page 629
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetProps Description method retrieves the properties of the specified table. GetProps() GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description method sets the properties of the specified table. SetProps() SetProps under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary TblFmt The API uses an object to represent each table format in a document. FO_TblFmt Delete Deletes the specified table format. See “Delete” on page 412 under the AFrame class. GetProps See “GetProps” on page 412 under the AFrame class.
Page 631
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax GetText(flags) Parameters Parameter name Data Type Optional Description flags Denotes the various bit flags that specify the items to be retrieved. GetProps Description method retrieves the properties of the specified text frame. GetProps() GetProps under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax ObjectValid() TextItems An Array of TextItem objects with integer indexing and a length property. concat Description The original array is unchanged. If an array is provided as a parameter to concat(), each of its elements are appended as separate array elements at the end of the new array.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns number Syntax push(value) Parameters Parameter name Data Type Optional Description value TextItem The value to push into the array. TextLine Delete Description Deletes the specified text line. Delete under the AFrame class for more information.
Page 634
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetProps Description method retrieves the properties of the specified text line. GetProps() GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description method sets the properties of the specified text line.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary TextLoc TextLoc Description TextLoc specifies a location within the text of a paragraph or a graphic text line. Returns TextLoc Syntax TextLoc(obj, offset) Parameters Parameter name Data Type Optional Description FO_Pgf or FO_TextLine object.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary TiApiClient object represents text imported by an FDK client. FO_TiApiClient GetText See “GetText” on page 452 under the Cell class. GetProps See “GetProps” on page 412 under the AFrame class. SetProps See “SetProps” on page 413 under the AFrame class.
Page 637
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary UpdateTextInset Description Updates the contents of a stale text inset. It determines whether an inset is stale by comparing the inset’s LastUpdate property with the modification date of the inset’s source file. does not update a text inset unless UpdateTextInset() it is stale.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary DeletePropByName Description Deletes an inset facet. Except for inset facets, all properties are identified by integer constants. Facets are the only properties identified by name. fails, the API assigns one of the following values to...
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary DeleteTextInsetContents DeleteTextInsetContents under the TiApiClient class. UpdateTextInset UpdateTextInset under the TiApiClient class. ConvertToText Description This method is called upon a text inset (Examples: ) object and converts TiApiClient TiFlow TiText TiTextTable it to a text. This method deletes the text inset and removes the locked text range around it without modifying the content.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary DeleteTextInsetContents DeleteTextInsetContents under the TiApiClient class. UpdateTextInset UpdateTextInset under the TiApiClient class. ConvertToText Description This method is called upon a text inset (Examples: ) object and converts TiApiClient TiFlow TiText TiTextTable it to a text. This method deletes the text inset and removes the locked text range around it without modifying the content.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary DeleteTextInsetContents DeleteTextInsetContents under the TiApiClient class. UpdateTextInset UpdateTextInset under the TiApiClient class. ConvertToText Description This method is called upon a text inset (Examples: ) object and converts TiApiClient TiFlow TiText TiTextTable it to a text. This method deletes the text inset and removes the locked text range around it without modifying the content.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description value TypedVal Can also be arrays. Description Removes the last element from the array. Returns TypedVal Syntax pop() push Description Returns the new length of the array.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns UBytes Syntax concat(value) Parameters Parameter name Data Type Optional Description value UBytes Can also be arrays. Description Removes the last element from the array. Returns uint Syntax pop() push Description Returns the new length of the array.
Page 644
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary concat Description The original array is unchanged. If an array is provided as a parameter to concat(), each of its elements are appended as separate array elements at the end of the new array. Returns a new array, the result of concatenation the given values to the end of the original array.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary UnanchoredFrame Delete Description Deletes the specified unanchored frame. Delete under the AFrame class for more information. Returns Syntax Delete() GetProps Description method retrieves the properties of the specified unanchored frame. GetProps() GetProps under the AFrame class for more information.
Page 646
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary ObjectValid Description Returns if the unanchored frame is valid, else returns True False ObjectValid under the AFrame class for more information. Returns Syntax ObjectValid() Delete Description Deletes the specified var object. Delete under the AFrame class for more information.
Page 647
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetProps Description method retrieves the properties of the specified var object. GetProps() GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description method sets the properties of the specified var object.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary VarFmt Delete Description Deletes the specified varfmt object. Delete under the AFrame class for more information. Returns Syntax Delete() GetProps Description method retrieves the properties of the specified varfmt object. GetProps() GetProps under the AFrame class for more information.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary ObjectValid Description Returns if the varfmt object is valid, else returns True False ObjectValid under the AFrame class for more information. Returns Syntax ObjectValid() XRef Delete Description Deletes the specified XRef object. Delete under the AFrame class for more information.
Page 650
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetProps Description method retrieves the properties of the specified XRef object. GetProps() GetProps under the AFrame class for more information. Returns PropVals Syntax GetProps() SetProps Description method sets the properties of the specified XRef object.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary XRefFmt Delete Description Deletes the specified XRefFmt object. Delete under the AFrame class for more information. Returns Syntax Delete() GetProps Description method retrieves the properties of the specified XRefFmt object. GetProps() GetProps under the AFrame class for more information.
Page 652
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary ObjectValid Description Returns if the XRefFmt object is valid, else returns True False ObjectValid under the AFrame class for more information. Returns Syntax ObjectValid() Close See “Close” on page 430 under the Book class.
Page 653
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetNamedBook Description Gets the book object with a specified name. If this method fails, the API assigns the following value to FA_errno Error Meaning Constants. FE_NameNotFound (-20) The book with the specified name does not exist.
Page 654
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary If this method fails, the API assigns the following value to FA_errno Error Meaning Constants. A menu with the specified name does not exist. FE_NameNotFound (-20) Returns Menu Syntax GetNamedMenu(name) Parameters Parameter name Data Type...
Page 655
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Meaning Specified name for the new object is invalid. FE_BadName(-33) FE_BadNew (-23) Object cannot be created. Specified name for the new object belongs to an existing object. FE_DupName(-32) Returns Object Syntax NewNamedObject(objType, name)
Page 656
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary If this method fails, the API assigns one of the following values to FA_errno Error Meaning Specified name is invalid. FE_BadName(-33) FE_BadNew (-23) Command cannot be created. Specified name for the new command belongs to an existing command.
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary If this method fails, the API assigns one of the following values to FA_errno Error Meaning Specified name is invalid. FE_BadName(-33) FE_BadNew (-23) Menu item separator cannot be created. Specified name for the new menu item separator belongs to an existing menu item FE_DupName(-32) separator.
Page 658
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Constant Value Constants.FF_ALERT_CONTINUE_WARN (3) Displays the OK button with a warning indicator. Constants.FF_ALERT_YES_DEFAULT (4) Displays the Yes and No buttons; Yes is the default. Constants.FF_ALERT_NO_DEFAULT (5) Displays the Yes and No buttons; No is the default.
Page 659
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_NameNotFound (-20) There is no client with the specified name in the current FrameMaker productsession. Constants.FE_BadParameter (-43) For the TableSort client only: One of the arguments is invalid. For example, you gave a value for the sort key that is greater than the number of columns or rows in the current table selection, or you have no table cells selected.
Page 660
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_Transport (-1) A transport error occured. Returns string Syntax ClientDir() ClientName Description Returns the registered name of the current client (the client that calls ClientName() Note: Use Free() to free the string returned by ClientDir() when you are done with it.
Page 661
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns Syntax CustomDoc(width, height, numCols, columnGap, topMargin, botMargin, leftinsideMargin, rightoutsideMargin, sidedness, makeVisible) Parameters Parameter name Data Type Optional Description width The document page width. height The document page height. numCols The default number of columns.
Page 662
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_SystemError (-42) System error. Returns Menu Syntax DefineMenu(name, label) Parameters Parameter name Data Type Optional Description name string A unique name for the menu. If the user or an ESTK client has already defined a command or menu with this name, the new menu replaces it.
Page 663
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary FamilyFonts Description Returns a object with the permutations of angles, variations, and weights available for a specified font family. Fonts Returns Fonts Syntax FamilyFonts(family) Parameters Parameter name Data Type Optional Description family The index of the font family (in the list of fonts in the session).
Page 664
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary GetEncodingForFont Description Returns the encoding that FrameMaker uses for a specific font with a specific combination of weight, angle, and variation. Returns one of the following strings indicating the encoding for the font: Value...
Page 665
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Returns PropVals Syntax GetOpenDefaultParams() GetPropIndex Description Gets the index of a property-value pair (PropVal structure) within a property list. ) is a convenience GetPropIndex( routine that makes it easier to manipulate the properties in a property list.
Page 666
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Values AutoBackupOnSave Specifies whether to create a backup file. The value is one of: • Constants.FV_SaveUserPrefAutoBackup(2) - Follow preference specified by the session’s property. AutoBackup • Constants.FV_SaveYesAutoBackup(0) - Make a backup. • Constants.FV_SaveNoAutoBackup(1) - Do not make a backup.
Page 667
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Values ModDateChanged The file has changed since the last time it was opened or saved in the current session. Somebody else has probably modified the file. The value is one of: • Constants.FV_DoCancel(0) - Cancel the Save operation.
Page 668
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Property Values SaveMode Specifies whether to use Save or Save As mode. The value is one of: • Constants.FV_ModeSaveAs(1) - Use Save As mode. • Constants.FV_ModeSave(0) - Use Save mode. SaveTextExtraBlankLineAtEOP Specifies whether to add an extra line at the end of each paragraph if the file is being saved as Text Only.
Page 669
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary On failure, the method sets the field of the returned structure to 0. Returns PropVals Syntax GetSaveDefaultParams() GetSupportedEncodings Description Returns the font encodings supported for the current session. The following strings indicate the encoding for fonts:...
Page 670
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary parameter can be set to one of the following values: encodingName Value Meaning FrameRoman Roman Text. JISX0208.ShiftJIS Japanese Text. BIG5 Traditional Chinese Text. GB2312-80.EUC Simplified Chinese Text. KSC5601-1992 Korean Text. Returns if the specified encoding is supported for the current session, else returns...
Page 671
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description pathname string The pathname of the menu customization file to load. If you specify only a filename, the function looks in the client directory. silent is set to False, the pathname specified by pathname is used as the default in the Menu Customization File dialog box.
Page 672
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Event Notification Point Notification Constant XML document opened • • Before checking the type of file to be Constants.FA_Note_PreFileType (9) opened • Constants.FA_Note_PostFileType (10) • After checking the type of file to be •...
Page 673
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Event Notification Point Notification Constant Document saved as PDF • • Before specifying Acrobat settings and Constants.FA_Note_PreSaveAsPDFDialog (71) generating PostScript • Constants.FA_Note_PostSaveAsPDFDialog (72) • After specifying Acrobat settings and • Constants.FA_Note_PreDistill (73) generating PostScript •...
Page 674
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Event Notification Point Notification Constant FrameMaker product updates When the client needs to update insets that Constants.FA_Note_UpdateAllClientTi (36) all text insets belong to it FrameMaker product updates When the client needs to update a specified Constants.FA_Note_UpdateClientTi (37)
Page 675
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Event Notification Point Notification Constant Structural element dragged • • Before the element is dragged Constants.FA_Note_PreDragElement (58) • • After the element is dragged Constants.FA_Note_PostDragElement (59) An attribute value is set • • Before the attribute value is set Constants.FA_Note_PreSetAttrValue (62)
Page 676
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_Transport (-1) A transport error occurred. Constants.FE_BadOperation (-27) Clipboard stack is empty. Returns Syntax PopClipboard() Parameters Parameter name Data Type Optional Description NULL Void PrintFAErrno Description Prints the current error status, represented by the global variable, .
Page 677
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary PrintImportStatus Description Prints status flags returned by . It is useful for debugging your clients. Import() Returns Void Syntax PrintImportStatus(p) Parameters Parameter name Data Type Optional Description PropVals The property list that Import() returns in...
Page 678
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description PropVal The property to print. PrintPropVals Description Prints the values in a specified property list. It is useful for debugging your clients. Returns Void Syntax PrintPropVals(p) Parameters...
Page 679
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax PrintTextItem(textItem) Parameters Parameter name Data Type Optional Description textItem The text item to print. TextItem PrintTextItems Description Prints the text in a specified set of text items ( structure). It is useful for debugging clients.
Page 680
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary On failure, the method assigns the following value to FA_errno Error Reason Constants.FE_Transport (-1) A transport error occurred. Returns Void Syntax PushClipboard() Parameters Parameter name Data Type Optional Description NULL Void ReturnValue Description Sets a return value for a client-defined callback. The method allows a client to provide status information to the FrameMaker product or client that called the callback.You can call this method in the following callbacks:...
Page 681
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Notification Values that client can pass to Meaning ReturnValue() Constants.FA_Note_DisplayClientTiDialog (35) Constants.FR_DisplayedTiDialog (-10002) The client has displayed its version of the Text Inset Properties dialog box. Constants.FA_Note_PreSaveAsPDFDialog (71) • • Constants.FR_CancelOperation (-10001) Cancel the Save As PDF operation.
Page 682
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary ShutDown Description Closes an ESTK client’s connection. Returns Void Syntax ShutDown(_) Parameters Parameter name Data Type Optional Description Void NULL SimpleNewDoc Description Creates a new document from a specified template. Note: If you call...
Page 683
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary is useful for clients that conduct extensive processing that the user may want to cancel. For example, if UserCancel() your client processes all the documents in a book, it can call after it processes each document.
Page 684
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description fileName string The absolute pathname of the file to open. interactive Specifies whether the FrameMaker product displays messages and warnings to the user. instructs the FrameMaker True product to display messages and warnings.
Page 685
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_BadParameter (-43) One of: • tomenu menu have the same values • is not previously defined tomenu • is not a menu tomenu Returns Syntax AddMenu(toMenu, menu, label) Parameters Parameter name Data Type...
Page 686
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary MenuExists Description Indicates whether a specified menu exists. The method returns if the menu exists or if the menu does not exist. True False Returns Syntax MenuExists(menu) Parameters Parameter name Data Type Optional Description menu The menu to be checked for existence.
Page 687
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description Void Null PrintExportStatus Description Returns Void Syntax PrintExportStatus(p) Parameters Parameter name Data Type Optional Description PropVals ErrorName Description Returns the string corresponding to the value of FA_errno...
Page 688
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax PrintErrno(i) Parameters Parameter name Data Type Optional Description NotificationName Description Returns string Syntax NotificationName(i) Parameters Parameter name Data Type Optional Description AllocatePropVals Description Allocates memory for a property list. On success, the method returns a property list (a data structure).The returned...
Page 689
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Open Description Opens a document or book. It can also create a new document. allows you to specify a property list telling FrameMaker how to open or create the file and how to deal with Open() error and warning conditions.
Page 690
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary FS_OpenNativeError and FA_errno values Possible FS_OpenStatus flags Constants.FE_Success (0) (file was opened) • Constants.FV_FileHasNewName (32) - Filename was changed from the name specified in call. Open() • Constants.FV_RecoverFileUsed (33) - Recover file was present, and it was used.
Page 691
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary FS_OpenNativeError and FA_errno values Possible FS_OpenStatus flags Constants.FE_BadParameter (-43) (file was not • Constants.FV_FileHadStructure(64) - File had FrameMaker features, but current opened) FrameMaker product is not FrameMaker. • Constants.FV_FileAlreadyOpenThisSession (65) - File is already open and script disallowed opening another copy.
Page 692
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary FS_OpenNativeError and FA_errno values Possible FS_OpenStatus flags Constants.FE_Canceled (-44) (file was not • Constants.FV_CancelUseRecoverFile (96) - A recover file was present, so the user or the opened) Open() script canceled the Open operation. •...
Page 693
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary FS_OpenNativeError and FA_errno values Possible FS_OpenStatus flags • • Constants.FE_Success (0) Constants.FV_LockWasReset (0) - File lock was reset. • • Constants.FE_Canceled (-44) Constants.FV_LockNotReset (1) - File had a lock that was not reset. •...
Page 694
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Error Reason Constants.FE_Transport (-1) The user clicked Cancel, or a transport error occurred. Returns Syntax ScrollBox(title, stringslist, _default) Parameters Parameter name Data Type Optional Description title string The title that appears on the dialog box.
Page 695
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Parameters Parameter name Data Type Optional Description title string The message that appears in the dialog box. directory The default directory when the dialog box is first displayed. If string you specify an empty string, the last directory used by an ESTK client is used.
Page 696
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary does not assign a value to if the user clicks Cancel. PromptMetric() *metricp dialog boxes behave like metric dialog boxes in the user interface.If the user types a number followed PromptMetric() by a string that represents a unit (for example 10pts or 5"), the method converts the number into the equivalent number of metric units.
Page 697
ADOBE FRAMEMAKER SCRIPTING GUIDE Function Summary Syntax PromptString(message, stuffVal) Parameters Parameter name Data Type Optional Description message The message that appears in the dialog box. It must be 255 string characters or less.Newline and linefeed characters are ignored. stuffVal string The default value that appears in the input field when the dialog box is first displayed.