Silverlight - ListBox
Listbox to kontrolka udostępniająca użytkownikowi listę elementów do wyboru. Użytkownik może jednocześnie wybrać jeden lub więcej elementów ze wstępnie zdefiniowanej listy elementów. WListBox, wiele opcji jest zawsze widocznych dla użytkownika bez żadnej interakcji z użytkownikiem.
Listbox przedstawia przewijaną listę elementów. Jeśli użytkownik wybierze element, wybrany element zmienia wygląd, aby wskazać wybór. Obsługuje bardziej rozbudowaną formę modelu zawartości i przycisku. Główną różnicą między przyciskiem a polem listy jest to, że przycisk zawiera pojedynczą treść, podczas gdy pole listy pozwala na każdy element na liście.
Hierarchiczne dziedziczenie klasy ListBox jest następujące -
Podane poniżej są powszechnie używane Properties z ListBox klasa.
Sr. No. | Właściwość i opis |
---|---|
1 | Background Pobiera lub ustawia pędzel, który udostępnia tło formantu. (Odziedziczone po Control) |
2 | BorderThickness Pobiera lub ustawia grubość obramowania kontrolki. (Odziedziczone po Control) |
3 | FontFamily Pobiera lub ustawia czcionkę używaną do wyświetlania tekstu w kontrolce. (Odziedziczone po Control) |
4 | FontSize Pobiera lub ustawia rozmiar tekstu w tej kontrolce. (Odziedziczone po Control) |
5 | FontStyle Pobiera lub ustawia styl, w którym jest renderowany tekst. (Odziedziczone po Control) |
6 | FontWeight Pobiera lub ustawia grubość określonej czcionki. (Odziedziczone po Control) |
7 | Foreground Pobiera lub ustawia pędzel opisujący kolor pierwszego planu. (Odziedziczone po Control) |
8 | GroupStyle Pobiera kolekcję obiektów GroupStyle, które definiują wygląd każdego poziomu grup. (Odziedziczone po ItemsControl) |
9 | Height Pobiera lub ustawia sugerowaną wysokość FrameworkElement. (Odziedziczone po FrameworkElement) |
10 | HorizontalAlignment Pobiera lub ustawia charakterystyki wyrównania w poziomie, które są stosowane do FrameworkElement, gdy jest on składany w nadrzędnym układzie, takim jak panel lub kontrolka elementów. (Odziedziczone po FrameworkElement) |
11 | IsEnabled Pobiera lub ustawia wartość wskazującą, czy użytkownik może współdziałać z formantem. (Odziedziczone po Control) |
12 | Item Pobiera kolekcję używaną do generowania zawartości formantu. (Odziedziczone po ItemsControl) |
13 | ItemsSource Pobiera lub ustawia źródło obiektu używane do generowania zawartości ItemsControl. (Odziedziczone po ItemsControl) |
14 | Margin Pobiera lub ustawia zewnętrzny margines FrameworkElement. (Odziedziczone po FrameworkElement) |
15 | Name Pobiera lub ustawia nazwę identyfikującą obiektu. Gdy procesor XAML tworzy drzewo obiektów na podstawie znaczników XAML, kod czasu wykonywania może odwoływać się do obiektu zadeklarowanego w języku XAML o tej nazwie. (Odziedziczone po FrameworkElement) |
16 | Opacity Pobiera lub ustawia stopień krycia obiektu. (Odziedziczone po UIElement) |
17 | SelectedIndex Pobiera lub ustawia indeks wybranego elementu. (Odziedziczone po Selector) |
18 | SelectedItem Pobiera lub ustawia wybrany element. (Odziedziczone po Selector) |
19 | SelectedValue Pobiera lub ustawia wartość wybranego elementu uzyskaną przy użyciu SelectedValuePath. (Odziedziczone po Selector) |
20 | Style Pobiera lub ustawia styl wystąpienia, który jest stosowany dla tego obiektu podczas układu i renderowania. (Odziedziczone po FrameworkElement) |
21 | VerticalAlignment Pobiera lub ustawia cechy wyrównania w pionie, które są stosowane do FrameworkElement, gdy jest on składany w obiekcie nadrzędnym, takim jak panel lub kontrolka elementów. (Odziedziczone po FrameworkElement) |
22 | Width Pobiera lub ustawia szerokość FrameworkElement. (Odziedziczone po FrameworkElement) |
Podane poniżej są najczęściej używane Events z ListBox.
Sr. No. | Opis wydarzenia |
---|---|
1 | DragEnter Występuje, gdy system wejściowy zgłasza bazowe zdarzenie przeciągania z tym elementem jako celem. (Odziedziczone po UIElement) |
2 | DragLeave Występuje, gdy system wejściowy zgłasza bazowe zdarzenie przeciągania z tym elementem jako źródłem. (Odziedziczone po UIElement) |
3 | DragOver Występuje, gdy system wejściowy zgłasza bazowe zdarzenie przeciągania z tym elementem jako potencjalnym celem upuszczania. (Odziedziczone po UIElement) |
4 | DragStarting Występuje po zainicjowaniu operacji przeciągania. (Odziedziczone po UIElement) |
5 | Drop Występuje, gdy system wejściowy zgłasza bazowe zdarzenie upuszczania z tym elementem jako celem upuszczania. (Odziedziczone po UIElement) |
6 | DropCompleted Występuje po zakończeniu operacji przeciągania i upuszczania. (Odziedziczone po UIElement) |
7 | GotFocus Występuje, gdy UIElement otrzyma fokus. (Odziedziczone po UIElement) |
8 | IsEnabledChanged Występuje po zmianie właściwości IsEnabled. (Odziedziczone po Control) |
9 | KeyDown Występuje po naciśnięciu klawisza klawiatury, gdy element UIElement ma fokus. (Odziedziczone po UIElement) |
10 | KeyUp Występuje po wydaniu klawisza klawiatury, gdy element UIElement ma fokus. (Odziedziczone po UIElement) |
11 | LostFocus Występuje, gdy element UIElement traci fokus. (Odziedziczone po UIElement) |
12 | SelectionChanged Występuje, gdy zmieni się aktualnie wybrany element. (Odziedziczone po Selector) |
13 | SizeChanged Występuje, gdy właściwość ActualHeight lub ActualWidth zmieni wartość na FrameworkElement. (Odziedziczone po FrameworkElement) |
Podane poniżej są najczęściej używane Methods z ListBox.
Sr. No. | Metoda i opis |
---|---|
1 | Arrange Ustawia obiekty podrzędne i określa rozmiar elementu UIElement. Obiekty nadrzędne, które implementują układ niestandardowy dla swoich elementów podrzędnych, powinny wywoływać tę metodę z ich implementacji przesłaniających układ, aby utworzyć cykliczną aktualizację układu. (Odziedziczone po UIElement) |
2 | FindName Pobiera obiekt, który ma określoną nazwę identyfikatora. (Odziedziczone po FrameworkElement) |
3 | Focus Próbuje ustawić fokus na formancie. (Odziedziczone po Control) |
4 | GetValue Zwraca bieżącą efektywną wartość właściwości zależności z DependencyObject. (Odziedziczone po DependencyObject) |
5 | IndexFromContainer Zwraca indeks do elementu, który ma określony, wygenerowany kontener. (Odziedziczone po ItemsControl) |
6 | OnDragEnter Wywoływana przed wystąpieniem zdarzenia DragEnter. (Odziedziczone po Control) |
7 | OnDragLeave Wywoływana przed wystąpieniem zdarzenia DragLeave. (Odziedziczone po Control) |
8 | OnDragOver Wywoływana przed wystąpieniem zdarzenia DragOver. (Odziedziczone po Control) |
9 | OnDrop Wywoływane przed wystąpieniem zdarzenia Drop. (Odziedziczone po Control) |
10 | OnKeyDown Wywoływana przed wystąpieniem zdarzenia KeyDown. (Odziedziczone po Control) |
11 | OnKeyUp Wywoływana przed wystąpieniem zdarzenia KeyUp. (Odziedziczone po Control) |
12 | OnLostFocus Wywoływane przed wystąpieniem zdarzenia LostFocus. (Odziedziczone po Control) |
13 | ReadLocalValue Zwraca lokalną wartość właściwości zależności, jeśli jest ustawiona wartość lokalna. (Odziedziczone po DependencyObject) |
14 | SetBinding Dołącza powiązanie do FrameworkElement przy użyciu podanego obiektu powiązania. (Odziedziczone po FrameworkElement) |
15 | SetValue Ustawia wartość lokalną właściwości zależności w DependencyObject. (Odziedziczone po DependencyObject) |
Spójrzmy na prosty przykład, w którym różne elementy interfejsu użytkownika są dodawane w pliku 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>
Poniżej podano implementację języka 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" });
}
}
}
Kiedy powyższy kod zostanie skompilowany i wykonany, zobaczysz pole listy zawierające mieszankę tekstu graficznego, a także edytowalne pole, w którym możesz wpisać tekst.
Sr. No. | Sterowanie i opis |
---|---|
1 | Calendar & DatePicker Calendar & DatePicker reprezentuje kontrolkę, która umożliwia użytkownikowi wybranie daty przy użyciu wizualnego wyświetlania kalendarza. Zapewnia podstawową nawigację za pomocą myszy lub klawiatury. |
2 | TabControl Kontener, który umieszcza elementy w osobnych kartach i umożliwia użytkownikowi przeglądanie tylko jednej karty na raz. Pozwala użytkownikowi wybierać spośród wielu różnych widoków, klikając nagłówki kart. |
3 | Popup Ta klasa wyświetla zawartość nad istniejącą zawartością, w granicach okna aplikacji. Jest to tymczasowe wyświetlanie na innych treściach. |
4 | ToolTip Etykietka narzędzia reprezentuje kontrolkę, która tworzy wyskakujące okienko, które wyświetla informacje o elemencie w GUI. Silverlight umożliwia dołączenie podpowiedzi do dowolnego elementu sterującego. |