NAME¶
EditorInfo - stores information about an editor's contents
SYNOPSIS¶
#include <Unidraw/editorinfo.h>
DESCRIPTION¶
An EditorInfo object is a UMap that stores a list of strings and/or string
tuples. Application-specific editors can use these objects to store
information about what components, commands, and tools they incorporate in
their interface. The programmer can write out this information with a catalog
object and read it back in later. The application can then let the user change
the editor's configuration by editing the catalog-generated file. For example,
an EditorInfo object could have a list of names for tools in the editor's
interface that have been saved with the catalog. When the application is
restarted, the EditorInfo object can be read first, and then the catalog can
reconstruct the tools given their names.
PUBLIC OPERATIONS¶
- EditorInfo()
- Construct an EditorInfo instance.
- void Register(const char* name, const char* info = ``'')
- void UnregisterName(const char*)
- void UnregisterInfo(const char*)
- boolean Registered(const char* name)
- Register enters a name or name-info tuple into the EditorInfo object.
UnregisterName removes an entry whose name string matches the given one,
while UnregisterInfo removes an entry whose info string matches the given
one. The Registered operation returns whether or not an entry with a
matching name exists.
- const char* GetName(const char* info)
- const char* GetInfo(const char* name)
- Name-info tuple lookup operations. The GetName operation returns the name
corresponding to a given info string, while the GetInfo operation returns
the info string for a given name.
- const char* GetName(int index)
- const char* GetInfo(int index)
- Name or info strings can be accessed by an index that reflects the order
in which they were registered. These operations return the name or info
string for a given index.
SEE ALSO¶
Catalog(3U), Editor(3U), UMap(3U)