swirl
Guide to OmniMark 9   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
  Related Syntax    
operator  

usemap

 
 

Return type: String
Returns:       Map names.

Syntax

usemap (is | isnt)  (#none | #empty)


Purpose

usemap is an element test, which tests the short reference map associated with the currently opened element (or the element specified by the element-qualifiers) for one of the map names specified in the test.

This test is used to detect the association of usemaps with the elements in the DTD, not in the document instance.

The test succeeds:

Knowing whether or not an element type has an associated usemap declaration is important if the OmniMark program is creating an SGML document from an input SGML document: usemap may affect the way the short reference delimiters are interpreted. When "normalizing" a document, it is usually safest to issue a "<!USEMAP #EMPTY>" declaration at the start of any element with which a usemap declaration (for a map other than #empty) has been associated in the DTD.

The usemap-name is the name of a usemap declaration in the DTD.

Elements which have had short reference maps associated with them by usemap declarations can be identified by the usemap is test. Short reference map names are subject to the NAMELEN and NAMECASE GENERAL declarations in the SGML declaration..

If the element-qualifier specifies an element which does not exist, then the test fails.

The following variations are permitted:

    Related Syntax
 
 
 

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]

OmniMark 9.1.0 Documentation Generated: September 2, 2010 at 1:51:21 pm
If you have any comments about this section of the documentation, please use this form.

Copyright © Stilo International plc, 1988-2010.