Modyfikacja i tworzenie kontrolek

procedure SetControlPosAndSize(FormName,ControlName:PChar; L,T,W,H:Integer);stdcall;

Ustawia położenie i wielkość dowolnej kontrolki.

Parametry

•FormName - nazwa okna na którym znajduje się kontrolka

•ControlName - nazwa kontrolki

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

Aby poznać nazwę okna i kontrolki, której położenie lub wielkość chcemy zmodyfikować, w aplikacji R2płatnik należy najechać myszą na kontrolkę, przytrzymać klawisze Alt+Ctrl+Shift i nacisnąć lewy przycisk myszy. W lewym górnym rogu okna pojawi się podpowiedź z nazwą okna i kontrolki oraz jej aktualne położenie i wielkość. Teraz znając te wartości należy wywołać tę funkcję w aplikacji API (jednorazowo - np. przy starcie).

procedure SetControlEnableOrVisible(FormName,ControlName:PChar; E,V,R:Boolean);stdcall;

Ustawia właściwości dowolnej kontrolki.

Parametry

•FormName - nazwa okna na którym znajduje się kontrolka

•ControlName - nazwa kontrolki

•E - ustawia czy kontrolka ma być aktywna

•V - ustawia czy kontrolka ma być widoczna

•R - ustawia czy kontrolka ma "tylko do odczytu"

Zwracane wartości
Brak

Aby poznać nazwę okna i kontrolki, której właściwości chcemy zmodyfikować, w aplikacji R2płatnik należy najechać myszą na kontrolkę, przytrzymać klawisze Alt+Ctrl+Shift i nacisnąć lewy przycisk myszy. W lewym górnym rogu okna pojawi się podpowiedź z nazwą okna i kontrolki oraz jej aktualne położenie i wielkość. Teraz znając te wartości należy wywołać tę funkcję w aplikacji API.

procedure SetControlPos(Form,Name:PChar; L,T,W,H:Integer);stdcall;

Ustawia położenie i wielkość dowolnej kontrolki.

Parametry

•Form - nazwa okna na którym znajduje się kontrolka

•Name - nazwa kontrolki

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

Aby poznać nazwę okna i kontrolki, której położenie lub wielkość chcemy zmodyfikować, w aplikacji R2płatnik należy najechać myszą na kontrolkę, przytrzymać klawisze Alt+Ctrl+Shift i nacisnąć lewy przycisk myszy. W lewym górnym rogu okna pojawi się podpowiedź z nazwą okna i kontrolki oraz jej aktualne położenie i wielkość. Teraz znając te wartości należy wywołać tę funkcję w aplikacji API. Funkcja zastępuje SetControlPosAndSize, która mogła być wywołana tylko jednorazowo.

procedure SetControlProp(Form,Name:PChar; E,V,R:Boolean);stdcall;

Ustawia właściwości dowolnej kontrolki.

Parametry

•Form - nazwa okna na którym znajduje się kontrolka

•Name - nazwa kontrolki

•E - ustawia czy kontrolka ma być aktywna

•V - ustawia czy kontrolka ma być widoczna

•R - ustawia czy kontrolka ma "tylko do odczytu"

Zwracane wartości
Brak

Aby poznać nazwę okna i kontrolki, której właściwości chcemy zmodyfikować, w aplikacji R2płatnik należy najechać myszą na kontrolkę, przytrzymać klawisze Alt+Ctrl+Shift i nacisnąć lewy przycisk myszy. W lewym górnym rogu okna pojawi się podpowiedź z nazwą okna i kontrolki oraz jej aktualne położenie i wielkość. Teraz znając te wartości należy wywołać tę funkcję w aplikacji API. Funkcja zastępuje SetControlEnableOrVisible, która mogła być wywołana tylko jednorazowo.

procedure RefreshControls(FormName:PChar);stdcall;

Odświeża właściwości wszystkich kontrolek w oknie.

Parametry

•FormName - nazwa okna na którym znajdują się kontrolki

Zwracane wartości
Brak

Funkcje SetControlPosAndSize i SetControlEnableOrVisible ustawiają właściwości dowolnych kontrolek przy każdym pokazaniu okna. Jeśli chcemy odświeżyć kontrolki w oknie w dowolnej chwili, po ustawieniu ich właściwości tymi funkcjami, należy wywołać RefreshControls.

procedure AddButton(FormName,ParentName,ControlName,Caption:PChar; L,T,W,H:Integer);stdcall;

Dodaje nowy przycisk (button).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowy przycisk

•ParentName - nazwa kontrolki, na której ma znaleźć się nowy przycisk (jeśli bezpośrednio na oknie, to nazwa okna)

•ControlName - nazwa nowego przycisku

•Caption - tytuł nowego przycisku (OK, Anuluj, Eksportuj, itd.)

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

FormName jest nazwą okna, które utworzy nową kontrolkę, natomiast ParentName jest nazwą kontrolki, na której będzie "leżeć" nowa kontrolka. Nazwy okien i kontrolek są "case sensitive" czyli wymagają do poprawnej identyfikacji małych i dużych liter.

procedure AddLabel(FormName,ParentName,ControlName,Caption:PChar; L,T,W,H:Integer);stdcall;

Dodaje nową etykietę (label).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowa etykieta

•ParentName - nazwa kontrolki, na której ma znaleźć się nowa etykieta (jeśli bezpośrednio na oknie, to nazwa okna)

•ControlName - nazwa nowej etykiety

•Caption - tekst nowej etykiety

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

FormName jest nazwą okna, które utworzy nową kontrolkę, natomiast ParentName jest nazwą kontrolki, na której będzie "leżeć" nowa kontrolka. Nazwy okien i kontrolek są "case sensitive" czyli wymagają do poprawnej identyfikacji małych i dużych liter.

procedure AddEdit(FormName,ParentName,ControlName:PChar; L,T,W,H:Integer);stdcall;

Dodaje nowe okno edycyjne (edit).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowe okno edycyjne

•ParentName - nazwa kontrolki, na której ma znaleźć się nowe okno edycyjne (jeśli bezpośrednio na oknie, to nazwa okna)

•ControlName - nazwa nowego okna edycyjnego

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

FormName jest nazwą okna, które utworzy nową kontrolkę, natomiast ParentName jest nazwą kontrolki, na której będzie "leżeć" nowa kontrolka. Nazwy okien i kontrolek są "case sensitive" czyli wymagają do poprawnej identyfikacji małych i dużych liter.

procedure AddDateEdit(FormName,ParentName,ControlName:PChar; L,T,W,H:Integer);stdcall;

Dodaje nowe okno edycyjne daty wraz z kalendarzem (dateedit).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowe okno edycyjne daty

•ParentName - nazwa kontrolki, na której ma znaleźć się nowe okno edycyjne daty (jeśli bezpośrednio na oknie, to nazwa okna)

•ControlName - nazwa nowego okna edycyjnego daty

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

Użytkownik może wpisywać do tej kontrolki dowolną datę, bądź przyciskiem wywołać kalendarz i z niego wybrać dzień, miesiąc i rok.

procedure AddSpinEdit(FormName,ParentName,ControlName:PChar; L,T,W,H,MinValue,MaxValue:Integer; Increment:Double);stdcall;

Dodaje nowe okno edycyjne dla liczb wraz z przyciskami do zwiększania i zmniejszania (spinedit).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowe okno edycyjne daty

•ParentName - nazwa kontrolki, na której ma znaleźć się nowe okno edycyjne daty (jeśli bezpośrednio na oknie, to nazwa okna)

•ControlName - nazwa nowego okna edycyjnego daty

•MinValue - minimalna wartość edytowanej liczby

•MaxValue - maksymalna wartość edytowanej liczby

•Increment - wartość zwiększenia lub zmniejszenia edytowanej liczby

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

Użytkownik może wpisywać do tej kontrolki dowolną liczbę z zakresu, bądź przyciskami zwiększać lub zmniejszać jej wartość (przydatne do wyboru miesiąca: zakres 1-12, zwiększenie 1).

procedure AddGroupBox(FormName,ParentName,ControlName,Caption:PChar; L,T,W,H:Integer);stdcall;

Dodaje nowy panel (groupbox).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowy panel

•ParentName - nazwa kontrolki, na której ma znaleźć się nowy panel (jeśli bezpośrednio na oknie, to nazwa okna)

•ControlName - nazwa nowego panela

•Caption - tytuł nowego panela (pokaże się na górze)

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

Na panelu (groupbox) można później układać inne kontrolki (przyciski, okna edycyjne, itd.). Należy wtedy w ParentName wpisać nazwę panela.

procedure AddPageControl(FormName,ParentName,ControlName:PChar; L,T,W,H:Integer);stdcall;

Dodaje nowy kontener zakładek (pagecontrol).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowy kontener zakładek

•ParentName - nazwa kontrolki, na której ma znaleźć się nowy kontener zakładek (jeśli bezpośrednio na oknie, to nazwa okna)

•ControlName - nazwa nowego kontenera zakładek

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

Do kontenera zakładek (pagecontrol) należy następnie dodać zakładki używając funkcji AddTabSheet opisanej poniżej. Należy wtedy w ParentName wpisać nazwę kontenera.

procedure AddTabSheet(FormName,ParentName,ControlName,Caption:PChar; L,T,W,H:Integer);stdcall;

Dodaje nową zakładkę (tabsheet) do kontenera zakładek (pagecontrol).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowa zakładka

•ParentName - nazwa kontenera zakładek, na którym ma znaleźć się nowa zakładka. Zakładki można układać tylko na kontenerze zakładek (pagecontrol)

•ControlName - nazwa nowej zakładki

•Caption - tytuł nowej zakładki (pokaże się na górze)

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

W ParentName należy koniecznie wpisać nazwę kontenera zakładek.

procedure AddComboBox(FormName,ParentName,ControlName,Data:PChar; L,T,W,H:Integer);stdcall;

Dodaje nowe oknienko edycyjne z rozwijalną listą wyboru (combobox).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowe okno edycyjne

•ParentName - nazwa kontrolki, na której ma znaleźć się nowe okno edycyjne

•ControlName - nazwa nowego okna edycyjnego

•Data - lista pozycji rozwijajnej listy wyboru. Pozycje tej listy muszą być oddzielone znakami CR LF (#13#10 ASCII)

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

Użytkownik może wpisywać do tej kontrolki dowolny tekst, bądź przyciskiem rozwinąć listę i z niej wybrać jakąś wartość.

procedure AddRadioGroup(FormName,ParentName,ControlName,Data:PChar; L,T,W,H:Integer);stdcall;

Dodaje nowe okno z opcjami wyboru (radiogroup).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowe okno z opcjami wyboru

•ParentName - nazwa kontrolki, na której ma znaleźć się nowe okno z opcjami wyboru

•ControlName - nazwa nowego okna z opcjami wyboru

•Data - lista pozycji (opcji) wyboru. Pozycje tej listy muszą być oddzielone znakami CR LF (#13#10 ASCII)

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

procedure AddCheckBox(FormName,ParentName,ControlName,Caption:PChar; L,T,W,H:Integer);stdcall;

Dodaje nowe okienko zaznaczenia (checkbox).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowe okno zaznaczenia

•ParentName - nazwa kontrolki, na której ma znaleźć się nowe okno zaznaczenia

•ControlName - nazwa nowego okna zaznaczenia

•Caption - tytuł okna zaznaczenia (opis)

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

procedure AddFileNameEdit(FormName,ParentName,ControlName,Filter:PChar; L,T,W,H:Integer);stdcall;

Dodaje nowe okno edycyjne nazwy pliku (filenameedit).

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowe okno edycyjne nazwy pliku

•ParentName - nazwa kontrolki, na której ma znaleźć się okno edycyjne nazwy pliku

•ControlName - nazwa nowego okna edycyjnego nazwy pliku

•Filter - filtr pokazywanej listy dostępnych plików w formie: Pliki tekstowe|*.txt|Pliki Excel|*.xls

•L - położenie lewego rogu kontrolki

•T - położenie górnego rogu kontrolki

•W - szerokość kontrolki

•H - wysokość kontrolki

Zwracane wartości
Brak

Użytkownik może wpisać do kontrolki nazwę konkretnego pliku lub klikając w przycisk wyboru pliku, wybrać go z listy katalogów.

procedure AddMenu(FormName,ParentName,ControlName,Caption:PChar);stdcall;

Dodaje nową pozycję do menu

Parametry

•FormName - nazwa okna, w którym ma znaleźć się nowa pozycja menu

•ParentName - nazwa pozycji menu głównego lub menu typu popup, do którego dodać nową pozycję

•ControlName - nazwa nowej pozycji menu

•Caption - tytuł nowej pozycji menu

Zwracane wartości
Brak