Home » Adobe Manuals » Computer Software » Adobe 26001360 » Manual Viewer

Adobe 26001360 Scripting Guide - Page 288

Referencing and creating objects in Visual Basic, myPath, Application, GetObject

UPC - 718659321840

Add to My Manuals
Save this manual to your list of manuals

Page 288 highlights

288 Visual Basic Reference paste the script into a macro routine. In either case, modify the Sub statement in the example to work with your situation. Referencing and creating objects in Visual Basic As the object model diagram shows, all objects are arranged in a hierarchy. To obtain a reference to a specific object you need to navigate the hierarchy. For example, to store a reference to the first PathItem in the second layer of the active document in the variable myPath you would write: Set myPath = appRef.ActiveDocument.layers(2).PathItems(1) Since all objects in the hierarchy are referenced through the Application object, you must have a reference to the Illustrator application before you can start modifying any other objects. There are several ways to obtain a reference to an Illustrator application object. For example, the following line will create a new reference to the Application if you have added a reference to the Illustrator type library to the project. Dim appRef As New Illustrator.Application As with New, GetObject will create a reference to a running instance of Illustrator. If Illustrator is not running an error is returned. Dim appRef As Illustrator.Application Set appRef = GetObject(, "Illustrator.Application") CreateObject will launch Illustrator as an invisible application if it is not already running. Note that if Illustrator was launched as an invisible application you have to manually activate the application to make it visible. Dim appRef As Illustrator.Application Set appRef = CreateObject("Illustrator.Application") Note: If you have both Illustrator 10 and Illustrator CS installed on the same machine and wish to use the CreateObject() or GetObject() method for obtaining an application reference, you have to be sure to use the correct PROGID string. "Illustrator.Application" always refers to the latest installed Illustrator version; in this case, Illustrator CS. To specifically target Illustrator 10, use "Illustrator.Application.1"; Illustrator CS, "Illustrator.Application.2". 12 Aug 03

Section	Page
Introduction	13
About this manual	13
What is scripting?	14
Why use scripting?	14
What about actions?	15
System requirements	15
Mac OS	16
Windows	16
Scripting Basics	17
Object model concepts	17
Object classes	18
Object inheritance	18
Object elements or collections	19
Object references	19
Scripting concepts	19
Comments	19
About long script lines	20
Values Types	21
Variables	22
Properties	23
Operators	24
Commands and methods	24
Conditional statements	25
Control structures	25
Handlers and subroutines	27
Testing and troubleshooting	29
About error handling	31
Scripting Illustrator	33
Illustrator’s object model	33
Looking at Illustrator’s objects and commands	34
AppleScript	34
Visual Basic	36
The application	36
Your first Illustrator script	37
Creating an AppleScript script	37
Creating a Visual Basic script	37
VBScript	39
Adding features to “Hello World”	40
Measurement units	42
Unit conversion to points	43
Em Space Units	43
Coordinates	44
Fixed points	44
Zero point	44
Fixed rectangle	45
Page item positioning and dimensions	45
Object references	46
Object references in AppleScript	46
Object references in Visual Basic	47
Object containment: document vs. layer	48
Working with selections	49
Working with paths	52
Working with color	52
Working with symbols	53
Working with symbol items	53
Working with text art	53
Content of a Text Range	55
Character Style, Character Attributes, Local Character Attributes	55
Printing Illustrator Documents	55
Transformation matrices	56
Using a matrix in an AppleScript script	57
Using a matrix in a Visual Basic script	57
Working with variables and datasets	58
Datasets	58
Launching and quitting Illustrator from a script	58
Launching and quitting from AppleScript	58
Launching and quitting from Visual Basic	59
Some objects that cannot be created by a script	59
User Interaction Levels	59
AppleScript	60
Visual Basic and JavaScript	60
The Scripts menu	60
Notes	61
Supported scripting languages	61
Script files	61
Installing scripts	61
Executing other scripts	62
AppleScript Reference	63
About the script examples	63
application	64
brush, brushes	67
character	69
character style, character styles	76
CMYK color info	82
color info	83
color management options	84
color separation options	84
compound path item, compound path items	85
coordinate options	87
dataset, datasets	88
document, documents	91
ellipse	98
EPS save options	100
Flash export options	102
flattening options	104
font, fonts	105
font options	105
GIF export options	107
gradient, gradients	110
gradient color info	112
gradient stop, gradient stops	113
gradient stop info	115
graph item, graph items	116
graphic style, graphic styles	118
gray color info	119
group item, group items	120
Illustrator preferences	125
Illustrator save options	125
ink	128
ink properties	128
insertion point	129
job options	132
JPEG export options	134
layer, layers	136
line	140
matrix	146
mesh item, mesh items	148
no color info	149
Open Options	150
page item, page items	150
page marks options	154
paper	155
paper options	155
paper properties	156
paragraph, paragraphs	157
paragraph style, paragraph styles	166
path item, path items	173
path point, path points	176
path point info	178
pattern, patterns	179
pattern color info	180
PDF options	181
PDF save options	183
Photoshop options	188
Photoshop export options	190
placed item, placed items	192
plugin item, plugin items	194
PNG24 export options	194
PNG8 export options	196
polygon	199
postscript options	200
PPD file	200
PPD properties	201
print options	203
printer	204
printer properties	206
raster item, raster items	207
rectangle	209
RGB color info	211
rounded rectangle	212
screen properties	213
screen spot function	214
separation screen	215
spot, spots	215
spot color info	217
star	218
story, stories	219
SVG export options	221
swatch, swatches	223
symbol, symbols	224
symbol item, symbol items	226
tab stop info	227
tag, tags	228
text, texts	229
text frame, text frames	231
variable, variables	234
view, views	235
word	238
Command reference	245
apply	246
apply character style	247
apply paragraph style	247
change case	248
close	248
colorize	249
concatenate matrix	249
concatenate rotation matrix	250
concatenate scale matrix	250
concatenate translation matrix	251
convert	251
convert to paths	252
copy	252
count	253
cut	254
delete	255
deselect	256
display	256
do javascript	256
do script	257
duplicate	258
equal matrices	259
exists	259
export	260
export PDF preset	261
export print presets	261
export variables	262
get	262
get identity matrix	263
get rotation matrix	264
get scale matrix	264
get translation matrix	265
import character styles	265
import paragraph styles	266
import PDF preset	267
import print preset	267
import variables	268
invert matrix	268
make	269
move	270
open	271
paste	272
print	273
quit	273
redraw	274
rotate	275
save	276
scale	279
select	280
set	281
show presets	281
singular matrix	281
transform	283
translate	284
translate placeholder text	285
update	285
Visual Basic Reference	287
About the script examples	287
Referencing and creating objects in Visual Basic	288
Syntax differences between Sub and Function methods	289
Application	290
Brush	295
Brushes	296
CharacterAttributes	297
Characters	300
CharacterStyle	301
CharacterStyles	301
CMYKColor	303
CompoundPathItem	304
CompoundPathItems	309
DataSet	310
DataSets	311
Document	312
Documents	319
EPSSaveOptions	320
ExportOptionsFlash	321
ExportOptionsGIF	322
ExportOptionsJPEG	324
ExportOptionsPhotoshop	326
ExportOptionsPNG24	327
ExportOptionsPNG8	328
ExportOptionsSVG	330
Gradient	331
Gradients	333
GradientColor	334
GradientStop	336
GradientStops	336
GraphicStyle	338
GraphicStyles	339
GraphItem	340
GraphItems	344
GrayColor	345
GroupItem	346
GroupItems	350
IllustratorSaveOptions	351
Ink	353
InkInfo	354
InsertionPoint	355
InsertionPoints	355
Layer	356
Layers	359
LegacyTextItem	360
LegacyTextItems	364
Lines	364
Matrix	366
MeshItem	367
MeshItems	370
NoColor	372
OpenOptions	373
PageItems	374
Paper	376
PaperInfo	377
ParagraphAttributes	377
Paragraphs	380
ParagraphStyle	381
ParagraphStyles	383
PathItem	383
PathItems	389
PathPoint	391
PathPoints	392
Pattern	393
Patterns	394
PatternColor	395
PDFFileOptions	397
PDFSaveOptions	398
PhotoshopFileOptions	401
PlacedItem	402
PlacedItems	406
PluginItem	406
PluginItems	410
PPDFile	410
PPDFileInfo	411
Preferences	412
PrintColorManagementOptions	412
PrintColorSeparationOptions	413
PrintCoordinateOptions	415
Printer	416
PrinterInfo	417
PrintFlattenerOptions	419
PrintFontOptions	421
PrintJobOptions	422
PrintOptions	424
PrintPageMarksOptions	426
PrintPaperOptions	427
PrintPostScriptOptions	428
RasterItem	429
RasterItems	433
RGBColor	434
Screen	435
ScreenInfo	436
ScreenSpotFunction	436
Spot	437
Spots	439
SpotColor	440
Story	441
Stories	442
Swatch	443
Swatches	444
Symbol	445
Symbols	445
SymbolItem	447
SymbolItems	451
TabStopInfo	452
Tag	452
Tags	454
TextFont	455
TextFonts	456
TextFrame	457
TextFrames	461
TextRange	464
TextRanges	466
Variable	466
Variables	467
View	468
Views	469
Words	470
Enumerations reference	471
Changes Since Earlier Versions	487
Changes InThe Object Model for Illustrator CS	487
Macintosh / AppleScript	487
Windows / COM (Visual Basic, et al)	487
Deprecated	489
Bibliography	491
AppleScript	491
Visual Basic	491
Internet resources	492
Adobe Systems, Inc.	492
AppleScript	492

Match case Limit results 1 per page

Visual Basic Reference

288

12 Aug 03

paste the script into a macro routine. In either case, modify the

Sub

statement in the example

to work with your situation.

Referencing and creating objects in Visual Basic

As the object model diagram shows, all objects are arranged in a hierarchy. To obtain a

reference to a specific object you need to navigate the hierarchy. For example, to store a

reference to the first PathItem in the second layer of the active document in the variable

myPath

you would write:

Set myPath = appRef.ActiveDocument.layers(2).PathItems(1)

Since all objects in the hierarchy are referenced through the

Application

object, you must

have a reference to the Illustrator application before you can start modifying any other objects.

There are several ways to obtain a reference to an Illustrator application object. For example,

the following line will create a new reference to the

Application

if you have added a

reference to the Illustrator type library to the project.

Dim appRef As New Illustrator.Application

As with

New

GetObject

will create a reference to a running instance of Illustrator. If Illustrator

is not running an error is returned.

Dim appRef As Illustrator.Application

Set appRef = GetObject(, "Illustrator.Application")

CreateObject

will launch Illustrator as an invisible application if it is not already running.

Note that if Illustrator was launched as an invisible application you have to manually activate

the application to make it visible.

Dim appRef As Illustrator.Application

Set appRef = CreateObject("Illustrator.Application")

Note:

If you have both Illustrator 10 and Illustrator CS installed on the same machine and wish

to use the

CreateObject()

GetObject()

method for obtaining an application

reference, you have to be sure to use the correct

PROGID

string.

“

Illustrator.Application

” always refers to the latest installed Illustrator

version; in this case, Illustrator CS. To specifically target Illustrator 10, use

"Illustrator.Application.1"; Illustrator CS, "Illustrator.Application.2".