Adobe 12040118 Using Help - Page 157

PropertyGroup addProperty() method, ADBE Text Selector

Page 157 highlights

Help Using Help Reference Back 157 Description The PropertyGroup object represents a group of PropertyBase objects, (i.e., Property objects and/or PropertyGroup objects). PropertyGroups may be nested to provide a chain all the way from the Layer at the top down to a single Property (such as the mask feather of the third mask). Attributes Attribute numProperties Reference see "PropertyGroup numProperties attribute" on page 158 Description number of indexed properties in the group Methods Method property() canAddProperty() addProperty() Reference Description see "PropertyGroup property() method" returns the child PropertyGroup or Property on page 158 with the given propertyIndex or name see "PropertyGroup canAddProperty() true if a property with the given name can be method" on page 158 added to the PropertyGroup see "PropertyGroup addProperty() method" on page 157 adds a property with the given name to the PropertyGroup PropertyGroup addProperty() method app.project.item(index).layer(index).propertyGroup(index).addProperty(name) Description This method adds a property with the given name to this group. Properties may only be added to a PropertyGroup whose propertyType is PropertyType.INDEXED_GROUP. The only exception to this rule is a text animator property, which is contained in a NAMED_GROUP. This method generates an exception if a property cannot be created with the given name, so it is always a good idea to call PropertyGroup canAdd Property() method first to check. (See "PropertyGroup canAddProperty() method" on page 158.) The following names are supported: • Any matchName for a property that can be added normally using the user interface. For example, ADBE Mask Atom, ADBE Paint Atom, ADBE Text Position, ADBE Text Anchor Point. • When adding to an ADBE Mask Parade: ADBE Mask Atom, Mask. • When adding to an ADBE Effects Parade, any effect by matchName, such as ADBE Bulge, ADBE Glo2, APC Vegas. • Any effect by display name, such as Bulge, Glow, Vegas. • For text animators and selectors, Text Animator maps to ADBE Text Animator, Range Selector maps to ADBE Text Selector, Wiggly Selector maps to ADBE Text Wiggly Selector, and Expression Selector maps to ADBE Text Expressible Selector. Using Help Back 157

  • 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
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253

U
sing H
elp
B
ack
157
Help
Reference
U
sing H
elp
B
ack
157
Description
The PropertyGroup object represents a group of PropertyBase objects, (i.e., Property objects and/or Proper-
tyGroup objects). PropertyGroups may be nested to provide a chain all the way from the Layer at the top down
to a single Property (such as the mask feather of the third mask).
Attributes
Methods
PropertyGroup addProperty() method
app.project.item(index).layer(index)
.
propertyGroup(index).
addProperty(
name
)
Description
This method adds a property with the given name to this group.
Properties may only be added to a PropertyGroup whose propertyType is PropertyType.INDEXED_GROUP.
The only exception to this rule is a text animator property, which is contained in a NAMED_GROUP.
This method generates an exception if a property cannot be created with the given name, so it is always a good
idea to call PropertyGroup canAdd Property() method first to check. (See “PropertyGroup canAddProperty()
method” on page 158.)
The following names are supported:
Any matchName for a property that can be added normally using the user interface. For example, ADBE
Mask Atom, ADBE Paint Atom, ADBE Text Position, ADBE Text Anchor Point.
When adding to an ADBE Mask Parade: ADBE Mask Atom, Mask.
When adding to an ADBE Effects Parade, any effect by matchName, such as ADBE Bulge, ADBE Glo2, APC
Vegas.
Any effect by display name, such as Bulge, Glow, Vegas.
For text animators and selectors, Text Animator maps to ADBE Text Animator, Range Selector maps to
ADBE Text Selector, Wiggly Selector maps to ADBE Text Wiggly Selector, and Expression Selector maps to
ADBE Text Expressible Selector.
Attribute
Reference
Description
numProperties
see “PropertyGroup numProperties
attribute” on page 158
number of indexed properties in the group
Method
Reference
Description
property()
see “PropertyGroup property() method”
on page 158
returns the child PropertyGroup or Property
with the given propertyIndex or name
canAddProperty()
see “PropertyGroup canAddProperty()
method” on page 158
true if a property with the given name can be
added to the PropertyGroup
addProperty()
see “PropertyGroup addProperty()
method” on page 157
adds a property with the given name to the
PropertyGroup