Scroll to navigation

autoscroll(3tk) Automatic mapping of scrollbars autoscroll(3tk)


NAME

autoscroll - Provides for a scrollbar to automatically mapped and unmapped as needed

SYNOPSIS

package require Tcl

package require autoscroll ?1.1?

::autoscroll::autoscroll scrollbar

::autoscroll::unautoscroll scrollbar

::autoscroll::wrap

::autoscroll::unwrap


DESCRIPTION

This package allows scrollbars to be mapped and unmapped as needed depending on the size and content of the scrollbars scrolled widget. The scrollbar must be managed by either pack or grid, other geometry managers are not supported.

When managed by pack, any geometry changes made in the scrollbars parent between the time a scrollbar is unmapped, and when it is mapped will be lost. It is an error to destroy any of the scrollbars siblings while the scrollbar is unmapped. When managed by grid, if anything becomes gridded in the same row and column the scrollbar occupied it will be replaced by the scrollbar when remapped.

This package may be used on any scrollbar-like widget as long as it supports the set subcommand in the same style as scrollbar. If the set subcommand is not used then this package will have no effect.

::autoscroll::autoscroll scrollbar
Arranges for the already existing scrollbar scrollbar to be mapped and unmapped as needed.
::autoscroll::unautoscroll scrollbar
Returns the named scrollbar to its original static state.
::autoscroll::wrap
Arranges for all scrollbars created after this command is run to be automatically mapped and unmapped as needed.
::autoscroll::unwrap
Turns off the automatic autoscrolling of all new scrollbars. Does not effect existing scrollbars

text .t -yscrollcommand ".scrolly set"
scrollbar .scrolly -orient v -command ".t yview"
pack .scrolly -side right -fill y
pack .t -side left -fill both -expand 1
::autoscroll::autoscroll .scrolly

BUGS, IDEAS, FEEDBACK

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category autoscroll of the Tklib Trackers [http://core.tcl.tk/tklib/reportlist]. Please also report any ideas for enhancements you may have for either package and/or documentation.

KEYWORDS

scroll, scrollbar

1.1 tklib