Type: info
         Title: Introduction of new Smart Tag API
     Posted by: [EMAIL PROTECTED]
      Affected: sw
Effective from: cws smarttags3


*Summary*
--------
New Smart Tag API in ::com::sun::star::smarttags

*Description*
-------------
With OOo 2.2, a first draft of a Smart Tag API has been introduced.
That API only provided some basic Smart Tag functionality which had to
be enhanced in many regards. An overview about Smart Tags and the
current (OOo 2.2) Smart Tag API can be found here:

http://wiki.services.openoffice.org/wiki/Smart_Tags

For the new Smart Tag API, new services/interfaces have been introduced:

New services:
+com.sun.star.smarttags.SmartTagRecognizer
+com.sun.star.smarttags.SmartTagAction

New interfaces:
+com.sun.star.smarttags.XSmartTagRecognizer
+com.sun.star.smarttags.XSmartTagAction
+com.sun.star.text.XTextMarkup
+com.sun.star.container.XStringKeyMap 

New enums/constant groups:
+com.sun.star.smarttags.SmartTagRecognizerMode
+com.sun.star.text.TextMarkupType


Short Description of the services/interfaces:

- A SmartTagRecognizer is used to find smart tags in a document. Note:
There may be a couple of installed SmartTagRecognizer components.

- A SmartTagAction defines actions associated with smart tags. Note:
There may be a couple of installed SmartTagAction components.

- SmartTagRecognizerMode is used to specify the type of text
(paragraph, cell content, single word) passed to the recognize
function of the SmartTagRecognizer service.

- The XTextMarkup interface provides functionality to highlight the
text of a paragraph. This interface is used by the recognize function
of the SmartTagRecognizer service to mark text as smart tags.

- TextMarkupType defines some constants to specify the type of the
highlighted text (smart tag, spell check, grammar check).

- The interface XStringKeyMap provides functions to map strings to
anys. This is used to associate user defined data with the smart tag
identified by a SmartTagRecognizer. This user defined data will be
stored together with the smart tag and passed to a SmartTagAction on
invocation. 


For more information see the respective IDL files.



---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to