Synopsis

canvasId create clipGroup [-option value...]

Options

-onButtonPress

type: string (default: "")

Tcl command which is executed if a mouse button is press inside the item. Before evaluation the following percent strings are substituated:

%w    canvas name
%i    item id
%t    type of event: one of buttonPress, button2Press or button3Press
%x    x coordinate
%y    y coordinate
%b    button number
%s    state of the buttons and modifiers (bitmask)

-onButtonRelease

type: string (default: "")

Tcl command which is executed if a mouse button is released if it has been pressed inside the item. Before evaluation the following percent strings are substituated:

%w    canvas name
%i    item id
%t    type of event: always buttonRelease
%x    x coordinate
%y    y coordinate
%b    button number
%s    state of the buttons and modifiers (bitmask)

-onEnter

type: string (default: "")

Tcl command which is executed if a mouse enters the item. Before evaluation the following percent strings are substituated:

%w    canvas name
%i    item id
%x    x coordinate
%y    y coordinate
%s    state of the buttons and modifiers (bitmask)

-onLeave

type: string (default: "")

Tcl command which is executed if a mouse enters the item. Before evaluation the following percent strings are substituated:

%w    canvas name
%i    item id
%x    x coordinate
%y    y coordinate
%s    state of the buttons and modifiers (bitmask)

-onMotion

type: string (default: "")

Tcl command which is executed if the mouse is moved inside the item. Before evaluation the following percent strings are substituated:

%w    canvas name
%i    item id
%x    x coordinate
%y    y coordinate
%s    state of the buttons and modifiers (bitmask)

-path

type: list-of-graphic-commands-and-floats

The path describing the bounds of the clipping region. Its syntax is the same as for canvas bPath.

-tags

type: list (default: "")

List of tags to be associated with this item. A tag must start with a alphabetic character which is followed by zero or more alphabetic or numeric characters.

Description

A clip group implements clipping for its children. A child is added to the clipg roup via its -parent option.

Commands

canvasId itemCommand tagOrId appendPath list-of-graphic-commands-and-floats

See command "appendCoords" of the canvas bPath.