Raport HTML (html)

MetodaDeklaracja metodyPrzykład wywołaniaOpis działania
Deklaracja obiektu raporthtml(Text title="HL++ html",Text description="Html created by HL++",Text keywords="HL++")html raportDeklarowana jest obiekt typu raport HTML.
Ustawienie koloru tłavoid background(Text color)raport.backgroundcolor("blue")Ustawiane jest tło strony.
Dodanie zakładkivoid tab(Text name)raport.tab("Pierwsza zakładka")Dodawanie nowej zakładki do raportu. Raport musi mieć co najmniej jedną zakładkę.
Jeżeli jest więcej niż 1 zakładka, to u góry strony automatycznie zostanie wygenerowany pasek nawigacji między zakładkami.
Klasa właściwości tekstuclass text_properties
{
public:
int bold,
italic,
underline,
font_size; znakow
Text font_color,
font_face;

text_properties();
};
text_properties wlasciwosci_tekstuKlasa definująca właściwości tekstu umieszczanego w raporcie za pomocą metody add_text. Każdy umieszczany tekst ma własne właściwości, takie jak:
- pogrubienie (bold)
- kursywa (italic)
- podkreślenie (underline)
- wielkość znaków (font_size)
- kolor znaków (font_color)
- rodzaj czcionki (font_face)
Po utworzeniu zmiennej text_properties te właściwości przyjmują wartości domyślne (zwykły tekst), ale można je zmieniać jak w przykładzie poniżej:
text_properties wlasciwosci_tekstu;
wlasciwosci_tekstu.bold=1;
wlasciwosci_tekstu.size=20;
Klasa właściwości tabeliclass table_properties
{
public:
Text captition,
captition_align,
width,
height,
align,
bgcolor,
names_color;
int col_names,
row_names,
border,
cellpadding,
cellspacing;

table_properties();
};
table_properties wlasciwosci_tabeliKlasa definująca właściwości tabel umieszczanych w raporcie za pomocą metody add_table. Każda umieszczana tabela ma własne właściwości, takie jak:
- tytuł (captition)
- położenie tytułu (captition_align)
- szerokość w pikselach lub % (width)
- wysokość w pikselach lub % (height)
- wyrównanie względem tekstu (align)
- kolor tła (bgcolor)
- kolor wiersza z nazwami kolumn (names_color)
- wybór czy pokazywać nazwy kolumn (col_names)
- wybór czy pokazywać nazwy wierszy (row_names)
- grubość zewnętrznej ramki w pikselach (border)
- szerokość marginesów poziomych i pionowych (cellpadding)
- szerokość odstępu między sąsiednimi komórkami (cellspacing)
Po utworzeniu zmiennej table_properties te właściwości przyjmują wartości domyślne, ale można je zmieniać jak w przykładzie poniżej:
table_properties wlasciwosci_tabeli;
wlasciwosci_tabeli.captition="Tabela 1. Przykładowa";
wlasciwosci_tabeli.row_names=0;
Dodanie rozdziałuvoid chapter(Text name,const text_properties &p)raport.chapter("Rozdział 1", wlasciwosci_tekstu)Do raportu dodawany jest nowy rozdział. Tytuł rozdziału ma podane wlasciwosci_tekstu.
Dodawanie rozdziałów powoduje automatyczne utworzenie spisu treści na pasku nawigacyjnym z lewej strony raportu.
Dodanie tekstuvoid htext(Text t,const text_properties &p)raport.htext("Jakiś napis",wlasciwosci_tekstu)Do raportu dodawany jest tekst o podanych właściwościach.
Dodanie paragrafuvoid paragraph(Text t,const text_properties &p,Text align="left")raport.paragraph("Jakiś napis",wlasciwosci_tekstu)Do raportu dodawany jest tekst w paragrafie o podanych właściwościach. Po kliknięciu w paragraf tekst może być dynamicznie modyfikowany.
Dodanie ilustracjivoid image(Text name,Text dir="",Text align="left",int width=600,int height=400)raport.image("obrazek.jpg")Do raportu dodawana jest ilustracja (obraz).
Dodanie odwołaniavoid href(Text name,Text dir="",Text description="reference",Text image="")raport.href("rozdzial2.html")Do raportu dodawane jest odwołanie wewnętrzne lub zewnętrzne.
Dodanie tabelivoid htable(const table &tab,const table_properties &p)
void htable(const table &tab,const matrix &conv,const table_properties &p)
raport.htable(tabela,wlasciwosci_tabeli)
raport.htable(tabela,c(2,2,0,1),wlasciwosci_tabeli)
Do raportu dodawana jest tabela o podanych właściwościach. Opcjonalny parametr 'conv' definiuje sposób prezentacji liczb. Jest to wektor o długości odpowiadającej liczbie kolumn w tabeli. Każda wartości (liczba całkowita) definiuje sposób prezentacji w kolejnych kolumnach. Liczby dodanie wskazują, że liczby w kolumnie mają być wyświetlone jako liczby rzeczywiste o zadanej dokładności po przecinku. Wartość 0 wskazuje, że mają być wyświetlane liczby całkowite. Wartości ujemne wskazują, że mają być wyświetlane wartości procentowe o zadanej dokładności po przecinku.
Dodanie macierzyvoid hmatrix(const matrix &mat,const matrix &conv,const table_properties &p)raport.hmatrix(macierz,c(2,3,6),wlasciwosci_tabeli)Do raportu dodawana jest macierz. Parametr 'conv' definiuje sposób prezentacji liczb (tak samo jak dla funkcji add_table).
Dodanie JavaScriptuvoid js(Text name,Text dir="",int width=600,int height=400)raport.js("wykres_gplot.js")Do raportu dodawany jest dowolny JavaScript. JavaScriptem może być wykres utworzony za pomocą gplot, jeżeli ustawi się właściwości pliku wynikowego: set terminal canvas.
Dodanie separatoravoid endline(int n=1)raport.endline()Do raportu dodawane są linie odstępu.
Czyszczenie raportuvoid clear()raport.clear()Obiekt raport jest czyszczony. Powstaje pusty raport.
Zapisanie raportuvoid save(Text dir,Text name)raport.save("","raport.html")Raport zapisywane jest na dysku w zadanej lokalizacji i pod określoną nazwą.