Tk_GetReliefFromObj,  Tk_GetRelief, Tk_NameOfRelief - translate between
       strings and relief values

SYNOPSIS

       #include <tk.h>

       int                                                                     |
       Tk_GetReliefFromObj(interp, objPtr, reliefPtr)                          |

       int
       Tk_GetRelief(interp, name, reliefPtr)

       CONST char *
       Tk_NameOfRelief(relief)

ARGUMENTS

       Tcl_Interp   *interp      (in)      Interpreter  to   use   for   error
                                           reporting.

       Tcl_Obj      *objPtr      (in/out)                                      ||
                                           String  value  contains   name   of |
                                           relief   (one   of   flat,  groove, |
                                           raised, ridge, solid,  or  sunken); |
                                           internal  rep  will  be modified to |
                                           cache corresponding relief value.   |

       char         *string      (in)                                          ||
                                           Same  as  objPtr except description |
                                           of relief is passed as a string.

       int          *reliefPtr   (out)     Pointer to  location  in  which  to
                                           store relief value corresponding to
                                           objPtr or name.

       CONST char   *name                  Name of the relief.

       int          relief       (in)      Relief      value      (one      of
                                           TK_RELIEF_FLAT,   TK_RELIEF_RAISED,
                                           TK_RELIEF_SUNKEN, TK_RELIEF_GROOVE,
                                           TK_RELIEF_SOLID,                 or
                                           TK_RELIEF_RIDGE).
_________________________________________________________________

DESCRIPTION

       Tk_GetReliefFromObj places in *reliefPtr the relief value corresponding |
       to  the  value  of  objPtr.   This value will be one of TK_RELIEF_FLAT, |
       TK_RELIEF_RAISED, TK_RELIEF_SUNKEN, TK_RELIEF_GROOVE,  TK_RELIEF_SOLID, |
       or  TK_RELIEF_RIDGE.   Under  normal  circumstances the return value is |
       TCL_OK and interp is unused.  If objPtr  doesn't  contain  one  of  the |
       valid relief names or an abbreviation of one of them, then TCL_ERROR is |
       returned, *reliefPtr is unmodified, and an error message is  stored  in |

KEYWORDS

       name, relief, string



Tk                                    8.1               Tk_GetReliefFromObj(3)