Compartir a través de


ListBoxItem

ListBoxItem representa un elemento individual seleccionable dentro de un control ListBox. Al agregar elementos a una colección ListBox, WPF ajusta automáticamente cada elemento en un contenedor ListBoxItem.

El control ListBoxItem proporciona propiedades visuales y de comportamiento para elementos de lista individuales, entre los que se incluyen:

  • Comportamiento de selección: controla cómo responde el elemento a la selección del usuario.
  • Estados visuales : administra los cambios de apariencia cuando se mantiene el puntero, se selecciona o se centra el elemento.
  • Presentación de contenido : muestra los datos o el contenido reales de ese elemento específico.

Puede personalizar la apariencia y el comportamiento de los contenedores ListBoxItem mediante el estilo de ListBoxItem directamente o definiendo un ItemContainerStyle personalizado en el listBox primario.

Estilos y plantillas

Puede modificar el valor predeterminado ControlTemplate para dar al ListBoxItem control una apariencia única. Para obtener más información, vea ¿Qué son los estilos y las plantillas? yCómo crear una plantilla para un control.

Content (propiedad)

El ListBoxItem control usa la Content propiedad como su propiedad de contenido. Esta propiedad determina qué se muestra dentro de cada elemento de lista y admite varios tipos de contenido, como texto, imágenes y elementos complejos de la interfaz de usuario.

Partes

El ListBoxItem control no define ningún elemento de plantilla con nombre.

Estados visuales

En la tabla siguiente se enumeran los estados visuales del ListBoxItem control.

Nombre de VisualState Nombre de VisualStateGroup Description
Normal CommonStates El control está en su estado normal.
pasar el ratón por encima CommonStates El ratón está sobre el control.
Disabled CommonStates El control está deshabilitado.
Focused FocusStates El control tiene el foco del teclado.
Sin enfoque FocusStates El control no tiene el foco del teclado.
Seleccionado SelectionStates El control está seleccionado.
SeleccionadoDesenfocado SelectionStates El control está seleccionado, pero no tiene el foco del teclado.
No seleccionado SelectionStates El control no está seleccionado.
EnfoqueInválido Estados de Validación El control tiene un error de validación y tiene el foco del teclado.
InválidoSinEnfoque Estados de Validación El control presenta un error de validación, pero no tiene el enfoque del teclado.
Validar Estados de Validación El control es válido y no tiene errores de validación.

Consulte también