CropSelectionTool Class

In This Topic

A visual tool for cropping an image in image viewer.

Object Model

Syntax

Visual Basic
C#
Managed Extensions for C++
C++/CLI

'Declaration

Public Class CropSelectionTool
   Inherits RectangularSelectionTool

public class CropSelectionTool : RectangularSelectionTool

public __gc class CropSelectionTool : public RectangularSelectionTool*

public ref class CropSelectionTool : public RectangularSelectionTool^

Remarks

Rectangular region of image in image viewer can be cropped as follows:

place the mouse to the desired position
press the action button (ActionButton) and select the "crop" region by holding the action button
press the action button inside the "crop" region for cropping of image; press any mouse button outside of the "crop" region for canceling cropping of image

If ActionButton is set to right mouse button, context menu during action can be disabled with the DisableContextMenu property.

Example

This C#/VB.NET code shows how to programmatically crop an image.

VB.NET


Class CropSelectionToolExample
    ''' <summary>
    ''' Programmatically crops an image in image viewer.
    ''' </summary>
    ''' <param name="viewer">Image viewer.</param>
    Public Sub ProgrammaticallyCropImageInViewer(viewer As Vintasoft.Imaging.UI.ImageViewer)
        ' create an instance of CropSelectionTool class
        Dim cropSelectionTool As New Vintasoft.Imaging.UI.VisualTools.CropSelectionTool()

        ' set the tool as the current tool of the ImageViewer
        viewer.VisualTool = cropSelectionTool

        ' set the region of interest on image
        cropSelectionTool.Rectangle = New System.Drawing.Rectangle(50, 50, 250, 150)
        ' crop an image
        cropSelectionTool.Crop()
    End Sub
End Class


class CropSelectionToolExample
{
    /// <summary>
    /// Programmatically crops an image in image viewer.
    /// </summary>
    /// <param name="viewer">Image viewer.</param>
    public void ProgrammaticallyCropImageInViewer(Vintasoft.Imaging.UI.ImageViewer viewer)
    {
        // create an instance of CropSelectionTool class
        Vintasoft.Imaging.UI.VisualTools.CropSelectionTool cropSelectionTool = 
            new Vintasoft.Imaging.UI.VisualTools.CropSelectionTool();

        // set the tool as the current tool of the ImageViewer
        viewer.VisualTool = cropSelectionTool;
        
        // set the region of interest on image
        cropSelectionTool.Rectangle = new System.Drawing.Rectangle(50, 50, 250, 150);
        // crop an image
        cropSelectionTool.Crop();
    }
}

Inheritance Hierarchy

System.Object
   Vintasoft.Imaging.UI.VisualTools.VisualTool
      Vintasoft.Imaging.UI.VisualTools.UserInteraction.UserInteractionVisualTool
         Vintasoft.Imaging.UI.VisualTools.RectangularSelectionTool
            Vintasoft.Imaging.UI.VisualTools.CropSelectionTool
               Vintasoft.Imaging.Pdf.UI.PdfCropSelectionTool

Requirements

Target Platforms: .NET9; .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

Reference

CropSelectionTool Members
Vintasoft.Imaging.UI.VisualTools Namespace

Send Feedback