AspectRatioCorrection Property (ImageBox)

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public double AspectRatioCorrection {get; set;}

'Declaration
 
Public Property AspectRatioCorrection As Double

'Usage
 
Dim instance As ImageBox
Dim value As Double
 
instance.AspectRatioCorrection = value
 
value = instance.AspectRatioCorrection

public double AspectRatioCorrection {get; set;}

 get_AspectRatioCorrection();
 set_AspectRatioCorrection(value);

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.

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.

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

Copy 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

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);
}

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);
}

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>

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ImageBox Class
ImageBox Members