¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo
Expandir Minimizar
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

FrameworkElement.GetVisualChild (Método)

Invalida Visual.GetVisualChild y devuelve un elemento secundario situado en el índice especificado de una colección de elementos secundarios.

Espacio de nombres:  System.Windows
Ensamblado:  PresentationFramework (en PresentationFramework.dll)

protected override Visual GetVisualChild(
	int index
)

Parámetros

index
Tipo: System.Int32
Índice de base cero del elemento secundario solicitado en la colección.

Valor devuelto

Tipo: System.Windows.Media.Visual
Elemento secundario solicitado. Esto no debería devolver null; si el índice proporcionado está fuera del intervalo, se produce una excepción.

En la implementación de FrameworkElement, el único índice válido es cero. El modelo de contenido para GetVisualChild admite un elemento secundario o ninguno, no una colección.

Notas para los herederos

Esta implementación sólo es válida para los elementos que ya no mantienen una colección descriptiva de elementos secundarios visuales. Cualquier elemento que tenga este tipo de colección debe invalidar este método y asignar el índice a un índice equivalente en la colección de elementos secundarios admitida por ese elemento. Un índice en el intervalo del cero a VisualChildrenCount (menos uno) debe devolver un elemento válido; cualquier otro índice debe producir una excepción de fuera de intervalo. Un ejemplo de un tipo de elemento que admite una colección de elementos secundarios e invalida GetVisualChild para devolver más que un posible elemento secundario es Panel.

La implementación predeterminada de FrameworkElement asume que sólo existe un elemento secundario visual. Cualquier valor pasado a index distinto de cero hace que se produzca una excepción. Varios elementos comunes, como los decoradores, adornos o elementos con procesadores especializados, invalidan la implementación de FrameworkElement (en la implementación de las clases base intermedias). Algunas implementaciones todavía exigen un elemento secundario visual mientras que otras permiten una colección.

En el ejemplo siguiente se muestra cómo un adorno personalizado usa los valores declarados por VisualCollection, que mantiene para sus múltiples elementos secundarios visuales. Estos valores se notifican a través de las invalidaciones de VisualChildrenCount y GetVisualChild.


// To store and manage the adorner's visual children.
VisualCollection visualChildren;


...


// 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]; }


.NET Framework

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft