Uwaga
Należy pamiętać, aby na zakładce „Schemat obiegu” na etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#” przy danej kontrolce i aby zapisać wszystkie wprowadzone zmiany za pomocą przycisku 
[Zapisz] .
Kontrolka „Lista” posiada identyfikatory numeryczne i tekstowe.
Rodzaj używanego identyfikatora zależy od właściwości „Rodzaj identyfikatora”, którą ustawia się na definicji danej kontrolki typu Lista.
Pole „Rodzaj identyfikatora” na definicji kontrolki typu Lista
Metoda: AddItem
- Opis: Metoda umożliwia dodanie nowej pozycji w ramach kontrolki typu Lista.
- Dla właściwości „Rodzaj identyfikatora” = Int
- Definicja: byte Globals.MainFrame.
.AddItem (int, string)
Przyklad
Zainicjowanie kontrolki typu Lista (gdy „Rodzaj identyfikatora” = Int):
Globals.MainFrame.List1.AddItem(1,"Poczta");
Globals.MainFrame.List1.AddItem(2,"Kurier");
Globals.MainFrame.List1.AddItem(3,"Odbiór osobisty");
Zainicjowanie kontrolki wybranymi pozycjami przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/listid.mp4
Dodawanie nowego dokumentu – w kontrolce „Sposób dostawy” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C#:
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/listid2.mp4
- Dla właściwości „Rodzaj identyfikatora” = Text
- Definicja: byte Globals.MainFrame.
.AddItem (string, string)
Przyklad
Zainicjowanie kontrolki typu Lista (gdy „Rodzaj identyfikatora” = Text):
Globals.MainFrame.List1.AddItem("1","Samochód");
Globals.MainFrame.List1.AddItem("2","Pociąg");
Globals.MainFrame.List1.AddItem("3","Autobus");
Zainicjowanie kontrolki wybranymi pozycjami przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/listtext1.mp4
Dodawanie nowego dokumentu – w kontrolce „Rodzaj transportu” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C#:
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/listtext2.mp4
Zwracane wyniki:
0 – element został dodany do kolekcji
1 – identyfikator elementu już istnieje w kolekcji
2 – niewłaściwy typ identyfikatora dodawanej pozycji
3 – błąd dodawania pozycji
Metoda: Clear
- Opis: Metoda usuwa wszystkie pozycje listy.
- Definicja: void Globals.MainFrame.
.Clear()
Przyklad
Zainicjowanie kontrolki typu Lista – w poniższym przykładzie operator chce zachować w zapytaniu wcześniej dodane pozycje, ale nie powinny być dostępne na dokumencie – natomiast zamiast nich mają być wyświetlane dwie nowe pozycje – „Tramwaj” i „Samolot”:
Globals.MainFrame.List1.AddItem("1","Samochód");
Globals.MainFrame.List1.AddItem("2","Pociąg");
Globals.MainFrame.List1.AddItem("3","Autobus");
Globals.MainFrame.List1.Clear();
Globals.MainFrame.List1.AddItem("4","Tramwaj");
Globals.MainFrame.List1.AddItem("5","Samolot");
Zainicjowanie kontrolki typu Lista wybranymi pozycjami przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
Operator modyfikuje istniejące zapytanie dodając następujący kod:
Globals.MainFrame.List1.Clear();
Globals.MainFrame.List1.AddItem("4","Tramwaj");
Globals.MainFrame.List1.AddItem("5","Samolot");
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/listclear1.mp4
Dodawanie nowego dokumentu – w kontrolce „Rodzaj transportu” widoczna jest lista zainicjowana za pomocą C# – pierwsze trzy pozycje listy z zapytania nie są dostępne, ponieważ zastosowano metodę „Clear”:
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/listclear2.mp4
Metoda: SetSelectedItem
- Opis: Metoda ustawia wskazaną pozycję w kontrolce lista.
- Dla właściwości „Rodzaj identyfikatora” = Int
- Definicja: byte Globals.MainFrame.
.SetSelectedItem (int)
Przyklad
Zainicjowanie kontrolki typu Lista (gdy „Rodzaj identyfikatora” = Int), a w kontrolce typu Lista ma być domyślnie wyświetlana wartość „Kurier”
Globals.MainFrame.List1.AddItem(1,"Poczta");
Globals.MainFrame.List1.AddItem(2,"Kurier");
Globals.MainFrame.List1.AddItem(3,"Odbiór osobisty");
Globals.MainFrame.List1.SetSelectedItem(2);
Zainicjowanie kontrolki wybranymi pozycjami przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/selecteditemset-lista-1.mp4
Dodawanie nowego dokumentu – w kontrolce „Sposób dostawy” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C# – z domyślnie wyświetlaną wartością „Kurier”:
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/selecteditemset-lista-2.mp4
- Dla właściwości „Rodzaj identyfikatora” = Text
- Definicja: byte Globals.MainFrame.
.SetSelectedItem(string)
Przyklad
Zainicjowanie kontrolki typu Lista (gdy „Rodzaj identyfikatora” = Text):
Globals.MainFrame.List1.AddItem("1","Samochód");
Globals.MainFrame.List1.AddItem("2","Pociąg");
Globals.MainFrame.List1.AddItem("3","Autobus");
Globals.MainFrame.List1.SetSelectedItem("1");
Zainicjowanie kontrolki wybranymi pozycjami przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/selecteditemset-lista-text-1.mp4
Dodawanie nowego dokumentu – w kontrolce „Rodzaj transportu” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C# z domyślną wartością „Samochód”:
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/selecteditemset-lista-text-2.mp4
Zwracane wyniki:
0 – pozycja została ustawiona
1 – nie odnaleziono pozycji
2 – zastosowano argument niewłaściwego typu
Metoda: ClearSelectedItem
- Opis: Metoda usuwa wybraną pozycję listy.
- Definicja: void Globals.MainFrame.
.ClearSelectedItem()
Przyklad
Zainicjowanie kontrolki typu Lista (gdy „Rodzaj identyfikatora” = Text) – operator chce, aby na liście nie wyświetlano wybranej wcześniej wartości domyślnej, dlatego dodaje metodę ClearSelectedItem :
Globals.MainFrame.List1.AddItem("1","Samochód");
Globals.MainFrame.List1.AddItem("2","Pociąg");
Globals.MainFrame.List1.AddItem("3","Autobus");
Globals.MainFrame.List1.SetSelectedItem("1");
Globals.MainFrame.List1.ClearSelectedItem();
Zainicjowanie kontrolki wybranymi pozycjami przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/clearselecteditem-1.mp4
Dodawanie nowego dokumentu – w kontrolce „Rodzaj transportu” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C# – bez wartości domyślnej :
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/clearselecteditem-2.mp4
Właściwość: SelectedText
- Opis: Zwraca wprowadzoną przez użytkownika wartość wyszukiwania listy.
- Definicja: Globals.MainFrame.
.SelectedText - Typ: string
- Dostęp: Odczyt
Przyklad
Konfiguracja zmiany wartości w kontrolce typu Tekst Nazwa pozycji wybranej w kontrolce „Sposób dostawy” (identyfikator: String2), gdy wybrano pozycję w kontrolce typu Lista Sposób dostawy (identyfikator: List1) :
Globals.MainFrame.String2.Text=Globals.MainFrame.List1.SelectedText;
Konfigurację kontrolki Nazwa pozycji wybranej w kontrolce „Sposób dostawy” i zmianę wartości tej kontrolki na nowym dokumencie przedstawiono w poniższych filmach:
Film
Wprowadzanie kodu i kompilacja:
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/selectedtext-1-1.mp4
Dodawanie nowego dokumentu – w kontrolce Nazwa pozycji wybranej w kontrolce „Sposób dostawy” wartość zmienia się zgodnie z wartością wybraną w kontrolce Sposób dostawy :
https://pomoc.comarch.pl/dms/wp-content/uploads/2024/09/selectedtext-2.mp4
Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?