Application :: registerTextDatabase - Register text database
A text database is a database that provides text versions for different languages. Usually, the dictionary or resource database is used as text database.
The function is called in order to register a text databases to the application. The text database passed in cDatabase. The last text database inserted will be the first one searched. When the text entry looked for is not available in this text database, searching continues with the last but one text database registered for the application etc.
When the text database had already been registered before, it will be moved to top of the list of text databases.
Text databases are searched by name (database path). In case that database had been opened several times, is will be registered as text database ones, only.
Implementation details
- cDatabase
- Database handle
The database handle refers to an (usually) opened database. Calling functions with invalid database handles may cause an exception. For checking the database handle, isValid() can be called.