FrameworkElement.AddLogicalChild(Object) Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega el objeto proporcionado al árbol lógico de este elemento.
protected public:
void AddLogicalChild(System::Object ^ child);protected internal void AddLogicalChild (object child);member this.AddLogicalChild : obj -> unitProtected Friend Sub AddLogicalChild (child As Object)- child
- Object
Elemento secundario que se va a agregar.
En el ejemplo siguiente se implementa una Child propiedad en un personalizado FrameworkElement que realiza su propia implementación de capa visual. El establecedor de propiedades está diseñado para que, si el valor cambia, el valor anterior se quita del árbol lógico, así como una colección visual específica de la clase. El valor de la propiedad se almacena en caché y, a continuación, el nuevo valor se agrega al árbol lógico y a la colección de objetos visuales personalizados.
public virtual UIElement Child
{
get
{
return _child;
}
set
{
if (_child != value)
{
//need to remove old element from logical tree
if (_child != null)
{
OnDetachChild(_child);
RemoveLogicalChild(_child);
}
_vc.Clear();
if (value != null)
{
//add to visual
_vc.Add(value);
//add to logical
AddLogicalChild(value);
}
//always add the overlay child back into the visual tree if its set
if (_overlayVisual != null)
_vc.Add(_overlayVisual);
//cache the new child
_child = value;
//notify derived types of the new child
if (value != null)
OnAttachChild(_child);
InvalidateMeasure();
}
}
}
<System.ComponentModel.DefaultValue(GetType(Object), Nothing)>
Public Overridable Property Child() As UIElement
Get
Return _child
End Get
Set(ByVal value As UIElement)
If _child IsNot value Then
'need to remove old element from logical tree
If _child IsNot Nothing Then
OnDetachChild(_child)
RemoveLogicalChild(_child)
End If
_vc.Clear()
If value IsNot Nothing Then
'add to visual
_vc.Add(value)
'add to logical
AddLogicalChild(value)
End If
'always add the overlay child back into the visual tree if its set
If _overlayVisual IsNot Nothing Then
_vc.Add(_overlayVisual)
End If
'cache the new child
_child = value
'notify derived types of the new child
If value IsNot Nothing Then
OnAttachChild(_child)
End If
InvalidateMeasure()
End If
End Set
End Property
Utilice este método para la implementación de colecciones en objetos que representan elementos secundarios lógicos de un elemento. El mantenimiento de colecciones para colecciones de elementos secundarios se puede realizar en captadores de propiedades o establecedores, control de clases de eventos modificados, constructores o dentro de los propios tipos de colección.
Para los autores de controles, manipular el árbol lógico en este nivel no es la práctica recomendada, a menos que ninguno de los modelos de contenido para las clases de control base disponibles sea adecuado para su escenario de control. Considere la posibilidad de crear subclases en el nivel de ContentControl, ItemsControly HeaderedItemsControl. Estas clases proporcionan un modelo de contenido con una aplicación concreta de elementos secundarios de árbol lógico a través de API dedicadas, así como compatibilidad con otras características que normalmente son deseables en un control WPF, como aplicar estilos a través de plantillas. Para obtener más información sobre cómo usar LogicalChildren y AddLogicalChild, vea Árboles en WPF.
AddLogicalChild puede producir una excepción si se llama en un momento en que otro proceso itera el árbol lógico.
| Producto | Versiones |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |