Related Titles: Search Document

6/14/23, 3:23 PM Script Guide | PDF | Parameter (Computer Programming) | Scripting Language
 Search document 
Related titles

https://www.scribd.com/document/20045985/Script-Guide# 1/503



Adobe ®
PageMaker 7.0 ®
Related titles
Script Guide.PDF

Related titles




o e ystems ncorporate an ts censors. r g ts reserve .
PageMaker 7.0 Script Language Guide for Windows and Macintosh
This manual, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. The c
manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Adobe Systems Incorporate
tems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in this book.
Except as permitted by such license, no part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, elec
ical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated.
Adobe, the Adobe logo, and Adobe PageMaker are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other co
Macintosh, and Mac OS are trademarks of Apple Computer, Inc., registered in the U.S. and other countries. Microsoft, Windows, and Windows NT are registered
Microsoft Corporation in the U.S. and/or other countries. All other trademarks are the property of their respective owners.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA
Related titles

Related titles




PageMaker Script Language Guide
How to use this reference What's in a command or query

Welcome to the PageMaker Script Language description
Guide. This guide will help you write PageMaker The description of each command and query
scripts. generally includes:
New to scripting? Read the topics in the Scripting • Syntax
section of this guide:
• A list of parameters (if any) and the values e
Introduction to scripting and the script language accepts
Working with variables • Special notes about the command or query
Writing and running scripts
• An example
Working with other scripting applications
• A list of any related commands or queries.
Command and query reference. The remainder
of this guide describes each command and query in See also:
the PageMaker script language.
Documentation and language conventions
See also:
What's in a command or query description
Related titles

Related titles




Introduction to scripting and the

script language
Documentation and language What are scripts?
conventions Scripts contain text-based commands, queries
The descriptions of each command and query and controls that automate actions you can
use the following conventions: perform in PageMaker. Commands and queri
are part of the Adobe PageMaker script
Example of con- Description language, and are similar to the PageMaker
vention
menu commands. You don't need programmi
Open, MultiplePaste Script-language commands and experience to understand basic scripting. A so
queries appear in uppercase and working knowledge of PageMaker is the key.
lowercase.
Scripts are the ideal way to automate repetitiv
cCopyWhat Command parameters appear as a
word (or words merged together) tasks in PageMaker. For example, a script mig
preceded by a lowercase letter. Com- automate the following tasks:
mand parameters usually corre-
spond to dialog-box options. The let- • Defining standard master pages, styles, and
ter before the word indicates the colors
data type of the parameter (see
Parameter types). • Placing ruler guides
[bFacingPages] Optional parameters appear inside • Importing a logo
square brackets.
The following is a script that tells PageMaker t
[bProp[, bBestSize]] Conditionally optional parameters create a new 12-page publication with a page
appear in nested brackets. The outer
parameters are optional only when of 9 inches by 11 inches, set margins, make the
the inner parameters are not needed. pages double-sided, and then save the
In this example, bProp is optional document:
only if you don't specify bBestSize; if
you want to specify bBestSize, you new 12
must specify bProp.
pagesize 9i, 12i
none or 0 The values or keywords that you type pagemargins 1i, .75i, .75i, .75i
as parameters appear in bold. pageoptions 1, 1
nNumOfColors(, Parameters that repeat are enclosed saveas "Sample Document"
sColorName)... in either parenthesis (if required) or return
square brackets (if optional), and are
nNumOfStyles[, followed by an ellipsis.
sStyleName]...
See also:
See also: What is the script language?
Parameter types Script language components defined
Related titles

Related titles




ADOBE PAG
Introduction to scripting and the scri
What is the script language? If you want to write the same sort of script fo
publication that does not start on page 1, you
In the PageMaker scripting language, a command
can have the Page command calculate the pub
is a single word that tells PageMaker what to do.
cation’s last page by using an expression in pla
For example, your script may tell PageMaker to
of a single value or variable. An expression is a
open a new publication, import and place a
simple algebraic formula such as:
specific story, and style the text. Parameters are
values that control the action of the command. page (NumOfPages + StartPage - 1)
In addition to commands and parameters, the

In this example, 1 is subtracted from the total
PageMaker scripting language has the capability
NumOfPages and StartPage because pages are
to store values as variables. A variable is a word
numbered starting at one, not at zero. The par
that can be used in place of the value it stores.
of the expression that determines how to
For example, a variable such as NumOfPages
combine the variable is called an operator . In t
could be assigned the value of 10 and then be
above example, there are two operators: the
used in multiple instances in a script, as follows:
addition and subtraction symbols.
N u m O f P a ge s = 1 0
The PageMaker scripting language also suppo
n e w N u m O f P a ge s
common programming language capability
page NumOfPages
referred to as a function. A function modifies t
way a command sees the value of a parameter
This script assigns the value of 10 to be equal to
(whether it is in the form of a single value, a
the variable name NumOfPages, creates a new
variable name, or an expression) without chan
publication with 10 pages, and then goes to page
the value itself. The following is an example o
10.
command that uses a function and an express
Queries request information from PageMaker. to specify a value:
For example, a query can ask for the location of
t e x t e n t e r q u o t e ( N u m O f Pa g e s + S t a r t P a g e - 1
an element on the page, the attributes of a style,
or the number of stories in a publication. A
Because the TextEnter command requires quo
query is always followed by a set of two greater-
around the string of text to be entered, the Quo
than symbols (>>) which point to a variable
function is used to add quotes around the val
name for each returned parameter value. For
determined by the expression. It only adds them
example:
for single use, leaving the value unmodified in
new 40 other places in a script.
g e t p a g e s > > N u m O f P ag e s
Controls tell PageMaker which script command
page NumOfPages
send under a given set of conditions. By using
controls, you can set up a script to repeat a seri
In this example, the script tells PageMaker to
commands or to execute a series of command
open the very last page of a publication that
only if a variable has a specific value. Example
starts on page 1. The GetPages query asks
commonly used controls are If, Loop, Repeat,
PageMaker for the number of pages in the
Else statements.
current publication—in this case 40—which the
script specifies to put in the NumOfPages
variable. Then the Page command uses that
variable’s value as the NumOfPages parameter,
switching to that page.
Related titles

Related titles




ADOBE PAG
Sample script • GetFillAndLine returns information about t

This sample script evaluates the page size to see fill and stroke styles of the selected object.
if it is wide or tall (landscape or portrait). If the • GetLockGuides tells you whether Lock Guid
page is wide, the script switches the dimensions is selected on the Options menu.
to make the page tall. To do this, the If control Parameter. To duplicate dialog box options o
evaluates whether the value of the width variable mouse actions, many commands and a few
is greater than the value of the height variable, queries include parameters. (Dialog boxes do
which would make for a wide page. If it is, then not appear on screen when you use command
the script switches the width with the height Parameters correspond directly to the options
through a third variable, "x," to make the page the related dialog box or to page locations or
tall. If the page is already tall, then it skips the object handles normally specified by dragging
commands to switch the values, and ends: and clicking the mouse. For example:
getpagesize >> width, height
removepages 3, 5
if width > height
x = width
In this example, RemovePages corresponds to
width = height
the Layout > Remove Pages command. The fir
height = x
parameter (3) corresponds to the first page in
pagesize width, height
the range of pages to be removed, and the
endif
second parameter (5) corresponds to the last
return
page in the range of pages to be removed. The
parameters are identical to the dialog box
options.
See also:
Menu commands that open complex dialog
What are scripts? boxes may be represented by several comman
Script language components defined in the script language. The command you use
Working with variables a script depends on which options you want. F
Writing expressions example, four different script-language
commands represent the File > Document Set
Using functions
menu command:
Using controls
• PageMargins
• PageNumbers
Script language components
• PageOptions
defined
• PageSize
Command. A one-word equivalent of menu,
keyboard, or mouse actions, as well as other • PrinterResol
feature-like private data. For example, the script Control. A type of command that is used to
language equivalent for the PageMaker Control control the flow of a script and thus the
Palette menu command is ControlPalette. execution of other commands, such as If, Loo
Query. Queries ask questions about the or repeat.
PageMaker publication and use the same one- Evaluation. The result of an expression. For
word approach that commands use. Queries example, if x = 2, then the script language wou
always begin with "get." For example: evaluate the expression (x + 1) as 3.
Related titles

Related titles




ADOBE PAG
Variable: A flexible container for a value. See also:

Expression: A series of values combined using Parameter types
operators to calculate a single value. Documentation and language conventions
Operator: A mathematical function that Deciphering PageMaker replies to queries
combines a series of values.
Function: A special command that returns a Parameter types
value based on the arguments it receives.
Just as a dialog box may include several types
options, the command and query language als
See also: requires different types of parameters:
What is the script language?
• Numeric values
Command and query syntax
• Coordinates
Parameter types
Documentation and language conventions • Filenames
• Submenu, pop-up menu, and palette choice
• Text
Command and query syntax
In the command and query descriptions, each
The order in which you specify parameter values
parameter name includes a lowercase prefix. T
for a command or query is listed on the top line
prefix indicates the type of value you can use
of the description with the command or query
that PageMaker will return. The remainder of
name. You must specify parameter values in this
the name identifies the dialog box option,
order for PageMaker to correctly interpret the
mouse action, object handle, and so forth, to
command.
which the parameter relates. For example:
For example, the syntax for the RemovePages
e x p o r t fFilename, sFormat[, bTags]
command is:
removepages nFirstPage, nLastPage The following table defines each parameter
prefix and notes acceptable values:
The nFirstPage parameter corresponds to the
Remove Pages option in the Remove Pages
dialog box. The nLastPage corresponds to the
Through option.
Prefix Type Description Example
b boolean Values are: true, on, 1 and false, off , 0. Boolean parameters represent check rulers on
boxes and options that you can turn on and off (such as the display of rul-
ers, guides, or palettes).
c choice Values are keywords or their equivalent integers as indicated in the param- linestyle thindash
eter descriptions (for example, none or 0, center or 2). Choice parameters
represent radio buttons, submenu, or pop-up selections. or
Note: Do not enclose keywords in quotation marks. linestyle 13
d decimal Values are decimal numbers, generally accepted to one decimal point (for size 13.5
example, 6.2). Decimal values specify point size, leading, page size, and so
forth.
Related titles

Related titles




ADOBE PAG
Prefix Type Description Example
f filename Values are a filename. The filename must appear in quotation marks. For relink "MyDisk:Newslet-
best results, include the full path with the filename. Filenames are used ter:Art:Chart.eps"
with commands that refer to a file (such as, Place, Relink, or Open).
or
Note: For filenames in scripts intended for both the Macintosh and Win-
dows, avoid upper-ASCII characters (character number 128 and up). relink "c:\News-
Although the first 128 characters are identical in the character sets used by ltr\Art\Chart.eps"
Windows and the Macintosh, the upper-ASCII characters are not. This can
cause a problem if the character on one platform maps to a character that
is illegal for filenames on another.
n number Values are integers. Integers are used for page numbers, columns, new new 5
pages, and so forth.
s string Values are text. The text must be in quotation marks (for example, "Blue- font "Zapf Dingbats"
green"). String parameters are used for entering text, page-number pre-
fixes, and variable palette and submenu options, such as fonts, dictionar-
ies, export filters, master pages, styles, and colors.
Where the string represents a variable palette, pop-up, or submenu option,

you must capitalize, spell, and punctuate the option name exactly as it
appears on screen.
Note: To include a quotation mark within the text, precede the quotation
mark with a backslash, such as "\"Scripting is fun\" said the script writer."
The quotation mark is the only character that requires special treatment.
Note for scripts intended for both the Macintosh and Windows: While
you can enclose strings in either typographer's (curly) or straight quotation
marks, we recommend that you use straight quotation marks if your script
is to be dual-platform.
x x-coordi- Values are coordinates. You can specify coordinates as either numeric loca- move lefttop, (2p5, 3p5)
nate tions (or offsets) or references to a guide, column edge, or the edge of the
y last object drawn. Coordinates identify a location on the page, an offset, or or
y-coordi- a relative position. (For details, see Coordinates.)
nate move lefttop,(rightpage
Note for numeric coordinates: You generally specify numeric coordi- umn 2,left,column top)
nates relative to the zero point. To ensure you know the location of the zero
point, set it with either the ZeroPoint or ZeroPointReset commands. You
specify the coordinates using the current measurement system or by
including the appropriate measurement identifier with the coordinate
(such as 3p6 for 3 picas, 6 points). See Specifying the measurement system.
See also: About PMScript

Documentation and language conventions PMScript is a background application that rea
Deciphering PageMaker replies to queries your scripts and executes their instructions.
What is the script language? When you double-click on a script, PageMake
Writing expressions launches PMScript. Any PageMaker feature
commands are executed by PageMaker itself; t
remaining elements of the Pagemaker script
language, whether they are commands, contro
functions, operators, or variables, are handled
exclusively by PMScript.
Related titles

Related titles




ADOBE PAG
In addition to PMScript, there is another Deciphering PageMaker replie

background application called PMTrace that is
to queries
used in place of PMScript when you choose the
Trace command from the Scripts palette menu. When you send a query to PageMaker, it retur
PMTrace allows you to follow the progress of a information as a string of numbers or words,
script line by line for troubleshooting purposes. separated by commas. This information is
known as a reply . Depending on the query, a
The script-executing operations carried out by reply may be short or long. For example, the
PMScript and PMTrace happen automatically. If GetRoundedCorners query asks PageMaker to
you have trouble running scripts, be sure these identify the corner style of the selected object.
special applications are located in PageMaker’s PageMaker responds with a single value that
Plug-ins folder and that you have enough RAM identifies the style specified in the "Rounded
available to launch them. corners" dialog box.
On the other hand, replies can be complex. Fo
See also:
example, the GetRuleAbove query asks
What is the script language? PageMaker to identify the settings for all the
Working with variables attributes in the "Paragraph rules" dialog box
Using functions pertaining to rules above paragraphs.
Using controls PageMaker replies with a string of values, the
order of which is shown in the "Reply" section
the query description:
Dialog boxes, error messages, bOnOff, cLineStyle, sLineColor, cLineWidth
and alerts xLeftIndent, xRightIndent, dWeight, bOpaq
When a script is running, PageMaker dialog

The parameter names listed correspond to the
boxes, error messages, and alerts do not appear
dialog box options.
on the screen. This is especially important to
note in commands that PageMaker normally lets To decipher the reply, match the values that
you cancel, such as deleting pages with the PageMaker returns with the values listed in th
Layout > Remove Pages option or closing a query description. For example, let's say
publication. In a script, alert messages do not PageMaker returns these values:
appear on screen, so you have no opportunity to
1,1,"Blue-green",1,0,0,0,0
cancel commands. However, you can write
scripts in such a way that they invoke dialog
Match the return values with the table in the
boxes in order to present or to get information
GetRuleAbove description to decipher the
from the user.
PageMaker reply:
You cannot undo Script commands.
Returned Parameter Meaning
1 bOnOff Rule Above Paragraph

option is checked (or "o
1 cLineStyle The rule is a hairline.
"Blue-green" sLineColor The color is Blue-green
1 cLineWidth The rule is the width of

text.
Related titles

Related titles




ADOBE PAG
Returned Parameter Meaning Specifying the measurement system:

Individual parameters
0 xLeftIndent There is no left indent.
To override the default measurement system f
0 xRightIndent There is no right indent. a parameter, simply include a measurement
0 dWeight The stroke weight is not abbreviation with the measurement or
custom (a standard weight coordinate value. For example, if the publicati
was specified, as noted in
measurement system is picas, PageMaker
the cLineStyle parameter).
assumes the "7" in:
0 bOpaque The background is transpar-
ent. move bottom, 7
means 7 picas. To specify inches instead of pic

See also:
enter this in your script:
move bottom, 7i
Parameter types
The "i" tells PageMaker to move the object to
location 7 inches from the vertical-ruler zero
Specifying the measurement
point. Once that parameter value is processed
system PageMaker interprets values using picas again
Several commands and queries require measure- The following table lists the measurement
ments or ruler coordinates as parameter values. abbreviations you can use to override the defa
When interpreting the values you specify or measurement system:
when returning query results, PageMaker uses
the publication default measurement system (set System Abbreviation Example
in the Preferences dialog box) unless you specify Inches i after 5.625i
another system.
Millimeters m after 25m
Using the script language, you can:
Picas p after 18p
• Specify a system for an individual parameter,
Points p before p6
leaving the publication default measurement
system intact for the rest of the script. This Picas and points p between 18p6
technique is useful if you don't know (or don't Ciceros c after 5c
want to alter) the publication measurement
system. See Specifying the measurement system:
Note: Do not insert a space between the
Individual parameters.
measurement and the abbreviation.
• Specify a new default measurement system for
the publication (or, if no publications are open,
See also:
for all future publications). This technique is
useful if you want to use a particular Specifying the measurement system
measurement system for all commands and Specifying the measurement system: Publicati
queries. See Specifying the measurement system: default
Publication default.
Related titles

Related titles


ADOBE PAG
Specifying the measurement system: Coordinates

Publication default
For some commands and queries, you must u
To change the measurement system for the coordinates to specify locations on the page.
publication, use the MeasureUnits command. You can specify coordinates either:
The new measurement system becomes the
default and remains in effect after the script has
• Using numeric values (specified relative to t
run. PageMaker uses the default measurement rulers' zero point), for example:
system when interpreting measurements and move bottom, 7i
coordinates in commands (unless overridden
with a measurement abbreviation) and when • Relative to page elements, such as columns,
returning measurements and coordinates from guides, and objects, for example:
queries. move bottom, column bottom
Note: If no publication is open when you use the
MeasureUnits command, the new measurement See also:
system becomes the application default and applies
Setting the rulers' zero point
to all new publications.
Using numeric coordinates
The MeasureUnits command syntax is: Specifying locations by page elements
measureunits cMeasurement, cVertical,
dCustomPoints
Setting the rulers' zero point
The cMeasurement parameter specifies the The default position of the zero point is at the
measurement system for PageMaker to use. In upper left corner of single pages and the uppe
the following example, the cMeasurement touching corner of two-page spreads, as show
parameter in the first line changes the the following illustration.
measurement system to inches, and thus
PageMaker interprets the "7" in the second line
(for the Move command) as 7 inches from the
zero point of the vertical ruler:
measureunits inches, custom, 12
--cMeasurement value
--specifies "inches"
The zero point is moveable and is often not in
move bottom, 7 default position. It's a good idea to explicitly se
- - P a g e M a k er i n t e r p r e t s t h i s zero point location to ensure that PageMaker
--and all subsequent places objects and guides where you want them
--coordinates as inches. and to ensure that you understand the locatio
returned in query results.
See also:
Specifying the measurement system
Specifying the measurement system: Individual
parameters
Related titles

Related titles


ADOBE PAG
To position the zero point, use the ZeroPoint or Note: Although PageMaker lets you specify a
ZeroPointReset command. separate measurement system for the vertical ru
all coordinates and measurements use the
measurement system set in the Measurements I
See also:
option (or with the cMeasurement parameter of
Coordinates MeasureUnits command). For example, even if
Using numeric coordinates vertical ruler is set to inches, PageMaker interpr
Specifying locations by page elements any vertical coordinates or measurements using
default measurement system (which may not be
inches). You can override the default system by
Using numeric coordinates including an abbreviation for the desired system
Numeric coordinates represent locations in the parameter value; see S pecifying the measurem
relation to the PageMaker rulers. Using numeric system.
coordinates lets you specify a precise location
for an object. See also:
Coordinate values can be either negative or Coordinates
positive numbers. Unlike standard coordinates, Setting the rulers' zero point
PageMaker uses positive numbers to express Specifying locations by page elements
vertical locations below the zero point. Vertical
locations above the zero point are expressed as
negative numbers. Horizontal locations match Specifying locations by page
standard coordinates: Locations right of the
elements
zero point are positive and left of the zero point
are negative. You can specify coordinates in relation to elem
on the page. When you specify locations by pa
elements, the locations remain valid even after
move the rulers' zero point, move an object, o
change the publication page size or orientatio
To use this method, you refer to a column guid
object by the internal number PageMaker assig
The following examples specify parameters when it is first placed, typed, or drawn on the p
using the numeric method: • Columns are numbered from left to right on
Precise coordinate Action specified page. You specify "leftpage" or
"rightpage" (as shown in the table below) only
move top, 6i Positions the selec ted object so its
top edge is 6 inches below the zero
when the publication has facing pages.
point. • Guides are numbered in the order in which t
guidevert 4.25i Creates a vertical ruler guide 4.25 were placed on the page, regardless of their
inches to the right of the zero point. positions on the page. The first guide drawn i
deletevert 4.25i Deletes the vertical guide that is number one. If you delete a guide, PageMaker
located 4.25 inches to the right of renumbers the remaining guides.
the zero point.
Related titles

Related titles


ADOBE PAG
• Objects (text blocks and graphics) are numbered Examples:

in the order in which they were first typed or Command Action
drawn, regardless of position. The first object
placed on the page is number one. Using the move left, guide 1 Positions the left edge of the
selected object on the first guid
BringToFront, BringForward, SendBackward, or drawn on the page.
SendToBack commands changes its drawing order.
deletevert guide 3 Deletes the third vertical ruler g
If you delete an object, PageMaker renumbers the
placed on the page (regardless o
remaining objects. location).
The following table shows how to specify coordi- select (rightpage Selects the object that is on the r
nates relative to columns, guides, and objects: column 2 left, page, where the left side of the
guide 2) ond column meets with second
Location x-coordinates y-coordinates izontal guide placed on the pag
Columns column n left column top
column n right column bottom See also:

rightpage column n left Coordinates
Using numeric coordinates
leftpage column n left
rightpage column n right
leftpage column n right

Working with variables
Guides guide n guide n
Variables let you store values in your scripts,
adding a level of intelligence to an otherwise lin
Objects last left last top set of instructions. Variables can contain a sin
last right last bottom value or a list of values.
Note that: Writing variables

• "n" in the column and guide references repre- The name of a variable can be a single letter sim
sents the column or guide number. to those commonly used in algebraic formulas
such as n, I, x, y, or z. These letters are often use
• "last" in the object descriptions refers to the edge
scripting to represent a number that controls
of the last object drawn (the object with the highest
either a repeat loop or a distance measuremen
drawing order).
variable name can also be a word that describes
• If you do not specify a location, PageMaker uses value it represents, such as pagenumber , pubna
the right page by default. or filedirectory . Many times, the most logical n
for a variable is the name of the parameter fro
which it gets its value, such as NumOfPages,
Width, Height, or ParaStyle. Use the following
guidelines when writing variables:
•Write each variable name as a single word
beginning with a letter and with no spaces.
• Use either uppercase or lowercase letters, but
them consistently.
Related titles

Related titles


ADOBE PAG
• Use a unique name for a variable: it cannot be the • Parse down the values in the list by taking th
same as any command or function supported by in series using the Set command. For example
the PageMaker scripting language. VariableName >> Variable1, Variable2, Variab
VariableName. The following script uses the
GetFontList command to see if a font is availab
Assigning variables
a computer system before using it in a script.
You can assign a value to a variable in a number of repeat loop uses the Set command to parse
ways. The simplest way is to simply set the variable through the variable fontlist for a match with
name equal to the value, as in X = 5. Palatino. The ellipses are placeholder variables
Another common way to assign a variable is to use getfontlist >> NumOfFonts, fontlist
it with a query command. In this way, the value or loop x = 1, NumOfFonts
values replied by the query are assigned to a list of set fontlist >> font name, ..., ..., ..., fontlis
variables in the order in which they are listed, as in if fontname = "Palatino"
this example: getpagesize >> X, Y. For a letter-size set search >> found
page, this command would set the variable X equal endif
to 8.5, and the variable Y equal to 11. endloop
if search = found
A variable can also store a list of values, separated
message "Palatino available in current syste
with commas, such as: X = 5, 7, 9. The values listed
else
are stored in the same order in which they are
message "Palatino not available."
assigned, so that you can retrieve them later.
endif
You can also assign a list of values to a single return
variable. For example:
getobjectlist >> num, objectsinfo Search the list for a specific value using # or ?
(Includes) operators. The Includes operator
Num represents a value for the number of objects simplifies a process that would otherwise take
currently visible; objectsinfo represents a list of all several lines of instruction. The following scri
other information returned by the query. performs the same function as the previous sc
but uses the Includes operator to write a singl
expression.
Parsing variable lists
getfontlist >> NumOfFonts, fontlist -- acqu
When you want to work with a single value from a
font list
list, do one of the following:
if "Palatino" # fontlist > 0
• Follow the variable name with a number or message "Palatino available in current syste
expression in parentheses, with no space. The else
following example sets a list of values to the message "Palatino not available."
variable EvenNumbers, and then uses the fifth endif
value to go to a page: return
EvenNumbers = 2, 4, 6, 8, 10, 12, 14, 16
pageEvenNumbers(5) The Includes operator is used by first listing th
value to search for before the # mark and then
variable to search within after. The expression
calculated result will be the number of the val
position in the value list being searched for, or
equal to zero if no occurrence is found.
Related titles

Related titles


ADOBE PAG
Indexed variables Writing expressions

By placing a value (a number or string) in brackets Whenever a parameter or variable is called for
after a variable name (variablename[x]) you can script, you can instead use an expression that ca
create different variable "containers" without calculated to a single value. In this way, you can
having to create additional variable names. fewer variables with more possible results, with
With an indexed variable, a script can create having to create separate scripts just to calcula
variables to meet whatever it’s value storing needs special values. Writing expressions is just like
require, particularly when you can’t predict those writing mathematical formulas. The symbols,
needs in advance. This is useful, for example, if you commands to calculate a value with another va
are looping through every publication in a book are called operators.
list and want to get its page numbering options, The following rules outline the use of operato
then you want to apply those values in another create expressions. If PageMaker returns a syn
repeating loop. error or your script creates unexpected results
The following example demonstrates indexed could be due to an inappropriately used opera
variables: • Each expression can have as many variables,
a = "red", "blue", "green" values, and operators as needed, but must alw
b = "cyan", "magenta", "yellow", "black" have a single solution.
y = 1 • You can freely use spaces and parentheses,
loop x = 1,3 modifying the order of precedence for calcula
colors[x,y]=a(x) tions.
endloop
•Text string values must always be enclosed in
y = 2
quotation marks and can only be added, divid
loop x=1,4
and multiplied with other strings.
colors[x,y]=b(x)
endloop • Multiplied string values must contain the va
textenter colors[1,1] in the first operator and be enclosed in paren-
textenter colors[1,2] theses.
• An expression can be used in place of any si
Results: value.
textenter "red" PageMaker’s scripting language supports the
textenter "cyan" following operators:
See also: Special operators

Writing expressions • = (assigns a value)
Using functions • # (checks to see if a value includes a value; ca
Using controls the Includes operator)
• : (accompanies a value with comments)
• , (separates a list of values)
•...(a null or "throw away" variable. Must be t
periods, not an ellipsis character)
Related titles

Related titles


ADOBE PAG
Mathematical operators See also:

• + (add) Parameter types
• - (subtract) Working with variables
• * (multiply)
• / (divide) Using functions
The function of these four basic math operators is When you are working with commands and
obvious when being used with numeric values. expressions, you may want to use a value that
When strings of text are involved, however, things not be in the proper form. You can use a funct
get a bit more complicated. You can use paren- to coerce, or change, a value into another form
theses and spaces to help break up lengthy calcula- use a function, you first type the function nam
tions and to modify the order of precedence for and then, directly next to it—without a space
calculations. When multiple string values are within parentheses—the name of the variable
expressed with an addition symbol, PageMaker value to apply to it. You can use a function with
will concatenate them together, as in the following command or expression that uses a value; you
example: even use a function within a function.
X = "one" + "two" + "three" The following rules outline the use of function
PageMaker returns a syntax error or your scri
Result: creates unexpected results, it could be due to a
inappropriately used function
X = "onetwothree"
• Write each function name as a single word,
followed directly by the variable or value to be
Percent sign (Mod) operator
affected in parentheses. Don’t use any spaces.
% (percent sign)
• Use appropriate values specified in the func
This special operator, which works only with
• You can use a function with any appropriate
number values, divides the first value by the
value, in any type of expression or command.
second and returns the remainder. For example:
• Functions only affect the single use of a vari
X = 22 % 7
value; they do not change the value itself for o
Y = 21 % 7
instances in a script.
Result: The PageMaker Scripting language supports t

following functions:
X = 1
Y = 0 Empty() function: evaluates whether a variab
contains a value or is void of content. When u
it will equal a Boolean value of false if the spec
Less Than and Greater Than Operators variable evaluated contains data, or true if the
• < (less than) variable has no assigned value, as in the follow
• > (greater than) example:
These operators compare which of two given a,b = 42 -- a is assigned 42, b is left empt
values are greater. The results are always in Boolean x = empty(a) -- value will be 0
values of true or false (1 or 0). y = e m p t y (b ) - - v a lu e w i ll b e 1
Related titles

Related titles


ADOBE PAG
Not() function: reverses the value of a Boolean a = "42"

condition. This makes the value 1, or true, when a b = val(a)
variable or expression is 0, or false. When a variable
or expression is not true, the function equals 0, as Result
in the following examples:
b = 42
if not(x = 42)
m e s s a g e " Va l u e i s n o t 4 2 " List() and Unlist() functions: put quotes aroun
end if or remove quotes from, each item in a list of va
within a single variable. For example:
Result
a = 11, 19, 52
x = 0 b = list(a)
y = n o t ( x)
Result
IsNumber() function: determines if a value is a
b = "11", "19", "52"
number, which is useful when you need to make
sure that a value is legal before using it with a
ToUpper() and ToLower() functions: change th
command that requires a numerical value, as in the
case of a string value to be all uppercase or all
following example:
lowercase. For example:
x = isnumber (36)
a = "PageMaker"
y = is n um b e r (t h ir t y si x )
b = toupper(a)
Result:
Result
x = 1
b = "PAGEMAKER"
Len() function: counts the number of values in a

SubStr() function: selects a subset, or portion,
value list. For example:
string value. For example:
a = 2, "two", 4, "four", 6, "six", 8, "eight"
a = "PageMaker"
x = len(a)
b = substr(a,2,3)
Result:
Result
x = 8
b = "age"
Quote() and Unquote() functions: puts quotes

SpecialCharacter() or ^() function: used to en
around, or removes quotes from, an expression.
PageMaker’s special typesetting characters.
Allows you to put quotes around a variable, as in
the following example:
a = 42
textenter quote(a)
Str() and Val() functions: Str() turns a value into a

string, and Val() turns a string into a value. For
example:
Related titles

Related titles


ADOBE PAG
Path() function: translates file directory paths returns a pseudo-random

Rand() function:
between the Windows DOS syntax, which number between two given values. For examp
separates each level of its path with a backslash (\),
a = rand(1, 42)
and the Macintosh syntax, which uses a colon.
Used for cross-platform scripts that use path
Possible result
names. The following example will be translated to
the correct format regardless of the platform that is a = 11.1952
being used:
Sin() and Cos() functions: calculate either the
a = " P r o j e c t \ P u b s \ C h a p te r 1 "
or cosine value, in degrees, for a given value o
open path(a)
angle. For example:
Abs() function: gets the absolute value of a a = sin(36)
number, resulting in a positive value whether it is a
positive or a negative. For example: Result
a = abs(-42) a = 0.587785
Result Arctan() function: calculates the arc tangent va

in degrees, for a given value. For example:
a = 42
a = arctan(36)
Trunc() function: truncates a decimal number (or
a string with a period) to its whole value. For Result
example: a = 88.408864
a = trunc(11.11)
calculate th
Exp(), Log(), and Sqrt() functions:
Result exponential, logarithm, or square root value fo
given value. For example:
a = 11
a = sqrt(25)
Zstrip() function: strips any trailing zeros from a
fractional value. For example: Result
a = zstrip(11.1100) a = 5
Result See also:

a = 11.11 Writing expressions
Max() and Min() functions: return the largest or

smallest number in a list of values. For example:
a = max(11, 19, 5)
Result
a = 19
Related titles

Related titles


ADOBE PAG
Using controls message "The page is tall."

endif
Controls add a level of intelligence to your scripts
and allow you to automate the production of
almost any PageMaker project. PageMaker’s Nesting If controls
scripting language provides several different if width = 8.5
logical control statements common to other if height = 11
programming languages. These controls give you message "This is a letter size page."
the ability to evaluate an expression and act endif
accordingly on the result. endif
A control is used just like a command by writing its

name first, followed by a space and any parameters Loop and EndLoop: repeats a series of instru
and expressions. Many controls require an ending tions. The Loop control requires the expressio
counterpart to define the set of instructions they a variable equal to a list of two numerical value
control, such as EndIf, EndLoop, EndWhile, or the beginning and ending, for example X = 1,
Until. The control will step from the first value to th
If and EndIf: gives you the ability to say "if the second value in single, whole-number increm
value of this variable is x, then do y." The If control
works by evaluating an expression and, if it equals Example
true, executes any commands that follow it until an loop x = 1, 100
EndIf control is reached. If the expression is found textenter quote(x) + ", "
to be false, then the script skips to the EndIf endloop
control.
Repeat Until: loops a series of instructions
Example dependent upon the evaluation of a condition w
if width > height the Until control, such as until x = 100.
x = width
endif Example
x = 0
Else and ElseIf: The Else control is used within an repeat
If control to direct the script to a set of instructions x = x + 1
to carry out when the evaluation equals false. This textenter quote(x) + ", "
is useful when you want an alternate set of instruc- until x = 100
tions carried out when an expression is false
(considering that the instructions that follow an While and EndWhile: acts in the same way as
EndIf are always carried out, whether or not the Repeat Until controls, except that it evaluates
result is true or false.) expression at the beginning and will skip the
instructions it encloses if the expression is fals
Example (while the Repeat Until controls will execute t
if width > height instruction at least once, even if the expression
message "The page is wide." evaluated with Until is false).
elseif width = height
message "The page is square."
else
Related titles

Related titles


ADOBE PAG
Example textenter quote(x)
x = 0 break x = 100
while x < 100 textenter ", "
textenter quote(x) + ", " until x = 100
endwhile
Goto and Label: skip from one point in a scrip
Switch, CaseOf, Default, Endswitch: evaluate a another. By using a value or expression with th
single variable for a series of values. The Switch Goto control, PageMaker will immediately sea
control is accompanied by a variable, which is the whole script to find a Label with a matchi
evaluated by each of the subsequently listed value and continue executing instructions from
CaseOf controls. If the CaseOf value matches the that point.
Switch value, then the commands that follow are
all executed to the Endswitch control (ignoring any Example
additional CaseOf or Default controls). To stop a if "Helvetica" # fontlist
CaseOf from executing all the way to the font "Helvetica"
Endswitch, you can use the Break control to exit goto done
the Switch and immediately jump to the endif
Endswitch. If none of the CaseOf values match the if "Helvetica-Narrow" # fontlist
Switch value, you can use the optional Default message "Substituting Helvetica-Narrow for
control to execute instructions instead. Helvetica"
f o n t " H e l v e t i c a - Na r r o w "
Example goto done
getpagenumber >> pagenum, ... endif
switch pagenum message "Default font being used instead of
caseof -3 missing Helvetica"
message "The current page is a left- hand master label done
page." n e w
break
caseof -4 Try command: executes a command that mig
message "The current page is a right-hand return an error, without interrupting the execu
master page." of the rest of your script. When the command
break follows a Try command fails, PMScript simply
default ignores it and continues on.
message "This is not a master page.
endswitch
Example
Break: escapes from any Repeat Until, While, or t r y f o n t " H e l v e t i c a"
Loop controls. See above example for using Break
with the Switch control. ErrorChecking command: toggles scripts on a
off when encountering errors generated by
Example PageMaker (not PMScript). This is similar to u
x = 0 a Try command on every line of your script, ex
repeat that if one of the commands fails, all the subs
x = x + 1 quent commands are ignored.
Related titles

Related titles


ADOBE PAG
Example 2 Use a carriage return to separate the comm

errorchecking off or query and its parameters from the next
font "Courier" command or query. For example:
f o n t " H e l v e t i c a" select (rightpage column 2 left, guide 2)
errorchecking on delete
Message Command: Displays a message in a 3 Use commas to separate parameters from o

dialog box. Can also be used to display the results another. For example:
of a query. See above for other examples of the
resize righttop, 3.5i, 7i, 1,1
message command.
4 Use the correct syntax. Parameter values m
Example always follow the command or query in the or
getalignment >> myvariable specified in this guide.
message "Current alignment value is: " + 5 Don't worry about case when entering
str(myvariable) commands, queries, and parameter keywords
They can contain any combination of lowerca
The Message command can be combined with the and capital letters. For example:
GetYesNo command to get information from the
M a n u a l Ke r n i n g A p a r t F i n e
user while the script is running. The GetYesNo
command replaces the "OK" button in the message
or
box with a Yes and No button..
manualkerning apartfine
Example
or
message "Do you want to Quit?"
getyesno >> myvariable M A N U A L K ER N I N G A p a r t fi n e
if myvariable = YES
goto signoff 6 Always match the case, as well as spelling an
endif punctuation, of submenu, pop-up menu, and
palette options, such as fonts, colors, master pa
dictionaries, and styles. These parameters app
See also:
in quotation marks.
About PMScript
You must capitalize, spell, and punctuate an op
Parameter types
name exactly as it appears on screen.
Writing expressions
7 Precede all comments with a double hyphe
Using functions
) or two backslashes (\\). Comments may be ei
on a line by themselves or on the same line as
Basic scripting rules command or query. As with commands and
queries, the carriage return marks the end of a
1 Type each command or query as one word, comment.
without spaces. For example, type "lockguides,"
not "lock guides;" type "getlinkinfo," not "get link A comment is optional text within the script t
info." describes the script's actions. (PageMaker igno
these comments when the script runs.)
Related titles

Related titles


ADOBE PAG
Both of the following examples are correct: You cannot undo PageMaker script command
The only way to reverse the result of running a
new 5 -- creates a new, 5-page publication
script is to choose Revert from the File menu o
use the Revert command in a script and replace
or
current publication with the last-saved version
new 5 -- creates a new, 5-page publication
4 Use comments to document your script.
Include comments throughout a script to ensu
See also:
that you (and others) remember what the scri
Parameter types does.
Deciphering PageMaker replies to queries See also:
Scripting tips
Specifying the measurement system
How publication defaults and preferences affect
Coordinates
scripts
Script language components defined
Basic scripting rules
Scripting tips
1 Prepare for varying conditions.
How publication defaults and
Keep in mind the conditions of the environment in
preferences affect scripts
which your script may run. For example, prefer-
ences may be set; document and application Be aware of the possible conditions, preferenc
defaults may vary; objects may be selected; or no and default settings in a publication and on th
publication may be open. Keep in mind that your computer, such as:
script may change application or document • Installed fonts, filters, and plug-ins
defaults, with undesirable results.
• Whether or not an object is selected
To make sure your script runs as planned, set as • Whether or not a publication is open
many preferences and defaults within the script as
you need to control the running environment. Otherwise, under certain circumstances, your
(For example, set the zero point, specify script may not run correctly or may yield
measurement systems for parameter values, select undesirable results.
the necessary objects, open or close publications, The effect of a command or the values a query
and so forth.) returns depends on the state of PageMaker and
2 Leave things as you found them. publication when PageMaker executes the
command or query. Here are the effects of
Before changing defaults or preferences, query
commands in each state:
their initial state, store the state in variables, and
then restore the defaults and preferences at the end No publication is open. If no publication is o
of your script. many commands set PageMaker default values
new publications, and many queries return th
3 Save the publication at the start, whenever
PageMaker default settings. The default setting
possible.
existing publications are not affected.
Related titles

Related titles


ADOBE PAG
Publication is open and no object is selected. If a To write a script using the Scripts palette:
publication is open and no object is selected, many 1 If the Scripts palette is not open, choose
commands set the publication defaults and many Window > Plug-in Palettes > Show Scripts.
queries return the publication defaults.
2 Choose New Script from the Scripts palette
Publication is open and an object is selected. If a menu (click the arrow on the upper right corn
publication is open and objects are selected with the palette to display the menu).
the Select command or pointer tool, object-
3 Name the script file, select a location in the
specific commands and queries apply to those
Scripts folder, and then click OK.
selected objects.
4 Type the script commands in the New Scrip
Publication is open and text is selected with the
window.
text tool. If a publication is open and text is
selected with the text tool, text-specific commands
To run a script listed in the Scripts palette:
and queries apply only to those selected sections of
the text; paragraph-specific commands and 1 If the Scripts palette is not open, choose
queries apply to all the paragraphs containing the Window > Plug-in Palettes > Show Scripts.
selected text. 2 If the script acts on selected objects in the p
Publication is open and the insertion point is cation, select the desired objects.
within a text object. If a publication is open and 3 Double-click the script in the Scripts palett
the insertion point is within a text object, text-
specific commands and queries apply only to the
next characters inserted; paragraph-specific See also:
commands and queries apply to the paragraph Working with other scripting applications
containing the cursor. Basic scripting rules
Scripting tips
See also: Adding scripts to the Scripts palette
Specifying the measurement system Removing scripts from the Scripts palette
Coordinates
Basic scripting rules
Adding scripts to the Scripts
palette
Writing and running scripts You can add scripts to the Scripts palette by ei
You can write scripts directly in the PageMaker using the Add Script command on the Scripts
Scripts palette or in any application that can save palette menu or by copying scripts to the Scrip
the script in the text-only format. Once written, folder.
move the script into the Scripts folder so it will
appear in the Scripts palette. The Scripts folder is To add a script using the Scripts palette:
in: 1 Choose Add Script from the Scripts palette
Windows PageMaker 7.0\RSRC\<language> menu (click the arrow on the upper right corn
\PLUGINS\SCRIPTS the palette to display the menu).
2 In the Add a Script dialog box, select a scrip
Macintosh Adobe PageMaker
7.0:RSRC:Plugins:Scripts folder, and then click Open.
Related titles

Related titles


ADOBE PAG
The script or folder you choose is automatically The script is now stored in the Scripts-Disable
copied to the Scripts folder and appears in the folder in the Plug-ins folder.
Scripts palette.
To restore a script that has been removed from th
Note: In Windows, you can type a descriptive title in
Scripts palette:
the Script Title text box. The title will appear in the
palette instead of the script's filename. If you leave 1 Choose Restore Script from the Scripts pale
the Script Title blank, the palette displays the script's menu (click the arrow on the upper right corn
filename. the palette to display the menu).
2 From the list of removed scripts, select a sc
To rearrange scripts in the Scripts palette: and click Restore.
1 Open the Scripts folder, located in the following
location: See also:
Windows PageMaker 7.0\RSRC\<language> Adding scripts to the Scripts palette
\PLUGINS\SCRIPTS
7.0:RSRC:Plugins:Scripts
2 Rearrange the order of the scripts in the folder;
Working with other scripting
that order will be reflected in the Scripts palette. applications
Because scripts written in other applications
See also: contain more than PageMaker commands and
queries, you must know the following to write
successful script:
Removing scripts from the Scripts palette
• The language used by the application in whi
you write the script
Removing scripts from the • The method by which that application comm
Scripts palette nicates with PageMaker
You can remove scripts from the Scripts palette. • The PageMaker script language
When you remove a script, you merely prevent it •How to use Apple Events or Windows Dyna
from being displayed on the palette; the script file
Data Exchange (DDE)
itself is not deleted. On the Macintosh, scripts you
remove from the palette are moved into the This guide describes only how to use Apple Ev
Scripts-Disabled folder. To redisplay a script you've and DDE to communicate with PageMaker. R
removed from the palette, use the Restore to the documentation provided with your
command. scripting or programming application for deta
on how to send Apple Events or DDE message
To remove a script from the Scripts palette:
Note that most applications can send and rece
1 Select a script in the Scripts palette. (You can only certain Apple Events, and that PageMake
remove only one script at a time.) recognizes only the "Do Script" and "Evaluate
2 Choose Remove Script from the Scripts palette
Script" Apple Events. Therefore, not all applic
menu (click the arrow on the upper right corner of tions that support Apple Events can communi
the palette to display the menu). with PageMaker. Refer to your scripting appli-
cation documentation for the necessary detail
Related titles

Related titles


ADOBE PAG
See also: See also:

Using Apple Events to communicate with Page- Apple Events: Required constants
Maker Apple Events: Sending commands and queries
Using DDE to communicate with PageMaker Apple Events: Receiving a reply
Using Apple Events to communicate with Pag
Maker
Using Apple Events to
communicate with PageMaker
On the Macintosh, you can communicate directly Apple Events: Required
with PageMaker using any application that constants
supports the "Do Script" or "Evaluate Expression" To communicate with PageMaker using AESe
Apple Events. These applications include: your script must identify these constants:
• Apple Script Constant Description
• Frontier
kAEMiscStdSuite = 'misc' Miscellaneous standar
PageMaker does not distinguish between suite
commands and queries at the Apple Event level. kAEDoScript = 'dosc' Standard DoScript eve
You can use either Do Script or Evaluate (or you can identify kA
Expression to send commands and queries to Evaluate below; both a
not required)
PageMaker.
kAEEvaluate = 'eval' Standard Eval event (or
can identify kAEDoScri
See also: above; both are not
required)
Apple Events: Addressing
Apple Events: Required constants keyAEDirectParameter = ' -- --' Direct parameter of AE
scriptor
Apple Events: Sending commands and queries
keyErrorNumber = 'erno' Error number returned
Apple Events: Receiving a reply from PageMaker
keyErrorString = 'errs' Error string returned fr

PageMaker
Apple Events: Addressing
typeText = 'TEXT' Raw text data
You can use several methods to address Apple
Events to a specific application: typeLongInteger = 'l ong' Long integer
•The application signature (ADPM for

PageMaker 7.0) See also:
• The session ID Apple Events: Addressing
• The target ID Apple Events: Sending commands and queries
• The process serial number Apple Events: Receiving a reply
The approach depends on the scripting application
Maker
you're using. To learn about each, refer to your
scripting or programming application documen-
tation and Inside Macintosh, Interapplication
Communication.
Related titles

Related titles


ADOBE PAG
Apple Events: Sending Apple Events: Required constants

commands and queries Apple Events: Sending commands and queries
When you send commands and queries to
Maker
PageMaker using an Apple Event, you can send
only one query per event. If you send more than
one query per event, PageMaker replies to only the
Using DDE to communicate wi
last query.
PageMaker
Note: It is possible to send commands and queries to
You can communicate with PageMaker by send
PageMaker faster than PageMaker can process them.
DDE messages directly to PageMaker from an
If that happens, events may be ignored. To avoid this
application that supports DDE commands. Th
problem, always specify a kAEWaitReply in the
applications include Microsoft Excel, Microso
sendMode parameter of AESend.
Word for Windows, ToolBook, and Visual Bas
For more information about kAEWaitReply, see
PageMaker recognizes and uses the following D
Inside Macintosh, Interapplication Communication.
messages:
Message Use
See also:
Apple Events: Addressing WM_DDE_INITIATE Use this message to begin a co
versation. PageMaker registers
Apple Events: Required constants itself as "PageMaker" and respo
Apple Events: Receiving a reply to WM_DDE_INITIATE message
"PageMaker" that use any topi
Using Apple Events to communicate with Page- name (including NULL).
Maker
WM_DDE_EXECUTE Use this message to send com
mands.
Apple Events: Receiving a reply WM_DDE_REQUEST Use this message to send quer
Queries must use the CF_TEXT
PageMaker uses a reply Apple Event to provide mat.
error information and query results to the appli-
WM_DDE_DATA PageMaker uses this message
cation sending the Apple Event. Replies may transmit its reply to the applica
contain one of the following: that issued the
WM_DDE_REQUEST.
• A query reply (keyAEDirectParameter)
WM_DDE_ACK Use this message to acknowle
• An error number (keyErrorNumber) the receipt of a command or
request.
• An error string (keyErrorString), if PageMaker
generates a string for the error code WM_DDE_TERMINATE Use this message to end a con
sation.
Note: If an error occurs, the reply may also contain
invalid data in keyAEDirectParameter. To verify
whether the data is valid, make sure the reply Sending queries to PageMaker using D
contains the keyAEDirectObject parameter and does You use WM_DDE_EXECUTE to send comma
not contain the keyErrorNumber parameter. and WM_DDE_REQUEST to send queries.
You can send only one query per message. If y
See also: send more than one, PageMaker replies only to
Apple Events: Addressing last query.
Related titles

Related titles


ADOBE PAG
Receiving replies from PageMaker To use this threading utility, you should have a
PageMaker uses WM_DDE_DATA to transmit the publication open in PageMaker with at least tw
result of the query to the application that issued stories on the page.
the WM_DDE_REQUEST. Replies may contain Note: You must use HyperCard version 2.1 or la
one of the following: Also, program linking must be active in the Sha
• An error string, if PageMaker can generate a Setup control panel for this example to work.
string for that error code. Stack or project script. The following functio
• A query result, if the script contains a query. the stack or project script for the utility:
For more information about deciphering --Threading utility courtesy David Butler
replies, see Deciphering PageMaker replies to function sendQueryToPM pmscript
queries. global PMAPP
- - p u t P a g e M ak e r n a m e i n t o v a r i a b l e P M A P P
See also: if PMAPP is empty then
answer program "Select PageMaker from lis
Working with other scripting applications
right:"
Sample scripts i f i t i s e m p t y t h e n e x i t s e n d Q u e r y To P M
put it into PMAPP
end if
Sample scripts request pmscript from program PMAPP
These simple examples illustrate how to send return it
commands to PageMaker using a script written in e n d s e n d Q u e r y To P M
another application. For more samples of how to
use the PageMaker script language, see the script Button. The utility has one button named
samples in the Scripts folder (and listed in the Thread. The script for the button is:
Scripts palette).
on mouseUp
-- Get coordinates of selected text block
See also: -- Use coordinates later to place text back o
Sample scripts: HyperCard or SuperCard page
p u t s e n d Q u e r y To P M ( " g e t o b j e c t l o c t o p l e f t " )
Sample scripts: Visual Basic for Applications
into TLCoords
Sample scripts: Visual Basic
p u t s e n d Q u e r y To P M ( " g e t o b j e c t l o c b o t t o m -
right") into BRCoords
Sample scripts: HyperCard or

-- Highlight and cut text from second text b
SuperCard -- Select first text block
The following HyperCard or SuperCard example p u t s e n d Q u e r y To P M ( " t e x t e d i t ; s e l e c t a l l;
creates a simple utility that threads (joins) the text cut;select 1;") into reply
of two independent text blocks into one story and
then replaces the second text block in its original -- Get bottom corner of first text block
position. The utility consists of a button, which p u t s e n d Q u e r y To P M ( " g e t o b j e c t l o c b o t t o m -
sends the commands and queries to select, join, right") into BCd
and replace the text, and a simple text field, where
user instructions are displayed. -- Get last character of first text block
Related titles

Related titles


ADOBE PAG
p u t s e n d Q u e r y To P M ( " t e x t e d i t ; t e x tc u r s o r Sub MAIN

+textblock;textselect -char") into reply Shell "C:\PM7\PM7.EXE", 1-- Launch
p u t s e n d Q u e r y T o P M (" g e t s t o r y t e x t 0 0 " ) i n t o PageMaker
reply c h a n n e l = D D E I n i t i a t e ( " Pa g e M a k e r " , " " ) - -
Open a DDE link
-- If last character is not a return, add one DDEExecute channel, "new1"-- Send a scrip
If character 2 of reply is return then command
put "textcursor +textblock;" into TxtSend result$ = DDERequest$(channel, "getpages"
else Send a script query
put "textcursor +textblock;textenter " & quote D D E Te r m i n a t e c h a n n e l - - C l o s e t h e D D E l i n
& return & quote & ";" into TxtSend End Sub
end if
See also:
-- Paste text and reposition text blocks
put "paste;select 1;resize bottomright" && BCd Using DDE to communicate with PageMaker
& ";" after TxtSend Sample scripts: Visual Basic
put "placenext;place" && TLCoords & ";" after
TxtSend
put "resize topleft" && TLCoords & ";" after Sample scripts: Visual Basic
TxtSend The following Visual Basic program creates a
put "resize bottomright" && BRCoords & ";" simple utility that threads (joins) the text of tw
after TxtSend independent text blocks into one story and th
put sendQueryToPM(TxtSend) into reply replaces the second text block in its original
end mouseUp position. The utility form consists of a button
which sends the commands and queries to sel
Text field. The utility has one text field that join, and replace the text, and a simple text
contains the following instructions for the user: window, where user instructions are displayed
To t h r e a d t w o t e x t b l o c k s , s e l e c t t h e fi r s t t e x t replies from PageMaker are sent.
block and send it to the back. Then, select the To use this threading utility, you should have a
second block and click Thread. publication open in PageMaker with at least tw
stories on the page.
See also: Declarations. Here are the "(general)" declara
Using Apple Events to communicate with Page- tions for the utility:
Maker
REM Threading utility courtesy David Butle
REM Subroutine to keep utility on top
Declare Sub SetWindowPos Lib "User" (ByV
Sample scripts: Visual Basic for hWnd As Integer, ByVal hWndInsertAfter As
Applications Integer, ByVal X As Integer, ByVal Y As Integ
You can use Visual Basic for Applications (VBA) to ByVal cx As Integer, ByVal cy As Integ er, ByV
write scripts in applications such as Microsoft wFlags As Integer)
Word, Excel, and Access. The following example,
written with Microsoft Word 6.0 for Windows, Const HWND_TOPMOST = -1
shows how to initiate a DDE link with PageMaker Const HWND_NOTOPMOST = -2
and send commands and queries. Const SWP_NOACTIVATE = &H10
Related titles

Related titles


ADOBE PAG
Const SWP_SHOWWINDOW = &H40 End Sub
Subroutines. Here are the subroutines used by the Text field. The utility has one text field with t
utility: MultiLine property set to True. The LinkClose
procedure contains the following code:
Sub Form_Load ()
R E M M a k e w i n d o w s t a y o n t o p o f P a g e M a ke r Sub Text1_LinkClose ()
SetWindowPos hWnd, HWND_TOPMOST, 0, 0,
0, 0, SW P_NOACTIVATE Or REM Let PageMaker finish before utility
SWP_SHOWWINDOW continues
REM This procedure is important for more
R e m P r e v e n t u t i li t y f r o m t i m i n g o u t i f complex scripts
P a g e M a ke r i s n o t r u n n i n g DoEvents
Text1.LinkTimeout = -1
Text1.LinkTopic = "PageMaker|DDE_LINK" End Sub
REM Put help message in text window Command button. The utility has one comm
UpdateStatus button with a caption of Thread. The subrout
for the button follows. Be careful to follow the
End Sub PageMaker syntax correctly (for example, inser
a space between commands and parameters).
Sub RunScriptCommand (PM_Cmd As String)
The sample code below sends several comman
Text1.LinkMode = 2
a time. If it becomes necessary to troubleshoo
problem, you may want to send one command
REM Send either commands or query based on
time.
first 3 characters
R E M Yo u c a n g r o u p c o m m a n d s , b u t m u s t s e n d Sub Command1_Click ()
queries one by one
REM Use Execute for commands, Request for REM Define a paragraph (carriage return)
queries character
Cr$ = Chr$(34) + Chr$(13) + Chr$(10) +
If Left$(LCase$(PM_Cmd), 3) = "get" Then Chr$(34)
Text1.LinkItem = PM_Cmd
Text1.LinkRequest REM Get coordinates of selected text block
Else REM Use coordinates later to place text back
Text1.LinkExecute PM_Cmd page
End If RunScriptCommand ("getobjectloc topleft")
TLCoord$ = Text1.Text
End Sub RunScriptCommand ("getobjectloc bottom-
right")
Sub UpdateStatus () BRCoord$ = Text1.Text
REM Define help text to appear in text window
Msg$ = "To thread two text blocks, select th e REM Highlight and cut text in second text b
first text block and send to b ack. " REM Then select first text block
Msg$ = Msg$ + "Then, select the second block RunScriptCommand
and click Thread." ( " t e x t e d i t ; s e l e c t a l l ; cu t ; s e l e c t 1 ; " )
Text1.Text = Msg $
Related titles

Related titles


ADOBE PAG
REM Get bottom corner of first text block Testing and troubleshooting
RunScriptCommand ("getobjectloc bottom-
The flowchart below illustrates the most succes
right")
method for testing and troubleshooting a scri
BCd$ = Text1.Text
REM Get last character of first text b lock

R u n S c r i p t C o m m a n d ( " t e x t e d i t ; t e x t cu r s o r
+textblock;textselect -char;") These steps are described in detail in the follow
sections:
REM If last character is not a return, add one
Testing scripts using PMTrace
RunScriptCommand ("getstorytext 0 0")
Common problems
If Asc(Mid$(Text1.Text, 2)) <> 13 Then
Msg$ = "textcursor +textblock;textenter " & Cr$
& ";"
Testing scripts using PMTrace
Else
Msg$ = "textcursor +textblock;" When you run a script, PageMaker interprets
End If executes each command and query in turn. W
it encounters an error, PageMaker stops runni
REM Paste text and reposition text blocks the script at the point where the error occurred
Msg$ = Msg$ + "paste;select 1;resize bottom- displays an alert message, followed by a brief
right " + BCd$ + ";" description of the error.
Msg$ = Msg$ + "placenext;place " + TLCoord$ + To find the command causing an error in a sc
";" you can run the script command by comman
Msg$ = Msg$ + "resize topleft " + TLCoord$ + using the Trace option. PageMaker displays th
";" script text in a window and highlights each
Msg$ = Msg$ + "resize bottomright " + command.
BRCoord$ + ";"
To locate an error in a script:
RunScriptCommand (Msg$)
1 If the Scripts palette is not open, choose
Window > Scripts.
R E M P u t h e l p m e s s a g e b a c k i n t ex t w i n d o w
UpdateStatus 2 Select the script you want to error-check.
3 Choose Trace from the Scripts palette menu

End Sub (click the arrow on the upper right corner of t
palette to display the menu).
See also: PageMaker displays the script, highlighting th
Using DDE to communicate with PageMaker first command.
Sample scripts: Visual Basic for Applications 4 Choose Step from the Run menu once for e
command until PageMaker displays an error
message.
See also:
Testing and troubleshooting
Locating errors in other scripting applications
Related titles

Related titles


ADOBE PAG
Locating errors in other scripting If you have moved the Scripts palette file or ha
rearranged these folders, return them to their
applications
appropriate locations.
Scripts written in other applications should
perform their own error-checking routines. To get PageMaker needs the following files in order to
error information from PageMaker, use the the Scripts palette:
GetLastErrorStr query; then display the error On the Macintosh: In Windows:
information in an alert box.
PMScript PMScript.exe
Script Palette.add Scriptpal.add

See also:
Testing and troubleshooting ScriptDLG
See also:
Common problems
Common problems
The following is a list of topics about common
scripting problems and some suggested solutions:
Scripts palette won't open Script not listed in palette
Script not listed in palette A script may not be listed in the Scripts palett
Script stops running before end for any of the following reasons:
Cannot stop a script • The script is not in the Scripts folder. To
Script can't select or misdraws or misplaces appear in the Scripts palette, a script must be
Script stops when command includes filename the Scripts folder (or a folder within the Scrip
None of the scenarios match your situation folder):
Windows PageMaker 7.0\RSRC\<language>
See also: \PLUGINS\SCRIPTS
Testing and troubleshooting Macintosh Adobe PageMaker
Parameter types 7.0:RSRC:Plugins:Scripts
Basic scripting rules • The script has been removed from the Scrip
Scripting tips palette with the Remove Script option, which
prevents a script from being displayed in the
palette but leaves the script file in the Scripts
Scripts palette won't open folder.
The Scripts palette is actually a plug-in and must To view the list of removed scripts, choose
reside in the Plug-ins folder. It cannot be in Restore Script from the Scripts palette menu.
another folder within the Plug-ins folder. Double-click the name of the script you want
PageMaker expects to find it in the following restore.
locations:
Windows PageMaker 7.0\RSRC\<language> See also:
\PLUGINS\SCRPTPAL.ADD Common problems
7.0:RSRC:Plugins:Script Palette.add
Related titles

Related titles


ADOBE PAG
Script stops running before end • Does the command require that an object b
selected or that text be highlighted?
PageMaker stops running a script when it
encounters an error. To find the command When you're satisfied that the details of a scri
causing the error, run the script command by are correct, run it again. If it still doesn't run,
command, using the Trace option. check to see if the commands are in the correc
sequence. You may have omitted a necessary
To locate an error in a script: command or used the wrong command.
1 If the Scripts palette is not open, choose
Window > Plug-in Palettes > Show Scripts. See also:
2 Select the script you want to error-check. Common problems
3 Choose Trace from the Scripts palette menu
(click the arrow on the upper right corner of the
Cannot stop a script
palette to display the menu).
You cannot interrupt a script when it's runnin
PageMaker displays the script, highlighting the
However, you can use the Revert command (o
first command.
choose File > Revert) to restore the publicatio
4 Choose Step from the Run menu once for to its most recently saved version.
each command until PageMaker displays an
We recommend that you use Save, SaveAs, and
error message.
MiniSave as the first command statement in t
When you have located the offending command, script. That way, Revert will return the publi-
determine why it is causing a problem: cation to its original condition if no other Sav
SaveAs commands are used in the script. (See
• Are the command and keywords spelled
Revert command description.)
correctly?
•Are the command and keywords each one
word? See also:
Common problems
• Are all the required parameters specified?
•If a comment is on the same line, is it preceded
by two hyphens? Script can't select or misdraws
• Does the specified location, guide, or object misplaces
exist in this publication? If your script fails to select an object or places
• Is the path for an imported graphic or file in the wrong location, check out these possibl
complete and correct? causes:
• Are filenames and other text (such as fonts, • Has the location of the object changed since
colors, and styles) enclosed in quotation marks? you wrote the script? If you used numeric
• Are parameters that represent variable menu coordinates, you'll need to edit the script for t
options (such as fonts, colors, master pages, and new location of the object.
styles) spelled and capitalized exactly as they • Is the zero point where you expect it to be? S
appear on the menu? Setting the rulers' zero point
• Is the publication in the correct view for the
command (some commands work only in the
story editor or only in layout view)?
Related titles

Related titles


ADOBE PAG
• Did you specify coordinates using the • If the file is not in the current folder but is o
PageMaker coordinate system? Remember that the same disk, precede the name with the hard
locations below the zero point are positive and disk and folder names, separating each with a
location above are negative. See Using numeric colon (for example, "Disk:Newsletter:Artwork
coordinates. Chart.eps").
•Are your coordinates in the default measurement • On the PC, follow Windows rules to specify
units of the publication? See Specifying the the path and name of the file (for example,
measurement system. "C:\Artfiles\Newsletter\Charts\Chart.bmp").
• Are you using the correct drawing-order If you either transferred the script from one
number? Remember that sending an object to platform to another as a text file or wrote the
the back or front changes its drawing order. script in a DOS editor, the filename referenced
• Are you selecting a PageMaker object that does in the script may contain an upper-ASCII
not have a fill? To select an unfilled object, you character (character number 128 and up).
must specify a location on its line. See the Select Although the first 128 characters are identical
command. the character sets used by DOS, Windows, and
the Macintosh, the upper-ASCII characters ar
not identical. This can be a problem if the
See also: character on one platform maps to a characte
Common problems that is illegal for filenames on another. Try on
of the following solutions:
• If the file was written in a DOS text editor,
Script stops when command
import the script into PageMaker for Window
includes filename using the Text-only filter and select the DOS
PageMaker looks for a file only in the current import option. Then, either run the script in
default folder unless you specify a path. (The PageMaker or export it to a new text file.
current folder is the last folder PageMaker used • If you transferred the script across platform
when opening, placing, exporting, or saving (Macintosh to Windows, or vice versa), transf
with File > Save As or with the SaveAs the script again within a PageMaker publicatio
command.) PageMaker correctly maps the upper-ASCII
If the file is in the current default folder, make characters of transferred publications. Then,
sure you spelled the filename correctly and you can export the script to a text file or copy
enclosed it within quotation marks. Do not into the Scripts palette edit box and save it fro
include any spaces between the quotation marks there.
and the name (unless the spaces are part of the
filename). See also:
• On the Macintosh, if the file is in a folder Common problems
within the current folder, precede the filename
with a colon, the subfolder name, and another
colon (for example, ":Artwork:Chart.eps").
Related titles

Related titles


ADOBE PAG
None of the scenarios match your • Adobe Technical Support. If the "Testing and
troubleshooting" section of this guide doesn't
situation
answer your questions and you need person-t
If that's the case, back up a step and examine the person advice, our technical support represen
logic of your script. Make sure the context in tives can answer questions about commands a
which you're using commands and queries queries. They cannot, however, evaluate the
makes sense. For example: soundness of your scripts, nor can they troubl
• Check the state of PageMaker. Are you sending shoot for you. If you are in the United States o
a NewStory command when no publication is Canada, technical support is available directly
open? from Adobe. Outside the United States and
Canada, call your local Adobe subsidiary or
• Make sure you're using the correct command. distributor.
Are you trying to select a text block using
SelectAll instead of TextSelect?
• Make sure the script contains all the necessary
commands. Step through the process you're
scripting manually and compare the sequence
against your script text.
See also:
Common Problems
Getting more information

The best source for scripting information is
other script writers. Check with your local
PageMaker user group. In addition, Adobe has
several online services you can access:
•The Adobe Home Page on the World Wide
Web. To open the Adobe Home Page, use the
URL http://www.adobe.com once you're on the
World Wide Web.
• E-mail at techdocs@adobe.com
You can also find more scripting-related infor-
mation in:
• Other Adobe documents. Most script commands
work just like their corresponding menu
commands.
Related titles

Related titles


Commands
Addition sPlugInName[, sFilename] AddPrinterStyle sPrinterStyle

Runs an installed menu plug-in, such as Build Saves the current print settings as a printer sty
Booklet, from the Plug-ins submenu. the given name.
Parameter Values to enter Parameter Value
sPlugInName Name of plug-in, in quotation marks, sPrinterStyle Name of printer style to create, in qu
exactly as it appears in menu (to a maxi- tion marks (maximum of 31 characte
mum of 31 characters)
sFilename Exact name of file that contains plug-in, Commands that compose a printer style. To
in quotation marks (to a maximum of 31 create a printer style, set all the print options a
characters; required only if two plug-ins
have same menu name). Include path if
needed and save them using the AddPrinterSt
the file is not in default PlugIns folder. command. The commands that set print optio
saved in a style are:
Running plug-ins. A menu plug-in is a set of PrintColor
commands that combines PageMaker tasks into
one software component; a plug-in is installed on PrintDoc (range set to all pages)
the Plug-ins submenu. Once the plug-in is PrintFeature
executed using the Addition command, the plug-
in continues to run until it reaches the last PrintOptions or PrintOptionsPS
command. PrintPaperPS
Creating the ellipsis. For a Macintosh plug-in, PrintTo
press Option + ; to include the required ellipsis (...)
in the plug-in name. For a Windows plug-in, type Example. The following example sets various
three periods. print settings and saves them as the printer sty
LJet Color Seps Letter.
Example. The following example executes the
printcolor 1, 0, 0, 1, 1, 0, "60 lpi / 300 dpi"
plug-in that vertically aligns the top and bottom
printdoc 1, 1, 0, 0, "", 0, 0, 0, 0, 0, 0
lines of text block handles in selected columns.
printoptionsps normalimage, on, on, norma
Addition Balance Columns off, off, on, off, off
p r i n t p a p e r p s "Letter", "Paper Tray", -2, -2, -
See also: 2, -2, 0, 0, -2, 0, 1000 0
printto "HP LaserJet IIISi PostScript v52.3",
The GetAdditions and GetAdditionsDir queries
LaserJet IIISi PostScript on LPT1"
addprinterstyle "LJet Color Seps Letter"
See also:
The PrintColors, PrintDoc, PrinterStyle, Print
tions, PrintOptionsPS, PrintPaperPS, PrintTo,
RemovePrinterStyle commands
Related titles

Related titles


ADOBE PAG
The GetPrintColor, GetPrintDoc, GetPrinterList, Alignment cKind

GetPrinterStyles , GetPrintFeatureTitles , GetPrint-
Specifies paragraph alignment. The extent of t
OptionsPS, GetPrintPaperPS, GetPrintPPDs, Get-
PrintPS, GetPrintScreens, and GetPrintTo queries action depends on which tool is active, wheth
any text is selected, and whether a publication
open when the command is executed.
AddWord sWord[, sLanguage] Parameter Values to enter
Adds the specified word to the user dictionary for
cKind left or 0 (zero)
spell checking and hyphenation.
center or 1
Parameter Values to enter
right or 2
sWord Word to add to user dictionar y, in quota- justify or 3
tion marks (maximum 63 characters)
force or 4
sLanguage Language, in quotation marks and
exactly as it appears in Add Word to User
Dictionary list box (maximum of 15 char- Specifying default alignment. If no text is
acters) selected or the pointer tool is active, this comm
"" (empty quotation marks or omit specifies the default alignment setting.
parameter entirely) to add word to dic-
tionary assigned to paragraph contain- Example. The following example right-aligns
ing insertion point or selected with text selected paragraphs or the next text entered in
tool publication.
alignment right
Multiple paragraphs. If you do not specify a
language and more than one paragraph is selected,
but the paragraphs have different dictionaries See also:
assigned to them, the AddWord command adds The GetAlignment query
the word to the publication default user dictionary.
Text tool not active. In layout view, if you do not
specify a language, and a tool other than the text AppendVertices npoints, xLocatio
tool is selected, the AddWord command adds the yLocation1[, xLocation2, ... xLocationN
word to the publication default user dictionary. yLocationN]
Example. The following example adds the word Appends vertices to the currently selected irreg
"PageMaker" to the UK English user dictionary. polygon. For each point, both values must be
provided. The maximum number of points in
a d d w o r d " P a g e M a k e r" , " U K E n g l i s h "
irregular polygon depends on the system's
memory. In some instances, there is a limit to
See also: length of a command that can be sent to
The RemoveWord, Spell, and SpellWindow com- PageMaker. For example, if you send command
mands PageMaker through a DDE channel from a
separate application, the maximum length of
The GetPMInfo, GetSpellResult, and GetSpell-
Window queries command is dictated by the DDE channel.
Parameter Values to Enter
nPoints Number of points to add to the poly
Related titles

Related titles


ADOBE PAG

tions, LockLayers, MoveLayer, NewLayer, Past
emembers, SelectLayer, ShowLayers, and
xLocation x coordinate for the point to add to the TargetLayer commands
polygon
The GetLayerFromID, GetLayerList, GetLayer
yLocation y coordinate for the point to add to the tions, GetPasteRemembers, and GetTargetLay
polygon queries
Example. The following example creates a

polygon using the CreatePolygon command and AttachContent [nObjectID]
then adds two points to the polygon using the
Attaches the object with an id of nObjectID to
AppendVertices command.
selected frame if the object is specified. Attach
createpolygon 3,1i,1i,1i,2i,2i,2i the selected object to the selected frame if no ob
appendvertices 2,3i,3i,3i,2i is specified.

See Also:
nObjectID Content object (optional)
The CreatePolygon, PolygonMiterLimit, Polygon-
Type, PolygonVertices, and ReversePolyVertices
commands Layout view only. The AttachContent comm
works only in layout view.
The PolygonMiterLimit, GetPolygonType, and
GetPolygonVertices queries Example. The following example attaches a
selected object to a selected frame.
attachcontent
AssignLayer sFromLayer, sToLayer
Assigns currently selected objects from one layer to
another layer. If sFromLayer is "" then all selected See Also:
objects are assigned to sToLayer. The BreakLinks, DeleteContent, FrameConten
Pos, FrameInset, LinkFrames, SeparateConten
Parameter Values to Enter and ToggleFrame commands
sFromLayer Name of the layer to take selected items The GetFrameContentPos, GetFrameInset, Ge
from ameContentType, GetIsFrame, and GetNext-
(or "" all layers) Frame queries
sToLayer Name of the layer to assign selected

items to
Autoflow bState
Layout view only. The AssignLayer command Sets autoflow on or off. If set on, the next text
works only in layout view. placed will flow automatically.
Example. The following example assigns all of the Parameter Values to enter
currently selected objects to the layer named bState off or 0 (zero)
"MyLayer".
on or 1
assignlayer "", "MyLayer"
See Also:
The DeleteLayer, DeleteUnusedLayers, LayerOp-
Related titles

Related titles


ADOBE PAG
Change default to autoflow text. By default, See also:

autoflow is off. In general, specify on to automati- The Hyphenation, NextStyle, ParaOptions, Sty
cally flow a new story or the end of an existing Begin, StyleEnd, and Tabs commands
story into available columns. Automatic text-flow
The GetBasedOn query
creates new pages when necessary.
If turned on, autoflow remains on until turned off
by another command statement or until you select BlackAttributes dBlackLimit,
the Autoflow command on the Layout menu to bOverprintTxt, dOvrprntTxtSz,
turn it off. bOvrprntLines, bOvrprntFlls
Example. The following example turns autoflow Sets the values that control the trapping and
on. automatic overprinting of "black" objects.
autoflow 1 Parameter Values to enter
dBlackLimit dontcare or -2 to leave black limit

unchanged
See also:
Percentage of black, from 0% (0.0) to
The GetAutoflow query
100% (100.0), which sets minimum
amount of black a color needs to be
sidered "black" for trapping and auto
BasedOn sBasedOn overprinting (assuming the color has
cyan, magenta, or yellow componen
Specifies the style on which the style being edited is
bOverprintTxt off or 0 (zero) to disable auto-overpr
based.
ing of black text
Parameter Values to enter on or 1 to enable auto-overprinting
black text
sBasedOn Name of the style on which the edited
style is based, in quotation marks and dontcare or -2 to leave state unchan
exactly as it appears in the Based On
option in the Edit Style dialog box (to a dOvrprntTxtSz Point size below which black text is a
maximum of 31 characters) overprinted, from 4.0 to 650.0
dontcare or -2 to leave overprint tex

Use BasedOn with StyleBegin and StyleEnd. Use limit unchanged
this command only after the StyleBegin command, bOvrprntLines off or 0 (zero) to disable auto-overpr
which marks the beginning of a style definition ing of black lines
and specifies the name of the style being defined or on or 1 to enable auto-overprinting
edited. Use the StyleEnd command to complete the black lines
definition. dontcare or -2 to leave state unchan
Example. The following example defines the new bOvrprntFills off or 0 (zero) to disable auto-overpr
style "Heading 2" (or edits an existing style by that ing of black fills
name), and specifies "Heading 1" as the style on on or 1 to enable auto-overprinting
which it is based. It then identifies the style in the black fills
paragraphs that follow "Heading 2." dontcare or -2 to leave state unchan
stylebegin "Heading 2"

basedon "Heading 1" Example. The following example sets a black l
nextstyle "Para" of 90%, enables auto-overprinting of black tex
styleend below 18 points, and disables auto-overprintin
lines and fills.
Related titles

Related titles


ADOBE PAG
blackattributes 90.0 on 18.0 off off

For each publication:

See also:
sPubNames Publication names, including option
The TrapSettings command pathname to folder and disk, in quot
The GetTrapSettings and GetBlackAttributes que- tion marks (to a maximum of 91 char
ters for each name and path)
ries
Clearing the book list. To remove all publicat
from the book list, set nNumOfPubs to zero.
Book cAutoRenum, nNumOfPubs,
sPubNames Example. The following example specifies the
Creates the book list with the specified publication type of automatic renumbering for the book,
names and sets up automatic renumbering. specifies the number of publications in the bo
list, and creates a list of the publications.
book nextpage 4 "mydisk:myfolder:toc",
cAutoRenum none or 0 (zero) "mydisk:myfolder:sec1",
nextpage or 1 "mydisk:myfolder:sec2",
"mydisk:myfolder:sum3"
nextodd or 2
nexteven or 3
See also:
nNumOfPubs Number of publications in book list
The GetBook query
Box xLeft, yTop, xRight, yBottom

Draws a box from the top-left coordinates to t
bottom-right coordinates.
xLeft x coordinate of top-left corner
yTop y coordinate of top-left corner
xRight x coordinate of bottom-right corner
yBottom y coordinate of bottom-right corner
Measurement units for scripts. If you do not

specify a unit of measure (e.g., i for inches),
PageMaker uses the default unit of measure,
specified in the Preferences dialog box or with
MeasureUnits command.
Drawing rounded rectangles. To draw a roun
rectangle, use the Box command followed by t
RoundedCorners command.
Layout view only. The Box command works
in layout view.
Related titles

Related titles


ADOBE PAG
Example. The following example draws a box A group is considered an object and has a draw
with the specified top-left corner coordinates (five order number like any other object. If you brin
inches, four inches) and the bottom-right corner the group forward, the objects within the grou
coordinates (seven inches, six inches). retain their stacking order in relation to each ot
box 5i, 4I, 7i, 6i
but their drawing-order numbers each increas
one.
Example. The following example selects the fi
See also:
object drawn and brings it forward, changing
The Line and Oval commands drawing order to two.
select 1
BreakLinks bringforward
Breaks the links, or threads, of the selected frames.

See also:
Layout view only. The BreakLinks command
works only in layout view. The BringToFront, Move, SendBackward, and
SendToBack commands
Example. The following example breaks the
selected frames out of their threads.
breaklinks BringToFront
Moves the selected text or graphic to the front
See Also: top layer of the page.
The AttachContent, DeleteContent, FrameCon- Stacking order not affected. If you selected
tentPos, FrameInset, LinkFrames, SeparateCon- multiple elements, the selected objects retain t
tent, and ToggleFrame commands stacking order in relation to each other, but th
The GetFrameContentPos, GetFrameInset, GetFr- selection is brought to the front of the page ah
ameContentType, GetIsFrame, and GetNext- of everything else.
Frame queries
Command language compared to using pointe
tool. When you move a text block or a graph
with the pointer tool, PageMaker automaticall
BringForward brings the object to the front. However, when
Brings the selected object forward one position, move an object with the command language,
bumping up its drawing order by one. Multiple must use BringToFront to bring objects to the
selected objects retain their stacking order in front of the page.
relation to each other.
Layout view only. The BringToFront comma
Drawing order. The first object drawn on a page works only in layout view.
(or pages for facing pages) has drawing-order
Example. The following example selects the
number 1 and is the bottom-most object. The top-
bottom-most object by its drawing order (1) a
most object is the last object drawn and has the
brings it to the top layer of the page.
highest drawing-order number.
select 1
bringtofront
Related titles

Related titles


ADOBE PAG
See also: Specifying smallcaps size. The size of small

The Move and SendToBack commands capitals is specified in the Type Options dialog
(by selecting the Options button in the Type Sp
fications dialog box) or with the TypeOptions
Cascade command.
Cascades the displayed windows of either publica- You cannot use

No override for Caps Lock key.
tions in the layout view or stories in story editor. Case command to change the case of characte
The Cascade command stacks the windows on top typed when the Caps Lock key is on.
of each other, offsetting them so that each title is Example. The following example changes the
visible. currently selected text to all caps.
Stories in current publication only. The Cascade case allcaps
command rearranges story-editor windows only
for the current publication. Stories from other
publications remain unaffected. See also:
The TypeOptions command
Example. The following example switches to the
story editor and cascades the displayed story- The GetCase and GetTypeOptions queries
editor windows of the current publication.
editstory Change sFindWhat, sChangeTo,
cascade [cSearchRange], [bWrapAround],
[bMatchCase], [bWholeWord],
See also: [bClearAttr]
The Tile command Replaces the first occurrence of the specified t
searching the selected range, the active story, o
stories of the current publication. Leaves the n
Case cCase text selected.
Formats text as normal, all capitals, or small Parameter Values to enter
capitals. The extent of the action depends on which
sFindWhat Text to search for, in quotation marks
tool is active, whether any text is selected, and
whether a publication is open when the command sChangeTo Replacement text, in quotation mark
is executed.
cCase normal or 0 (zero) to leave uppercase

and lowercase letters as typed
allcaps or 1 to change all letters to full-

size capitals
smallcaps or 2 to change lowercase let-

ters to small capitals
Related titles

Related titles


ADOBE PAG

Change next. The Change command locates
changes only one instance of the search text. Y
cSearchRange selectedtext or 0 to search selected text must repeat the command, or better yet, use th
currentstory or 1 to search current story ChangeNext command, to find and change th
only, starting from position of insertion next occurrence of the search text. Use the
point (default setting)
ChangeAll command to find and change all oc
allstories or 2 to search all stories in cur- rences of the search text.
rent publication, starting from beginning
of currently active story bWrapAround. PageMaker disregards the bW
default or -1 to use default or previously Around parameter in two cases, when
defined range cSearchRange is set to either:
dontcare or -2 to let system choose
range based on current text selection. If
• selectedtext (or 0), where the search is confi
text is selected, the Change command to the selected text.
searches only selected text; if no text is
selected, it searches only the current
•allstories (or 2), where the search starts at th
story, starting from position of insertion beginning of the active story and automaticall
point. wraps to the beginning of the next story.
bWrapAround stopatend or 0 to stop searching when Optional parameters. PageMaker requires on
PageMaker reaches end of story
the sFindWhat and sChangeTo parameters. If
wrap or 1 to continue searching from do not include values for the other parameter
beginning of story when PageMaker
PageMaker uses the settings of the most recen
reaches end of story (default setting)
executed Find, Change, or ChangeAll comman
bMatchCase anycase or 0 (zero) to turn off case-sensi- (If none of these commands has been executed
tive searching (default setting)
session, PageMaker uses the default settings—
matchcase or 1 to turn on case-sensitive noted in the parameter list above.) If you chan
searching (to match capitalization of
search text exactly)
the cSearchRange using the Find, Change, or
ChangeAll commands, PageMaker resets the
bWholeWord allinstances or 0 (zero) to search for any starting position of the search.
occurrence of specified text (default set-
ting), even if text is found within another Setting text and paragraph a ttributes. To sea
word (for example, searching for "story"
could yield "history," as well as "story")
for and replace text and paragraph attributes (
font, type size, paragraph style), use the
wholeword or 1 to search for specified
text as a whole word only, disregarding
FindTypeAttr1, FindTypeAttr2, FindParaAttr,
occurrences where text is embedded ChangeTypeAttr1, ChangeTypeAttr2, and
within another word. ChangeParaAttr commands, followed by the
bClearAttr useattributes or 0 to use existing text Change command with bClearAttr set to usea
and paragraph attributes (default set- tributes or 0.
ting)
clear or 1 to clear all attribute settings

(both Find and Change settings)
Story editor only. The Change command works

only in story editor.
Current publication only. Unlike the Change
dialog box, the Change command cannot search
multiple publications. It can search only the stories
in the currently active publication.
Related titles

Related titles


ADOBE PAG
Changing only text attributes. To change text Example. The following example selects a sto
attributes only (e.g., all 10-point, bold text to 9- inserts the insertion point into the story, and
point, Helvetica bold), use the FindTypeAttr1, switches to story editor. It then searches the
FindTypeAttr2, ChangeTypeAttr1, and current story for the word "rumba," regardles
ChangeTypeAttr2 commands to set the desired the capitalization or attribute settings. The sea
attributes. (Be sure to clear the paragraph begins at the position of the insertion point an
attributes with the FindParaAttr and wraps to the beginning of the story, if necessar
ChangeParaAttr commands.) Then, using the replaces the first match it finds with the word "
Change command, specify an empty string for cha" and leaves the changed text selected.
both sFindWhat and sChangeTo and set
select (column 1 left, column top)--select st
bClearAttr to useattributes or 0. For example, to
textedit--insert insertion point into beginn
change all 10-point, bold text in a publication to 9-
of selected story
point, Helvetica bold, the commands are:
editstory--switch to story editor
findtypeattr2 -3, -3, "Any", -3--to clear the change "rumba", "cha-cha", currentstory, wr
other type attributes anycase, wholeword, clear
changetypeattr2 -3, -3, "Any", -3--to clear the
other type attributes
See also:
findparaattr "Any", -3, -3--to clear the
paragraph attributes The ChangeAll, ChangeParaAttr,
changeparaattr "Any", -3, -3--to clear the
ChangeTypeAttr1, ChangeTypeAttr2,
ChangeWindow , Find, FindNext, FindParaAtt
paragraph attributes
FindTypeAttr1, FindTypeAttr2, and FindWind
findtypeattr1 "Any", 10, -3, boldstyle, -3, -3
commands
changetypeattr1 "Helvetica", 9, -3, boldstyle, -3,
The GetChangeParaAttr, GetChangeTypeAttr
-3
GetChangeTypeAttr2, GetChangeWindow , Ge
change "", "", allstories, stopatend, anycase,
FindParaAttr, GetFindTypeAttr1,
allinstances, useattributes
GetFindTypeAttr2, and GetFindWindow quer
Searching for and changing special characters.

You enter a special character as part of your search ChangeAll sFindWhat, sChangeTo,
or replacement text using the same key combina- [cSearchRange], [bMatchCase],
tions that you type directly in the Change dialog
[bWholeWord], [bClearAttr]
box.
Replaces all occurrences of the specified text in
Scripts palette. Do not use the Change command selected range, the active story, or all stories of
in scripts you plan to run using the Scripts palette. current publication.
When PageMaker finds no match or completes the
search, the Scripts palette interprets this as an error Parameter Values to enter
and stops at that point in the script. sFindWhat Text to search for, in quotation marks
Plug-ins and external s cripts only.PageMaker sChangeTo Replacement text, in quotation mark
returns the following codes to indicate the success
of the search:
Related titles

Related titles


ADOBE PAG

Optional parameters. PageMaker requires on
the sFindWhat and sChangeTo parameters. If
cSearchRange selectedtext or 0 to search selected text do not include values for the other parameter
currentstory or 1 to search current story PageMaker uses the settings of the last Find,
only, starting from position of insertion Change, or ChangeAll command. (If none of t
commands has been executed this session,
allstories or 2 to search all stories in cur- PageMaker uses the default settings—noted in
rent publication, starting from beginning
of currently active story parameter list above.)
default or -1 to use default or previously Setting text and paragraph a ttributes. To sea
defined range for and replace text and paragraph attributes (
dontcare or -2 to let system choose a font, type size, paragraph style), use the
range based on the current text selec- FindTypeAttr1, FindTypeAttr2, FindParaAttr,
tion. If text is selected, ChangeAll
searches only selected text; if no text is
ChangeTypeAttr1, ChangeTypeAttr2, and
selected, ChangeAll searches current ChangeParaAttr commands, followed by the
story only, starting from position of inser- ChangeAll command with bClearAttr set to u
tion point.
tributes or 0.
bMatchCase anycase or 0 (zero) to turn off case-sensi-
tive searching (default setting)
Changing only text attributes. To change text
attributes only (e.g., all 10 point, bold text to 9
matchcase or 1 to turn on case-sensitive
searching (match capitalization of search
point, Helvetica bold), first use the FindTypeA
text exactly) FindTypeAttr2, ChangeTypeAttr1, and
ChangeTypeAttr2 commands to set the desire
bWholeWord allinstances or 0 (zero) to search for any
occurrence of specified text (default set-
attributes. (Be sure to clear the paragraph
ting), even if the text is found within attributes with the FindParaAttr and
another word (for example, searching for ChangeParaAttr commands.) Then, using the
"story" could yield "history," as well as
"story")
Change command, specify an empty string fo
both sFindWhat and sChangeTo and set
wholeword or 1 to search for specified
text as a whole word only, disregarding
bClearAttr to useattributes or 0. For example,
cases where text is embedded within using the case just mentioned, to change all 10
another word point, bold text in a publication to 9-point,
bClearAttr useattributes or 0 to use existing text Helvetica bold, the commands are:
and paragraph attribute settings (default
findtypeattr2 -3, -3, "Any", -3--to clear the
setting)
clear or1 to clear attribute settings (both
changetypeattr2 -3, -3, "Any", -3--to clear t
Find and Change settings)
Story editor only. The ChangeAll command findparaattr "Any", -3, -3--to clear the
works only in story editor. paragraph attributes
changeparaattr "Any", -3, -3--to clear the
Current publication only. Unlike the Change All paragraph attributes
button in the Change dialog box, the ChangeAll findtypeattr1 "Any", 10, -3, boldstyle, -3, -3
command cannot search multiple publications. changetypeattr1 "Helvetica", 9, -3, boldstyle
ChangeAll can search only the stories in the -3
currently active publication. change "", "", allstories, stopatend, anycase,
allinstances, useattributes
Related titles

Related titles


ADOBE PAG
Searching for and changing special characters. • The Font submenu or pop-up menu
You enter a special character as part of your search • The Plug-ins submenu
or replacement text using the same key combina-
tions that you type to enter the character directly Use this command when you have changed,
into the Change dialog box. deleted, or added font metric files, fonts, or pl
ins during this session with PageMaker.
Scripts palette. Do not use the ChangeAll
command in scripts you plan to run using the Parameter Values to enter
Scripts palette. When PageMaker finds no match cEnvChange fontmetrics or 1 to force PageMake
or completes the search, the Scripts palette inter- reload font-metric information
prets this as an error and stops at that point in the installedfonts or 2 to force PageMa
script. to rebuild the font list for Font subm
(and pop-up menu)
Plug-ins and external s cripts only.PageMaker
plugins or 4 to force PageMaker to
returns the following codes to indicate the success
rebuild the Plug-ins submenu
of the search:
Example. The following example selects a story, Keyword use and order optional. You can inc
inserts the insertion point into the story, and one or all of the keywords and place them in a
switches to story editor. It then replaces all order. See the example below.
instances of the word "rumba," regardless of the
Example . The following example forces
capitalization or attribute settings, with "cha-cha."
PageMaker to rebuild the font list for the Font
It searches only the currently active story.
submenu (and pop-up menu) and to rebuild
select (column 1 left, column top)--select story Plug-ins submenu.
textedit--insert insertion point into beginning
changeenv installedfonts plugins
of selected story
editstory--switch to story editor
changeall "rumba", "cha-cha", currentstory,
anycase, wholeword, clear
ChangeNext
Searches for the next instance of the Find What
specified in the last Change, ChangeAll, or Fin
See also:
command and replaces it with the Change To
The Change, ChangeParaAttr, ChangeTypeAttr1, specified in the last Change or ChangeAll
ChangeTypeAttr2, ChangeWindow , Find, FindN- commands, using all the same settings. Leaves
ext, FindParaAttr, FindTypeAttr1, FindTypeAttr2, new text selected.
and FindWindow commands
The GetChangeParaAttr, GetChangeTypeAttr1, Story editor only. The ChangeNext comman
GetChangeTypeAttr2, GetChangeWindow , Get- works only in story editor.
FindParaAttr, GetFindTypeAttr1, Current publication only. The ChangeNext
GetFindTypeAttr2, and GetFindWindow queries command cannot search multiple publication
can search only the stories in the currently act
publication.
ChangeEnv cEnvChange
Repeat as often as needed. You can send this
Depending upon the parameters, rebuilds one or
command repeatedly until PageMaker finishe
all of the following:
searching the range specified by the previous F
•The font metrics information (for example, kern Change, or ChangeAll command.
pairs or track-kerning information)
Related titles

Related titles


ADOBE PAG
Last executed Change, ChangeAll, or Find wins. Scripts palette. Do not use the ChangeNext
As in the Find and Change dialog boxes, the Find, command in scripts you plan to run using the
Change, and ChangeAll commands share the Find Scripts palette. When PageMaker finds no mat
What and Change To text, as well as the settings for or completes the search, the Scripts palette int
the search options, range, and attributes. (Note: prets this as an error and stops at that point in
You must know all the current settings before you script.
use the ChangeNext and FindNext commands. If
Plug-ins and external sc ripts only.PageMake
you insert a Find command between the Change
returns the following codes to indicate the suc
and ChangeNext commands, the Find search-text,
of the search:
options, range, and attributes become the search
text and settings used by ChangeNext, while the Example. The following example switches to s
replacement text and attributes remain active from editor. It searches the current story for the wo
the last Change or ChangeNext command.) For "rumba," regardless of the capitalization or
example: attribute settings and replaces the first match
finds with the word "cha-cha." The search begin
findtypeattr1 "Any", 10, -3,
the position of the insertion point and wraps to
boldstyle+underline, -3, -3
beginning of the story if necessary. The
changetypeattr1 "Helvetica", 9, -3, boldstyle, -3,
ChangeNext command then replaces the next
-3
instance of "rumba," using the same search crit
change "Note", "Tip", allstories, 1, matchcase,
and starting the search from the end of the las
wholeword, useattributes
encountered "rumba."
changenext--changes next instance of a bold
underlined editstory--switch to story editor
--"Note" to bold, Helvetica 9-point "Tip:" change "rumba", "cha-cha", currentstory, wr
find "See also", currentstory, stopatend, anycase, anycase, wholeword, clear
allinstances, clear changenext
changenext--searches only from insertion point
to end of story,
See also:
--changes next instance of "See also" to "Tip",
--regardless of attributes
The Change, ChangeAll, ChangeParaAttr,
The first ChangeNext command searches for the ChangeWindow , Find, FindNext, FindParaAtt
next instance of a 10-point, bold, underlined, FindTypeAttr1, FindTypeAttr2, and FindWind
whole-word "Note" and replaces it with a 9-point, commands
Helvetica, bold word "Tip." The search begins at The GetChangeParaAttr, GetChangeTypeAttr
the position of the insertion point and wraps to the GetChangeTypeAttr2, GetChangeWindow , Ge
beginning of the next story if necessary. FindParaAttr, GetFindTypeAttr1,
Because of the Find command, the second GetFindTypeAttr2, and GetFindWindow quer
ChangeNext searches for the next instance of "See
also," regardless of its capitalization or attributes.
Using the same Change To criteria, it replaces "See
also" with 9-point, Helvetica bold "Tip." The
search begins from the location of the insertion
point, but is now limited to the current story.
Related titles

Related titles


ADOBE PAG
ChangeParaAttr sParaStyle, Example. The following example changes all

cAlignment, cLeadingType aligned text in the current publication to full-
justified text. Notice that it first sets all other F
Sets paragraph attributes (paragraph style,
and Change attributes to Any.
alignment, and leading method) to be used for the
search text in the Change and ChangeAll findtypeattr1 "Any", -3, -3, -3, -3, -3
commands. changetypeattr1 "Any", -3, -3, -3, -3, -3
findtypeattr2 -3, -3, "Any", -3
Parameter Values to enter changetypeattr2 -3, -3, "Any", -3
sParaStyle Name of style (exactly as it appears in findparaattr "Any", left, -3
Styles palette), in quotation marks (to a changeparaattr "Any", justify, -3
maximum of 31 characters)
changeall "", "", allstories, anycase, allinstan
"Any" (quotation marks required) for useattributes
Any paragraph style (i.e., to not include
paragraph style in search criteria; default
setting)
See also:
"No style" (quotation marks required)
The Change, ChangeAll, ChangeNext,
for No Style
cAlignment any or -3 for Any alignment (i.e., to not ChangeWindow , Find, FindNext, FindParaAtt
include alignment in search criteria; FindTypeAttr1, FindTypeAttr2, and FindWind
default setting)
commands
left or 0 (zero) for Left The GetChangeParaAttr, GetChangeTypeAttr
center or 1 for Center GetChangeTypeAttr2, GetChangeWindow , Ge
right or 2 for Right
GetFindTypeAttr2, and GetFindWindow quer
justify or 3 for Justify
force or 4 for Force Justify
cLeadingType any or -3 for Any leading method (i.e., to

ChangeTypeAttr1 sFontName,
not include leading method in search cri- dPointSize, dLeading, cTypeStyle,
teria; default setting) cPosition, cCase
proportional or 0 (zero) for Proportional Sets the text attributes (font, point size, type s
topofcaps or 1 for Top of Caps position, and case) to be used for the search tex
baseline or 2 for Baseline the Change and ChangeAll commands.

Story editor only. The ChangeParaAttr command
sFontName Name of font (exactly as it appears o
works only in story editor. Type menu), in quotation marks (to a
All attributes cleared first. The settings you maximum of 63 characters)
include with the ChangeParaAttr command "Any" (quotation marks required) fo

Any font (i.e., to not include font nam
replace all existing attribute settings.
search criteria; default setting)
If story editor is not
Plug-ins and external scripts.
dPointSize Point size of type (from 4.0 to 650.0)
active, PageMaker returns
any or -3 for Any size (i.e., to not incl
CQ_LO_INVALID_MODE and disregards the
point size in search criteria; default s
command. ting)
Related titles

Related titles


ADOBE PAG

Type styles are additive. To set the cTypeStyl
parameter to multiple type styles, either separ
dLeading Amount of leading, in points (from 0.0 to the desired style option with the plus sign (+)
1300.0)
add the numeric equivalents for the styles. For
any or -3 to specify Any leading example, for bold (1) and underline (4), you c
auto or -1 for automatic leading either set cTypeStyle to boldstyle+underline o
5 (the sum of 1 and 4).
cTypeStyle any or -3 for Any (i.e., to not include type
style in search criteria; default setting) All attributes cleared first. The settings you
normalstyle or 0 for Normal include with the ChangeTypeAttr1 command
Or, any combination of the following replace all existing attribute settings.
styles, separated by the plus sign (+), or
the actual sum of their values:
Any for cTypeStyle, cPosition, and cCase. Unl
the Type Styles pop-up menu in the Change
boldstyle or 1 for Bold
Attributes dialog box, the any or -3 setting for
italicstyle or 2 for Italic cTypeStyle pertains only to the type styles Bol
underlinestyleor 4 for Underline Italic, Underline, Strikethru, Outline, Shadow,
strikethrustyleor 8 for Strikethru Reverse. The value of cTypeStyle does not affe
the cPosition and cCase parameters, which are
outlinestyle or 16 for Outline (Macin-
tosh only) turned off and on separately.
shadowstyle or 32 for Shadow (Macin- GetTypeStyle values doubled. If you are using
tosh only) GetTypeStyle query in conjunction with
reversestyle or 64 for Reverse ChangeTypeAttr1, FindTypeAttr1,
GetChangeTypeAttr1, or GetFindTypeAttr1, n
cPosition any or -3 for Any position (i.e., to not
include position attribute in search crite- that the GetTypeStyle query returns different
ria; default setting) values for the type styles. With the exception o
superscript or 1 for Superscript normal, all the GetTypeStyle values are twice t
values used in the find and change commands
subscript or 2 for Subscript
queries. For example, bold is 2 for GetTypeSty
cCase any or -3 for Any case (i.e., to not include and 1 for ChangeTypeAttr1, FindTypeAttr1,
case attribute in search criteria; default
GetChangeTypeAttr1, and GetFindTypeAttr1.
setting)
Normal, however, is 1 in GetTypeStyle and 0 in
allcaps or 1 for All Caps (full-size capitals)
other commands and queries.
smallcaps or 2 for Small Caps (small cap-
itals) Example. The following example changes all
point, bold, underlined text in the current pub
The ChangeTypeAttr1
Story editor only. cation to 9-point, Helvetica bold. Notice that i
command works only in story editor. first sets all other Find and Change attributes
Any.
If story editor is not
active, PageMaker returns findtypeattr2 -3, -3, "Any", -3
CQ_LO_INVALID_MODE and disregards the changetypeattr2 -3, -3, "Any", -3
command. findparaattr "Any", -3, -3
changeparaattr "Any", -3, -3
boldstyle+underline, -3, -3
changetypeattr1 "Helvetica", 9, -3, boldstyle
-3
Related titles

Related titles


ADOBE PAG
changeall "", "", allstories, anycase, allinstances,

useattributes
nTintValue Percentage of color (from 0 to 100), i
whole percentages
See also: any or -3 for Any tint amount
ChangeParaAttr, ChangeTypeAttr2, ChangeWin- The ChangeTypeAttr2
Story editor only.
dow , Find, FindNext, FindParaAttr, command works only in story editor.
FindTypeAttr1, FindTypeAttr2, and FindWindow
commands All attributes cleared first. The settings you
include with the ChangeTypeAttr2 command
The GetChangeParaAttr, GetChangeTypeAttr1,
replace all existing attribute settings.
GetChangeTypeAttr2, GetChangeWindow , Get-
FindParaAttr, GetFindTypeAttr1, If story editor is
GetFindTypeAttr2, GetFindWindow , and Get- active, PageMaker returns
TypeStyle queries CQ_LO_INVALID_MODE and disregards the
command.
ChangeTypeAttr2 dSetWidth, cTrack, Example. The following example changes all

sColorName, nTintValue purple text in the current publication to 93%
of Purple. Notice that it first sets all other Find
Sets additional text attributes (set width, tracking, Change attributes to Any.
color, and tint) to be used for the search text in the
Change and ChangeAll commands. findparaattr "Any", -3, -3
Parameter Values to enter findtypeattr1 "Any", -3, -3, -3, -3, -3
dSetWidth Percentage to scale character width changetypeattr1 "Any", -3, -3, -3, -3, -3
(from 5.0 to 250.0; normal is 100.0) findtypeattr2 -3, -3, "Purple", -3
any or -3 for Any set width (i.e., to not changetypeattr2 -3, -3, "Purple", 93
include set width settings in search crite- changeall "", "", allstories, anycase, allinstan
ria)
useattributes
cTrack any or -3 for Any tracking (i.e., to not
include track settings in search criteria)
See also:
notrack or 0 (zero) for No Track
veryloose or 1 for Very Loose
ChangeParaAttr, ChangeTypeAttr1, ChangeW
loose or 2 for Loose dow , Find, FindNext, FindParaAttr,
normaltrack or 3 for Normal Track
FindTypeAttr1, FindTypeAttr2, and FindWind
commands
tight or 4 for Tight
verytight or 5 for Very Tight GetChangeTypeAttr2, GetChangeWindow , Ge
sColorName Name of color, in quotation marks and FindParaAttr, GetFindTypeAttr1,
exactly as it appears in Colors palette (to GetFindTypeAttr2, and GetFindWindow quer
"Any" (quotation marks required) for

Any color (i.e., to not include color in
search criteria)
Related titles

Related titles


ADOBE PAG
ChangeWindow bOpen Story editor: no clearing from dialog boxes.

Unlike Clear on the Edit menu, the Clear
Opens or closes the Change dialog box.
command does not clear text from the Find,
Parameter Values to enter Change, or Spell dialog boxes. Instead, it clears
text selected in the current story, regardless of
bOpen close or 0 to close Change dialog box
whether one of the dialog boxes is displayed.
Example. The following example selects all
open or 1 to open Change dialog box
Story editor only. The ChangeWindow command objects on the page (or all the text in a story if a
works only in story editor. block contains the text insertion point) and cl
them from the publication without copying th
If story editor
Plug-ins and external s cripts only. to the Clipboard.
is not active, PageMaker returns
CQ_LO_INVALID_MODE and disregards the selectall
command. clear
Change and Spell closed , depending on platform.

PageMaker for the Macintosh closes the Find See also:
dialog box before opening the Change dialog box. The Cut, Delete, Select, and SelectAll comman
PageMaker for Windows closes both the Find and
Spelling dialog boxes.
Example. The following example switches to story
Close [sPubName]
editor and opens the Change dialog box. Closes the specified publication without savin
changes and returns to the PageMaker window
editstory
you do not specify a particular publication or
changewindow open
the publications, PageMaker closes the curren
active publication.
See also:
sPubName Name of publication to close, exactly
ChangeParaAttr, ChangeTypeAttr1,
appears on Windows menu and in qu
ChangeTypeAttr2, Find, FindNext, FindParaAttr, tion marks (to a maximum of 63 char
FindTypeAttr1, FindTypeAttr2, and FindWindow ters). If you don't specify a name, Pag
commands Maker closes the currently active
publication.
GetChangeTypeAttr2, GetChangeWindow , Get- "all" (quotation marks required) to c
FindParaAttr, GetFindTypeAttr1, all open publications
GetFindTypeAttr2, and GetFindWindow queries
Specifying "all." If you specify the keyword "a
while a publication titled "All" is open, PageMa
Clear will close that publication. Otherwise, PageMa
Deletes the currently selected graphic or text will close all open publications.
without storing it on the Clipboard.
Objects with text wrap. When you select and clear
a graphic that has a text wrap applied to it, the
space that the graphic occupied is then filled with
the surrounding text.
Related titles

Related titles


ADOBE PAG
Caution: No prompt for unsaved or changed publi- CloseStory can close story editor. If the story
cation. Unlike its menu counterpart, the Close being closed is the only story open in story edi
command does not warn you if you have not saved PageMaker switches to the previously active p
the latest changes to a publication, nor does it in layout view.
prompt you to name an unnamed publication. Use
Plug-ins and external sc ripts only. If story ed
the Save or SaveAs commands first if you want to
save changes to the publication or name it.
Path okay. While not part of the name displayed command.
in the Window menu, you can include the path
Example. The following example closes the
with the name of file you want to close.
current story and activates the text icon if the s
Example. The following example saves a publi- has not already been placed.
cation as "mypub" (and copies any linked
closestory 1
documents), and then closes the publication.
saveas "myfloppy:myfolder:mypub", publi-
See also:
cation, linked
close "mypub" The EditLayout, EditStory , and OpenStory co
mand
See also:
The MiniSave, Save, and SaveAs commands Color sColorName[, nTintValue]
Applies a color to the selected text or graphics o
nothing is selected, to the next object drawn o
CloseStory bPlace placed.
Closes the active story in story editor.
sColorName Name of color, in quotation marks an
bPlace discard or 0 to discard story without exactly as it appears on Colors palett
placing it (affects unplaced stories only) a maximum of 31 characters)
place or 1 to display loaded text icon in nTintValue Percentage of color to apply to objec
layout view (affects unplaced stories (from 0 to 100)
only)
dontcare or -2 to leave setting
unchanged (default)
Story editor only. The CloseStory command
works only in story editor. You can apply
All palette colors are available.
bPlace ignored for placed stories. If the story has color that appears on the Colors palette.
already been placed, PageMaker ignores the value Fill and line of PageMaker objects. Regardles
of the bPlace parameter and simply closes the story the setting of the Fill and Line menu on the Co
(as if you clicked the Go Away box). palette, the Color command applies a color to b
Placing story on page. If the story being closed the fill and line of objects drawn in PageMake
has not been placed, PageMaker switches to the an object has a fill style of None, the Color
previously active page in layout view and displays command changes the fill style to Solid.
the loaded text gun. To place the story on the page, Example. The following example applies a 25
use the place command. red tint to the first object drawn on the page.
select 1
color "Red", 25
Related titles

Related titles


ADOBE PAG
See also: Parameter Values to enter

The ColorPalette, DefineColor, and TintSelection
bAdjustLayout true Adjust page layout to new colum
commands guides
The GetColor, GetColorInfo, GetColorNames, false Do not adjust page layout
GetColorPalette and GetTint queries
specify a unit of measure for xGutter (e.g., i fo
ColorPalette bState inches), PageMaker uses the default unit of
Displays or removes the Colors palette—a scrol- measure, specified in the Preferences dialog bo
lable window that lists the colors available for the with the MeasureUnits command.
text and graphics in the publication.
cPage defaults. If you do not specify the cPag
Parameter Values to enter parameter, PageMaker places the columns bas
on how the publication was set up (with the
bState off or 0 (zero) to close the Colors palette
PageOptions command) and on the page displ
on or 1 to display the Colors palette
when the plug-in or script is run. The defaults
PageMaker uses are:
Example. The following example turns the Colors
palette on.
• bothpages if the publication is set up with fa
pages
colorpalette 1
• leftpage if the publication is set up with dou
sided pages and a left page is on the pasteboar
See also:
• rightpage if the publication is set up with
The Color, PickColor, and TintSelection com- double-sided pages, and a right page is on the
mands pasteboard
The GetColor, GetColorInfo, GetColorNames,
Layout view only. The ColumnGuides comm
GetColorPalette, and GetTint queries
Example. The following example creates two
ColumnGuides nColumns, xGutter[, evenly sized columns with a 0.2-inch gutter on
cPage, bAdjustLayout] each of the facing pages (specified with the
Creates evenly sized columns with the specified PageOptions command). PageMaker uses defa
gutter size on the currently displayed page or values for the cPage parameter.
pages. columnguides 2, .2i
nColumns Number of columns for the pages

See also:
The DefineMasterPage, PageMargins, and
xGutter Space between columns
PageOptions command
cPage bothpages or 0 if these settings are the The GetPageOptions and GetColumnGuides q
same for facing pages
ries
leftpage or 1 if these settings are for left-
page guides
rightpage or 2 if these settings are for

right-page guides
Related titles

Related titles


ADOBE PAG
ControlPalette bState Pasting outside of PageMaker for Macintosh.

PageMaker for the Macintosh cuts and copies
Displays or removes the Control palette.
selected objects to its internal clipboard, not to
Parameter Values to enter standard Macintosh Clipboard. To paste
PageMaker objects into another application, y
bState off or 0 (zero) to close the palette
must force PageMaker to render its internal
on or 1 to display the palette
clipboard into the Macintosh Clipboard by us
dontcare or -2 to leave display state of the RenderClip command. For example, follow
Control palette unchanged
Copy command with the RenderClip comman
specifying out or 1 for the bDirection parame
Example. The following example closes the
selectall
Control palette.
copy
controlpalette 0 renderclip out
Story editor: no copying from d ialog boxes.
See also: Unlike Copy on the Edit menu, the Copy
command does not copy text from the Find,
The SuppressPalDraw command
Change, or Spell dialog boxes. Instead, it copie
The GetControlPalette and GetSuppressPalDraw selected text in the current story, regardless of
queries
whether one of the dialog boxes is displayed.
Example. The following example selects all th
ConvertEnhMetafile objects on the page (or all the text in a story if a
block contains the text insertion point) and co
(Windows only) Converts the selected enhanced
them to the Clipboard.
metafile into a Windows metafile. The enhanced
metafile must be stored in the publication. selectall
copy
Example. This example selects the first object
drawn and converts it to a Windows metafile.
select 1--selects the first-drawn object on the
See also:
page The Select, SelectAll, and RenderClip comman
c o n v e r t e n h m e t a fi l e - - co n v e r t s t h e s e l e c t e d
metafile
CreateIndex sTitle, bReplace, bBoo
bRemove, bHiddenLayers
See also:
Creates an index.
The GetObjectList, GetOb jectLoc, GetSelec-
tIDList, GetTransform, and GetLineStyle queries Parameter Values to enter
sTitle Title for index, in quotation marks (to

maximum of 31 character
Copy "" (empty quotation marks) for no tit
Copies the currently selected text or graphics to the
bReplace off or 0 to create a new index
Clipboard, from which it can be pasted elsewhere.
on or 1 to replace existing index
Related titles

Related titles


ADOBE PAG
Parameter Values to enter CreatePolygon nPoints, xLocation

yLocation1, xLocation2, yLocation2,
bBook off or 0 to include entries from only cur-
rently open publication xLocation2, yLocation2 [...,xLocationN
on or 1 to include entries from all publi-
yLocationN]
cations in book list Creates an open, irregular polygon.
bRemove off or 0 to include all topics in index
on or 1 to remove unreferenced topics
nPoints Number of points in the polygon
bHiddenLayers true include index items from hidden
For each of the points in the polygon
layers
specify a pair of coordinates.
false do not include items f rom hidden
xLocation x coordinate of the point
layers.
yLocation y coordinate of the point
Index without a title. To create an index without a
title, enter a pair of quotation marks with nothing
Note. A polygon has a minimum of 3 points and
between them for sTitle ("").
maximum of 100 points.
Formatting the index. To specify the format of the
Layout view only. The CreatePolygon comma
index, the IndexFormat command must precede
the CreateIndex command. If you do not specify
the format, PageMaker uses the default settings. Example. The following example draws an op
irregular, three-sided polygon.
Placing a new index. When you create a new
index (by entering 0 as the bReplace value), createpolygon 3, 1i, 1i, 2i, 1i, 1i, 2i
PageMaker does not place the file on the page, but
displays the loaded text icon. To place the index, See Also:
follow CreateIndex with the Place command.
The PolygonMiterLimit, PolygonType, and
Example. The following example creates an index PolygonVertices commands
with no title and specifies that PageMaker replace The PolygonMiterLimit, GetPolygonType, and
the existing index, include entries from only the GetPolygonVertices queries
open publication, remove unreferenced topics and
include index items from hidden layers.
createindex "", 1, 0, 1, true
CreateTOC sTitle, bReplace, bBook,
cFormat[, sBetString, bHiddenLayers]
Creates a table of contents.
See also:
The IndexFormat and Place commands Parameter Values to enter
sTitle Title of table of contents, in quotatio

marks (to a maximum of 31 characte
"" (empty quotation marks) for no tit
bReplace off or 0 (zero) to create a new table o

contents
on or 1 to replace an existing table o

contents
Related titles

Related titles


ADOBE PAG
Parameter Values to enter See also:

The Place command
bBook off or 0 (zero) to include only currently
open publication in table of contents
on or1 to include all publications in book

list Crop cHandle, xyLocation[, yLocation
cFormat nonumber or 0 (zero) to omit page num-
Crops the selected imported image.
bers from table of contents
numberbefore or 1 to have page num-
bers appear before entry cHandle Handle to drag when cropping objec
numberafter or 2 to have page numbers Side handles:

appear after entry
left or 0
sBetString Characters to be inserted between entry
right or 2
and page number, in quotation marks (to
a maximum of seven) top or 3
bHiddenLayers true include table of contents items from bottom or 4

hidden layers
Corner handles:
false do not include table of contents
items from hidden layers. lefttop or 5
leftbottom or 6
Use sBetString only with cFormat. Use the righttop or 7
sBetString parameter only if you specify page
rightbottom or 8
numbers with the cFormat parameter.
xyLocation x or y coordinate, relative to the curr
Table of contents without a title. To create a table zero point, to which you want the sp
of contents without a title, enter the value for sTitle fied part dragged. If cHandle is a cor
as a pair of quotation marks with nothing between (that is, lefttop, leftbottom, righttop, o
rightbottom), both the x and y coord
them ("").
nates are required.
Placing a new table of contents. When you create yLocation y coordinate, relative to the current z
a new table of contents (by entering 0 as the point, to which you want a corner
bReplace value), PageMaker does not place it on dragged
the page, but displays the loaded text icon. To place
the new table of contents, follow CreateTOC with Measurement units for scripts. If you do not
the Place command. specify a unit of measure for xyLocation (e.g.,
inches), PageMaker uses the default unit of
Example. The following example creates a table of
measure, specified in the Preferences dialog bo
contents, titled "Contents," which replaces an
with the MeasureUnits command.
existing table of contents, does not include book
publications, and specifies that the page number Crop single images only. The Crop command
comes after the entry. The character between the crop only one image at a time; if more than on
entry and page number is a tab, which results in a image is selected, the plug-in or script stops
right-aligned page number preceded by leader running.
dots. The table of contents includes entries from
Crop imported images only. The Crop comm
hidden layers.
can crop only imported images, not graphics
createtoc "Contents" 1, 0, 2, "^t", true drawn with the Box, Line, and Oval command
the respective drawing tools.
Related titles

Related titles


ADOBE PAG
cHandle for transformed objects. (See illus- Story editor: no cutting from dialog boxes.
tration below.) If the selected object was skewed, Unlike Cut on the Edit menu, the Cut comma
rotated, or reflected, cHandle should correspond does not cut text from the Find, Change, or Sp
to the handle before the object was transformed. dialog boxes. Instead, it cuts the text selected in
For example, lefttop always refers to the original current story, regardless of whether one of the
left-top handle of an object, not to the handle that dialog boxes is displayed.
is currently the left-most top handle.
Example. The following example selects all
objects on the page (or all text in a story if a te
block contains the text insertion point) and cu
them to the Clipboard.
selectall
Layout view only. The Crop command works cu t
only in layout view.
Example. The following example selects the first See also:
object drawn and drags the left-bottom handle to
the horizontal and vertical coordinates (four The Select, SelectAll, and RenderClip comman
inches and two inches, respectively).
select 1 DefaultPrintClrSpace
crop leftbottom 4i, 2i
See also: sColorSpace

The Select command Sets the color space for the print job.
The GetCropRect query Parameter Values to Enter
sColorSpace Color space for the print job, one of t

following values: "Gray", "CMYK", "RG
Cut or "CMY".
Cuts selected text or graphics to the Clipboard.
Example. The following example sets the def
Pasting outside of PageMaker for Macintosh.
color space to RGB.
PageMaker for the Macintosh cuts and copies
selected objects to its internal clipboard, not to the defaultprintclrspace "RGB"
standard Macintosh Clipboard. To paste
PageMaker objects into another application, you
See also:
must force PageMaker to render its internal
clipboard into the Macintosh Clipboard by using The GetDefaultPrintClrSpace query
the RenderClip command. For example, follow the
Cut command with the RenderClip command,
specifying out or 1 for the bDirection parameter:
selectall
copy
renderclip out
Related titles

Related titles


ADOBE PAG
DefaultDir sPath DefineColor sColorName, cType,

Sets the specified path as the default folder for cModel, bOverprint, d1, d2, d3[, d4,
subsequent commands that access files. sBaseColor, [nInks (sInkName,
dInkLevel)...]]
Defines a new color or tint and adds it to the
sPath Path, in quotation marks, to desired disk Colors palette, or redefines an existing color.
and folders (to a maximum of 91 charac-
ters) Parameter Values to enter
sColorName Name of the new color or color bein

Default folder reset. PageMaker automatically redefined, in quotation marks (to a m
resets the default folder to the folder last accessed mum of 31 characters). If redefining a
when opening, placing, exporting, or saving with existing color, the name must exactly
match the name in the Colors palett
either File > Save As or the SaveAs command.
cType spot or 0 for spot color
No trailing backslash; trailing colon optional. In
PageMaker for Windows, do not end your path process or 1 for process color
with a backslash. In PageMaker for the Macintosh, tint or 2 for tint

while you can end the path with a colon, it is not hifi or 3 for high-fidelity color (you m
required. The GetDefaultDir query returns the set cModel to multiink)
Windows path without the backslash (unless it is
cModel rgbpct or 0 for RGB color model,
the root folder, for example, c:\) and the Macintosh expressed in percentages
path with a trailing colon.
cmyk or 1 for process color model
Specified folder doesn't exist. If the default folder hls or 2 for HLS color model
specified in the sPath parameter does not exist,
multiink or 4 for multi-ink model (yo
PageMaker returns to the current default folder. must set cType to hifi or 3)
Examples . The following example sets the default rgb255 or 5 for RGB color model,
path to the disk "mydisk" and the "artfiles" folder expressed in units from 0 to 255
on the Macintosh. bOverprint false or 0 to knockout objects of this
color
defaultdir "mydisk:artfiles"
The following example sets the default path to the true or 1 to overprint
folder "mydir" and the "mysubdir" subfolder in d1 Percentage of red if cModel equals rg
Windows. pct (0)
d e f a u l t d i r " c : \ m y d i r \ my s u b d i r " Units of red if cModel equals rgb255

from 0 to 255
Percentage of cyan if cModel equals

See also: either cmyk (1) or multiink (4)
The GetDefaultDir query Degrees hue if cModel equals hls (2)
Percentage of base color for a tint
Related titles

Related titles


ADOBE PAG

Tints. You can base a tint only on an existing c
in the Colors palette. To use a color in a color
d2 Percentage of green if cModel equals library, you must first add the color to the Col
rgbpct (0)
palette; then define the tint.
Units of green if cModel equals rgb255
(5), from 0 to 255 You can base a tint on another tint as long as t
Percentage of magenta if cModel equals logic isn't circular (for example, a slate green b
either cmyk (1) or multiink (4) on moss green which is, in turn, based on slate
Percentage of lightness if cModel equals green creates a circular definition and is not
hls (2) allowed).
0 for a tint Color name restrictions. A color name canno
d3 Percentage of blue if cModel equals rgb- exceed 31 characters and, in English-language
pct (0) versions of PageMaker, cannot be: Process Cya
Units of blue if cModel equals rgb255 (5), Process Magenta, Process Yellow, Process Black
from 0 to 255 Black, black, Registration, or registration. In n
Percentage of yellow if cModel equals English language versions, PageMaker restricts
either cmyk (1) or multiink (4) color names equivalent to those just mentione
Percentage of saturation if cModel Values truncated. Use whole percentages for
equals hls (2)
d2, d3, and d4; otherwise PageMaker will trun
0 for a tint the values.
d4 Percentage of black if cModel equals Assigning color to text or graphics. Choose th
cmyk (1) or multiink (4)
Color command when you want to assign a co
0 for a tint or if cModel equals rgbpct (0), to text or graphics. If you use DefineColor and
hls (2), or rgb255 (5)
Color together, put DefineColor first.
sBaseColor Name of base color to use for tint (when
cType is set to tint)
Editing EPS colors. You cannot edit process co
imported with an EPS image. Attempts to edit
"" (empty quotation marks) if not defin-
ing a tint process colors will result in an error. You can,
however, edit spot colors imported with an EP
nInks Number of high-fidelity ink names and
image.
percentages to follow
Example. The following example creates the c
For each high-fidelity ink:
Rose based on a 35% tint of the color Pink.
sInkName Name of ink
definecolor "Rose", tint,,,35,,,,"Pink"
dInkLevel Percentage of specified ink coverage The following example creates the process col
value between 0.0 and 100.0
Peach using the CMYK color model. Peach is
Adding a color from a color library. To add a color composed of 15% cyan, 30% magenta, 10% yel
from a color library to the Colors palette, use the and no black.
PickColor command. definecolor "Peach", process,CMYK,,15,30,1
Using an installable color picker. To use an

installable color picker with PageMaker, use the See also:
PickColor command. The PickColor command
HiFi colors. When you define a HiFi color, you The GetColor, GetColorInfo, and GetColorNa
must specify its CMYK values as well (which are queries
used for composite printing).
Related titles

Related titles


ADOBE PAG
DefineInk sInkName[, sAngle, sRuling, DefineMasterPage sMasterName,

dDefaultND] bOverwrite, bSpread, xLeftOrInside, yT
Defines (or redefines) the screen angle, screen xRghtOrOutsd, yBottom, nColumns,
ruling, and default neutral density value for the xGutter[, nColumnRightPage,
specified HiFi ink. xGutterRghtPg]

Creates or redefines the named master page,
setting the specified margins and columns. Tu
sInkName Name of HiFi ink (no tints), in quotation to the specified master.
marks (to a maximum of 31 characters). If
redefining an existing ink, the name Parameter Values to enter
must exactly match as it appears in the
Print dialog box. sMasterName Master-page name to define or rede
(maximum of 31 characters; cannot b
sAngle Screen angle, in quotation marks, from Document Master or None)
"0.0" to "360.0"
bOverwrite false or 0 (zero) to leave existing ma
"" (empty quotation marks) to leave
unchanged (if one exists with same
angle unchanged
name)
sRuling Screen ruling (frequency), in quotation true or 1 to overwrite existing maste
marks for specified ink, from "1.0" to one exists with same name)
"500.0"
bSpread false or 0 (zero) for a one-page mast
"" (empty quotation marks) to leave rul-
ing unchanged true or 1 for a two-page master spre
dDefaultND Default neutral density for ink (to 3 deci- dontcare or -2 if redefining an existi
mal places), from 0.000 to 10.000 master page (you cannot change this
ting when redefining)
dontcare or -2 to leave value unchanged
default or -1 to use current Docume
Master setting
Example. The following example defines
HiFiGreen with a 45-degree screen angle, a screen xLeftOrInside Inside (or left) margin
ruling of 60, and a default neutral density of 0. -2 to leave margin unchanged (use on
redefining an existing master page)
defineink "HiFiGreen", "45", "60", 0.000
-1 to use current Document Master s
ting
See also: yTop Top margin
The DefineColor, InkND, and PrintInk com- -2 to leave margin unchanged (use on
mands redefining an existing master page)
The GetColor, GetColorInfo, GetColorNames, default or -1 to use current Docume
GetInkNames, and GetInkND queries Master setting
xRghtOrOutsd Outside (or right) margin
-2 to leave margin unchanged (use on

-1 to use current Document Master s

ting
Related titles

Related titles


ADOBE PAG

Unique names. When you create a new maste
page, make sure you are not overwriting an
yBottom Bottom margin existing master page. Use the GetMasterPageLi
-2 to leave margin unchanged (use only if determine the names of all existing master pa
Modifying Document Master. You cannot mo
-1 to use current Document Master set-
ting
the Document Master using the DefineMasterP
command. To change the margins of the
nColumns Number of columns either on a single Document Master, use the PageMargins
page if the master is a single page, or on
the left page if the master is a two-page command. To change its column guides, displ
spread the Document Master (using the Page comma
-2 to leave number of columns and use the ColumnGuides commands.
unchanged (use only if redefining an
existing master page)
Cannot change spread. You cannot change th
spread setting of an existing master page. If you
ting
redefining a master page, you must set bSprea
-2. Otherwise PageMaker returns an error. (If
xGutter Space between columns on a single page set bSpread to -2 and the named master doesn
or the left page of a two-page spread
exist, PageMaker also returns an error.)
-2 to leave gutter unchanged (use only if
redefining an existing master page) Example. The following example creates the
master spread "ad layout master" (unless a ma
ting page with the same name already exists). The
settings for the master page are: an inside mar
nColumn- Number of columns on the right page of
RightPage a two-page spread of 1 inch, a top margin of 0.5 inches, an outsid
margin of 0.75 inches, and a bottom margin o
Ignored if master is a single page
inches; both pages have two columns with a 0
-2 to leave number of columns inch gutter between the columns.
unchanged (use only if redefining an
existing master page) definemasterpage "ad layout master", false, tr
-1 to use current Document Master set- 1i, .5i, .75i, .5i, 2, .2i, 2, .2i
ting
xGutterRghtPg Space between columns on the right See also:

page of a two-page spread
The ColumnGuides, DeleteMasterPage, Maste
Ignored if master is a single page
Page, Page, PageMargins, RenameMasterPage,
-2 to leave gutter unchanged (use only if SaveAsMasterPage commands
The GetMasterPage, GetMasterPageInfo, and
-1 to use current Document Master set- MasterPageList queries
ting

specify a unit of measure for the margins and
Delete
gutters (e.g., i for inches), PageMaker uses the Deletes the selected text, text block, or graphic
default unit of measure, specified in the Prefer- Delete equals Clear. This command is identic
ences dialog box or with the MeasureUnits the Clear command.
command.
Related titles

Related titles


ADOBE PAG
Example. The following example selects all Measurement units for scripts. If you do not
objects on the page (or all text in a story if a text specify a unit of measure (e.g., i for inches),
block contains the insertion point) and deletes PageMaker uses the default unit of measure,
them. specified in the Preferences dialog box or with
selectall
delete Determining drawing order. Remember that
drawing order is determined by the order in w
the guide was drawn on the page, not its posit
See also:
on the page.
The Clear command
Layout view only. The DeleteHoriz command
DeleteContent Example. The following example deletes two
Deletes the content, whether text or a graphic, guides: the horizontal guide seven inches from
from the selected frame. This removes the frame's current location of the rulers' zero point and t
content from the publication. To remove the third horizontal guide drawn.
content from the frame, but keep it in the publi- deletehoriz 7i
cation as an independent item, use the Separate- deletehoriz guide 3
Content command.
Layout view only. The DeleteContent command See also:
The DeleteVert command
Example. The following example deletes content
from the selected frame and from the publication.
deletecontent DeleteLayer sFromLayer, sToLayer
Deletes a layer and moves its objects to anothe
layer, or removes a layer and its objects altoget
See Also:
The AttachContent, BreakLinks, FrameContent- Parameter Values to Enter
Pos, FrameInset, LinkFrames, SeparateContent, sFromLayer Name of the layer to be deleted

and ToggleFrame commands
sToLayer Name of layer to move objects to, or
The GetFrameContentPos, GetFrameInset, GetFr- delete the objects
ameContentType, GetIsFrame, and GetNext-
Frame queries
Layout view only. The DeleteLayer command
DeleteHoriz yLocation Example . The following example removes th
Deletes the specified horizontal guide, using either layer "Notes" and all of its contents.
its location or drawing-order number. deletelayer "Notes", ""
yLocation y coordinate of the horizontal guide to See Also:

be deleted, relative to rulers' zero point The AssignLayer, DeleteUnusedLayers, LayerO
guide #, where # is the drawing-order tions, LockLayers, MoveLayer, NewLayer, Past
number of the guide (e.g., deletehoriz emembers, SelectLayer, ShowLayers, and
guide 2) TargetLayer commands
Related titles

Related titles


ADOBE PAG
The GetLayerFromID, GetLayerList, GetLayerOp- Parameter Values to enter

tions, GetPasteRemembers, and GetTargetLayer
queries cTargetClass classobject for imported graphics an
images, and for PageMaker lines, box
ovals, polygons, and text blocks
classstory for stories
DeleteMasterPage sMasterName
classpub for publication (current pu
Deletes the specified master page and sets None as
cation only)
the master page of any pages to which the deleted
classpage for page
master had been applied.
classmaster for master page
Document Master and None. You cannot delete
dontcare or -2 to delete all private d
the prenamed master pages, Document Master
associated with specified sDevelope
and None. and sPlugInID
Example. The following example deletes the nTypeFlag Identifier you defined to distinguish
master page named TOC. between types of private data for sam
cTargetClass
deletemasterpage "TOC"
dontcare or -2 to delete all private d
for specified cTargetClass and associa
with specified plug-in, or if cTargetC
See also: is dontcare or -2
The DefineMasterPage, MasterPage, RenameMas-
nCount Number of deletions
terPage, and SaveAsMasterPage commands
1 if nTypeFlag is set to dontcare or -2
The GetMasterPage, GetMasterPageInfo, and Get-
MasterPageList queries nTargetID Internal PageMaker identifier for elem
(graphic, image, text block, page, ma
page, or story) to which private data
associated
DeletePrivateData sDeveloperID,
0 (zero) for publication (PageMaker
sPlugInID, cTargetClass, nTypeFlag,
deletes private data in current public
nCount, (nTargetID)... tion only)
Deletes the private data and private strings dontcare or-2 to delete all private da
associated with the specified input criteria. Using for all elements in specified cTargetC
and associated with a specified nTyp
dontcare or -2 for parameter values, you can delete Flag, or if nTypeFlag is set to dontcar
all private data and strings associated with any of -2
the following: your plug-in; your plug-in and a
class of objects; your plug-in, a class of objects, and Errors. PageMaker returns an error if:
a private ID; or your plug-in, a class of objects, a
• The specified element has no private data
private ID, and a specific element.
associated with the specified plug-in and
Parameter Values to enter nTypeFlag (CQ_NOPDATA).
sDeveloperID Four-character string representing your • cTargetClass and nTargetID together do not
name or your company name, in quota- specify an existing element (graphic, image, te
tion marks (e.g., ADBE for Adobe)
block, page, master page, story, or publication
sPlugInID Four-character string representing the (CQ_INVALID_TARGET).
plug-in, in quotation marks (e.g., KYLN
for Keyline plug-in) • nTypeFlag is -1 (CQ_INVALID_CONTEXT
Related titles

Related titles


ADOBE PAG
Five parameters needed to identify data. The DeleteRulerGuides

Layout view only.
PageMaker requires five parameters to identify command works only in layout view.
private data:
Example. The following example deletes all r
• sDeveloperID and sPlugInID to identify the guides on the current page.
plug-in. deleterulerguides
• cTargetClass and nTargetID to identify the
element being assigned the data.
• nTypeFlag to distinguish between data types DeleteUnusedLayers bSkipUI
(you define this parameter). Deletes all the unused layers in a publication.
Dontcare or -2. If you set any parameter to Parameter Values to Enter
dontcare or -2, you must set all subsequent param-
bSkipUI Off or 0 prompts the user for confirm
eters to dontcare or -2 as well, except nCount, tion before the layers are deleted
which must be set to 1. If you set cTargetClass to -
On or 1 deletes the layers without
2, then set nTypeFlag and nTargetID to -2 and set prompting the user for confirmation
nCount to 1.
Examples. The following example deletes all Example. The following example deletes all of
private data of all ClassObject elements that are unused layers without prompting the user for
associated with ADBE and KYLN and have a confirmation.
private ID of 15.
d e l e t e u n u s e d l a y er s 1
deleteprivatedata "ADBE", "KYLN", classobject,
15, 1, dontcare
See Also:
The following example deletes all private data of all
ClassObject elements that are associated with The AssignLayer, DeleteLayer, LayerOptions,
ADBE and KYLN. LockLayers, MoveLayer, NewLayer, PasteRem
bers, SelectLayer, ShowLayers, and TargetLaye
deleteprivatedata "ADBE", "KYLN", classobject, commands
dontcare, 1, dontcare The GetLayerFromID, GetLayerList, GetLayer
The following example deletes all private data in tions, GetPasteRemembers, and GetTargetLay
the publication that is associated with ADBE and queries
KYLN.
deleteprivatedata "ADBE", "KYLN", dontcare,
dontcare, 1, dontcare
DeleteVert xLocation
Deletes the specified vertical guide, using eithe
location or drawing-order number.
See also:
The PrivateData and PrivateString commands
The GetPrivateData, GetPrivateList, and GetPri- xLocation x coordinate of the vertical guide to
deleted, relative to rulers' zero point
vateString queries
guide #, where # is the drawing-orde
number of the guide (e.g., deletehor
guide 2)
DeleteRulerGuides
Deletes all ruler guides on the current page.
Related titles

Related titles


ADOBE PAG
Measurement units for scripts. If you do not Dictionary sLanguage

specify a unit of measure (e.g., i for inches),
Selects the language dictionary for hyphenatio
PageMaker uses the default unit of measure,
and spelling. The extent of the action depends
specified in the Preferences dialog box or with the
which tool is active, whether any text is selecte
and whether a publication is open when the
Determining drawing order. Remember that command is executed.
drawing order is determined by the order in which
the guide was drawn on the page, not its position
on the page. sLanguage Name of language dictionary, in quo
tion marks and exactly as it appears
Layout view only. The DeleteVert command Dictionary list box
works only in layout view. "none" (quotation marks required) t
choose no language dictionary
Example. The following example deletes two
guides: the vertical guide 3.2 inches from the
current location of the rulers' zero point and the Dictionary must be installed. The dictionary
first vertical guide drawn. specify must be installed.
deletevert 3.2i Example. The following example specifies the

deletevert guide 1 United Kingdom English dictionary for hyphe
ation and spell-checking.
See also: dictionary "UK English"
The DeleteHoriz command

See also:
The GetDictionary query
Deselect
Changes the active tool to the pointer tool (if
necessary) and deselects all currently selected text DisplayNonPrinting [bState]
or graphics. Displays or hides all nonprinting objects (text
Deselect emulates clicking. The Deselect blocks and graphics that have the nonprinting
command is identical to clicking a nonselectable attribute applied).
area of the publication window, such as the paste- Parameter Values to enter
board or the margin of the page.
bState off or 0 to hide nonprinting objects
Layout view only. The Deselect command works
on or 1 to display nonprinting objec
only in layout view. (the default)
Example. The following example deselects text or

graphics. If you do not specify the bSt
bState defaults.
parameter, PageMaker displays the nonprintin
deselect
objects.
See also:
The SelectAll command
The GetSelectList and GetSelectInfo queries
Related titles

Related titles


ADOBE PAG
Example. In the following example, all DisplayStyleNames bDisplay

nonprinting items (text blocks and graphics that
Displays or hides paragraph style names in a
have the nonprinting attribute applied) are
sidebar in the left margin of the story active in
displayed on screen when you turn to the pages
story editor.
containing them.
displaynonprinting on
bDisplay off or 0 to hide paragraph style nam
See also: on or 1 to display paragraph style na
The NonPrinting command

The DisplayStyleNames
Story editor only.
The GetDisplayNonPrinting and GetNonPrinting
command works only in story editor.
queries
If story ed
Plug-ins and external sc ripts only.
DisplaySpecial bDisplay CQ_LO_INVALID_MODE and disregards the
Displays or hides special characters in the story command.
active in story editor. Characters displayed include Example. The following example switches to s
spaces, tab characters, hard returns, and soft editor and displays paragraph style names.
returns (Shift-Return).
editstory
Parameter Values to enter displaystylenames on
bDisplay off or 0 to hide special characters
on or 1 to display special characters See also:

The DisplaySpecial command
Story editor only. The DisplaySpecial command The GetDisplayStyleNames query
works only in story editor.
If story editor
Plug-ins and external s cripts only.
is not active, PageMaker returns DragSelect xLeft, yTop, xRight,
CQ_LO_INVALID_MODE and disregards the yBottom
command. Deselects the current selection and then select
Example. The following example switches to story of the objects enclosed within the rectangle
editor and displays special characters. specified.
editstory Parameter Values to Enter
displayspecial on xLeft x coordinate, relative to the current z

point, of the left side of the area to b
selected
See also:
yTop y coordinate, relative to the current z
The DisplayStyleNames command point, of the top side of the area to b
The GetDisplaySpecial query selected
xRight x coordinate, relative to the current z

point, of the right side of the area to
selected
Related titles

Related titles


ADOBE PAG
Parameter Values to Enter See Also:

The DragSelect, Select, SelectAll, SelectExtend
yBottom y coordinate, relative to the current zero
point, of the bottom side of the area to SelectID, and SelectIDExtend commands
be selected The GetSelectIDList and GetSelectInfo querie
Layout view only. The DragSelect command

works only in layout view. EditLayout
Example. The following example selects all of the Switches to layout view of the current publicat
objects in an 8.5 by 11 inch area, starting at the zero
Story editor only. The EditLayout command
point.
dragselect 0i, 0i, 8.5i, 11i
Location displayed depends on active story.
Which page or pages PageMaker displays in lay
See Also: view depends upon the story active at the time
The DragSelectExtend, Select, SelectAll, SelectEx- command is sent. If the active story:
tend, SelectID, and SelectIDExtend commands • Has been placed, PageMaker turns to the pa
The GetSelectIDList and GetSelectInfo queries (or pages, for facing pages) containing the
insertion point or selected text. The story rem
open in story editor, though inactive.
DragSelectExtend xLeft, yTop,
• Has not been placed, PageMaker returns to t
xRight, yBottom
previously active page (or pages, for facing pa
Adds the objects that are enclosed within the and displays the loaded text icon.
specified area to the current selection list.
• Is empty, PageMaker closes the empty story
Parameter Values to Enter window and returns to the previously active p
xLeft x coordinate, relative to the current zero (or pages, for facing pages).
point, of the left side of the area to be
Plug-ins and external sc ripts only. If story ed
selected
yTop y coordinate, relative to the current zero CQ_LO_INVALID_MODE and disregards the
point, of the top side of the area to be
selected
command.
xRight x coordinate, relative to the current zero

Example. The following example switches to
point, of the right side of the area to be layout view of the currently active publication
selected
editlayout
yBottom y coordinate, relative to the current zero
point, of the bottom side of the area to
be selected See also:
The EditStory command
The DragSelectExtend
Layout view only.
The GetPMState query
command works only in layout view.
Example. The following example selects all of the
objects in an 8.5 by 11 inch area without
deselecting any objects that were already selected.
dragselectextend 0i, 0i, 8.5i, 11i
Related titles

Related titles


ADOBE PAG
EditOriginal sAppFilename Example. The following example exits

PageMaker.
Launches the originating application (or the
specified application) of the selected linked exit
graphic or story.
Parameter Value to enter See also:
sAppFilename Exact name of application to be

The Close, Save, SaveAs, and Quit commands
launched, in quotation marks, including
optional pathname to folder and disk (to
a maximum of 91 characters for each
name and path)
Export fFilename, sFormat[, bTags]
Exports text from the text block that currently
System 7 required on Macintosh. To use this contains the insertion point to the specified
command on the Macintosh, you must run the filename, using the selected format.
plug-in or script under System 7.0 or later. Parameter Values to enter
Example. The following example selects the first fFilename Exact name of file to which selected
object drawn and launches the application that is to be exported, including optional
created it. pathname to folder and disk, in quot
tion marks (to a maximum of 91 char
select 1 ters for each name and path)
e d i t o r i g i n a l " m y d i s k : m y f o l d e r : Wo r d "
sFormat File format, in quotation marks and
exactly as it appears in File Format lis
box (to a maximum of 31 characters)
EditStory bTags false or 0 (zero, default)
Invokes the story editor. true or 1 to export tags (style names
Layout view only. The EditStory command works

only in layout view. Range or entire story. Unlike the options in t
Export dialog box, this command does not pro
Example. The following example switches a parameter to explicitly choose Entire Story o
PageMaker to the story editor. Selected Text Only. If there is a selection range
editstory the story, PageMaker exports it; otherwise,
PageMaker exports the entire story.
Exporting style names. The bTags parameter
Exit exports the style names with the exported file
Exits (quits) PageMaker without saving the They appear in angle brackets at the beginnin
changes to the open publications. each paragraph. Later, if the file is placed in
PageMaker, PageMaker uses the styles to form
Caution: No prompt for unsaved or changed publi-
the text.
cations. Unlike its menu counterpart, the Exit
command does not warn you if you have not saved Caution: No prompt for overwriting files. Un
the latest changes to a publication, nor does it its menu counterpart, the Export command d
prompt you to name an unnamed publication. Use not prompt you if a file with the same name
the Save or SaveAs commands if you want to save already exists. Instead, PageMaker overwrites
changes to the open publications. file directly.
Related titles

Related titles


ADOBE PAG
Example. The following example exports selected Parameter Values to enter

text to "myfile," in text-only format and with style
names attached. sFillColor Name of color, in quotat
marks, exactly as it appe
e x p o r t " m y d i s k : m y f o l d e r : m y fi l e " , " Te x t - o n l y " , on Colors palette (to a m
mum of 31 characters)
true
"dontcare" to leave the
color unchanged (quota
See also: marks required)
The GetExportFilters query bFillOverprint off or 0 to knockout any

tion of an element posi-
tioned beneath object
FillAndLine cFillStyle, sFillColor, on or 1 to print all overla

ping elements
bFillOverprint, cLineStyle, bReverse,
dWeight, bOpaque, sLineColor, cLineStyle dontcare or -2 to leave t
line style unchanged
bLineOverprint[, nFillTint, nLineTint]
Sets the fill and line attributes of the selected none or 0 (zero)
objects: style, color, overprint attribute, weight hairline or 1

(lines only), and tint percentage. Acts on
PageMaker-drawn objects only. halfpoint or 2
Parameter Values to enter onepoint or 3
cFillStyle dontcare or -2 to leave style twopoint or 4

unchanged
fourpoint or 5
none or 0 (zero)
sixpoint or 6
paper or 1
eightpoint or 7
solid or 2
twelvepoint or 8
vertfew or 9
thinthin or 9
vertlots or 10
thickthin or 10
horizfew or 11
thinthick or 11
horizlots or 12
thinthickthinor 12
diagfew or 13
thindash or 13
diaglots or 14
mediumdash or 14
hashfew or 15
thickdash or 15
hashlots or 16
squares or 16
dots or 17
Related titles

Related titles


ADOBE PAG

PageMaker objects only. The FillAndLine
command applies only to objects drawn in
customsolid or 31 for a PageMaker, not imported objects.
solid line of weight specified
by specified by dWeight dWeight overrides cStyle. Set the dWeight
bReverse off or 0 for normal parameter to dontcare or -2 unless you are defin
a custom line. The value of dWeight overrides
on or 1 for reverse line
line weight specified in cStyle.
dontcare or -2 to leave set-
ting unchanged dWeight truncated. If dWeight includes more
than one decimal place, PageMaker truncates
dWeight Weight of custom line, in
points (precise to one deci- value to tenths of a point. For example, 12.19
mal place) becomes 12.1 points.
dontcare or -2 to leave Text tool, story editor, or no object. If the tex
existing line weight
unchanged or for pre-
tool is active, the command results in an error
defined line weight (e.g., either the story editor is active or no PageMak
hairline) objects are selected, the specified fill and line
bOpaque false or 0 to make the back- become the default settings for the publication
ground of compound,
dashed, or dotted lines
Tinting and shading objects. In PageMaker 6
transparent; default later, you tint an object's fill using the nFillTin
true or 1 to make the back-
parameter. Earlier versions of PageMaker set s
ground of compound, fills from 10 percent to 80 percent of an objec
dashed, or dotted lines color (tenpct or 3 to eightypct or 8). To duplic
opaque
these fill styles, set cFillStyle to solid (or 2) and
sLineColor Name of color, in quotation nFillTint to the desired percentage, from 0 to
marks, exactly as it appears
on Colors palette (to a maxi- Example. The following example selects the fi
mum of 31 characters) object drawn on the page and sets its fill to a 3
"dontcare" to leave color Red tint. The 20-point line is a 20% Green tin
unchanged (quotation When printing, PageMaker will knockout any
marks required)
portion of an element beneath the fill, but wil
bLineOverprint off or 0 to knockout any por- overprint the line.
tion of an element posi-
tioned beneath the line select 1
fillandline 2, "Red", 0, 31, 0, 20, 0, "Green",
on or 1 to overprint any por-
tion of an element that the 30, 20
line overlaps
nFillTint Percentage of color to apply See also:

to the object fill (from 0 to
100) The FillStyle and LineStyle commands
dontcare or -2 to leave set- The GetFillAndLine , GetFillStyle, and GetLine
ting unchanged (default) Style queries
nLineTint Percentage of color to apply
to the object line (from 0 to
100)
dontcare or -2 to leave set-

ting unchanged (default)
Related titles

Related titles


ADOBE PAG
FillStyle cStyle Find sFindWhat, [cSearchRange],

Applies a fill to the selected object or objects. [bWrapAround], [bMatchCase],
[bWholeWord], [bClearAttr]
Searches for the first instance of the specified t
cStyle none or 0 (zero) in the selected range, the active story, or all sto
none or 0 (zero) of the current publication. Selects the first matc
finds.
paper or 1
solid or 2
sFindWhat Text to search for, in quotation marks
vertfew or 9 cSearchRange selectedtext or 0 to search selected
vertlots or 10 currentstory or 1 to search current s

only, starting from position of inserti
horizfew or 11
allstories or 2 to search all stories in
horizlots or 12 rent publication, starting from beginn
of currently active story
diagfew or 13
default or -1 to use default or previo
defined range
diaglots or 14
dontcare or -2 to let system choose
hashfew or 15 range based on current text selectio
text is selected, the Find command
searches only selected text; if no text
hashlots or 16
selected, the Find command searche
current story only, starting from posi
of insertion point.
Text tool, story editor, or no object. If the text
tool is active, the command results in an error. If bWrapAround stopatend or 0 to stop searching wh
either the story editor is active or no PageMaker PageMaker reaches end of story
objects are selected, the specified fill becomes the wrap or 1 to continue searching from
default fill for the publication. beginning of story when PageMaker
reaches end of story (default setting
Tinting and shading objects. In PageMaker 7.0,
bMatchCase anycase or 0 (zero) to turn off case-se
you tint an object's fill using the FillAndLine tive searching (default setting)
command.
matchcase or 1 to turn on case-sens
Example. The following example selects the searching (match capitalization of sea
text exactly)
second-drawn object and applies a pattern of a few
horizontal lines (as shown in the Fill submenu). bWholeWord allinstances or 0 (zero) to search for
occurrence of specified text (default
select 2 ting), even if text is found within anot
fillstyle 11 word (for example, searching for "sto
could yield "history," as well as "story
wholeword or 1 to search for specifi

See also: text as a whole word only, disregardi
cases where text is embedded withi
The GetFillAndLine and GetFillStyle queries
another word.
Related titles

Related titles


ADOBE PAG

Searching for text attributes only. To search f
text attributes only (e.g., all 10 point, bold tex
bClearAttr useattributes or 0 to use existing Find first use the FindTypeAttr1 and FindTypeAttr
text and paragraph attributes (default
setting) commands to set the desired attributes. (Be su
clear the paragraph attributes with the FindPa
clear or 1 to clear all Find attribute set-
tings aAttr command.) Then, follow with the Find
command: Specify an empty string for sFindW
Story editor only. The Find command works only and set bClearAttr to useattributes or 0. For
in story editor. example, to search for all 10-point, bold text in
publication, the commands are:
Current publication only. Unlike the Find dialog
box, the Find command cannot search multiple findtypeattr2 -3, -3, "Any", -3--to clear the
publications. It can search only the stories in the other type attributes
currently active publication. findparaattr "Any", -3, -3--to clear the
paragraph attributes
Find next. The Find command locates the first
findtypeattr1 "Any", 10, -3, boldstyle, -3, -3
occurrence of the search text. You must repeat the
find "", "", allstories, stopatend, anycase, all
command or use the FindNext command to find
stances, useattributes
the next occurrence of the search text. Use the
Searching for special characters. You enter a
ChangeAll command to change all occurrences of
special character as part of your search text us
the search text.
the same key combinations that you use to ent
bWrapAround. PageMaker disregards the bWrap- the character directly into the Find dialog box
Around parameter when cSearchRange is set to
Scripts palette. Do not use the Find comman
either:
scripts you plan to run using the Scripts palet
• selectedtext (or 0), which confines the search to When PageMaker finds no match or completes
the selected text. search, the Scripts palette interprets this as an e
and stops at that point in the script.
•allstories (or 2), which starts the search at the
beginning of the active story and automatically Plug-ins and external sc ripts only.PageMake
wraps to the beginning of the next story. returns the following codes to indicate the suc
Optional parameters. PageMaker requires only of the search:
the sFindWhat parameter. If you do not include Example. The following example searches the
values for the other parameters, PageMaker uses current story for any instance of the letters "tan
the settings of the last Find, Change, or ChangeAll regardless of the capitalization or attribute sett
command. (If none of these commands has been (paragraph style, font, size, type style, position
executed this session, PageMaker uses the default case). The search begins at the position of the
settings—noted in the parameter list above.) insertion point and wraps to the beginning of
Setting text and paragraph attributes. To search story if necessary.
for text and paragraph attributes (e.g., font, type find "tango", story, wrap, anycase, allinstanc
size, paragraph style), use the FindTypeAttr1, clear
FindTypeAttr2, and FindParaAttr commands,
followed by the Find command with bClearAttr set
to useattributes or 0.
See also:
ChangeTypeAttr2, ChangeWindow , FindNext
Related titles

Related titles


ADOBE PAG
FindParaAttr, FindTypeAttr1, FindTypeAttr2, and --searches only from insertion point to en

FindWindow commands story,
The GetChangeParaAttr, GetChangeTypeAttr1, change "Note", "Tip", allstories, 1, anycase,
GetChangeTypeAttr2, GetChangeWindow , Get- allinstances, clear
FindParaAttr, GetFindTypeAttr1, findnext--finds next instance of "Note",
GetFindTypeAttr2, and GetFindWindow queries --regardless of attributes, searching all sto
The first FindNext command searches for the n

FindNext instance of a 10-point, bold and underlined "T
Searches for the next instance of the text specified matching the whole word and its capitalizatio
in the last Find, Change, or ChangeAll command, The search begins at the location of the insert
using all the same settings. Selects the first match point and stops at the end of the story.
of the search text it encounters. Because of the Change command, the second
Story editor only. The FindNext command works FindNext searches for the next instance of "No
only in story editor. regardless of its capitalization or attributes. Th
search begins from the location of the insertio
Current publication only. Unlike the Find Next
point, but wraps to the next story if necessary
button in the Find dialog box, the FindNext
command cannot search multiple publications. It Scripts palette. Do not use the FindNext
can search only the stories in the currently active command in scripts you plan to run using the
publication. Scripts palette. When PageMaker finds no mat
or completes the search, the Scripts palette int
Repeat as often as needed. You can send this
prets this as an error and stops at that point in
command repeatedly until PageMaker finishes
script.
searching the range specified by the previous Find,
Change, or ChangeAll command. Plug-ins and external sc ripts only.PageMake
returns the following codes to indicate the suc
Last executed Change, ChangeAll, or Find wins.
of the search:
As in the Find and Change dialog box, the Find,
Change, and ChangeAll commands share the Find Example. The following example searches the
What and Change To text, as well as the settings for current story for the first instance of the letter
the search options, range, and attributes. "tango," regardless of the capitalization or attrib
Therefore, you must be careful to know all the settings (paragraph style, font, size, type style,
current settings before you use the ChangeNext position, or case). The search begins at the posi
and FindNext commands. (If you insert a Change of the insertion point and wraps to the beginn
command between the Find and FindNext of the story if necessary. The FindNext comm
commands, the Change search text, options, range, then searches for the next instance of "tango,"
and attributes become the search text and settings using the same search criteria and starting the
used by FindNext.) For example: search from the end of the last encountered
"tango."
boldstyle+underline, -3, -3 find "tango", story, wrap, anycase, allinstanc
changetypeattr1 "Helvetica", 9, -3, boldstyle, -3, clear
-3 findnext
find "Tip", currentstory, stopatend, matchcase,
wholeword, useattributes
See also:
findnext--finds next instance of a bold under-
lined "Tip" The Change, ChangeAll, ChangeNext,
Related titles

Related titles


ADOBE PAG
ChangeParaAttr, ChangeTypeAttr1, All attributes cleared first. The settings you

ChangeTypeAttr2, ChangeWindow , Find, Find- include with the FindParaAttr command repla
ParaAttr, FindTypeAttr1, FindTypeAttr2, and all existing attribute settings.
FindWindow commands
If story editor is
GetChangeTypeAttr2, GetChangeWindow , Get-
GetFindTypeAttr2, and GetFindWindow queries command.
Example. The following example changes all
aligned text in the current publication to full-
FindParaAttr sParaStyle, cAlignment, justified text. Notice that it first sets all other F
cLeadingType and Change attributes to Any.
Sets the paragraph attributes (paragraph style, findtypeattr1 "Any", -3, -3, -3, -3, -3
alignment, and leading method) to be used as the changetypeattr1 "Any", -3, -3, -3, -3, -3
search text in the Find, Change, and ChangeAll findtypeattr2 -3, -3, "Any", -3
commands. changetypeattr2 -3, -3, "Any", -3

findparaattr "Any", left, -3
changeparaattr "Any", justify, -3
sParaStyle Name of style (exactly as it appears in
changeall "", "", allstories, anycase, allinstan
Styles palette), in quotation marks (to a
maximum of 31 characters) useattributes

Any paragraph style (i.e., to not include See also:
paragraph style in search criteria; default
setting) The Change, ChangeAll, ChangeNext,
"No style" (quotation marks required)
for No Style ChangeTypeAttr2, ChangeWindow , Find, Find
ext, FindTypeAttr1, FindTypeAttr2, and FindW
cAlignment any or -3 for Any alignment (i.e., to not
dow commands
include alignment in search criteria;
default setting) The GetChangeParaAttr, GetChangeTypeAttr
left or 0 (zero) for Left
center or 1 for Center GetFindTypeAttr2, and GetFindWindow quer
right or 2 for Right
justify or 3 for Justify
force or 4 for Force Justify
cLeadingType any or -3 for Any leading method (i.e., to

not include leading method in search cri-
teria; default setting)
proportional or 0 (zero) for Proportional
topofcaps or 1 for Top of Caps
baseline or 2 for Baseline
Story editor only. The FindParaAttr command

Related titles

Related titles


ADOBE PAG
FindTypeAttr1 sFontName, Parameter Values to enter

dPointSize, dLeading, cTypeStyle,
cCase any or -3 for Any case (i.e., to not incl
cPosition, cCase case attribute in search criteria; defa
setting)
Sets the text attributes (font, point size, type style,
position, and case) to be used for the search text in allcaps or 1 for All Caps (full-size capi
the Find, Change, and ChangeAll commands. smallcaps or 2 for Small Caps (small
itals)
sFontName Name of font (exactly as it appears on Story editor only. The FindTypeAttr1 comm
Type menu), in quotation marks (to a works only in story editor.
Plug-ins and external scripts. If story editor is
Any font (i.e., to not include font name in
search criteria; default setting) CQ_LO_INVALID_MODE and disregards the
command.
dPointSize Point size of type (from 4.0 to 650.0)
any or -3 for Any size (i.e., to not include Type styles are additive. To set the cTypeStyl
point size in search criteria; default set- parameter to multiple type styles, either separ
ting) the desired style option with the plus sign (+)
dLeading Amount of leading, in points (from 0.0 to add the numeric equivalents for the styles. For
1300.0) example, for bold (1) and underline (4), you c
any or -3 to specify Any leading either set cTypeStyle to boldstyle+underline o
5 (the sum of 1 and 4).
auto or -1 for automatic leading
All attributes cleared first. The settings you
cTypeStyle any or -3 for Any (i.e., to not include type
style in search criteria; default setting) include with the FindTypeAttr1 command rep
all existing attribute settings.
normalstyle or 0 for Normal
Or, any combination of the following Any for cTypeStyle, cPosition, and cCase. Unl
styles, separated by the plus sign (+), or the Type Styles pop-up menu in the Find
the actual sum of their values: Attributes dialog box, the any or -3 setting for
boldstyle or 1 for Bold cTypeStyle pertains only to the type styles Bol
italicstyle or 2 for Italic Italic, Underline, Strikethru, Outline, Shadow,
Reverse. The value of cTypeStyle does not affe
underlinestyleor 4 for Underline
the cPosition and cCase parameters, which are
strikethrustyleor 8 for Strikethru
turned off and on separately.
outlinestyle or 16 for Outline (Macin-
tosh only)
shadowstyle or 32 for Shadow (Macin-

tosh only)
reversestyle or 64 for Reverse
cPosition any or -3 for Any position (i.e., to not

include position attribute in search crite-
ria; default setting)
superscript or 1 for Superscript
subscript or 2 for Subscript
Related titles

Related titles


ADOBE PAG
GetTypeStyle values doubled. If you are using the FindTypeAttr2 dSetWidth, cTrack,
GetTypeStyle query in conjunction with sColorName, nTintValue
ChangeTypeAttr1, FindTypeAttr1,
Sets additional text attributes (horizontal scale
GetChangeTypeAttr1, or GetFindTypeAttr1, note
tracking, color, and tint) to be used for the sea
that the GetTypeStyle query returns different
text in the Find, Change, and ChangeAll
values for the type styles. With the exception of
commands.
normal, all the GetTypeStyle values are twice the
values used in the find and change commands and Parameter Values to enter
queries. For example, bold is 2 for GetTypeStyle
dSetWidth Percentage to scale the character wi
and 1 for ChangeTypeAttr1, FindTypeAttr1, (from 5.0 to 250.0; normal is 100.0)
GetChangeTypeAttr1, and GetFindTypeAttr1.
any or -3 for Any set width (i.e., to no
Normal, however, is 1 in GetTypeStyle and 0 in the include set width settings in search c
other commands and queries. ria)
Example. The following example changes all 10- cTrack dontcare or -3 for Any tracking (i.e.,
point, bold, underlined text in the current publi- not include track settings in search c
ria)
cation to 9-point, Helvetica bold. Notice that it
first sets all other Find and Change attributes to notrack or 0 (zero) for No Track
Any. veryloose or 1 for Very Loose
findtypeattr2 -3, -3, "Any", -3 loose or 2 for Loose
changetypeattr2 -3, -3, "Any", -3 normaltrack or 3 for Normal Track

findparaattr "Any", -3, -3
tight or 4 for Tight
verytight or 5 for Very Tight
boldstyle+underline, -3, -3 sColorName Name of color, in quotation marks an
changetypeattr1 "Helvetica", 9, -3, boldstyle, -3, exactly as it appears in Colors palette
-3
changeall "", "", allstories, anycase, allinstances, "Any" (quotation marks required) fo
Any color (i.e., to not include color in
useattributes search criteria)
See also: nTintValue Percentage of color (from 0 to 100), i

The Change, ChangeAll, ChangeNext, whole percentages
ChangeParaAttr, ChangeTypeAttr1, any or -3 for Any tint amount
ChangeTypeAttr2, ChangeWindow , Find, FindN-
ext, FindParaAttr, FindTypeAttr2, and FindWin-
Story editor only. The FindTypeAttr2 comm
dow commands
GetChangeTypeAttr2, GetChangeWindow , Get- All attributes cleared first. The settings you
FindParaAttr, GetFindTypeAttr1, include with the FindTypeAttr2 command rep
GetFindTypeAttr2, GetFindWindow , and Get- all existing attribute settings.
TypeStyle queries
If story editor is
command.
Related titles

Related titles


ADOBE PAG
Example. The following example changes all Example. The following example opens the F
purple text in the current publication to 93% tint dialog box.
of purple. Notice that it first sets all other Find and
findwindow open
Change attributes to Any.
findtypeattr1 "Any", -3, -3, -3, -3, -3
See also:
changetypeattr1 "Any", -3, -3, -3, -3, -3
findparaattr "Any", -3, -3 The Change, ChangeAll, ChangeNext,
ChangeTypeAttr2, ChangeWindow , Find, Find
findtypeattr2 -3, -3, "Purple", -3
ext, FindParaAttr, FindTypeAttr1, and
changetypeattr2 -3, -3, "Purple", 93
FindTypeAttr2 commands
changeall "", "", allstories, anycase, allinstances,
useattributes
See also: GetFindTypeAttr2, and GetFindWindow quer
ChangeTypeAttr2, ChangeWindow , Find, FindN- Font sFontName
ext, FindParaAttr, FindTypeAttr1, and FindWin- Specifies the font for text. Action depends on
dow commands which tool is active, whether any text is selecte
The GetChangeParaAttr, GetChangeTypeAttr1, and whether a publication is open when the
GetChangeTypeAttr2, GetChangeWindow , Get- command is executed.
GetFindTypeAttr2, and GetFindWindow queries Parameter Values to enter
sFontName Name of font, in quotation marks and

exactly as it appears on Type menu (
FindWindow bOpen maximum of 63 characters)
Opens or closes the Find dialog box.

Font must be installed on same system. The
Parameter Values to enter you specify must be installed on the system on
which you're running the plug-in or script.
bOpen close or 0 to close Find dialog box
open or 1 to open Find dialog box Specifying the font name correctly. Type the
name exactly as it appears when you choose F
Story editor only. The FindWindow command from the Type menu. If the system on which t
works only in story editor. plug-in or script is running includes Adobe Ty
Reunion (ATR), Font Harmony, or another ut
If story editor
Plug-ins and external s cripts only. that alters the font list, the name must appear
is not active, PageMaker returns would in the menu without the utility running
CQ_LO_INVALID_MODE and disregards the see the appropriate name, open the Type Speci
command. tions dialog box and select the wanted font.
Change and Spell closed , depending on platform. Example. The following example selects the
PageMaker for the Macintosh closes the Change second text block placed on the page and spec
dialog box before opening the Find dialog box. that the font be changed to Times Bold Italic.
PageMaker for Windows closes both the Change
select 2
and Spell dialog boxes.
font "BI Times BoldItalic"
Related titles

Related titles


ADOBE PAG
See also: FrameContentPos nVertAlign,

The TypeStyle command nHorzAlign, nScaleType,
The GetFont and GetTypeStyle queries nKeepAspectRatio
Sets the content position for the currently sele
frame. Graphic items will be positioned within
FontDrawing bIgnore, cPresrvShape frame according to the values set.
Specifies whether to preserve line spacing and
character shape in TrueType.
nVertAlign Vertical alignment of the content wit
Parameter Values to enter the frame
bIgnore 0 (zero; value is ignored) 0 for top of frame
cPresrvShape preservelineor 0 to preserve the line 1 for center of frame

spacing (leading) of TrueType fonts and 2 for bottom of frame
to adjust character height as necessary
-2 to leave unchanged
preservechar or 1 to preserve character
height of TrueType fonts, regardless of nHorzAlign Horizontal alignment of the content
line spacing within the frame
0 for left edge of frame

bIgnore replaces b UseATM. The bIgnore
1 for center of frame
parameter replaces the bUseATM parameter found
in earlier versions of the PageMaker command 2 for right edge of frame
language. Because this version of PageMaker uses -2 to leave unchanged

ATM whenever it is present, the bUseATM nScaleType Scaling option for content
parameter is invalid. The bIgnore parameter acts
0 to clip to fit frame
as a placeholder to maintain compatibility with
plug-ins or scripts created using earlier versions of 1 to resize to fit frame
the command language. 2 to scale frame to fit content
Default setting. The specification applies only to -2 to leave unchanged

the active publication. If no publication is open, nKeepAspec- Aspect Ratio for scaled object
the specifications apply to any new publication tRatio
1 to keep the aspect ratio
subsequently created.
2 to resize horizontal and vertical ind
Example. The following example specifies that pendently
line spacing be preserved in TrueType. The -2 to leave this option unchanged
bIgnore value, 0, is ignored.
fontdrawing 0, preserveline The FrameContentPos
Layout view only.
command works only in layout view.
See also: Example. The following example aligns the
The Font and Preferences commands content with the center of the frame both hori
tally and vertically; the content size and aspec
The GetFontDrawing and GetPreferences queries
ratio are left unchanged.
F r a m e C o n t e n t Po s 1 , 1 , - 2 , - 2
Related titles

Related titles


ADOBE PAG
See Also: GoBack

The AttachContent, BreakLinks, DeleteContent, Returns to the previously displayed page.
FrameInset, LinkFrames, SeparateContent, and
ToggleFrame commands Layout view only. The GoBack command wo
The GetFrameContentPos, GetFrameInset, GetFr- only in layout view.
ameContentType, GetIsFrame, and GetNext- Example. The following example returns to t
Frame queries source of a hyperlink, assuming that there is a v
hyperlink at the location 5i, 5i.
hyperjump 5i, 5I
FrameInset nTop, nLeft, nBottom,
goback
nRight
Sets the inset, or margins, around the inside of a
frame. Text within the frame will be positioned See Also:
according to the insets. The GoForward and HyperJump commands
nTop Size of the inset on the top edge of the GoForward

frame
Moves forward through a hyperlink or page ju
nLeft Size of the inset on the left edge of the
that is in the page history.
frame

This command is only valid if the GoBack
nBottom Size of the inset on the bottom edge of
the frame command or Go Back menu item has been us
nRight Size of the inset on the right edge of the Layout view only. The GoForward command
frame works only in layout view.
Example. The following example returns to t
Note. The selected frames must have text content or
source of a hyperlink and then moves forward
no content. An inset does not work with a graphic again, assuming that there is a valid hyperlink
frame. the location 5i, 5i.
Layout view only. The FrameInset command hyperjump 5i, 5I
works only in layout view. goback
Example. The following example adds a 0.25 inch goforward
inset to all four sides of a selected frame.
frameinset 0.25i, 0.25i, 0.25i, 0.25i See Also:
The GoBack and HyperJump commands
See Also:
The AttachContent, BreakLinks, FrameContent-
Pos, LinkFrames, SeparateContent, and Toggle-
Group
Frame commands Groups the currently selected objects.
The GetFrameContentPos, GetFrameInset, GetFr- Locked and unlocked objects. You cannot gro
ameContentType, GetIsFrame, and GetNext- locked and unlocked objects together. All obje
Frame queries in a group must have the same lock status;
otherwise PageMaker returns an error
(CQ_MIXED_LOCK).
Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles

Related titles


Reward Your Curiosity
Everything you want to read.
Anytime. Anywhere. Any device.
Read free for 30 days
No Commitment. Cancel anytime.
Share this document

    
About Support Legal Social
About Scribd Help / FAQ Terms Instagram
Press Accessibility Privacy Twitter
Our blog Purchase help Copyright Facebook

Join our team! AdChoices Cookie Preferences Pinterest
Contact us Publishers Do not sell or share my
personal information
Invite friends
Gifts
Scribd for enterprise
Get our free apps
Audiobooks • Books • Documents • Magazines • Podcasts • Sheet music • Snapshots
Language: English
Copyright © 2023 Scribd Inc.

Related Titles: Search Document

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Related Titles: Search Document

Uploaded by

Copyright:

Available Formats

6/14/23, 3:23 PM Script Guide | PDF | Parameter (Computer Programming) | Scripting Language

PageMaker Script Language Guide

How to use this reference What's in a command or query

Introduction to scripting and the

In addition to commands and parameters, the

Sample script • GetFillAndLine returns information about t

Variable: A ﬂexible container for a value. See also:

Preﬁx Type Description Example

Note: Do not enclose keywords in quotation marks. linestyle 13

Preﬁx Type Description Example

Where the string represents a variable palette, pop-up, or submenu option,

See also: About PMScript

In addition to PMScript, there is another Deciphering PageMaker replie

When a script is running, PageMaker dialog

1 bOnOff Rule Above Paragraph

1 cLineStyle The rule is a hairline.

"Blue-green" sLineColor The color is Blue-green

1 cLineWidth The rule is the width of

Returned Parameter Meaning Specifying the measurement system:

means 7 picas. To specify inches instead of pic

Specifying the measurement system: Coordinates

• Objects (text blocks and graphics) are numbered Examples:

Columns column n left column top

column n right column bottom See also:

rightpage column n right

leftpage column n right

Note that: Writing variables

Indexed variables Writing expressions

See also: Special operators

Mathematical operators See also:

Result: The PageMaker Scripting language supports t

Not() function: reverses the value of a Boolean a = "42"

Len() function: counts the number of values in a

Quote() and Unquote() functions: puts quotes

Str() and Val() functions: Str() turns a value into a

Path() function: translates ﬁle directory paths returns a pseudo-random

Result Arctan() function: calculates the arc tangent va

Result See also:

Max() and Min() functions: return the largest or

Using controls message "The page is tall."

A control is used just like a command by writing its

Example textenter quote(x)

while x < 100 textenter ", "

textenter quote(x) + ", " until x = 100

getpagenumber >> pagenum, ... endif

switch pagenum message "Default font being used instead of

caseof -3 missing Helvetica"

message "The current page is a left- hand master label done

Example 2 Use a carriage return to separate the comm

Message Command: Displays a message in a 3 Use commas to separate parameters from o

See also: See also:

keyErrorString = 'errs' Error string returned fr

•The application signature (ADPM for

Apple Events: Sending Apple Events: Required constants

Sample scripts: HyperCard or

p u t s e n d Q u e r y To P M ( " t e x t e d i t ; t e x tc u r s o r Sub MAIN

Const SWP_SHOWWINDOW = &H40 End Sub

REM Get last character of ﬁrst text b lock

3 Choose Trace from the Scripts palette menu

Script Palette.add Scriptpal.add

Getting more information

Addition sPlugInName[, sFilename] AddPrinterStyle sPrinterStyle

Parameter Values to enter Parameter Value