Tworzenie okna dialogowego w edytorze raportu SigmaNEST część 1 Edytor raportu SigmaNEST to wszechstronne narzędzie umożliwiające zarówno dostosowanie każdego raportu pod specyficzne oczekiwania klienta, jak również pozwalające na utworzenie okien dialogowych zintegrowanych z procesem generowania raportów. Dzięki oknom dialogowym w SigmaNEST możemy wyświetlić dodatkowe informacje lub wprowadzić je do raportu, lub też posortować informacje w raporcie po określonych danych. Tworzone okno może mieć zarówno prosty układ - wyświetlający pojedyncze notatki - lub znacznie bardziej złożony, składający się z pól wyboru, list rozwijanych, programowanych kontrolek pozwalające na wyszukiwanie danych w raportach oraz wstawienie do nich dodatkowych informacji. Okno dialogowe można wywołać w czasie procesu generowania raportu lub w podglądzie dostępnym z poziomu edytora raportu. Rys.1. Przykładowe okno dialogowe.
Tworzenie nowej strony okna dialogowego Na początku konieczne jest otwarcie okna edytora raportu i utworzenie nowej strony okna dialogowego. Przejdź do zakładki [Szczegół rozkład] i wybierz ikonę [Drukuj]. W nowo otwartym oknie dialogowym wciśnij przycisk [Ustaw], a następnie sklonuj raport [LayoutReport.FR3], aby zachować oryginalny plik. Rys.2. Instrukcja dostępu do okna Edytora raportów. Po uruchomieniu się edytora raportu włącz przycisk [ ]znajdujący się w pasku narzędzi widocznym w górnej części okna lub wybierz [File] [New Dialog]:
Rys.3. Tworzenie nowego okna dialogowego. W obszarze roboczym edytora pojawi się puste okno dialogowe. Jednocześnie w pasku zakładek ułatwiającym nawigowanie pomiędzy stronami raportu, kodu i innymi, pojawi się nowa zakładka przeznaczona do edytowania okna dialogowego. Na tym etapie możemy sprawdzić podgląd raportu [ ], jednak strona okna dialogowego nie zostanie wyświetlona do chwili, w której nie dodamy do niej co najmniej jednej kontrolki. Rys.4. Obszar roboczy edytora raportów z wyświetlonym pustym oknem dialogowym gotowym do edycji.
Właściwości strony okna dialogowego Poniżej znajduje się omówienie niektórych właściwości ustawień okna dialogowego, umieszczonych w panelu bocznym: BorderStyle umożliwia ustawienie właściwości dla ramki okna dialogowego. Zmiana tego parametru będzie widoczna jedynie w Podglądzie widoku raportu. bsdialog Zablokowany rozmiar okna. Brak przycisku Minimalizuj/Maksymalizuj. bsnone Brak ramki. Okno można zamknąć jedynie ustawionym przyciskiem OK. bssingle Zablokowany rozmiar okna. Zawiera przycisk Minimalizuj/ Maksymalizuj. bssizeable Zmiana rozmiaru okna dozwolona. Zawiera przycisk Minimalizuj/Maksymalizuj. Rys.5. Ustawienie właściwości dla okna dialogowego. Caption tytuł okna dialogowego. Po wprowadzeniu w puste pole dowolnej nazwy okna dialogowego, zostanie ona wyświetlona na górnym pasku okna. Name pole Nazwa. Jeśli istnieje tylko jedno okno dialogowe nie zmieniaj przyporządkowanej nazwy, gdyż jest ona narzucona z góry. Position określa miejsce na ekranie, w którym pojawi się okno dialogowe. Najczęściej pozostawia się je z wartością domyślną poscreencenter. Tworząc przykładowe okno dialogowe ustaw właściwości: BorderStyle: bsdialog, Caption: Report Prompt, Position: poscreencenter.
Dodawanie przycisków Aby włączyć podgląd okna dialogowego w edytorze raportów konieczne jest umieszczenie w nim przynajmniej jednego przycisku lub kontrolki. W zależności od potrzeb SigmaNEST udostępnia Ci okienka tekstowe, przyciski, pola wyboru, przyciski okrągłe, listy rozwijane i inne. Przykład: Aby dodać przycisk zatwierdzający [OK], po wciśnięciu którego zostanie wygenerowany raport, kliknij ikonę [ ], a następnie umieść przycisk w miejscu, które Ci najbardziej odpowiada. Kliknij na przycisk, aby w panelu bocznym wyświetlić jego właściwości. Rys.6. Paleta kontrolek i obiektów. Caption nazwa wyświetlana na przycisku; Enabled wyszarzenie przycisku lub uaktywnienie go; Hint podpowiedź wyświetlająca się po najechaniu kursorem myszki na przycisk; ModalResult - opcja [mrcancel] spowoduje całkowite wyjście z raportu, opcja [mrok] zaakceptuje dane wejściowe i wygeneruje raport, opcja [mrnone] nie spowoduje żadnych zmian po naciśnięciu przycisku. Visible widoczność przycisku w oknie dialogowym (po zaznaczeniu opcji [False] Rys.7. Ustawienie właściwości przycisku OK. przycisk będzie niewidoczny); WordWrap - Jeśli opcja jest włączona, a tekst podpisu jest dłuższy niż szerokość przycisku, tekst będzie przeniesiony do następnej linii.
Po dokonaniu ustawień w sposób widoczny na Rys. 7. możliwe jest przejście do podglądu raportu [ ]. W pierwszej kolejności pojawi się widok skonfigurowanego przez nas okna dialogowego. W wyniku kliknięcia przycisku [OK] zostanie otwarty podgląd wygenerowanego raportu. mgr inż. A.Szpak W następnej części omówione zostanie: Edytowanie kontrolek okien dialogowych w edytorze raportów SigmaNEST. Jeśli masz jakieś pytania, skontaktuj się z nami! Z przyjemnością odpowiemy na wszelkie pytania: Tel.: +48 12 346 58 00 E-mail: biuro@stigo.com.pl