{"id":55000085,"date":"2017-06-01T00:00:00","date_gmt":"2020-03-27T19:26:14","guid":{"rendered":"http:\/\/access-im-unternehmen.aix-dev.de\/aiu\/?p=85"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-30T00:00:00","slug":"Das_ListBoxSteuerelement_Grundlagen","status":"publish","type":"post","link":"https:\/\/vbentwickler.de\/Das_ListBoxSteuerelement_Grundlagen\/","title":{"rendered":"Das ListBox-Steuerelement: Grundlagen"},"content":{"rendered":"

Wer unter Access\/VBA gern das Listenfeld als Steuerelement genutzt hat, wird unter WPF ein ähnliches Steuerelement verwenden wollen. Ein einfach aufgebautes Steuerelement zur Anzeige von Texten in Listenform ist das ListBox-Steuerelement. Es lässt sich sehr leicht definieren und mit Daten füllen, sei es vordefiniert per XAML oder auch zur Laufzeit per Code. Dieser Artikel zeigt die Grundlagen zur Definition und Programmierung des ListBox-Steuerelements. Dabei erfahren Sie, wie Sie es mit einfachen Texten füllen, Einträge selektieren, die Selektion auslesen und auf Ereignisse wie die geänderte Auswahl oder einen Doppelklick reagieren können.<\/b><\/p>\n

Programmiersprache<\/h2>\n

Die Beispiele in diesem Artikel basieren auf C#.<\/p>\n

Hinweis<\/h2>\n

Um die verschiedenen Beispiele übersichtlich darzustellen, haben wir diese statt in verschiedenen Window<\/b>-Elementen in Page<\/b>-Elementen untergebracht, die dann über das Ribbon im Kopf des Fensters MainWindow <\/b>per Mausklick auf den jeweiligen Ribbon-Button geöffnet werden können.<\/p>\n

Die Definition des RibbonButton<\/b>-Elements enthält dann im Attribut tag <\/b>den Namen des zu öffnenden Page<\/b>-Elements:<\/p>\n

<RibbonButton Label=\"Einfache Einträge\" Click=\"RibbonButton_Click\" Tag=\"pgeEinfacheEintraege\"><\/RibbonButton><\/pre>\n
Die dort angegebene Ereignismethode Ribbon_Button_Click <\/b>fragt den Wert des Tag<\/b>-Attributs ab und öffnet das entsprechende Page<\/b>-Element im Frame<\/b>-Steuerelement:<\/p>\n
private void RibbonButton_Click(object sender, RoutedEventArgs e) {\r\n     RibbonButton button = (RibbonButton)sender;\r\n     string pge = button.Tag.ToString();\r\n     Workzone.Content = GetInstance(\"ListBox_Beispiele.\" + pge);\r\n}<\/pre>\n
Listbox hinzufügen<\/h2>\n
Der erste und einfachste Schritt ist das Hinzufügen des ListBox-Elements: Dazu ziehen Sie es einfach aus der Toolbox in das WPF-Fenster und lassen es dort fallen.<\/p>\n
Oder Sie machen es wie ein richtiger Programmierer und fügen ein ListBox<\/b>-Element zur XAML-Definition des Fensters hinzu:<\/p>\n
<ListBox x:Name=\"lstBeispiel\" Height=\"100\" Width=\"300\" Margin=\"10,10\" HorizontalAlignment=\"Left\" VerticalAlignment=\"Top\"><\/ListBox><\/pre>\n
Zusammen mit einem Label soll unsere erste Beispiel-ListBox dann wie folgt deklariert sein und im Entwurf wie in Bild 1 aussehen:<\/p>\n
\"Entwurf<\/p>\n
Bild 1: Entwurf unseres ListBox-Steuerelements<\/span><\/b><\/p>\n
<Grid>\r\n     <Grid.RowDefinitions>\r\n         <RowDefinition><\/RowDefinition>\r\n     <\/Grid.RowDefinitions>\r\n     <Grid.ColumnDefinitions>\r\n         <ColumnDefinition Width=\"100\"><\/ColumnDefinition>\r\n         <ColumnDefinition><\/ColumnDefinition>\r\n     <\/Grid.ColumnDefinitions>\r\n     <Label Grid.Column=\"0\" Margin=\"10,10,10,10\">Listbox:<\/Label>\r\n     <ListBox x:Name=\"lstBeispiel\" Grid.Column=\"1\" Margin=\"10,10,10,10\"><\/ListBox>\r\n<\/Grid><\/pre>\n
Einträge vordefinieren<\/h2>\n
Vielleicht wissen Sie schon zur Entwurfszeit, welche Einträge die Liste anzeigen soll. Dann können Sie diese Elemente einfach per XAML festlegen. Der XAML-Code für die ListBox sieht dann wie folgt aus:<\/p>\n
<ListBox x:Name=\"lstEintraege\" Grid.Column=\"1\" Margin=\"10,10,10,10\">\r\n     <ListBoxItem>Erster Eintrag<\/ListBoxItem>\r\n     <ListBoxItem>Zweiter Eintrag<\/ListBoxItem>\r\n     <ListBoxItem>Dritter Eintrag<\/ListBoxItem>\r\n     <ListBoxItem>Vierter Eintrag<\/ListBoxItem>\r\n<\/ListBox><\/pre>\n
Diese Einträge werden dann in der ListBox wie in Bild 2 angezeigt.<\/p>\n
\"Feste<\/p>\n
Bild 2: Feste Beispieleinträge in einem ListBox-Element<\/span><\/b><\/p>\n
Element per XAML vorselektieren<\/h2>\n
Wenn Sie die Elemente per XAML vordefinieren, können Sie auch einen der Einträge vorselektieren. Dazu fügen Sie dem betroffenen Element einfach das Attribut IsSelected <\/b>hinzu und stellen es auf true <\/b>ein:<\/p>\n
<ListBoxItem IsSelected=\"true\">Erster Eintrag<\/ListBoxItem><\/pre>\n
ListBox-Element mit Texten füllen<\/h2>\n
Die erste Schaltfläche, die wir hinzufügen, soll einen Eintrag zum Listenfeld hinzufügen. Das erledigen wir mit der Add<\/b>-Methode der Items<\/b>-Auflistung der ListBox. Die Schaltfläche definieren wir wie folgt:<\/p>\n
<Button x:Name=\"btnNamen\" Grid.Column=\"0\" Grid.ColumnSpan=\"2\" Grid.Row=\"1\" Height=\"30\" Margin=\"10,10,10,10\" Click=\"btnNamen_Click\">Namen<\/Button><\/pre>\n
Das Click<\/b>-Ereignis soll diese Methode auslösen:    <\/p>\n
private void btnNeuerEintrag_Click(object sender, RoutedEventArgs e) {\r\n     lstEintraege.Items.Add(\"Fünfter Eintrag\");\r\n}<\/pre>\n
Das Ergebnis sieht schließlich wie in Bild 3 aus.<\/p>\n
\"Einfügen<\/p>\n
Bild 3: Einfügen einiger Einträge zu einem ListBox-Element<\/span><\/b><\/p>\n
ListBox leeren<\/h2>\n
Wenn Sie alle Einträge aus der ListBox entfernen wollen, verwenden Sie die Clear<\/b>-Methode der Items<\/b>-Auflistung:<\/p>\n
private void btnAlleLoeschen_Click(object sender, RoutedEventArgs e) {\r\n     lstEintraege.Items.Clear();\r\n}<\/pre>\n
Einfach- oder Mehrfachauswahl<\/h2>\n
Der Benutzer kann natürlich einen oder mehrere Einträge in der ListBox auswählen. Ob er einen oder mehrere auswählen kann, legen Sie mit der Eigenschaft SelectionMode<\/b> fest. Diese kann die folgenden Werte annehmen:<\/p>\n