←Select platform

ViewLayout Property

Summary

View layout used by this ImageViewer.

Syntax
C#
C++/CLI
public virtual ImageViewerViewLayout ViewLayout { get; set; } 
public:  
   virtual property ImageViewerViewLayout^ ViewLayout 
   { 
      ImageViewerViewLayout^ get() 
      void set(ImageViewerViewLayout^ value) 
   } 

Property Value

The view layout used by this ImageViewer. Default value is an instance of ImageViewerSingleViewLayout.

Remarks

For more information, refer to Image Viewer Layouts.

Example

This example will add a few items to the ImageViewer and then allows you to switch between different view layouts to see the differences.

Run the demo. Now when you click the Example button.

Start with the ImageViewer example, remove all the code inside the example function (search for the "// TODO: add example code here" comment) and insert the following code:

C#
using Leadtools; 
using Leadtools.Controls; 
using Leadtools.Codecs; 
using Leadtools.Drawing; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
 
 
public ImageViewerForm _form = new ImageViewerForm(); 
public ComboBox comboBox = new ComboBox(); 
public ImageViewer _imageViewer; 
 
public void ImageViewerViewLayoutExample() 
{ 
 
   // Get the ImageViewer control from the form 
   _imageViewer = _form.ImageViewer; 
 
   // Clear all the images already the viewer 
   _imageViewer.Items.Clear(); 
   // Use vertical view layout 
   _imageViewer.ViewLayout = new ImageViewerVerticalViewLayout(); 
   // Item Border 
   _imageViewer.ItemBorderThickness = 1; 
   // Make sure the item size is larger than the image size (thumbnails mode) 
   _imageViewer.ItemSize = LeadSize.Create(200, 200); 
 
   // Add 4 items to the viewer 
   using (var codecs = new RasterCodecs()) 
   { 
      for (var page = 1; page <= 4; page++) 
      { 
         ImageViewerItem item = new ImageViewerItem(); 
         var fileName = Path.Combine(LEAD_VARS.ImagesDir, string.Format("ocr{0}.tif", page)); 
 
         // Create a thumbnail from the image 
         using (var image = codecs.Load(fileName, page)) 
         { 
            item.Image = image.CreateThumbnail(180, 180, 24, RasterViewPerspective.TopLeft, RasterSizeFlags.Resample); 
         } 
         _imageViewer.Items.Add(item); 
      } 
   } 
 
   // Add a combo box control to show the view layout modes 
   comboBox.Top = _form.ClientRectangle.Top; 
   _form.Controls.Add(comboBox); 
 
   // Add an entry for each view mode to the combo box 
   comboBox.Items.Add("Single view layout"); 
   comboBox.Items.Add("Vertical view layout"); 
   comboBox.Items.Add("Horizontal view layout"); 
   comboBox.Items.Add("Vertical view layout - 2 Columns"); 
   comboBox.Items.Add("Horizontal view layout - 2 Rows"); 
 
   comboBox.BringToFront(); 
 
   // When the user selects a view layout mode from the combo box 
   comboBox.SelectedIndexChanged += ComboBox_SelectedIndexChanged; 
} 
 
private void ComboBox_SelectedIndexChanged(object sender, EventArgs e) 
{ 
   ComboBox comboBox = sender as ComboBox; 
   ImageViewerViewLayout layout; 
 
   switch (comboBox.SelectedItem.ToString()) 
   { 
      case "Single view layout": 
         layout = new ImageViewerSingleViewLayout(); 
         break; 
      case "Vertical view layout": 
      default: 
         layout = new ImageViewerVerticalViewLayout(); 
         break; 
      case "Horizontal view layout": 
         layout = new ImageViewerHorizontalViewLayout(); 
         break; 
      case "Vertical view layout - 2 Columns": 
         layout = new ImageViewerVerticalViewLayout() { Columns = 2 }; 
         break; 
      case "Horizontal view layout - 2 Rows": 
         layout = new ImageViewerHorizontalViewLayout() { Rows = 2 }; 
         break; 
   } 
 
   _imageViewer.ViewLayout = layout; 
   _imageViewer.UpdateTransform(); 
   // Call Zoom with current values to update ImageViewer.ViewLayout values 
   _imageViewer.Zoom(_imageViewer.SizeMode, _imageViewer.ScaleFactor, _imageViewer.DefaultZoomOrigin);  
 
   string msg = string.Format("Layout.Name = {0}\nLayout.SizeModeHeight = {1}\nLayout.SizeModeHeightItemCount = {2}\nLayout.SizeModeWidth = {3}\nLayout.SizeModeWidthItemCount = {4}\n", 
      _imageViewer.ViewLayout.Name, 
      _imageViewer.ViewLayout.SizeModeHeight, 
      _imageViewer.ViewLayout.SizeModeHeightItemCount, 
      _imageViewer.ViewLayout.SizeModeWidth, 
      _imageViewer.ViewLayout.SizeModeWidthItemCount); 
   Debug.WriteLine(msg, "ImageViewerLayout Information"); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
} 
Requirements

Target Platforms

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Controls Assembly

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.