7.4
Table Of Contents
- Copyright Information
- Table of Content
- Fonts and Styles
- Overview
- Getting Started
- The PlanetPress Design Program
- Start PlanetPress Design
- The PlanetPress Suite Button
- The Quick Access Toolbar
- The PlanetPress Design Ribbon
- Document Structure Area
- Add a Metadata Field
- Data Pane
- Object Inspector
- Workspace Area
- Detailed Directions
- Debug an Object or Group
- Select Objects and/or Groups
- Lock and Unlock Objects and Groups
- Reposition Objects and/or Groups
- Resize Objects and/or Groups
- Delete Objects and/or Groups
- Align Objects and/or Groups
- Rotate Objects and/or Groups
- Duplicate Objects and/or Groups
- Snap or Unsnap Objects and/or Groups
- Copy Values of Properties between Objects and/or Groups
- Adding image resources to your document
- Messages Area
- PlanetPress Design Preferences
- Notification Messages Preferences
- Image Resources Preferences
- Color Preferences
- Object Duplication Preferences
- Miscellaneous Preferences
- Editor Preferences
- Display Preferences
- Color Preferences
- Ribbon Preferences
- Object Inspector Preferences
- Document Structure Area Preferences
- Rulers Preferences
- Form Pages Preferences
- Compiler Messages Preferences
- Document and Pages Preferences
- Image Resources Preferences
- PDF Text Extraction Tolerance Factors
- Data Selector Display Preferences
- Dock and Undock Areas of the Program Window
- Minimize and Customize the Ribbon
- Show or Hide Areas of the Program Window
- Resize the Program Window Area
- Data in PlanetPress Design
- Setting Up a Document
- Setting Up Pages
- PlanetPress Design Objects
- Document Resources
- Conditions
- Conditions
- Global Conditions
- Local Conditions
- Line Conditions
- Create or Remove a Line Condition
- PlanetPress Supports Global Variables in the Global Function Library Manager
- Create a Global Condition
- View or Edit the Properties of a Global Condition
- Apply or Remove a Global Condition
- Use a Global Condition as a Variable
- Combine Global Conditions
- Override a Global Condition
- Delete a Global Condition
- Create, Edit, or Delete Local Conditions
- Verify a Condition
- Add a Global Function
- View or Edit a Global Function
- Delete a Global Function
- PlanetPress Talk
- Variable PlanetPressTalk Properties
- The PlanetPress Talk Editor
- PlanetPress Talk Editor Features
- Debugging Features
- Code Execution in the Editor
- Enter a New Program in the Editor
- Import or Export a Program
- Save a Program
- Print a Program
- Exit the PlanetPress Talk Editor
- Show or Hide the Commands Area or Spy List
- Adjust the Sizes of the Commands Area, Code Area and Spy List
- Expand or Collapse Command Groups
- Enter Commands in the Editor
- Use Command and Variable Name Completion
- Dynamic Images
- PlanetPress Talk Expressions for Dynamic Images that Reference Image Resources
- PlanetPress Talk Expressions for Dynamic Images that Reference External Images
- Image Name and Pathname Resolution in Dynamic Images
- Creating and using Runpages
- PlanetPress Talk Basics
- Assumed Knowledge
- PlanetPress Talk
- PlanetPress Talk Terminology
- The Elements of PlanetPress Talk
- PlanetPress Talk Syntax
- Data Types
- Variables
- Create a Global Variable
- View or Edit a Global Variable
- Delete a Global Variable
- System Variables with Local Scope
- System Variables with Global Scope
- System Objects with Global Scope
- Current System Object
- Code Samples
- Language Reference
- Language Reference (Alphabetical)
- % (procedure)
- Current (system object)
- ¤titeration (variable)
- &Document (system object)
- &EOJob (system variable)
- &FirstSide (system variable)
- &Height (system variable)
- &iterationcount (variable)
- lastoverflowcount (variable)
- &Metamode (variable)
- Physical (system object)
- &PrinterMode (system variable)
- Script (system object)
- &Str (system variable)
- &system (system object)
- &watch (system object)
- &Width (system variable)
- @ (function)
- @name (function/procedure)
- @page (procedure)
- $element (procedure)
- + (operator & function)
- – (operator)
- Asterisk (*) operator
- / (operator)
- Greater than (>) operator
- Greater or equal to (>=) operator
- Less than (<) operator
- Less or equal to (<=) operator
- = (operator)
- <> (operator)
- Add (function)
- And (Boolean operator function)
- Arc and ArcN (procedures)
- BeginDocument/EndDocument (procedure)
- BeginGroup/EndGroup (procedure)
- BeginParagraph … EndParagraph (procedure)
- BeginUTF8Paragraph … EndUTF8Paragraph (procedure)
- BitmapWidth/BitmapHeight (function)
- Breakpoint (procedure)
- C128 (function)
- CallPPD (procedure)
- Ceil (function)
- Char (function)
- CharPath (procedure)
- ClearPage (procedure)
- ClipPath (procedure)
- ClosePath (procedure)
- Cos (function)
- CRLF (procedure)
- CurToStr (function)
- CurToFloat (function)
- CurveTo/RCurveTo (procedure)
- Date (function)
- Define (procedure)
- DefineData (procedure)
- DefineImageIndex (procedure)
- Definemeta (function)
- Div (function)
- DoForm (procedure)
- endpageset (procedure)
- EPSWidth/EPSHeight (function)
- Eq (function)
- ExecPage (procedure)
- ExecScriptFile (function)
- Exit (procedure)
- ExpandString (function)
- Field (function)
- FieldCount (function)
- FieldName (function)
- Fill (procedure)
- Find (function)
- FloatToCur (function)
- FloatToInt (function)
- FloatToStr (function)
- For… EndFor (procedure)
- Function @name (procedure)
- GE (function)
- Get (function)
- GetBlack (function)
- GetCyan (function)
- GetMagenta (function)
- Getmeta (function)
- Getmetacount (function)
- GetNextDataPage(procedure)
- GetYellow (function)
- GRestore (procedure)
- GSave (procedure)
- GT (function)
- If (function)
- If … ElseIf… EndIf (procedure)
- InStream... EndInStream (procedure)
- IntToCur (function)
- IntToFloat (function)
- IntToStr (function)
- IsNumber (function)
- IsPageEmpty (function)
- LE (function)
- Left (function)
- Length (function)
- LineTo/RLineTo (procedure)
- LowerCase (function)
- LT (function)
- MapUTF8 (function)
- Margin (procedure)
- Mid (function)
- Mod (function & procedure)
- MoveTo/RMoveTo (procedure)
- Mul (function)
- NE (function)
- Neg (function)
- Not (Boolean operator function)
- Object $name()... EndObject (procedure)
- Or (Boolean operator function)
- Ord (function)
- OutputDebugString (procedure)
- PassThrough (procedure)
- PDFPageCount (function)
- PDFWidth/PDFHeight (function)
- Pie (procedure)
- PixelHeight (function)
- PixelWidth (function)
- Pos (function)
- Put (procedure)
- Random (function)
- Rectangle (procedure)
- RectFill (procedure)
- RectFillStroke (procedure)
- RectStroke (procedure)
- Region (function)
- Regionline (function)
- Repeat... Until (procedure)
- ResourceType (function)
- Right (function)
- RunPS (procedure)
- Scale (procedure)
- Search … EndSearch (procedure)
- SelectMedia (procedure)
- SelectPrinter (procedure)
- Set (procedure)
- SetAngle (procedure)
- SetBodyText (procedure)
- SetDash(procedure)
- SetDataPage(procedure)
- SetEmailAddress (procedure)
- SetEmailSubject (procedure)
- SetEmulation(procedure)
- SetUserCRLF (procedure)
- SetFaxInformation (procedure)
- SetFaxNumber (procedure)
- SetFillColor (procedure)
- SetImageIndex (procedure)
- SetLineWidth (procedure)
- SetLPP(procedure)
- SetPDFBookmark (procedure)
- SetStrokeColor (procedure)
- SetStyle (procedure)
- SetStyleExt (procedure)
- Show / ShowCenter / ShowRight (procedure)
- ShowBarCode (procedure)
- ShowBarcode2of5(procedure)
- ShowBarcodeAustPost (procedure)
- ShowBarcodeAztec (procedure)
- ShowBarcodeCodabar (procedure)
- ShowBarcodeCodablockF (procedure)
- ShowBarcodeCode11 (procedure)
- ShowBarcodeCode128 (procedure)
- ShowBarcodeCode16k (procedure)
- ShowBarcodeCode39 (procedure)
- ShowBarcodeCode49 (procedure)
- ShowBarcodeCode93 (procedure)
- ShowBarcodeDatamatrix (procedure)
- ShowBarcodeEAN8 (procedure)
- ShowBarcodeEAN13 (procedure)
- ShowBarcodeFIM (procedure)
- ShowBarcodeI2of5 (procedure)
- ShowBarcodeISBN (procedure)
- ShowBarcodeJapanpost (procedure)
- ShowBarcodeMaxicode (procedure)
- ShowBarcodeMicroPDF (procedure)
- ShowBarcodeMicroQR (procedure)
- ShowBarcodeMSI (procedure)
- ShowBarcodeOnecode (procedure)
- ShowBarcodePDF417 (procedure)
- ShowBarcodePlessey (procedure)
- ShowBarcodePostnet (procedure)
- ShowBarcodeQRCode (procedure)
- ShowBarcodeRoyalMail (procedure)
- ShowBarcodeRSS (procedure)
- ShowBarcodeUPCA (procedure)
- ShowBarcodeUPCE (procedure)
- ShowBitmap (procedure)
- ShowCaptureUserArea (procedure)
- ShowEPS (procedure)
- ShowLeftRight (procedure)
- ShowPage (procedure)
- ShowPDF (procedure)
- ShowUTF8 (procedure)
- ShowUTF8Left / ShowUTF8Right / ShowUTF8Center (procedure)
- Sin (function)
- StopJob (procedure)
- Store (procedure)
- StringReplace (function)
- StringWidth (function)
- StringWidthUTF8 (function)
- Strip (function)
- Stroke (procedure)
- StrokeAndFill (procedure)
- StrToCur (function)
- StrToFloat (function)
- StrToInt (function)
- Sub (function)
- SubRecCount (function)
- Time (function)
- Translate (procedure)
- Trim (function)
- TrimLeft (function)
- TrimRight (function)
- UpperCase (function)
- xmlCount()
- xmlGet()
- XOr (Boolean operator function)
- Language Reference (by element type)
- System Variables
- &EOJob (system variable)
- &FirstSide (system variable)
- &Height (system variable)
- &PrinterMode (system variable)
- &Str (system variable)
- &Width (system variable)
- System Objects
- Current (system object)
- Physical (system object)
- &system (system object)
- Assignment Operator
- = (operator)
- Mathematical Operators and Operator Functions
- + (operator & function)
- Add (function)
- – (operator)
- Sub (function)
- Asterisk (*) operator
- Mul (function)
- / (operator)
- Div (function)
- Neg (function)
- Cos (function)
- Sin (function)
- Random (function)
- Ceil (function)
- String Operator
- + (operator & function)
- Boolean Operator Functions
- And (Boolean operator function)
- Not (Boolean operator function)
- Or (Boolean operator function)
- XOr (Boolean operator function)
- Comparison Operators and Operator Functions
- GT (function)
- Greater than (>) operator
- GE (function)
- Greater or equal to (>=) operator
- LT (function)
- Less than (<) operator
- LE (function)
- Less or equal to (<=) operator
- Eq (function)
- = (operator)
- NE (function)
- <> (operator)
- Conversion Operator Functions
- FloatToCur (function)
- FloatToInt (function)
- FloatToStr (function)
- IntToCur (function)
- IntToFloat (function)
- IntToStr (function)
- StrToCur (function)
- StrToFloat (function)
- StrToInt (function)
- Loop Structures
- For… EndFor (procedure)
- Repeat... Until (procedure)
- Search … EndSearch (procedure)
- Exit (procedure)
- Condition Structures
- If … ElseIf… EndIf (procedure)
- If (function)
- Procedures
- % (procedure)
- @name (function/procedure)
- @page (procedure)
- $element (procedure)
- Arc and ArcN (procedures)
- BeginDocument/EndDocument (procedure)
- BeginGroup/EndGroup (procedure)
- BeginParagraph … EndParagraph (procedure)
- BeginUTF8Paragraph … EndUTF8Paragraph (procedure)
- Breakpoint (procedure)
- CallPPD (procedure)
- CharPath (procedure)
- ClearPage (procedure)
- ClipPath (procedure)
- ClosePath (procedure)
- CRLF (procedure)
- CurveTo/RCurveTo (procedure)
- Define (procedure)
- DefineData (procedure)
- DefineImageIndex (procedure)
- DoForm (procedure)
- endpageset (procedure)
- ExecPage (procedure)
- Exit (procedure)
- Fill (procedure)
- For… EndFor (procedure)
- Function @name (procedure)
- GetNextDataPage(procedure)
- GRestore (procedure)
- GSave (procedure)
- If … ElseIf… EndIf (procedure)
- InStream... EndInStream (procedure)
- LineTo/RLineTo (procedure)
- Margin (procedure)
- MoveTo/RMoveTo (procedure)
- Object $name()... EndObject (procedure)
- OutputDebugString (procedure)
- PassThrough (procedure)
- Pie (procedure)
- Put (procedure)
- Rectangle (procedure)
- RectFill (procedure)
- RectFillStroke (procedure)
- RectStroke (procedure)
- Repeat... Until (procedure)
- RunPS (procedure)
- Scale (procedure)
- Search … EndSearch (procedure)
- SelectMedia (procedure)
- SelectPrinter (procedure)
- Set (procedure)
- SetAngle (procedure)
- SetBodyText (procedure)
- SetDash(procedure)
- SetDataPage(procedure)
- SetEmailAddress (procedure)
- SetEmailSubject (procedure)
- SetEmulation(procedure)
- SetUserCRLF (procedure)
- SetFaxInformation (procedure)
- SetFaxNumber (procedure)
- SetFillColor (procedure)
- SetImageIndex (procedure)
- SetLineWidth (procedure)
- SetLPP(procedure)
- SetPDFBookmark (procedure)
- SetStrokeColor (procedure)
- SetStyle (procedure)
- SetStyleExt (procedure)
- Show / ShowCenter / ShowRight (procedure)
- ShowBarCode (procedure)
- ShowBarcode2of5(procedure)
- ShowBarcodeAustPost (procedure)
- ShowBarcodeAztec (procedure)
- ShowBarcodeCodabar (procedure)
- ShowBarcodeCodablockF (procedure)
- ShowBarcodeCode11 (procedure)
- ShowBarcodeCode128 (procedure)
- ShowBarcodeCode16k (procedure)
- ShowBarcodeCode39 (procedure)
- ShowBarcodeCode49 (procedure)
- ShowBarcodeCode93 (procedure)
- ShowBarcodeDatamatrix (procedure)
- ShowBarcodeEAN8 (procedure)
- ShowBarcodeEAN13 (procedure)
- ShowBarcodeFIM (procedure)
- ShowBarcodeI2of5 (procedure)
- ShowBarcodeISBN (procedure)
- ShowBarcodeJapanpost (procedure)
- ShowBarcodeMaxicode (procedure)
- ShowBarcodeMicroPDF (procedure)
- ShowBarcodeMicroQR (procedure)
- ShowBarcodeMSI (procedure)
- ShowBarcodeOnecode (procedure)
- ShowBarcodePDF417 (procedure)
- ShowBarcodePlessey (procedure)
- ShowBarcodePostnet (procedure)
- ShowBarcodeQRCode (procedure)
- ShowBarcodeRoyalMail (procedure)
- ShowBarcodeRSS (procedure)
- ShowBarcodeUPCA (procedure)
- ShowBarcodeUPCE (procedure)
- ShowBitmap (procedure)
- ShowCaptureUserArea (procedure)
- ShowEPS (procedure)
- ShowLeftRight (procedure)
- ShowPage (procedure)
- ShowPDF (procedure)
- ShowUTF8 (procedure)
- ShowUTF8Left / ShowUTF8Right / ShowUTF8Center (procedure)
- StopJob (procedure)
- Store (procedure)
- Stroke (procedure)
- StrokeAndFill (procedure)
- Translate (procedure)
- Functions
- @ (function)
- @name (function/procedure)
- BitmapWidth/BitmapHeight (function)
- C128 (function)
- Ceil (function)
- Char (function)
- Date (function)
- Definemeta (function)
- EPSWidth/EPSHeight (function)
- ExecScriptFile (function)
- ExpandString (function)
- Field (function)
- FieldCount (function)
- FieldName (function)
- Find (function)
- Get (function)
- GetBlack (function)
- GetCyan (function)
- GetMagenta (function)
- Getmeta (function)
- Getmetacount (function)
- GetYellow (function)
- IsNumber (function)
- IsPageEmpty (function)
- Left (function)
- Length (function)
- LowerCase (function)
- MapUTF8 (function)
- Mid (function)
- Mul (function)
- Ord (function)
- PDFPageCount (function)
- PDFWidth/PDFHeight (function)
- PixelHeight (function)
- PixelWidth (function)
- Pos (function)
- Random (function)
- Region (function)
- Regionline (function)
- ResourceType (function)
- Right (function)
- StringReplace (function)
- StringWidth (function)
- StringWidthUTF8 (function)
- Strip (function)
- Sub (function)
- SubRecCount (function)
- Time (function)
- Trim (function)
- TrimLeft (function)
- TrimRight (function)
- UpperCase (function)
- xmlCount()
- xmlGet()
- System Variables (by data type)
- Functions (by return value data type)
- Currency
- Add (function)
- FloatToCur (function)
- IntToCur (function)
- StrToCur (function)
- Integer
- Add (function)
- Ceil (function)
- Div (function)
- FieldCount (function)
- FloatToInt (function)
- Get (function)
- GetBlack (function)
- GetCyan (function)
- GetMagenta (function)
- GetYellow (function)
- Getmetacount (function)
- If (function)
- Length (function)
- Mod (function & procedure)
- Mul (function)
- Neg (function)
- Ord (function)
- PDFPageCount (function)
- PixelHeight (function)
- PixelWidth (function)
- Pos (function)
- ResourceType (function)
- StrToInt (function)
- Sub (function)
- SubRecCount (function)
- xmlCount()
- Measure
- Add (function)
- BitmapWidth/BitmapHeight (function)
- Cos (function)
- CurToFloat (function)
- Div (function)
- EPSWidth/EPSHeight (function)
- Get (function)
- If (function)
- IntToFloat (function)
- Mul (function)
- Neg (function)
- PDFWidth/PDFHeight (function)
- Random (function)
- Sin (function)
- StringWidth (function)
- StringWidthUTF8 (function)
- StrToFloat (function)
- Sub (function)
- String
- @ (function)
- C128 (function)
- Char (function)
- CurToStr (function)
- ExpandString (function)
- Field (function)
- FieldName (function)
- FloatToStr (function)
- Get (function)
- If (function)
- IntToStr (function)
- Left (function)
- LowerCase (function)
- Mid (function)
- Right (function)
- StringReplace (function)
- Strip (function)
- Trim (function)
- TrimLeft (function)
- TrimRight (function)
- UpperCase (function)
- xmlGet()
- Boolean
- Add (function)
- Eq (function)
- Find (function)
- GE (function)
- GT (function)
- If (function)
- IsNumber (function)
- IsPageEmpty (function)
- LE (function)
- LT (function)
- NE (function)
- Not (Boolean operator function)
- Or (Boolean operator function)
- XOr (Boolean operator function)
- Procedures (by category)
- Debugging
- Breakpoint (procedure)
- OutputDebugString (procedure)
- Variables
- Define (procedure)
- Put (procedure)
- Set (procedure)
- Global Functions
- @name (function/procedure)
- Function @name (procedure)
- Comments
- % (procedure)
- Graphics State
- GRestore (procedure)
- GSave (procedure)
- Scale (procedure)
- SetAngle (procedure)
- SetDash(procedure)
- SetFillColor (procedure)
- SetLineWidth (procedure)
- SetStrokeColor (procedure)
- Translate (procedure)
- Path
- Arc and ArcN (procedures)
- ClosePath (procedure)
- CurveTo/RCurveTo (procedure)
- Fill (procedure)
- LineTo/RLineTo (procedure)
- MoveTo/RMoveTo (procedure)
- Pie (procedure)
- Rectangle (procedure)
- RectFill (procedure)
- RectFillStroke (procedure)
- RectStroke (procedure)
- Stroke (procedure)
- StrokeAndFill (procedure)
- Paragraphs and Text
- BeginParagraph … EndParagraph (procedure)
- BeginUTF8Paragraph … EndUTF8Paragraph (procedure)
- CRLF (procedure)
- Margin (procedure)
- ShowLeftRight (procedure)
- Show / ShowCenter / ShowRight (procedure)
- Styles
- SetStyle (procedure)
- SetStyleExt (procedure)
- Objects
- Object $name()... EndObject (procedure)
- Bar Codes
- ShowBarCode (procedure)
- ShowBarcode2of5(procedure)
- ShowBarcodeAustPost (procedure)
- ShowBarcodeAztec (procedure)
- ShowBarcodeCodabar (procedure)
- ShowBarcodeCodablockF (procedure)
- ShowBarcodeCode11 (procedure)
- ShowBarcodeCode128 (procedure)
- ShowBarcodeCode16k (procedure)
- ShowBarcodeCode39 (procedure)
- ShowBarcodeCode49 (procedure)
- ShowBarcodeCode93 (procedure)
- ShowBarcodeDatamatrix (procedure)
- ShowBarcodeEAN8 (procedure)
- ShowBarcodeEAN13 (procedure)
- ShowBarcodeFIM (procedure)
- ShowBarcodeI2of5 (procedure)
- ShowBarcodeISBN (procedure)
- ShowBarcodeJapanpost (procedure)
- ShowBarcodeMaxicode (procedure)
- ShowBarcodeMicroPDF (procedure)
- ShowBarcodeMicroQR (procedure)
- ShowBarcodeMSI (procedure)
- ShowBarcodeOnecode (procedure)
- ShowBarcodePDF417 (procedure)
- ShowBarcodePlessey (procedure)
- ShowBarcodePostnet (procedure)
- ShowBarcodeQRCode (procedure)
- ShowBarcodeRoyalMail (procedure)
- ShowBarcodeRSS (procedure)
- ShowBarcodeUPCA (procedure)
- ShowBarcodeUPCE (procedure)
- Resources
- InStream... EndInStream (procedure)
- ShowBitmap (procedure)
- ShowEPS (procedure)
- ShowPDF (procedure)
- Elements
- $element (procedure)
- Emulation, Data File, and Data Pages
- ClearPage (procedure)
- DefineData (procedure)
- DoForm (procedure)
- GetNextDataPage(procedure)
- SetDataPage(procedure)
- SetEmulation(procedure)
- SetLPP(procedure)
- Store (procedure)
- Data Destined for PlanetPress Image, PlanetPress Fax and PlanetPress Search
- DefineImageIndex (procedure)
- SetBodyText (procedure)
- SetEmailAddress (procedure)
- SetEmailSubject (procedure)
- SetFaxInformation (procedure)
- SetFaxNumber (procedure)
- SetImageIndex (procedure)
- SetPDFBookmark (procedure)
- Document Pages
- @page (procedure)
- ExecPage (procedure)
- ShowPage (procedure)
- PPDs and PostScript
- CallPPD (procedure)
- PassThrough (procedure)
- RunPS (procedure)
- SelectMedia (procedure)
- Program Control
- Exit (procedure)
- For… EndFor (procedure)
- If … ElseIf… EndIf (procedure)
- Repeat... Until (procedure)
- Search … EndSearch (procedure)
- StopJob (procedure)
- Conversion Tables
- ASCII Conversion Table
- Points to Inches or Centimeters
- Line Height as a Function of Lines Per Unit (LPU)
- Variable PlanetPressTalk Properties
- Tools and Utilities
- Document Output and Preview
- About Previewing and Printing
- Install a Document
- Perform a Batch Conversion and/or Installation
- How a Variable Content Document Runs on a Printer
- Techniques for Inserting Triggers
- Trigger Syntax
- Trigger Syntax for Documents Installed on a Hard Disk
- Trigger Syntax for Documents Installed in RAM
- Trigger Syntax for Documents Installed in Flash Memory
- Run a Document Installed on a Printer
- Run a Document Installed in a PlanetPress Suite Workflow Tool
- Run a Document that Uses a Database Emulation
- Run Several Documents as a Single Job
- Troubleshoot Execution Problems
- Keyboard Shortcuts
- PlanetPress Design General
- Exit PlanetPress Design
- Use the Help System
- Show or Hide Areas of the Program Window
- Work with Hierarchies
- Work in the Document Structure Area
- Work with Documents
- Preview and Install Documents
- Work with Pages
- Adjust the Zoom
- Use Basic Editing Commands
- Work in the Data Pane
- Work with the Data File
- Work with Data Selections
- Use the Hex Viewer
- Work with Objects
- Work in the Text Properties of a Text Object
- PlanetPress Talk Editor
- General
- Show or Hide Areas of the Editor
- Expand or Collapse Groups in the Commands Area
- Work in the Code Area
- Use Command Name Completion/Argument Insertion
- Undo Commands
- Work with Selections
- Add/Remove Comments
- Indent Code
- Search
- Jump to a Specific Line
- Use Bookmarks
- Execute a Program
- Debug Code
- Print the Script
- Converted Document
- About Documents
- About Data Selections
- About Objects
- PPD File
- PlanetPress Design General
Select Data
You use the @ function to select data in PlanetPress Talk. This command selects data on a single line of the data page. For
example, the following returns the string of data found on line 3, from column 12 through 30 of the current data page:
@(3,12,30)
Remember that arguments can be variables. The following returns the string of data found on line &line, from column &col1
to column &col2 of the current data page:
@(&line, &col1, &col2)
You usually assign the result of a function to a variable or use it as an argument to another command. For example:
&customer_name := @(&line, &col1, &col2)
You can also use the Data Selector to insert a PlanetPress Talk data selection command. This is often quicker and more con-
venient than manually typing the data selection command. Consult the PlanetPress User Guide, and in particular the area
of the PlanetPress user interface you are using to enter PlanetPress Talk code, for help.
Use Functions as Arguments
You can nest functions so that the value returned by one function becomes the argument for another function. For example, in
the following example, the string returned by the @ function becomes one of two arguments for the strip function:
strip('*',@(36,25,58))
As a more complex example, consider the following:
if((pos('BLACK', strip( ' ', @(36,25,58))) > 0 ), 'old', 'new')
It returns the string ‘old’ if the data selection contains the string ‘BLACK’ and ‘new’ if it does not. When the PlanetPress Talk
interpreter evaluates the statement, it first selects the data on line 36 of the current data page, from columns 25 through 58. It
then sends that data to the strip command which removes all spaces in the data. It then sends the data (which now contains
no spaces) to the pos command, which determines whether it contains the string ‘BLACK’. Finally, it compares the value
returned by the pos command to 0, and returns the value of that comparison to the if command.
Debug Scripts
The PlanetPress Talk Editor has a solid set of features for debugging PlanetPress Talk scripts, including execution control,
breakpoints, spies, expression evaluation, and changing the value of a variable during execution. Consult the PlanetPress Talk
Editor section of the PlanetPress User Guide for a description of these features, and suggestions on other debugging tech-
niques.
PlanetPress Talk includes a breakpoint command that you can enter anywhere you can enter a PlanetPress Talk script. See
"Breakpoint (procedure)" (page 561).
PlanetPress reports errors in PlanetPress Talk code in two places: the status bar of a dialog box when you are entering a Plan-
etPress Talk expression in a text box within that dialog box, and the Messages area of the PlanetPress Program Window (con-
sult the PlanetPress User Guide for a description of the Messages area). You can also use these error reports to
determine and fix problems in your code.
Tips and Tricks
The following are useful to remember as you write your PlanetPress Talk scripts:
©2010 Objectif Lune Inc - 238 -