Next: allow-double-click Up: Class Reference Previous: set-label

`wx:canvas%`

Superclass: wx:window%

A canvas is a subwindow onto which graphics and text can be drawn, and mouse and keyboard input can be intercepted. At present, panel items cannot be placed on a canvas.

When you draw onto a canvas, you are really drawing onto a device context (see wx:dc%, wx:canvas-dc%). Although you can use the members of wx:canvas% for drawing, it is much better to get the device context from the canvas (see get-dc) and draw into it. Then, code which can draw into one device context can be reused for others, such as PostScript or memory device contexts (see wx:post-script-dc% and wx:memory-dc%).

(make-object wx:canvas% parent x y width height style name) -> wx:canvas% object
    parent : wx:frame% object or wx:panel% object
    x = -1 : small integer
    y = -1 : small integer
    width = -1 : small integer
    height = -1 : small integer
    style = 0 : small integer
    name = "canvas" : string
If x, y, width or height is -1, a default position/size is selected. The default may be platform-specific.
The style argument is a bitwise-ior combination of the following flags:
- wx:const-border -- gives the canvas a thin border
- wx:const-hscroll -- enables horizontal scrolling
- wx:const-vscroll -- enables vertical scrolling
(Use 0 for no flags.) The wx:const-hscroll and wx:const-vscroll flags create a canvas with an initially inactive scrollbar. The scrollbar is activated with set-scrollbars.
The name argument is used to associate a name with the canvas, allowing the application user to set X Windows resource values for each individual canvas.

Methods:

All methods:

Next: allow-double-click Up: Class Reference Previous: set-label

PLT