Visual Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Ger återgivningsstöd i WPF, vilket inkluderar beräkningar för träfftestning, koordinattransformering och avgränsningsruta.
public ref class Visual abstract : System::Windows::DependencyObjectpublic abstract class Visual : System.Windows.DependencyObjecttype Visual = class
inherit DependencyObject
interface DUCE.IResourcetype Visual = class
inherit DependencyObjectPublic MustInherit Class Visual
Inherits DependencyObject- Arv
- Härledda
Kommentarer
Klassen Visual är den grundläggande abstraktion som varje FrameworkElement objekt härleder från. Det fungerar också som startpunkt för att skriva nya kontroller i WPF, och kan på många sätt betraktas som en motsvarighet till ett fönsterhandtag (HWND) i Win32-programmodellen.
Det Visual objektet är ett wpf-kärnobjekt vars primära roll är att tillhandahålla återgivningsstöd. Användargränssnittskontroller, till exempel Button och TextBox, härleds från Visual klassen och använder de Visual definierade egenskaperna för att bevara sina återgivningsdata. Objektet Visual har stöd för följande:
Utdatavisning: Återge det bevarade, serialiserade ritningsinnehållet i ett visuellt objekt.
Transformeringar: Utföra transformeringar på ett visuellt objekt.
Urklipp: Ge stöd för urklippsregion för ett visuellt objekt.
Träfftestning: Avgöra om en angiven koordinat (punkt) eller geometri finns inom gränserna för ett visuellt objekt.
Beräkningar av avgränsningsrutor: Fastställa avgränsningsrektangeln för ett visuellt objekt.
Arkitektoniskt innehåller objektet Visual inte stöd för andra programutvecklingskrav/WPF funktioner som inte är omedelbart relaterade till återgivningen, till exempel följande:
Händelsehantering
Layout
Stilar
Datalänkning
Globalisering
Visual tillhandahålls som en offentlig abstrakt klass från vilken ytterligare klasser kan härledas. Följande bild visar hierarkin för befintliga visuella objekt som definieras i WPF-arkitekturen.
Visuell klasshierarki
I vissa fall exponeras medlemmar som definieras som skyddade i Visual som mer lättillgängliga medlemmar med liknande namn i den härledda UIElement klassen.
För mer information, se Översikt över WPF-grafikrendering.
A Visual har ett begränsat antal nivåer. I tidigare versioner av .NET Framework var det här maximala djupet 255. Den här gränsen är otillräcklig för vissa layouter som har många nivåer i det visuella trädet.
I .NET Framework 4 är det maximala djupet för en Visual 2047, vilket möjliggör mycket djupare visuella träd. I de flesta program finns det inte tillräckligt med stackutrymme för att passera så många nivåer, och resultatet är en StackOverflowException under layout. För standardstackens storlek genereras det här undantaget vanligtvis när träddjupet är cirka 800, vilket motsvarar cirka 190 kapslade TreeViewItem objekt.
Om det här undantaget genereras av ditt program och du behöver ha ett djupare visuellt träd kan du öka programmets stackstorlek. Du kan öka storleken på stacken med hjälp av alternativet /STACK vid kompileringstillfället eller med hjälp av verktyget EDITBIN. Om du ökar stackstorleken kan det påverka programmets prestanda. Mer information finns i Stackallokeringar och ALTERNATIV för EDITBIN.
Konstruktorer
| Name | Description |
|---|---|
| Visual() |
Tillhandahåller basinitiering för objekt som härletts Visual från klassen. |
Egenskaper
| Name | Description |
|---|---|
| DependencyObjectType |
DependencyObjectType Hämtar som omsluter CLR-typen för den här instansen. (Ärvd från DependencyObject) |
| Dispatcher |
Hämtar det Dispatcher som DispatcherObject är associerat med. (Ärvd från DispatcherObject) |
| IsSealed |
Hämtar ett värde som anger om den här instansen för närvarande är förseglad (skrivskyddad). (Ärvd från DependencyObject) |
| VisualBitmapEffect |
Föråldrad.
Föråldrad.
Hämtar eller anger BitmapEffect värdet för Visual. |
| VisualBitmapEffectInput |
Föråldrad.
Föråldrad.
Hämtar eller anger BitmapEffectInput värdet för Visual. |
| VisualBitmapScalingMode |
Hämtar eller anger BitmapScalingMode för Visual. |
| VisualCacheMode |
Hämtar eller anger en cachelagrad representation av Visual. |
| VisualChildrenCount |
Hämtar antalet underordnade element för Visual. |
| VisualClearTypeHint |
Hämtar eller anger ClearTypeHint som avgör hur ClearType återges i Visual. |
| VisualClip |
Hämtar eller anger klippområdet för Visual som ett Geometry värde. |
| VisualEdgeMode |
Hämtar eller anger kantläget för Visual som ett EdgeMode värde. |
| VisualEffect |
Hämtar eller anger bitmappseffekten som ska tillämpas på Visual. |
| VisualOffset |
Hämtar eller anger förskjutningsvärdet för det visuella objektet. |
| VisualOpacity |
Hämtar eller anger opaciteten för Visual. |
| VisualOpacityMask |
Hämtar eller anger värdet Brush som representerar opacitetsmasken för Visual. |
| VisualParent |
Hämtar det visuella trädets överordnade objekt. |
| VisualScrollableAreaClip |
Hämtar eller anger ett klippt rullningsbart område för Visual. |
| VisualTextHintingMode |
Hämtar eller ställer in TextHintingMode i Visual. |
| VisualTextRenderingMode |
Hämtar eller ställer in TextRenderingMode i Visual. |
| VisualTransform | |
| VisualXSnappingGuidelines |
Hämtar eller anger riktlinjesamlingen x-koordinat (lodrät). |
| VisualYSnappingGuidelines |
Hämtar eller anger y-koordinatsamlingen (vågrät) riktlinje. |
Metoder
| Name | Description |
|---|---|
| AddVisualChild(Visual) |
Definierar relationen mellan överordnad och underordnad mellan två visuella objekt. |
| CheckAccess() |
Avgör om den anropande tråden har åtkomst till den här DispatcherObject. (Ärvd från DispatcherObject) |
| ClearValue(DependencyProperty) |
Rensar det lokala värdet för en egenskap. Egenskapen som ska rensas anges av en DependencyProperty identifierare. (Ärvd från DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Rensar det lokala värdet för en skrivskyddad egenskap. Egenskapen som ska rensas anges av en DependencyPropertyKey. (Ärvd från DependencyObject) |
| CoerceValue(DependencyProperty) |
Tvingar fram värdet för den angivna beroendeegenskapen. Detta uppnås genom att anropa alla CoerceValueCallback funktioner som anges i egenskapsmetadata för beroendeegenskapen eftersom den finns på anropet DependencyObject. (Ärvd från DependencyObject) |
| Equals(Object) |
Avgör om en angivet DependencyObject motsvarar den aktuella DependencyObject. (Ärvd från DependencyObject) |
| FindCommonVisualAncestor(DependencyObject) |
Returnerar den gemensamma överordnad för två visuella objekt. |
| GetHashCode() |
Hämtar en hash-kod för den här DependencyObject. (Ärvd från DependencyObject) |
| GetLocalValueEnumerator() |
Skapar en specialiserad uppräknare för att avgöra vilka beroendeegenskaper som har lokalt angivna värden för den här DependencyObject. (Ärvd från DependencyObject) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| GetValue(DependencyProperty) |
Returnerar det aktuella effektiva värdet för en beroendeegenskap för den här instansen av en DependencyObject. (Ärvd från DependencyObject) |
| GetVisualChild(Int32) |
Returnerar angivet Visual i den överordnade VisualCollection. |
| HitTestCore(GeometryHitTestParameters) |
Avgör om ett geometrivärde ligger inom gränserna för det visuella objektet. |
| HitTestCore(PointHitTestParameters) |
Avgör om ett punktkoordinatvärde ligger inom gränserna för det visuella objektet. |
| InvalidateProperty(DependencyProperty) |
Utvärderar det effektiva värdet för den angivna beroendeegenskapen igen. (Ärvd från DependencyObject) |
| IsAncestorOf(DependencyObject) |
Avgör om det visuella objektet är en överordnad objekt för det underordnade visuella objektet. |
| IsDescendantOf(DependencyObject) |
Avgör om det visuella objektet är underordnat det överordnade visuella objektet. |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| OnDpiChanged(DpiScale, DpiScale) |
Anropas när DPI:et där den här vyn återges ändras. |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Anropas när det effektiva värdet för någon beroendeegenskap DependencyObject har uppdaterats. Den specifika beroendeegenskap som ändrades rapporteras i händelsedata. (Ärvd från DependencyObject) |
| OnVisualChildrenChanged(DependencyObject, DependencyObject) |
Anropas när objektet VisualCollection för det visuella objektet ändras. |
| OnVisualParentChanged(DependencyObject) |
Anropas när det överordnade objektet för det visuella objektet ändras. |
| PointFromScreen(Point) |
Konverterar en Point i-skärmkoordinat till en Point som representerar det aktuella koordinatsystemet för Visual. |
| PointToScreen(Point) |
Konverterar ett Point som representerar det aktuella koordinatsystemet för Visual till en Point i skärmkoordinater. |
| ReadLocalValue(DependencyProperty) |
Returnerar det lokala värdet för en beroendeegenskap, om den finns. (Ärvd från DependencyObject) |
| RemoveVisualChild(Visual) |
Tar bort relationen mellan överordnad och underordnad mellan två visuella objekt. |
| SetCurrentValue(DependencyProperty, Object) |
Anger värdet för en beroendeegenskap utan att ändra dess värdekälla. (Ärvd från DependencyObject) |
| SetValue(DependencyProperty, Object) |
Anger det lokala värdet för en beroendeegenskap som anges av dess beroendeegenskapsidentifierare. (Ärvd från DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Anger det lokala värdet för en skrivskyddad beroendeegenskap som anges av identifieraren DependencyPropertyKey för beroendeegenskapen. (Ärvd från DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Returnerar ett värde som anger om serialiseringsprocesser ska serialisera värdet för den angivna beroendeegenskapen. (Ärvd från DependencyObject) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| TransformToAncestor(Visual) |
Returnerar en transformering som kan användas för att transformera koordinater från Visual till angiven överordnad Visual för det visuella objektet. |
| TransformToAncestor(Visual3D) |
Returnerar en transformering som kan användas för att transformera koordinater från Visual till angiven överordnad Visual3D för det visuella objektet. |
| TransformToDescendant(Visual) |
Returnerar en transformering som kan användas för att transformera koordinater från Visual till det angivna visuella objektets underordnade objekt. |
| TransformToVisual(Visual) |
Returnerar en transformering som kan användas för att transformera koordinater från Visual till det angivna visuella objektet. |
| VerifyAccess() |
Framtvingar att den anropande tråden har åtkomst till den här DispatcherObject. (Ärvd från DispatcherObject) |
