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

Uwaga
Przed kompilacją skryptów C# na komputerze z IIS należy nadać użytkownikowi IIS_IUSRS prawo zapisu do katalogu .scriptcs_cache

 

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 zapisz32 [Zapisz] .

 

Metoda:AddRow

  • Opis: Metoda umożliwia dodanie pustego wiersza do kontrolki tabelarycznej.
  • Definicja: void Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.AddRow ()

Przyklad

Zainicjowanie kontrolki typu Dane tabelaryczne z dodanym jednym pustym wierszem:

 Globals.MainFrame.Multiline1.AddRow();

 

Zainicjowanie kontrolki wybraną pozycją przedstawiono w poniższych filmach:

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1):

 

Dodawanie nowego dokumentu – w kontrolce „Tabela” widoczny jest jeden pusty wiersz zainicjowany za pomocą C#:

 

Metoda:AddRows

    • Opis: Metoda umożliwia dodanie wielu pustych wierszy do kontrolki typu Dane tabelaryczne.
    • Definicja: bool Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.AddRows (int)
    • Zwracane wyniki:
      • true -wiersze zostały dodane
      • false – błąd

Przyklad

Zainicjowanie kontrolki typu Dane tabelaryczne z dodanym jednym pustym wierszem:

 Globals.MainFrame.Multiline1.AddRows(10);

 

Zainicjowanie kontrolki wybraną pozycją przedstawiono w poniższych filmach:

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1):

 

Dodawanie nowego dokumentu – w kontrolce „Tabela” widoczne jest 10 pustych wierszy zainicjowanych za pomocą C#:

 

Metoda:Clear

    • Opis: Metoda umożliwia usunięcie wszystkich wierszy z kontrolki typu Dane tabelaryczne.
    • Definicja: void Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Clear()

Przyklad

Zainicjowanie kontrolki typu Dane tabelaryczne:

 Globals.MainFrame.Multiline1.Clear();

 

Zainicjowanie kontrolki wybraną pozycją przedstawiono w poniższych filmach:

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1):

 

Dodawanie nowego dokumentu – w kontrolce „Tabela” nie jest widoczne 10 pustych wierszy:

 

Właściwość:Column

    • Opis: W przypadku edycji kontrolki tabelarycznej właściwość „Column” zwraca numer ostatnio modyfikowanej kolumny. W przypadku dodania nowego wiersza zwraca wartość -1, usunięcia wiersza zwraca wartość -2.
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Column
    • Typ: int
    • Dostęp: Odczyt
Przyklad

Konfiguracja kontrolki typu Liczba całkowita, w której zostanie wyświetlona wartość dotycząca ostatniej modyfikacji kolumny (-1 – dodanie nowego wiersza, -2 – usunięcie wiersza):

 Globals.MainFrame.Int1.Value = Globals.MainFrame.Multiline1.Column;

 

Zainicjowanie kontrolki wybraną pozycją przedstawiono w poniższych filmach:

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1) i kontrolki „Numer ostatnio modyfikowanej kolumny” (identyfikator: Int1):

 

Dodawanie nowego dokumentu – w kontrolce „Numer ostatnio modyfikowanej kolumny” widoczne jest -1, gdy ostatnio dodano nowy wiersz w kontrolce „Tabela” lub -2, gdy ostatnio usunięto wiersz:

Właściwość:Row

    • Opis: Właściwość zwraca numer ostatnio edytowanego wiersza.
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Row
    • Typ: int
    • Dostęp: Odczyt
Przyklad

Konfiguracja kontrolki typu Liczba całkowita, w której zostanie wyświetlony numer ostatnio modyfikowanego wiersza:

 Globals.MainFrame.Int2.Value = Globals.MainFrame.Multiline1.Row;

 

 

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1) i kontrolki „Numer ostatnio edytowanego wiersza” (identyfikator: Int2):

 

Dodawanie nowego dokumentu – w kontrolce „Numer ostatnio edytowanego wiersza” widoczny jest numer wiersza, w którym ostatnio dokonano zmiany:

Metoda:RemoveRow

    • Opis: Metoda umożliwia usunięcie wskazanego wiersza kontrolki tabelarycznej.
    • Definicja: bool Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.RemoveRow(int)
    • Zwracane wyniki:
      • true – wiersze zostału usunięte
      • false – błąd

 

Przyklad

Konfiguracja kontrolki typu Dane tabelaryczne:

 Globals.MainFrame.Multiline1.RemoveRow(3);

 

Film

Wprowadzanie kodu i kompilacja (na zakładce „Schemat obiegu” ustawiono inicjalizację kontrolki na etapie 2):

 

Przekazywanie dokumentu do kolejnego etapu – w kontrolce „Tabela” zostaje usunięty wiersz 3 (nalezy pamiętać, że numery wierszy liczone są od 0 – a zatem wiersz 3 to wiersz oznaczony  w tabeli numerem 4):

Właściwość:RowCount

    • Opis: Właściwość zwraca ilość wierszy znajdujących się w kontrolce tabelarycznej.
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.RowCount
    • Typ: int
    • Dostęp: Odczyt

 

Przyklad

Konfiguracja kontrolki typu Liczba całkowita „Liczba wierszy” (identyfikator: Int1), gdy kontrolka typu Dane tabelaryczne „Tabela” ma identyfikator Multiline1:

Globals.MainFrame.Int1.Value = Globals.MainFrame.Multiline1.RowCount;

 

Film

Wprowadzanie kodu i kompilacja (w ramach konfiguracji kontrolki typu Liczba całkowita „Liczba wierszy” (identyfikator: Int1) i gdy kontrolka typu Dane tabelaryczne „Tabela” ma identyfikator Multiline1):

 

Dodawanie nowego dokumentu – w kontrolce typu Liczba całkowita „Liczba wierszy” widoczna jest aktualna liczba wierszy znajdujących się w kontrolce typu Dane tabelaryczne „Tabela”:

 

Dostęp do wartości komórek kontrolki „Dane tabelaryczne”

Dostęp do wartości komórki w kontrolce „Dane tabelaryczne” realizowany jest w oparciu o poniższą definicję:

Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<Identyfikator danej kolumny>.<właściwość>

Gdzie „index” to numer wiersza liczony od 0 (0 – pierwszy wiersz, 1 – drugi wiersz, …).

Definicje wartości komórek w zależności od typu kolumny

Aby sprawdzić definicje wartości dla danego typu kolumny, kliknij w jej nazwę poniżej  i sprawdź informacje wyświetlane po prawej stronie:

 

Data i godzinaDokument elektronicznyDokumenty w obieguKontrahentLiczba całkowitaLiczba rzeczywistaLiczba stałoprzecinkowaListaTekstTowarWartość logiczna

    • Opis: Ustawienie/odczytanie daty.
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Data i godzina>.Value
    • Typ: DateTime?
    • Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].DateTime1.Value = DateTime.Now;

 

1.

    • Opis: Ustawienie/odczytanie numerycznego identyfikatora dokumentu elektronicznego
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokument elektroniczny>.Id
    • Typ: int?
    • Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.Id = 5024;

 

2.

    • Opis: Ustawienie/odczytanie numerycznego identyfikatora typu dokumentu elektronicznego
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokument elektroniczny>.IdType
    • Typ: int?
    • Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdType = 1521;

3.

    • Opis: Ustawienie/odczytanie tekstowego identyfikatora dokumentu elektronicznego
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokument elektroniczny>.IdText
    • Typ: string
    • Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdText = "E97B3CE0-F719-44CD-A473-54A59ABF20D5";

 

4.

    • Opis: Ustawienie/odczytanie tekstowego identyfikatora typu dokumentu elektronicznego
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokument elektroniczny>.IdTextType
    • Typ: string
    • Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdTextType = "3EEC4A14-8263-4196-B721-CE7A61C12F45";

 

5.

    • Opis: Ustawienie/odczytanie numeru dokumentu elektronicznego
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokument elektroniczny>.Number
    • Typ: string
    • Dostęp: Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPDocument1.Number;

1.

    • Opis: Ustawienie/odczytanie numerycznego identyfikatora dokumentu w obiegu
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokumenty w obiegu>.Id
    • Typ: int?
    • Dostęp: Zapis/Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Id = 2;

 

2.

    • Opis: Odczytanie numeru dokumentu w obiegu
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Dokumenty w obiegu>.Number
    • Typ: String
    • Dostęp: Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Number;

1.

    • Opis: Ustawienie/odczytanie numerycznego identyfikatora dokumentu w obiegu
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Kontrahent>.Id
    • Typ: int?
    • Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPContractor1.Id = 1;

 

2.

    • Opis: Ustawienie/odczytanie tekstowego identyfikatora kontrahenta
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Kontrahent>.IdText
    • Typ: string
    • Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPContractor1.IdText;

 

3.

    • Opis: Odczytanie skrótu kontrahenta
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Kontrahent>.Shortcut
    • Typ: string
    • Dostęp: Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPContractor1.Shortcut;

    • Opis: Ustawienie/odczytanie wartości komórki
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Liczba całkowita>.Value
    • Typ: int?
    • Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].Int2.Value = 16;

    • Opis: Ustawienie/odczytanie wartości komórki
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Liczba rzeczywista>.Value
    • Typ: float?
    • Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].Real1.Value = (float)124.57;

    • Opis: Ustawienie/odczytanie wartości komórki

Uwaga
Typ stałoprzecinkowy zdefiniowany w kompilatorze DMS posiada 6 miejsc po przecinku.

    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Liczba stałoprzecinkowa>.Value
    • Typ: decimal?
    • Dostęp: Odczyt/Zapis

Przykład:

Globals.MainFrame.Multiline1.Items[0].Decimal1.Value = (decimal)25.36;

1.

    • Opis: Ustawienie/odczytanie numerycznego identyfikatora pozycji listy
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Lista>.Value
    • Typ: int?
    • Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].List1.Value = 3;

 

2.

    • Opis: Ustawienie/odczytanie tekstowego identyfikatora pozycji listy
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Lista>.ValueText
    • Typ: string
    • Dostęp: Odczyt/Zapis

Przykład:

Globals.MainFrame.Multiline1.Items[0].List1.ValueText = "prz";

 

3.

    • Opis: Odczytanie pozycji listy
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Lista>.Text
    • Typ: string
    • Dostęp: Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].List1.Text;

    • Opis: Ustawienie/odczytanie wartości tekstowej komórki
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Tekst>.Text
    • Typ: string
    • Dostęp: Odczyt/Zapis

Przykład:

Globals.MainFrame.Multiline1.Items[0].String3.Text = "Faktura zakupu";

1.

    • Opis: Ustawienie/odczytanie numerycznego identyfikatora towaru
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Towar>.Id
    • Typ: int?
    • Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPArticle1.Id = 1;

 

2.

    • Opis: Ustawienie/odczytanie numerycznego identyfikatora towaru
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Towar>.IdText
    • Typ: string
    • Dostęp: Odczyt/Zapis

Przykład:

Globals.MainFrame.Multiline1.Items[0].ERPArticle1.IdText;

 

3.

    • Opis: Ustawienie/odczytanie numerycznego identyfikatora towaru
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Towar>.Shortcut
    • Typ: string
    • Dostęp: Odczyt

Przykład:

 Globals.MainFrame.Multiline1.Items[0].ERPArticle1.Shortcut;

    • Opis: Ustawienie/odczytanie wartości komórki
    • Definicja: Globals.MainFrame.<identyfikator kontrolki typu Dane tabelaryczne>.Items[index].<identyfikator kolumny typu Wartość logiczna>.Value
    • Typ: bool
    • Dostęp: Odczyt/Zapis

Przykład:

 Globals.MainFrame.Multiline1.Items[0].Bool1.Value = true;

 

Przyklad
Inicjowanie kontrolki typu Dane tabelaryczne  za pomocą kodu C# – przykładowe uzupełnienie pierwszego wiersza (pierwszy wiersz = index 0)

Globals.MainFrame.Multiline1.AddRows(3);
Globals.MainFrame.Multiline1.Items[0].DateTime1.Value = DateTime.Now;
Globals.MainFrame.Multiline1.Items[0].ERPContractor1.Id = 1;
Globals.MainFrame.Multiline1.Items[0].String1.Text = "FZ-2/2024";
Globals.MainFrame.Multiline1.Items[0].ERPDocument1.Id = 5024;
Globals.MainFrame.Multiline1.Items[0].Int1.Value = Globals.MainFrame.Multiline1.Items[0].ERPDocument1.IdType = 1521;
Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Id = 2;
Globals.MainFrame.Multiline1.Items[0].String2.Text = Globals.MainFrame.Multiline1.Items[0].WorkflowDocuments1.Number;
Globals.MainFrame.Multiline1.Items[0].Int2.Value = 16;
Globals.MainFrame.Multiline1.Items[0].Real1.Value = (float)124.57;
Globals.MainFrame.Multiline1.Items[0].Decimal1.Value = (decimal)25.36;
Globals.MainFrame.Multiline1.Items[0].List1.ValueText = "prz";
Globals.MainFrame.Multiline1.Items[0].String3.Text = "Faktura zakupu";
Globals.MainFrame.Multiline1.Items[0].ERPArticle1.Id = 1;
Globals.MainFrame.Multiline1.Items[0].Bool1.Value = true;

 

Film

Wprowadzanie kodu i kompilacja (dla kontrolki „Tabela” (identyfikator: Multiline1):

 

Pierwszy wiersz zainicjowany w kontrolce typu Dane tabelaryczne „Tabela” na dokumencie Comarch DMS za pomocą kodu C#

 

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