Package Scientific :: Package TkWidgets :: Module TkPlotCanvas :: Class PlotCanvas

[frames] | no frames]

# Class PlotCanvas

      Tkinter.Misc --+
                     |
    Tkinter.BaseWidget --+
                         |
          Tkinter.Pack --+
                         |
         Tkinter.Place --+
                         |
          Tkinter.Grid --+
                         |
            Tkinter.Widget --+
                             |
                 Tkinter.Frame --+
                                 |
                                PlotCanvas

Tk plot widget

PlotCanvas objects support all operations of Tk widgets.

Nested Classes
Inherited from `Tkinter.Misc`: `getdouble`, `getint`

Instance Methods

__init__(self, master, width, height, background=`'``white``'`, font=`'``-*-helvetica-medium-r-normal--10-*-*-*-*-*-*-*``'`, **attr) Construct a frame widget with the parent MASTER. |

bind(self, *args) Bind to this widget at event SEQUENCE a call to function FUNC. |

clear(self) Clear the canvas |

draw(self, graphics, xaxis=None, yaxis=None) Draw something on the canvas |

reconfigure(self, event) |

redraw(self) Redraw the most recent canvas contents |

select(self, range) Highlight a range on the x-axis |

Inherited from `Tkinter.BaseWidget`: `destroy`

Inherited from `Tkinter.Misc`: `__getitem__`, `__setitem__`, `__str__`, `after`, `after_cancel`, `after_idle`, `bbox`, `bell`, `bind_all`, `bind_class`, `bindtags`, `cget`, `clipboard_append`, `clipboard_clear`, `clipboard_get`, `colormodel`, `columnconfigure`, `config`, `configure`, `deletecommand`, `event_add`, `event_delete`, `event_generate`, `event_info`, `focus`, `focus_displayof`, `focus_force`, `focus_get`, `focus_lastfor`, `focus_set`, `getboolean`, `getvar`, `grab_current`, `grab_release`, `grab_set`, `grab_set_global`, `grab_status`, `grid_bbox`, `grid_columnconfigure`, `grid_location`, `grid_propagate`, `grid_rowconfigure`, `grid_size`, `grid_slaves`, `image_names`, `image_types`, `keys`, `lift`, `lower`, `mainloop`, `nametowidget`, `option_add`, `option_clear`, `option_get`, `option_readfile`, `pack_propagate`, `pack_slaves`, `place_slaves`, `propagate`, `quit`, `register`, `rowconfigure`, `selection_clear`, `selection_get`, `selection_handle`, `selection_own`, `selection_own_get`, `send`, `setvar`, `size`, `slaves`, `tk_bisque`, `tk_focusFollowsMouse`, `tk_focusNext`, `tk_focusPrev`, `tk_menuBar`, `tk_setPalette`, `tk_strictMotif`, `tkraise`, `unbind`, `unbind_all`, `unbind_class`, `update`, `update_idletasks`, `wait_variable`, `wait_visibility`, `wait_window`, `waitvar`, `winfo_atom`, `winfo_atomname`, `winfo_cells`, `winfo_children`, `winfo_class`, `winfo_colormapfull`, `winfo_containing`, `winfo_depth`, `winfo_exists`, `winfo_fpixels`, `winfo_geometry`, `winfo_height`, `winfo_id`, `winfo_interps`, `winfo_ismapped`, `winfo_manager`, `winfo_name`, `winfo_parent`, `winfo_pathname`, `winfo_pixels`, `winfo_pointerx`, `winfo_pointerxy`, `winfo_pointery`, `winfo_reqheight`, `winfo_reqwidth`, `winfo_rgb`, `winfo_rootx`, `winfo_rooty`, `winfo_screen`, `winfo_screencells`, `winfo_screendepth`, `winfo_screenheight`, `winfo_screenmmheight`, `winfo_screenmmwidth`, `winfo_screenvisual`, `winfo_screenwidth`, `winfo_server`, `winfo_toplevel`, `winfo_viewable`, `winfo_visual`, `winfo_visualid`, `winfo_visualsavailable`, `winfo_vrootheight`, `winfo_vrootwidth`, `winfo_vrootx`, `winfo_vrooty`, `winfo_width`, `winfo_x`, `winfo_y`

Inherited from `Tkinter.Pack`: `forget`, `info`, `pack`, `pack_configure`, `pack_forget`, `pack_info`

Inherited from `Tkinter.Place`: `place`, `place_configure`, `place_forget`, `place_info`

Inherited from `Tkinter.Grid`: `grid`, `grid_configure`, `grid_forget`, `grid_info`, `grid_remove`, `location`

Class Variables
Inherited from `Tkinter.Misc`: `_noarg_`

Method Details

### __init__(self, master, width, height, background=`'``white``'`, font=`'``-*-helvetica-medium-r-normal--10-*-*-*-*-*-*-*``'`, **attr)
(Constructor)

Construct a frame widget with the parent MASTER.

Valid resource names: background, bd, bg, borderwidth, class, colormap, container, cursor, height, highlightbackground, highlightcolor, highlightthickness, relief, takefocus, visual, width.

Parameters:
  - `master` - the parent widget
  - `width` (`int`) - the initial width of the canvas
  - `height` (`int`) - the initial height of the canvas
  - `background` (`str`) - the background color
  - `font` (`str`) - the font used for the axis labels
  - `attr` - widget attributes
  - `zoom` (`bool`) - a flag that indicates whether interactive zooming (using the left mouse button) is enabled; the default is `False` (no zoom)
  - `select` - enables the user to select a range along the x axis by dragging the mouse (with the left button pressed) in the area under the x axis. If select is 0, no selection is possible. Otherwise the value of select must be a callable object that is called whenever the selection changes, with a single argument that can be `None` (no selection) or a tuple containing two x values.
Overrides: Tkinter.BaseWidget.__init__

### bind(self, *args)

Bind to this widget at event SEQUENCE a call to function FUNC.

SEQUENCE is a string of concatenated event patterns. An event pattern is of the form <MODIFIER-MODIFIER-TYPE-DETAIL> where MODIFIER is one of Control, Mod2, M2, Shift, Mod3, M3, Lock, Mod4, M4, Button1, B1, Mod5, M5 Button2, B2, Meta, M, Button3, B3, Alt, Button4, B4, Double, Button5, B5 Triple, Mod1, M1. TYPE is one of Activate, Enter, Map, ButtonPress, Button, Expose, Motion, ButtonRelease FocusIn, MouseWheel, Circulate, FocusOut, Property, Colormap, Gravity Reparent, Configure, KeyPress, Key, Unmap, Deactivate, KeyRelease Visibility, Destroy, Leave and DETAIL is the button number for ButtonPress, ButtonRelease and DETAIL is the Keysym for KeyPress and KeyRelease. Examples are <Control-Button-1> for pressing Control and mouse button 1 or <Alt-A> for pressing A and the Alt key (KeyPress can be omitted). An event pattern can also be a virtual event of the form <<AString>> where AString can be arbitrary. This event can be generated by event_generate. If events are concatenated they must appear shortly after each other.

FUNC will be called if the event sequence occurs with an instance of Event as argument. If the return value of FUNC is "break" no further bound function is invoked.

An additional boolean parameter ADD specifies whether FUNC will be called additionally to the other bound function or whether it will replace the previous function.

Bind will return an identifier to allow deletion of the bound function with unbind without memory leak.

If FUNC or SEQUENCE is omitted the bound function or list of bound events are returned.

Overrides: Tkinter.Misc.bind
  (inherited documentation)

### draw(self, graphics, xaxis=None, yaxis=None)

Draw something on the canvas

Parameters:
  - `graphics` - the graphics object (PolyLine, PolyMarker, or PlotGraphics) to be drawn
  - `xaxis` - `None` (no x-axis), `"automatic"` (automatic scaling), or a pair (x1, x2) defining the range of the x-axis
  - `yaxis` - `None` (no y-axis), `"automatic"` (automatic scaling), or a pair (y1, y2) defining the range of the y-axis

### select(self, range)

Highlight a range on the x-axis

Parameters:
  - `range` - the range on the x-axis to be highlighted. It can be `None` (no selection) or a sequence of two values on the x-axis.