Dokumentacja do programowania przy użyciu serii Q-Line 3000

QBS >> Suplementy i Dokumentacja Techniczna do Q-Line 3000 >> QL-QCONL Layout

LAYOUT to pozycja w nagłówku struktury TAB odpowiedzialnej za edycję rekordu. Określa ona rozłożenie pól (kontrolek) na ekranie. Składnia jest następująca:

LAYOUT=<layout element>
Gdzie layout element to

TCP( <fieldId> ... <fieldId> ) - gdzie każdy <fieldId> może być jedną z postaci
identyfikator pola - zwykła kontrolka z nazwą
identyfikator pola (<layout element>) - ewentualny element dodawany bezpośrednio za wartością pola. Dobre dla jednostek lub opisu

Ang: Two Column Panel.
Każde pole składa się z dwóch komponentów: nazwy pola i jego wartości (kontrolki). Pola zostaną ułożone jedno pod drugim wzdłuż osi Y. Kontrolki pól zostaną wyrównane do linii bazowej tworzonej przez swoje początki. Czyli nazwy po lewej a wartości po prawej a linia wyrównująca w środku.

TRP( <fieldId> ... <fieldId> ) - lista identyfikatorów pól.
Ang: Two Row Panel.
Każde pole składa się z dwóch komponentów: nazwy pola i jego wartości (kontrolki). Pola zostaną ułożone jedno obok drugiego wzdłuż osi X, w jednym rzędzie nazwy, w drugim wartości, czyli pole pod jego nazwą.

HPAN( <layout element> ... <layout element> ) - lista <layout_element>.
Ang: Horizontal Panel.
Ten element rozkłada podane elementy jeden pod drugim.Kolejno wzdłuż osi Y

VPAN( <layout element> ... <layout element> ) - lista <layout_element>.
Ang: Vertical Panel.
Ten element rozkłada podane elementy jeden obok drugiego. Kolejno wzdłuż osi X

GRP( <"group name"> <layout element> ) - grupa z dzieckiem <layout_element>.
Ang: Group.
Ten element wokół podanego dziecka rysuje ramkę z podaną nazwą. Ramka ta zaznacza się gdy skupienie jest w dziecku.

CONST( <"napis"> ) - stały napis na ekranie.
Ang: Constants.
Ten element jest dobry dla jednostek i innych opisów

NAME( <fieldId> ) - stały napis z nazwą pola.
Ang: Name.
Nazwa pola

VALUE( <fieldId> ) - kontrolka z wartością pola.
Ang: Value.
Wartość pola

FLD( <fieldId> ) - nazwa i kontrolka z wartością pola.
Ang: Field.
Wartość i nazwa pola

GRID( <row>...<row> ) - gdzie <row> to
<GridElement>...<GridElement>; zaś <GridElement> może być jednym z

<layout element> - nadawana jest domyślna pozycja (kolumna rząd, width = 1, height = 1);
<layout element>[ x, y ] - nadawana jest podana pozycja (width = 1, height = 1)
<layout element>[ x, y, width, height ]

.
Ang: Grid.
Podane elementy będą rozmieszczone jak w tablicy dynamicznej, jest to ciąg rzędów, każdy rząd to ciąg <layout element> zakończony średnikiem. (puste rzędy i kolumny są wycinane). Width i Height mówią na ilu rzędach i kolumnach rozmieścić element.

TAB( "tab1_name" <layout element>..."tabN_name" <layout element> ) - Inaczej lista zakładek, gdzie każdą zakładkę określa para :

"tab_Name" - tytuł zakładki (String)
<layout element> - zawartość zakładki

Ang: Tab.
Po ludzku rzecz biorąc podajemy ciąg zakładek, gdzie każda z nich to jej tytuł i element który będzie zawartością zakładki

GC( <layout element> ) - kontrola poprawności grupowa z dzieckiem <layout_element>.
Ang: Group-Control.
Poprawność wszystkich dzieci (rekurencyjnie w dół) jest sprawdzana dopiero po wyjściu z całej grupy.

MAIN( <layout element>(procx procy) ... <layout element>(procx procy) ) - lista <layout_element>.
Ang: Main Panel.
Ten element rozkłada podane elementy wg podanych pozycji procentowo jak MainPanel

IMAGE( <"nazwapliku"> ) - stały obrazek.
Umieszczenie stałego obrazka.

LAB( <field_id> ) - wartość pola jako zwykła labelka
Działa jak VAL tylko, jako LABEL

RTRP( <field_id> ) - Analogiczny do TRP, tylko nazwy pól są POD kontrolkami i labelki są pochyłe

SWITCH( < field_id >< layout_element1 >< layout_element2> ... ) - dynamicznie wybierany element layoutu
field_id to identyfikator pola (musi być INT), którego wartość wskazuje, który z element podanej listy ma być aktualnie widoczny (liczymy od zera). Można tym sposobem w ogóle wyłączyć fragment recedita, dając jako element alternatywny pusty panel (np VPAN()). Ten sam efekt daje wartość null - nic nie widać.

LAYOUT=HPAN(
            GRP(
                "Adres" TCP(ULICA KOD MIASTO)
                ) 
            GRP(
                "Imię i Nazwisko" TCP(IMIE NAZWISKO)
                ) 
           )

LAYOUT=VPAN(
            GRP(
                "Adres" TCP(ULICA KOD MIASTO)
                ) 
            GRP(
                "Imię i Nazwisko" TCP(IMIE NAZWISKO)
                ) 
           )

LAYOUT=HPAN(
            GRP("Dane" TAB(
                           "Dane osobowe" GRP(
                                              "Imię i Nazwisko" TCP(IMIE NAZWISKO)
                                             )
                           "Dane adresowe" GRP(
                                               "Adres" TRP(ULICA MIASTO KOD)
                                              )
                          )
                )
            GRP("Kontakt i inne" TAB(
                                     "Kontakt" GRP (
                                                    "Telefon i email" TCP(TELEFON EMAIL)
                                                   )
                                     "Inne" GRP(
                                                "Data urodzenia" TCP(DATA_UR) 
                                               )
                                    )
               )
           )

<--Wróć