ThumbnailViewer Class

In This Topic

Represents a viewer control for displaying thumbnails of 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 ThumbnailViewer
   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 ThumbnailViewer : 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 ThumbnailViewer : 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 ThumbnailViewer : public ImageViewerBase^

Remarks

ThumbnailViewer allows to:

Preview thumbnails of images
Select multiple thumbnails
Reorder thumbnails using drag-and-drop
Remove thumbnail(s) from thumbnail viewer
Use copy/cut/paste operations

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

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

ThumbnailViewer starts a background thread each time when the image collection associated with it was changed. It raises the ThumbnailAdded event for each added or updated thumbnail.

Images from the ThumbnailViewer's image collection can be reordered using drag-and-drop.

Example

VB.NET


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

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


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

    public void RunExample()
    {
        _thumbnailViewer1.MasterViewer = _imageViewer1;
        _thumbnailViewer1.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.ThumbnailViewer
                     Vintasoft.Imaging.Annotation.UI.AnnotatedThumbnailViewer

Requirements

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

Reference

ThumbnailViewer Members
Vintasoft.Imaging.UI Namespace

ImageViewerImagesManager
ThumbnailCaption

Send Feedback