Visual 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.
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
- Pochodne
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.
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 VisualGeometry 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 | |
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 VisualPoint 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) |