Caution
HaO This Web-Site was restructured and informations are mixed up. It is as it is, sorry.
Summary
BWidget is a high-level widget set for Tcl/Tk using native Tcl 8.x namespaces. Contains over 20 widgets, such as progress bars, main frames, generic scrolled widget, paned windows, button boxes, notebooks, combo boxes, spin boxes, tree widgets, font and color selection widgets, balloon help, and more. Original authors web site no longer available; source has been moved to the Tcllib sf.net CVS repository. Bug reports, mailing lists, etc. are available from that location. The compiler-factory site has a binary version of the extension. Currently at version 1.9.6.
HaO: There are currently two versions of BWidget in the CVS:
- The Tile-enabled version by JOB (work in Progress) in the Trunk (future BWidget 2.0)
- The old version with bug-fixes and very limited Tile support with the sticky tag bwidget. This version is the bases for all realeases to date, includeing the current release, 1.9.6.
A checkout command for the version with the sticky tag bwidget:
cvs -z3 -d:ext:[email protected]:/cvsroot/tcllib checkout -P -r bwidget bwidget
or use the tarball button at the end of his link .
Attributes
- name
- BWidget
- website (obsolete)
- https://sourceforge.net/projects/tcllib/files/BWidget/
- contact (obsolete)
- http://sf.net/bugs/?group_id=12883
Download
Documentation
- official reference
- Also at ActiveState , sourceforge , and freshmeat, which was out-of-date, so aku asked to transfer the freshmeat entry to himself and updated the entry to match the current release.
- MouseWheel TIP #171 interaction with canvas ,comp.lang.tcl ,2012-03-07
- HaO 2011-03-22: a discusstin about mousewheel, with valuable input by Martyn Smith and Koen Dankaert:
Development
Software Using bwidget
Description
BWidget, currently maintained as a part of tcllib, is a Tcl/Tk script-only set of megawidgets designed to provide the developer additional tools.
- BWidget::ComboBox
- some notes and examples
History
2013-09-10: BWidget 1.9.7 released
2013-01-14: migrate repository to Fossil
Thanks to Roy Keene, the repository of the source code moved to https://core.tcl.tk/bwidget/home
2012-07-27: release of BWidget 1.9.6
The 4 bug-fixes of this year are included in this release:
- ListBox selection only redrawn if changed
- Entry configure in themed mode fixed
- error if next widget is a ttk widget and has spaces in the window path
- ListBox documented options -selectfill and -autofocus as read-only
2011-06-27: BWidget 1.9.5 release
- The color picker button is translated, while some languages are still missing.
- ListBox and tree scroll region on Windows 7
- ListBox tags for images were broken (introduced in 1.9.2)
- The widgets LabelEntry, LabelFrame, PagesMgr are now themed (by Wojciech Kocjan).
- The MainFrame widget got a -sizegrip option. - The NoteBook client frame is themed.
2010-12-14: Bwidget 1.9.4 release
Former release has introduced an update bug of multiple nodes in the tree widget, which is fixed here.
MHo 2010-12-16:
- pkgIndex.tcl is wrong, line 4, says 1.9.3 instead of 1.9.4.
HaO sorry, corrected (also on teapot)
- with Widget::theme 1 I get an Error in startup script: unknown option "-highlightthickness" while executing "ttk::label .....
HaO What are you doing exactly ? This is correct, this option does not exist any more in themed mode (RTFM?).
- The download name still says "1.9.2", and only the listbox.tcl seems to be renewed. Is that right?
HaO: The only change between 1.9.3 and 1.9.4 is a listbox bugfix, right.
2010-12-05: release of version 1.9.3
BWidget Classic and Tile/TTK
I am migrating my own applications to ttk now. There is practically no BWidget widget, which is not replaced by a ttk widget. There are mostly details missing which must be added by additional packets like balloon help (tklib) and drag and drop (tkdnd).
I did not use the work of Johann, because tile is emulated by switching colors. This works well on most Unix platforms but does not bring the complete different look of native windows (and MacOS) widgets. We discussed on that and this approach seams not to be possible. Even a simple ttk::frame may contain a structured bitmap surface which may not be emulated by one color.
I updated the classic BWidget (sticky tag "BWidget" in the repository) within this process. There are tile versions of some widgets which mostly do not support as many options as the normal ones. This is for migration purposes. I would not use it for new projects.
To enable themed mode, use:
Widget::theme 1
Here is the state and thoughts about some widgets:
- Label
- migrated, was quite easy, because ttk::label supports many options.
- Button
- migrated
- ScrolledWindow
- migrated (for ttk::scrollbars and the background frame)
- NoteBook
- this is my favorite BWidget widget which features scroll-buttons compared to the ttk widget. It is difficult to make a tile version. It requires an implementation of the ArrowButton first. I thought making a ttk::frame as background widget on the canvas.
- ArrowButton
- Is required for many widgets. Is implemented as canvas and thus difficult to migrate. One may create a gif with the triangle dynamically and put it on a themed button.
- Tree
- this is a widget many people use but not me.
2010-06-18: BWidget 1.9.2
HaO: 2010-06-18 ActiveState has distributed the unreleased BWidget 1.9.1 which contains extended themed support with ActiveTcl 8.4.19.4, 8.5.8.2 and 8.6.0.0b3.
There are some incompatibilities in color selection to former BWidgets. A 1.9.2 release followed which is 1.9.0 with some minor bug fixes. Andreas wrote me, that BWidget 1.9.2 is now installable via Teapot. Anybody experiencing compatibility issues is asked to install this release.
Anybody wanting to use Tile and does not need this compatibility may try to use the 1.9.1 in ActiveState or the current trunk from the Tcllib CVS . This is work in progress.
Mho: With version 1.9.1 in Tile mode I see that buttons disappear after they are initially drawn correctly and later activated. The text of the button remains intact. Maybe I have to change more than just specifying BWidget::use -package ttk...:
Only if the mouse pointer is over the button, the relief and border are visible again, but with a different style... See BWidget with tile for a code fragment.
HaO: Sorry, for sure a bug or an unfinished feature. Eventually JOB may write more.
2009-10-25: JOB: BWidget revitalization
A modified version for the BWidget toolkit to take advantage of ttk is now available in CVS.
The programming interface of BWidget::use has changed:
# BWidget::use
# Argument usage:
# -package ttk
# |
# specify a package name to be initialized, currently
# support for the following packages is implemented:
# ttk ... try to use tile'd widget set (if available)
#
# -style default / native / myFavoriteStyleName
# | | |
# | | specify a valid style name,
# | | use "BWidget::_get_colordcls" which gives
# | | you a list of what's avaliable for tk
# | |
# | if specified, BW tries to emulate OS color scheme,
# | a specific color schema associated to each individual
# | operation system is going to be used
# |
# same behaviour as before, stay compatible
# with previous releases
#
# -setoptdb [no=default|0|yes|1]
# |
# maintain the option database
# if you need a dynamic behavior when changing
# the underlying style, activate this option!
#
# -themedirs {} = default / a list of valid directory names,
# to specifying additional ttk theme packagesWith the modified package (available in CVS) I could get a reasonable good result e.g. for ased3.0b16.vfs by just adding this to the existing code (and copying the requ. theme package to ased.../lib , beside this with no other change!):
package require BWidget BWidget::use \ -package ttk -style winxpblue -setoptdb 1
The result looks like:
Comments are welcome!
2009-07-24
HaO: Bugfix release in 2009-07-24
2006-10-11: release of BWidget 1.8 (according to jt
See Also
Misc
TWidgetsLV 2008-03-25: So, has BWidget been enhanced to take advantage of Ttk when available? Has there really not been a BWidget release since 2006?
JOB is currently working on a ttk-enabled version.
Has anyone converted the BWidget html reference pages into either doctools or nroff -man formats?
HaO: AFAIK - nobody, sorry.
MHo: The BWidget demo coming with ActiveState 8.4.19.4 does not work anymore.
HaO: Does it work with BWidget 1.9.2 for you ?
CLT: Use BWidget for new projects
HaO 2011-08-23: clt contribution by Kevin Walzer on Use BWidget for new projects:
> As I stated on wiki.tcl.tk/bwidget , I would not recomment using > BWidget for new projects if you target ttk (what you should IMHO).
I'd disagree with this. BWidget is still quite useful in certain contexts. Its tree widget is more configurable than the ttk treeview, and the listbox is also more flexible, and yet it is simpler to program against than tktreectrl. Its notebook widget also offers more flexibility than the ttk notebook.
I think the best strategy to use with BWidget is as a supplement--a very powerful one--to the core and ttk widgets. Perhaps you wouldn't want to do an entire project in BWidget, but I find it indispensible and I am grateful that Harald continues to maintain it. That's why I've also contributed some patches to the project and helped test Harald's updates on the Mac.
In case you're curious how I use it, take a look at this screenshot:
http://www.codebykevin.com/packetstream-running.png
The tree widget on the left, styled to emulate a Mac "source list" widget, is a BWidget tree. Doesn't look like the standard BWidget tree in the demos with the Windows-2000-era appearance, but that's the point--these changes are trivial to make. Doing this in tktreectrl would give me a migraine, and I'm not aware that the ttk treeview can be configured to this extent.