DrawingGroup.ClipGeometry 屬性


取得或設定這個 DrawingGroup 的裁剪區域。Gets or sets the clip region of this DrawingGroup.

 property System::Windows::Media::Geometry ^ ClipGeometry { System::Windows::Media::Geometry ^ get(); void set(System::Windows::Media::Geometry ^ value); };
public System.Windows.Media.Geometry ClipGeometry { get; set; }
member this.ClipGeometry : System.Windows.Media.Geometry with get, set
Public Property ClipGeometry As Geometry



用來裁剪這個 GeometryDrawingGroupThe Geometry that is used to clip this DrawingGroup. 預設為 nullThe default is null.


這個範例會示範如何定義的裁剪區域 DrawingThis example shows how to define a clip region for a Drawing.

使用 DrawingGroup 定義的剪輯 DrawingUse a DrawingGroup to define a clip for a Drawing. DrawingGroup類別是唯一可 Drawing 讓您定義自己的剪輯區域的物件類型。The DrawingGroup class is the only type of Drawing object that enables you to define your own clip region.

使用 Geometry 來描述剪輯,並將其套用至 ClipGeometry 物件的屬性 DrawingGroupUse a Geometry to describe the clip and apply it to the ClipGeometry property of the DrawingGroup object.

下圖顯示套用 DrawingGroup 橢圓形剪輯之前和之後。The illustration shows the DrawingGroup before and after the elliptical clip is applied.

具有已定義之裁剪區域的 DrawingGroupDrawingGroup with a defined clip region

下列範例會使用 DrawingGroup 來將套用 ClipGeometry 至數個 GeometryDrawing 物件。The following example uses a DrawingGroup to apply a ClipGeometry to several GeometryDrawing objects.

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Media.Animation;
using System.Windows.Shapes;

namespace SDKSample
    /// <summary>
    /// Shows how to define a clip region for a DrawingGroup.
    /// </summary>
    public class ClipExample : Page
        public ClipExample()

            // Create several GeometryDrawing objects.

            // Create a rectangle.
            GeometryDrawing drawing1 = new GeometryDrawing(
                new RectangleGeometry(new Rect(0,0,50,85))

            // Create a polygon.
            PathFigure pLineFigure = new PathFigure();
            pLineFigure.StartPoint = new Point(25, 25);
            PolyLineSegment pLineSegment = new PolyLineSegment();
            pLineSegment.Points.Add(new Point(0, 50));
            pLineSegment.Points.Add(new Point(25, 75));
            pLineSegment.Points.Add(new Point(50, 50));
            pLineSegment.Points.Add(new Point(25, 25));
            pLineSegment.Points.Add(new Point(25, 0));
            PathGeometry pGeometry = new PathGeometry();

            GeometryDrawing drawing2 = new GeometryDrawing(
                    new Pen(Brushes.Black, 10),

            // Create a circle.
            GeometryDrawing drawing3 = new GeometryDrawing(
                    new Pen(Brushes.Black, 2),
                    new EllipseGeometry(new Point(10, 10), 5, 5)

            // Create the DrawingGroup and add the
            // geometry drawings.
            DrawingGroup aDrawingGroup = new DrawingGroup();

            // Create an EllipseGeometry and use it to
            // clip the DrawingGroup.
            EllipseGeometry clipGeometry = 
                new EllipseGeometry(new Point(25,50), 25, 50);
            aDrawingGroup.ClipGeometry = clipGeometry;

            // Use an Image control and a DrawingImage to
            // display the drawing.
            DrawingImage aDrawingImage = new DrawingImage(aDrawingGroup);

            // Freeze the DrawingImage for performance benefits.

            Image anImage = new Image();
            anImage.Source = aDrawingImage;
            anImage.Stretch = Stretch.None;
            anImage.HorizontalAlignment = HorizontalAlignment.Left;

            // Create a border around the images and add it to the
            // page.
            Border imageBorder = new Border();
            imageBorder.BorderBrush = Brushes.Gray;
            imageBorder.BorderThickness = new Thickness(1);
            imageBorder.VerticalAlignment = VerticalAlignment.Top;
            imageBorder.HorizontalAlignment = HorizontalAlignment.Left;
            imageBorder.Margin = new Thickness(20);
            imageBorder.Child = anImage;

            this.Background = Brushes.White;
            this.Margin = new Thickness(20);
            this.Content = imageBorder;

  Background="White" Margin="20">

  <Border BorderBrush="Gray" BorderThickness="1" 
    HorizontalAlignment="Left" VerticalAlignment="Top"
    <Image Stretch="None" HorizontalAlignment="Left">
        <DrawingImage PresentationOptions:Freeze="True">

            <!-- A DrawingGeometry with an elliptical clip region. -->
              <GeometryDrawing Brush="Pink">
                  <RectangleGeometry Rect="0,0,50,85" />
              <GeometryDrawing Brush="Lime" 
                Geometry="M 25,25 L 0,50 25,75 50,50 25,25 25,0">
                  <Pen Thickness="10" Brush="Black" />
              <GeometryDrawing Brush="Lime">
                  <EllipseGeometry Center="10,10" RadiusX="5" RadiusY="5" />
                  <Pen Thickness="2" Brush="Black" />

                <EllipseGeometry Center="25,50" RadiusX="25" RadiusY="50" />



幾何外的繪圖會在 DrawingGroup 呈現時裁剪。Drawings outside the geometry are clipped from the DrawingGroup when it is rendered. 幾何不需要是矩形;例如,您可以使用 EllipseGeometry 來剪輯至橢圓圖形。The geometry does not have to be rectangular; for example, you can use an EllipseGeometry to clip to an elliptical shape.

DrawingGroup 作業會依下列順序套用:DrawingGroup operations are applied in the following order:

  1. OpacityMask

  2. Opacity

  3. BitmapEffect

  4. ClipGeometry

  5. GuidelineSet

  6. Transform

相依性屬性資訊Dependency Property Information

識別碼欄位Identifier field ClipGeometryProperty
中繼資料屬性設定為 trueMetadata properties set to true None