33. insertCharByName
Prev | Chapter 6. Commands written in the Java™ programming language | Next

## 33. insertCharByName

Parameter syntax:

    [ '[DocBookIfNone]'|'[DocBook]' ]? [ S entity_name ]?

Inserts at caret position a character specified using its entity name. If the entity name is not specified, this command displays a dialog box (supporting auto-completion) which allows to choose it interactively.

### Important

This command does not insert a reference to a character entity, it inserts a character. It must be considered as an alternative to using the Characters tool of XMLmind XML Editor.

Unless the `[DocBookIfNone]` option or the `[DocBook]` option is specified, this command cannot be executed if the document being edited has no DTD defining character entities.

If the `[DocBookIfNone]` option is specified, the dialog box lists the names of the character entities defined in the DocBook 4.2 DTD, but only if the DTD/schema of the document being edited does not define its own character entities.

If the `[DocBook]` option is specified, the dialog box lists the names of the character entities defined in the DocBook 4.2 DTD, whatever is the DTD/schema of the document being edited.

Examples:

    insertCharByName
    insertCharByName Beta
    insertCharByName [DocBookIfNone]
    insertCharByName [DocBookIfNone] mdash
    insertCharByName [DocBook]
    insertCharByName [DocBook] lambda

Prev | Up | Next
32. insert | Home | 34. insertCharSequence