IXRImage::GetStretch (Windows Embedded CE 6.0)
1/6/2010
This method retrieves a value that describes how an image should be stretched to fill the destination rectangle.
Syntax
virtual HRESULT STDMETHODCALLTYPE GetStretch(
XRStretch* pStretch
) = 0;
Parameters
- pStretch
Pointer to an XRStretch enumerated type that specifies how the source image is rendered if the Height and Width of the IXRImage are both specified and different from the height and width of the source image.
Return Value
Returns an HRESULT that indicates success or failure.
Remarks
If pStretch specifies XRStretch_Fill, the image is stretched to completely fill the output area. When the output area and the image have different aspect ratios, the image is distorted by this kind of stretching. To make an IXRImage preserve the aspect ratio of the image, pStretch must be XRStretch_Uniform or XRStretch_UniformToFill.
Alternatively, you can decide not to set the Height and Width by not calling the inherited methods IXRFrameworkElement::SetHeight and IXRFrameworkElement::SetWidth, which will display the image source at its true resolution. However, this results in a loss of control over the element sizing in the source XAML for your application.
.NET Framework Equivalent
System.Windows.Controls.Image.Stretch
Requirements
| Header | XamlRuntime.h |
| sysgen | SYSGEN_XAML_RUNTIME |
| Windows Embedded CE | Windows Embedded CE 6.0 R3 |