Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

DrawingGroup.ClipGeometry-Eigenschaft

Aktualisiert: November 2007

Ruft den Ausschneidebereich der DrawingGroup ab oder legt diesen fest. Dies ist eine Abhängigkeitseigenschaft.

Namespace:  System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

public Geometry ClipGeometry { get; set; }
/** @property */
public Geometry get_ClipGeometry()
/** @property */
public  void set_ClipGeometry(Geometry value)

public function get ClipGeometry () : Geometry
public function set ClipGeometry (value : Geometry)
Informationen zu XAML finden Sie im Geometry-Typ.

Eigenschaftenwert

Typ: System.Windows.Media.Geometry
Die Geometry, mit der die DrawingGroup ausgeschnitten wird. Der Standardwert ist null.

Bezeichnerfeld

ClipGeometryProperty

Auf true festgelegte Metadateneigenschaften

Keine

Zeichnungen außerhalb der Geometrie werden von der DrawingGroup abgeschnitten, wenn sie gerendert wird. Die Geometrie muss nicht rechteckig sein. Beispielsweise können Sie eine EllipseGeometry verwenden, um eine elliptische Form auszuschneiden.

DrawingGroup-Operationen werden in folgender Reihenfolge angewendet:

  1. OpacityMask

  2. Opacity

  3. BitmapEffect

  4. ClipGeometry

  5. GuidelineSet

  6. Transform

In diesem Beispiel wird das Definieren eines Clip-Bereichs für eine Drawing dargestellt.

Verwenden Sie eine DrawingGroup, um einen Clip-Bereich für ein Drawing zu definieren. Die DrawingGroup-Klasse ist der einzige Drawing-Objekttyp, mit dem Sie einen eigenen Clip-Bereich definieren können.

Verwenden Sie zur Beschreibung des Clip-Bereichs eine Geometry, und wenden Sie diese auf die ClipGeometry-Eigenschaft des DrawingGroup-Objekts an.

In der Abbildung wird die DrawingGroup vor und nach der Anwendung des elliptischen Clip-Bereichs dargestellt.

DrawingGroup mit einem definierten Clip-Bereich

Im folgenden Beispiel wird mithilfe einer DrawingGroup eine ClipGeometry auf mehrere GeometryDrawing-Objekte angewendet.

<Page 
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:PresentationOptions="http://schemas.microsoft.com/winfx/2006/xaml/presentation/options" 
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  mc:Ignorable="PresentationOptions"
  Background="White" Margin="20">

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

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

              <DrawingGroup.ClipGeometry>
                <EllipseGeometry Center="25,50" RadiusX="25" RadiusY="50" />
              </DrawingGroup.ClipGeometry>
            </DrawingGroup>
          </DrawingImage.Drawing>
        </DrawingImage>
      </Image.Source>
    </Image>
  </Border>


</Page>


Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0
Anzeigen: