ListShortcut

ListShortcut is a subclass of HyperTreeList, customized to look like the GIMP main shortcut list. This class is used to display the shortcut label (with an optional bitmap next to it), its accelerator and the help string associated with it (if present).

This information is displayed in 3 columns inside ListShortcut.

Inheritance Diagram

Inheritance diagram for: ListShortcut

Known Superclasses

• hypertreelist.HyperTreeList

Methods Summary

__init__	Default class constructor.
AcceptShortcut	Returns True if the input accelerator is a valid shortcut, False otherwise.
BuildImageList	Recursively builds the ListShortcut image list based on the bitmaps in the
CalculateOffset	Calculates an offset (in pixels) so that the Shortcut items without
DisableShortcut	If the user decides to reassign a shortcut to another item, this method will disable
FireShortcutChanged	Fires the EVT_SHORTCUT_CHANGED event for ListShortcut.
FireShortcutChanging	Fires the EVT_SHORTCUT_CHANGING event for ListShortcut.
GetItemIdentity	Return a hashable object that represents the identity of a ListShortcut item.
HasFlag	Overridden from wx.Window as a workaround on the conflicts between treemixin and
MakeImageList	Builds the ListShortcut image list based on the bitmaps in the Shortcut hierarchy.
OnExpandCollapse	Handles the wx.EVT_TREE_ITEM_COLLAPSED / wx.EVT_TREE_ITEM_EXPANDED events for ListShortcut.
OnKillFocus	Handles the wx.EVT_KILL_FOCUS event for ListShortcut.
OnLeftDown	Handles the wx.EVT_LEFT_DOWN event for ListShortcut.
OnSelChanged	Handles the wx.EVT_TREE_SEL_CHANGED event for ListShortcut.
OnShortcut	Handles the wx.EVT_CHAR_HOOK event for ShortcutEditor, implemented in ListShortcut
Populate	Recursively populates the ListShortcut with information from the Shortcut tree.
RecreateTree	Recreates the entire ListShortcut (columns excluded).
SetFilter	Sets the filter string against all the shortcuts in the ListShortcut are matched.
ShowShortcutText	Shows/Hides a wx.TextCtrl used to display the combination of keystrokes the user

Class API

class ListShortcut(HTL.HyperTreeList, treemixin.ExpansionState)

ListShortcut is a subclass of HyperTreeList, customized to look like the GIMP main shortcut list. This class is used to display the shortcut label (with an optional bitmap next to it), its accelerator and the help string associated with it (if present).

This information is displayed in 3 columns inside ListShortcut.

---

__init__(parent)

Default class constructor.

Parameters:parent – an instance of ShortcutEditor.

---

AcceptShortcut(shortcut, accelerator)

Returns True if the input accelerator is a valid shortcut, False otherwise.

Parameters:

• shortcut – an instance of Shortcut;
• accelerator (string) – the new accelerator to check.

Note

Conflicting shortcuts are handled inside this method by presenting the user with a conflict dialog. At this point the user can decide to reassign an existing shortcut or to back away, in which case this method will return False.

---

BuildImageList(shortcut=None, index=None)

Recursively builds the ListShortcut image list based on the bitmaps in the Shortcut hierarchy.

Parameters:

• shortcut – an instance of Shortcut. If None, it is defaulted to self.manager to make this function reentrant (i.e. allow more than one enumeration on one and the same object simultaneously);
• index (integer) – the current image index inside the ListShortcut own wx.ImageList.

---

CalculateOffset()

Calculates an offset (in pixels) so that the Shortcut items without a bitmap look parallel to the ones with a bitmap.

---

DisableShortcut(conflict, item=None)

If the user decides to reassign a shortcut to another item, this method will disable the conflicting shortcut (by putting a “Disabled” string as its accelerator).

Parameters:

• conflict – an instance of Shortcut to reset;
• item – an instance of GenericTreeItem. If defaulted to None, it is set to the ListShortcut root item and used only to make this function reentrant (i.e. allow more than one enumeration on one and the same object simultaneously).

---

FireShortcutChanged(shortcut, newAccel)

Fires the EVT_SHORTCUT_CHANGED event for ListShortcut.

Parameters:

• shortcut – an instance of Shortcut that has been renamed;
• newAccel (string) – the new accelerator just entered by the user.

---

FireShortcutChanging(shortcut, newAccel)

Fires the EVT_SHORTCUT_CHANGING event for ListShortcut.

The event propagation (and thus the shortcut renaming by the user) can be interrupted by not calling event.Skip() in your handler for this event.

Parameters:

• shortcut – an instance of Shortcut that is about to be renamed;
• newAccel (string) – the new accelerator just entered by the user.

---

GetItemIdentity(item)

Return a hashable object that represents the identity of a ListShortcut item.

In this implementation this returns the item label.

Parameters:item – an instance of GenericTreeItem.

---

HasFlag(flag)

Overridden from wx.Window as a workaround on the conflicts between treemixin and HyperTreeList with the wx.TR_HIDE_ROOT agwStyle set.

Parameters:flag (integer) – an integer bit flag specifying the agwStyle style. Returns:True if the ListShortcut has the input flag set, False otherwise.

Note

Overridden from wx.Window.

---

MakeImageList()

Builds the ListShortcut image list based on the bitmaps in the Shortcut hierarchy.

---

OnExpandCollapse(event)

Handles the wx.EVT_TREE_ITEM_COLLAPSED / wx.EVT_TREE_ITEM_EXPANDED events for ListShortcut.

Parameters:event – an instance of wx.TreeEvent.

---

OnKillFocus(event)

Handles the wx.EVT_KILL_FOCUS event for ListShortcut.

Parameters:event – an instance of wx.FocusEvent.

---

OnLeftDown(event)

Handles the wx.EVT_LEFT_DOWN event for ListShortcut.

Parameters:event – an instance of wx.MouseEvent.

---

OnSelChanged(event)

Handles the wx.EVT_TREE_SEL_CHANGED event for ListShortcut.

Parameters:event – an instance of wx.TreeEvent.

---

OnShortcut(event)

Handles the wx.EVT_CHAR_HOOK event for ShortcutEditor, implemented in ListShortcut as it is easier to deal with in this class.

Parameters:event – an instance of wx.KeyEvent.

---

Populate(item=None, shortcut=None)

Recursively populates the ListShortcut with information from the Shortcut tree.

Parameters:

• item – an instance of GenericTreeItem. If None, it is defaulted to the ListShortcut root item to make this function reentrant (i.e. allow more than one enumeration on one and the same object simultaneously);
• shortcut – an instance of Shortcut. If None, it is defaulted to self.manager to make this function reentrant (i.e. allow more than one enumeration on one and the same object simultaneously).

---

RecreateTree()

Recreates the entire ListShortcut (columns excluded).

---

SetFilter(filter=u'')

Sets the filter string against all the shortcuts in the ListShortcut are matched.

Parameters:filter (string) – a string to match.

---

ShowShortcutText(show)

Shows/Hides a wx.TextCtrl used to display the combination of keystrokes the user has entered. This wx.TextCtrl remains visible only for a short amount of time and only when some keys are down.

Parameters:show (bool) – True to show the wx.TextCtrl, False to hide it.

AGW

• advancedsplash
• aquabutton
• artmanager
• aui
• balloontip
• buttonpanel
• cubecolourdialog
• customtreectrl
• flatmenu
• flatnotebook
• floatspin
• fmcustomizedlg
• foldpanelbar
• fourwaysplitter
• genericmessagedialog
• gradientbutton
• hyperlink
• hypertreelist
• infobar
• knobctrl
• labelbook
• multidirdialog
• peakmeter
• persist
• piectrl
• pybusyinfo
• pycollapsiblepane
• pygauge
• pyprogress
• ribbon
• rulerctrl
• shapedbutton
• shortcuteditor
• speedmeter
• supertooltip
• thumbnailctrl
• toasterbox
• ultimatelistctrl
• xlsgrid
• zoombar

Tree