Visual Třída

Definice

Obor názvů:
System.Windows.Media
Sestavení:
PresentationCore.dll

Poskytuje podporu vykreslování v WPF, která zahrnuje výpočty testování, souřadnicové transformace a 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é

Poznámky

Třída Visual je základní abstrakce, ze které je každý objekt FrameworkElement odvozen. Slouží také jako vstupní bod pro psaní nových ovládacích prvků ve WPF a mnoha způsoby lze považovat za ekvivalent úchytu 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í, například Button a TextBox, jsou odvozeny z Visual třídy a používají Visual definované vlastnosti pro zachování jejich vykreslovacích dat. Objekt Visual poskytuje podporu pro následující:

  • Zobrazení výstupu: Vykreslení trvalého serializovaného výkresového obsahu vizuálu

  • Transformace: Provádění transformací ve vizuálu

  • Výřez: Poskytování podpory pro definování oblastí výřezu vizuálu.

  • Testování hitů: Určení, zda 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

Objekt v architektuře Visual nezahrnuje podporu pro další požadavky na vývoj aplikací / funkce WPF, které nejsou okamžitě spojené s jeho vykreslováním, například následující:

  • Zpracování událostí

  • Rozložení

  • Styly

  • Datová vazba

  • Globalizace

Visual je poskytována jako veřejná abstraktní třída, ze které mohou být odvozeny další třídy. Následující obrázek znázorňuje hierarchii existujících objektů vizuálů definovaných v architektuře WPF.

Diagram tříd odvozených z vizuálního objektového Hierarchie tříd vizuálu

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

Další informace naleznete v přehledu grafického vykreslování 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í pro některá rozložení, která mají ve stromu vizuálu mnoho úrovní.

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

Pokud je tato výjimka vyvolán vaší aplikací a potřebujete mít 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ýšení velikosti zásobníku může ovlivnit výkon vaší aplikace. Další informace najdete v tématu Přidělení zásobníku a MOŽNOSTI EDITBIN.

Konstruktory

Name Description
Visual()

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

Vlastnosti

Name Description
DependencyObjectType

DependencyObjectType Získá ten, který zabalí typ CLR této instance.

(Zděděno od DependencyObject)
Dispatcher

Dispatcher Získá toto DispatcherObject je přidružené.

(Zděděno od DispatcherObject)
IsSealed

Získá hodnotu, která označuje, zda je tato instance aktuálně 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í BitmapScalingMode pro 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 vykreslen 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 použít na Visual.
VisualOffset

Získá nebo nastaví hodnotu posunu objektu vizuálu.
VisualOpacity

Získá nebo nastaví neprůhlednost Visual.
VisualOpacityMask

Získá nebo nastaví Brush hodnotu, která představuje neprůhlednou masku Visual.
VisualParent

Získá nadřazený strom vizuálu objektu.
VisualScrollableAreaClip

Získá nebo nastaví oříznutou posuvnou oblast pro Visual.
VisualTextHintingMode

Získá nebo nastaví TextHintingMode objektu Visual.
VisualTextRenderingMode

Získá nebo nastaví TextRenderingMode objektu Visual.
VisualTransform

Získá nebo nastaví Transform hodnotu pro Visual.
VisualXSnappingGuidelines

Získá nebo nastaví kolekci vodítek souřadnic x (svisle).
VisualYSnappingGuidelines

Získá nebo nastaví kolekci vodítek souřadnice y (vodorovné).

Metody

Name Description
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á se má vymazat, je určena identifikátorem DependencyProperty .

(Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)

Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která má být vymazána, je určena parametrem DependencyPropertyKey.

(Zděděno od DependencyObject)
CoerceValue(DependencyProperty)

Převede hodnotu zadané vlastnosti závislosti. Toho se dosahuje vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastností pro vlastnost závislosti, protože existuje ve volání DependencyObject.

(Zděděno od DependencyObject)
Equals(Object)

Určuje, zda je poskytnutá DependencyObject hodnota ekvivalentní aktuálnímu DependencyObject.

(Zděděno od DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Vrátí společný nadřazený objekty dvou vizuálů.
GetHashCode()

Získá hash kód pro tento DependencyObject.

(Zděděno od DependencyObject)
GetLocalValueEnumerator()

Vytvoří specializovaný enumerátor pro určení, které vlastnosti závislosti mají místně nastavené hodnoty na tomto DependencyObject.

(Zděděno od DependencyObject)
GetType()

Získá Type 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é VisualCollectionsadě .
HitTestCore(GeometryHitTestParameters)

Určuje, zda je hodnota geometrie v mezích vizuálního objektu.
HitTestCore(PointHitTestParameters)

Určuje, zda je hodnota souřadnic bodu 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ým objektem potomku vizuálu.
IsDescendantOf(DependencyObject)

Určuje, zda je objekt vizuálu následníkem nadřazeného objektu vizuálu.
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Object.

(Zděděno od Object)
OnDpiChanged(DpiScale, DpiScale)

Volá se při změně DPI, při kterém se toto zobrazení vykreslí.
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Vyvolána vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Konkrétní vlastnost závislosti, která se změnila, je hlášena v datech události.

(Zděděno od DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Volá se při VisualCollection změně objektu vizuálu.
OnVisualParentChanged(DependencyObject)

Volá se při změně nadřazeného objektu vizuálu.
PointFromScreen(Point)

Převede souřadnice Point na obrazovku Point , která představuje aktuální souřadnicový systém Visual.
PointToScreen(Point)

Převede soustavu Point , která představuje aktuální souřadnicový systém Visual obrazovek na Point souřadnice obrazovky.
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 hodnot.

(Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)

Nastaví místní hodnotu vlastnosti závislosti určenou jeho 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 identifikátorem DependencyPropertyKey vlastnosti závislosti.

(Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Vrátí hodnotu, která určuje, zda procesy serializace 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, která se dá použít k transformaci souřadnic od Visual zadaného Visual nadřazeného objektu vizuálu.
TransformToAncestor(Visual3D)

Vrátí transformaci, která se dá použít k transformaci souřadnic od Visual zadaného Visual3D nadřazeného objektu vizuálu.
TransformToDescendant(Visual)

Vrátí transformaci, která se dá použít k transformaci souřadnic od zadaného objektu vizuálu Visual .
TransformToVisual(Visual)

Vrátí transformaci, která se dá použít k transformaci souřadnic od zadaného objektu vizuálu Visual .
VerifyAccess()

Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject.

(Zděděno od DispatcherObject)

Platí pro

Viz také