BitmapCacheBrush Sınıf

Tanım

Ad Alanı:

System.Windows.Media

Bütünleştirilmiş Kod:

PresentationCore.dll

Önbelleğe alınmış içerik içeren bir alanı boyar.

public ref class BitmapCacheBrush sealed : System::Windows::Media::Brush

public sealed class BitmapCacheBrush : System.Windows.Media.Brush

type BitmapCacheBrush = class
    inherit Brush

Public NotInheritable Class BitmapCacheBrush
Inherits Brush

Devralma

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

BitmapCacheBrush

Örnekler

Aşağıdaki kod örneğinde ile BitmapCache nasıl ilişkilendirilecek gösterilmektedir BitmapCacheBrush. Kaynağı birden çok öğede kullanabilir BitmapCacheBrush ve iyi performans elde edebilirsiniz. Kod listesinin tamamı için bkz . Nasıl yapılır: Önbelleğe Alınmış Öğeyi Fırça Olarak Kullanma.

<Window.Resources>
    <RichTextBox x:Key="cachedRichTextBox"  >
        <RichTextBox.CacheMode>
            <BitmapCache EnableClearType="True" RenderAtScale="1" SnapsToDevicePixels="True" />
        </RichTextBox.CacheMode>
    </RichTextBox>

    <BitmapCacheBrush x:Key="cachedRichTextBoxBrush" Target="{StaticResource cachedRichTextBox}">
        <BitmapCacheBrush.BitmapCache>
            <BitmapCache EnableClearType="False" RenderAtScale="0.4" SnapsToDevicePixels="False" />
        </BitmapCacheBrush.BitmapCache>
    </BitmapCacheBrush>        
</Window.Resources>

Açıklamalar

Önbelleğe BitmapCacheBrush alınmış bir öğeyi verimli bir şekilde yeniden kullanmak için sınıfını kullanın. Bu, karmaşık içeriği birden çok öğeye boyamanız gerektiğinde kullanışlıdır. BitmapCache Karmaşık bir öğeyi önbelleğe almak için sınıfını kullanın.

özelliğine bir Visual atayın Target ve isteğe bağlı olarak özelliğine bir BitmapCache atayın BitmapCache . Fırça CacheMode ve hedef Visual farklı davranışlar üretmek için etkileşim kurar. Aşağıdaki tabloda bu etkileşim açıklanmaktadır.

Fırça CacheMode'a sahip	Hedefte CacheMode yok	Hedefte CacheMode var
Hayır	Hedef görsel normal şekilde işlenir; fırça varsayılan önbellek davranışını kullanır.	Hedef görsel kendi önbelleğinde işlenir; fırça, işleme sırasında hedefin önbelleğini kullanır.
Evet	Hedef görsel normal şekilde işlenir; brush, hedefi kendi önbelleğinde işler ve işlemek için bunu kullanır.	Hedef görsel kendi önbelleğinde işlenir; brush, hedefi fırçanın kendi önbelleğine işler ve işlemek için bunu kullanır.

BitmapCacheBrush sınıfı sınıfına VisualBrush benzer, ancak BitmapCacheBrush her zaman hedef öğedeki bir önbellekten veya özelliği tarafından BitmapCache tanımlanan bir önbellekten işlenir. sınıfı kirli BitmapCacheBrush bölgeleri de destekler.

Aşağıdaki tabloda sınıfı için varsayılan bit eşlem önbellek ayarları gösterilmektedir BitmapCacheBrush .

Bit Eşlem Önbelleği Özelliği	Varsayılan Ayar
SnapsToDevicePixels	false
EnableClearType	false
RenderAtScale	1

SnapsToDevicePixels özelliği sınıfı tarafından BitmapCacheBrush yoksayılır.

BitmapCacheBrush sınıfı, kökünde Visualaşağıdaki özellikleri yoksayar. Bu davranış sınıfından VisualBrush farklıdır.

• VisualOffset

• VisualTransform

• VisualClip

• VisualEffect

• VisualOpacity

• VisualOpacityMask

Oluşturucular

Name	Description
BitmapCacheBrush()	BitmapCacheBrush sınıfının yeni bir örneğini başlatır.
BitmapCacheBrush(Visual)	belirtilen BitmapCacheBrushile sınıfının yeni bir örneğini Visual başlatır.

Alanlar

Name	Description
AutoLayoutContentProperty	AutoLayoutContent Bağımlılık özelliğini tanımlar.
BitmapCacheProperty	BitmapCache Bağımlılık özelliğini tanımlar.
TargetProperty	Target Bağımlılık özelliğini tanımlar.

Özellikler

Name	Description
AutoLayoutContent	Düzenin bu fırçanın içeriğine uygulanıp uygulanmadığını gösteren bir değer alır veya ayarlar.
BitmapCache	Önbelleğe alınmış içeriği temsil eden bir CacheMode alır veya ayarlar.
CanFreeze	Nesnenin değiştirilemez hale getirilip getirilemeyeceğini gösteren bir değer alır. (Devralındığı yer: Freezable)
DependencyObjectType	DependencyObjectType Bu örneğin CLR türünü sarmalayan öğesini alır. (Devralındığı yer: DependencyObject)
Dispatcher	Dispatcher Bunun DispatcherObject ilişkili olduğu öğesini alır. (Devralındığı yer: DispatcherObject)
HasAnimatedProperties	Bir veya daha fazla AnimationClock nesnenin bu nesnenin bağımlılık özelliklerinden herhangi biriyle ilişkili olup olmadığını gösteren bir değer alır. (Devralındığı yer: Animatable)
IsFrozen	Nesnenin şu anda değiştirilebilir olup olmadığını gösteren bir değer alır. (Devralındığı yer: Freezable)
IsSealed	Bu örneğin şu anda korumalı (salt okunur) olup olmadığını gösteren bir değer alır. (Devralındığı yer: DependencyObject)
Opacity	bir Brushopaklık derecesini alır veya ayarlar. (Devralındığı yer: Brush)
RelativeTransform	Göreli koordinatları kullanarak fırçaya uygulanan dönüşümü alır veya ayarlar. (Devralındığı yer: Brush)
Target	Hedef görseli önbelleğe alacak veya ayarlar.
Transform	Fırçaya uygulanan dönüşümü alır veya ayarlar. Bu dönüştürme, fırçanın çıkışı eşlendikten ve konumlandırıldıktan sonra uygulanır. (Devralındığı yer: Brush)

Yöntemler

Name	Description
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Belirtilen DependencyPropertyöğesine bir AnimationClock uygular. Özellik zaten animasyonluysa, belirtilen HandoffBehavior kullanılır. (Devralındığı yer: Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Belirtilen DependencyPropertyöğesine bir AnimationClock uygular. Özelliği zaten animasyonlu ise, SnapshotAndReplace iletim davranışı kullanılır. (Devralındığı yer: Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Belirtilen DependencyPropertyöğesine bir animasyon uygular. Animasyon, sonraki çerçeve işlendiğinde başlatılır. Belirtilen özellik zaten animasyonluysa, belirtilen HandoffBehavior kullanılır. (Devralındığı yer: Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Belirtilen DependencyPropertyöğesine bir animasyon uygular. Animasyon, sonraki çerçeve işlendiğinde başlatılır. Belirtilen özellik zaten animasyonluysa, SnapshotAndReplace iletim davranışı kullanılır. (Devralındığı yer: Animatable)
CheckAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişimi olup olmadığını belirler. (Devralındığı yer: DispatcherObject)
ClearValue(DependencyProperty)	Bir özelliğin yerel değerini temizler. Temizlenecek özellik bir DependencyProperty tanımlayıcı tarafından belirtilir. (Devralındığı yer: DependencyObject)
ClearValue(DependencyPropertyKey)	Salt okunur özelliğin yerel değerini temizler. Temizlenecek özellik tarafından DependencyPropertyKeybelirtilir. (Devralındığı yer: DependencyObject)
Clone()	nesnesinin değerlerinin BitmapCacheBrushderin kopyalarını oluşturan değiştirilebilir bir kopyasını oluşturur. Nesnenin bağımlılık özelliklerini kopyalarken, bu yöntem ifadeleri (artık çözümlenmeyebilir) kopyalar, ancak animasyonları veya geçerli değerlerini kopyalar.
CloneCore(Freezable)	Temel (animasyonsuz) özellik değerlerini kullanarak örneği belirtilenlerin Freezable bir kopyası (derin kopya) yapar. (Devralındığı yer: Freezable)
CloneCurrentValue()	Geçerli değerlerini kullanarak öğesinin BitmapCacheBrush değiştirilebilir bir kopyasını (derin kopya) oluşturur.
CloneCurrentValueCore(Freezable)	Geçerli özellik değerlerini kullanarak örneği belirtilenlerin Freezable değiştirilebilir bir kopyası (derin kopya) yapar. (Devralındığı yer: Freezable)
CoerceValue(DependencyProperty)	Belirtilen bağımlılık özelliğinin değerini zorlama. Bu, çağrısında CoerceValueCallbackvar olan bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir DependencyObject işlevi çağırarak gerçekleştirilir. (Devralındığı yer: DependencyObject)
CreateInstance()	Freezable sınıfının yeni bir örneğini başlatır. (Devralındığı yer: Freezable)
CreateInstanceCore()	Türetilmiş bir sınıfta uygulandığında, türetilmiş sınıfın Freezable yeni bir örneğini oluşturur. (Devralındığı yer: Freezable)
Equals(Object)	Sağlanan DependencyObject öğesinin geçerli DependencyObjectile eşdeğer olup olmadığını belirler. (Devralındığı yer: DependencyObject)
Freeze()	Geçerli nesneyi değiştirilemez hale getirir ve özelliğini olarak trueayarlarIsFrozen. (Devralındığı yer: Freezable)
FreezeCore(Boolean)	Bu Animatable nesneyi değiştirilemez hale getirir veya değiştirilemez hale getirilip getirilemeyeceğini belirler. (Devralındığı yer: Animatable)
GetAnimationBaseValue(DependencyProperty)	Belirtilen DependencyPropertyöğesinin animasyonsuz değerini döndürür. (Devralındığı yer: Animatable)
GetAsFrozen()	temel (animasyonsuz) özellik değerlerini kullanarak donmuş bir kopyasını Freezableoluşturur. Kopya dondurulacağından, dondurulan alt nesneler başvuruyla kopyalanır. (Devralındığı yer: Freezable)
GetAsFrozenCore(Freezable)	Temel (animasyonsuz) özellik değerlerini kullanarak örneği belirtilenlerin Freezable donmuş bir kopyası yapar. (Devralındığı yer: Freezable)
GetCurrentValueAsFrozen()	Geçerli özellik değerlerini kullanarak donmuş Freezable bir kopyasını oluşturur. Kopya dondurulacağından, dondurulan alt nesneler başvuruyla kopyalanır. (Devralındığı yer: Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Geçerli örneği, belirtilen Freezableöğesinin donmuş bir kopyası yapar. Nesne animasyonlu bağımlılık özelliklerine sahipse, geçerli animasyonlu değerleri kopyalanır. (Devralındığı yer: Freezable)
GetHashCode()	Bu DependencyObjectiçin bir karma kodu alır. (Devralındığı yer: DependencyObject)
GetLocalValueEnumerator()	Hangi bağımlılık özelliklerinin bu DependencyObjectüzerinde yerel olarak ayarlı değerlere sahip olduğunu belirlemek için özel bir numaralandırıcı oluşturur. (Devralındığı yer: DependencyObject)
GetValue(DependencyProperty)	Bir öğesinin bu örneğindeki bir bağımlılık özelliğinin DependencyObjectgeçerli etkin değerini döndürür. (Devralındığı yer: DependencyObject)
InvalidateProperty(DependencyProperty)	Belirtilen bağımlılık özelliği için geçerli değeri yeniden değerlendirir. (Devralındığı yer: DependencyObject)
OnChanged()	Geçerli Freezable nesne değiştirildiğinde çağrılır. (Devralındığı yer: Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Bu üye Windows Presentation Foundation (WPF) altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır. (Devralındığı yer: Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Yeni ayarlanmış bir DependencyObjectType veri üyesi için uygun bağlam işaretçilerinin oluşturulmasını sağlar. (Devralındığı yer: Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	türündeki DependencyObjectFreezabledeğişen bağımlılık özelliğine yanıt olarak herhangi Changed bir işleyici çağırmak için uygulamasını OnPropertyChanged(DependencyPropertyChangedEventArgs) geçersiz kılar. (Devralındığı yer: Freezable)
ReadLocalValue(DependencyProperty)	Varsa, bağımlılık özelliğinin yerel değerini döndürür. (Devralındığı yer: DependencyObject)
ReadPreamble()	Freezable geçerli bir iş parçacığından erişildiğinden emin olur. öğesinin Freezable devralanları, bağımlılık özellikleri olmayan veri üyelerini okuyan herhangi bir API'nin başında bu yöntemi çağırmalıdır. (Devralındığı yer: Freezable)
SetCurrentValue(DependencyProperty, Object)	Bir bağımlılık özelliğinin değerini, değer kaynağını değiştirmeden ayarlar. (Devralındığı yer: DependencyObject)
SetValue(DependencyProperty, Object)	Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir bağımlılık özelliğinin yerel değerini ayarlar. (Devralındığı yer: DependencyObject)
SetValue(DependencyPropertyKey, Object)	Bağımlılık özelliğinin tanımlayıcısı tarafından belirtilen salt okunur bağımlılık özelliğinin DependencyPropertyKey yerel değerini ayarlar. (Devralındığı yer: DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Serileştirme işlemlerinin sağlanan bağımlılık özelliği için değeri serileştirmesi gerekip gerekmediğini gösteren bir değer döndürür. (Devralındığı yer: DependencyObject)
ToString()	Bu Brushöğesinin dize gösterimini döndür. (Devralındığı yer: Brush)
ToString(IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerine göre bu nesnenin dize gösterimini oluşturur. (Devralındığı yer: Brush)
VerifyAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişmesini zorlar. (Devralındığı yer: DispatcherObject)
WritePostscript()	Changed için Freezable olayını oluşturur ve yöntemini çağırırOnChanged(). öğesinden Freezable türetilen sınıflar, bağımlılık özellikleri olarak depolanmayan sınıf üyelerini değiştiren herhangi bir API'nin sonunda bu yöntemi çağırmalıdır. (Devralındığı yer: Freezable)
WritePreamble()	öğesinin Freezable dondurulmadığını ve geçerli bir iş parçacığı bağlamından erişildiğini doğrular. Freezable devralanların, bağımlılık özellikleri olmayan veri üyelerine yazan herhangi bir API'nin başında bu yöntemi çağırması gerekir. (Devralındığı yer: Freezable)

Ekinlikler

Name	Description
Changed	veya içerdiği bir nesne değiştirildiğinde Freezable gerçekleşir. (Devralındığı yer: Freezable)

Belirtik Arabirim Kullanımları

Name	Description
IFormattable.ToString(String, IFormatProvider)	Belirtilen biçimi kullanarak geçerli örneğin değerini biçimlendirin. (Devralındığı yer: Brush)

Ayrıca bkz.

• BitmapCache
• Visual