Visual Třída

Reference

Definice

Obor názvů:: System.Windows.Media

Sestavení:: PresentationCore.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje podporu vykreslování ve WPF, která zahrnuje testování přístupů, souřadnicové transformace a výpočty ohraničujícího rámečku.

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

Dědičnost: Object

DispatcherObject

DependencyObject
Visual

Odvozené: System.Windows.Media.ContainerVisual

System.Windows.Media.Media3D.Viewport3DVisual

System.Windows.UIElement

Poznámky

Třída Visual je základní abstrakce, ze které každý FrameworkElement objekt pochází. Slouží také jako vstupní bod pro psaní nových ovládacích prvků ve WPF a v mnoha ohledech se dá považovat za ekvivalent popisovače okna (HWND) v aplikačním modelu Win32.

Objekt Visual je základní objekt WPF, jehož primární rolí je poskytovat podporu vykreslování. Ovládací prvky uživatelského rozhraní, jako Button jsou a TextBox, jsou odvozeny z Visual třídy a používají Visual definované vlastnosti pro zachování svých vykreslovacích dat. Objekt Visual poskytuje podporu pro následující:

Zobrazení výstupu: Vykreslení trvalého serializovaného obsahu výkresu vizuálu.
Transformace: Provádění transformací ve vizuálu.
Oříznutí: Poskytuje podporu oblasti oříznutí pro vizuál.
Testování shod: Určení, jestli je zadaná souřadnice (bod) nebo geometrie obsažena v mezích vizuálu.
Výpočty ohraničujícího rámečku: Určení ohraničujícího obdélníku vizuálu.

Z architektonického Visual důvodu objekt neobsahuje podporu pro jiné požadavky na vývoj aplikací / funkce WPF, které nesouvisí okamžitě s jeho vykreslováním, například následující:

Zpracování událostí
Layout
Styly
Datová vazba
Globalizace

Visual je k dispozici jako veřejná abstraktní třída, ze které lze odvodit další třídy. Následující obrázek znázorňuje hierarchii existujících vizuálních objektů, které jsou definovány v architektuře WPF.

Diagram tříd odvozených z vizuálního objektu
Hierarchie tříd vizuálů

V některých případech jsou členy, které jsou definovány jako chráněné v Visual , vystaveny jako dostupnější členy s podobnými názvy v odvozené UIElement třídě.

Další informace najdete v přehledu vykreslování grafiky ve WPF.

A Visual má omezený počet úrovní. V předchozích verzích rozhraní .NET Framework byla tato maximální hloubka 255. Tento limit není dostatečný u některých rozložení, která mají ve vizuálním stromu mnoho úrovní.

V rozhraní .NET Framework 4 je maximální hloubka Visual 2047, což umožňuje mnohem hlubší vizuální stromy. Ve většině aplikací není dostatek místa v zásobníku pro procházení tolika úrovní a výsledkem je StackOverflowException během rozložení. Pro výchozí velikost zásobníku je tato výjimka obvykle vyvolána, když je hloubka stromu přibližně 800, což odpovídá přibližně 190 vnořeným TreeViewItem objektům.

Pokud tuto výjimku vyvolá vaše aplikace a potřebujete hlubší vizuální strom, můžete zvětšit velikost zásobníku aplikace. Velikost zásobníku můžete zvětšit pomocí možnosti /STACK v době kompilace nebo pomocí nástroje EDITBIN. Zvětšení velikosti zásobníku může ovlivnit výkon vaší aplikace. Další informace najdete v tématech Přidělení zásobníku a Možnosti EDITBIN.

Konstruktory

Visual()

Poskytuje základní inicializaci pro objekty odvozené z Visual třídy .

Vlastnosti

DependencyObjectType	Získá, DependencyObjectType který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Získá to Dispatcher DispatcherObject je přidružena k. (Zděděno od DispatcherObject)
IsSealed	Získá hodnotu, která označuje, zda je tato instance právě zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
VisualBitmapEffect	Zastaralé. Zastaralé. Získá nebo nastaví BitmapEffect hodnotu pro Visual.
VisualBitmapEffectInput	Zastaralé. Zastaralé. Získá nebo nastaví BitmapEffectInput hodnotu pro Visual.
VisualBitmapScalingMode	Získá nebo nastaví pro BitmapScalingMode Visual.
VisualCacheMode	Získá nebo nastaví reprezentaci Visualv mezipaměti .
VisualChildrenCount	Získá počet podřízených prvků pro Visual.
VisualClearTypeHint	Získá nebo nastaví , ClearTypeHint který určuje, jak ClearType je vykreslena v Visual.
VisualClip	Získá nebo nastaví oblast klipu Visual jako Geometry hodnotu.
VisualEdgeMode	Získá nebo nastaví hraniční režim Visual jako EdgeMode hodnotu.
VisualEffect	Získá nebo nastaví rastrový efekt pro použití na Visual.
VisualOffset	Získá nebo nastaví hodnotu posunu objektu vizuálu.
VisualOpacity	Získá nebo nastaví neprůhlednost objektu Visual.
VisualOpacityMask	Získá nebo nastaví Brush hodnotu, která představuje masku neprůhlednosti objektu Visual.
VisualParent	Získá nadřazený vizuální strom objektu vizuálu.
VisualScrollableAreaClip	Získá nebo nastaví oříznutou posouvatelnou oblast pro Visual.
VisualTextHintingMode	Získá nebo nastaví TextHintingMode z Visual.
VisualTextRenderingMode	Získá nebo nastaví TextRenderingMode z Visual.
VisualTransform	Získá nebo nastaví Transform hodnotu pro Visual.
VisualXSnappingGuidelines	Získá nebo nastaví x-souřadnice (svislé) vodítka kolekce.
VisualYSnappingGuidelines	Získá nebo nastaví kolekci vodítek souřadnice y (vodorovné).

Metody

AddVisualChild(Visual)	Definuje vztah nadřazenosti a podřízenosti mezi dvěma vizuály.
CheckAccess()	Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která má být vymazána, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která se má vymazat, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho se dosáhne vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastnosti závislosti, protože existuje ve volajícím DependencyObjectobjektu . (Zděděno od DependencyObject)
Equals(Object)	Určuje, zda zadaný DependencyObject je ekvivalentní k aktuálnímu DependencyObject. (Zděděno od DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Vrátí společný nadřazený objekt dvou vizuálních objektů.
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení vlastností závislostí, které mají místně nastavené hodnoty v tomto DependencyObjectobjektu . (Zděděno od DependencyObject)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject)
GetVisualChild(Int32)	Vrátí hodnotu zadanou Visual v nadřazené objektu VisualCollection.
HitTestCore(GeometryHitTestParameters)	Určuje, zda je hodnota geometrie v mezích vizuálního objektu.
HitTestCore(PointHitTestParameters)	Určuje, zda se hodnota souřadnice bodu nachází v mezích objektu vizuálu.
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
IsAncestorOf(DependencyObject)	Určuje, zda je objekt vizuálu nadřazený následníkovi objektu vizuálu.
IsDescendantOf(DependencyObject)	Určuje, zda vizuální objekt je potomkem nadřazeného objektu vizuálu.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnDpiChanged(DpiScale, DpiScale)	Volá se, když se změní DPI, při kterém je toto zobrazení vykresleno.
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Vyvolá se vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Konkrétní změněná vlastnost závislosti je uvedena v datech události. (Zděděno od DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Volána při VisualCollection změně objektu vizuálu.
OnVisualParentChanged(DependencyObject)	Volána při změně nadřazeného objektu vizuálu.
PointFromScreen(Point)	Převede Point souřadnice Point na obrazovce, který představuje aktuální systém Visualsouřadnic .
PointToScreen(Point)	Point Převede objekt, který představuje aktuální souřadnicový systém objektu Visual Point na souřadnice na obrazovce.
ReadLocalValue(DependencyProperty)	Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject)
RemoveVisualChild(Visual)	Odebere vztah nadřazenosti a podřízenosti mezi dvěma vizuály.
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnoty. (Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
SetValue(DependencyPropertyKey, Object)	Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou DependencyPropertyKey identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která označuje, zda serializační procesy mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TransformToAncestor(Visual)	Vrátí transformaci, kterou lze použít k transformaci souřadnic z objektu Visual do zadaného Visual nadřazeného objektu vizuálu.
TransformToAncestor(Visual3D)	Vrátí transformaci, kterou lze použít k transformaci souřadnic z objektu Visual do zadaného Visual3D nadřazeného objektu vizuálu.
TransformToDescendant(Visual)	Vrátí transformaci, která se dá použít k transformaci souřadnic z objektu Visual na potomka zadaného objektu vizuálu.
TransformToVisual(Visual)	Vrátí transformaci, která se dá použít k transformaci souřadnic z objektu Visual do zadaného objektu vizuálu.
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)

Platí pro