X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/8b9a4190f70909de9568f45389e7aa3ecbc66b8a..685d898512944add00640b6e37da89159ee4d9b5:/wxPython/demo/wxDragImage.py
diff --git a/wxPython/demo/wxDragImage.py b/wxPython/demo/wxDragImage.py
index 74ade7e0ea..ad8f880a5d 100644
--- a/wxPython/demo/wxDragImage.py
+++ b/wxPython/demo/wxDragImage.py
@@ -1,37 +1,37 @@
+# 11/15/2003 - Jeff Grimmett (grimmtooth@softhome.net)
+#
+# o Updated for wx namespace
+#
-from wxPython.wx import *
-
-import images
+import wx
+import images
#----------------------------------------------------------------------
class DragShape:
def __init__(self, bmp):
self.bmp = bmp
- self.pos = wxPoint(0,0)
+ self.pos = (0,0)
self.shown = True
self.text = None
self.fullscreen = False
-
def HitTest(self, pt):
rect = self.GetRect()
return rect.InsideXY(pt.x, pt.y)
-
def GetRect(self):
- return wxRect(self.pos.x, self.pos.y,
+ return wx.Rect(self.pos[0], self.pos[1],
self.bmp.GetWidth(), self.bmp.GetHeight())
-
- def Draw(self, dc, op = wxCOPY):
+ def Draw(self, dc, op = wx.COPY):
if self.bmp.Ok():
- memDC = wxMemoryDC()
+ memDC = wx.MemoryDC()
memDC.SelectObject(self.bmp)
- dc.Blit(self.pos.x, self.pos.y,
- self.bmp.GetWidth(), self.bmp.GetHeight(),
- memDC, 0, 0, op, True)
+ dc.Blit((self.pos[0], self.pos[1]),
+ (self.bmp.GetWidth(), self.bmp.GetHeight()),
+ memDC, (0, 0), op, True)
return True
else:
@@ -41,156 +41,192 @@ class DragShape:
#----------------------------------------------------------------------
-class DragCanvas(wxScrolledWindow):
+class DragCanvas(wx.ScrolledWindow):
def __init__(self, parent, ID):
- wxScrolledWindow.__init__(self, parent, ID)
+ wx.ScrolledWindow.__init__(self, parent, ID)
self.shapes = []
self.dragImage = None
self.dragShape = None
self.hiliteShape = None
- self.SetCursor(wxStockCursor(wxCURSOR_ARROW))
+ self.SetCursor(wx.StockCursor(wx.CURSOR_ARROW))
self.bg_bmp = images.getBackgroundBitmap()
-
# Make a shape from an image and mask. This one will demo
# dragging outside the window
bmp = images.getTestStarBitmap()
shape = DragShape(bmp)
- shape.pos = wxPoint(5, 5)
+ shape.pos = (5, 5)
shape.fullscreen = True
self.shapes.append(shape)
-
# Make a shape from some text
text = "Some Text"
- bg_colour = wxColour(57, 115, 57) # matches the bg image
- font = wxFont(15, wxROMAN, wxNORMAL, wxBOLD)
+ bg_colour = wx.Colour(57, 115, 57) # matches the bg image
+ font = wx.Font(15, wx.ROMAN, wx.NORMAL, wx.BOLD)
textExtent = self.GetFullTextExtent(text, font)
- bmp = wxEmptyBitmap(textExtent[0], textExtent[1])
- dc = wxMemoryDC()
+
+ # create a bitmap the same size as our text
+ bmp = wx.EmptyBitmap(textExtent[0], textExtent[1])
+
+ # 'draw' the text onto the bitmap
+ dc = wx.MemoryDC()
dc.SelectObject(bmp)
- dc.SetBackground(wxBrush(bg_colour, wxSOLID))
+ dc.SetBackground(wx.Brush(bg_colour, wx.SOLID))
dc.Clear()
- dc.SetTextForeground(wxRED)
+ dc.SetTextForeground(wx.RED)
dc.SetFont(font)
- dc.DrawText(text, 0, 0)
- dc.SelectObject(wxNullBitmap)
- mask = wxMaskColour(bmp, bg_colour)
+ dc.DrawText(text, (0, 0))
+ dc.SelectObject(wx.NullBitmap)
+ mask = wx.MaskColour(bmp, bg_colour)
bmp.SetMask(mask)
shape = DragShape(bmp)
- shape.pos = wxPoint(5, 100)
+ shape.pos = (5, 100)
shape.text = "Some dragging text"
self.shapes.append(shape)
# Make some shapes from some playing card images.
x = 200
+
for card in ['_01c_', '_12h_', '_13d_', '_10s_']:
bmpFunc = getattr(images, "get%sBitmap" % card)
bmp = bmpFunc()
shape = DragShape(bmp)
- shape.pos = wxPoint(x, 5)
+ shape.pos = (x, 5)
self.shapes.append(shape)
x = x + 80
- EVT_ERASE_BACKGROUND(self, self.OnEraseBackground)
- EVT_PAINT(self, self.OnPaint)
- EVT_LEFT_DOWN(self, self.OnLeftDown)
- EVT_LEFT_UP(self, self.OnLeftUp)
- EVT_MOTION(self, self.OnMotion)
- EVT_LEAVE_WINDOW(self, self.OnLeaveWindow)
-
+ self.Bind(wx.EVT_ERASE_BACKGROUND, self.OnEraseBackground)
+ self.Bind(wx.EVT_PAINT, self.OnPaint)
+ self.Bind(wx.EVT_LEFT_DOWN, self.OnLeftDown)
+ self.Bind(wx.EVT_LEFT_UP, self.OnLeftUp)
+ self.Bind(wx.EVT_MOTION, self.OnMotion)
+ self.Bind(wx.EVT_LEAVE_WINDOW, self.OnLeaveWindow)
+
+ # We're not doing anything here, but you might have reason to.
+ # for example, if you were dragging something, you might elect to
+ # 'drop it' when the cursor left the window.
def OnLeaveWindow(self, evt):
pass
+ # tile the background bitmap
def TileBackground(self, dc):
- # tile the background bitmap
sz = self.GetClientSize()
w = self.bg_bmp.GetWidth()
h = self.bg_bmp.GetHeight()
x = 0
+
while x < sz.width:
y = 0
+
while y < sz.height:
- dc.DrawBitmap(self.bg_bmp, x, y)
+ dc.DrawBitmap(self.bg_bmp, (x, y))
y = y + h
+
x = x + w
+ # Go through our list of shapes and draw them in whatever place they are.
def DrawShapes(self, dc):
for shape in self.shapes:
if shape.shown:
shape.Draw(dc)
-
+ # This is actually a sophisticated 'hit test', but in this
+ # case we're also determining which shape, if any, was 'hit'.
def FindShape(self, pt):
for shape in self.shapes:
if shape.HitTest(pt):
return shape
return None
-
+ # Remove a shape from the display
def EraseShape(self, shape, dc):
r = shape.GetRect()
- dc.SetClippingRegion(r.x, r.y, r.width, r.height)
+ dc.SetClippingRect(r)
self.TileBackground(dc)
self.DrawShapes(dc)
dc.DestroyClippingRegion()
-
+ # Clears the background, then redraws it. If the DC is passed, then
+ # we only do so in the area so designated. Otherwise, it's the whole thing.
def OnEraseBackground(self, evt):
dc = evt.GetDC()
+
if not dc:
dc = wxClientDC(self)
rect = self.GetUpdateRegion().GetBox()
- dc.SetClippingRegion(rect.x, rect.y, rect.width, rect.height)
+ dc.SetClippingRect(rect)
self.TileBackground(dc)
-
+ # Fired whenever a paint event occurs
def OnPaint(self, evt):
- dc = wxPaintDC(self)
+ dc = wx.PaintDC(self)
self.PrepareDC(dc)
self.DrawShapes(dc)
-
+ # Left mouse button is down.
def OnLeftDown(self, evt):
+ # Did the mouse go down on one of our shapes?
shape = self.FindShape(evt.GetPosition())
+
+ # If a shape was 'hit', then set that as the shape we're going to
+ # drag around. Get our start position. Dragging has not yet started.
+ # That will happen once the mouse moves, OR the mouse is released.
if shape:
- # get ready to start dragging, but wait for the user to
- # move it a bit first
self.dragShape = shape
self.dragStartPos = evt.GetPosition()
-
+ # Left mouse button up.
def OnLeftUp(self, evt):
if not self.dragImage or not self.dragShape:
self.dragImage = None
self.dragShape = None
return
- # end the dragging
+ # Hide the image, end dragging, and nuke out the drag image.
self.dragImage.Hide()
self.dragImage.EndDrag()
self.dragImage = None
- dc = wxClientDC(self)
+ dc = wx.ClientDC(self)
+
if self.hiliteShape:
self.hiliteShape.Draw(dc)
self.hiliteShape = None
# reposition and draw the shape
- self.dragShape.pos = self.dragShape.pos + evt.GetPosition() - self.dragStartPos
+
+ # Note by jmg 11/28/03
+ # Here's the original:
+ #
+ # self.dragShape.pos = self.dragShape.pos + evt.GetPosition() - self.dragStartPos
+ #
+ # So if there are any problems associated with this, use that as
+ # a starting place in your investigation. I've tried to simulate the
+ # wx.Point __add__ method here -- it won't work for tuples as we
+ # have now from the various methods
+ #
+ # There must be a better way to do this :-)
+ #
+
+ self.dragShape.pos = (
+ self.dragShape.pos[0] + evt.GetPosition()[0] - self.dragStartPos[0],
+ self.dragShape.pos[1] + evt.GetPosition()[1] - self.dragStartPos[1]
+ )
+
self.dragShape.shown = True
self.dragShape.Draw(dc)
self.dragShape = None
-
+ # The mouse is moving
def OnMotion(self, evt):
+ # Ignore mouse movement if we're not dragging.
if not self.dragShape or not evt.Dragging() or not evt.LeftIsDown():
return
@@ -206,17 +242,17 @@ class DragCanvas(wxScrolledWindow):
return
# erase the shape since it will be drawn independently now
- dc = wxClientDC(self)
+ dc = wx.ClientDC(self)
self.dragShape.shown = False
self.EraseShape(self.dragShape, dc)
if self.dragShape.text:
- self.dragImage = wxDragString(self.dragShape.text,
- wxStockCursor(wxCURSOR_HAND))
+ self.dragImage = wx.DragString(self.dragShape.text,
+ wx.StockCursor(wx.CURSOR_HAND))
else:
- self.dragImage = wxDragImage(self.dragShape.bmp,
- wxStockCursor(wxCURSOR_HAND))
+ self.dragImage = wx.DragImage(self.dragShape.bmp,
+ wx.StockCursor(wx.CURSOR_HAND))
hotspot = self.dragStartPos - self.dragShape.pos
self.dragImage.BeginDrag(hotspot, self, self.dragShape.fullscreen)
@@ -244,14 +280,14 @@ class DragCanvas(wxScrolledWindow):
self.dragImage.Hide()
if unhiliteOld:
- dc = wxClientDC(self)
+ dc = wx.ClientDC(self)
self.hiliteShape.Draw(dc)
self.hiliteShape = None
if hiliteNew:
- dc = wxClientDC(self)
+ dc = wx.ClientDC(self)
self.hiliteShape = onShape
- self.hiliteShape.Draw(dc, wxINVERT)
+ self.hiliteShape.Draw(dc, wx.INVERT)
# now move it and show it again if needed
self.dragImage.Move(evt.GetPosition())
@@ -262,10 +298,14 @@ class DragCanvas(wxScrolledWindow):
#----------------------------------------------------------------------
def runTest(frame, nb, log):
- win = wxPanel(nb, -1)
+
+ win = wx.Panel(nb, -1)
canvas = DragCanvas(win, -1)
- def onSize(evt, panel=win, canvas=canvas): canvas.SetSize(panel.GetSize())
- EVT_SIZE(win, onSize)
+
+ def onSize(evt, panel=win, canvas=canvas):
+ canvas.SetSize(panel.GetSize())
+
+ win.Bind(wx.EVT_SIZE, onSize)
return win
#----------------------------------------------------------------------
@@ -273,6 +313,28 @@ def runTest(frame, nb, log):
overview = """\
+DragImage is used when you wish to drag an object on the screen, and a simple
+cursor is not enough.
+
+On Windows, the WIN32 API is used to do achieve smooth dragging. On other
+platforms, GenericDragImage is used. Applications may also prefer to use
+GenericDragImage on Windows, too.
+
+wxPython note: wxPython uses GenericDragImage on all
+platforms, but uses the DragImage name.
+
+To use this class, when you wish to start dragging an image, create a
+DragImage object and store it somewhere you can access it as the
+drag progresses. Call BeginDrag to start, and EndDrag to stop the drag. To move
+the image, initially call Show and then Move. If you wish to update the screen
+contents during the drag (for example, highlight an item as in the example), first
+call Hide, update the screen, call Move, and then call Show.
+
+You can drag within one window, or you can use full-screen dragging either across
+the whole screen, or just restricted to one area of the screen to save resources.
+If you want the user to drag between two windows, then you will need to use
+full-screen dragging.
+
"""