Tk_AddOption(3)       Tk Library Procedures       Tk_AddOption(3)



_________________________________________________________________

NAME
       Tk_AddOption - Add an option to the option database

SYNOPSIS
       #include 

       void
       Tk_AddOption(tkwin, name, value, priority)

ARGUMENTS
       Tk_Window    tkwin              (in)      Token  for  win-
                                                 dow.

       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_GetOp-
       tion.   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.  Some common priority values are:

       20     Used for default values hard-coded into widgets.

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

       60     Used   for   options   specified  in  user-specific
              defaults  files,  such  as  user-specific   startup
              files.

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



KEYWORDS
       class, name, option, add



Tk                                                Tk_AddOption(3)