1

#!/usr/bin/env python

     2

# -*- coding: utf-8 -*-

     3

     4

# This file is part of Beremiz, a Integrated Development Environment for

     5

# programming IEC 61131-3 automates supporting plcopen standard and CanFestival.

     6

#

     7

# Copyright (C) 2007: Edouard TISSERANT and Laurent BESSARD

     8

#

     9

# See COPYING file for copyrights details.

    10

#

    11

# This program is free software; you can redistribute it and/or

    12

# modify it under the terms of the GNU General Public License

    13

# as published by the Free Software Foundation; either version 2

    14

# of the License, or (at your option) any later version.

    15

#

    16

# This program is distributed in the hope that it will be useful,

    17

# but WITHOUT ANY WARRANTY; without even the implied warranty of

    18

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    19

# GNU General Public License for more details.

    20

#

    21

# You should have received a copy of the GNU General Public License

    22

# along with this program; if not, write to the Free Software

    23

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

    24

    25

import wx

    26

    27

from controls.CustomStyledTextCtrl import faces

    28

    29

TOOLTIP_MAX_CHARACTERS = 30  # Maximum number of characters by line in ToolTip

    30

TOOLTIP_MAX_LINE = 5         # Maximum number of line in ToolTip

    31

TOOLTIP_WAIT_PERIOD = 0.5    # Wait period before displaying tooltip in second

    32

    33

# -------------------------------------------------------------------------------

    34

#                               Custom ToolTip

    35

# -------------------------------------------------------------------------------

    36

    37

    38

class CustomToolTip(wx.PopupWindow):

    39

    """

    40

    Class that implements a custom tool tip

    41

    """

    42

    43

    def __init__(self, parent, tip, restricted=True):

    44

        """

    45

        Constructor

    46

        @param parent: Parent window

    47

        @param tip: Tip text (may be multiline)

    48

        @param restricted: Tool tip must follow size restriction in line and

    49

            characters number defined (default True)

    50

        """

    51

        wx.PopupWindow.__init__(self, parent)

    52

    53

        self.Restricted = restricted

    54

    55

        self.SetBackgroundStyle(wx.BG_STYLE_CUSTOM)

    56

        self.SetTip(tip)

    57

    58

        # Initialize text font style

    59

        self.Font = wx.Font(

    60

            faces["size"],

    61

            wx.SWISS,

    62

            wx.NORMAL,

    63

            wx.NORMAL,

    64

            faceName=faces["mono"])

    65

    66

        self.Bind(wx.EVT_PAINT, self.OnPaint)

    67

    68

    def SetFont(self, font):

    69

        """

    70

        Set tool tip text font style

    71

        @param font: wx.Font object containing font style

    72

        """

    73

        self.Font = font

    74

        self.RefreshTip()

    75

    76

    def SetTip(self, tip):

    77

        """

    78

        Set tool tip text

    79

        @param tip: Tool tip text

    80

        """

    81

        if self.Restricted:

    82

            # Compute tip text line return

    83

            self.Tip = []

    84

            for line in tip.splitlines():

    85

                if line != "":

    86

                    words = line.split()

    87

                    new_line = words[0]

    88

                    for word in words[1:]:

    89

                        # Add word to line

    90

                        if len(new_line + " " + word) <= TOOLTIP_MAX_CHARACTERS:

    91

                            new_line += " " + word

    92

                        # Create new line

    93

                        else:

    94

                            self.Tip.append(new_line)

    95

                            new_line = word

    96

                    self.Tip.append(new_line)

    97

                else:

    98

                    self.Tip.append(line)

    99

   100

            # Restrict number of lines

   101

            if len(self.Tip) > TOOLTIP_MAX_LINE:

   102

                self.Tip = self.Tip[:TOOLTIP_MAX_LINE]

   103

   104

                # Add ... to the end of last line to indicate that tool tip

   105

                # text is too long

   106

                if len(self.Tip[-1]) < TOOLTIP_MAX_CHARACTERS - 3:

   107

                    self.Tip[-1] += "..."

   108

                else:

   109

                    self.Tip[-1] = self.Tip[-1][:TOOLTIP_MAX_CHARACTERS - 3] + \

   110

                                   "..."

   111

        else:

   112

            self.Tip = tip.splitlines()

   113

   114

        # Prevent to call wx method in non-wx threads

   115

        wx.CallAfter(self.RefreshTip)

   116

   117

    def SetToolTipPosition(self, pos):

   118

        """

   119

        Set tool tip position

   120

        @param pos: New tool tip position

   121

        """

   122

        # Get screen size to prevent tool tip to go out of the screen

   123

        screen_width, screen_height = wx.GetDisplaySize()

   124

   125

        # Calculate position of tool tip to stay in screen limits

   126

        tip_width, tip_height = self.GetToolTipSize()

   127

        self.SetPosition(wx.Point(

   128

            max(0, min(pos.x, screen_width - tip_width)),

   129

            max(0, min(pos.y, screen_height - tip_height))))

   130

   131

    def GetToolTipSize(self):

   132

        """

   133

        Get tool tip size according to tip text and restriction

   134

        @return: wx.Size(tool_tip_width, tool_tip_height)

   135

        """

   136

        max_width = max_height = 0

   137

   138

        # Create a memory DC for calculating text extent

   139

        dc = wx.MemoryDC()

   140

        dc.SetFont(self.Font)

   141

   142

        # Compute max tip text size

   143

        for line in self.Tip:

   144

            w, h = dc.GetTextExtent(line)

   145

            max_width = max(max_width, w)

   146

            max_height += h

   147

   148

        return wx.Size(max_width + 4, max_height + 4)

   149

   150

    def RefreshTip(self):

   151

        """

   152

        Refresh tip on screen

   153

        """

   154

        # Prevent to call this function if tool tip destroyed

   155

        if self:

   156

            # Refresh tool tip size and position

   157

            self.SetClientSize(self.GetToolTipSize())

   158

   159

            # Redraw tool tip

   160

            self.Refresh()

   161

   162

    def OnPaint(self, event):

   163

        """

   164

        Callback for Paint Event

   165

        @param event: Paint event

   166

        """

   167

        # Get buffered paint DC for tool tip

   168

        dc = wx.AutoBufferedPaintDC(self)

   169

        dc.Clear()

   170

   171

        # Set DC drawing style

   172

        dc.SetPen(wx.BLACK_PEN)

   173

        dc.SetBrush(wx.Brush(wx.Colour(255, 238, 170)))

   174

        dc.SetFont(self.Font)

   175

   176

        # Draw Tool tip

   177

        dc.BeginDrawing()

   178

        tip_width, tip_height = self.GetToolTipSize()

   179

   180

        # Draw background rectangle

   181

        dc.DrawRectangle(0, 0, tip_width, tip_height)

   182

   183

        # Draw tool tip text

   184

        line_offset = 0

   185

        for line in self.Tip:

   186

            dc.DrawText(line, 2, line_offset + 2)

   187

            line_width, line_height = dc.GetTextExtent(line)

   188

            line_offset += line_height

   189

   190

        dc.EndDrawing()

   191

   192

        event.Skip()