←Select platform

AspectRatioCorrection Property (ImageBox)

Summary

Gets or sets the manual aspect ratio correction value. This is a dependency property.

Syntax

C++

public double AspectRatioCorrection {get; set;}

Public Property AspectRatioCorrection As Double

public: 
property double AspectRatioCorrection { 
   double get(); 
   void set (    double ); 
}

Property Value

The manual aspect ratio correction value used when displaying the image. The value is multiplied by the current vertical scale factor. Default value is 1.0.

Remarks

When displaying images, sometimes it is desired to set a manual aspect ratio correction to compensate for irregular screen resolution (pixel size) for example. For example, if you display an image that is 100 by 100 pixels on most monitors, the image will not be an exact square on screen because most monitors have pixels that are rectangular in shape. Setting the AspectRatioCorrection value can fix this issue.

The AspectRatioCorrection is multiplied by the current vertical scale factor of the control CurrentYScaleFactor at all times regardless of the ScaleFactor and SizeMode values.

Example

Silverlight C#

Silverlight VB

Imports Leadtools.Windows.Controls 
 
Public Sub ImageBox_PhysicalSize(ByVal viewer As ImageBox) 
    viewer.AspectRatioCorrection = 2 
    ' The image height will be multiplied by 2. 
    Dim s As String = String.Format("Physical Size : {0}", viewer.PhysicalSize.ToString()) 
    MessageBox.Show(s) 
End Sub

using Leadtools.Help; 
using Leadtools.Windows.Controls; 
 
public void ImageBox_PhysicalSize(ImageBox viewer) 
{ 
   viewer.AspectRatioCorrection = 2; 
   // The image height will be multiplied by 2. 
   string s = string.Format("Physical Size : {0}", viewer.PhysicalSize.ToString()); 
   MessageBox.Show(s); 
}

using Leadtools.Help; 
using Leadtools.Windows.Controls; 
 
public void ImageBox_PhysicalSize(ImageBox viewer) 
{ 
   viewer.AspectRatioCorrection = 2; 
   // The image height will be multiplied by 2. 
   string s = string.Format("Physical Size : {0}", viewer.PhysicalSize.ToString()); 
   MessageBox.Show(s); 
}

Imports Leadtools.Windows.Controls 
 
Public Sub ImageBox_PhysicalSize(ByVal viewer As ImageBox) 
   viewer.AspectRatioCorrection = 2 
   ' The image height will be multiplied by 2. 
   Dim s As String = String.Format("Physical Size : {0}", viewer.PhysicalSize.ToString()) 
   MessageBox.Show(s) 
End Sub

<Window x:Class="WPFSamples.ImageBox" 
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:Leadtools_Windows_Controls="clr-namespace:Leadtools.Windows.Controls;assembly=Leadtools.Windows.Controls" 
Height="600" Width="800"> 
  <DockPanel> 
    <Leadtools_Windows_Controls:ImageBox 
        Name="theImage" 
      Source="file:///c:\users\Public\Documents\LEADTOOLS Images\cannon.jpg" 
      DockPanel.Dock= "Bottom" 
      HorizontalAlignment="Center" VerticalAlignment="Bottom" AspectRatioCorrection="2"> 
 
    </Leadtools_Windows_Controls:ImageBox > 
  </DockPanel> 
  <Window.Title> 
    "Apply a effect" 
  </Window.Title> 
</Window>