Visual Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Media

Zestaw:: PresentationCore.dll

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.

Zapewnia obsługę renderowania w WPF, która obejmuje testowanie trafień, przekształcanie współrzędnych i obliczenia pola ograniczenia.

public ref class Visual abstract : System::Windows::DependencyObject

public abstract class Visual : System.Windows.DependencyObject

type Visual = class
    inherit DependencyObject
    interface DUCE.IResource

type Visual = class
    inherit DependencyObject

Public MustInherit Class Visual
Inherits DependencyObject

Dziedziczenie: Object

DispatcherObject

DependencyObject
Visual

Pochodne: System.Windows.Media.ContainerVisual

System.Windows.Media.Media3D.Viewport3DVisual

System.Windows.UIElement

Uwagi

Klasa Visual jest podstawową abstrakcją, z której pochodzi każdy FrameworkElement obiekt. Służy również jako punkt wejścia do pisania nowych kontrolek w WPF, a na wiele sposobów można traktować jako odpowiednik uchwytu okna (HWND) w modelu aplikacji Win32.

Obiekt Visual jest podstawowym obiektem WPF, którego główną rolą jest zapewnienie obsługi renderowania. Kontrolki interfejsu użytkownika, takie jak Button i TextBox, pochodzą z Visual klasy i używają Visual zdefiniowanych właściwości do utrwalania danych renderowania. Obiekt Visual zapewnia obsługę następujących elementów:

Wyświetlanie danych wyjściowych: renderowanie utrwalonej, serializowanej zawartości rysunku wizualizacji.
Przekształcenia: wykonywanie przekształceń na wizualizacji.
Wycinki: zapewnianie obsługi regionów wycinków dla wizualizacji.
Testowanie trafień: określanie, czy określona współrzędna (punkt) czy geometria znajduje się w granicach wizualizacji.
Obliczenia pola ograniczenia: określanie prostokąta ograniczenia wizualizacji.

W architekturze Visual obiekt nie obejmuje obsługi innych wymagań dotyczących tworzenia aplikacji / funkcji WPF, które nie są natychmiast związane z renderowaniem, takie jak następujące:

Obsługa zdarzeń
Layout
Style
Powiązanie danych
Globalizacja

Visual jest dostarczany jako publiczna klasa abstrakcyjna, z której można uzyskać dalsze klasy. Poniższa ilustracja przedstawia hierarchię istniejących obiektów wizualnych zdefiniowanych w architekturze WPF.

Diagram klas uzyskanych z obiektu wizualnego Diagram
Hierarchia klas wizualizacji

W niektórych przypadkach składowe zdefiniowane jako chronione w Visual programie są widoczne jako bardziej łatwo dostępne elementy członkowskie o podobnych nazwach w klasie pochodnej UIElement .

Aby uzyskać więcej informacji, zobacz Omówienie renderowania grafiki na platformie WPF.

Element A Visual ma ograniczoną liczbę poziomów. W poprzednich wersjach .NET Framework ta maksymalna głębokość wynosiła 255. Ten limit jest nieodpowiedni dla niektórych układów, które mają wiele poziomów w drzewie wizualizacji.

W .NET Framework 4 maksymalna głębokość obiektu Visual wynosi 2047, co umożliwia znacznie głębsze drzewa wizualne. W większości aplikacji nie ma wystarczającej ilości miejsca na stos, aby przechodzić tak wiele poziomów, a wynik jest StackOverflowException wynikiem układu. W przypadku domyślnego rozmiaru stosu ten wyjątek jest zwykle zgłaszany, gdy głębokość drzewa wynosi około 800, co odpowiada około 190 obiektów zagnieżdżonych TreeViewItem .

Jeśli ten wyjątek jest zgłaszany przez aplikację i musisz mieć bardziej szczegółowe drzewo wizualne, możesz zwiększyć rozmiar stosu aplikacji. Rozmiar stosu można zwiększyć przy użyciu opcji /STACK w czasie kompilacji lub za pomocą narzędzia EDITBIN. Zwiększenie rozmiaru stosu może mieć wpływ na wydajność aplikacji. Aby uzyskać więcej informacji, zobacz Alokacje stosu i Opcje EDITBIN.

Konstruktory

Visual()

Zapewnia podstawową inicjację obiektów pochodnych od Visual klasy.

Właściwości

DependencyObjectType	DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
VisualBitmapEffect	Przestarzałe. Przestarzałe. Pobiera lub ustawia BitmapEffect wartość dla elementu Visual.
VisualBitmapEffectInput	Przestarzałe. Przestarzałe. Pobiera lub ustawia BitmapEffectInput wartość dla elementu Visual.
VisualBitmapScalingMode	Pobiera lub ustawia wartość BitmapScalingMode dla parametru Visual.
VisualCacheMode	Pobiera lub ustawia w pamięci podręcznej reprezentację elementu Visual.
VisualChildrenCount	Pobiera liczbę elementów podrzędnych dla elementu Visual.
VisualClearTypeHint	Pobiera lub ustawia wartość ClearTypeHint określającą sposób renderowania typu ClearType w elemecie Visual.
VisualClip	Pobiera lub ustawia region klipu jako Visual Geometry wartość.
VisualEdgeMode	Pobiera lub ustawia tryb Visual krawędzi jako EdgeMode wartość.
VisualEffect	Pobiera lub ustawia efekt mapy bitowej, który ma być stosowany do elementu Visual.
VisualOffset	Pobiera lub ustawia wartość przesunięcia obiektu wizualizacji.
VisualOpacity	Pobiera lub ustawia nieprzezroczystość obiektu Visual.
VisualOpacityMask	Pobiera lub ustawia Brush wartość reprezentującą maskę nieprzezroczystości elementu Visual.
VisualParent	Pobiera element nadrzędny drzewa wizualnego obiektu wizualizacji.
VisualScrollableAreaClip	Pobiera lub ustawia przycięty obszar przewijania dla obiektu Visual.
VisualTextHintingMode	Pobiera lub ustawia TextHintingMode element .Visual
VisualTextRenderingMode	Pobiera lub ustawia TextRenderingMode element .Visual
VisualTransform	Pobiera lub ustawia Transform wartość dla elementu Visual.
VisualXSnappingGuidelines	Pobiera lub ustawia kolekcję wskazówek współrzędnych x (pionowo).
VisualYSnappingGuidelines	Pobiera lub ustawia kolekcję wskazówek współrzędnych y (poziomych).

Metody

AddVisualChild(Visual)	Definiuje relację nadrzędny-podrzędny między dwiema wizualizacjami.
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)
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)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Zwraca wspólny element nadrzędny dwóch obiektów wizualnych.
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)
GetVisualChild(Int32)	Zwraca wartość określoną Visual w obiekcie nadrzędnym VisualCollection.
HitTestCore(GeometryHitTestParameters)	Określa, czy wartość geometryczna znajduje się w granicach obiektu wizualizacji.
HitTestCore(PointHitTestParameters)	Określa, czy wartość współrzędnych punktu znajduje się w granicach obiektu wizualizacji.
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
IsAncestorOf(DependencyObject)	Określa, czy obiekt wizualny jest obiektem nadrzędnym obiektu wizualizacji potomnej.
IsDescendantOf(DependencyObject)	Określa, czy obiekt wizualizacji jest elementem potomnym obiektu wizualnego programu ancestor.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnDpiChanged(DpiScale, DpiScale)	Wywoływana, gdy dpi, w której ten widok jest renderowany, zmienia się.
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wywoływane za każdym razem, gdy obowiązująca wartość dowolnej właściwości zależności została DependencyObject zaktualizowana. Określona właściwość zależności, która uległa zmianie, jest zgłaszana w danych zdarzenia. (Odziedziczone po DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Wywoływana po VisualCollection zmodyfikowaniu obiektu wizualizacji.
OnVisualParentChanged(DependencyObject)	Wywoływana po zmianie elementu nadrzędnego obiektu wizualizacji.
PointFromScreen(Point)	Konwertuje współrzędnych Point w ekranie na Point wartość reprezentującą bieżący układ współrzędnych elementu Visual.
PointToScreen(Point)	Konwertuje element Point , który reprezentuje bieżący układ współrzędnych współrzędnych Visual Point na ekranie.
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
RemoveVisualChild(Visual)	Usuwa relację nadrzędny-podrzędny między dwiema wizualizacjami.
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()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TransformToAncestor(Visual)	Zwraca transformację, która może służyć do przekształcania współrzędnych z obiektu wizualnego na Visual określony Visual element nadrzędny.
TransformToAncestor(Visual3D)	Zwraca transformację, która może służyć do przekształcania współrzędnych z obiektu wizualnego na Visual określony Visual3D element nadrzędny.
TransformToDescendant(Visual)	Zwraca przekształcenie, które może służyć do przekształcania współrzędnych z Visual elementu podrzędnego do określonego obiektu wizualnego.
TransformToVisual(Visual)	Zwraca przekształcenie, które może służyć do przekształcania współrzędnych z Visual obiektu do określonego obiektu wizualizacji.
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)

Dotyczy

Produkt	Wersje
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Udostępnij za pośrednictwem