Třída Roll

property Params: _Strings;

Popis:

Slouží k definici filtračních parametrů číselníku. Tyto parametry se použijí téměř při všech metodách této třídy. Podrobnosti o zadávání parametrů naleznete v kapitole popisující filtrování číselníků

_Allowed=ID_Záznamu[,ID_Záznamu - Omezení číselníku za vyjmenovaná ID.

Související metody:

SelectDialog2, MultiSelectDialog, Find, Find2, LookUp, LookUp2, FindByPart, FindByPart2, GetIDs

procedure SetBoundRect(Top: Integer; Left: Integer; Bottom: Integer; Right: Integer);

Popis:

Slouží k definici oblasti, kolem které je v případě vizuálního vyvolání číselníku, tento číselník zobrazen.

Související metody:

SelectDialog2, MultiSelectDialog

function SelectDialog(CanChangeDetailed: WordBool; var ID: WideString): WordBool;

Popis:

Slouží k vizuálnímu vyvolání číselníku za účelem vybrat jeden záznam. Pokud si uživatel něco vybral, je vráceno True. Parametr CanChangeDetailed definuje, zda bude uživatel moci zobrazený "malý" číselník přepnout do tzv. "velkého", kde jsou k dispozici všechny funkce vizuálního číselníku. Parametr ID je vstupně/výstupní parametr. Jako vstupní parametr slouží pro předání výchozího záznamu. Funkce v některých prostředích, které nepodporují typ výstupního parametru, nevrací ID vybraného záznamu, nýbrž prázdnou hodnotu. Z toho důvodu je pro získání ID vybraného záznamu k dispozici ještě druhá varianta SelectDialog2), kterou pro tento účel doporučujeme používat.

Související metody:

Params, SetBoundRect, SelectDialog2, MultiSelectDialog

function SelectDialog2(CanChangeDetailed: WordBool; const ID: WideString): WideString;

Popis:

Slouží k vizuálnímu vyvolání číselníku za účelem vybrat jeden záznam. Pokud si uživatel něco vybral, je vráceno ID vybraného záznamu. Pokud si nic nevybral, je vrácen prázdný řetězec. Parametr CanChangeDetailed definuje, zda bude uživatel moci zobrazený "malý" číselník přepnout do tzv. "velkého", kde jsou k dispozici všechny funkce vizuálního číselníku. Parametr ID je pouze vstupní parametr. Slouží pro předání výchozího záznamu.

Související metody:

Params, SetBoundRect, MultiSelectDialog

function MultiSelectDialog(CanChangeDetailed: WordBool; const Selected: _Strings): WordBool;

Popis:

Slouží k vizuálnímu vyvolání číselníku za účelem vybrat jeden a více záznamů. Pokud si uživatel něco vybral, je vráceno True. Parametr CanChangeDetailed definuje, zda bude uživatel moci zobrazený "malý" číselník přepnout do tzv. "velkého", kde jsou k dispozici všechny funkce vizuálního číselníku. Parametr Selected je vstupně/výstupní parametr. Slouží pro předání seznamu výchozích (označených) záznamů a také pro získání seznamu vybraných záznamů.

Související metody:

Params, SetBoundRect, SelectDialog2

function Find(const TextField: WideString; const Text: WideString; var ID: WideString): WordBool;

Popis:

Slouží k nevizuálnímu vyhledání záznamu v číselníku. Pokud byl záznam dohledán, je vráceno True. Parametr TextField definuje, podle jakého údaje se bude hledat (Code, Name). Parametr Text obsahuje hledaný řetězec. Parametr ID obsahuje interní identifikátor nalezeného záznamu. Parametr ID je ale vstupně/výstupní, a číselník ho použije v případě, že pro předaný Text existuje více záznamů.

Související metody:

Params, Find2

function Find2(const TextField: WideString; const Text: WideString; const ID: WideString): WideString;

Popis:

Slouží k nevizuálnímu vyhledání záznamu v číselníku. Pokud byl záznam dohledán, je vráceno ID záznamu. Pokud záznam dohledán nebyl, je vrácen prázdný řetězec. Parametr TextField definuje, podle jakého údaje se bude hledat (Code, Name). Parametr Text obsahuje hledaný řetězec. Parametr ID je pouze vstupní, a číselník ho použije v případě, že pro předaný Text existuje více záznamů.

Související metody:

Params, Find

function LookUp(const ID: WideString; const TextField: WideString; out Text: WideString): WordBool;

Popis:

Slouží k nevizuálnímu vyhledání záznamu v číselníku, v případě, že je znám interní identifikátor záznamu. Pokud byl záznam dohledán, je vráceno True. Parametr ID obsahuje interní identifikátor hledaného záznamu. Parametr TextField definuje, jaký údaj je požadován navrátit (Code, Name). Parametr Text obsahuje nalezený řetězec.

Související metody:

Params, LookUp2

function LookUp2(const ID: WideString; const TextField: WideString): WideString;

Popis:

Slouží k nevizuálnímu vyhledání záznamu v číselníku, v případě, že je znám interní identifikátor záznamu. Pokud byl záznam dohledán, je vrácen text z požadované položky. Pokud záznam dohledán nebyl, je vrácen prázdný řetězec. Parametr ID obsahuje interní identifikátor hledaného záznamu. Parametr TextField definuje, jaký údaj je požadován navrátit (Code, Name).

Související metody:

Params, LookUp

function CorrectSelected(const Selected: _Strings): WordBool;

Popis:

Slouží ke zkorigování seznamu interních identifikátorů daného číselníku. Pokud došlo ke zkorigování, je vráceno True. Parametr Selected slouží pro předání i získání seznamu interních identifikátorů.

Související metody:

Params

function FindByPart(const TextField: WideString; var Text: WideString; out ID: WideString): WordBool;

Popis:

Slouží k nevizuálnímu vyhledání záznamu v číselníku podle části nějakého údaje. Respektive pomocí této funkce je možné dohledat první záznam, který začíná zadaným řetězcem. Pokud byl záznam dohledán, je vráceno True. Parametr TextField definuje, podle jakého údaje se bude hledat (Code, Name). Parametr Text obsahuje hledaný řetězec. Parametr ID obsahuje interní identifikátor nalezeného záznamu. V parametru Text je také v případě úspěšného dohledání vrácen celý údaj.

Související metody:

Params, FindByPart2

function FindByPart2(const TextField: WideString; const Text: WideString): WideString;

Popis:

Slouží k nevizuálnímu vyhledání záznamu v číselníku podle části nějakého údaje. Respektive pomocí této funkce je možné dohledat první záznam, který začíná zadaným řetězcem. Pokud byl záznam dohledán, je vráceno ID záznamu. Pokud záznam dohledán nebyl, je vrácen prázdný řetězec. Parametr TextField definuje, podle jakého údaje se bude hledat (Code, Name). Parametr Text obsahuje hledaný řetězec.

Související metody:

Params, FindByPart

function GetIDs: _Strings;

Popis:

Funkce vrátí objekt třídy _Strings. Vrácený objekt v sobě obsahuje všechny identifikátory (OID), záznamů z daného číselníku, které vyhověly nastaveným filtračním parametrům.

Související metody:

Params