EllipseGeometry Kelas

Definisi

Ruang nama:

System.Windows.Media

Rakitan:

PresentationCore.dll

Mewakili geometri lingkaran atau elips.

public ref class EllipseGeometry sealed : System::Windows::Media::Geometry

public sealed class EllipseGeometry : System.Windows.Media.Geometry

type EllipseGeometry = class
    inherit Geometry

Public NotInheritable Class EllipseGeometry
Inherits Geometry

Warisan

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Geometry

EllipseGeometry

Contoh

Contoh berikut menggunakan dua EllipseGeometry objek untuk menentukan konten GeometryDrawing. Contoh ini mencetak output berikut:

Dua objek EllipseGeometry

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

namespace SDKSample
{
    public class GeometryDrawingExample : Page
    {
        public GeometryDrawingExample()
        {

            //
            // Create the Geometry to draw.
            //
            GeometryGroup ellipses = new GeometryGroup();
            ellipses.Children.Add(
                new EllipseGeometry(new Point(50,50), 45, 20)
                );
            ellipses.Children.Add(
                new EllipseGeometry(new Point(50, 50), 20, 45)
                );

            //
            // Create a GeometryDrawing.
            //
            GeometryDrawing aGeometryDrawing = new GeometryDrawing();
            aGeometryDrawing.Geometry = ellipses;

            // Paint the drawing with a gradient.
            aGeometryDrawing.Brush = 
                new LinearGradientBrush(
                    Colors.Blue, 
                    Color.FromRgb(204,204,255), 
                    new Point(0,0), 
                    new Point(1,1));

            // Outline the drawing with a solid color.
            aGeometryDrawing.Pen = new Pen(Brushes.Black, 10);

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

            // Freeze the DrawingImage for performance benefits.
            geometryImage.Freeze();

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

            //
            // Place the image inside a border and
            // add it to the page.
            //
            Border exampleBorder = new Border();
            exampleBorder.Child = anImage;
            exampleBorder.BorderBrush = Brushes.Gray;
            exampleBorder.BorderThickness = new Thickness(1);
            exampleBorder.HorizontalAlignment = HorizontalAlignment.Left;
            exampleBorder.VerticalAlignment = VerticalAlignment.Top;
            exampleBorder.Margin = new Thickness(10);

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

<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"
  Margin="20" Background="White">

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

                <!-- Create a composite shape. -->
                <GeometryGroup>
                  <EllipseGeometry Center="50,50" RadiusX="45" RadiusY="20" />
                  <EllipseGeometry Center="50,50" RadiusX="20" RadiusY="45" />
                </GeometryGroup>
              </GeometryDrawing.Geometry>
              <GeometryDrawing.Brush>

                <!-- Paint the drawing with a gradient. -->
                <LinearGradientBrush>
                  <GradientStop Offset="0.0" Color="Blue" />
                  <GradientStop Offset="1.0" Color="#CCCCFF" />
                </LinearGradientBrush>
              </GeometryDrawing.Brush>
              <GeometryDrawing.Pen>

                <!-- Outline the drawing with a solid color. -->
                <Pen Thickness="10" Brush="Black" />
              </GeometryDrawing.Pen>
            </GeometryDrawing>
          </DrawingImage.Drawing>
        </DrawingImage>
      </Image.Source>
    </Image>
  </Border>


</Page>

Keterangan

EllipseGeometry Gunakan kelas dengan Path elemen atau GeometryDrawing untuk menggambar elips, atau dengan Clip properti dari UIElement untuk menentukan wilayah klip elips. Kelas ini EllipseGeometry juga memiliki banyak kegunakan lain. Untuk informasi selengkapnya tentang EllipseGeometry, lihat Gambaran Umum Geometri.

ElipsisGeometry Dibandingkan dengan Elips

Kelas Ellipse ini memiliki Fill, Stroke, dan properti penyajian lainnya yang EllipseGeometry kurang. Kelas Ellipse adalah FrameworkElement dan oleh karena itu berpartisipasi dalam sistem tata letak; dapat digunakan sebagai konten elemen apa pun yang mendukung anak-anak UIElement .

Kelas EllipseGeometry , di sisi lain, hanya mendefinisikan geometri elips, dan tidak dapat merender dirinya sendiri. Karena kesederhanaannya, ia memiliki berbagai kegunaan yang lebih luas.

Fitur yang Dapat Di-freezable

EllipseGeometry adalah jenis Freezable objek dan karenanya dapat dibekukan untuk meningkatkan performa. Untuk informasi tentang Freezable fitur, seperti pembekuan dan kloning, lihat Gambaran Umum Freezable Objects.

Konstruktor

EllipseGeometry()	Menginisialisasi instans baru kelas EllipseGeometry.
EllipseGeometry(Point, Double, Double)	Menginisialisasi instans EllipseGeometry baru kelas sebagai elips yang memiliki lokasi pusat tertentu, radius x, dan radius y.
EllipseGeometry(Point, Double, Double, Transform)	Menginisialisasi instans baru kelas EllipseGeometry yang memiliki posisi, ukuran, dan transformasi yang ditentukan.
EllipseGeometry(Rect)	Menginisialisasi instans EllipseGeometry baru kelas yang memiliki diameter horizontal yang sama dengan lebar yang diteruskan Rect, diameter vertikal yang sama dengan panjang yang diteruskan Rect, dan lokasi titik tengah yang sama dengan pusat yang diteruskan Rect.

Bidang

CenterProperty	Center Mengidentifikasi properti dependensi.
RadiusXProperty	RadiusX Mengidentifikasi properti dependensi.
RadiusYProperty	RadiusY Mengidentifikasi properti dependensi.

Properti

Bounds	Rect Mendapatkan yang mewakili kotak pembatas ini EllipseGeometry. Metode ini tidak mempertimbangkan area tambahan yang berpotensi ditambahkan oleh stroke.
CanFreeze	Mendapatkan nilai yang menunjukkan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Freezable)
Center	Mendapatkan atau mengatur titik EllipseGeometrytengah .
DependencyObjectType	Mendapatkan yang membungkus jenis CLR dari instans DependencyObjectType ini. (Diperoleh dari DependencyObject)
Dispatcher	Mendapatkan ini DispatcherDispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
HasAnimatedProperties	Mendapatkan nilai yang menunjukkan apakah satu atau beberapa AnimationClock objek dikaitkan dengan salah satu properti dependensi objek ini. (Diperoleh dari Animatable)
IsFrozen	Mendapatkan nilai yang menunjukkan apakah objek saat ini dapat dimodifikasi. (Diperoleh dari Freezable)
IsSealed	Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject)
RadiusX	Mendapatkan atau menetapkan nilai x-radius dari EllipseGeometry.
RadiusY	Mendapatkan atau menetapkan nilai radius y dari EllipseGeometry.
Transform	Mendapatkan atau mengatur Transform objek yang diterapkan ke Geometry. (Diperoleh dari Geometry)

Metode

ApplyAnimationClock(DependencyProperty, AnimationClock)	AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan. (Diperoleh dari Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, yang ditentukan HandoffBehavior akan digunakan. (Diperoleh dari Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Menerapkan animasi ke yang ditentukan DependencyProperty. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan. (Diperoleh dari Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Menerapkan animasi ke yang ditentukan DependencyProperty. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, properti yang ditentukan HandoffBehavior akan digunakan. (Diperoleh dari Animatable)
CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dibersihkan ditentukan oleh DependencyProperty pengidentifikasi. (Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dibersihkan ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject)
Clone()	Membuat kloning yang dapat dimodifikasi dari ini EllipseGeometry, membuat salinan mendalam dari nilai objek ini. Saat menyalin properti dependensi, metode ini menyalin referensi sumber daya dan pengikatan data (tetapi mungkin tidak lagi diselesaikan) tetapi bukan animasi atau nilainya saat ini.
CloneCore(Freezable)	Menjadikan instans sebagai kloning (salinan mendalam) dari yang ditentukan Freezable menggunakan nilai properti dasar (non-animasi). (Diperoleh dari Freezable)
CloneCurrentValue()	Membuat klon yang dapat dimodifikasi dari objek ini EllipseGeometry , membuat salinan mendalam dari nilai objek ini saat ini. Referensi sumber daya, pengikatan data, dan animasi tidak disalin, tetapi nilainya saat ini.
CloneCurrentValueCore(Freezable)	Menjadikan instans sebagai klon yang dapat dimodifikasi (salinan mendalam) dari yang ditentukan Freezable menggunakan nilai properti saat ini. (Diperoleh dari Freezable)
CoerceValue(DependencyProperty)	Memaksakan nilai properti dependensi yang ditentukan. Ini dicapai dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
CreateInstance()	Menginisialisasi instans baru kelas Freezable. (Diperoleh dari Freezable)
CreateInstanceCore()	Saat diimplementasikan di kelas turunan, membuat instans baru dari kelas turunan Freezable . (Diperoleh dari Freezable)
Equals(Object)	Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject. (Diperoleh dari DependencyObject)
FillContains(Geometry)	Menunjukkan apakah geometri saat ini benar-benar berisi yang ditentukan Geometry. (Diperoleh dari Geometry)
FillContains(Geometry, Double, ToleranceType)	Menunjukkan apakah geometri saat ini berisi yang ditentukan Geometry, mengingat margin kesalahan yang ditentukan. (Diperoleh dari Geometry)
FillContains(Point)	Menunjukkan apakah geometri berisi yang ditentukan Point. (Diperoleh dari Geometry)
FillContains(Point, Double, ToleranceType)	Menunjukkan apakah geometri berisi yang ditentukan Point, mengingat margin kesalahan yang ditentukan. (Diperoleh dari Geometry)
FillContainsWithDetail(Geometry)	Mengembalikan nilai yang menjelaskan persimpangan antara geometri saat ini dan geometri yang ditentukan. (Diperoleh dari Geometry)
FillContainsWithDetail(Geometry, Double, ToleranceType)	Mengembalikan nilai yang menjelaskan persimpangan antara geometri saat ini dan geometri yang ditentukan, mengingat margin kesalahan yang ditentukan. (Diperoleh dari Geometry)
Freeze()	Membuat objek saat ini tidak dapat dimodifikasi dan mengatur propertinya IsFrozen ke true. (Diperoleh dari Freezable)
FreezeCore(Boolean)	Membuat objek ini Animatable tidak dapat dimodifikasi atau menentukan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Animatable)
GetAnimationBaseValue(DependencyProperty)	Mengembalikan nilai non-animasi dari yang ditentukan DependencyProperty. (Diperoleh dari Animatable)
GetArea()	Mendapatkan area wilayah objek yang Geometry diisi. (Diperoleh dari Geometry)
GetArea(Double, ToleranceType)	Mendapatkan area ini EllipseGeometry.
GetAsFrozen()	Membuat salinan beku dari Freezable, menggunakan nilai properti dasar (non-animasi). Karena salinan dibekukan, sub-objek beku apa pun disalin oleh referensi. (Diperoleh dari Freezable)
GetAsFrozenCore(Freezable)	Menjadikan instans sebagai klon beku dari yang ditentukan Freezable menggunakan nilai properti dasar (non-animasi). (Diperoleh dari Freezable)
GetCurrentValueAsFrozen()	Membuat salinan beku dari Freezable menggunakan nilai properti saat ini. Karena salinan dibekukan, sub-objek beku apa pun disalin oleh referensi. (Diperoleh dari Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Menjadikan instans saat ini sebagai klon beku dari yang ditentukan Freezable. Jika objek memiliki properti dependensi animasi, nilai animasinya saat ini akan disalin. (Diperoleh dari Freezable)
GetFlattenedPathGeometry()	PathGeometry Mendapatkan yang merupakan perkiraan poligonal objekGeometry. (Diperoleh dari Geometry)
GetFlattenedPathGeometry(Double, ToleranceType)	PathGeometryMendapatkan , dalam toleransi yang ditentukan, yaitu perkiraan poligonal objekGeometry. (Diperoleh dari Geometry)
GetHashCode()	Mendapatkan kode hash untuk ini DependencyObject. (Diperoleh dari DependencyObject)
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang memiliki nilai yang ditetapkan secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject)
GetOutlinedPathGeometry()	Mendapatkan yang merupakan kerangka yang disederhanakan PathGeometry dari wilayah yang diisi dari Geometry. (Diperoleh dari Geometry)
GetOutlinedPathGeometry(Double, ToleranceType)	Mendapatkan , dalam toleransi yang ditentukan, yaitu kerangka yang disederhanakan PathGeometrydari wilayah yang diisi dari Geometry. (Diperoleh dari Geometry)
GetRenderBounds(Pen)	Mengembalikan persegi panjang rata sumbu yang tepat cukup besar untuk memuat geometri setelah diuraikan dengan yang ditentukan Pen. (Diperoleh dari Geometry)
GetRenderBounds(Pen, Double, ToleranceType)	Mengembalikan persegi panjang rata sumbu yang tepat cukup besar untuk memuat geometri setelah diuraikan dengan yang ditentukan Pen, mengingat faktor toleransi yang ditentukan. (Diperoleh dari Geometry)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject. (Diperoleh dari DependencyObject)
GetWidenedPathGeometry(Pen)	PathGeometry Mendapatkan yang merupakan bentuk yang didefinisikan oleh stroke pada Geometry yang dihasilkan oleh yang ditentukan Pen. (Diperoleh dari Geometry)
GetWidenedPathGeometry(Pen, Double, ToleranceType)	PathGeometry Mendapatkan yang merupakan bentuk yang ditentukan oleh stroke pada Geometry yang dihasilkan oleh yang ditentukan Pen, mengingat faktor toleransi yang ditentukan. (Diperoleh dari Geometry)
InvalidateProperty(DependencyProperty)	Mengevaluasi kembali nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
IsEmpty()	Menentukan apakah objek ini EllipseGeometry kosong.
MayHaveCurves()	Menentukan apakah objek ini EllipseGeometry dapat memiliki segmen melengkung.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
OnChanged()	Dipanggil ketika objek saat ini Freezable dimodifikasi. (Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Memastikan bahwa penunjuk konteks yang sesuai ditetapkan untuk DependencyObjectType anggota data yang baru saja ditetapkan. (Diperoleh dari Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Anggota ini mendukung infrastruktur Windows Presentation Foundation (WPF) dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. (Diperoleh dari Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Mengambil alih DependencyObject implementasi OnPropertyChanged(DependencyPropertyChangedEventArgs) untuk juga memanggil penangan apa pun Changed sebagai respons terhadap properti dependensi yang berubah dari jenis Freezable. (Diperoleh dari Freezable)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject)
ReadPreamble()	Memastikan bahwa Freezable sedang diakses dari utas yang valid. Pewaris Freezable harus memanggil metode ini di awal API apa pun yang membaca anggota data yang bukan properti dependensi. (Diperoleh dari Freezable)
SetCurrentValue(DependencyProperty, Object)	Mengatur nilai properti dependensi tanpa mengubah sumber nilainya. (Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya. (Diperoleh dari DependencyObject)
SetValue(DependencyPropertyKey, Object)	Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh DependencyPropertyKey pengidentifikasi properti dependensi. (Diperoleh dari DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus menserialisasikan nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject)
ShouldSerializeTransform()	Mendapatkan nilai yang menunjukkan apakah nilai Transform properti harus diserialisasikan. (Diperoleh dari Geometry)
StrokeContains(Pen, Point)	Menentukan apakah yang ditentukan terkandung Point dalam stroke yang dihasilkan dengan menerapkan yang ditentukan Pen ke geometri. (Diperoleh dari Geometry)
StrokeContains(Pen, Point, Double, ToleranceType)	Menentukan apakah yang ditentukan terkandung Point dalam stroke yang dihasilkan dengan menerapkan yang ditentukan Pen ke geometri, mengingat margin kesalahan yang ditentukan. (Diperoleh dari Geometry)
StrokeContainsWithDetail(Pen, Geometry)	Mengembalikan nilai yang menjelaskan persimpangan antara yang ditentukan Geometry dan goresan yang dibuat dengan menerapkan yang ditentukan Pen ke geometri saat ini. (Diperoleh dari Geometry)
StrokeContainsWithDetail(Pen, Geometry, Double, ToleranceType)	Mendapatkan nilai yang menjelaskan persimpangan antara yang ditentukan Geometry dan goresan yang dibuat dengan menerapkan yang ditentukan Pen ke geometri saat ini, mengingat margin kesalahan yang ditentukan. (Diperoleh dari Geometry)
ToString()	Membuat representasi string objek berdasarkan budaya saat ini. (Diperoleh dari Geometry)
ToString(IFormatProvider)	Membuat representasi string objek menggunakan informasi pemformatan khusus budaya yang ditentukan. (Diperoleh dari Geometry)
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
WritePostscript()	Menaikkan Changed peristiwa untuk Freezable dan memanggil metodenya OnChanged() . Kelas yang berasal dari Freezable harus memanggil metode ini di akhir API apa pun yang memodifikasi anggota kelas yang tidak disimpan sebagai properti dependensi. (Diperoleh dari Freezable)
WritePreamble()	Memverifikasi bahwa Freezable tidak dibekukan dan sedang diakses dari konteks utas yang valid. Freezable pewaris harus memanggil metode ini di awal API apa pun yang menulis ke anggota data yang bukan properti dependensi. (Diperoleh dari Freezable)

Acara

Changed

Terjadi ketika Freezable atau objek yang dikandungnya dimodifikasi. (Diperoleh dari Freezable)

Implementasi Antarmuka Eksplisit

IFormattable.ToString(String, IFormatProvider)

Memformat nilai instans saat ini menggunakan format yang ditentukan. (Diperoleh dari Geometry)

Lihat juga

• Path
• GeometryDrawing
• Clip