wx.lib.agw

This is the Advanced Generic Widgets package (AGW). It provides many custom-drawn wxPython controls: some of them can be used as a replacement of the platform native controls, others are simply an addition to the already rich wxPython widgets set.

Description:

AGW contains many different modules, listed below. Items labelled with an asterisk were already present in lib before:

• AdvancedSplash: reproduces the behaviour of SplashScreen, with more advanced features like custom shapes and text animations;

• AquaButton: this is another custom-drawn button class which approximately mimics the behaviour of Aqua buttons on the Mac;

• AUI: a pure-Python implementation of aui, with many bug fixes and new features like HUD docking and AuiNotebook tab arts;

• BalloonTip: allows you to display tooltips in a balloon style window (actually a frame), similarly to the Windows XP balloon help;

• ButtonPanel (*): a panel with gradient background shading with the possibility to add buttons and controls still respecting the gradient background;

• CubeColourDialog: an alternative implementation of wx.ColourDialog, it offers different functionalities like colour wheel and RGB cube;

• CustomTreeCtrl (*): mimics the behaviour of TreeCtrl, with almost the same base functionalities plus a bunch of enhancements and goodies;

• FlatMenu: as the name implies, it is a generic menu implementation, offering the same wx.MenuBar / wx.Menu / ToolBar capabilities and much more;

• FlatNotebook (*): a full implementation of the Notebook, and designed to be a drop-in replacement for Notebook with enhanced capabilities;

• FloatSpin: this class implements a floating point spinctrl, cabable (in theory) of handling infinite-precision floating point numbers;

• FoldPanelBar (*): a control that contains multiple panels that can be expanded or collapsed a la Windows Explorer/Outlook command bars;

• FourWaySplitter: this is a layout manager which manages four children like four panes in a window, similar to many CAD software interfaces;

• GenericMessageDialog: it is a possible replacement for the standard MessageDialog, with a fancier look and extended functionalities;

• GradientButton: another custom-drawn button class which mimics Windows CE mobile gradient buttons, using a tri-vertex blended gradient background;

• HyperLinkCtrl (*): this widget acts line an hyper link in a typical browser;

• HyperTreeList: a class that mimics the behaviour of wx.adv.TreeListCtrl, with almost the same base functionalities plus some more enhancements;

• InfoBar: a transient window shown at top or bottom of its parent window to display non-critical information to the user;

• KnobCtrl: a widget which lets the user select a numerical value by rotating it, like a slider with a wheel shape;

• LabelBook and FlatImageBook: these are a quasi-full implementations of Listbook, with additional features;

• MultiDirDialog: it represents a possible replacement for DirDialog, with the additional ability of selecting multiple folders at once and a fancier look;

• PeakMeter: this widget mimics the behaviour of LED equalizers that are usually found in stereos and MP3 players;

• PersistentControls: widgets which automatically save their state when they are destroyed and restore it when they are recreated, even during another program invocation;

• PieCtrl and ProgressPie: these are simple classes that reproduce the behavior of a pie chart, in a static or progress-gauge-like way;

• PyBusyInfo: constructs a busy info window and displays a message in it: it is similar to BusyInfo;

• PyCollapsiblePane: a pure Python implementation of the original wxWidgets C++ code of CollapsiblePane, with customizable buttons;

• PyGauge: a generic Gauge implementation, it supports the determinate mode functions as Gauge;

• PyProgress: it is similar to ProgressDialog in indeterminated mode, but with a different gauge appearance and a different spinning behavior;

• RibbonBar: the RibbonBar library is a set of classes for writing a ribbon user interface, similar to the user interface present in recent versions of Microsoft Office;

• RulerCtrl: it implements a ruler window that can be placed on top, bottom, left or right to any wxPython widget. It is somewhat similar to the rulers you can find in text editors software;

• ShapedButton: this class tries to fill the lack of “custom shaped” controls in wxPython. It can be used to build round buttons or elliptic buttons;

• ShortcutEditor: a widget that allows the user to customize and change keyboard shortcuts via a dialog;

• SpeedMeter: this widget tries to reproduce the behavior of some car controls (but not only), by creating an “angular” control;

• SuperToolTip: a class that mimics the behaviour of TipWindow and generic tooltips, with many features and highly customizable;

• ThumbnailCtrl: a widget that can be used to display a series of images in a “thumbnail” format; it mimics, for example, the Windows Explorer behavior when you select the “view thumbnails” option;

• ToasterBox: a cross-platform widget to make the creation of MSN-style “toaster” popups easier;

• UltimateListCtrl: mimics the behaviour of ListCtrl, with almost the same base functionalities plus some more enhancements;

• XLSGrid: a class based on grid.Grid that can be used to faithfully reproduce the appearance of a Microsoft Excel spreadsheets;

• ZoomBar: a class that appoximatively mimics the behaviour of the Mac Dock, inside a Panel.

Bugs and Limitations: many, patches and fixes welcome :-D

See the demos for an example of what AGW can do, and on how to use it.

Copyright: Andrea Gavana

License: Same as the version of wxPython you are using it with.

SVN for latest code: http://svn.wxwidgets.org/viewvc/wx/wxPython/3rdParty/AGW/

Mailing List: wxpython-users@lists.wxwidgets.org

My personal web page: http://xoomer.alice.it/infinity77

Please let me know if you are using AGW!

You can contact me at:

andrea.gavana@gmail.com andrea.gavana@maerskoil.com

AGW version: 0.9.7

Last updated: 09 January 2014, 23.00 GMT

Packages Summary

aui	AUI is an Advanced User Interface library that aims to implement “cutting-edge”
persist	Persistent objects are simply the objects which automatically save their state
ribbon	The RibbonBar library is a set of classes for writing a ribbon user interface.

Modules Summary

advancedsplash	AdvancedSplash tries to reproduce the behavior of SplashScreen, with
aquabutton	AquaButton is another custom-drawn button class which approximately mimics
artmanager	This module contains drawing routines and customizations for the AGW widgets
balloontip	BalloonTip is a class that allows you to display tooltips in a balloon style
buttonpanel	A custom panel class with gradient background shading with the possibility to
cubecolourdialog	CubeColourDialog is an alternative implementation of wx.ColourDialog.
customtreectrl	The customtreectrl module contains the CustomTreeCtrl class
flatmenu	FlatMenu is a generic menu implementation.
flatnotebook	FlatNotebook is a full, generic and owner-drawn implementation of Notebook.
floatspin	FloatSpin implements a floating point SpinCtrl.
fmcustomizedlg	This module contains a custom dialog class used to personalize the appearance of a
fmresources
foldpanelbar	FoldPanelBar is a control that contains multiple panels, which can be expanded
fourwaysplitter	FourWaySplitter is a layout manager which manages 4 children like 4 panes in a
genericmessagedialog	This class is a possible, fancy replacement for MessageDialog.
gradientbutton	GradientButton is another custom-drawn button class which mimics Windows CE mobile
hyperlink	HyperLinkCtrl is a control for wxPython that acts like a hyper link
hypertreelist	The hypertreelist module contains the HyperTreeList class
infobar	An info bar is a transient window shown at top or bottom of its parent window to display
knobctrl	KnobCtrl lets the user select a numerical value by rotating it.
labelbook	LabelBook and FlatImageBook are a quasi-full generic and owner-drawn
multidirdialog	This class represents a possible replacement for DirDialog, with the additional
peakmeter	PeakMeterCtrl mimics the behaviour of equalizers that are usually found in stereos
piectrl	PieCtrl and ProgressPie are simple classes that reproduce the behavior of a pie
pybusyinfo	PyBusyInfo constructs a busy info window and displays a message in it.
pycollapsiblepane	PyCollapsiblePane is a container with an embedded button-like control which
pygauge	PyGauge is a generic Gauge implementation.
pyprogress	PyProgress is similar to ProgressDialog in indeterminated mode, but with a
rulerctrl	RulerCtrl implements a ruler window that can be placed on top, bottom, left or right
scrolledthumbnail	ScrolledThumbnail is a widget that can be used to display a series of
shapedbutton	SButton tries to fill the lack of “custom shaped” controls in wxPython
shortcuteditor	ShortcutEditor is a widget that allows the user to customize and change keyboard
speedmeter	SpeedMeter tries to reproduce the behavior of some car controls (but not only),
supertooltip	SuperToolTip is a class that mimics the behaviour of TipWindow and generic tooltip
thumbnailctrl	ThumbnailCtrl is a widget that can be used to display a series of images in
toasterbox	ToasterBox is a cross-platform widget to make the creation of MSN style “toaster”
ultimatelistctrl	Description
xlsgrid	XLSGrid is a class based on grid.Grid that can be used to faithfully
zoombar	ZoomBar is a class that appoximatively mimics the behaviour of the Mac Dock,