NAME

       Tk_AddOption - Add an option to the option database

SYNOPSIS

       #include <tk.h>

       void
       Tk_AddOption(tkwin, name, value, priority)

ARGUMENTS

       Tk_Window tkwin (in)                      Token for window.

       const char *name (in)                     Multi-element name of option.

       const char *value (in)                    Value of option.

       int priority (in)                         Overall priority level to use for option.
_________________________________________________________________________________________________

DESCRIPTION

       This  procedure  is  invoked to add an option to the database associated with tkwin's main
       window.  Name contains the option being specified and consists  of  names  and/or  classes
       separated  by asterisks or dots, in the usual X format.  Value contains the text string to
       associate with name; this value will be  returned  in  calls  to  Tk_GetOption.   Priority
       specifies  the  priority  of  the  value; when options are queried using Tk_GetOption, the
       value with the highest priority is returned.  Priority must be between 0  and  TK_MAX_PRIO
       (100).  Some common priority values are:

       TK_WIDGET_DEFAULT_PRIO
                           Used for default values hard-coded into widgets.

       TK_STARTUP_FILE_PRIO                    Used for options specified in application-specific
                                               startup files.

       TK_USER_DEFAULT_PRIO                                        Used for options specified  in
                                                                   user-specific  defaults files,
                                                                   such as  .Xdefaults,  resource
                                                                   databases  loaded  into  the X
                                                                   server,    or    user-specific
                                                                   startup files.

       TK_INTERACTIVE_PRIO                                                             Used   for
                                                                                       options
                                                                                       specified
                                                                                       interactively
                                                                                       after  the
                                                                                       application
                                                                                       starts
                                                                                       running.

KEYWORDS

       class, name, option, add