In This Topic ▼

RasterPictureBox Class

Summary

Represents a LEADTOOLS PictureBox control for displaying an image.

Syntax

C++/CLI

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

public: 
   [DefaultPropertyAttribute(L"Image"),  
   DockingAttribute(System::Windows::Forms::DockingBehavior),  
   DefaultEventAttribute(L"FrameChanged")] 
   ref class RasterPictureBox : 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 Leadtools.RasterImage object to be displayed. The RasterPictureBox control can automatically animate multipage 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:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms