Tkinter.Canvas

class Tkinter.Canvas(master=None, cnf={}, **kw)[source]

Canvas widget to display graphical elements like lines or text.

Methods

_Misc__winfo_getint(x) Internal function.
_Misc__winfo_parseitem(t) Internal function.
__contains__(key)
__getitem__(key) Return the resource value for a KEY given as string.
__init__([master, cnf]) Construct a canvas widget with the parent MASTER.
__setitem__(key, value)
__str__() Return the window path name of this widget.
_bind(what, sequence, func, add[, needcleanup]) Internal function.
_configure(cmd, cnf, kw) Internal function.
_create(itemType, args, kw) Internal function.
_displayof(displayof) Internal function.
_do(name[, args])
_getboolean(string) Internal function.
_getconfigure(*args) Call Tcl configure command and return the result as a dict.
_getconfigure1(*args)
_getdoubles(string) Internal function.
_getints(string) Internal function.
_grid_configure(command, index, cnf, kw) Internal function.
_gridconvvalue(value)
_nametowidget(name) Return the Tkinter instance of a widget identified by its Tcl name NAME.
_options(cnf[, kw]) Internal function.
_register(func[, subst, needcleanup]) Return a newly created Tcl function.
_report_exception() Internal function.
_root() Internal function.
_setup(master, cnf) Internal function.
_substitute(*args) Internal function.
addtag(*args) Internal function.
addtag_above(newtag, tagOrId) Add tag NEWTAG to all items above TAGORID.
addtag_all(newtag) Add tag NEWTAG to all items.
addtag_below(newtag, tagOrId) Add tag NEWTAG to all items below TAGORID.
addtag_closest(newtag, x, y[, halo, start]) Add tag NEWTAG to item which is closest to pixel at X, Y.
addtag_enclosed(newtag, x1, y1, x2, y2) Add tag NEWTAG to all items in the rectangle defined by X1,Y1,X2,Y2.
addtag_overlapping(newtag, x1, y1, x2, y2) Add tag NEWTAG to all items which overlap the rectangle defined by X1,Y1,X2,Y2.
addtag_withtag(newtag, tagOrId) Add tag NEWTAG to all items with TAGORID.
after(ms[, func]) Call function once after given time.
after_cancel(id) Cancel scheduling of function identified with ID.
after_idle(func, *args) Call FUNC once if the Tcl main loop has no event to process.
bbox(*args) Return a tuple of X1,Y1,X2,Y2 coordinates for a rectangle which encloses all items with tags specified as arguments.
bell([displayof]) Ring a display’s bell.
bind([sequence, func, add]) Bind to this widget at event SEQUENCE a call to function FUNC.
bind_all([sequence, func, add]) Bind to all widgets at an event SEQUENCE a call to function FUNC.
bind_class(className[, sequence, func, add]) Bind to widgets with bindtag CLASSNAME at event SEQUENCE a call of function FUNC.
bindtags([tagList]) Set or get the list of bindtags for this widget.
canvasx(screenx[, gridspacing]) Return the canvas x coordinate of pixel position SCREENX rounded to nearest multiple of GRIDSPACING units.
canvasy(screeny[, gridspacing]) Return the canvas y coordinate of pixel position SCREENY rounded to nearest multiple of GRIDSPACING units.
cget(key) Return the resource value for a KEY given as string.
check()
clipboard_append(string, **kw) Append STRING to the Tk clipboard.
clipboard_clear(**kw) Clear the data in the Tk clipboard.
clipboard_get(**kw) Retrieve data from the clipboard on window’s display.
colormodel([value]) Useless.
columnconfigure(index[, cnf]) Configure column INDEX of a grid.
config([cnf]) Configure resources of a widget.
configure([cnf]) Configure resources of a widget.
coords(*args) Return a list of coordinates for the item given in ARGS.
create_arc(*args, **kw) Create arc shaped region with coordinates x1,y1,x2,y2.
create_bitmap(*args, **kw) Create bitmap with coordinates x1,y1.
create_image(*args, **kw) Create image item with coordinates x1,y1.
create_line(*args, **kw) Create line with coordinates x1,y1,...,xn,yn.
create_oval(*args, **kw) Create oval with coordinates x1,y1,x2,y2.
create_polygon(*args, **kw) Create polygon with coordinates x1,y1,...,xn,yn.
create_rectangle(*args, **kw) Create rectangle with coordinates x1,y1,x2,y2.
create_text(*args, **kw) Create text with coordinates x1,y1.
create_window(*args, **kw) Create window with coordinates x1,y1,x2,y2.
dchars(*args) Delete characters of text items identified by tag or id in ARGS (possibly several times) from FIRST to LAST character (including).
delete(*args) Delete items identified by all tag or ids contained in ARGS.
deletecommand(name) Internal function.
destroy() Destroy this and all descendants widgets.
dtag(*args) Delete tag or id given as last arguments in ARGS from items identified by first argument in ARGS.
event_add(virtual, *sequences) Bind a virtual event VIRTUAL (of the form <<Name>>) to an event SEQUENCE such that the virtual event is triggered whenever SEQUENCE occurs.
event_delete(virtual, *sequences) Unbind a virtual event VIRTUAL from SEQUENCE.
event_generate(sequence, **kw) Generate an event SEQUENCE.
event_info([virtual]) Return a list of all virtual events or the information about the SEQUENCE bound to the virtual event VIRTUAL.
find(*args) Internal function.
find_above(tagOrId) Return items above TAGORID.
find_all() Return all items.
find_below(tagOrId) Return all items below TAGORID.
find_closest(x, y[, halo, start]) Return item which is closest to pixel at X, Y.
find_enclosed(x1, y1, x2, y2) Return all items in rectangle defined by X1,Y1,X2,Y2.
find_overlapping(x1, y1, x2, y2) Return all items which overlap the rectangle defined by X1,Y1,X2,Y2.
find_withtag(tagOrId) Return all items with TAGORID.
focus(*args) Set focus to the first item specified in ARGS.
focus_displayof() Return the widget which has currently the focus on the display where this widget is located.
focus_force() Direct input focus to this widget even if the application does not have the focus.
focus_get() Return the widget which has currently the focus in the application.
focus_lastfor() Return the widget which would have the focus if top level for this widget gets the focus from the window manager.
focus_set() Direct input focus to this widget.
forget() Unmap this widget and do not use it for the packing order.
form([cnf])
getboolean(s) Return a boolean value for Tcl boolean values true and false given as parameter.
gettags(*args) Return tags associated with the first item specified in ARGS.
getvar([name]) Return value of Tcl variable NAME.
grab_current() Return widget which has currently the grab in this application or None.
grab_release() Release grab for this widget if currently set.
grab_set() Set grab for this widget.
grab_set_global() Set global grab for this widget.
grab_status() Return None, “local” or “global” if this widget has no, a local or a global grab.
grid([cnf]) Position a widget in the parent widget in a grid.
grid_bbox([column, row, col2, row2]) Return a tuple of integer coordinates for the bounding box of this widget controlled by the geometry manager grid.
grid_columnconfigure(index[, cnf]) Configure column INDEX of a grid.
grid_configure([cnf]) Position a widget in the parent widget in a grid.
grid_forget() Unmap this widget.
grid_info() Return information about the options for positioning this widget in a grid.
grid_location(x, y) Return a tuple of column and row which identify the cell at which the pixel at position X and Y inside the master widget is located.
grid_propagate([flag]) Set or get the status for propagation of geometry information.
grid_remove() Unmap this widget but remember the grid options.
grid_rowconfigure(index[, cnf]) Configure row INDEX of a grid.
grid_size() Return a tuple of the number of column and rows in the grid.
grid_slaves([row, column]) Return a list of all slaves of this widget in its packing order.
icursor(*args) Set cursor at position POS in the item identified by TAGORID.
image_names() Return a list of all existing image names.
image_types() Return a list of all available image types (e.g.
index(*args) Return position of cursor as integer in item specified in ARGS.
info() Return information about the packing options for this widget.
insert(*args) Insert TEXT in item TAGORID at position POS.
itemcget(tagOrId, option) Return the resource value for an OPTION for item TAGORID.
itemconfig(tagOrId[, cnf]) Configure resources of an item TAGORID.
itemconfigure(tagOrId[, cnf]) Configure resources of an item TAGORID.
keys() Return a list of all resource names of this widget.
lift(*args) Raise an item TAGORID given in ARGS (optional above another item).
location(x, y) Return a tuple of column and row which identify the cell at which the pixel at position X and Y inside the master widget is located.
lower(*args) Lower an item TAGORID given in ARGS (optional below another item).
mainloop([n]) Call the mainloop of Tk.
move(*args) Move an item TAGORID given in ARGS.
nametowidget(name) Return the Tkinter instance of a widget identified by its Tcl name NAME.
option_add(pattern, value[, priority]) Set a VALUE (second parameter) for an option PATTERN (first parameter).
option_clear() Clear the option database.
option_get(name, className) Return the value for an option NAME for this widget with CLASSNAME.
option_readfile(fileName[, priority]) Read file FILENAME into the option database.
pack([cnf]) Pack a widget in the parent widget.
pack_configure([cnf]) Pack a widget in the parent widget.
pack_forget() Unmap this widget and do not use it for the packing order.
pack_info() Return information about the packing options for this widget.
pack_propagate([flag]) Set or get the status for propagation of geometry information.
pack_slaves() Return a list of all slaves of this widget in its packing order.
place([cnf]) Place a widget in the parent widget.
place_configure([cnf]) Place a widget in the parent widget.
place_forget() Unmap this widget.
place_info() Return information about the placing options for this widget.
place_slaves() Return a list of all slaves of this widget in its packing order.
postscript([cnf]) Print the contents of the canvas to a postscript file.
propagate([flag]) Set or get the status for propagation of geometry information.
quit() Quit the Tcl interpreter.
register(func[, subst, needcleanup]) Return a newly created Tcl function.
rowconfigure(index[, cnf]) Configure row INDEX of a grid.
scale(*args) Scale item TAGORID with XORIGIN, YORIGIN, XSCALE, YSCALE.
scan_dragto(x, y[, gain]) Adjust the view of the canvas to GAIN times the difference between X and Y and the coordinates given in scan_mark.
scan_mark(x, y) Remember the current X, Y coordinates.
select_adjust(tagOrId, index) Adjust the end of the selection near the cursor of an item TAGORID to index.
select_clear() Clear the selection if it is in this widget.
select_from(tagOrId, index) Set the fixed end of a selection in item TAGORID to INDEX.
select_item() Return the item which has the selection.
select_to(tagOrId, index) Set the variable end of a selection in item TAGORID to INDEX.
selection_clear(**kw) Clear the current X selection.
selection_get(**kw) Return the contents of the current X selection.
selection_handle(command, **kw) Specify a function COMMAND to call if the X selection owned by this widget is queried by another application.
selection_own(**kw) Become owner of X selection.
selection_own_get(**kw) Return owner of X selection.
send(interp, cmd, *args) Send Tcl command CMD to different interpreter INTERP to be executed.
setvar([name, value]) Set Tcl variable NAME to VALUE.
size() Return a tuple of the number of column and rows in the grid.
slaves() Return a list of all slaves of this widget in its packing order.
tag_bind(tagOrId[, sequence, func, add]) Bind to all items with TAGORID at event SEQUENCE a call to function FUNC.
tag_lower(*args) Lower an item TAGORID given in ARGS (optional below another item).
tag_raise(*args) Raise an item TAGORID given in ARGS (optional above another item).
tag_unbind(tagOrId, sequence[, funcid]) Unbind for all items with TAGORID for event SEQUENCE the function identified with FUNCID.
tk_bisque() Change the color scheme to light brown as used in Tk 3.6 and before.
tk_focusFollowsMouse() The widget under mouse will get automatically focus.
tk_focusNext() Return the next widget in the focus order which follows widget which has currently the focus.
tk_focusPrev() Return previous widget in the focus order.
tk_menuBar(*args) Do not use.
tk_setPalette(*args, **kw) Set a new color scheme for all widget elements.
tk_strictMotif([boolean]) Set Tcl internal variable, whether the look and feel should adhere to Motif.
tkraise(*args) Raise an item TAGORID given in ARGS (optional above another item).
type(tagOrId) Return the type of the item TAGORID.
unbind(sequence[, funcid]) Unbind for this widget for event SEQUENCE the function identified with FUNCID.
unbind_all(sequence) Unbind for all widgets for event SEQUENCE all functions.
unbind_class(className, sequence) Unbind for all widgets with bindtag CLASSNAME for event SEQUENCE all functions.
update() Enter event loop until all pending events have been processed by Tcl.
update_idletasks() Enter event loop until all idle callbacks have been called.
wait_variable([name]) Wait until the variable is modified.
wait_visibility([window]) Wait until the visibility of a WIDGET changes (e.g.
wait_window([window]) Wait until a WIDGET is destroyed.
waitvar([name]) Wait until the variable is modified.
winfo_atom(name[, displayof]) Return integer which represents atom NAME.
winfo_atomname(id[, displayof]) Return name of atom with identifier ID.
winfo_cells() Return number of cells in the colormap for this widget.
winfo_children() Return a list of all widgets which are children of this widget.
winfo_class() Return window class name of this widget.
winfo_colormapfull() Return true if at the last color request the colormap was full.
winfo_containing(rootX, rootY[, displayof]) Return the widget which is at the root coordinates ROOTX, ROOTY.
winfo_depth() Return the number of bits per pixel.
winfo_exists() Return true if this widget exists.
winfo_fpixels(number) Return the number of pixels for the given distance NUMBER (e.g.
winfo_geometry() Return geometry string for this widget in the form “widthxheight+X+Y”.
winfo_height() Return height of this widget.
winfo_id() Return identifier ID for this widget.
winfo_interps([displayof]) Return the name of all Tcl interpreters for this display.
winfo_ismapped() Return true if this widget is mapped.
winfo_manager() Return the window mananger name for this widget.
winfo_name() Return the name of this widget.
winfo_parent() Return the name of the parent of this widget.
winfo_pathname(id[, displayof]) Return the pathname of the widget given by ID.
winfo_pixels(number) Rounded integer value of winfo_fpixels.
winfo_pointerx() Return the x coordinate of the pointer on the root window.
winfo_pointerxy() Return a tuple of x and y coordinates of the pointer on the root window.
winfo_pointery() Return the y coordinate of the pointer on the root window.
winfo_reqheight() Return requested height of this widget.
winfo_reqwidth() Return requested width of this widget.
winfo_rgb(color) Return tuple of decimal values for red, green, blue for COLOR in this widget.
winfo_rootx() Return x coordinate of upper left corner of this widget on the root window.
winfo_rooty() Return y coordinate of upper left corner of this widget on the root window.
winfo_screen() Return the screen name of this widget.
winfo_screencells() Return the number of the cells in the colormap of the screen of this widget.
winfo_screendepth() Return the number of bits per pixel of the root window of the screen of this widget.
winfo_screenheight() Return the number of pixels of the height of the screen of this widget in pixel.
winfo_screenmmheight() Return the number of pixels of the height of the screen of this widget in mm.
winfo_screenmmwidth() Return the number of pixels of the width of the screen of this widget in mm.
winfo_screenvisual() Return one of the strings directcolor, grayscale, pseudocolor, staticcolor, staticgray, or truecolor for the default colormodel of this screen.
winfo_screenwidth() Return the number of pixels of the width of the screen of this widget in pixel.
winfo_server() Return information of the X-Server of the screen of this widget in the form “XmajorRminor vendor vendorVersion”.
winfo_toplevel() Return the toplevel widget of this widget.
winfo_viewable() Return true if the widget and all its higher ancestors are mapped.
winfo_visual() Return one of the strings directcolor, grayscale, pseudocolor, staticcolor, staticgray, or truecolor for the colormodel of this widget.
winfo_visualid() Return the X identifier for the visual for this widget.
winfo_visualsavailable([includeids]) Return a list of all visuals available for the screen of this widget.
winfo_vrootheight() Return the height of the virtual root window associated with this widget in pixels.
winfo_vrootwidth() Return the width of the virtual root window associated with this widget in pixel.
winfo_vrootx() Return the x offset of the virtual root relative to the root window of the screen of this widget.
winfo_vrooty() Return the y offset of the virtual root relative to the root window of the screen of this widget.
winfo_width() Return the width of this widget.
winfo_x() Return the x coordinate of the upper left corner of this widget in the parent.
winfo_y() Return the y coordinate of the upper left corner of this widget in the parent.
xview(*args) Query and change the horizontal position of the view.
xview_moveto(fraction) Adjusts the view in the window so that FRACTION of the total width of the canvas is off-screen to the left.
xview_scroll(number, what) Shift the x-view according to NUMBER which is measured in “units” or “pages” (WHAT).
yview(*args) Query and change the vertical position of the view.
yview_moveto(fraction) Adjusts the view in the window so that FRACTION of the total height of the canvas is off-screen to the top.
yview_scroll(number, what) Shift the y-view according to NUMBER which is measured in “units” or “pages” (WHAT).