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

    26

from __future__ import absolute_import

    27

import wx

    28

    29

from controls.CustomToolTip import CustomToolTip, TOOLTIP_WAIT_PERIOD

    30

    31

    32

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

    33

#                           Tool Tip Producer class

    34

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

    35

    36

    37

class ToolTipProducer(object):

    38

    """

    39

    Class that implements an element that generate Tool Tip

    40

    """

    41

    42

    def __init__(self, parent):

    43

        """

    44

        Constructor

    45

        @param parent: Parent Viewer

    46

        """

    47

        self.Parent = parent

    48

    49

        self.ToolTip = None

    50

        self.ToolTipPos = None

    51

    52

        # Timer for firing Tool tip display

    53

        self.ToolTipTimer = wx.Timer(self.Parent, -1)

    54

        self.Parent.Bind(wx.EVT_TIMER,

    55

                         self.OnToolTipTimer,

    56

                         self.ToolTipTimer)

    57

    58

    def __del__(self):

    59

        """

    60

        Destructor

    61

        """

    62

        self.DestroyToolTip()

    63

    64

    def OnToolTipTimer(self, event):

    65

        """

    66

        Callback for Tool Tip firing timer Event

    67

        @param event: Tool tip text

    68

        """

    69

        # Get Tool Tip text

    70

        value = self.GetToolTipValue()

    71

    72

        if value is not None and self.ToolTipPos is not None:

    73

            # Create Tool Tip

    74

            self.ToolTip = CustomToolTip(self.Parent, value)

    75

            self.ToolTip.SetToolTipPosition(self.ToolTipPos)

    76

            self.ToolTip.Show()

    77

    78

    def GetToolTipValue(self):

    79

        """

    80

        Return tool tip text

    81

        Have to be overridden by inherited classes

    82

        @return: Tool tip text (None if not overridden)

    83

        """

    84

        return None

    85

    86

    def DisplayToolTip(self, pos):

    87

        """

    88

        Display Tool tip

    89

        @param pos: Tool tip position

    90

        """

    91

        # Destroy current displayed Tool tip

    92

        self.DestroyToolTip()

    93

    94

        # Save Tool Tip position

    95

        self.ToolTipPos = pos

    96

        # Start Tool tip firing timer

    97

        self.ToolTipTimer.Start(

    98

            int(TOOLTIP_WAIT_PERIOD * 1000),

    99

            oneShot=True)

   100

   101

    def SetToolTipText(self, text):

   102

        """

   103

        Set current Tool tip text

   104

        @param text: Tool tip Text

   105

        """

   106

        if self.ToolTip is not None:

   107

            self.ToolTip.SetTip(text)

   108

   109

    def DestroyToolTip(self):

   110

        """

   111

        Destroy current displayed Tool Tip

   112

        """

   113

        # Stop Tool tip firing timer

   114

        self.ToolTipTimer.Stop()

   115

        self.ToolTipPos = None

   116

   117

        # Destroy Tool Tip

   118

        if self.ToolTip is not None:

   119

            self.ToolTip.Destroy()

   120

            self.ToolTip = None