FrameworkElement.GetVisualChild(Int32) Methode
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.
Overschrijft en retourneert GetVisualChild(Int32)een onderliggend element in de opgegeven index van een verzameling onderliggende elementen.
protected:
override System::Windows::Media::Visual ^ GetVisualChild(int index);protected override System.Windows.Media.Visual GetVisualChild(int index);override this.GetVisualChild : int -> System.Windows.Media.VisualProtected Overrides Function GetVisualChild (index As Integer) As VisualParameters
- index
- Int32
De op nul gebaseerde index van het aangevraagde onderliggende element in de verzameling.
Retouren
Het aangevraagde onderliggende element. Dit mag niet worden geretourneerd null; als de opgegeven index buiten het bereik valt, wordt er een uitzondering gegenereerd.
Voorbeelden
In het volgende voorbeeld ziet u hoe een aangepaste versier de waarden gebruikt die zijn gedeclareerd door een VisualCollection die voor de onderliggende elementen van de visual meerdere elementen onderhoudt. Deze waarden worden gerapporteerd via onderdrukkingen van VisualChildrenCount en GetVisualChild.
// To store and manage the adorner's visual children.
VisualCollection visualChildren;
' To store and manage the adorner's visual children.
Private visualChildren As VisualCollection
// Override the VisualChildrenCount and GetVisualChild properties to interface with
// the adorner's visual collection.
protected override int VisualChildrenCount { get { return visualChildren.Count; } }
protected override Visual GetVisualChild(int index) { return visualChildren[index]; }
' Override the VisualChildrenCount and GetVisualChild properties to interface with
' the adorner's visual collection.
Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
Get
Return visualChildren.Count
End Get
End Property
Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
Return visualChildren(index)
End Function
Opmerkingen
In de FrameworkElement implementatie is de enige geldige index nul. Het inhoudsmodel voor GetVisualChild ondersteunt nul of één onderliggende elementen, niet een verzameling.
Notities voor overnemers
Deze implementatie is alleen geldig voor elementen die geen beschrijvende verzameling visuele onderliggende elementen onderhouden. Elk element dat een dergelijke verzameling heeft, moet deze methode overschrijven en de index toewijzen aan een equivalente index in de onderliggende elementverzameling die wordt ondersteund door dat element. Een index in het bereik van nul tot VisualChildrenCount (min één) moet een geldig element retourneren. Elke andere index moet een uitzondering buiten het bereik genereren. Een voorbeeld van een elementtype dat wel ondersteuning biedt voor een onderliggende verzameling en onderdrukkingen GetVisualChild(Int32) om meer dan één mogelijk onderliggend element te retourneren, is Panel.
Bij de standaard implementatie wordt FrameworkElement uitgegaan van slechts één onderliggende visual. Elke waarde die wordt doorgegeven voor index andere dan nul, zorgt ervoor dat er een uitzondering wordt gegenereerd. Verschillende algemene elementen, zoals decorators, versieringen of elementen met gespecialiseerde rendering, overschrijven de FrameworkElement implementatie (van de implementatie van tussenliggende basisklassen). Bij sommige implementaties wordt nog steeds één visueel onderliggend element afgedwongen, terwijl andere een verzameling toestaan.
