ContainerVisual Kelas

Definisi

Ruang nama:: System.Windows.Media

Rakitan:: PresentationCore.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengelola kumpulan Visual objek.

public ref class ContainerVisual : System::Windows::Media::Visual

public class ContainerVisual : System.Windows.Media.Visual

type ContainerVisual = class
    inherit Visual

Public Class ContainerVisual
Inherits Visual

Warisan: Object

DispatcherObject

DependencyObject

Visual
ContainerVisual

Turunan: System.Windows.Media.DrawingVisual

System.Windows.Media.HostVisual

Contoh

Contoh berikut menunjukkan cara membuat ContainerVisual objek yang digunakan sebagai induk untuk dua DrawingVisual objek. Objek yang ditambahkan ke ContainerVisual objek harus ditambahkan dalam urutan z terbalik (bawah ke atas) untuk memastikan objek dirender dalam urutan menggambar yang benar. Agar pohon visual dijumlahkan dengan benar, contohnya menyediakan implementasi metode dan VisualChildrenCount properti yang GetVisualChild ditimpa.

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual objects.
public class MyContainerVisualHost : FrameworkElement
{
    private ContainerVisual _containerVisual;

    public MyContainerVisualHost(DrawingVisual border, DrawingVisual text)
    {
        // Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = new ContainerVisual();

        // Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border);
        _containerVisual.Children.Add(text);

        // Create parent-child relationship with host visual and ContainerVisual.
        this.AddVisualChild(_containerVisual);
    }

    // Provide a required override for the VisualChildrenCount property.
    protected override int VisualChildrenCount
    {
        get { return _containerVisual == null ? 0 : 1; }
    }

    // Provide a required override for the GetVisualChild method.
    protected override Visual GetVisualChild(int index)
    {
        if (_containerVisual == null)
        {
            throw new ArgumentOutOfRangeException();
        }

        return _containerVisual;
    }
}

' Create a host visual derived from the FrameworkElement class.
' This class provides layout, event handling, and container support for
' the child visual objects.
Public Class MyContainerVisualHost
    Inherits FrameworkElement
    Private _containerVisual As ContainerVisual

    Public Sub New(ByVal border As DrawingVisual, ByVal text As DrawingVisual)
        ' Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = New ContainerVisual()

        ' Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border)
        _containerVisual.Children.Add(text)

        ' Create parent-child relationship with host visual and ContainerVisual.
        Me.AddVisualChild(_containerVisual)
    End Sub

    ' Provide a required override for the VisualChildrenCount property.
    Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
        Get
            Return If(_containerVisual Is Nothing, 0, 1)
        End Get
    End Property

    ' Provide a required override for the GetVisualChild method.
    Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
        If _containerVisual Is Nothing Then
            Throw New ArgumentOutOfRangeException()
        End If

        Return _containerVisual
    End Function
End Class

Keterangan

Kelas ContainerVisual digunakan sebagai kontainer untuk kumpulan objek Visual. Kelas DrawingVisual berasal dari ContainerVisual kelas , sehingga DrawingVisual kelas juga dapat berisi kumpulan objek visual.

Konstruktor

Nama	Deskripsi
ContainerVisual()	Membuat instans ContainerVisual baru kelas.

Properti

Nama	Deskripsi
BitmapEffect	Kedaluwarsa. Kedaluwarsa. Mendapatkan atau menetapkan BitmapEffect nilai untuk ContainerVisual.
BitmapEffectInput	Kedaluwarsa. Kedaluwarsa. Mendapatkan atau menetapkan BitmapEffectInput nilai untuk ContainerVisual.
CacheMode	Mendapatkan atau mengatur representasi cache dari ContainerVisual.
Children	Mendapatkan koleksi anak dari ContainerVisual.
Clip	Mendapatkan atau mengatur wilayah kliping dari ContainerVisual.
ContentBounds	Mendapatkan kotak pembatas ContainerVisualuntuk konten .
DependencyObjectType	DependencyObjectType Mendapatkan yang membungkus jenis CLR instans ini. (Diperoleh dari DependencyObject)
DescendantBounds	Mendapatkan penyatuan semua kotak pembatas ContainerVisualkonten untuk semua turunan , tetapi tidak termasuk konten ContainerVisual.
Dispatcher	Dispatcher Mendapatkan ini DispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
Effect	Mendapatkan atau mengatur efek bitmap untuk diterapkan ke ContainerVisual.
IsSealed	Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject)
Offset	Mendapatkan atau mengatur nilai offset dari ContainerVisual titik referensinya.
Opacity	Mendapatkan atau mengatur keburaman ContainerVisual, berdasarkan 0=transparan, 1=buram.
OpacityMask	Mendapatkan atau mengatur kuas yang menentukan kemungkinan masker opasitas untuk ContainerVisual.
Parent	Mendapatkan induk Visual untuk ContainerVisual.
Transform	Mendapatkan atau mengatur transformasi yang diterapkan ke ContainerVisual.
VisualBitmapEffect	Kedaluwarsa. Kedaluwarsa. Mendapatkan atau menetapkan BitmapEffect nilai untuk Visual. (Diperoleh dari Visual)
VisualBitmapEffectInput	Kedaluwarsa. Kedaluwarsa. Mendapatkan atau menetapkan BitmapEffectInput nilai untuk Visual. (Diperoleh dari Visual)
VisualBitmapScalingMode	Mendapatkan atau mengatur BitmapScalingMode untuk Visual. (Diperoleh dari Visual)
VisualCacheMode	Mendapatkan atau mengatur representasi cache dari Visual. (Diperoleh dari Visual)
VisualChildrenCount	Mendapatkan jumlah anak untuk ContainerVisual.
VisualClearTypeHint	Mendapatkan atau mengatur ClearTypeHint yang menentukan bagaimana ClearType dirender di Visual. (Diperoleh dari Visual)
VisualClip	Mendapatkan atau mengatur wilayah Visual klip sebagai Geometry nilai. (Diperoleh dari Visual)
VisualEdgeMode	Mendapatkan atau mengatur mode Visual tepi sebagai EdgeMode nilai. (Diperoleh dari Visual)
VisualEffect	Mendapatkan atau mengatur efek bitmap untuk diterapkan ke Visual. (Diperoleh dari Visual)
VisualOffset	Mendapatkan atau mengatur nilai offset objek visual. (Diperoleh dari Visual)
VisualOpacity	Mendapatkan atau mengatur keburaman dari Visual. (Diperoleh dari Visual)
VisualOpacityMask	Mendapatkan atau menetapkan Brush nilai yang mewakili masker opasitas dari Visual. (Diperoleh dari Visual)
VisualParent	Mendapatkan induk pohon visual dari objek visual. (Diperoleh dari Visual)
VisualScrollableAreaClip	Mendapatkan atau mengatur area yang dapat digulir terklip untuk Visual. (Diperoleh dari Visual)
VisualTextHintingMode	Mendapatkan atau mengatur TextHintingMode dari Visual. (Diperoleh dari Visual)
VisualTextRenderingMode	Mendapatkan atau mengatur TextRenderingMode dari Visual. (Diperoleh dari Visual)
VisualTransform	Mendapatkan atau menetapkan Transform nilai untuk Visual. (Diperoleh dari Visual)
VisualXSnappingGuidelines	Mendapatkan atau mengatur koleksi pedoman koordinat x (vertikal). (Diperoleh dari Visual)
VisualYSnappingGuidelines	Mendapatkan atau mengatur koleksi pedoman koordinat y (horizontal). (Diperoleh dari Visual)
XSnappingGuidelines	Mendapatkan atau mengatur pedoman X (horizontal) untuk ContainerVisual.
YSnappingGuidelines	Mendapatkan atau mengatur pedoman Y (vertikal) untuk ContainerVisual.

Metode

Nama	Deskripsi
AddVisualChild(Visual)	Menentukan hubungan induk-anak antara dua visual. (Diperoleh dari Visual)
CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dihapus ditentukan oleh DependencyProperty pengidentifikasi. (Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dihapus ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject)
CoerceValue(DependencyProperty)	Memaksa nilai properti dependensi yang ditentukan. Ini dilakukan dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
Equals(Object)	Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject. (Diperoleh dari DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Mengembalikan leluhur umum dari dua objek visual. (Diperoleh dari Visual)
GetHashCode()	Mendapatkan kode hash untuk ini DependencyObject. (Diperoleh dari DependencyObject)
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject. (Diperoleh dari DependencyObject)
GetVisualChild(Int32)	Mengembalikan anak Visual tertentu untuk induk ContainerVisual.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Memulai tes hit pada ContainerVisual dengan menggunakan HitTestFilterCallback objek dan HitTestResultCallback .
HitTest(Point)	Mengembalikan objek visual terbanyak dari pengujian hit dengan menentukan Point.
HitTestCore(GeometryHitTestParameters)	Menentukan apakah nilai geometri berada dalam batas objek visual. (Diperoleh dari Visual)
HitTestCore(PointHitTestParameters)	Menentukan apakah nilai koordinat titik berada dalam batas objek visual. (Diperoleh dari Visual)
InvalidateProperty(DependencyProperty)	Mengevaluasi kembali nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
IsAncestorOf(DependencyObject)	Menentukan apakah objek visual adalah leluhur dari objek visual turunan. (Diperoleh dari Visual)
IsDescendantOf(DependencyObject)	Menentukan apakah objek visual adalah turunan dari objek visual leluhur. (Diperoleh dari Visual)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnDpiChanged(DpiScale, DpiScale)	Dipanggil ketika DPI tempat Tampilan ini dirender berubah. (Diperoleh dari Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Dipanggil setiap kali nilai efektif dari properti dependensi apa pun pada ini DependencyObject telah diperbarui. Properti dependensi tertentu yang berubah dilaporkan dalam data peristiwa. (Diperoleh dari DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Dipanggil VisualCollection saat objek visual dimodifikasi. (Diperoleh dari Visual)
OnVisualParentChanged(DependencyObject)	Dipanggil saat induk objek visual diubah. (Diperoleh dari Visual)
PointFromScreen(Point)	Point Mengonversi koordinat dalam layar menjadi Point yang mewakili sistem koordinat Visualsaat ini dari . (Diperoleh dari Visual)
PointToScreen(Point)	Point Mengonversi yang mewakili sistem koordinat saat ini dari Visual ke dalam koordinat Point layar. (Diperoleh dari Visual)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject)
RemoveVisualChild(Visual)	Menghapus hubungan induk-turunan antara dua visual. (Diperoleh dari Visual)
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 membuat serialisasi nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TransformToAncestor(Visual)	Mengembalikan transformasi yang dapat digunakan untuk mengubah koordinat dari Visual ke leluhur objek visual yang ditentukan Visual . (Diperoleh dari Visual)
TransformToAncestor(Visual3D)	Mengembalikan transformasi yang dapat digunakan untuk mengubah koordinat dari Visual ke leluhur objek visual yang ditentukan Visual3D . (Diperoleh dari Visual)
TransformToDescendant(Visual)	Mengembalikan transformasi yang dapat digunakan untuk mengubah koordinat Visual dari ke turunan objek visual yang ditentukan. (Diperoleh dari Visual)
TransformToVisual(Visual)	Mengembalikan transformasi yang dapat digunakan untuk mengubah koordinat dari ke Visual objek visual yang ditentukan. (Diperoleh dari Visual)
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?