InteractiveUserRectangle Event

public event EventHandler<RectangleInteractiveEventArgs> InteractiveUserRectangle

public:
event EventHandler<RectangleInteractiveEventArgs^>^ InteractiveUserRectangle

'Declaration
 
Public Event InteractiveUserRectangle As EventHandler(Of RectangleInteractiveEventArgs)

'Usage
 
Dim instance As ImageViewer
Dim handler As EventHandler(Of RectangleInteractiveEventArgs)
 
AddHandler instance.InteractiveUserRectangle, handler

The event handler receives an argument of type RectangleInteractiveEventArgs containing data related to this event. The following RectangleInteractiveEventArgs properties provide information specific to this event.

Property	Description
Bounds	Gets the bounds location for the current interactive rectangle mode.
Cancel (Inherited from Leadtools.Windows.Controls.InteractiveEventArgs)	Gets or sets a value indicating whether the interactive mode should be canceled.
Handled (Inherited from System.Windows.RoutedEventArgs)
OriginalSource (Inherited from System.Windows.RoutedEventArgs)
RoutedEvent (Inherited from System.Windows.RoutedEventArgs)
Source (Inherited from System.Windows.RoutedEventArgs)
Status (Inherited from Leadtools.Windows.Controls.InteractiveEventArgs)	Gets the current status of the interactive mode.

Occurs when the InteractiveMode property is set to InteractiveMode.UseRectangle.

Use the InteractiveMode.UserRectangle and InteractiveUserRectangle to draw a rectangle on the surface of the control. The ImageViewer object will handle mouse cursor down and up events, mouse movement, canceling (through the ESC key or when the control loses the focus) and clipping.

The InteractiveUserRectangle event will occur every time the user moves the mouse or clicks any of the buttons with the corresponding data in the RectangleInteractiveEventArgs of the event.

You can use the user-defined rectangle interactive mode to perform additional interactive operations on the viewer not handled by any of the pre-defined InteractiveMode.

You can use the BoundsToImageCoordinates and BoundsFromImageCoordinates methods to convert a rectangle between image and control coordinates.

This example will use the user-defined rectangle interactive mode to let the user select a rectangle on the image to invert.

Imports Leadtools.Windows.Controls

Public Sub BitmapSourceViewer_IsInteractiveModeBusy(ByVal viewer As ImageViewer)
    AddHandler viewer.InteractiveUserRectangle, AddressOf viewer_InteractiveUserRectangle
    viewer.InteractiveMode = InteractiveMode.UserRectangle

    MessageBox.Show("Interactive mode set to draw a rectangular geometry." & Constants.vbLf & "If mouse is dragged up or to the left, interactive mode is cancelled")
End Sub

Private Sub viewer_InteractiveUserRectangle(ByVal sender As Object, ByVal e As RectangleInteractiveEventArgs)
    Console.WriteLine("" & e.Status)
    Dim viewer As ImageViewer = TryCast(sender, ImageViewer)

    Dim ee As RectangleInteractiveEventArgs = New RectangleInteractiveEventArgs(e.Status, e.Bounds)
    If e.Status = InteractiveModeStatus.End Then
        e.Cancel = True
        If (Not viewer.IsInteractiveModeBusy) Then
            MessageBox.Show("Interactive mode (Rectangular geometry) cancelled")
            viewer.InteractiveMode = InteractiveMode.None
        End If
    End If

    Console.WriteLine("" & e.Bounds.Left & ", " & e.Bounds.Top & ", " & e.Bounds.Right & ", " & e.Bounds.Bottom)
End Sub

using Leadtools.Help;
using Leadtools.Windows.Controls;

public void BitmapSourceViewer_IsInteractiveModeBusy(ImageViewer viewer)
{
   viewer.InteractiveUserRectangle += new EventHandler<RectangleInteractiveEventArgs>(viewer_InteractiveUserRectangle);
   viewer.InteractiveMode = InteractiveMode.UserRectangle;

   MessageBox.Show("Interactive mode set to draw a rectangular geometry.\nIf mouse is dragged up or to the left, interactive mode is cancelled");
}

void viewer_InteractiveUserRectangle(object sender, RectangleInteractiveEventArgs e)
{
   Console.WriteLine(@"" + e.Status);
   ImageViewer viewer = sender as ImageViewer;

   RectangleInteractiveEventArgs ee = new RectangleInteractiveEventArgs(e.Status, e.Bounds);
   if (e.Status == InteractiveModeStatus.End)
   {
      e.Cancel = true;
      if (!viewer.IsInteractiveModeBusy)
      {
         MessageBox.Show("Interactive mode (Rectangular geometry) cancelled");
         viewer.InteractiveMode = InteractiveMode.None;
      }
   }

   Console.WriteLine(@"" + e.Bounds.Left + ", " + e.Bounds.Top + ", " + e.Bounds.Right + ", " + e.Bounds.Bottom);
}

using Leadtools.Help;
using Leadtools.Windows.Controls;

public void BitmapSourceViewer_IsInteractiveModeBusy(ImageViewer viewer)
{
   viewer.InteractiveUserRectangle += new EventHandler<RectangleInteractiveEventArgs>(viewer_InteractiveUserRectangle);
   viewer.InteractiveMode = InteractiveMode.UserRectangle;

   MessageBox.Show("Interactive mode set to draw a rectangular geometry.\nIf mouse is dragged up or to the left, interactive mode is cancelled");
}

void viewer_InteractiveUserRectangle(object sender, RectangleInteractiveEventArgs e)
{
   Console.WriteLine(@"" + e.Status);
   ImageViewer viewer = sender as ImageViewer;

   RectangleInteractiveEventArgs ee = new RectangleInteractiveEventArgs(e.Status, e.Bounds);
   if (e.Status == InteractiveModeStatus.End)
   {
      e.Cancel = true;
      if (!viewer.IsInteractiveModeBusy)
      {
         MessageBox.Show("Interactive mode (Rectangular geometry) cancelled");
         viewer.InteractiveMode = InteractiveMode.None;
      }
   }

   Console.WriteLine(@"" + e.Bounds.Left + ", " + e.Bounds.Top + ", " + e.Bounds.Right + ", " + e.Bounds.Bottom);
}

Imports Leadtools
Imports Leadtools.Windows.Controls

Public Sub BitmapSourceViewer_IsInteractiveModeBusy(ByVal viewer As ImageViewer)
   AddHandler viewer.InteractiveUserRectangle, AddressOf viewer_InteractiveUserRectangle
   viewer.InteractiveMode = InteractiveMode.UserRectangle

   MessageBox.Show("Interactive mode set to draw a rectangular geometry." & Constants.vbLf & _
                   "If mouse is dragged up or to the left, interactive mode is cancelled")
End Sub

Private Sub viewer_InteractiveUserRectangle(ByVal sender As Object, ByVal e As RectangleInteractiveEventArgs)
   Console.WriteLine("" & e.Status)
   Dim viewer As ImageViewer = TryCast(sender, ImageViewer)

   Dim ee As RectangleInteractiveEventArgs = New RectangleInteractiveEventArgs(e.Status, e.Bounds)
   If e.Status = InteractiveModeStatus.End Then
      e.Cancel = True
      If (Not viewer.IsInteractiveModeBusy) Then
         MessageBox.Show("Interactive mode (Rectangular geometry) cancelled")
         viewer.InteractiveMode = InteractiveMode.None
      End If
   End If

   Console.WriteLine("" & e.Bounds.Left & ", " & e.Bounds.Top & ", " & e.Bounds.Right & ", " & e.Bounds.Bottom)
End Sub

Target Platforms

Reference

ImageViewer Class
ImageViewer Members