controls/DebugVariablePanel/DebugVariableTablePanel.py
changeset 1364 e9e17d3b2849
parent 1363 e87e0166d0a7
child 1365 debc97102b23
--- a/controls/DebugVariablePanel/DebugVariableTablePanel.py	Mon Oct 14 10:31:32 2013 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,509 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-#This file is part of PLCOpenEditor, a library implementing an IEC 61131-3 editor
-#based on the plcopen standard. 
-#
-#Copyright (C) 2012: Edouard TISSERANT and Laurent BESSARD
-#
-#See COPYING file for copyrights details.
-#
-#This library is free software; you can redistribute it and/or
-#modify it under the terms of the GNU General Public
-#License as published by the Free Software Foundation; either
-#version 2.1 of the License, or (at your option) any later version.
-#
-#This library is distributed in the hope that it will be useful,
-#but WITHOUT ANY WARRANTY; without even the implied warranty of
-#MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-#General Public License for more details.
-#
-#You should have received a copy of the GNU General Public
-#License along with this library; if not, write to the Free Software
-#Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-
-from types import TupleType
-
-import wx
-import wx.lib.buttons
-
-from editors.DebugViewer import DebugViewer
-from controls import CustomGrid, CustomTable
-from dialogs.ForceVariableDialog import ForceVariableDialog
-from util.BitmapLibrary import GetBitmap
-
-from DebugVariableItem import DebugVariableItem
-
-def GetDebugVariablesTableColnames():
-    """
-    Function returning table column header labels
-    @return: List of labels [col_label,...]
-    """
-    _ = lambda x : x
-    return [_("Variable"), _("Value")]
-
-#-------------------------------------------------------------------------------
-#                        Debug Variable Table Panel
-#-------------------------------------------------------------------------------
-
-"""
-Class that implements a custom table storing value to display in Debug Variable
-Table Panel grid
-"""
-
-class DebugVariableTable(CustomTable):
-    
-    def GetValue(self, row, col):
-        if row < self.GetNumberRows():
-            return self.GetValueByName(row, self.GetColLabelValue(col, False))
-        return ""
-    
-    def SetValue(self, row, col, value):
-        if col < len(self.colnames):
-            self.SetValueByName(row, self.GetColLabelValue(col, False), value)
-            
-    def GetValueByName(self, row, colname):
-        if row < self.GetNumberRows():
-            if colname == "Variable":
-                return self.data[row].GetVariable()
-            elif colname == "Value":
-                return self.data[row].GetValue()
-        return ""
-
-    def SetValueByName(self, row, colname, value):
-        if row < self.GetNumberRows():
-            if colname == "Variable":
-                self.data[row].SetVariable(value)
-            elif colname == "Value":
-                self.data[row].SetValue(value)
-    
-    def IsForced(self, row):
-        if row < self.GetNumberRows():
-            return self.data[row].IsForced()
-        return False
-    
-    def _updateColAttrs(self, grid):
-        """
-        wx.grid.Grid -> update the column attributes to add the
-        appropriate renderer given the column name.
-
-        Otherwise default to the default renderer.
-        """
-        
-        for row in range(self.GetNumberRows()):
-            for col in range(self.GetNumberCols()):
-                colname = self.GetColLabelValue(col, False)
-                if colname == "Value":
-                    if self.IsForced(row):
-                        grid.SetCellTextColour(row, col, wx.BLUE)
-                    else:
-                        grid.SetCellTextColour(row, col, wx.BLACK)
-                grid.SetReadOnly(row, col, True)
-            self.ResizeRow(grid, row)
-    
-    def RefreshValues(self, grid):
-        for col in xrange(self.GetNumberCols()):
-            colname = self.GetColLabelValue(col, False)
-            if colname == "Value":
-                for row in xrange(self.GetNumberRows()):
-                    grid.SetCellValue(row, col, str(self.data[row].GetValue()))
-                    if self.IsForced(row):
-                        grid.SetCellTextColour(row, col, wx.BLUE)
-                    else:
-                        grid.SetCellTextColour(row, col, wx.BLACK)
-      
-    def AppendItem(self, item):
-        self.data.append(item)
-    
-    def InsertItem(self, idx, item):
-        self.data.insert(idx, item)
-    
-    def RemoveItem(self, item):
-        self.data.remove(item)
-    
-    def MoveItem(self, idx, new_idx):
-        self.data.insert(new_idx, self.data.pop(idx))
-        
-    def GetItem(self, idx):
-        return self.data[idx]
-
-
-#-------------------------------------------------------------------------------
-#                  Debug Variable Table Panel Drop Target
-#-------------------------------------------------------------------------------
-
-"""
-Class that implements a custom drop target class for Debug Variable Table Panel
-"""
-
-class DebugVariableTableDropTarget(wx.TextDropTarget):
-    
-    def __init__(self, parent):
-        """
-        Constructor
-        @param window: Reference to the Debug Variable Panel
-        """
-        wx.TextDropTarget.__init__(self)
-        self.ParentWindow = parent
-        
-    def __del__(self):
-        """
-        Destructor
-        """
-        # Remove reference to Debug Variable Panel
-        self.ParentWindow = None
-        
-    def OnDropText(self, x, y, data):
-        """
-        Function called when mouse is dragged over Drop Target
-        @param x: X coordinate of mouse pointer
-        @param y: Y coordinate of mouse pointer
-        @param data: Text associated to drag'n drop
-        """
-        message = None
-        
-        # Check that data is valid regarding DebugVariablePanel
-        try:
-            values = eval(data)
-            if not isinstance(values, TupleType):
-                raise ValueError
-        except:
-            message = _("Invalid value \"%s\" for debug variable") % data
-            values = None
-        
-        # Display message if data is invalid
-        if message is not None:
-            wx.CallAfter(self.ShowMessage, message)
-        
-        # Data contain a reference to a variable to debug
-        elif values[1] == "debug":
-            grid = self.ParentWindow.VariablesGrid
-            
-            # Get row where variable was dropped
-            x, y = grid.CalcUnscrolledPosition(x, y)
-            row = grid.YToRow(y - grid.GetColLabelSize())
-            
-            # If no row found add variable at table end
-            if row == wx.NOT_FOUND:
-                row = self.ParentWindow.Table.GetNumberRows()
-            
-            # Add variable to table
-            self.ParentWindow.InsertValue(values[0], row, force=True)
-            
-    def ShowMessage(self, message):
-        """
-        Show error message in Error Dialog
-        @param message: Error message to display
-        """
-        dialog = wx.MessageDialog(self.ParentWindow, 
-                                  message, 
-                                  _("Error"), 
-                                  wx.OK|wx.ICON_ERROR)
-        dialog.ShowModal()
-        dialog.Destroy()
-
-
-#-------------------------------------------------------------------------------
-#                       Debug Variable Table Panel
-#-------------------------------------------------------------------------------
-
-"""
-Class that implements a panel displaying debug variable values in a table
-"""
-
-class DebugVariableTablePanel(wx.Panel, DebugViewer):
-    
-    def __init__(self, parent, producer, window):
-        """
-        Constructor
-        @param parent: Reference to the parent wx.Window
-        @param producer: Object receiving debug value and dispatching them to
-        consumers
-        @param window: Reference to Beremiz frame
-        """
-        wx.Panel.__init__(self, parent, style=wx.SP_3D|wx.TAB_TRAVERSAL)
-        
-        # Save Reference to Beremiz frame
-        self.ParentWindow = window
-        
-        # Variable storing flag indicating that variable displayed in table
-        # received new value and then table need to be refreshed
-        self.HasNewData = False
-        
-        DebugViewer.__init__(self, producer, True)
-        
-        # Construction of window layout by creating controls and sizers
-        
-        main_sizer = wx.FlexGridSizer(cols=1, hgap=0, rows=2, vgap=0)
-        main_sizer.AddGrowableCol(0)
-        main_sizer.AddGrowableRow(1)
-        
-        button_sizer = wx.BoxSizer(wx.HORIZONTAL)
-        main_sizer.AddSizer(button_sizer, border=5, 
-              flag=wx.ALIGN_RIGHT|wx.ALL)
-        
-        # Creation of buttons for navigating in table
-        
-        for name, bitmap, help in [
-                ("DeleteButton", "remove_element", _("Remove debug variable")),
-                ("UpButton", "up", _("Move debug variable up")),
-                ("DownButton", "down", _("Move debug variable down"))]:
-            button = wx.lib.buttons.GenBitmapButton(self, 
-                  bitmap=GetBitmap(bitmap), 
-                  size=wx.Size(28, 28), style=wx.NO_BORDER)
-            button.SetToolTipString(help)
-            setattr(self, name, button)
-            button_sizer.AddWindow(button, border=5, flag=wx.LEFT)
-        
-        # Creation of grid and associated table
-        
-        self.VariablesGrid = CustomGrid(self, 
-                size=wx.Size(-1, 150), style=wx.VSCROLL)
-        # Define grid drop target
-        self.VariablesGrid.SetDropTarget(DebugVariableTableDropTarget(self))
-        self.VariablesGrid.Bind(wx.grid.EVT_GRID_CELL_RIGHT_CLICK, 
-              self.OnVariablesGridCellRightClick)
-        self.VariablesGrid.Bind(wx.grid.EVT_GRID_CELL_LEFT_CLICK, 
-              self.OnVariablesGridCellLeftClick)
-        main_sizer.AddWindow(self.VariablesGrid, flag=wx.GROW)
-    
-        self.Table = DebugVariableTable(self, [], 
-                GetDebugVariablesTableColnames())
-        self.VariablesGrid.SetTable(self.Table)
-        self.VariablesGrid.SetButtons({"Delete": self.DeleteButton,
-                                       "Up": self.UpButton,
-                                       "Down": self.DownButton})
-        
-        # Definition of function associated to navigation buttons
-        
-        def _AddVariable(new_row):
-            return self.VariablesGrid.GetGridCursorRow()
-        setattr(self.VariablesGrid, "_AddRow", _AddVariable)
-    
-        def _DeleteVariable(row):
-            item = self.Table.GetItem(row)
-            self.RemoveDataConsumer(item)
-            self.Table.RemoveItem(item)
-            self.RefreshView()
-        setattr(self.VariablesGrid, "_DeleteRow", _DeleteVariable)
-        
-        def _MoveVariable(row, move):
-            new_row = max(0, min(row + move, self.Table.GetNumberRows() - 1))
-            if new_row != row:
-                self.Table.MoveItem(row, new_row)
-                self.RefreshView()
-            return new_row
-        setattr(self.VariablesGrid, "_MoveRow", _MoveVariable)
-        
-        # Initialization of grid layout
-        
-        self.VariablesGrid.SetRowLabelSize(0)
-        
-        self.GridColSizes = [200, 100]
-        
-        for col in range(self.Table.GetNumberCols()):
-            attr = wx.grid.GridCellAttr()
-            attr.SetAlignment(wx.ALIGN_RIGHT, wx.ALIGN_CENTER)
-            self.VariablesGrid.SetColAttr(col, attr)
-            self.VariablesGrid.SetColSize(col, self.GridColSizes[col])
-        
-        self.Table.ResetView(self.VariablesGrid)
-        self.VariablesGrid.RefreshButtons()
-        
-        self.SetSizer(main_sizer)
-    
-    def RefreshNewData(self, *args, **kwargs):
-        """
-        Called to refresh Table according to values received by variables
-        Can receive any parameters (not used here)
-        """
-        # Refresh 'Value' column of table if new data have been received since
-        # last refresh
-        if self.HasNewData:
-            self.HasNewData = False
-            self.RefreshView(only_values=True)
-        DebugViewer.RefreshNewData(self, *args, **kwargs)
-    
-    def RefreshView(self, only_values=False):
-        """
-        Function refreshing table layout and values
-        @param only_values: True if only 'Value' column need to be updated
-        """
-        # Block refresh until table layout and values are completely updated
-        self.Freeze()
-        
-        # Update only 'value' column from table 
-        if only_values:
-            self.Table.RefreshValues(self.VariablesGrid)
-        
-        # Update complete table layout refreshing table navigation buttons
-        # state according to 
-        else:
-            self.Table.ResetView(self.VariablesGrid)
-            self.VariablesGrid.RefreshButtons()
-        
-        self.Thaw()
-        
-    def ResetView(self):
-        """
-        Function removing all variables denugged from table
-        @param only_values: True if only 'Value' column need to be updated
-        """
-        # Unsubscribe all variables debugged
-        self.UnsubscribeAllDataConsumers()
-        
-        # Clear table content
-        self.Table.Empty()
-        
-        # Update table layout
-        self.Freeze()
-        self.Table.ResetView(self.VariablesGrid)
-        self.VariablesGrid.RefreshButtons()
-        self.Thaw()
-    
-    def SubscribeAllDataConsumers(self):
-        """
-        Function refreshing table layout and values
-        @param only_values: True if only 'Value' column need to be updated
-        """
-        DebugViewer.SubscribeAllDataConsumers(self)
-        
-        # Navigate through variable displayed in table, removing those that
-        # doesn't exist anymore in PLC
-        for item in self.Table.GetData()[:]:
-            iec_path = item.GetVariable()
-            if self.GetDataType(iec_path) is None:
-                self.RemoveDataConsumer(item)
-                self.Table.RemoveItem(idx)
-            else:
-                self.AddDataConsumer(iec_path.upper(), item)
-                item.RefreshVariableType()
-        
-        # Update table layout
-        self.Freeze()
-        self.Table.ResetView(self.VariablesGrid)
-        self.VariablesGrid.RefreshButtons()
-        self.Thaw()
-    
-    def GetForceVariableMenuFunction(self, item):
-        """
-        Function returning callback function for contextual menu 'Force' item
-        @param item: Debug Variable item where contextual menu was opened 
-        @return: Callback function
-        """
-        def ForceVariableFunction(event):
-            # Get variable path and data type
-            iec_path = item.GetVariable()
-            iec_type = self.GetDataType(iec_path)
-            
-            # Return immediately if not data type found
-            if iec_type is None:
-                return
-            
-            # Open dialog for entering value to force variable
-            dialog = ForceVariableDialog(self, iec_type, str(item.GetValue()))
-            
-            # If valid value entered, force variable
-            if dialog.ShowModal() == wx.ID_OK:
-                self.ForceDataValue(iec_path.upper(), dialog.GetValue())
-        
-        return ForceVariableFunction
-
-    def GetReleaseVariableMenuFunction(self, iec_path):
-        """
-        Function returning callback function for contextual menu 'Release' item
-        @param iec_path: Debug Variable path where contextual menu was opened
-        @return: Callback function
-        """
-        def ReleaseVariableFunction(event):
-            # Release variable
-            self.ReleaseDataValue(iec_path)
-        return ReleaseVariableFunction
-    
-    def OnVariablesGridCellLeftClick(self, event):
-        """
-        Called when left mouse button is pressed on a table cell
-        @param event: wx.grid.GridEvent
-        """
-        # Initiate a drag and drop if the cell clicked was in 'Variable' column
-        if self.Table.GetColLabelValue(event.GetCol(), False) == "Variable":
-            item = self.Table.GetItem(event.GetRow())
-            data = wx.TextDataObject(str((item.GetVariable(), "debug")))
-            dragSource = wx.DropSource(self.VariablesGrid)
-            dragSource.SetData(data)
-            dragSource.DoDragDrop()
-        
-        event.Skip()
-    
-    def OnVariablesGridCellRightClick(self, event):
-        """
-        Called when right mouse button is pressed on a table cell
-        @param event: wx.grid.GridEvent
-        """
-        # Open a contextual menu if the cell clicked was in 'Value' column
-        if self.Table.GetColLabelValue(event.GetCol(), False) == "Value":
-            row = event.GetRow()
-            
-            # Get variable path
-            item = self.Table.GetItem(row)
-            iec_path = item.GetVariable().upper()
-            
-            # Create contextual menu
-            menu = wx.Menu(title='')
-            
-            # Add menu items
-            for text, enable, callback in [
-                (_("Force value"), True,
-                 self.GetForceVariableMenuFunction(item)),
-                # Release menu item is enabled only if variable is forced 
-                (_("Release value"), self.Table.IsForced(row),
-                 self.GetReleaseVariableMenuFunction(iec_path))]:
-                
-                new_id = wx.NewId()
-                menu.Append(help='', id=new_id, kind=wx.ITEM_NORMAL, text=text)
-                menu.Enable(new_id, enable)
-                self.Bind(wx.EVT_MENU, callback, id=new_id)
-            
-            # Popup contextual menu
-            self.PopupMenu(menu)
-            
-            menu.Destroy()
-        event.Skip()
-    
-    def InsertValue(self, iec_path, index=None, force=False, graph=False):
-        """
-        Insert a new variable to debug in table
-        @param iec_path: Variable path to debug
-        @param index: Row where insert the variable in table (default None,
-        insert at last position)
-        @param force: Force insertion of variable even if not defined in
-        producer side
-        @param graph: Values must be displayed in graph canvas (Do nothing,
-        here for compatibility with Debug Variable Graphic Panel)
-        """
-        # Return immediately if variable is already debugged
-        for item in self.Table.GetData():
-            if iec_path == item.GetVariable():
-                return
-            
-        # Insert at last position if index not defined
-        if index is None:
-            index = self.Table.GetNumberRows()
-        
-        # Subscribe variable to producer
-        item = DebugVariableItem(self, iec_path)
-        result = self.AddDataConsumer(iec_path.upper(), item)
-        
-        # Insert variable in table if subscription done or insertion forced
-        if result is not None or force:
-            self.Table.InsertItem(index, item)
-            self.RefreshView()
-    
-    def ResetGraphicsValues(self):
-        """
-        Called to reset graphics values when PLC is started
-        (Nothing to do because no graphic values here. Defined for
-        compatibility with Debug Variable Graphic Panel)
-        """
-        pass
-    
\ No newline at end of file