Kontrolka typu Lista – przykłady definicji kontrolki za pomocą C#

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.

1. Dla właściwości „Rodzaj identyfikatora” = Int

Definicja: byte Globals.MainFrame.<identyfikator kontrolki typu Lista>.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:

Dodawanie nowego dokumentu – w kontrolce „Sposób dostawy” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C#:

2. Dla właściwości „Rodzaj identyfikatora” = Text

Definicja: byte Globals.MainFrame.<identyfikator kontrolki typu Lista>.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:

Dodawanie nowego dokumentu – w kontrolce „Rodzaj transportu” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C#:

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.<identyfikator kontrolki typu Lista>.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");

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”:

Metoda: SetSelectedItem

Opis: Metoda ustawia wskazaną pozycję w kontrolce lista.

1. Dla właściwości „Rodzaj identyfikatora” = Int

Definicja: byte Globals.MainFrame.<identyfikator kontrolki typu Lista>.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:

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”:

2. Dla właściwości „Rodzaj identyfikatora” = Text

Definicja: byte Globals.MainFrame.<identyfikator kontrolki typu Lista>.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:

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”:

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.<identyfikator kontrolk typu Lista>.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:

Dodawanie nowego dokumentu – w kontrolce „Rodzaj transportu” po kliknięciu w kontrolkę widoczna jest lista zainicjowana za pomocą C# – bez wartości domyślnej :

Właściwość: SelectedText

Opis: Zwraca wprowadzoną przez użytkownika wartość wyszukiwania listy.
Definicja: Globals.MainFrame.<identyfikator kontrolki>.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:

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 :

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?

Sprawdź Szkolenia Comarch DMS!

Powrót do początku artykułu