←Select platform

RasterPictureBox Class

Summary

Represents a LEADTOOLS PictureBox control for displaying an image.

Syntax

C++

[DefaultPropertyAttribute("Image")] 
[DefaultEventAttribute("FrameChanged")] 
[DockingAttribute(System.Windows.Forms.DockingBehavior)] 
public class RasterPictureBox : Control

  
<DockingAttribute(DockingBehavior.Ask)> 
<ToolboxBitmapAttribute()> 
<DefaultPropertyAttribute("Image")> 
Public Class RasterPictureBox  
   Inherits System.Windows.Forms.Control 
   Implements System.ComponentModel.IComponent, System.ComponentModel.ISynchronizeInvoke, System.IDisposable, System.Windows.Forms.IBindableComponent, System.Windows.Forms.IDropTarget, System.Windows.Forms.IWin32Window

[DockingAttribute(DockingBehavior.Ask)] 
[ToolboxBitmapAttribute()] 
[DefaultPropertyAttribute("Image")] 
public ref class RasterPictureBox : public System.Windows.Forms.Control, System.ComponentModel.IComponent, System.ComponentModel.ISynchronizeInvoke, System.IDisposable, System.Windows.Forms.IBindableComponent, System.Windows.Forms.IDropTarget, System.Windows.Forms.IWin32Window

Remarks

The RasterPictureBox is used to display graphics from a bitmap, metafile, icon, JPEG, GIF or PNG (or any other image file format supported by LEADTOOLS) file. Set the Image property to an Leadtools.RasterImage object to be displayed. The RasterPictureBox control can automatically animate Multi-Page file formats.

Example

This example will create an instance of the RasterPictureBox control and add it to a form

using Leadtools.WinForms; 
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Drawing; 
 
public void RasterPictureBox_RasterPictureBox() 
{ 
   MyForm1 form = new MyForm1(); 
   form.ShowDialog(); 
} 
 
class MyForm1 : Form 
{ 
   RasterPictureBox thePictureBox; 
 
   public MyForm1() 
   { 
      // Create the raster PictureBox 
      thePictureBox = new RasterPictureBox(); 
      thePictureBox.Dock = DockStyle.Fill; 
      thePictureBox.BorderStyle = BorderStyle.Fixed3D; 
      thePictureBox.UseDpi = false; 
 
      // Set the paint properties 
      RasterPaintProperties p = new RasterPaintProperties(); 
      p.PaintDisplayMode = RasterPaintDisplayModeFlags.Bicubic; 
      p.PaintEngine = RasterPaintEngine.GdiPlus; 
      p.UsePaintPalette = true; 
      thePictureBox.PaintProperties = p; 
 
      Controls.Add(thePictureBox); 
      thePictureBox.BringToFront(); 
 
      // load an image into the viewer 
      RasterCodecs codecs = new RasterCodecs(); 
      thePictureBox.Image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "eye.gif")); 
      codecs.Dispose(); 
 
      Text = string.Format("Size mode = {0}, double click to change", thePictureBox.SizeMode); 
 
      thePictureBox.DoubleClick += new EventHandler(thePictureBox_DoubleClick); 
   } 
 
   void thePictureBox_DoubleClick(object sender, EventArgs e) 
   { 
      switch (thePictureBox.SizeMode) 
      { 
         case RasterPictureBoxSizeMode.Normal: 
            thePictureBox.SizeMode = RasterPictureBoxSizeMode.StretchImage; 
            break; 
 
         case RasterPictureBoxSizeMode.StretchImage: 
            thePictureBox.SizeMode = RasterPictureBoxSizeMode.Fit; 
            break; 
 
         case RasterPictureBoxSizeMode.Fit: 
            thePictureBox.SizeMode = RasterPictureBoxSizeMode.AutoSize; 
            break; 
 
         case RasterPictureBoxSizeMode.AutoSize: 
            thePictureBox.SizeMode = RasterPictureBoxSizeMode.CenterImage; 
            break; 
 
         case RasterPictureBoxSizeMode.CenterImage: 
            thePictureBox.SizeMode = RasterPictureBoxSizeMode.Normal; 
            break; 
      } 
 
      Text = string.Format("Size mode = {0}, double click to change", thePictureBox.SizeMode); 
 
      base.OnDoubleClick(e); 
   } 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
}

Imports Leadtools.WinForms 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.Drawing 
 
Public Sub RasterPictureBox_RasterPictureBox() 
   Dim form As MyForm1 = New MyForm1() 
   form.ShowDialog() 
End Sub 
 
Private Class MyForm1 : Inherits Form 
   Private thePictureBox As RasterPictureBox 
 
   Public Sub New() 
      ' Create the raster PictureBox 
      thePictureBox = New RasterPictureBox() 
      thePictureBox.Dock = DockStyle.Fill 
      thePictureBox.BorderStyle = BorderStyle.Fixed3D 
      thePictureBox.UseDpi = False 
 
      ' Set the paint properties 
      Dim p As RasterPaintProperties = New RasterPaintProperties() 
      p.PaintDisplayMode = RasterPaintDisplayModeFlags.Bicubic 
      p.PaintEngine = RasterPaintEngine.GdiPlus 
      p.UsePaintPalette = True 
      thePictureBox.PaintProperties = p 
 
      Controls.Add(thePictureBox) 
      thePictureBox.BringToFront() 
 
      ' load an image into the viewer 
      Dim codecs As RasterCodecs = New RasterCodecs() 
      thePictureBox.Image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "eye.gif")) 
      codecs.Dispose() 
 
      Text = String.Format("Size mode = {0}, double click to change", thePictureBox.SizeMode) 
 
      AddHandler thePictureBox.DoubleClick, AddressOf thePictureBox_DoubleClick 
   End Sub 
 
   Private Sub thePictureBox_DoubleClick(ByVal sender As Object, ByVal e As EventArgs) 
      Select Case thePictureBox.SizeMode 
         Case RasterPictureBoxSizeMode.Normal 
            thePictureBox.SizeMode = RasterPictureBoxSizeMode.StretchImage 
 
         Case RasterPictureBoxSizeMode.StretchImage 
            thePictureBox.SizeMode = RasterPictureBoxSizeMode.Fit 
 
         Case RasterPictureBoxSizeMode.Fit 
            thePictureBox.SizeMode = RasterPictureBoxSizeMode.AutoSize 
 
         Case RasterPictureBoxSizeMode.AutoSize 
            thePictureBox.SizeMode = RasterPictureBoxSizeMode.CenterImage 
 
         Case RasterPictureBoxSizeMode.CenterImage 
            thePictureBox.SizeMode = RasterPictureBoxSizeMode.Normal 
      End Select 
 
      Text = String.Format("Size mode = {0}, double click to change", thePictureBox.SizeMode) 
 
      MyBase.OnDoubleClick(e) 
   End Sub 
End Class 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class

Requirements

Target Platforms

Reference

RasterPictureBox Members

Leadtools.WinForms Namespace

Help Version 19.0.2017.10.27

Leadtools.WinForms Assembly

Introduction

Getting Started

Namespaces

Leadtools.WinForms Namespace

Assemblies