Instrukcja obsługi R2środki

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

Uwagi

Aby poznać nazwę okna i kontrolki, której położenie lub wielkość chcemy zmodyfikować, w aplikacji R2środki 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

Uwagi

Aby poznać nazwę okna i kontrolki, której właściwości chcemy zmodyfikować, w aplikacji R2środki 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 RefreshControls(FormName);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

Uwagi

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

Uwagi

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

Uwagi

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

Uwagi

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

Uwagi

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

Uwagi

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

Uwagi

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

Uwagi

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

Uwagi

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

Uwagi

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

Uwagi

Brak

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

Dodaje nowe oknienko 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

Uwagi

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

Uwagi

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

Uwagi

Brak