Pierwszą część artykułu http://tgsoft.pl/Blog.aspx?id=8 zakończyliśmy przykładem, w którym za pomocą interfejsu użytkownika zdefiniowaliśmy okno z tabelą danych. Dane również zostały zdefiniowane przez użytkownika za pomocą SQL Repository.
Efektem była lista:
Okno i widok tabeli zdefiniowane są wg domyślnych ustawień. Poniżej przedstawimy sposób jak dostosować je do własnych wymagań. Pełny kod C#:
namespace Szark
{
using System;
using System.Windows.Forms;
using TGSoft.API.Forms;
public partial class Form1 : System.Windows.Forms.Form
{
public Form1(object sender)
{
this.InitializeComponent();
}
public void Main()
{
string klucz = "8d5afc95-d2d6-4ccd-9e17-eb5bf85262c5";
StandardGrid sg = new StandardGrid(klucz, "");
sg.Text = "Lista pracowników";
sg.SetColumnProperties("nazwisko", "Nazwisko", 150, true);
sg.SetColumnProperties("imie_pierwsze", "Imię", 100, true);
sg.SetColumnCaption("data_urodzenia", "Dt urodz.");
sg.SetColumnCaption("data_przyjecia", "Dt pracy");
sg.SetColumnCaption("wymiar_cz_pracy", "Etat");
sg.SetColumnLeft("kod");
sg.SetColumnRight("stawka");
sg.AddPrintPreviewButtons();
sg.AddFastReportButton("kp", "kartoteka");
sg.ShowDialog();
}
}
}
Efektem działania naszego programu będzie taki widok okna:
Poniżej szczegółowy opis poszczególnych (dodanych) linii programu:
sg.Text = "Lista pracowników";
Zmieniamy domyślny tutuł okna.
sg.SetColumnProperties("nazwisko", "Nazwisko", 150, true);
sg.SetColumnProperties("imie_pierwsze", "Imię", 100, true);
Zmieniamy ustawienia kolumn tabeli.
- Pierwszy parametr to nazwa kolumny z tabeli
- Drugi parametr to Nasza nazwa, która będzie wyświetlana na ekranie
- Trzeci parametr określa szerokość kolumny
- Czwarty parametr ustala „widoczność” kolumny. Za pomocą parametru false możemy ukryć kolumnę. Stosujemy w przypadku pobrania z tabeli SQL większej liczby kolumn (potrzebnych do wygenerowania raportu), ale niepożądanych w widoku tabeli na ekranie. Domyślnie program wyświetla wszystkie kolumny pobrane zapytaniem SQL.
sg.SetColumnCaption("data_urodzenia", "Dt urodz.");
Skrócona wersja poprzedniej metody, tylko do ustalenia tytułu kolumny.
sg.SetColumnLeft("kod");
sg.SetColumnRight("stawka");
Ustalamy "nieruchomą"Lewą i Prawą kolumnę. Parametrem jest nazwa kolumny z tabeli.
sg.AddPrintPreviewButtons();
Dodajemy przyciski do szybkiego, zintegrowanego wydruku i podglądu bieżącego widoku tabeli.
sg.AddFastReportButton("kp", "kartoteka");
Dodaje przycisk obsługujący projekty wydruków FastReport. Parametrami są Prefix oraz nazwa projektu wydruku. Efektem działania przycisku jest otwarcie okna dialogowego:
Teraz mamy już prawie identyczną nową (własną) opcję w programie, zgodną z podstawowymi oknami systemowymi Sz@rk. Nie jest to jednak koniec możliwości naszego API w tym zakresie, ale o tym w kolejnym artykule…