Adobe 38040334 API Reference - Page 270
Translation functions, dom.runTranslator
![]() |
UPC - 883919090467
View all Adobe 38040334 manuals
Add to My Manuals
Save this manual to your list of manuals |
Page 270 highlights
DREAMWEAVER CS3 265 API Reference 7 Dreamweaver calls the text() function for each span of text in the document (that is, everything that is not a tag or a directive). Text spans include text that is not visible to the user, such as the text inside a or tag. The text() function accepts two arguments, a string that contains the text and the document offset, which is the number of bytes in the document before the closing of the closing tag. The text() function returns a Boolean value that indicates whether scanning should continue. Arguments HTMLstr, parserCallbackObj • The HTMLstr argument is a string that contains code. • The parserCallbackObj argument is a JavaScript object that has one or more of the following methods: openTagBegin(), openTagEnd(), closeTagBegin(), closeTagEnd(), directive(), attribute(), and text(). For best performance, parserCallbackObj should be a shared library that is defined using the C-Level Extensibility interface. Performance is also improved if parserCallbackObj defines only the callback functions that it needs. Returns A Boolean value: true if the operation completed successfully; false otherwise. Example The following sequence of steps provide an example of how to use the dreamweaver.scanSourceString() function: 1 Create an implementation for one or more of the seven callback functions. 2 Write a script that calls the dreamweaver.scanSourceString() function. 3 The dreamweaver.scanSourceString() function passes a string that contains HTML and pointers to the callback functions that you wrote. For example, the string of HTML is "hello". 4 Dreamweaver analyzes the string and determines that the string contains a font tag. Dreamweaver calls the callback functions in the following sequence: • The openTagBegin() function • The attribute() function (for the size attribute) • The openTagEnd() function • The text() function (for the "hello" string) • The closeTagBegin() and closeTagEnd() functions Translation functions Translation functions deal either directly with translators or with translation results. These functions get information about or run a translator, edit content in a locked region, and specify that the translated source should be used when getting and setting selection offsets. dom.runTranslator() Availability Dreamweaver 3.
![](/manual_guide/products/adobe-38040334-api-reference-b593776/270.png)