CreateCanvas Method

Helper method to create a printable System.Windows.Controls.Canvas from an Leadtools.Windows.Controls.ImageBox, Leadtools.Windows.Controls.RasterImageBox, Leadtools.Windows.Controls.ImageViewer or Leadtools.Windows.Controls.RasterImageViewer control.

Syntax

Visual Basic
C#
Objective-C
Java
C++

public virtual Canvas CreateCanvas( 
   UIElement element,
   PrintPageEventArgs args
)

'Declaration
 
Public Overridable Function CreateCanvas( _
   ByVal element As UIElement, _
   ByVal args As PrintPageEventArgs _
) As Canvas

'Usage
 
Dim instance As PrinterHelper
Dim element As UIElement
Dim args As PrintPageEventArgs
Dim value As Canvas
 
value = instance.CreateCanvas(element, args)

public:
virtual Canvas^ CreateCanvas( 
   UIElement^ element,
   PrintPageEventArgs^ args
)

Parameters

element: A System.Windows.UIElement that contains the Leadtools.Windows.Controls.ImageBox, Leadtools.Windows.Controls.RasterImageBox, Leadtools.Windows.Controls.ImageViewer or Leadtools.Windows.Controls.RasterImageViewer control to print.
args: Print arguments.

Return Value

A System.Windows.Controls.Canvas that can be used with printing.

Remarks

The PrinterHelper.CreateCanvas method can be used to create the System.Windows.UIElement to use as the visual paramater to the WPF PrintDialog.PrintVisual when using the System.Windows.Controls.PrintDialog class.

This method can also be used to create the System.Windows.UIElement to use as the Silverlight 4.0 and later PrintPageEventArgs.PageVisual property used when printing using the Silverlight 4.0 and later PrintDocument class.

Example

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

Imports Leadtools.Windows.Controls
Imports Leadtools.Windows.Printing

Public Sub PrintViewerCanvasExample(ByVal viewer As ImageViewer)
   Dim dlg As New PrintDialog()
   If dlg.ShowDialog() = True Then
      ' Create the Visual from the viewer
      Dim ph As New PrinterHelper()
      ph.Destination = New Rect(0, 0, 1, 1)
      ph.IsDestinationRelative = True
      ph.HorizontalAlignment = HorizontalAlignment.Center
      ph.VerticalAlignment = VerticalAlignment.Center
      ph.ImageStretch = Stretch.UniformToFill
      Dim args As New PrintPageEventArgs(New Thickness(), New Size(dlg.PrintableAreaWidth, dlg.PrintableAreaHeight))
      Dim visual As Visual = ph.CreateCanvas(viewer, args)
      dlg.PrintVisual(visual, "My Document")
   End If
End Sub

using Leadtools.Windows.Controls;
using Leadtools.Windows.Printing;

public void PrintViewerCanvasExample(ImageViewer viewer)
{
   PrintDialog dlg = new PrintDialog();
   if(dlg.ShowDialog() == true)
   {
      // Create the Visual from the viewer
      PrinterHelper ph = new PrinterHelper();
      ph.Destination = new Rect(0, 0, 1, 1);
      ph.IsDestinationRelative = true;
      ph.HorizontalAlignment = HorizontalAlignment.Center;
      ph.VerticalAlignment = VerticalAlignment.Center;
      ph.ImageStretch = Stretch.UniformToFill;
      PrintPageEventArgs args = new PrintPageEventArgs(new Thickness(), new Size(dlg.PrintableAreaWidth, dlg.PrintableAreaHeight));
      Visual visual = ph.CreateCanvas(viewer, args);
      dlg.PrintVisual(visual, "My Document");
   }
}

Requirements

Target Platforms

Reference

PrinterHelper Class
PrinterHelper Members