Version 21 of Scrollutil

Updated 2021-04-14 11:31:27 by CsabaNemethi

Scrollutil , by Csaba Nemethi, is a scrolling utilities package for Tk 8.0 or higher, written in pure Tcl code.

Attributes

name
Scrollutil
location
https://www.nemethi.de
latest release
1.9
release time
2021-04
contact
Csaba Nemethi

Description

The Scrollutil package contains:

  • the implementation of the scrollarea, scrollsync, scrollableframe, and scrollednotebook mega-widgets, including a general utility module for mega-widgets;
  • the command scrollutil::addMouseWheelSupport, which creates mouse wheel event bindings for a given binding tag;
  • commands for user-friendly mouse wheel event handling in scrollable widget containers like scrollutil::scrollableframe, BWidget ScrollableFrame, and iwidgets::scrolledframe;
  • demo scripts illustrating the use of the Scrollutil package in connection with various scrollable widgets and the above-mentioned scrollable widget containers;
  • a programmer's guide and reference pages in HTML format.

The scrollutil::scrollarea mega-widget greatly simplifies the creation of arbitrary scrolled widgets. It consists of a scrollable widget and two scrollbars connected with that widget. The display mode of each scrollbar can be static, dynamic, or none.

The scrollutil::scrollsync mega-widget is designed for scrolling several widgets simultaneously. It is horizontally and vertically scrollable, hence it can be embedded into a scrollutil::scrollarea widget via the latter's setwidget subcommand.

The scrollutil::scrollableframe mega-widget is a lightweight, theme-able, and full-featured replacement for BWidget ScrollableFrame and iwidgets::scrolledframe. Arbitrary regions of its content frame can be brought into view by scrolling, and the widget also provides a see subcommand for making individual widgets contained in the content frame visible in the scrollableframe window.

The scrollutil::scrollednotebook mega-widget is based on a ttk::notebook within a scrollableframe and supports an arbitrary number of unsqueezed tabs. It also implements the navigation between the tabs of a ttk::notebook or scrollednotebook widget via the mouse wheel, as well as the support for moving the tabs with the mouse.

The commands for mouse wheel event handling in scrollable widget containers make sure that the mouse wheel events will only scroll the widget under the pointer if it has the focus, otherwise they will scroll the widget container that is an ancestor of the widget in question and is contained in the latter's toplevel.


Jeff Smith 2021-02-04 : Below is an online demo using CloudTk. This demo runs Scrollutil in an Alpine Linux Docker Container. It is a 28.3MB image which is made up of Alpine Linux + tclkit + Scrollutil1.8.kit + libx11 + libxft + fontconfig + ttf-linux-libertine. It is run under a user account in the Container. The Container is restrictive with permissions for "Other" removed for "execute" and "read" for certain directories.

By clicking on the "V" in the upper left corner you can access other demos.

Csaba Nemethi 2020-01-15 : The Scrollutil version installed on the CloudTk server is now 1.4 (many thanks to Jeff for the upgrade). This version creates mouse wheel event bindings for the ttk::scrollbar widget, which (as of Tk 8.6.10) are missing in the Tk core. The demo script applies the command scrollutil::addMouseWheelSupport to the text widget, thus making sure that the mouse wheel scrolls the text by lines rather than pixels. Last but not least, the scan support (added to the scrollutil::scrollableframe widget in Scrollutil 1.3) enables you to drag the content of the scrollableframe at high speed with the aid of mouse button 1.

Jeff Smith 2021-02-04 : The Scrollutil version installed on the CloudTk server is now 1.8.