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.