Paved::toplevel - 1.1

Table Of Contents

• NAME
• SYNOPSIS
• INTRODUCTION
• STANDARD OPTIONS
• PAVED-SPECIFIC OPTIONS
• WIDGET COMMANDS
• EXTENDED COMMANDS
• BINDINGS
• EXAMPLE
• NOTES
• HISTORY

NAME

Paved::toplevel - an extension of the toplevel widget

SYNOPSIS

package require Paved::toplevel

Paved::toplevel pathName ?options?

INTRODUCTION

Paved::toplevel is an extension of the toplevel widget.

A Paved-Toplevel is simply a toplevel with a paved (tiled) image acting as background.

STANDARD OPTIONS

.. all toplevel options are supported.

PAVED-SPECIFIC OPTIONS

-tile image

Specifies an image to display as background, which must have been created with the "image create" command. If image is the empty string, the background is disabled.

-tile filename

filename can be also the name of a supported graphic file ( see [ image types ] )

WIDGET COMMANDS

.. all toplevel widget commands are supported.

EXTENDED COMMANDS

no extended command.

BINDINGS

A script is attached to the <Configure> event for the pseudo class PavedToplevel, so that each time the widget is resized, the background image is resized accordling.

EXAMPLE

    package require Paved::toplevel
     # suppose xyz.gif is in current directory
    image create photo xyzImage -file xyz.gif 
     # create a tiled-toplevel widget; use 'xyzImage' as background.
    Paved::toplevel .z -tile xyzImage -borderwidth 10 -relief sunken

or in a more compact form:

    package require Paved::toplevel
    Paved::toplevel .z -tile xyz.gif -borderwidth 10 -relief sunken

NOTES

For each Paved::toplevel widget ".x" , the following items will be created:

• .x.bg - an internal 'label' used for holding the image
• .x_bg - an auxiliary 'image'
• imageNN - another auxiliary 'image' (NN is a serial number)

These items should never be manipulated. They will be automatically destroyed when widget ".x" is destroyed.

HISTORY

• 1.0
  • initial revision
• 1.1
  • Added Paved::toplevelAdaptor for 'paving' existing toplevel widgets.
  • Removed dependency from a fixed 'Snit' package (required Snit 0.91 or later).