42

        """

    43

        Constructor

    44

        @param parent: Parent wx.Window of dialog for modal

    45

        @param controller: Reference to project controller

    46

        @param tagname: Tagname of project POU edited

    47

        @param size: wx.Size object containing size of dialog

    48

        @param title: Title of dialog frame

    49

        """

    52

        # Save reference to

    56

        # Label for preview

    59

        # Create Preview panel

    62

    63

        # Add function to preview panel so that it answers to graphic elements

    64

        # like Viewer

    69

    70

        # Bind paint event on Preview panel

    73

        # Add default dialog buttons sizer

    78

        self.Block = None            # Graphic element to display in preview

    79

        self.MinBlockSize = None     # Graphic element minimal size

    80

        self.DefaultBlockName = None # Graphic element name when opening dialog

    81

    83

        """

    84

        Destructor

    85

        """

    86

        # Remove reference to project controller

    90

        """

    91

        Define minimal graphic element size

    92

        @param size: wx.Size object containing minimal size

    93

        """

    97

        """

    98

        Set font of Preview panel

    99

        @param font: wx.Font object containing font style

   100

        """

   104

        """

   105

        Text displayed graphic element name

   106

        @param block_name: Graphic element name

   107

        """

   108

        # Variable containing error message format

   109

        message_format = None

   110

        # Get graphic element name in upper case

   112

   113

        # Test if graphic element name is a valid identifier

   115

            message_format = _("\"%s\" is not a valid identifier!")

   116

   117

        # Test that graphic element name isn't a keyword

   119

            message_format = _("\"%s\" is a keyword. It can't be used!")

   120

   121

        # Test that graphic element name isn't a POU name

   123

            message_format = _("\"%s\" pou already exists!")

   124

   125

        # Test that graphic element name isn't already used in POU by a variable

   126

        # or another graphic element

   131

            message_format = _("\"%s\" element for this pou already exists!")

   132

   133

        # If an error have been identify, show error message dialog

   134

        if message_format is not None:

   135

            self.ShowErrorMessage(message_format % block_name)

   136

            # Test failed

   139

        # Test succeed

   143

        """

   144

        Show an error message dialog over this dialog

   145

        @param message: Error message to display

   146

        """

   154

        """

   155

        Called when dialog OK button is pressed

   156

        Need to be overridden by inherited classes to check that dialog values

   157

        are valid

   158

        @param event: wx.Event from OK button

   159

        """

   160

        # Close dialog

   164

        """

   165

        Refresh preview panel of graphic element

   166

        May be overridden by inherited classes

   167

        """

   168

        # Init preview panel paint device context

   173

        # Return immediately if no graphic element defined

   174

        if self.Block is None:

   175

            return

   176

   177

        # Calculate block size according to graphic element min size due to its

   178

        # parameters and graphic element min size defined

   179

        min_width, min_height = self.Block.GetMinSize()

   180

        width = max(self.MinBlockSize[0], min_width)

   181

        height = max(self.MinBlockSize[1], min_height)

   182

        self.Block.SetSize(width, height)

   183

   184

        # Get Preview panel size

   185

        client_size = self.Preview.GetClientSize()

   186

   187

        # If graphic element is too big to be displayed in preview panel,

   188

        # calculate preview panel scale so that graphic element fit inside

   189

        scale = (max(float(width) / client_size.width, 

   190

                     float(height) / client_size.height) * 1.2

   191

                 if width * 1.2 > client_size.width or 

   192

                    height * 1.2 > client_size.height

   193

                 else 1.0)

   194

        dc.SetUserScale(1.0 / scale, 1.0 / scale)

   195

   196

        # Center graphic element in preview panel

   197

        x = int(client_size.width * scale - width) / 2

   198

        y = int(client_size.height * scale - height) / 2

   199

        self.Block.SetPosition(x, y)

   200

   201

        # Draw graphic element

   202

        self.Block.Draw(dc)

   205

        """

   206

        Called when Preview panel need to be redraw

   207

        @param event: wx.PaintEvent

   208

        """