Silverlight - ListBox
Listbox é um controle que fornece uma lista de itens ao usuário para a seleção de um item. Um usuário pode selecionar um ou mais itens de uma lista predefinida de itens por vez. Em umListBox, várias opções estão sempre visíveis para o usuário sem qualquer interação do usuário.
Uma caixa de listagem apresenta uma lista rolável de itens. Se um usuário selecionar um item, o item selecionado muda de aparência para indicar a seleção. Ele oferece suporte a uma forma mais ampla de modelo de conteúdo e Botão. A principal diferença entre um botão e uma caixa de listagem é que um botão contém uma única parte do conteúdo, enquanto uma caixa de listagem permite todos os itens da lista.
A herança hierárquica da classe ListBox é a seguinte -
Dada a seguir são os comumente usados Properties do ListBox classe.
Sr. Não. | Descrição da Propriedade |
---|---|
1 | Background Obtém ou define um pincel que fornece o plano de fundo do controle. (Herdado do controle) |
2 | BorderThickness Obtém ou define a espessura da borda de um controle. (Herdado do controle) |
3 | FontFamily Obtém ou define a fonte usada para exibir o texto no controle. (Herdado do controle) |
4 | FontSize Obtém ou define o tamanho do texto neste controle. (Herdado do controle) |
5 | FontStyle Obtém ou define o estilo no qual o texto é renderizado. (Herdado do controle) |
6 | FontWeight Obtém ou define a espessura da fonte especificada. (Herdado do controle) |
7 | Foreground Obtém ou define um pincel que descreve a cor do primeiro plano. (Herdado do controle) |
8 | GroupStyle Obtém uma coleção de objetos GroupStyle que definem a aparência de cada nível de grupos. (Herdado de ItemsControl) |
9 | Height Obtém ou define a altura sugerida de um FrameworkElement. (Herdado de FrameworkElement) |
10 | HorizontalAlignment Obtém ou define as características de alinhamento horizontal que são aplicadas a um FrameworkElement quando ele é composto em um layout pai, como um painel ou controle de itens. (Herdado de FrameworkElement) |
11 | IsEnabled Obtém ou define um valor que indica se o usuário pode interagir com o controle. (Herdado do controle) |
12 | Item Obtém a coleção usada para gerar o conteúdo do controle. (Herdado de ItemsControl) |
13 | ItemsSource Obtém ou define uma fonte de objeto usada para gerar o conteúdo do ItemsControl. (Herdado de ItemsControl) |
14 | Margin Obtém ou define a margem externa de um FrameworkElement. (Herdado de FrameworkElement) |
15 | Name Obtém ou define o nome de identificação do objeto. Quando um processador XAML cria a árvore de objetos da marcação XAML, o código de tempo de execução pode se referir ao objeto declarado por XAML por este nome. (Herdado de FrameworkElement) |
16 | Opacity Obtém ou define o grau de opacidade do objeto. (Herdado de UIElement) |
17 | SelectedIndex Obtém ou define o índice do item selecionado. (Herdado do Seletor) |
18 | SelectedItem Obtém ou define o item selecionado. (Herdado do Seletor) |
19 | SelectedValue Obtém ou define o valor do item selecionado, obtido usando o SelectedValuePath. (Herdado do Seletor) |
20 | Style Obtém ou define um estilo de instância que é aplicado a este objeto durante o layout e a renderização. (Herdado de FrameworkElement) |
21 | VerticalAlignment Obtém ou define as características de alinhamento vertical aplicadas a um FrameworkElement quando ele é composto em um objeto pai, como um painel ou controle de itens. (Herdado de FrameworkElement) |
22 | Width Obtém ou define a largura de um FrameworkElement. (Herdado de FrameworkElement) |
Dados abaixo são os mais comumente usados Events do ListBox.
Sr. Não. | Descrição do Evento |
---|---|
1 | DragEnter Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com este elemento como destino. (Herdado de UIElement) |
2 | DragLeave Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com este elemento como a origem. (Herdado de UIElement) |
3 | DragOver Ocorre quando o sistema de entrada relata um evento de arrastar subjacente com este elemento como o alvo potencial para soltar. (Herdado de UIElement) |
4 | DragStarting Ocorre quando uma operação de arrastar é iniciada. (Herdado de UIElement) |
5 | Drop Ocorre quando o sistema de entrada relata um evento de soltar subjacente com este elemento como o destino de soltar. (Herdado de UIElement) |
6 | DropCompleted Ocorre quando uma operação de arrastar e soltar é encerrada. (Herdado de UIElement) |
7 | GotFocus Ocorre quando um UIElement recebe o foco. (Herdado de UIElement) |
8 | IsEnabledChanged Ocorre quando a propriedade IsEnabled é alterada. (Herdado do controle) |
9 | KeyDown Ocorre quando uma tecla do teclado é pressionada enquanto o UIElement está em foco. (Herdado de UIElement) |
10 | KeyUp Ocorre quando uma tecla do teclado é liberada enquanto o UIElement está em foco. (Herdado de UIElement) |
11 | LostFocus Ocorre quando um UIElement perde o foco. (Herdado de UIElement) |
12 | SelectionChanged Ocorre quando o item selecionado atualmente é alterado. (Herdado do Seletor) |
13 | SizeChanged Ocorre quando a propriedade ActualHeight ou ActualWidth altera o valor em um FrameworkElement. (Herdado de FrameworkElement) |
Dados abaixo são os mais comumente usados Methods do ListBox.
Sr. Não. | Método e Descrição |
---|---|
1 | Arrange Posiciona objetos filho e determina um tamanho para um UIElement. Os objetos pais que implementam layout personalizado para seus elementos filhos devem chamar esse método a partir de suas implementações de substituição de layout para formar uma atualização de layout recursiva. (Herdado de UIElement) |
2 | FindName Recupera um objeto que possui o nome do identificador especificado. (Herdado de FrameworkElement) |
3 | Focus Tenta definir o foco no controle. (Herdado do controle) |
4 | GetValue Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject. (Herdado de DependencyObject) |
5 | IndexFromContainer Retorna o índice para o item que possui o contêiner gerado especificado. (Herdado de ItemsControl) |
6 | OnDragEnter Chamado antes da ocorrência do evento DragEnter. (Herdado do controle) |
7 | OnDragLeave Chamado antes de ocorrer o evento DragLeave. (Herdado do controle) |
8 | OnDragOver Chamado antes de ocorrer o evento DragOver. (Herdado do controle) |
9 | OnDrop Chamado antes de o evento Drop ocorrer. (Herdado do controle) |
10 | OnKeyDown Chamado antes de ocorrer o evento KeyDown. (Herdado do controle) |
11 | OnKeyUp Chamado antes de ocorrer o evento KeyUp. (Herdado do controle) |
12 | OnLostFocus Chamado antes de ocorrer o evento LostFocus. (Herdado do controle) |
13 | ReadLocalValue Retorna o valor local de uma propriedade de dependência, se um valor local for definido. (Herdado de DependencyObject) |
14 | SetBinding Anexa uma vinculação a um FrameworkElement, usando o objeto de vinculação fornecido. (Herdado de FrameworkElement) |
15 | SetValue Define o valor local de uma propriedade de dependência em um DependencyObject. (Herdado de DependencyObject) |
Vejamos um exemplo simples no qual diferentes elementos da IU são adicionados em um 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 seguir está a implementação do 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" });
}
}
}
Quando o código acima for compilado e executado, você verá uma caixa de listagem que contém uma mistura de texto gráfico e também um campo editável onde você pode digitar o texto.
Sr. Não. | Controles e descrição |
---|---|
1 | Calendário e seletor de data Calendar & DatePicker representa um controle que permite ao usuário selecionar uma data usando uma exibição de calendário visual. Ele fornece alguma navegação básica usando o mouse ou o teclado. |
2 | TabControl Um contêiner que coloca itens em guias separadas e permite que o usuário visualize apenas uma guia por vez. Ele permite que o usuário selecione a partir de várias visualizações diferentes clicando nos cabeçalhos da guia. |
3 | Aparecer Esta classe exibe o conteúdo sobre o conteúdo existente, dentro dos limites da janela do aplicativo. É uma exibição temporária do outro conteúdo. |
4 | Dica de ferramenta A dica de ferramenta representa um controle que cria uma janela pop-up que exibe informações para um elemento na GUI. O Silverlight permite anexar uma dica de ferramenta a qualquer controle. |