fsleyes_widgets.texttag

This module provides two classes:

StaticTextTag The StaticTextTag class is a wx.Panel which contains a StaticText control, and a close button.
TextTagPanel The TextTagPanel is a panel which contains a control allowing the user to add new tags, and a collection of StaticTextTag controls.
_images/texttagpanel.png
class fsleyes_widgets.texttag.StaticTextTag(parent, text=None, bgColour='#aaaaaa', borderColour='#ffcdcd')

Bases: wx._core.Panel

The StaticTextTag class is a wx.Panel which contains a StaticText control, and a close button. The displayed text and background colour are configurable.

When the close button is pushed, an EVT_STT_CLOSE is generated.

Create a StaticTextTag.

Parameters:
  • parent – The wx parent object.
  • text – Initial text to display.
  • bgColour – Initial background colour.
  • borderColour – Initial border colour.
__init__(parent, text=None, bgColour='#aaaaaa', borderColour='#ffcdcd')

Create a StaticTextTag.

Parameters:
  • parent – The wx parent object.
  • text – Initial text to display.
  • bgColour – Initial background colour.
  • borderColour – Initial border colour.
__str__()

Returns a string representation of this StaticTextTag.

closeButton

Returns a reference to the StaticText control used as the close button.

text

Returns a reference to the StaticText control used for displaying the tag text.

SetBackgroundColour(colour)

Sets the background colour of this StaticTextTag.

SetBorderColour(colour)

Sets the border colour of this StaticTextTag, for when it has focus.

SetText(text)

Sets the text shown on this StaticTextTag.

GetText()

Returns the text shown on this StaticTextTag.

_StaticTextTag__onCloseButton(ev)

Called when the close button is pushed. Generates an EVT_STT_CLOSE.

_StaticTextTag__onKillFocus(ev)

Called when this StaticTextTag loses focus. Clears the border colour.

_StaticTextTag__onSetFocus(ev)

Called when this StaticTextTag gains focus. Changes the border colour.

__module__ = 'fsleyes_widgets.texttag'
fsleyes_widgets.texttag.EVT_STT_CLOSE = <wx.core.PyEventBinder object>

Identifier for the event generated by a StaticTextTag when its close button is pushed.

fsleyes_widgets.texttag.StaticTextTagCloseEvent

alias of wx.lib.newevent.NewEvent.<locals>._Event

class fsleyes_widgets.texttag.TextTagPanel(parent, style=None)

Bases: wx._core.Panel

The TextTagPanel is a panel which contains a control allowing the user to add new tags, and a collection of StaticTextTag controls.

The TextTagPanel supports the following styles:

TTP_ALLOW_NEW_TAGS Style flag for use with a TextTagPanel - if set, the user is able to type in tag names that are not known by the AutoTextCtrl.
TTP_ADD_NEW_TAGS Style flag for use with a TextTagPanel - if set, when the user types in a tag name that is not known by the AutoTextCtrl, that name is added to its list of options.
TTP_NO_DUPLICATES Style flag for use with a TextTagPanel - if set, the user will be prevented from adding the same tag more than once.
TTP_CASE_SENSITIVE Style flag for use with a TextTagPanel - if set, the auto-completion options will be case sensitive.
TTP_KEYBOARD_NAV Style flag for use with a TextTagPanel - if set, the user can use the left and right arrow keys to move between the new tag control and the tags and, when a tag is focused can use the delete/backspace keys to remove it.

The TextTagPanel generates the following events:

EVT_TTP_TAG_REMOVED Identifier for the event generated when a tag is removed from a TextTagPanel.
EVT_TTP_TAG_ADDED Identifier for the event generated when a tag is added to a TextTagPanel.
EVT_TTP_TAG_SELECT Identifier for the event generated when a tag is selected in a TextTagPanel.

Create a TextTagPanel.

Parameters:
  • parent – The wx parent object.
  • style – Style flags. Defaults to TTP_ALLOW_NEW_TAGS | TTP_ADD_NEW_TAGS.
__init__(parent, style=None)

Create a TextTagPanel.

Parameters:
  • parent – The wx parent object.
  • style – Style flags. Defaults to TTP_ALLOW_NEW_TAGS | TTP_ADD_NEW_TAGS.
newTagCtrl

Returns a reference to the AutoTextCtrl.

tags

Returns a list containing all StaticTextTag widgets.

FocusNewTagCtrl()

Gives focus to the new tag control (an AutoTextCtrl).

SelectTag(tag)

Gives focus to the StaticTextTag control with the specified tag, if it exists.

SetOptions(options, colours=None)

Sets the tag options made available to the user via the AutoTextCtrl.

Parameters:
  • options – A sequence of tags that the user can choose from.
  • colours – A sequence of corresponding colours for each tag.
GetOptions()

Returns a list of all the tags that are currently available to the user.

AddTag(tag, colour=None)

Add a new StaticTextTag to this TextTagPanel.

Parameters:
  • tag – The tag text.
  • colour – The tag background colour.
RemoveTag(tag)

Removes the specified tag.

GetTags()

Returns a list containing all active tags in this TextTagPanel.

ClearTags()

Removes all tags from this TextTagPanel.

GetTagIndex(tag)

Returns the index of the specified tag.

TagCount()

Returns the number of tags currently visible.

HasTag(tag)

Returns True if the given tag is currently shown, False otherwise.

GetTagColour(tag)

Returns the background colour of the specified tag, or None if there is no default colour for the tag.

SetTagColour(tag, colour)

Sets the background colour on all StaticTextTag items which have the given tag text.

_TextTagPanel__onNewTagKeyDown(ev)

Called on key down events from the new tag control (if the TTP_KEYBOARD_NAV style is set). If the right arrow key is pushed, the first StaticTextTag is given input focus.

_TextTagPanel__onTagClose(ev)

Called when the user pushes the close button on a StaticTextTag. Removes the tag, and generates a EVT_TTP_TAG_REMOVED event.

_TextTagPanel__onTagKeyDown(ev)

Called on key down events from a StaticTextTag object. If the left/right arrow keys are pushed, the focus is shifted accordingly.

_TextTagPanel__onTagLeftDown(ev)

Called on left mouse down events on StaticTextTag objects (only if the TTP_KEYBOARD_NAV style is set). Gives the tag focus.

_TextTagPanel__onTextCtrl(ev)

Called when the user enters a new value via the TextCtrl (if this TextTagPanel allows new tags). Adds the new tag, and generates an EVT_TTP_TAG_ADDED event.

_TextTagPanel__selectTag(stt)

Called by event handlers which listen for mouse/keyboard activity on StaticTextTag widgets. Focuses the given StaticTextTag, and generates an EVT_TTP_TAG_SELECT event.

_TextTagPanel__updateNewTagOptions()

Updates the options shown on the new tag control.

__module__ = 'fsleyes_widgets.texttag'
fsleyes_widgets.texttag.TTP_ALLOW_NEW_TAGS = 1

Style flag for use with a TextTagPanel - if set, the user is able to type in tag names that are not known by the AutoTextCtrl.

fsleyes_widgets.texttag.TTP_ADD_NEW_TAGS = 2

Style flag for use with a TextTagPanel - if set, when the user types in a tag name that is not known by the AutoTextCtrl, that name is added to its list of options. This flag only has an effect if the TTP_ALLOW_NEW_TAGS flag is also set.

fsleyes_widgets.texttag.TTP_NO_DUPLICATES = 4

Style flag for use with a TextTagPanel - if set, the user will be prevented from adding the same tag more than once.

fsleyes_widgets.texttag.TTP_CASE_SENSITIVE = 8

Style flag for use with a TextTagPanel - if set, the auto-completion options will be case sensitive. This flag only has an effect if the TTP_ALLOW_NEW_TAGS flag is also set.

fsleyes_widgets.texttag.TTP_KEYBOARD_NAV = 16

Style flag for use with a TextTagPanel - if set, the user can use the left and right arrow keys to move between the new tag control and the tags and, when a tag is focused can use the delete/backspace keys to remove it.

fsleyes_widgets.texttag.EVT_TTP_TAG_ADDED = <wx.core.PyEventBinder object>

Identifier for the event generated when a tag is added to a TextTagPanel.

fsleyes_widgets.texttag.TextTagPanelTagAddedEvent

alias of wx.lib.newevent.NewEvent.<locals>._Event

fsleyes_widgets.texttag.EVT_TTP_TAG_REMOVED = <wx.core.PyEventBinder object>

Identifier for the event generated when a tag is removed from a TextTagPanel.

fsleyes_widgets.texttag.TextTagPanelTagRemovedEvent

alias of wx.lib.newevent.NewEvent.<locals>._Event

fsleyes_widgets.texttag.EVT_TTP_TAG_SELECT = <wx.core.PyEventBinder object>

Identifier for the event generated when a tag is selected in a TextTagPanel.

fsleyes_widgets.texttag.TextTagPanelTagSelectEvent

alias of wx.lib.newevent.NewEvent.<locals>._Event