CreateTransform Method

Summary

Helper method to create the transformation matrix used to redirect the rendering of the ImageViewer.

Syntax

C++

public void CreateTransform( 
   ImageViewer imageViewer, 
   LeadRect destinationRect, 
   LeadRectD sourceRect, 
   ControlSizeMode sizeMode, 
   ControlAlignment horizontalAlignment, 
   ControlAlignment verticalAlignment 
)

Public Sub CreateTransform( 
   ByVal imageViewer As ImageViewer, 
   ByVal destinationRect As LeadRect, 
   ByVal sourceRect As LeadRectD, 
   ByVal sizeMode As ControlSizeMode, 
   ByVal horizontalAlignment As ControlAlignment, 
   ByVal verticalAlignment As ControlAlignment 
)

public:  
   void CreateTransform( 
       ImageViewer^ imageViewer, 
      LeadRect^ destinationRect, 
      LeadRectD^ sourceRect, 
      ControlSizeMode^ sizeMode, 
      ControlAlignment^ horizontalAlignment, 
      ControlAlignment^ verticalAlignment 
   )

Parameters

imageViewer

The image viewer instance that will be used as the source of RenderRedirect. This value

cannot be null.

destinationRect

Destination rectangle to use. For example, the client area of the external control.

sourceRect

The source rectangle into the current view of imageViewer. Pass Empty to render

the whole view.

sizeMode

Controls how the source rectangle is positioned and scaled inside the destination rectangle.

horizontalAlignment

Controls how the source rectangle is aligned horizontally inside the destination rectangle.

verticalAlignment

Controls how the source rectangle is aligned vertically inside the destination rectangle.

Remarks

This method will set the transformation matrix into Transform.

Use this method CreateTransform can be used to easily create a transformation matrix for common scenarios such as rendering a thumbnail of the content of the viewer.

For more information, refer to Image Viewer Rendering.

Example

For an example, refer to RenderRedirect.

Requirements

Target Platforms