TileBrush Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Opisuje sposób malowania regionu przy użyciu co najmniej jednego kafelka.
public ref class TileBrush abstract : System::Windows::Media::Brush
public abstract class TileBrush : System.Windows.Media.Brush
type TileBrush = class
inherit Brush
Public MustInherit Class TileBrush
Inherits Brush
- Dziedziczenie
- Pochodne
Uwagi
Klasy pochodne TileBrush definiują zawartość kafelków używanych do malowania regionu. Na przykład użyj ImageBrush klasy , aby malować obszar przy użyciu obrazu.
Użyj elementu , TileBrush aby kontrolować sposób malowania obszaru. Na przykład Windows Presentation Foundation (WPF) udostępnia kilka typów pędzli:
Aby malować przy użyciu obrazu, użyj elementu ImageBrush.
Aby malować za pomocą rysunku, użyj elementu DrawingBrush.
Aby malować przy użyciu elementu Visual, użyj elementu VisualBrush.
Gdy używasz TileBrush elementu do malowania obszaru, zamiast malować obszar przy użyciu pojedynczego rozciągniętego obrazu, możesz malować obszar przy użyciu serii kafelków obrazów, które tworzą wzór.
Podczas malowania obszaru przy użyciu elementu należy TileBrushużyć trzech składników: zawartości, kafelków i obszaru wyjściowego. Na poniższych ilustracjach pokazano, jak te trzy TileBrush składniki odnoszą się do siebie nawzajem.
Składniki kafelkaBrush z jednym kafelkiem
Składniki kafelkaBrush z kafelkiemMode kafelka
Zawartość: Zawartość TileBrush może mieć różne typy zawartości:
Jeśli pędzl jest plikiem ImageBrush, ta zawartość jest obrazem. Właściwość ImageSource określa zawartość elementu ImageBrush.
Jeśli szczotka jest rysunkiem DrawingBrush, ta zawartość jest rysunkiem. Właściwość Drawing określa zawartość elementu DrawingBrush.
Jeśli pędzl jest elementem VisualBrush, ta zawartość jest wizualizacją. Właściwość Visual określa zawartość elementu VisualBrush.
Możesz określić położenie i wymiary TileBrush zawartości przy użyciu Viewbox właściwości .
Kafelki: tworzy TileBrush co najmniej jeden kafelek. Domyślnie zawartość pędzla jest rozciągnięta, aby wypełnić pojedynczy kafelek i ten kafelek jest rozciągnięty w celu wypełnienia obszaru wyjściowego. Właściwość Viewport służy do określania rozmiaru i położenia kafelka podstawowego dla elementu TileBrush. Właściwość ViewportUnits określa, czy rozmiar i położenie Viewport obiektu są względne względem obszaru wyjściowego (zachowanie domyślne), czy też są wartościami bezwzględnymi.
Obszar wyjściowy: obszar wyjściowy to obszar, który maluje pędzle, takie jak Fill element lub EllipseBackground .Button
Aby uzyskać więcej informacji na temat TileBrush klasy, zobacz Malowanie za pomocą obrazów, rysunków i wizualizacji .
Funkcje zamrażalne
A TileBrush jest typem Freezable . Aby uzyskać informacje o Freezable funkcjach, takich jak zamrożenie i klonowanie, zobacz Omówienie obiektów z możliwością zamrażania.
Uwagi dotyczące implementowania
Po dziedziczeniu TileBrush z klasy należy zastąpić metodę CreateInstanceCore() . Aby uzyskać więcej informacji na temat dziedziczenia z Freezable typów, zobacz Omówienie obiektów z możliwością zamrażania.
Konstruktory
TileBrush() |
Zapewnia inicjowanie wartości klas bazowych, gdy są wywoływane przez konstruktor klasy pochodnej. |
Pola
AlignmentXProperty |
Identyfikuje AlignmentX właściwość zależności. |
AlignmentYProperty |
Identyfikuje AlignmentY właściwość zależności. |
StretchProperty |
Identyfikuje Stretch właściwość zależności. |
TileModeProperty |
Identyfikuje TileMode właściwość zależności. |
ViewboxProperty |
Identyfikuje Viewbox właściwość zależności. |
ViewboxUnitsProperty |
Identyfikuje ViewboxUnits właściwość zależności. |
ViewportProperty |
Identyfikuje Viewport właściwość zależności. |
ViewportUnitsProperty |
Identyfikuje ViewportUnits właściwość zależności. |
Właściwości
AlignmentX |
Pobiera lub ustawia wyrównanie w poziomie zawartości na kafelku TileBrush podstawowym. |
AlignmentY |
Pobiera lub ustawia wyrównanie w pionie zawartości na kafelku TileBrush podstawowym. |
CanFreeze |
Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny. (Odziedziczone po Freezable) |
DependencyObjectType |
DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Odziedziczone po DependencyObject) |
Dispatcher |
Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject) |
HasAnimatedProperties |
Pobiera wartość wskazującą, czy co najmniej jeden AnimationClock obiekt jest skojarzony z dowolnymi właściwościami zależności tego obiektu. (Odziedziczone po Animatable) |
IsFrozen |
Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny. (Odziedziczone po Freezable) |
IsSealed |
Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject) |
Opacity |
Pobiera lub ustawia stopień nieprzezroczystości obiektu Brush. (Odziedziczone po Brush) |
RelativeTransform |
Pobiera lub ustawia transformację, która jest stosowana do pędzla przy użyciu współrzędnych względnych. (Odziedziczone po Brush) |
Stretch |
Pobiera lub ustawia wartość, która określa, jak zawartość tego TileBrush odcinka pasuje do jego kafelków. |
TileMode |
Pobiera lub ustawia wartość określającą sposób TileBrush wypełniania obszaru malowania, jeśli kafelek podstawowy jest mniejszy niż obszar wyjściowy. |
Transform |
Pobiera lub ustawia transformację, która jest stosowana do pędzla. Ta transformacja jest stosowana po zamapowanym i umieszczonym w danych wyjściowych pędzla. (Odziedziczone po Brush) |
Viewbox |
Pobiera lub ustawia położenie i wymiary zawartości na kafelku TileBrush . |
ViewboxUnits |
Pobiera lub ustawia wartość określającą, czy Viewbox wartość jest względna względem pola TileBrush ograniczenia zawartości, czy wartość jest bezwzględna. |
Viewport |
Pobiera lub ustawia położenie i wymiary kafelka podstawowego dla elementu TileBrush. |
ViewportUnits |
Pobiera lub ustawia BrushMappingMode wyliczenie określające, czy wartość Viewportelementu , która wskazuje rozmiar i położenie kafelka podstawowego TileBrush , jest względna względem rozmiaru obszaru wyjściowego. |
Metody
ApplyAnimationClock(DependencyProperty, AnimationClock) |
Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie przekazywania. (Odziedziczone po Animatable) |
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Stosuje element AnimationClock do określonego DependencyPropertyelementu . Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior wartość . (Odziedziczone po Animatable) |
BeginAnimation(DependencyProperty, AnimationTimeline) |
Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, SnapshotAndReplace zostanie użyte zachowanie przekazywania. (Odziedziczone po Animatable) |
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Stosuje animację do określonego DependencyPropertyelementu . Animacja jest uruchamiana po renderowaniu następnej ramki. Jeśli określona właściwość jest już animowana, zostanie użyta określona HandoffBehavior właściwość. (Odziedziczone po Animatable) |
CheckAccess() |
Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject) |
ClearValue(DependencyProperty) |
Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject) |
ClearValue(DependencyPropertyKey) |
Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKeyelement . (Odziedziczone po DependencyObject) |
Clone() |
Tworzy modyfikowalną kopię tego elementu TileBrush , tworząc głębokie kopie jego wartości. |
CloneCore(Freezable) |
Sprawia, że wystąpienie jest klonem (kopią głęboką) określonej Freezable wartości właściwości przy użyciu wartości właściwości base (nie animowanych). (Odziedziczone po Freezable) |
CloneCurrentValue() |
Tworzy modyfikowalną kopię tego TileBrush obiektu, tworząc głębokie kopie jego wartości. Ta metoda nie kopiuje odwołań do zasobów, powiązań danych ani animacji, chociaż kopiuje bieżące wartości. |
CloneCurrentValueCore(Freezable) |
Sprawia, że wystąpienie jest modyfikowalny klon (kopia głęboka) określonego Freezable przy użyciu bieżących wartości właściwości. (Odziedziczone po Freezable) |
CoerceValue(DependencyProperty) |
Coerce wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject) |
CreateInstance() |
Inicjuje nowe wystąpienie klasy Freezable. (Odziedziczone po Freezable) |
CreateInstanceCore() |
Po zaimplementowaniu w klasie pochodnej tworzy nowe wystąpienie klasy pochodnej Freezable . (Odziedziczone po Freezable) |
Equals(Object) |
Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject) |
Freeze() |
Sprawia, że bieżący obiekt jest niezmodyfikowalny i ustawia jego IsFrozen właściwość na |
FreezeCore(Boolean) |
Sprawia, że ten Animatable obiekt jest niezmodyfikowalny lub określa, czy można go niemodyfikować. (Odziedziczone po Animatable) |
GetAnimationBaseValue(DependencyProperty) |
Zwraca wartość nie animowaną określonego DependencyPropertyelementu . (Odziedziczone po Animatable) |
GetAsFrozen() |
Tworzy zamrożoną kopię obiektu Freezableprzy użyciu wartości właściwości base (nie animowanych). Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable) |
GetAsFrozenCore(Freezable) |
Sprawia, że wystąpienie jest zamrożonym klonem określonej Freezable wartości właściwości przy użyciu wartości właściwości base (nie animowanych). (Odziedziczone po Freezable) |
GetContentBounds(Rect) |
Uzyskuje bieżące granice TileBrush zawartości. |
GetCurrentValueAsFrozen() |
Tworzy zamrożoną kopię przy użyciu bieżących Freezable wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable) |
GetCurrentValueAsFrozenCore(Freezable) |
Sprawia, że bieżące wystąpienie jest klonem zamrożonym określonego Freezableobiektu . Jeśli obiekt ma animowane właściwości zależności, są kopiowane ich bieżące animowane wartości. (Odziedziczone po Freezable) |
GetHashCode() |
Pobiera kod skrótu dla tego pliku DependencyObject. (Odziedziczone po DependencyObject) |
GetLocalValueEnumerator() |
Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości w tym DependencyObjectelemecie . (Odziedziczone po DependencyObject) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
GetValue(DependencyProperty) |
Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu DependencyObject. (Odziedziczone po DependencyObject) |
InvalidateProperty(DependencyProperty) |
Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
OnChanged() |
Wywoływana po zmodyfikowaniu bieżącego Freezable obiektu. (Odziedziczone po Freezable) |
OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Zapewnia, że odpowiednie wskaźniki kontekstu są ustanawiane dla DependencyObjectType elementu członkowskiego danych, który został właśnie ustawiony. (Odziedziczone po Freezable) |
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie jest przeznaczony do użycia bezpośrednio z kodu. (Odziedziczone po Freezable) |
OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Zastępuje implementację DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs) metody w celu wywołania wszystkich Changed procedur obsługi w odpowiedzi na zmieniającą się właściwość zależności typu Freezable. (Odziedziczone po Freezable) |
ReadLocalValue(DependencyProperty) |
Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject) |
ReadPreamble() |
Gwarantuje, że dostęp do obiektu Freezable jest uzyskiwany z prawidłowego wątku. Dziedzicze muszą Freezable wywoływać tę metodę na początku dowolnego interfejsu API, który odczytuje elementy członkowskie danych, które nie są właściwościami zależności. (Odziedziczone po Freezable) |
SetCurrentValue(DependencyProperty, Object) |
Ustawia wartość właściwości zależności bez zmiany źródła wartości. (Odziedziczone po DependencyObject) |
SetValue(DependencyProperty, Object) |
Ustawia wartość lokalną właściwości zależności określonej przez jego identyfikator właściwości zależności. (Odziedziczone po DependencyObject) |
SetValue(DependencyPropertyKey, Object) |
Ustawia wartość lokalną właściwości zależności tylko do odczytu określona przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject) |
ShouldSerializeProperty(DependencyProperty) |
Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject) |
ToString() |
Zwracana reprezentacja ciągu tego Brushelementu . (Odziedziczone po Brush) |
ToString(IFormatProvider) |
Tworzy reprezentację ciągu tego obiektu na podstawie określonych informacji o formatowaniu specyficznym dla kultury. (Odziedziczone po Brush) |
VerifyAccess() |
Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject) |
WritePostscript() |
Changed Zgłasza zdarzenie dla Freezable metody i wywołuje jej OnChanged() metodę. Klasy pochodzące z Freezable programu powinny wywoływać tę metodę na końcu dowolnego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności. (Odziedziczone po Freezable) |
WritePreamble() |
Sprawdza, czy Freezable element nie jest zamrożony i czy jest uzyskiwany dostęp do niego z prawidłowego kontekstu wątkowego. Freezable dziedzicze powinny wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje do elementów członkowskich danych, które nie są właściwościami zależności. (Odziedziczone po Freezable) |
Zdarzenia
Changed |
Występuje, gdy Freezable obiekt lub, który zawiera, jest modyfikowany. (Odziedziczone po Freezable) |
Jawne implementacje interfejsu
IFormattable.ToString(String, IFormatProvider) |
Formatuje wartość bieżącego wystąpienia przy użyciu określonego formatu. (Odziedziczone po Brush) |