Visual Basic (Declaration) | |
---|---|
Public Event LoadImage As EventHandler(Of CodecsLoadImageEventArgs) |
Visual Basic (Usage) | Copy Code |
---|---|
Dim instance As RasterCodecs Dim handler As EventHandler(Of CodecsLoadImageEventArgs) AddHandler instance.LoadImage, handler |
C# | |
---|---|
public event EventHandler<CodecsLoadImageEventArgs> LoadImage |
C++/CLI | |
---|---|
public: event EventHandler<CodecsLoadImageEventArgs^>^ LoadImage |
The event handler receives an argument of type CodecsLoadImageEventArgs containing data related to this event. The following CodecsLoadImageEventArgs properties provide information specific to this event.
Property | Description |
---|---|
Buffer | Gets the memory buffer containing one or more lines of output image data. |
Cancel | Gets or sets a value which allows the user to abort the load process. |
FileName | Gets the name of the file currently being loaded. |
FirstPage | Gets the index of the first page being loaded. |
Flags | Gets a value which describes whether this is the first or last call of the event, and whether the buffer contains first or last row of image data. |
Image | Gets the Leadtools.RasterImage object into which the image data is being loaded. |
ImagePage | Gets the index of the RasterImage.Page into which the image data is being loaded. |
Info | Gets a CodecsImageInfo object that contains information about the image file being loaded. |
LastPage | Gets the index of the last page being loaded. |
Lines | Gets the number of lines in Buffer. |
Offset | Gets the offset in bytes from the beginning of the file at which the image data begins. |
OffsetCount | Gets the number of bytes that make up the actual image data being loaded. |
OffsetValid | Determines whether the Offset property is valid. |
Page | Gets the index of the page currently being loaded. |
PagePercent | Gets the load completion percentage of the current page. |
Row | Gets the current image row number of the first line in Buffer. |
Stream | Gets the Stream associated with the file load process. |
Tile | Gets the rectangular area of the image being loaded. |
TileValid | Determines whether the Tile property is valid. |
TotalPercent | Gets the overall completion percentage for the load operation. |
Visual Basic | Copy Code |
---|---|
Private Sub Codecs_LoadImage(ByVal sender As Object, ByVal e As CodecsLoadImageEventArgs) e.Cancel = True ' get all properties for the CodecsLoadImageEventArgs class. Console.WriteLine("File name is: {0}", e.FileName) Console.WriteLine("The Image width and height is: {0},{1}", e.Image.Width, e.Image.Height) Console.WriteLine("The Length of the buffer is: {0}", e.Buffer.Length) Console.WriteLine("The current row in the first line of the buffer is: {0}", e.Row) If e.OffsetValid Then Console.WriteLine("Offset count is : {0}", e.OffsetCount) Console.WriteLine("Offset value is : {0}", e.Offset) End If If e.TileValid Then Dim rect As LeadRect = e.Tile Console.WriteLine("Tile Dimension ({0},{1},{2},{3)}", rect.X, rect.Y, rect.Width, rect.Height) End If Console.WriteLine("Image p number: {0}", e.ImagePage) Console.WriteLine("First page number: {0}", e.FirstPage) Console.WriteLine("Current page number: {0}", e.Page) Console.WriteLine("Last page number: {0}", e.LastPage) Console.WriteLine("Page percent: {0}%", e.PagePercent) Console.WriteLine("Total percent: {0}%", e.TotalPercent) Console.WriteLine("Flags = {0}", e.Flags) Dim loadStream As System.IO.Stream = e.Stream Dim info As CodecsImageInfo = e.Info e.Cancel = False End Sub Public Sub LoadImageExample() Dim codecs As RasterCodecs = New RasterCodecs() AddHandler codecs.LoadImage, AddressOf Codecs_LoadImage Dim image As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp")) RemoveHandler codecs.LoadImage, AddressOf Codecs_LoadImage ' Clean up codecs.Dispose() image.Dispose() End Sub Public NotInheritable Class LEAD_VARS Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" End Class |
C# | Copy Code |
---|---|
private void Codecs_LoadImage(object sender, CodecsLoadImageEventArgs e) { e.Cancel = true; // get all properties for the CodecsLoadImageEventArgs class. Console.WriteLine("File name is: {0}", e.FileName); Console.WriteLine("The Image width and height is: {0},{1}", e.Image.Width, e.Image.Height); Console.WriteLine("The Length of the buffer is: {0}", e.Buffer.Length); Console.WriteLine("The current row in the first line of the buffer is: {0}", e.Row); if(e.OffsetValid) { Console.WriteLine("Offset count is : {0}", e.OffsetCount); Console.WriteLine("Offset value is : {0}", e.Offset); } if(e.TileValid) { LeadRect rect = e.Tile; Console.WriteLine("Tile Dimension ({0},{1},{2},{3)}", rect.X, rect.Y, rect.Width, rect.Height); } Console.WriteLine("Image p number: {0}", e.ImagePage); Console.WriteLine("First page number: {0}", e.FirstPage); Console.WriteLine("Current page number: {0}", e.Page); Console.WriteLine("Last page number: {0}", e.LastPage); Console.WriteLine("Page percent: {0}%", e.PagePercent); Console.WriteLine("Total percent: {0}%", e.TotalPercent); Console.WriteLine("Flags = {0}", e.Flags); System.IO.Stream loadStream = e.Stream; CodecsImageInfo info = e.Info; e.Cancel = false; } public void LoadImageExample() { RasterCodecs codecs = new RasterCodecs(); codecs.LoadImage += new EventHandler<CodecsLoadImageEventArgs>(Codecs_LoadImage); RasterImage image = codecs.Load( Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp")); codecs.LoadImage -= new EventHandler<CodecsLoadImageEventArgs>(Codecs_LoadImage); // Clean up codecs.Dispose(); image.Dispose(); } static class LEAD_VARS { public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; } |
SilverlightCSharp | Copy Code |
---|---|
private void Codecs_LoadImage(object sender, CodecsLoadImageEventArgs e) { e.Cancel = true; if (e.Buffer.Length != 0) { // get all properties for the CodecsLoadImageEventArgs class. Debug.WriteLine("File name is: {0}", e.FileName); Debug.WriteLine("The Image width and height is: {0},{1}", e.Image.Width, e.Image.Height); Debug.WriteLine("The Length of the buffer is: {0}", e.Buffer.Length); Debug.WriteLine("The current row in the first line of the buffer is: {0}", e.Row); if(e.TileValid) { LeadRect rect = e.Tile; Debug.WriteLine("Tile Dimension ({0},{1},{2},{3)}", rect.X, rect.Y, rect.Width, rect.Height); } Debug.WriteLine("Page Index is: {0}", e.Page); Debug.WriteLine("Page Count is: {0}", e.LastPage); Debug.WriteLine("Image Page Index is: {0}", e.ImagePage); Debug.WriteLine("Flags = {0}", e.Flags); System.IO.Stream loadStream = e.Stream; CodecsImageInfo info = e.Info; e.Cancel = false; } } public void LoadImageExample(Stream inStream) { RasterCodecs codecs = new RasterCodecs(); codecs.LoadImage += new EventHandler<CodecsLoadImageEventArgs>(Codecs_LoadImage); RasterImage image = codecs.Load(inStream); codecs.LoadImage -= new EventHandler<CodecsLoadImageEventArgs>(Codecs_LoadImage); // Clean up image.Dispose(); } |
SilverlightVB | Copy Code |
---|---|
Private Sub Codecs_LoadImage(ByVal sender As Object, ByVal e As CodecsLoadImageEventArgs) e.Cancel = True If e.Buffer.Length <> 0 Then ' get all properties for the CodecsLoadImageEventArgs class. Debug.WriteLine("File name is: {0}", e.FileName) Debug.WriteLine("The Image width and height is: {0},{1}", e.Image.Width, e.Image.Height) Debug.WriteLine("The Length of the buffer is: {0}", e.Buffer.Length) Debug.WriteLine("The current row in the first line of the buffer is: {0}", e.Row) If e.TileValid Then Dim rect As LeadRect = e.Tile Debug.WriteLine("Tile Dimension ({0},{1},{2},{3)}", rect.X, rect.Y, rect.Width, rect.Height) End If Debug.WriteLine("Page Index is: {0}", e.Page) Debug.WriteLine("Page Count is: {0}", e.LastPage) Debug.WriteLine("Image Page Index is: {0}", e.ImagePage) Debug.WriteLine("Flags = {0}", e.Flags) Dim loadStream As System.IO.Stream = e.Stream Dim info As CodecsImageInfo = e.Info e.Cancel = False End If End Sub Public Sub LoadImageExample(ByVal inStream As Stream) Dim codecs As RasterCodecs = New RasterCodecs() AddHandler codecs.LoadImage, AddressOf Codecs_LoadImage Dim image As RasterImage = codecs.Load(inStream) RemoveHandler codecs.LoadImage, AddressOf Codecs_LoadImage ' Clean up image.Dispose() End Sub |
This event will fire during loading images with the RasterCodecs.Load and RasterCodecs.LoadAsync methods. You can use this event to get information about the image being loaded, manually handle the image scanline data or provide a progress status as well as to abort the load operation.
Target Platforms: Silverlight, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)