CropSelectionTool Class
In This Topic
A visual tool for cropping an image in image viewer.
Object Model
Syntax
'Declaration Public Class CropSelectionTool Inherits RectangularSelectionTool Implements Vintasoft.Imaging.UI.VisualTools.UserInteraction.IInteractiveObject, Vintasoft.Imaging.UI.VisualTools.UserInteraction.IRectangularInteractiveObject, Vintasoft.Imaging.UIActions.ISupportUIActions
public class CropSelectionTool : RectangularSelectionTool, Vintasoft.Imaging.UI.VisualTools.UserInteraction.IInteractiveObject, Vintasoft.Imaging.UI.VisualTools.UserInteraction.IRectangularInteractiveObject, Vintasoft.Imaging.UIActions.ISupportUIActions
Remarks
Rectangular region of image in image viewer can be cropped as follows:
If VisualTool.ActionButton is set to right mouse button, context menu during action can be disabled with the VisualTool.DisableContextMenu property.
- place the mouse to the desired position
- press the action button (VisualTool.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 VisualTool.ActionButton is set to right mouse button, context menu during action can be disabled with the VisualTool.DisableContextMenu property.
Example
This example shows how to programmatically crop an image.
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: .NET 6; .NET 5; .NET Core 3.1; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5
See Also