Adobe 65011817 Extended User Guide - Page 163

dom.setHotspotText

Page 163 highlights

Last updated 12/8/2009 EXTENDING FIREWORKS 159 The Document object Returns Nothing. Description Sets the target tag text to the specified value for the hotspots and slices in the selection. Example The following command links the currently selected slices to the parent window: fw.getDocumentDOM().setHotspotTarget("slices", "_parent"); dom.setHotspotText() Availability Fireworks 3. Usage dom.setHotspotText(whatToSet, textString, urlToMatch, bUpdateAttributes) Description Sets the hotspot text to the specified value for the hotspots and slices in the selection. Arguments whatToSet Acceptable values are "hotspots", "slices", or "hotspots and slices". textString A string that specifies the text to be used for the hotspot or slice. urlToMatch A string that specifies a URL that is already assigned to one or more hotspots in the document. If this value is not null, the URLs of all hotspots or slices in the document that have urlToMatch as their URL are changed to textString. Note: The URLs of both selected and unselected hotspots or slices are changed. bUpdateAttributes Boolean. If true, changed hotspots inherit the color, target, and alt tag text that were most recently associated with the new text value. For example, suppose textString is "http://www.mywebsite.com", and the last time "http://www.mywebsite.com" was used, it was used with a color of blue, a target of none, and an alt tag of "Link to My Home Page". If bUpdateAttributes is true, any hotspot or slice whose text is now being changed to "http://www.mywebsite.com" will also have a color of blue, a target of none, and an alt tag text of "Link to My Home Page". Returns Nothing. Description Sets the hotspot text to the specified value for the hotspots and slices in the selection. Example The following command creates a slice and inserts the HTML text, "I am HTML text": fw.getDocumentDOM().setHotspotText("Slice ","I am HTML text", null, true);

  • 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
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336

159
EXTENDING FIREWORKS
The Document object
Las
t
up
d
a
ted
12/8/2009
Returns
Nothing.
Description
Sets the target tag text to the specified value for the hotspots and slices in the selection.
Example
The following command links the currently selected slices to the parent window:
fw.getDocumentDOM().setHotspotTarget("slices", "_parent");
dom.setHotspotText()
Availability
Fireworks 3.
Usage
dom.setHotspotText(
whatToSet, textString, urlToMatch, bUpdateAttributes
)
Description
Sets the hotspot text to the specified value for the hotspots and slices in the selection.
Arguments
whatToSet
Acceptable values are
"hotspots"
,
"slices"
, or
"hotspots and slices"
.
textString
A string that specifies the text to be used for the hotspot or slice.
urlToMatch
A string that specifies a URL that is already assigned to one or more hotspots in the document. If this
value is not
null
, the URLs of all hotspots or slices in the document that have
urlToMatch
as their URL are changed
to
textString
.
Note:
The URLs of both selected and unselected hotspots or slices are changed.
bUpdateAttributes
Boolean. If
true
, changed hotspots inherit the color, target, and alt tag text that were most
recently associated with the new text value. For example, suppose
textString
is
,
and the last time
was used, it was used with a color of blue, a target of none, and an
alt tag of “Link to My Home Page”. If
bUpdateAttributes
is
true
, any hotspot or slice whose text is now being
changed to
will also have a color of blue, a target of none, and an alt tag text of
"Link
to My Home Page"
.
Returns
Nothing.
Description
Sets the hotspot text to the specified value for the hotspots and slices in the selection.
Example
The following command creates a slice and inserts the HTML text,
"I am HTML text"
:
fw.getDocumentDOM().setHotspotText("Slice ","I am HTML text", null, true);