piePeripheralLabeler(n)   piePeripheralLabeler class   piePeripheralLabeler(n)



______________________________________________________________________________

NAME
       piePeripheralLabeler - tkpiechart pie peripheral style labeler class

SYNOPSIS
       stooop::new piePeripheralLabeler canvas ?options?

       switched::configure piePeripheralLabelerObject ?options?

       switched::cget piePeripheralLabelerObject option

_________________________________________________________________

DESCRIPTION
       The pie peripheral style labeler object is used as a slice label placer
       for a pie object and is passed to the pie constructor via its -labeler
       option (see the pie class manual).

       The slice description text labels are arranged in 2 columns below the
       pie graphics, whereas the slice values are placed next to the slice and
       actually follow the slice as the pie is updated. Each description label
       text is placed to the right of a rectangle, the background color of
       which matches its corresponding slice. Each description label is
       actually a canvasLabel object.

       There is no need to delete a piePeripheralLabeler object as it is
       automatically handled by the pie class.

       stooop::new piePeripheralLabeler canvas ?options?
              Creates a piePeripheralLabeler object in the specified Tk
              canvas. The piePeripheralLabeler object identifier is returned
              (refered to as piePeripheralLabelerObject in this document).

       switched::configure piePeripheralLabelerObject ?options?
              Configures a piePeripheralLabeler object or returns all the
              options with their current values if no options are passed as
              parameters.

       switched::cget piePeripheralLabelerObject option
              Returns an option value for the specified piePeripheralLabeler
              object.

OPTIONS
       -font value
              Specifies a font for the slice labels. If not specified, the
              default font is system dependent.

       -justify value
              Specifies how to justify labels within their own column. Must be
              one of left, center or right. Defaults to left. For example, if
              justification is right, all column labels right edges are
              aligned.

       -offset value
              Specifies the distance between the pie graphics and the closest
              slice label. This value may be specified in any of the forms
              described in the canvas COORDINATES manual section.

       -smallfont
              Specifies a font for the slice values. It is usually a small
              font in order to avoid values overlapping when 2 slices are very
              close to each other. If not specified, the description label
              font (-font option) is used.

       -widestvaluetext
              Specifies a string of maximum width for slice values (placed
              around the pie next to the slices), so that enough room is
              allocated for these value labels when the pie width and height
              are set. It defaults to 00.0. For example, it could be set to
              "00.00 %".

TAGS
       The labeler has the following specific tag (see the canvas manual page
       ITEM IDS AND TAGS section for more information):

       o      piePeripheralLabeler(piePeripheralLabelerObject)

BUGS, IDEAS, FEEDBACK
       This document, and the package it describes, will undoubtedly contain
       bugs and other problems.  Please report such in the category tkpiechart
       of the Tklib Trackers [http://core.tcl.tk/tklib/reportlist].  Please
       also report any ideas for enhancements you may have for either package
       and/or documentation.

SEE ALSO
       canvasLabel, pie, pieBoxLabeler

KEYWORDS
       canvas, labeler, pie, slice

COPYRIGHT
       Copyright (c) 1995-2004 Jean-Luc Fontaine <jfontain@free.fr>




tklib                                 6.6              piePeripheralLabeler(n)
