LEADTOOLS WPF and Silverlight (Leadtools.Windows.Controls assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.30
AspectRatioCorrection Property
See Also 
Leadtools.Windows.Controls Namespace > ImageBox Class : AspectRatioCorrection Property



Gets or sets the manual aspect ratio correction value. This is a dependency property. Supported in Silverlight, Windows Phone 7

Syntax

Visual Basic (Declaration) 
Public Property AspectRatioCorrection As Double
Visual Basic (Usage)Copy Code
Dim instance As ImageBox
Dim value As Double
 
instance.AspectRatioCorrection = value
 
value = instance.AspectRatioCorrection
C# 
public double AspectRatioCorrection {get; set;}
C++/CLI 
public:
property double AspectRatioCorrection {
   double get();
   void set (    double value);
}

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.

Example

Visual BasicCopy Code
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
C#Copy Code
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);
}
SilverlightCSharpCopy Code
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);
}
SilverlightVBCopy Code
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
XAMLCopy Code
<Window x:Class="WPFSamples.ImageBox" Height="600" Width="800" 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">
  <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>

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.

Requirements

Target Platforms: Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family

See Also