RasterPictureBox Class

Summary

Represents a LEADTOOLS PictureBox control for displaying an image.

Syntax

C++

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

<DefaultEventAttribute("FrameChanged"),  
 DockingAttribute(System.Windows.Forms.DockingBehavior),  
 DefaultPropertyAttribute("Image")>  
Public Class RasterPictureBox 
   Inherits System.Windows.Forms.Control

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

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 RasterImage object to be displayed.

The RasterPictureBox control can automatically animate Multi-Page file formats.

Example

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

Imports Leadtools 
Imports Leadtools.Controls 
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 pictureBoxInstance As RasterPictureBox 
 
   Public Sub New() 
      ' Create the raster PictureBox 
      pictureBoxInstance = New RasterPictureBox() 
      pictureBoxInstance.Dock = DockStyle.Fill 
      pictureBoxInstance.BorderStyle = BorderStyle.FixedSingle 
      pictureBoxInstance.UseDpi = False 
 
      ' Set the paint properties 
      Dim paintProperties As RasterPaintProperties = RasterPaintProperties.Default 
      paintProperties.PaintDisplayMode = RasterPaintDisplayModeFlags.Bicubic 
      paintProperties.PaintEngine = RasterPaintEngine.GdiPlus 
      paintProperties.UsePaintPalette = True 
      pictureBoxInstance.PaintProperties = paintProperties 
 
      Me.Controls.Add(pictureBoxInstance) 
      pictureBoxInstance.BringToFront() 
 
      ' load an image into the viewer 
      Using codecs As RasterCodecs = New RasterCodecs() 
         pictureBoxInstance.Image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "eye.gif")) 
      End Using 
 
 
      Text = String.Format("Size mode = {0}, double click to change", pictureBoxInstance.SizeMode) 
 
      AddHandler pictureBoxInstance.DoubleClick, AddressOf pictureBoxInstance_DoubleClick 
   End Sub 
 
   Private Sub pictureBoxInstance_DoubleClick(ByVal sender As Object, ByVal e As EventArgs) 
      Select Case pictureBoxInstance.SizeMode 
         Case RasterPictureBoxSizeMode.Normal 
            pictureBoxInstance.SizeMode = RasterPictureBoxSizeMode.StretchImage 
 
         Case RasterPictureBoxSizeMode.StretchImage 
            pictureBoxInstance.SizeMode = RasterPictureBoxSizeMode.Fit 
 
         Case RasterPictureBoxSizeMode.Fit 
            pictureBoxInstance.SizeMode = RasterPictureBoxSizeMode.AutoSize 
 
         Case RasterPictureBoxSizeMode.AutoSize 
            pictureBoxInstance.SizeMode = RasterPictureBoxSizeMode.CenterImage 
 
         Case RasterPictureBoxSizeMode.CenterImage 
            pictureBoxInstance.SizeMode = RasterPictureBoxSizeMode.Normal 
      End Select 
 
      Text = String.Format("Size mode = {0}, double click to change", pictureBoxInstance.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.Controls Namespace

Download our FREE evaluation

Help Version 20.0.2020.4.3

Leadtools.Controls Assembly

Introduction

Getting Started

Namespaces

Leadtools.Controls Namespace

Assemblies