Files
docs-desktop/dotnet-desktop-guide/framework/wpf/controls/how-to-crop-an-image.md
T
Andy De George da363692ff Initial WPF content migrated (#17)
* Reset branch for WPF changes

* Convert BMP to PNG; fix link-out-of-scope err

* Add snippets for WPF... 6794 files!!!!

* Add missing snippets

* update file updated between migration

* Fix paths to include

* update breadcrumb and toc

* fix index links

* fix index links

* fix index links

* fix markdown
2020-09-04 09:46:28 -07:00

2.5 KiB

title, ms.date, dev_langs, helpviewer_keywords, ms.assetid
title ms.date dev_langs helpviewer_keywords ms.assetid
How to: Crop an Image 03/30/2017
csharp
vb
images [WPF], cropping
cropping images [WPF]
c6bba109-c6e7-4cf8-bfe6-9cf8d01bb4fc

How to: Crop an Image

This example shows how to crop an image using xref:System.Windows.Media.Imaging.CroppedBitmap.

xref:System.Windows.Media.Imaging.CroppedBitmap is primarily used when encoding a cropped version of an image to save out to a file. To crop an image for display purposes see the How to: Create a Clip Region topic.

Example

The following [!INCLUDETLA#tla_xaml] defines resources used within the samples below.

[!code-xamlimageelementexample#CroppedXAML1]

The following example creates an image using a xref:System.Windows.Media.Imaging.CroppedBitmap as its source.

[!code-xamlimageelementexample#CroppedXAML2]

[!code-csharpimageelementexample#CroppedCSharp1] [!code-vbimageelementexample#CroppedCSharp1]

The xref:System.Windows.Media.Imaging.CroppedBitmap can also be used as the source of another xref:System.Windows.Media.Imaging.CroppedBitmap, chaining the cropping. Note that the xref:System.Windows.Media.Imaging.CroppedBitmap.SourceRect%2A uses values that are relative to the source cropped bitmap and not the initial image.

[!code-xamlimageelementexample#CroppedXAML3]

[!code-csharpimageelementexample#CroppedCSharp2] [!code-vbimageelementexample#CroppedCSharp2]

See also