Tk_GetReliefFromObj man page on OpenMandriva

Man page or keyword search:  
man Server   8135 pages
apropos Keyword Search (all sections)
Output format
OpenMandriva logo
[printable version]

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
					   reporting.

       Tcl_Obj *objPtr (in/out)		   String   value   contains  name  of
					   relief, one	of  “flat”,  “groove”,
					   “raised”,   “ridge”,	  “solid”,  or
					   “sunken” (or any  unique  abbrevia‐
					   tion	 thereof on input); the inter‐
					   nal 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 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
       information 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
       description of the relief is specified with  a  string  instead	of  an
       object.	 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)
[top]

List of man pages available for OpenMandriva

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net