WindowChrome Sınıf

Tanım

Ad Alanı:

System.Windows.Shell

Bütünleştirilmiş Kod:

PresentationFramework.dll

Bir pencerenin istemci olmayan alanında yapılan özelleştirmeleri açıklayan bir nesneyi temsil eder.

public ref class WindowChrome : System::Windows::Freezable

public class WindowChrome : System.Windows.Freezable

type WindowChrome = class
    inherit Freezable

Public Class WindowChrome
Inherits Freezable

Devralma

Object

DispatcherObject

DependencyObject

Freezable

WindowChrome

Açıklamalar

sınıfı, WindowChrome Windows Presentation Foundation (WPF) içeriğini genellikle işletim sisteminin pencere yöneticisi için ayrılmış bir pencerenin istemci olmayan alanına genişletmenizi sağlar.

Standart Windows

Standart pencereler iki örtüşen dikdörtgenden oluşur. Dış dikdörtgen, genellikle krom olarak adlandırılan istemci olmayan bir alandır. İşletim sisteminin pencere yöneticisi tarafından çizilir ve yönetilir. Boyutları standart işletim sistemi ayarları tarafından belirlenir. İstemci olmayan çerçeve, standart pencere özellikleri ve davranışları sağlar. Bunlar resim yazısı düğmelerini (Simge Durumuna Küçült, Ekranı Kapla ve Kapat), pencere kenarını, yeniden boyutlandırma ve taşıma davranışlarını, uygulama simgesini ve başlığını ve sistem menüsünü içerir. İç dikdörtgen istemci alanıdır. Uygulamanızın içeriğini içerir ve uygulama tarafından çizilir ve yönetilir. WPF uygulamalarındaki pencereler hakkında daha fazla bilgi için bkz. WPF Windows'a Genel Bakış.

Aşağıdaki çizimde standart pencerenin bölümleri gösterilmektedir.

Özel Windows

Özelliğini None olarak ayarlayarak veya sınıfını Window.WindowStyle kullanarak bir pencere kenarını WindowChrome özelleştirebilirsiniz.

WindowStyle.None

WPF uygulama penceresinin görünümünü özelleştirmenin bir yolu, özelliğini olarak NoneayarlamaktırWindow.WindowStyle. Bu işlem, istemci olmayan çerçeveyi pencereden kaldırır ve yalnızca özel stil uygulayabileceğiniz istemci alanını bırakır. Ancak, istemci olmayan çerçeve kaldırıldığında, resim yazısı düğmeleri ve pencere yeniden boyutlandırma gibi sağladığı sistem özelliklerini ve davranışlarını da kaybedersiniz. Başka bir yan etki, pencerenin ekranı kapladığında Windows görev çubuğunu kaplamasıdır. Ayar WindowStyle.None , tamamen özel bir uygulama oluşturmanıza olanak tanır, ancak standart pencere davranışına öykünmek için uygulamanızda özel mantık uygulamanızı da gerektirir.

Windowchrome

Standart işlevselliğini korurken pencereyi özelleştirmek için sınıfını WindowChrome kullanabilirsiniz. sınıfı, WindowChrome pencere çerçevesinin işlevselliğini görsellerden ayırır ve uygulama pencerenizin istemci ve istemci olmayan alanları arasındaki sınırı denetlemenize olanak tanır. sınıfı, WindowChrome istemci alanını istemci olmayan alanı kapsayacak şekilde genişleterek WPF içeriğini pencere çerçevesine yerleştirmenize olanak tanır. Aynı zamanda, iki görünmez alan aracılığıyla sistem davranışlarını korur; kenarlık ve resim yazısı alanlarını yeniden boyutlandırın.

sınıfını kullanarak WindowChrome özel pencere oluşturmak için iki ana bölüm vardır. İlk olarak, nesnede kullanıma sunulan WindowChrome özellikleri ayarlayarak pencerenin istemci olmayan bölümünü özelleştirebilirsiniz. Ardından, uygulamanızın istemci olmayan alana genişletilmiş bölümünü tanımlayan pencere için bir şablon sağlarsınız. nesnesinde WindowChrome kullanıma sunulan özellikler , CaptionHeight, CornerRadiusve GlassFrameThickness'tirResizeBorderThickness.

ResizeBorderThickness özelliği, kullanıcının pencereyi yeniden boyutlandırmak için tıklayıp sürükleyebileceği, uygulama penceresinin dışında görünmez bir kenarlık belirtir.

özelliği, CaptionHeight pencerenin üst kısmında, genellikle başlık çubuğuyla ilişkili sistem davranışlarını etkinleştiren görünmez bir alan belirtir. Bu davranışlar şunlardır: pencereyi taşımak için tıklayıp sürükleyin, pencereyi ekranı kaplamak için çift tıklayın ve sistem menüsünü göstermek için sağ tıklayın.

Kenarlık ve resim yazısı yeniden boyutlandırma alanında görsel öğe yoktur; yalnızca girişe yanıt veren alanları tanımlar ve sistem tarafından sağlanan standart pencere davranışlarını etkinleştirir.

özelliği, CornerRadius pencerenin köşelerinin yuvarlanma miktarını belirtir. Cam çerçeve bir pencere için etkinleştirildiyse bu özelliğin herhangi bir etkisi olmaz.

özelliği, GlassFrameThickness pencerenin etrafındaki cam çerçevenin genişliğini belirtir. Varsayılan olarak, standart bir pencerenin görünümünü öykünmek için özelliği tarafından WindowNonClientFrameThickness belirtilen sistem değerini kullanır. Cam çerçeve kullanıldığında Simge Durumuna Küçült, Ekranı Kapla ve Kapat resim yazısı düğmeleri görünür ve etkileşimlidir. Uygulama, uygulama simgesini ve resim yazısı metnini görüntülemekle sorumludur. Cam çerçeveyi GlassFrameThickness varsayılandan daha geniş veya dar hale getirmek için özelliğini ayarlayabilirsiniz.

Dikkat

Özellik değiştirildiğinde resim yazısı düğmelerinin GlassFrameThickness boyutu değişmez. Cam çerçevenin üst kısmı resim yazısı düğmelerinin yüksekliğinden küçükse, resim yazısı düğmeleri tamamen görünmez.

Cam çerçevesi olmayan özel bir pencere oluşturmak için özelliğini 0 tekdüzen değerine ayarlayın GlassFrameThickness . Bu, standart resim yazısı düğmelerini devre dışı bırakır ve gizler.

Cam çerçeveyi pencerenin tamamını kaplayacak şekilde genişletmek için özelliği herhangi bir tarafta negatif bir değere ayarlayın GlassFrameThickness . GlassFrameThickness Özellik herhangi bir taraf için negatif bir değere ayarlandığında, zorlamalı değeri değerine GlassFrameCompleteThicknesseşit olur.

Uyarı

Aero, Windows Vista'da kullanıma sunulan Windows masaüstünün görünümüne ve işlevselliğine yönelik bir dizi görsel geliştirmedir. Aero'nun görsel olarak daha belirgin özelliklerinden biri yarı saydam cam pencere kenarlıklarıdır. Windows Aero, Masaüstü Pencere Yöneticisi'nin (DWM) masaüstü oluşturma özelliği tarafından etkinleştirilir.

Windows Aero cam efektleri tüm işletim sistemlerinde desteklenmez ve desteklenen işletim sistemlerinde devre dışı bırakılabilir. Windows Aero kullanılamıyorsa, özellik değerinden bağımsız olarak GlassFrameThickness cam çerçeve görüntülenmez. Bunun yerine bu özellik tarafından belirtilen kenarlık alanı siyah görünür. Windows Aero cam efektlerinin IsGlassEnabled kullanılabilir olduğunu doğrulamak için özelliğini denetleyin. Cam efektleri yoksa, cam çerçeveyi kullanmayan alternatif bir pencere stili sağlamanız veya pencere stilini null olarak ayarlayarak standart pencereyi kullanmanız gerekir.

ÇERÇEVE içeriğinin görünümünü ve davranışını tanımlayan bir ControlTemplate belirterek WPF içeriğinizi pencere çerçevesine genişletirsiniz. ControlTemplate'ın TargetType değerini özelleştirdiğiniz pencerenin türüne ayarlarsınız.

<ControlTemplate TargetType="{x:Type local:MainWindow}">

Varsayılan olarak, pencerenin istemci olmayan alanında yer alan görsel öğelerin bölümleri etkileşimli değildir. İstemci olmayan alanda etkileşimli öğeleri etkinleştirmek için WindowsChrome.IsHitTestVisibleInChrome iliştirilmiş özelliğini öğesine ekleyin ve true olarak ayarlayın.

Aşağıdaki XAML işaretlemesi, WindowChrome sınıfını kullanarak bir pencereyi özelleştirmek için gereken ana öğeleri gösterir.

<Style x:Key="StandardStyle" TargetType="{x:Type local:MainWindow}">
    <Setter Property="shell:WindowChrome.WindowChrome">
        <Setter.Value>
            <shell:WindowChrome />
        </Setter.Value>
    </Setter>
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type local:MainWindow}">
                <Grid>
                    <Border Background="White"
                            Margin="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=WindowNonClientFrameThickness}">
                        <ContentPresenter Content="{TemplateBinding Content}" />
                    </Border>
                    <TextBlock Text="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Title}"
                               VerticalAlignment="Top" HorizontalAlignment="Left"
                               Margin="36,8,0,0"/>
                    <Image Source="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Icon}"
                           VerticalAlignment="Top" HorizontalAlignment="Left"
                           Margin="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=(shell:WindowChrome.WindowChrome).ResizeBorderThickness}"
                           Width="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=SmallIconSize.Width}"
                           shell:WindowChrome.IsHitTestVisibleInChrome="True"/>
                </Grid>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

İlk ayarlayıcı WindowChrome'yi pencereye ekler. WindowChrome özellikleri için tüm varsayılan değerleri kullanır ve bu da pencerenin standart bir pencere gibi görünmesini sağlar.

<Setter Property="shell:WindowChrome.WindowChrome">
    <Setter.Value>
        <shell:WindowChrome />
    </Setter.Value>
</Setter>

Pencere şablonu, uygulamanızda belirtilen pencerenin içeriğini görüntülemek için bir içerik sunucusu belirtmelidir. Varsayılan olarak WindowChrome sınıfı istemci alanını, istemci olmayan kenarlıkları kapsayacak şekilde genişletir. Cam çerçeveyi ortaya çıkarmak için ContentPresenter çevresinde bir kenar boşluğu belirtmeniz gerekir. Bu işaretleme, standart bir pencerenin görünümüne öykünmek için içerik sunucusu çevresinde beyaz arka planlı bir kenarlık belirtir. Ayrıca, çerçeve için varsayılan sistem genişliğini alan WindowNonClientFrameThickness özelliğine bağlı bir kenar boşluğu belirtir.

<Border Background="White"
    Margin="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=WindowNonClientFrameThickness}">
    <ContentPresenter Content="{TemplateBinding Content}" />
</Border>

Uygulama simgesi ve başlığı WindowChrome sınıfı tarafından görüntülenmez; kenarlıklara özel içerik olarak eklenmesi gerekir. Aşağıdaki XAML, simgeyi ve başlığı görüntülemek için bir görüntü ve metin bloğu ekler. Her iki öğe de penceredeki ilgili özelliklere bağlıdır. Görüntü genişliği SmallIconSize genişliğine bağlıdır ve simge için varsayılan sistem boyutunu alır. IsHitTestVisibleInChrome bağlı özelliği, fare olaylarını alabilmesi için görüntüde ayarlanır.

<Image Source="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Icon}"
       VerticalAlignment="Top" HorizontalAlignment="Left"
       Margin="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=(shell:WindowChrome.WindowChrome).ResizeBorderThickness}"
       Width="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=SmallIconSize.Width}"
       shell:WindowChrome.IsHitTestVisibleInChrome="True"/>

<TextBlock Text="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Title}"
           VerticalAlignment="Top" HorizontalAlignment="Left"
           Margin="36,8,0,0"/>

Oluşturucular

Name	Description
WindowChrome()	WindowChrome sınıfının yeni bir örneğini başlatır.

Alanlar

Name	Description
CaptionHeightProperty	CaptionHeight Bağımlılık özelliğini tanımlar.
CornerRadiusProperty	CornerRadius Bağımlılık özelliğini tanımlar.
GlassFrameThicknessProperty	GlassFrameThickness Bağımlılık özelliğini tanımlar.
IsHitTestVisibleInChromeProperty	IsHitTestVisibleInChrome Bağımlılık özelliğini tanımlar.
NonClientFrameEdgesProperty	NonClientFrameEdges Bağımlılık özelliğini tanımlar.
ResizeBorderThicknessProperty	ResizeBorderThickness Bağımlılık özelliğini tanımlar.
ResizeGripDirectionProperty	ResizeGripDirection Bağımlılık özelliğini tanımlar.
UseAeroCaptionButtonsProperty	UseAeroCaptionButtons Bağımlılık özelliğini tanımlar.
WindowChromeProperty	WindowChrome Bağımlılık özelliğini tanımlar.

Özellikler

Name	Description
CanFreeze	Nesnenin değiştirilemez hale getirilip getirilemeyeceğini gösteren bir değer alır. (Devralındığı yer: Freezable)
CaptionHeight	Pencerenin en üstündeki resim yazısı alanının yüksekliğini alır veya ayarlar.
CornerRadius	Bir pencerenin köşelerinin yuvarlanma miktarını gösteren bir değer alır veya ayarlar.
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)
GlassFrameCompleteThickness	-1 tekdüzen kalınlığını alır.
GlassFrameThickness	Pencerenin etrafındaki cam kenarlık genişliğini gösteren bir değer alır veya ayarlar.
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)
NonClientFrameEdges	Pencere çerçevesinin hangi kenarlarının istemciye ait olmadığını gösteren bir değer alır veya ayarlar.
ResizeBorderThickness	Bir pencereyi yeniden boyutlandırmak için kullanılan kenarlık genişliğini gösteren bir değer alır veya ayarlar.
UseAeroCaptionButtons	Windows Aero resim yazısı düğmelerinde isabet testinin etkinleştirilip etkinleştirilmediğini gösteren bir değer alır veya ayarlar.

İliştirilmiş Özellikler

Name	Description
IsHitTestVisibleInChrome	Bir pencerenin istemci olmayan alanında yapılan özelleştirmeleri açıklayan bir nesneyi temsil eder.
ResizeGripDirection	Bir pencerenin istemci olmayan alanında yapılan özelleştirmeleri açıklayan bir nesneyi temsil eder.
WindowChrome	Bir pencereye eklenmiş olan örneğini WindowChrome alır veya ayarlar.

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)
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 Freezablederin 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. (Devralındığı yer: Freezable)
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 Freezable değiştirilebilir bir kopyasını (derin kopya) oluşturur. (Devralındığı yer: Freezable)
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()	sınıfının yeni bir örneğini WindowChrome oluşturur.
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)	Freezable Nesneyi değiştirilemez hale getirir veya değiştirilemez hale getirilip getirilemeyeceğini test eder. (Devralındığı yer: Freezable)
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)
GetIsHitTestVisibleInChrome(IInputElement)	Belirtilen giriş öğesinden eklenen özelliğin değerini IsHitTestVisibleInChrome alır.
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)
GetResizeGripDirection(IInputElement)	Belirtilen giriş öğesinden eklenen özelliğin değerini ResizeGripDirection alır.
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)
GetWindowChrome(Window)	Belirtilen Windowdeğerinden WindowChrome eklenen özelliğin değerini alır.
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)
SetIsHitTestVisibleInChrome(IInputElement, Boolean)	Belirtilen giriş öğesinde IsHitTestVisibleInChrome ekli özelliğin değerini ayarlar.
SetResizeGripDirection(IInputElement, ResizeGripDirection)	Belirtilen giriş öğesinde ResizeGripDirection ekli özelliğin değerini ayarlar.
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)
SetWindowChrome(Window, WindowChrome)	Belirtilen Windowüzerindeki ekli özelliğin değerini WindowChrome ayarlar.
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)
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)