GeoGet

Complete geocaching solutions

User Tools

Site Tools


user:skript:ggstatlib
no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.


Next revision
user:skript:ggstatlib [2012/07/31 15:18] – vytvořeno gord
Line 1: Line 1:
 +====== GgStatLib ======
 +Knihovna obsahuje funkce, pomocí kterých je možné z pluginů pro **GeoGet** získat hodnoty a nastavení používané v Template souboru programu [[user:skript:ggstat|GgStat]]. Takto získané hodnoty mohou být použity v pluginu pro doplnění statistik o tabulky, grafy či seznamy, které [[user:skript:ggstat|GgStat]] vytvářet neumí.
  
 +===== Autor =====
 +|**[[http://www.geocaching.com/profile/?u=gordici|Gord]]**, **[[mailto:gord@atlas.cz|Gord]]**| ~~PAYPAL business="gord@atlas.cz" message="Prispevek na skript: Combine"~~|
 +
 +Pokud se Vám doplněk líbí, kliknutím na tlačítko **Donate** můžete přispět na jeho vývoj.
 +
 +//Nekamarádíte se s PayPalem? Napište mi [[mailto:gord@atlas.cz|email]] a domluvíme se na jiném způsobu, třeba převodu na účet.//
 +/*
 +|**[[http://www.geocaching.com/profile/?u=gordici|Gord]]**, **[[mailto:gord@atlas.cz|Gord]]**|
 +*/
 +
 +===== Automatická instalace =====
 +~~GEOGET_INSTALL~~
 +
 +===== Diskuze =====
 +Diskuze o tomto skriptu se nachází na stránkách [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=17224|Geocaching.cz]].
 +
 +===== Uživatelská dokumentace =====
 +Tato část textu je určena především pro uživatele GeoGetu. Respektive pro uživatele těch skriptů GeoGetu, které využívají funkcí knihovny GgStatLib. Odstavce jsou však povinnou četbou i pro programátory skriptů.
 +
 +<box round 100% #DEE7EC> 
 +:!: Protože se jedná o knihovnu, není možné ji použít samostatně. Jako každá jiná knihovna i tato slouží programátorům (v tomto případě programátorům skriptů pro GeoGet) k tomu, aby zjednodušila jejich práci. Programátor začleněním knihovny do svého skriptu použije její funkce a případně poskytne nějaké to klikátko k tomu, aby uživatel sám mohl upravovat šablony používané programátorovým skriptem.
 +</box>
 +
 +===== Programátorská dokumentace =====
 +
 +==== Veřejné funkce knihovny ====
 +Použití knihovny spočívá ve volání některé z knihovních funkcí. 
 +
 +<code delphi>GgStatGetCommand(templatePathname, command:string; position:integer; var sCmd:string):boolean;</code>
 +  * získá požadovaný příkaz (jen hodnotu bez klíčového slova), ''position'' udává pořadí příkazu v Template. Pokud ''position'' převyšuje počet těchto příkazů v souboru, je vrácen poslední
 +
 +<code delphi>GgStatGetColors(templatePathname, command:string; position:integer; var aColors:TypeGgStatColors):boolean;</code>
 +  * naplní strukturu aColors barvami podle nastavení v Template souboru, ''position'' udává pořadí příkazu v COLORS. Pokud ''position'' převyšuje počet příkazů COLORS v souboru, je použit poslední z nich
 +
 +Struktura ''TypeGgStatColors'' je vlastně pole. Pro snadnější přístup k prvkům pole jsou definovány konstanty:
 +
 +<code delphi>
 +GGSTAT_COLORS=14;  //počet položek v poli
 +GGSTAT_COLOR_BG=0;
 +GGSTAT_COLOR_TEXT=1;
 +GGSTAT_COLOR_BG_TITLE=2;
 +GGSTAT_COLOR_TEXT_TITLE=3;
 +GGSTAT_COLOR_BG_HEADER=4;
 +GGSTAT_COLOR_TEXT_HEADER=5;
 +GGSTAT_COLOR_BG_TABLE=6;
 +GGSTAT_COLOR_TEXT_TABLE=7;
 +GGSTAT_COLOR_BG_VALUE=8;
 +GGSTAT_COLOR_TEXT_VALUE=9;
 +GGSTAT_COLOR_TEXT_MAX=10;
 +GGSTAT_COLOR_TEXT_AVG=11;
 +GGSTAT_COLOR_TEXT_MIN=12;
 +GGSTAT_COLOR_TEXT_MISC=13;</code>
 +
 +==== Knihovna jako Include nebo Unit ====
 +
 +Knihovna je připravena ve dvou verzích. Je možné prostě includovat soubor 
 +
 +<code delphi>
 +{$include GgStat.lib.pas}
 +</code>
 +
 +nebo je možné knihovnu použít jako unit příkazem
 +
 +<code delphi>
 +uses GgStatUnit;
 +</code>
 +
 +na prvním řádku klientského skriptu.
 +
 +Výhodou unit je bezproblémová práce s formuláři, je tedy doporučeno používat tuto cestu.
 +
 +==== Nastavení a konfigurace ====
 +Knihovna neobsahuje žádné konfigurační parametry, které by měly být uživatelsky přístupné.
 +
 +===== Seznam skriptů, které používají tuto knihovnu =====
 +{{topic>uses_ggstalib}}
 +
 +Pokud jste narazili na skript, který knihovnu používá, ale není zde uveden, kontaktujte, prosím, autory.
 +
 +===== Stažení =====
 +<box round 95% #DEE7EC>
 +:!: Stáhnout aktuální verzi: ~~DOWNLOAD ggstatlib-*.gip highest~~
 +</box>
 +
 +==== Seznam dostupných verzí ====
 +{{filelist>ggstatlib:*.gip&style=table&tableheader=1&tableshowdate=1&sort=mtime}}
 +
 +===== Seznam změn =====
 +=== 1.1.1.1 (2011/05/17) ===
 +   * úvodní veřejná verze knihovny
 +
 +/* Pokud je seznam změn již moc dlouhý */
 +<hidden onHidden=":?: **Zobrazit změny ve starších verzích**" onVisible="Skrýt změny ve starších verzích">
 +</hidden>
 +
 +{{tag>author_Gord skript lib}}
user/skript/ggstatlib.txt · Last modified: 2014/02/17 00:00 (external edit)