Tk_GetOption(3tk)

Tk_GetOption(3)       Tk Library Procedures       Tk_GetOption(3)

_________________________________________________________________

NAME

     Tk_GetOption - retrieve an option from the option database

SYNOPSIS

     #include <tk.h>

     Tk_Uid
     Tk_GetOption(tkwin, name, class)

ARGUMENTS

     Tk_Window tkwin (in)           Token for window.

     const char *name (in)          Name of desired option.

     const char *class (in)         Class  of   desired   option.
                                    Null  means there is no class
                                    for this option;   do  lookup
                                    based on name only.
_________________________________________________________________

DESCRIPTION

     This procedure is invoked to retrieve  an  option  from  the
     database  associated  with tkwin's main window.  If there is
     an option for tkwin that matches the given  name  or  class,
     then  it  is  returned in the form of a Tk_Uid.  If multiple
     options match name and class, then the highest-priority  one
     is returned.  If no option matches, then NULL is returned.

     Tk_GetOption caches options related to tkwin so that succes-
     sive calls for the same tkwin will execute much more quickly
     than successive calls for different windows.

KEYWORDS

     class, name, option, retrieve

Tk                        Last change:                          1