←Select platform

PreferredItemType Property

Summary

The preferred mode to use when viewing the image data of the pages.

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

Property Value

The preferred mode to use when viewing the image of a page. Default value is DocumentViewerItemType.Image.

Remarks

ImageViewer supports using RasterImage or SvgDocument images.

When DocumentViewerItemType.Image is set, the document viewer will use DocumentPage.GetImage to get the image data of a page and use it for viewing. This is supported by all document types.

When DocumentViewerItemType.Svg is set, the document viewer will check IsSvgViewingPreferred the property of the current LEADDocument set. If SVG is supported, then it use use DocumentPage.GetSvg to get the SVG data of a page and use it for viewing. This is supported by all document formats but not by most raster file formats.

Use PreferredItemType property to set the preferred mode to use. In other words, when you set it as DocumentViewerItemType.Image, then raster images will always be used. If you set it to DocumentViewerItemType.Svg, then SVG documents is used if supported, otherwise, use raster images.

The ItemType property returns the actual value being used currently based on the document type.

Example

Start with the example created in DocumentViewer, remove all the code in the Example function and add the code below.

When the user clicks the Example button, we will switch between SVG and Image viewing showing information on what happened.

C#
using Leadtools; 
using Leadtools.Controls; 
using Leadtools.Document; 
using Leadtools.Document.Viewer; 
using Leadtools.Codecs; 
using Leadtools.Caching; 
using Leadtools.Annotations.Engine; 
using Leadtools.Ocr; 
 
 
// Switch between SVG and Raster image viewer 
var view = _documentViewer.View; 
if (view.PreferredItemType == DocumentViewerItemType.Svg) 
   view.PreferredItemType = DocumentViewerItemType.Image; 
else 
   view.PreferredItemType = DocumentViewerItemType.Svg; 
 
// When we ste the preferred, ItemType gets updated accordingly with 
// the actual value supported by the document format 
// Formats such as PDF and DOCX support both 
// Formats such as TIF and JPEG support only raster 
var message = string.Format("We prefer {0} and it is currently {1} - document MIME type is {2}", 
   view.PreferredItemType, 
   view.ItemType, 
   _documentViewer.Document.MimeType); 
Console.WriteLine(message); 
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.Document.Viewer.WinForms Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.