Visual Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt renderingondersteuning in WPF, waaronder hittests, coördinaattransformatie en begrenzingsvakberekeningen.
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- Overname
- Afgeleid
Opmerkingen
De Visual klasse is de basisabstractie waaruit elk FrameworkElement object is afgeleid. Het fungeert ook als toegangspunt voor het schrijven van nieuwe besturingselementen in WPF, en op veel manieren kan worden beschouwd als een equivalent van een venstergreep (HWND) in het Win32-toepassingsmodel.
Het Visual-object is een WPF-kernobject, waarvan de primaire rol is om renderingondersteuning te bieden. Besturingselementen voor de gebruikersinterface, zoals Button en TextBox, zijn afgeleid van de Visual klasse en gebruiken de gedefinieerde eigenschappen voor het Visual behouden van hun renderinggegevens. Het Visual object biedt ondersteuning voor het volgende:
Uitvoerweergave: De persistente, geserialiseerde tekeninhoud van een visual weergeven.
Transformaties: transformaties uitvoeren op een visual.
Clippen: Het ondersteunen van het clippen van een regio voor een visual.
Hittests: Bepalen of een opgegeven coördinaat (punt) of geometrie zich binnen de grenzen van een visual bevindt.
Berekeningen van begrenzingsvakken: de begrenzingsrechthoek van een visual bepalen.
Het object Visual bevat architectuur geen ondersteuning voor andere vereisten voor het ontwikkelen van toepassingen/WPF functies die niet direct zijn gerelateerd aan de rendering, zoals:
Gebeurtenisafhandeling
Layout
Styles
Gegevensbinding
Globalisatie
Visual wordt geleverd als een openbare abstracte klasse waaruit verdere klassen kunnen worden afgeleid. In de volgende afbeelding ziet u de hiërarchie van de bestaande visuele objecten die zijn gedefinieerd in de WPF-architectuur.
Hiërarchie van visuele klassen
In sommige gevallen worden leden die zijn gedefinieerd als beveiligd Visual , weergegeven als beter toegankelijke leden met vergelijkbare namen in de afgeleide UIElement klasse.
Zie WPF Graphics Rendering Overviewvoor meer informatie.
A Visual heeft een beperkt aantal niveaus. In eerdere versies van het .NET Framework was deze maximale diepte 255. Deze limiet is ontoereikend voor sommige indelingen met veel niveaus in de visuele structuur.
In .NET Framework 4 is de maximale diepte van een Visual 2047, wat veel diepere visuele bomen mogelijk maakt. In de meeste toepassingen is er onvoldoende stackruimte om zoveel niveaus te doorlopen en is het resultaat een StackOverflowException tijdens de indeling. Voor de standaardstackgrootte wordt deze uitzondering meestal gegenereerd wanneer de structuurdiepte ongeveer 800 is, wat overeenkomt met ongeveer 190 geneste TreeViewItem objecten.
Als deze uitzondering wordt gegenereerd door uw toepassing en u een diepere visuele structuur moet hebben, kunt u de stackgrootte van de toepassing vergroten. U kunt de grootte van de stack vergroten met behulp van de optie /STACK tijdens het compileren of met behulp van het hulpprogramma EDITBIN. Het vergroten van de stackgrootte kan van invloed zijn op de prestaties van uw toepassing. Zie Stack Allocations en EDITBIN Options voor meer informatie.
Constructors
| Name | Description |
|---|---|
| Visual() |
Biedt de basisinitialisatie voor objecten die zijn afgeleid van de Visual klasse. |
Eigenschappen
| Name | Description |
|---|---|
| DependencyObjectType |
Hiermee haalt u het DependencyObjectType CLR-type van dit exemplaar op. (Overgenomen van DependencyObject) |
| Dispatcher |
Hiermee wordt de Dispatcher aan dit DispatcherObject gekoppelde bestand. (Overgenomen van DispatcherObject) |
| IsSealed |
Hiermee wordt een waarde opgehaald die aangeeft of dit exemplaar momenteel is verzegeld (alleen-lezen). (Overgenomen van DependencyObject) |
| VisualBitmapEffect |
Verouderd.
Verouderd.
Hiermee haalt of stelt u de BitmapEffect waarde voor de Visual. |
| VisualBitmapEffectInput |
Verouderd.
Verouderd.
Hiermee haalt of stelt u de BitmapEffectInput waarde voor de Visual. |
| VisualBitmapScalingMode |
Haalt of stelt de BitmapScalingMode voor de Visual. |
| VisualCacheMode |
Hiermee haalt u een in de cache opgeslagen weergave van de Visual. |
| VisualChildrenCount |
Hiermee haalt u het aantal onderliggende elementen voor de Visual. |
| VisualClearTypeHint |
Hiermee wordt de ClearTypeHint opdracht opgehaald of ingesteld die bepaalt hoe ClearType wordt weergegeven in de Visual. |
| VisualClip |
Hiermee haalt u het clipgebied van de waarde op of stelt u deze Visual in Geometry . |
| VisualEdgeMode |
Hiermee haalt u de randmodus van de als een Visual waarde op of stelt u deze EdgeMode in. |
| VisualEffect |
Hiermee haalt u het bitmapeffect op of stelt u dit in op de Visual. |
| VisualOffset |
Hiermee haalt u de offsetwaarde van het visuele object op of stelt u deze in. |
| VisualOpacity |
Haalt of stelt de dekking van de Visual. |
| VisualOpacityMask |
Hiermee wordt de Brush waarde opgehaald of ingesteld die het dekkingsmasker van de Visual. |
| VisualParent |
Hiermee wordt de bovenliggende visualstructuur van het visualobject opgehaald. |
| VisualScrollableAreaClip |
Hiermee haalt u een geknipt schuifbaar gebied voor de Visual. |
| VisualTextHintingMode |
Haalt of stelt de TextHintingMode van de Visual. |
| VisualTextRenderingMode |
Haalt of stelt de TextRenderingMode van de Visual. |
| VisualTransform |
Hiermee haalt of stelt u de Transform waarde voor de Visual. |
| VisualXSnappingGuidelines |
Hiermee haalt u de x-coördinaat (verticale) richtlijnverzameling op of stelt u deze in. |
| VisualYSnappingGuidelines |
Hiermee haalt u de y-coördinaat (horizontale) richtlijnverzameling op of stelt u deze in. |
Methoden
| Name | Description |
|---|---|
| AddVisualChild(Visual) |
Definieert de bovenliggende en onderliggende relatie tussen twee visuals. |
| CheckAccess() |
Bepaalt of de aanroepende thread toegang heeft tot dit DispatcherObject. (Overgenomen van DispatcherObject) |
| ClearValue(DependencyProperty) |
Hiermee wist u de lokale waarde van een eigenschap. De eigenschap die moet worden gewist, wordt opgegeven door een DependencyProperty id. (Overgenomen van DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Hiermee wist u de lokale waarde van een alleen-lezen eigenschap. De eigenschap die moet worden gewist, wordt opgegeven door een DependencyPropertyKey. (Overgenomen van DependencyObject) |
| CoerceValue(DependencyProperty) |
Hiermee wordt de waarde van de opgegeven afhankelijkheidseigenschap gecodeerd. Dit wordt bereikt door een CoerceValueCallback functie aan te roepen die is opgegeven in eigenschapsmetagegevens voor de afhankelijkheidseigenschap, zoals deze bestaat bij het aanroepen DependencyObject. (Overgenomen van DependencyObject) |
| Equals(Object) |
Bepaalt of een opgegeven DependencyObject gelijk is aan de huidige DependencyObject. (Overgenomen van DependencyObject) |
| FindCommonVisualAncestor(DependencyObject) |
Retourneert de gemeenschappelijke voorouder van twee visuele objecten. |
| GetHashCode() |
Hiermee haalt u een hashcode op.DependencyObject (Overgenomen van DependencyObject) |
| GetLocalValueEnumerator() |
Hiermee maakt u een gespecialiseerde enumerator om te bepalen welke afhankelijkheidseigenschappen lokaal waarden hebben ingesteld.DependencyObject (Overgenomen van DependencyObject) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| GetValue(DependencyProperty) |
Retourneert de huidige effectieve waarde van een afhankelijkheidseigenschap op dit exemplaar van een DependencyObject. (Overgenomen van DependencyObject) |
| GetVisualChild(Int32) |
Retourneert de opgegeven in het bovenliggende VisualVisualCollectionitem. |
| HitTestCore(GeometryHitTestParameters) |
Bepaalt of een geometriewaarde binnen de grenzen van het visuele object valt. |
| HitTestCore(PointHitTestParameters) |
Bepaalt of een puntcoördinaatwaarde binnen de grenzen van het visuele object valt. |
| InvalidateProperty(DependencyProperty) |
Evalueert de effectieve waarde voor de opgegeven afhankelijkheidseigenschap opnieuw. (Overgenomen van DependencyObject) |
| IsAncestorOf(DependencyObject) |
Bepaalt of het visuele object een bovenliggend element van het onderliggende visuele object is. |
| IsDescendantOf(DependencyObject) |
Bepaalt of het visuele object een afstammeling is van het bovenliggende visuele object. |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| OnDpiChanged(DpiScale, DpiScale) |
Wordt aangeroepen wanneer de DPI waarmee deze weergave wordt weergegeven, wordt gewijzigd. |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Aangeroepen wanneer de effectieve waarde van een afhankelijkheidseigenschap op deze DependencyObject eigenschap is bijgewerkt. De specifieke afhankelijkheidseigenschap die is gewijzigd, wordt gerapporteerd in de gebeurtenisgegevens. (Overgenomen van DependencyObject) |
| OnVisualChildrenChanged(DependencyObject, DependencyObject) |
Aangeroepen wanneer het VisualCollection visuele object wordt gewijzigd. |
| OnVisualParentChanged(DependencyObject) |
Aangeroepen wanneer het bovenliggende element van het visuele object wordt gewijzigd. |
| PointFromScreen(Point) |
Converteert een Point in schermcoördinaten naar een Point die het huidige coördinaatsysteem van de Visual. |
| PointToScreen(Point) |
Converteert een Point die het huidige coördinaatsysteem van het Visual systeem weergeeft in een Point schermcoördinaten. |
| ReadLocalValue(DependencyProperty) |
Retourneert de lokale waarde van een afhankelijkheidseigenschap, als deze bestaat. (Overgenomen van DependencyObject) |
| RemoveVisualChild(Visual) |
Hiermee verwijdert u de relatie tussen de bovenliggende en onderliggende elementen tussen twee visuals. |
| SetCurrentValue(DependencyProperty, Object) |
Hiermee stelt u de waarde van een afhankelijkheidseigenschap in zonder de waardebron te wijzigen. (Overgenomen van DependencyObject) |
| SetValue(DependencyProperty, Object) |
Hiermee stelt u de lokale waarde van een afhankelijkheidseigenschap in, die is opgegeven door de id van de afhankelijkheidseigenschap. (Overgenomen van DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Hiermee stelt u de lokale waarde van een alleen-lezen afhankelijkheidseigenschap in, die is opgegeven door de DependencyPropertyKey id van de afhankelijkheidseigenschap. (Overgenomen van DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Retourneert een waarde die aangeeft of serialisatieprocessen de waarde voor de opgegeven afhankelijkheidseigenschap moeten serialiseren. (Overgenomen van DependencyObject) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
| TransformToAncestor(Visual) |
Retourneert een transformatie die kan worden gebruikt om coördinaten te transformeren van de Visual opgegeven bovenliggende Visual waarde van het visuele object. |
| TransformToAncestor(Visual3D) |
Retourneert een transformatie die kan worden gebruikt om coördinaten te transformeren van de Visual opgegeven bovenliggende Visual3D waarde van het visuele object. |
| TransformToDescendant(Visual) |
Retourneert een transformatie die kan worden gebruikt om coördinaten te transformeren van de Visual naar de opgegeven onderliggende visualobject. |
| TransformToVisual(Visual) |
Retourneert een transformatie die kan worden gebruikt om coördinaten van het Visual opgegeven visuele object te transformeren. |
| VerifyAccess() |
Hiermee wordt afgedwongen dat de aanroepende thread toegang heeft tot dit DispatcherObject. (Overgenomen van DispatcherObject) |
