SimpleListBox y SimpleListBoxItem

This page applies to WPF projects only

El cuadro de lista es un control de elementos en forma de una lista desplazable. Para colocar contenido en un cuadro de lista en Microsoft Expression Blend, haga doble clic en el cuadro de lista y, a continuación, dibuje un elemento (como un rectángulo) en él. Otra posibilidad es hacer clic con el botón secundario en el cuadro de lista del panel Objetos y escala de tiempo y, a continuación, hacer clic en Agregar SimpleListBoxItem para agregar elementos individuales a la colección, o bien hacer clic en Enlazar ItemsSourcea datos para generar la colección de elementos SimpleListBoxItem desde un origen de datos. Si agrega elementos individuales a la colección, puede reorganizar los elementos haciendo doble clic en el cuadro de lista para activarlo y, a continuación, arrastrando los elementos para cambiarlos al orden deseado. Puede establecer los elementos que se seleccionan con la propiedad SelectedIndex (índice seleccionado) del cuadro de lista.

Vista de la mesa de trabajo de un control SimpleListBox después de agregar dos elementos

Cc295293.542edff2-bb86-4d80-902d-93810083b1a9(ES-ES,Expression.30).png

Desglosar la plantilla de control

La plantilla del control SimpleListBox está formada por los siguientes elementos:

  • Un panel de cuadrícula, que se usa para que el cuadro de lista contenga varios elementos secundarios. El panel de cuadrícula Grid también se usa porque facilita al diseñador de la interfaz de usuario de la aplicación la adición de otros elementos a la plantilla.

  • Un elemento Border, que se usa porque incluye una propiedad BorderThickness (grosor del borde) que se puede enlazar mediante una plantilla a la propiedad BorderThickness (grosor del borde) del cuadro de lista al que se aplica esta plantilla.

  • Un elemento ScrollViewer, que se usa para permitir al usuario de la aplicación desplazarse si la lista es demasiado larga.

  • Un elemento StackPanel, que está incluido en el elemento ScrollViewer y organiza los elementos. La propiedad IsItemsHost (es host de elementos)de StackPanel se establece en True para identificar ScrollViewer como el elemento que mostrará los elementos del control de cuadro de lista al que se aplica esta plantilla. Para cambiar el elemento StackPanel a otro elemento de panel, haga clic con el botón secundario en el elemento StackPanel en el panel Objetos y escala de tiempo y, a continuación, seleccione Cambiar tipo de diseño y elija otro panel, como UniformGrid.

La plantilla del control SimpleListBoxItem está formada por los siguientes elementos:

  • Un panel de cuadrícula, que se usa para que el elemento de cuadro de lista contenga varios elementos secundarios. Además, el uso de Grid facilita al diseñador la adición de otros elementos a la plantilla.

  • Un elemento Border, que se usa porque incluye una propiedad BorderThickness (grosor del borde) que se puede enlazar mediante una plantilla a la propiedad BorderThickness (grosor del borde) del control de botón al que se aplica la plantilla.

  • Un elemento ContentPresenter, que está incluido dentro del elemento Grid y se enlaza automáticamente a la propiedad Content (contenido) del control de elemento al que se aplica la plantilla.

    Vista de objetos: partes básicas (plantilla) de un control SimpleListBox (izquierda) y un control SimpleListBoxItem (derecha)

    Cc295293.0ad09c5f-f7f2-474d-b236-4b7d3952e69f(ES-ES,Expression.30).pngCc295293.db944557-0b57-4b64-ba83-70c0cdd8f914(ES-ES,Expression.30).png

Desencadenadores de propiedad usados

Los desencadenadores de propiedad de la plantilla de control sirven para hacer que el control reaccione ante los cambios de propiedad. Puede hacer clic en los elementos en el panel Desencadenadores para ver las propiedades que cambian cuando se activa un desencadenador. Por ejemplo, en la plantilla del cuadro de lista, si la propiedad IsSelected (está seleccionado) de un elemento del cuadro de lista es True, el color de fondo del elemento cambia. En la plantilla del elemento de cuadro de lista, si la propiedad IsHighlighted (está resaltado) es True, la propiedad Background (fondo) del elemento Border se cambia para indicar qué elemento del cuadro de lista se selecciona.

Pinceles usados

Las plantillas SimpleListBox y SimpleListBoxItem usan los siguientes recursos de pincel del diccionario de recursos SimpleStyles.xaml:

  • La propiedad Background (fondo) se establece mediante WindowBackgroundBrush cuando no hay ningún desencadenador activo y mediante DisabledBackgroundBrush cuando IsEnabled es False.

  • La propiedad BorderBrush (pincel del borde) se establece mediante SolidBorderBrush cuando no hay ningún desencadenador activo y mediante DisabledBorderBrush cuando IsEnabled es False.

  • Si SimpleListBox se ha llenado con elementos que usan la plantilla SimpleListBoxItem, la propiedad Background (fondo) del elemento se establece mediante SelectedBackgroundBrush cuando se selecciona un elemento y la propiedad Foreground (primer plano) se establece mediante DisabledForgroundBrush cuando IsEnabled es False.

Vea también

Tareas

Inténtelo: cambiar la apariencia del elemento seleccionado de un control SimpleListBox