Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Tk_GetReliefFromObj(3)	     Tk	Library	Procedures	Tk_GetReliefFromObj(3)

______________________________________________________________________________

NAME
       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  re-
					   porting.

       Tcl_Obj *objPtr (in/out)		   String  value  contains name	of re-
					   lief,  one  of  "flat",   "groove",
					   "raised",   "ridge",	  "solid",  or
					   "sunken"; the internal rep will  be
					   modified to cache corresponding re-
					   lief	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_RE-
					   LIEF_FLAT, TK_RELIEF_RAISED,	TK_RE-
					   LIEF_SUNKEN,	     TK_RELIEF_GROOVE,
					   TK_RELIEF_SOLID,	or	TK_RE-
					   LIEF_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 does	not 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
       interp's	result if interp is not	NULL.  Tk_GetReliefFromObj caches  in-
       formation  about	 the  return  value  in	objPtr,	which speeds up	future
       calls to	Tk_GetReliefFromObj with the same objPtr.

       Tk_GetRelief is identical to Tk_GetReliefFromObj	except	that  the  de-
       scription  of  the  relief is specified with a string instead of	an ob-
       ject.  This prevents Tk_GetRelief from caching  the  return  value,  so
       Tk_GetRelief is less efficient than Tk_GetReliefFromObj.

       Tk_NameOfRelief is the logical inverse of Tk_GetRelief.	Given a	relief
       value it	 returns  the  corresponding  string  (flat,  raised,  sunken,
       groove,	solid, or ridge).  If relief is	not a legal relief value, then
       "unknown	relief"	is returned.

KEYWORDS
       name, relief, string

Tk				      8.1		Tk_GetReliefFromObj(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Tk_GetRelief.tk85&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help