Adobe 19400084 Scripting Guide - Page 143

PathItem, Document, SubPathItem, SubPathItems

Page 143 highlights

JavaScript Scripting Reference Adobe Photoshop CS3 JavaScript Object Reference 143 PathItems The collection of pathItem objects in the document. See PathItem for information on pathItem objects. Note: Because the PathItems class is a property of the Document object, you use the property name, pathItems, rather than the class name, PathItems, in your code. For example: var myPathItem = docRef.pathItems.add("A Line", lineSubPathArray) The following sample uses the PathItems object incorrectly: var myPathItem = docRef.PathItems.add("A Line", lineSubPathArray) Properties Property length parent typename Value Type What it is number (long) Read-only. The number of pathItem objects in the pathItems collection. object (document) Read-only. The pathItems object's container. string Read-only. The class name of the referenced pathItems object. Methods Method index (itemKey) add (name, entirePath) getByName (name) removeAll () Parameter Type number string array of SubPathInfo objects string Returns What it does PathItem Gets a pathItem object from the pathItems collection. PathItem Creates a new PathItem object from the sub paths defined in the array provided in the entirePath parameter. A new SubPathItem object is created for each SubPathInfo object provided in entirePath, and those SubPathItem objects are added to the SubPathItems collection of the returned PathItem. PathItem Get the first element in the pathItems collection with the provided name. Removes all pathItem objects from the pathItems collection.

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229

Adobe Photoshop CS3
JavaScript Scripting Reference
JavaScript Object Reference
143
PathItems
The collection of
pathItem
objects in the document. See
PathItem
for information on
pathItem
objects.
Note:
Because the
PathItems
class is a property of the
Document
object, you use the property name,
pathItems
, rather than the class name,
PathItems
, in your code. For example:
var myPathItem = docRef.pathItems.add(“A Line”, lineSubPathArray)
The following sample uses the
PathItems
object incorrectly:
var myPathItem = docRef.PathItems.add(“A Line”, lineSubPathArray)
Properties
Methods
Property
Value Type
What it is
length
number (long)
Read-only. The number of
pathItem
objects in the
pathItems
collection.
parent
object (document)
Read-only. The
pathItems
object's container.
typename
string
Read-only. The class name of the referenced
pathItems
object.
Method
Parameter Type
Returns
What it does
index
(itemKey)
number
PathItem
Gets a
pathItem
object from the
pathItems
collection.
add
(name,
entirePath)
string
array of
SubPathInfo
objects
PathItem
Creates a new
PathItem
object from the sub
paths defined in the array provided in the
entirePath
parameter.
A new
SubPathItem
object is created for
each
SubPathInfo
object provided in
entirePath
, and those
SubPathItem
objects are added to the
SubPathItems
collection of the returned
PathItem
.
getByName
(name)
string
PathItem
Get the first element in the
pathItems
collection with the provided name.
removeAll
()
Removes all
pathItem
objects from the
pathItems
collection.