ImageViewer Class

In This Topic

Represents a viewer control for displaying an image collection.

Object Model

Syntax

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

'Declaration

<DockingAttribute(Ask)>
<DesignerAttribute("System.Windows.Forms.Design.ScrollableControlDesigner, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>
<DefaultPropertyAttribute("Text")>
<DefaultEventAttribute("Click")>
<DesignerAttribute("System.Windows.Forms.Design.ControlDesigner, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>
<DesignerSerializerAttribute("System.Windows.Forms.Design.ControlCodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.Serialization.CodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>
<ToolboxItemFilterAttribute("System.Windows.Forms", Allow)>
<DesignerCategoryAttribute("Component")>
Public Class ImageViewer
   Inherits ImageViewerBase

[Docking(Ask)]
[Designer("System.Windows.Forms.Design.ScrollableControlDesigner, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
[DefaultProperty("Text")]
[DefaultEvent("Click")]
[Designer("System.Windows.Forms.Design.ControlDesigner, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
[DesignerSerializer("System.Windows.Forms.Design.ControlCodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.Serialization.CodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[ToolboxItemFilter("System.Windows.Forms", Allow)]
[DesignerCategory("Component")]
public class ImageViewer : ImageViewerBase

[Docking(Ask)]
[Designer("System.Windows.Forms.Design.ScrollableControlDesigner, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
[DefaultProperty("Text")]
[DefaultEvent("Click")]
[Designer("System.Windows.Forms.Design.ControlDesigner, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
[DesignerSerializer("System.Windows.Forms.Design.ControlCodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.Serialization.CodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[ToolboxItemFilter("System.Windows.Forms", Allow)]
[DesignerCategory("Component")]
public __gc class ImageViewer : public ImageViewerBase*

[Docking(Ask)]
[Designer("System.Windows.Forms.Design.ScrollableControlDesigner, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
[DefaultProperty("Text")]
[DefaultEvent("Click")]
[Designer("System.Windows.Forms.Design.ControlDesigner, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.IDesigner, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
[DesignerSerializer("System.Windows.Forms.Design.ControlCodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", "System.ComponentModel.Design.Serialization.CodeDomSerializer, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[ToolboxItemFilter("System.Windows.Forms", Allow)]
[DesignerCategory("Component")]
public ref class ImageViewer : public ImageViewerBase^

Remarks

ImageViewer allows to:

Preview image using different size modes
Scroll and zoom image
Magnify image
Select rectangular or custom image region
Copy/cut/paste image
Scale to gray (antialiasing) option for black-white images
Enable/disable buffering

Supported size modes:

Normal with screen resolution ( ImageSizeMode .Normal)
Normal with image resolution ( ImageSizeMode .PixelToPixel)
Best fit ( ImageSizeMode .BestFit)
Fit to width ( ImageSizeMode .FitToWidth)
Fit to height ( ImageSizeMode .FitToHeight)
Scale ( ImageSizeMode .Scale)

ImageViewer has the image collection (the Images property) which stores images associated with this viewer.

ImageViewer can work separately (viewer will have own image collection) or as a slave viewer of another viewer (viewer will use the image collection of master viewer).

Example

VB.NET


Class ImageViewerExample
    Private _thumbnailViewer1 As Vintasoft.Imaging.UI.ThumbnailViewer = Nothing
    Private _imageViewer1 As Vintasoft.Imaging.UI.ImageViewer = Nothing

    Public Sub RunExample()
        _thumbnailViewer1.MasterViewer = _imageViewer1
        _imageViewer1.Images.Add("c:\multipage.tiff")
    End Sub
End Class


class ImageViewerExample
{
    Vintasoft.Imaging.UI.ThumbnailViewer _thumbnailViewer1 = null;
    Vintasoft.Imaging.UI.ImageViewer _imageViewer1 = null;

    public void RunExample()
    {
        _thumbnailViewer1.MasterViewer = _imageViewer1;
        _imageViewer1.Images.Add(@"c:\multipage.tiff");
    }
}

Inheritance Hierarchy

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Windows.Forms.Control
            System.Windows.Forms.ScrollableControl
               Vintasoft.Imaging.UI.ImageViewerBase
                  Vintasoft.Imaging.UI.ImageViewer
                     Vintasoft.Imaging.Annotation.UI.AnnotationViewer
                     Vintasoft.Imaging.UI.AnimatedImageViewer

Requirements

Target Platforms: .NET 7; .NET 6; .NET 5; .NET Core 3.1; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

Reference

ImageViewer Members
Vintasoft.Imaging.UI Namespace

Send Feedback