Package nMOLDYN :: Package GUI :: Module SelectionDialog :: Class SelectionDialog
[hide private]
[frames] | no frames]

Class SelectionDialog

source code

  Tkinter.Misc --+        
                 |        
Tkinter.BaseWidget --+    
                     |    
        Tkinter.Wm --+    
                     |    
      Tkinter.Toplevel --+
                         |
                        SelectionDialog

Sets up a dialog from which the user can perform an atom selection.

Nested Classes [hide private]

Inherited from Tkinter.Misc: getdouble, getint

Instance Methods [hide private]
 
__init__(self, parent, selectionType, univContents)
The constructor.
source code
 
body(self, master)
Create dialog body.
source code
 
buttonbox(self)
Add standard button box.
source code
 
ok(self, event=None)
This method is called when the user clicks on the 'OK' button of the selection editor dialog.
source code
 
cancel(self, event=None)
Cancel the selection setting up the selection string to a selection type-dependant value.
source code
 
validate(self) source code
 
apply(self)
Performs a last checking of the selection string before closing the selection dialog.
source code
 
getValue(self)
This method returns the self.selectionString class attributes.
source code
 
setDefaultSelectionString(self)
Sets the selection string to its default value.
source code
 
changeSelectionMedia(self)
Changes the 'media' from which the selection will be performed.
source code
 
clear(self)
This methods clears all the listboxes of the 'Selection from the loaded trajectory' browser.
source code
 
buildSelectionString(self)
This method actually build the selection string out of the |self.selection| dictionnary.
source code
 
displaySelectionString(self)
Displays in the 'Selection preview' textwidget the selection string under process.
source code
 
selectFromExpression(self, event)
This callback performs a selection from a expression string by writing the expression in its corresponding text widget.
source code
 
selectFromFile(self, event=None)
This method/callback performs a selection from a file by selection the file from a browser.
source code
 
selectPrefixName(self, event)
This callback is called when the user clicks on one item of the 'Group number' listbox of the selection editor.
source code
 
deletePrefixName(self, event)
This callback will remove the selection string associated to the selected prefix name.
source code
 
createNewGroup(self)
This callback will create a new group entry in the 'Group number' listbox.
source code
 
selectObjectName(self, event)
This callback is called when the user clicks on one item of the 'Object name' listbox of the selection editor.
source code
 
selectGroupingLevel(self, event) source code
 
selectKeyword(self, event)
This callback is called whenever the user clicks on one item of the 'Selection keyword' listbox.
source code
 
deleteObjectName(self, event)
This method will delete the object name from the selection string if it was previously selected.
source code
 
selectValue(self, event)
This callback is called whenever the user clicks on one entry of the 'Selection value' listbox.
source code
 
appendLinker(self, linker)
This method is called when the user press the '(', ')', 'AND' or 'OR' buttons of the atom selection dialog.
source code

Inherited from Tkinter.BaseWidget: destroy

Inherited from Tkinter.BaseWidget (private): _do, _setup

Inherited from Tkinter.Misc: __getitem__, __setitem__, __str__, after, after_cancel, after_idle, bbox, bell, bind, bind_all, bind_class, bindtags, cget, clipboard_append, clipboard_clear, clipboard_get, colormodel, columnconfigure, config, configure, deletecommand, event_add, event_delete, event_generate, event_info, focus, focus_displayof, focus_force, focus_get, focus_lastfor, focus_set, getboolean, getvar, grab_current, grab_release, grab_set, grab_set_global, grab_status, grid_bbox, grid_columnconfigure, grid_location, grid_propagate, grid_rowconfigure, grid_size, grid_slaves, image_names, image_types, keys, lift, lower, mainloop, nametowidget, option_add, option_clear, option_get, option_readfile, pack_propagate, pack_slaves, place_slaves, propagate, quit, register, rowconfigure, selection_clear, selection_get, selection_handle, selection_own, selection_own_get, send, setvar, size, slaves, tk_bisque, tk_focusFollowsMouse, tk_focusNext, tk_focusPrev, tk_menuBar, tk_setPalette, tk_strictMotif, tkraise, unbind, unbind_all, unbind_class, update, update_idletasks, wait_variable, wait_visibility, wait_window, waitvar, winfo_atom, winfo_atomname, winfo_cells, winfo_children, winfo_class, winfo_colormapfull, winfo_containing, winfo_depth, winfo_exists, winfo_fpixels, winfo_geometry, winfo_height, winfo_id, winfo_interps, winfo_ismapped, winfo_manager, winfo_name, winfo_parent, winfo_pathname, winfo_pixels, winfo_pointerx, winfo_pointerxy, winfo_pointery, winfo_reqheight, winfo_reqwidth, winfo_rgb, winfo_rootx, winfo_rooty, winfo_screen, winfo_screencells, winfo_screendepth, winfo_screenheight, winfo_screenmmheight, winfo_screenmmwidth, winfo_screenvisual, winfo_screenwidth, winfo_server, winfo_toplevel, winfo_viewable, winfo_visual, winfo_visualid, winfo_visualsavailable, winfo_vrootheight, winfo_vrootwidth, winfo_vrootx, winfo_vrooty, winfo_width, winfo_x, winfo_y

Inherited from Tkinter.Misc (private): _bind, _configure, _displayof, _getboolean, _getdoubles, _getints, _grid_configure, _nametowidget, _options, _register, _report_exception, _root, _substitute

Inherited from Tkinter.Wm: aspect, attributes, client, colormapwindows, command, deiconify, focusmodel, frame, geometry, grid, group, iconbitmap, iconify, iconmask, iconname, iconposition, iconwindow, maxsize, minsize, overrideredirect, positionfrom, protocol, resizable, sizefrom, state, title, transient, withdraw, wm_aspect, wm_attributes, wm_client, wm_colormapwindows, wm_command, wm_deiconify, wm_focusmodel, wm_frame, wm_geometry, wm_grid, wm_group, wm_iconbitmap, wm_iconify, wm_iconmask, wm_iconname, wm_iconposition, wm_iconwindow, wm_maxsize, wm_minsize, wm_overrideredirect, wm_positionfrom, wm_protocol, wm_resizable, wm_sizefrom, wm_state, wm_title, wm_transient, wm_withdraw

Class Variables [hide private]

Inherited from Tkinter.Misc: _noarg_

Inherited from Tkinter.Misc (private): _subst_format, _subst_format_str, _tclCommands

Method Details [hide private]

__init__(self, parent, selectionType, univContents)
(Constructor)

source code 

The constructor.

Parameters:
  • parent - the parent widget.
  • selectionType (string) - a string being one of 'subset', 'deuteration' or 'group' specifying the atom selection type thatwill be performed.
  • univContents (dict) - a dictionnary that contains the universe contents.
Overrides: Tkinter.BaseWidget.__init__

body(self, master)

source code 

Create dialog body. Return widget that should have initial focus.

ok(self, event=None)

source code 

This method is called when the user clicks on the 'OK' button of the selection editor dialog. It closes the selection editor dialog and build the selection string.

getValue(self)

source code 

This method returns the self.selectionString class attributes.

Thanks to this method, the selection dialog can be used like any other ComboWidget for which the getValue allows to fetch their contents.

setDefaultSelectionString(self)

source code 

Sets the selection string to its default value. This value depends on the the selection type.

changeSelectionMedia(self)

source code 

Changes the 'media' from which the selection will be performed.

It can be either from a selection file, either from the loaded trajectory or from an expression string. When changing selection media, the previous selection is cleared.

clear(self)

source code 

This methods clears all the listboxes of the 'Selection from the loaded trajectory' browser. It resets the selection listboxes and their associated variables, it resets the selection string, and updates the 'Selection preview' text widget.

selectFromExpression(self, event)

source code 

This callback performs a selection from a expression string by writing the expression in its corresponding text widget.

The expression must be a set of valid ;-separated python instructions the last one being 'selection = ...' as the selection string parser will search for the selection variables when executing the expression string.

To refer to the universe just use the variable 'self.universe'.

selectObjectName(self, event)

source code 

This callback is called when the user clicks on one item of the 'Object name' listbox of the selection editor. It will display into the 'Selection keyword' listbox all the selection keywords corresponding to the selected object type.

selectKeyword(self, event)

source code 

This callback is called whenever the user clicks on one item of the 'Selection keyword' listbox. It will display in the 'Selection value' listbox the selection values available for the selected keyword.

selectValue(self, event)

source code 

This callback is called whenever the user clicks on one entry of the 'Selection value' listbox. It will update the current selection.

appendLinker(self, linker)

source code 

This method is called when the user press the '(', ')', 'AND' or 'OR' buttons of the atom selection dialog. It:

  • checks whether the selected linker can be actually be appended
  • appends the linker if so.