DrawingContext Sınıf

Tanım

Ad Alanı:

System.Windows.Media

Bütünleştirilmiş Kod:

PresentationCore.dll

Çizim, gönderme ve pop komutlarını kullanarak görsel içeriği açıklar.

public ref class DrawingContext abstract : System::Windows::Threading::DispatcherObject, IDisposable

public abstract class DrawingContext : System.Windows.Threading.DispatcherObject, IDisposable

type DrawingContext = class
    inherit DispatcherObject
    interface IDisposable

Public MustInherit Class DrawingContext
Inherits DispatcherObject
Implements IDisposable

Devralma

Object

DispatcherObject

DrawingContext

Uygulamalar

IDisposable

Örnekler

Aşağıdaki örnekten bir DrawingContext alır ve bunu dikdörtgen çizmek için kullanır.

// Create a DrawingVisual that contains a rectangle.
private DrawingVisual CreateDrawingVisualRectangle()
{
    DrawingVisual drawingVisual = new DrawingVisual();

    // Retrieve the DrawingContext in order to create new drawing content.
    DrawingContext drawingContext = drawingVisual.RenderOpen();

    // Create a rectangle and draw it in the DrawingContext.
    Rect rect = new Rect(new System.Windows.Point(160, 100), new System.Windows.Size(320, 80));
    drawingContext.DrawRectangle(System.Windows.Media.Brushes.LightBlue, (System.Windows.Media.Pen)null, rect);

    // Persist the drawing content.
    drawingContext.Close();

    return drawingVisual;
}

' Create a DrawingVisual that contains a rectangle.
Private Function CreateDrawingVisualRectangle() As DrawingVisual
    Dim drawingVisual As New DrawingVisual()

    ' Retrieve the DrawingContext in order to create new drawing content.
    Dim drawingContext As DrawingContext = drawingVisual.RenderOpen()

    ' Create a rectangle and draw it in the DrawingContext.
    Dim rect As New Rect(New Point(160, 100), New Size(320, 80))
    drawingContext.DrawRectangle(Brushes.LightBlue, CType(Nothing, Pen), rect)

    ' Persist the drawing content.
    drawingContext.Close()

    Return drawingVisual
End Function

Sonraki örnekte komutu gösterilmektedir PushOpacity . DrawingContext bir'den DrawingGroup alınır ve bir Image denetim kullanılarak görüntülenir.

using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Media.Effects;

namespace SDKSample
{

    public class PushEffectExample : Page
    {

        public PushEffectExample()
        {
            Pen shapeOutlinePen = new Pen(Brushes.Black, 2);
            shapeOutlinePen.Freeze();

            // Create a DrawingGroup
            DrawingGroup dGroup = new DrawingGroup();

            // Obtain a DrawingContext from 
            // the DrawingGroup.
            using (DrawingContext dc = dGroup.Open())
            {
                // Draw a rectangle at full opacity.
                dc.DrawRectangle(Brushes.Blue, shapeOutlinePen, new Rect(0, 0, 25, 25));

                // Push an opacity change of 0.5. 
                // The opacity of each subsequent drawing will
                // will be multiplied by 0.5.
                dc.PushOpacity(0.5);

                // This rectangle is drawn at 50% opacity.
                dc.DrawRectangle(Brushes.Blue, shapeOutlinePen, new Rect(25, 25, 25, 25));
            }

            // Display the drawing using an image control.
            Image theImage = new Image();
            DrawingImage dImageSource = new DrawingImage(dGroup);
            theImage.Source = dImageSource;

            this.Content = theImage;
        }
    }
}

Imports System.Windows.Media.Animation
Imports System.Windows.Media.Effects

Namespace SDKSample

    Public Class PushEffectExample
        Inherits Page

        Public Sub New()
            Dim shapeOutlinePen As New Pen(Brushes.Black, 2)
            shapeOutlinePen.Freeze()

            ' Create a DrawingGroup
            Dim dGroup As New DrawingGroup()

            ' Obtain a DrawingContext from
            ' the DrawingGroup.
            Using dc As DrawingContext = dGroup.Open()
                ' Draw a rectangle at full opacity.
                dc.DrawRectangle(Brushes.Blue, shapeOutlinePen, New Rect(0, 0, 25, 25))

                ' Push an opacity change of 0.5.
                ' The opacity of each subsequent drawing will
                ' will be multiplied by 0.5.
                dc.PushOpacity(0.5)

                ' This rectangle is drawn at 50% opacity.
                dc.DrawRectangle(Brushes.Blue, shapeOutlinePen, New Rect(25, 25, 25, 25))
            End Using

            ' Display the drawing using an image control.
            Dim theImage As New Image()
            Dim dImageSource As New DrawingImage(dGroup)
            theImage.Source = dImageSource

            Me.Content = theImage

        End Sub

    End Class

End Namespace

Açıklamalar

DrawingContext veya görsel içerikle doldurmak Visual için a Drawing kullanın.

Çizim yöntemleri türün DrawingContext çizim yöntemlerine System.Drawing.Graphics benzer görünse de, çok farklı çalışırlar: DrawingContext korumalı mod grafik sistemiyle kullanılırken System.Drawing.Graphics , tür anında mod grafik sistemiyle kullanılır. Bir DrawingContext nesnenin çizim komutlarını kullandığınızda, aslında daha sonra grafik sistemi tarafından kullanılacak bir dizi işleme yönergesini (tam depolama mekanizmasını sağlayan DrawingContextnesne türüne bağlı olsa da) depolarsınız; ekrana gerçek zamanlı olarak çizim yapılmaz. Windows Presentation Foundation (WPF) grafik sisteminin nasıl çalıştığı hakkında daha fazla bilgi için bkz. WPF Grafik İşlemeye Genel Bakış.

Hiçbir zaman doğrudan bir DrawingContext örneği oluşturmazsınız; ancak DrawingGroup.Open ve DrawingVisual.RenderOpen gibi belirli yöntemlerden bir çizim bağlamı elde edebilirsiniz.

Özellikler

Name	Description
Dispatcher	Dispatcher Bunun DispatcherObject ilişkili olduğu öğesini alır. (Devralındığı yer: DispatcherObject)

Yöntemler

Name	Description
CheckAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişimi olup olmadığını belirler. (Devralındığı yer: DispatcherObject)
Close()	DrawingContext öğesini kapatır ve içeriği temizler. Daha sonra, DrawingContext değiştirilemez.
DisposeCore()	tarafından DrawingContextkullanılan tüm kaynakları serbest bırakır.
DrawDrawing(Drawing)	Belirtilen Drawing nesneyi çizer.
DrawEllipse(Brush, Pen, Point, AnimationClock, Double, AnimationClock, Double, AnimationClock)	Belirtilen Brush ile bir üç nokta çizer ve Pen belirtilen animasyon saatlerini uygular.
DrawEllipse(Brush, Pen, Point, Double, Double)	Belirtilen Brush ve Penile bir üç nokta çizer.
DrawGeometry(Brush, Pen, Geometry)	belirtilen Geometry ve Penkullanarak belirtileni Brush çizer.
DrawGlyphRun(Brush, GlyphRun)	Belirtilen metni çizer.
DrawImage(ImageSource, Rect, AnimationClock)	Belirtilen Rect tarafından tanımlanan bölgeye bir görüntü çizer ve belirtilen animasyon saatini uygular.
DrawImage(ImageSource, Rect)	Belirtilen Recttarafından tanımlanan bölgeye bir görüntü çizer.
DrawLine(Pen, Point, AnimationClock, Point, AnimationClock)	Belirtilen noktaların arasına belirtilen Pen öğesini kullanarak bir çizgi çizer ve belirtilen animasyon saatlerini uygular.
DrawLine(Pen, Point, Point)	Belirtilen noktaların arasına belirtilen Penkullanarak bir çizgi çizer.
DrawRectangle(Brush, Pen, Rect, AnimationClock)	Belirtilen Brush ile bir dikdörtgen çizer ve Pen belirtilen animasyon saatlerini uygular.
DrawRectangle(Brush, Pen, Rect)	belirtilen Brush ve Penile bir dikdörtgen çizer. Kalem ve fırça olabilir null.
DrawRoundedRectangle(Brush, Pen, Rect, AnimationClock, Double, AnimationClock, Double, AnimationClock)	Belirtilen Brush ile yuvarlatılmış bir dikdörtgen çizer ve Pen belirtilen animasyon saatlerini uygular.
DrawRoundedRectangle(Brush, Pen, Rect, Double, Double)	Belirtilen Brush ve Penile yuvarlatılmış bir dikdörtgen çizer.
DrawText(FormattedText, Point)	Biçimlendirilmiş metni belirtilen konuma çizer.
DrawVideo(MediaPlayer, Rect, AnimationClock)	Belirtilen bölgeye bir video çizer ve belirtilen animasyon saatini uygular.
DrawVideo(MediaPlayer, Rect)	Belirtilen bölgeye bir video çizer.
Pop()	Çizim bağlamı üzerine gönderilen son opaklık maskesini, opaklığı, klibi, efekti veya dönüştürme işlemini açar.
PushClip(Geometry)	Belirtilen küçük resim bölgesini çizim bağlamına iter.
PushEffect(BitmapEffect, BitmapEffectInput)	Geçersiz. Belirtilen BitmapEffect öğesini çizim bağlamına iletir.
PushGuidelineSet(GuidelineSet)	Belirtilen GuidelineSet öğesini çizim bağlamına iletir.
PushOpacity(Double, AnimationClock)	Belirtilen opaklık ayarını çizim bağlamına iter ve belirtilen animasyon saatini uygular.
PushOpacity(Double)	Belirtilen opaklık ayarını çizim bağlamına iletir.
PushOpacityMask(Brush)	Belirtilen opaklık maskesini çizim bağlamına iter.
PushTransform(Transform)	Belirtilen Transform öğesini çizim bağlamına iletir.
VerifyAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişmesini zorlar. (Devralındığı yer: DispatcherObject)
VerifyApiNonstructuralChange()	Bu üye WPF altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.

Belirtik Arabirim Kullanımları

Name	Description
IDisposable.Dispose()	Bu üye Windows Presentation Foundation (WPF) altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır.

Ayrıca bkz.

• DrawingGroup
• Drawing