Silverlight - ListBox
Listbox es un control que proporciona una lista de elementos al usuario para la selección de un elemento. Un usuario puede seleccionar uno o más elementos de una lista predefinida de elementos a la vez. en unListBox, múltiples opciones siempre están visibles para el usuario sin ninguna interacción del usuario.
Un cuadro de lista presenta una lista desplazable de elementos. Si un usuario selecciona un elemento, el elemento seleccionado cambia de apariencia para indicar la selección. Admite una forma más amplia de modelo de contenido y botón. Una diferencia importante entre un botón y un cuadro de lista es que un botón contiene una sola pieza de contenido, mientras que un cuadro de lista permite todos los elementos de la lista.
La herencia jerárquica de la clase ListBox es la siguiente:
A continuación se muestran los Properties de ListBox clase.
No Señor. | Descripción de propiedad |
---|---|
1 | Background Obtiene o establece un pincel que proporciona el fondo del control. (Heredado de Control) |
2 | BorderThickness Obtiene o establece el grosor del borde de un control. (Heredado de Control) |
3 | FontFamily Obtiene o establece la fuente utilizada para mostrar texto en el control. (Heredado de Control) |
4 | FontSize Obtiene o establece el tamaño del texto en este control. (Heredado de Control) |
5 | FontStyle Obtiene o establece el estilo en el que se representa el texto. (Heredado de Control) |
6 | FontWeight Obtiene o establece el grosor de la fuente especificada. (Heredado de Control) |
7 | Foreground Obtiene o establece un pincel que describe el color de primer plano. (Heredado de Control) |
8 | GroupStyle Obtiene una colección de objetos GroupStyle que definen la apariencia de cada nivel de grupos. (Heredado de ItemsControl) |
9 | Height Obtiene o establece el alto sugerido de FrameworkElement. (Heredado de FrameworkElement) |
10 | HorizontalAlignment Obtiene o establece las características de alineación horizontal que se aplican a FrameworkElement cuando se compone en un elemento primario de diseño, como un panel o un control de elementos. (Heredado de FrameworkElement) |
11 | IsEnabled Obtiene o establece un valor que indica si el usuario puede interactuar con el control. (Heredado de Control) |
12 | Item Obtiene la colección utilizada para generar el contenido del control. (Heredado de ItemsControl) |
13 | ItemsSource Obtiene o establece un origen de objeto que se utiliza para generar el contenido de ItemsControl. (Heredado de ItemsControl) |
14 | Margin Obtiene o establece el margen exterior de FrameworkElement. (Heredado de FrameworkElement) |
15 | Name Obtiene o establece el nombre de identificación del objeto. Cuando un procesador XAML crea el árbol de objetos a partir del marcado XAML, el código en tiempo de ejecución puede hacer referencia al objeto declarado XAML con este nombre. (Heredado de FrameworkElement) |
dieciséis | Opacity Obtiene o establece el grado de opacidad del objeto. (Heredado de UIElement) |
17 | SelectedIndex Obtiene o establece el índice del elemento seleccionado. (Heredado de Selector) |
18 | SelectedItem Obtiene o establece el elemento seleccionado. (Heredado de Selector) |
19 | SelectedValue Obtiene o establece el valor del elemento seleccionado, obtenido mediante SelectedValuePath. (Heredado de Selector) |
20 | Style Obtiene o establece un estilo de instancia que se aplica a este objeto durante el diseño y la representación. (Heredado de FrameworkElement) |
21 | VerticalAlignment Obtiene o establece las características de alineación vertical que se aplican a FrameworkElement cuando está compuesto en un objeto principal, como un panel o un control de elementos. (Heredado de FrameworkElement) |
22 | Width Obtiene o establece el ancho de FrameworkElement. (Heredado de FrameworkElement) |
A continuación se muestran los más utilizados Events de ListBox.
No Señor. | Descripción del evento |
---|---|
1 | DragEnter Ocurre cuando el sistema de entrada informa un evento de arrastre subyacente con este elemento como destino. (Heredado de UIElement) |
2 | DragLeave Ocurre cuando el sistema de entrada informa un evento de arrastre subyacente con este elemento como origen. (Heredado de UIElement) |
3 | DragOver Se produce cuando el sistema de entrada informa de un evento de arrastre subyacente con este elemento como posible destino de colocación. (Heredado de UIElement) |
4 | DragStarting Ocurre cuando se inicia una operación de arrastre. (Heredado de UIElement) |
5 | Drop Ocurre cuando el sistema de entrada informa un evento de caída subyacente con este elemento como destino de caída. (Heredado de UIElement) |
6 | DropCompleted Se produce cuando finaliza una operación de arrastrar y soltar. (Heredado de UIElement) |
7 | GotFocus Se produce cuando un UIElement recibe el foco. (Heredado de UIElement) |
8 | IsEnabledChanged Se produce cuando cambia la propiedad IsEnabled. (Heredado de Control) |
9 | KeyDown Se produce cuando se presiona una tecla del teclado mientras UIElement tiene el foco. (Heredado de UIElement) |
10 | KeyUp Se produce cuando se suelta una tecla del teclado mientras UIElement tiene el foco. (Heredado de UIElement) |
11 | LostFocus Se produce cuando un UIElement pierde el foco. (Heredado de UIElement) |
12 | SelectionChanged Ocurre cuando cambia el elemento seleccionado actualmente. (Heredado de Selector) |
13 | SizeChanged Se produce cuando la propiedad ActualHeight o ActualWidth cambia el valor en un FrameworkElement. (Heredado de FrameworkElement) |
A continuación se muestran los más utilizados Methods de ListBox.
No Señor. | Método y descripción |
---|---|
1 | Arrange Coloca objetos secundarios y determina un tamaño para un UIElement. Los objetos principales que implementan un diseño personalizado para sus elementos secundarios deben llamar a este método desde sus implementaciones de anulación de diseño para formar una actualización de diseño recursiva. (Heredado de UIElement) |
2 | FindName Recupera un objeto que tiene el nombre de identificador especificado. (Heredado de FrameworkElement) |
3 | Focus Intenta establecer el foco en el control. (Heredado de Control) |
4 | GetValue Devuelve el valor efectivo actual de una propiedad de dependencia de DependencyObject. (Heredado de DependencyObject) |
5 | IndexFromContainer Devuelve el índice del elemento que tiene el contenedor generado especificado. (Heredado de ItemsControl) |
6 | OnDragEnter Llamado antes de que ocurra el evento DragEnter. (Heredado de Control) |
7 | OnDragLeave Se llama antes de que se produzca el evento DragLeave. (Heredado de Control) |
8 | OnDragOver Se llama antes de que ocurra el evento DragOver. (Heredado de Control) |
9 | OnDrop Llamado antes de que ocurra el evento Drop. (Heredado de Control) |
10 | OnKeyDown Llamado antes de que ocurra el evento KeyDown. (Heredado de Control) |
11 | OnKeyUp Llamado antes de que ocurra el evento KeyUp. (Heredado de Control) |
12 | OnLostFocus Se llama antes de que se produzca el evento LostFocus. (Heredado de Control) |
13 | ReadLocalValue Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject) |
14 | SetBinding Adjunta un enlace a FrameworkElement, utilizando el objeto de enlace proporcionado. (Heredado de FrameworkElement) |
15 | SetValue Establece el valor local de una propiedad de dependencia en un DependencyObject. (Heredado de DependencyObject) |
Veamos un ejemplo simple en el que se agregan diferentes elementos de la interfaz de usuario en una ListBox.
<UserControl x:Class = "ListBoxExample.MainPage"
xmlns = "http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x = "http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:d = "http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc = "http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable = "d" d:DesignWidth = "640" d:DesignHeight = "480">
<Grid x:Name = "LayoutRoot">
<ListBox x:Name = "myList">
<TextBlock Text = "First item" />
<Button Content = "Second item" />
<Path Fill = "Blue" Data = "M4,0 l-4,10 8,0z M15,0 l-4,10 8,0z M26,0 l4,10 8,0z"
Margin = "10" />
<StackPanel Orientation = "Horizontal">
<Ellipse Fill = "Red" Height = "30" Width = "100" />
<TextBlock Text = "Name: " />
<TextBox Width = "200" />
</StackPanel>
<TextBlock Text = "More..." />
</ListBox>
</Grid>
</UserControl>
A continuación se muestra la implementación de C #.
using System.Windows.Controls;
namespace ListBoxExample {
public partial class MainPage : UserControl {
public MainPage() {
InitializeComponent();
myList.Items.Add("String entry");
myList.Items.Add(new Button { Content = "Content entry" });
}
}
}
Cuando se compile y ejecute el código anterior, verá un cuadro de lista que contiene una mezcla de texto gráfico y también un campo editable donde puede escribir el texto.
No Señor. | Controles y descripción |
---|---|
1 | Calendario y selector de fecha Calendar & DatePicker representa un control que permite a un usuario seleccionar una fecha usando una pantalla de calendario visual. Proporciona una navegación básica con el mouse o el teclado. |
2 | TabControl Un contenedor que coloca elementos en pestañas independientes y permite al usuario ver solo una pestaña a la vez. Permite al usuario seleccionar entre varias vistas diferentes haciendo clic en los encabezados de las pestañas. |
3 | Surgir Esta clase muestra el contenido sobre el contenido existente, dentro de los límites de la ventana de la aplicación. Es una visualización temporal en el otro contenido. |
4 | ToolTip La información sobre herramientas representa un control que crea una ventana emergente que muestra información para un elemento en la GUI. Silverlight le permite adjuntar información sobre herramientas a cualquier control. |