Expand Minimize
This topic has not yet been rated - Rate this topic

UIElement.ReleaseMouseCapture Method

Releases the mouse capture, if this element held the capture.

Namespace:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)
'Declaration
Public Sub ReleaseMouseCapture

Implements

IInputElement.ReleaseMouseCapture

If this element did not hold the capture, calling this method has no effect. Consider checking the value of IsMouseCaptured before you call this method.

The following example is the parallel to the example given for CaptureMouse: it handles mouse button up to release mouse capture and re-enable moving the mouse.


		Private Sub MouseDownHandler(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
			If Not Enabled Then
				Return
			End If
			e.Handled = True


			If Keyboard.IsKeyDown(Key.F1) = True Then
				Reset()
				Return
			End If

			Dim el As UIElement = CType(sender, UIElement)
			_point = e.MouseDevice.GetPosition(el)
			' Initialize the center of rotation to the lookatpoint
			If Not _centered Then
				Dim camera As ProjectionCamera = CType(_slaves(0).Camera, ProjectionCamera)
				_center = camera.LookDirection
				_centered = True
			End If

			_scaling = (e.MiddleButton = MouseButtonState.Pressed)

			If Keyboard.IsKeyDown(Key.Space) = False Then
				_rotating = True
			Else
				_rotating = False
			End If

			el.CaptureMouse()
		End Sub

		Private Sub MouseUpHandler(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
			If Not _enabled Then
				Return
			End If
			e.Handled = True

			' Stuff the current initial + delta into initial so when we next move we
			' start at the right place.
			If _rotating = True Then
				_rotation = _rotationDelta * _rotation
			Else
				_translate += _translateDelta
				_translateDelta.X = 0
				_translateDelta.Y = 0
			End If

			'_scale = _scaleDelta * _scale
			Dim el As UIElement = CType(sender, UIElement)
			el.ReleaseMouseCapture()
		End Sub


.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.