Seth Woolley's Man Viewer

Tk_GetJustify(3) - Tk_GetJustify, Tk_GetJustifyFromObj, Tk_NameOfJustify - translate between strings and justification styles - man 3 Tk_GetJustify

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

Tk_GetJustifyFromObj(3)      Tk Library Procedures     Tk_GetJustifyFromObj(3)



______________________________________________________________________________

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(3,n), justifyPtr)                               |

       CONST char *                                                            |
       Tk_NameOfJustify(justify)                                               |

ARGUMENTS                                                                      |
       Tcl_Interp   *interp       (in(1,8))                                         ||
                                            Interpreter   to   use  for  error(8,n) |
                                            reporting, or NULL.                |

       Tcl_Obj      *objPtr       (in(1,8)/out)                                     ||
                                            String value contains name of jus- |
                                            tification style (left, right,  or |
                                            center).  The internal rep will be |
                                            modified  to  cache  corresponding |
                                            justify value.                     |

       CONST                                                                   |
       char   *string(3,n)       (in(1,8))                                         |     |
                                            Same as objPtr except  description |
                                            of  justification  style is passed |
                                            as a string.

       int          *justifyPtr   (out)     Pointer to location  in(1,8)  which  to
                                            store  justify value corresponding
                                            to objPtr or string(3,n).

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


DESCRIPTION
       Tk_GetJustifyFromObj  places  in(1,8)  *justifyPtr  the justify value corre- |
       sponding 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(8,n) message is stored in(1,8) interp's result if(3,n) |
       interp isn't NULL.  Tk_GetJustifyFromObj caches information  about  the |
       return  value  in(1,8)  objPtr, which speeds up future calls to Tk_GetJusti- |
       fyFromObj with the same objPtr.                                         |

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

       Tk_NameOfJustify is the logical inverse of Tk_GetJustify.  Given a jus-
       tify value it returns a statically-allocated  string(3,n)  corresponding  to
       justify.  If justify isn't a legal justify value, then ``unknown justi-
       fication style'' is returned.


KEYWORDS
       center, fill, justification, string(3,n)



Tk                                    8.1              Tk_GetJustifyFromObj(3)

References for this manual (incoming links)