SimpleListBox y SimpleListBoxItem (soporte WPF en Blend)
.png "Esta página es específica de proyectos WPF")
El cuadro de lista es un control de elementos en forma de una lista desplazable. Para colocar contenido en un cuadro de lista en Blend para Visual Studio, haga doble clic en el cuadro de lista y, a continuación, dibuje un objeto (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 ItemsSource a datos para generar la colección de objetos 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
.png "JJ170163.542edff2-bb86-4d80-902d-93810083b1a9(es-es,VS.120).png")
Desglosar la plantilla de control
La plantilla del control SimpleListBox está formada por los siguientes elementos:
Un panel Grid , que se usa para que el cuadro de lista contenga varios objetos secundarios. El panel Grid también se usa porque facilita al diseñador de la interfaz de usuario de la aplicación (UI) la incorporación de más objetos a la plantilla.
Un elemento Border , que se usa porque incluye una propiedad BorderThickness que se puede enlazar mediante plantilla a la propiedad BorderThickness del control de 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 objeto ScrollViewer y organiza los elementos. La propiedad IsItemsHost de StackPanel se establece en True para identificar ScrollViewer como el objeto que mostrará los elementos del control de cuadro de lista al que se aplica esta plantilla. Para cambiar el elemento StackPanel a otro objeto de panel, haga clic con el botón secundario en el objeto StackPanel del 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 Grid , que se usa para que el elemento de cuadro de lista contenga varios objetos secundarios. También se usa el panel Grid porque facilita al diseñador la incorporación de más objetos a la plantilla.
Un elemento Border , que se usa porque incluye una propiedad BorderThickness que se puede enlazar mediante plantilla a la propiedad BorderThickness del control de botón al que se aplica esta plantilla.
Un elemento ContentPresenter , que está incluido dentro del objeto Grid y se enlaza automáticamente a la propiedad Content del control de elemento al que se aplica la plantilla.
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 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 es True, la propiedad Background del objeto Border se cambia para indicar qué elemento del cuadro de lista se selecciona.
Pinceles usados
Los siguientes recursos de pincel del diccionario de recursos SimpleStyles.xaml se utilizan en las plantillas SimpleListBox y SimpleListBoxItem:
La propiedad Background se establece mediante WindowBackgroundBrush cuando no hay ningún desencadenador activo y mediante DisabledBackgroundBrush cuando IsEnabled es False.
La propiedad BorderBrush 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 del elemento se establece mediante SelectedBackgroundBrush cuando se selecciona un elemento y la propiedad Foreground se establece mediante DisabledForegroundBrush cuando IsEnabled es False.