canvasLabel(n) canvasLabel class canvasLabel(n)______________________________________________________________________________NAME
canvasLabel - tkpiechart canvas label class
SYNOPSIS
package require stooop 4.1
package require switched 2.2
package require tkpiechart 6.6
stooop::new canvasLabel canvas ?options?
switched::configure canvasLabelObject ?options?
switched::cget canvasLabelObject option
stooop::delete canvasLabelObject
_________________________________________________________________DESCRIPTION
The canvasLabel class brings some Tk label widget functionality to the
canvas text item, such as a background and a border.
The canvasLabel is built with a bullet rectangle on the left side of
the text. The relief changes according to the select state, with a tra‐
ditionally sunken relief when selected.
The label has a specific tag, which can be used to retrieve the coordi‐
nates of the object or move it, thanks to the canvas facilities.
stooop::new canvasLabel canvas ?options?
Creates a canvasLabel object in the specified Tk canvas. The
canvasLabel object identifier is returned (referred to as can‐
vasLabelObject in this document).
switched::configure canvasLabelObject ?options?
Configures a canvasLabel object or returns all the options with
their current values if no options are passed as parameters.
switched::cget canvasLabelObject option
Returns an option value for the specified canvasLabel object.
stooop::delete canvasLabelObject
Deletes the specified canvasLabel object.
OPTIONS-anchor value
Specifies the anchor position of the rectangle and the text,
relative to the positioning point. The behavior is similar to
the -anchor option of the canvas text item, except that the rec‐
tangle is taken into account. The default is center.
-background color
Specifies the background color of the bullet rectangle, as in
the -fill option of the canvas rectangle item. The default is
transparent (empty string).
-bordercolor color
Specifies the border color of the rectangle, as in the -outline
option of the canvas rectangle item. The default is black.
-borderwidth value
Specifies the border width of the rectangle, as in the -width
option of the canvas rectangle item. By default, the width is 1
pixel, which is the minimum width.
-bulletwidth value
Specifies the width of the rectangle placed to the left of the
text. Defaults to 10.
-font value
Specifies the font of the text, as in the -font option of the
canvas text item. The default is system dependent.
-foreground color
Specifies the color of the text, as in the -fill option of the
canvas text item. The default is black.
-justify value
Specifies how to justify the text, as in the -justify option of
the canvas text item. The default is left.
-minimumwidth value
The total label width will not go below the specified value, but
may be larger if the label text requires it.
-padding value
Specifies how much space to leave between the text and the clos‐
est rectangle edge. Units are identical to those specified in
the canvas COORDINATES manual section.
-scale list
List of 2 floating point numbers used to set the scaling factor
in the x and y axis. Scaling is applied immediately and defaults
to 1.
-select boolean
Sets the label state.
-selectrelief value
Either flat, raised or sunken. Specifies the 3D effect desired
for the text area when the label is selected.
-stipple bitmap
Specifies the stipple pattern filling the rectangle, as in the
-stipple option of the canvas rectangle item. There is no bitmap
by default.
-text text
Specifies the string to be displayed in the text area, as in the
-text option of the canvas text item. The default is an empty
string.
-textbackground color
Specifies the color of the text area background.
-width value
Specifies a maximum line length for the text, as in the -width
option of the canvas text item. The default is 0.
TAGS
The labeler has the following specific tag (see the canvas manual page
ITEM IDS AND TAGS section for more information):
· canvasLabel(canvasLabelObject)SEE ALSO
pie, pieBoxLabeler, piePeripheralLabeler
KEYWORDS
canvas, labeler, pie, slice
COPYRIGHT
Copyright (c) 1995-2004 Jean-Luc Fontaine <jfontain@free.fr>
tkpiechart 6.6 canvasLabel(n)