NAME

       Tk_GetJustifyFromObj,  Tk_GetJustify,  Tk_NameOfJustify  -  translate  between strings and
       justification styles

SYNOPSIS

       #include <tk.h>

       int                                                                                        │
       Tk_GetJustifyFromObj(interp, objPtr, justifyPtr)                                           │

       int                                                                                        │
       Tk_GetJustify(interp, string, justifyPtr)                                                  │

       CONST char *                                                                               │
       Tk_NameOfJustify(justify)                                                                  │

ARGUMENTS                                                                                         │
       Tcl_Interp   *interp       (in)                                                            │
                                            Interpreter to use for error reporting, or NULL.      │

       Tcl_Obj      *objPtr       (in/out)                                                        │
                                            String value contains  name  of  justification  style │
                                            (left,  right,  or center).  The internal rep will be │
                                            modified to cache corresponding justify value.        │

       CONST char   *string       (in)                                                            │
                                            Same as objPtr except  description  of  justification │
                                            style is passed as a string.

       int          *justifyPtr   (out)     Pointer  to  location in which to store justify value
                                            corresponding to objPtr or string.

       Tk_Justify   justify       (in)      Justification style (one of the values listed below).
_________________________________________________________________

DESCRIPTION

       Tk_GetJustifyFromObj places in *justifyPtr the justify  value  corresponding  to  objPtr's │
       value.  This value will be one of the following:

       TK_JUSTIFY_LEFT
              Means  that  the text on each line should start at the left edge of the line;  as a
              result, the right edges of lines may be ragged.

       TK_JUSTIFY_RIGHT
              Means that the text on each line should end at the right edge of the  line;   as  a
              result, the left edges of lines may be ragged.

       TK_JUSTIFY_CENTER
              Means  that  the  text on each line should be centered;  as a result, both the left
              and right edges of lines may be ragged.

       Under normal circumstances the return value is TCL_OK and interp  is  unused.   If  objPtr │
       doesn't  contain  a  valid  justification  style or an abbreviation of one of these names, │
       TCL_ERROR is returned, *justifyPtr is unmodified,  and  an  error  message  is  stored  in │
       interp's  result  if interp isn't NULL.  Tk_GetJustifyFromObj caches information about the │
       return value in objPtr, which speeds up future calls to Tk_GetJustifyFromObj with the same │
       objPtr.                                                                                    │

       Tk_GetJustify  is  identical  to  Tk_GetJustifyFromObj  except that the description of the │
       justification  is  specified  with  a  string  instead  of  an  object.    This   prevents │
       Tk_GetJustify  from  caching  the  return  value,  so Tk_GetJustify is less efficient than │
       Tk_GetJustifyFromObj.

       Tk_NameOfJustify is the logical inverse  of  Tk_GetJustify.   Given  a  justify  value  it
       returns  a statically-allocated string corresponding to justify.  If justify isn't a legal
       justify value, then ``unknown justification style'' is returned.

KEYWORDS

       center, fill, justification, string