Picker

1. Základní informace

• Picker je dialogové okno, které zobrazuje nahlížecí tabulku s databázovými záznamy, jejichž hodnoty je možné převzít či zkopírovat do právě otevřeného editačního formuláře. Picker se typicky používá pro kopírování celých databázových záznamů nebo pro převzetí hodnoty cizího klíče (ForeignKey).
• Odkaz na dialogové okno pickeru s nahlížecí tabulkou a databázovými záznamy má podobu ikony lupy, a zobrazuje se v editačním formuláři napravo vedle ovládacího prvku, ke kterému je picker přidružen.
• Picker je dostupný pro tyto typy ovládacích prvků:
  • TextBox
  • TextArea
  • RichTextBox
  • ComboBox
  • ListBox
  • MultiListBox
  • Radio
  • CheckBox
  • ForeignKey
  • File
  • Image
  • DatePicker
• Picker má i podobu ajaxového našeptávače, který začne nabízet databázové záznamy už při zadávání hodnoty do textového pole v editačním formuláři. Aby fungovalo ajaxové našeptávání, je nutné povolit vyhledávání hodnot zadaných v editačním formuláři.
• Nastavení pickeru se provádí v samostatném dialogu. Odkaz na tento dialog má podobu ikony lupy, a nachází se v levém dolním rohu dialogu nastavení ovládacího prvku, ke kterému je picker přidružen.

2. Záložka „Obecné“

2.1. Tooltip

• Tooltip určuje text nápovědy, který se zobrazí po najetí myši nad ikonu pickeru v editačním formuláři.

2.2. Zdroj dat

• Zdroj dat definuje data zobrazovaná v nahlížecí tabulce pickeru. Tato data jsou výsledkem databázového dotazu, který je vyhodnocen při otevření okna pickeru, nebo při zahájení našeptávání hodnot přímo do editačního formuláře.
• Nastavení zdroje dat se provádí v grafickém návrháři databázových dotazů.

2.3. Počet záznamů na stránce

• Pro přehlednost používá nahlížecí tabulka stránkování zobrazovaných záznamů. To je užitečné v situacích, kdy nahlížecí tabulka načítá velké množství dat.
• Počet záznamů na stránce určuje maximální počet záznamů, které se zobrazí na jedné stránce. Mezi jednotlivými stránkami lze snadno přecházet pomocí nástrojů, které obsahuje každá nahlížecí tabulka ve svém zápatí.

2.4. Možnosti

• Vyhledat hodnotu zadanou v editačním formuláři
  • Pro ovládací prvky TextBox, TextArea, RichTextBox a ForeignKey
  • Zaškrtnutí tohoto pole určuje, zda má být hodnota zadaná v editačním formuláři vyhledána v nahlížecí tabulce pickeru, a zda má editační formulář nabízet ajaxový picker.
• Optimalizované hledání
  • Pro všechny ovládací prvky editačního formuláře s možností pickeru
  • Optimalizované hledání znamená, že každý sloupec nahlížecí tabulky pickeru používá svoje textové pole určené pro zadání hledaného výrazu nebo slovního spojení.
  • Běžné (neoptimalizované) hledání znamená, že se pro zadání hledaného výrazu používá jedno společné textové pole, do kterého je možné vypsat všechny hledané výrazy, a ty jsou následně vyhledávány ve všech sloupcích nahlížecí tabulky najednou.
• Zobrazit pouze výsledky hledání
  • Pro všechny ovládací prvky editačního formuláře s možností pickeru
  • Zaškrtnutí tohoto pole určuje, zda má nahlížecí tabulka pickeru zobrazovat záznamy, pouze když je zadán hledaný výraz nebo slovní spojení.
• Přepsat hodnotu zadanou v editačním formuláři
  • Pro ovládací prvky TextBox, TextArea, RichTextBox a MultiListBox
  • Zaškrtnutí tohoto pole určuje, zda má převzetí hodnoty pole z nahlížecí tabulky pickeru do editačního formuláře hodnotu přepsat, nebo jí přidat na konec.
• Povolit vytváření nových záznamů
  • Pro všechny ovládací prvky editačního formuláře s možností pickeru
  • Zaškrtnutí tohoto pole určuje, zda se pod nahlížecí tabulkou pickeru bude zobrazovat tlačítko pro zadání nového záznamu stejné agendy, která je použitá jako zdroj dat v nahlížecí tabulce.
• Povolit otevírání záznamů
  • Pro všechny ovládací prvky editačního formuláře s možností pickeru
  • Zaškrtnutí tohoto pole určuje, zda má být možné otevírat jednotlivé záznamy z nahlížecí tabulky pickeru, a v dialogovém okně pickeru zobrazit detail konkrétního databázového záznamu přímo v jeho editačním formuláři.
• Povolit výběr více záznamů najednou
  • Pro všechny ovládací prvky editačního formuláře s možností pickeru
  • Zaškrtnutí tohoto pole umožňuje výběr více záznamů v pickeru najednou. Jednotlivé záznamy se v pickeru vybírají zaškrtnutím checkboxu umístěného na každé řádce nahlížecí tabulky pickeru v prvním sloupci. Tímto způsobem je však možné pickovat pouze sloupec „(ID)“ tj. primární klíč. Do editačního formuláře se vybrané záznamy převezmou jako jednotlivé hodnoty primárního klíče oddělené středníkem.

2.5. Přiřazovací tabulka

• Sloupce
  • Nastavení sloupců určuje, jaký sloupec nahlížecí tabulky v pickeru bude zkopírován do jakého ovládacího prvku v editačním formuláři.
  • Pickované sloupce – ty co mají nastavený zdroj a cíl – se automaticky zobrazují v nahlížecí tabulce pickeru v pořadí, v jakém jsou uvedeny v přiřazovací tabulce.
  • Sloupce v nahlížecí tabulce pickeru je možné skrýt výběrem příkazu „Skrýt“ z rozbalovacího seznamu umístěného napravo vedle rozbalovacího seznamu „Cíl“.
  • U sloupců v nahlížecí tabulce pickeru je možné aktivovat hledání výběrem příkazu „Aktivovat hledání“ z rozbalovacího seznamu umístěného napravo vedle rozbalovacího seznamu „Cíl“.
  • Není-li zvolen žádný sloupec pro hledání, automaticky se aktivuje hledání u všech sloupců nahlížecí tabulky pickeru, kde je to povolené z pohledu obecného nastavení vyhledávání v nahlížecích tabulkách, které se definuje ve vlastnostech ovládacího prvku.

3. Záložka „Nápověda“

• Na záložce „Nápověda“ je možné nastavit seznam všech dalších sloupců, které mají být zobrazeny v nahlížecí tabulce pickeru, přestože se žádný z těchto sloupců nepickuje.

4. Záložka „Aktivovat hledání“

• Na záložce „Aktivovat hledání“ je možné nastavit seznam všech dalších sloupců, ve kterých má být aktivováno hledání.

5. Záložka „Ostatní“

• Název šablony
  • Nastavení pickeru je možné uložit do šablony, aby se dalo snadno zkopírovat při nastavování pickeru dalšího ovládacího prvku, který načítá data ze stejného zdroje dat.

6. Tlačítka „Uložit“, „Vynulovat přiřazovací tabulku“ a „Skrýt – pro vše“

• Tlačítko „Uložit” – Uložení změn v nastavení pickeru.
• Tlačítko „Vynulovat přiřazovací tabulku“ – Odstranění aktuálních přiřazení mezi zdrojem a cílem na všech řádkách přiřazovací tabulky. Hodnoty ve sloupci Cíl a Možnosti jsou tímto tlačítkem vráceny do nepřiřazeného stavu.
• Tlačítko „Skrýt – pro vše“ – Nastavení příznaku „Skrýt“ na všech řádkách přiřazovací tabulky.