更新：2007 年 11 月

命名空间：  System.Windows.Media.Imaging
程序集：  PresentationCore（在 PresentationCore.dll 中）

CroppedBitmap 实现 ISupportInitialize 接口，以对多个属性的初始化进行优化。只能在对象初始化过程中对属性进行更改。调用 BeginInit 以表示初始化开始；调用 EndInit 以表示初始化结束。初始化后，将忽略属性更改。

使用 CroppedBitmap(BitmapSource, Int32Rect) 构造函数创建的 CroppedBitmap 对象将自动初始化，且属性无法更改。

如果在应用转换后将图像保存到文件，则必须更新与图像数据相关的元数据标记。

使用此类的 SourceRect 属性定义要裁剪的位图区域。

// Create an Image element.
Image croppedImage = new Image();
croppedImage.Width = 200;
croppedImage.Margin = new Thickness(5);

// Create a CroppedBitmap based off of a xaml defined resource.
CroppedBitmap cb = new CroppedBitmap(     
   (BitmapSource)this.Resources["masterImage"],
   new Int32Rect(30, 20, 105, 50));       //select region rect
croppedImage.Source = cb;                 //set image source to cropped

CroppedBitmap 还可以用作另一个 CroppedBitmap 的源，从而链接裁剪内容。请注意，SourceRect 使用相对于源裁剪位图的值，而不是使用相对于初始图像的值。