Udostępnij za pośrednictwem


Visual Klasa

Definicja

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.

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 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

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 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)

Dotyczy

Zobacz też