Příručka ve formátu PDF
1. Základní informace
1.1. Popis ovládacího prvku
TextBox je textové pole libovolné šířky a výšky určené k zadávání prostého textu.
1.2. Vytvoření nového ovládacího prvku
Nový textbox je možné vytvořit následujícím způsobem z nahlížecí stránky pomocí toolbaru s ovládacími prvky:
- Nejdříve se kliknutím myši na nahlížecí stránce určí pozice, na kterou má být nový textbox umístěn. Tím dojde ke zvýraznění vybrané pozice šedou horizontální linií. Následně stačí v toolbaru nahlížecí stránky kliknout na položku „TextBox“, v nově otevřeném dialogu vyplnit atributy nového ovládacího prvku, a následně uložit. Tím dojde k vložení nového textboxu na předem vybrané místo nahlížecí stránky.
- Nedojde-li před vložením nového textboxu k určení požadované pozice, bude nový textbox vložen na konec nahlížecí stránky.
1.3. Editace nebo smazání ovládacího prvku
- U každého existujícího ovládacího prvku se po jeho levé straně v nahlížecí stránce zobrazuje ikona tužky, která slouží pro změnu nastavení ovládacího prvku nebo jeho smazání.
- Jednotlivé ovládací prvky mohou být na nahlížecí stránce vertikálně přesouvány metodou Drag&Drop. Přesunutí spočívá v chycení ovládacího prvku nejlépe za jeho název, a následném tažení až na požadované místo na nahlížecí stránce.
- Z bezpečnostních důvodů je důležité mít povolenou funkci přesouvání ovládacích prvků pomocí zaškrtávacího pole „Drag&Drop“ umístěného nad toolbarem s ovládacími prvky. Při každém přihlášení do aplikace je toto pole nezaškrtnuté.
2. Seznam záložek v dialogu nastavení ovládacího prvku
- Obecné – Nastavení obecných vlastností
- Práva – Nastavení práv
- Administrace – Nastavení ostatních vlastností
2.1. Záložka „Obecné“
2.1.1. Název
- Název ovládacího prvku zobrazovaný na nahlížecí stránce v samostatném sloupci s barevným pozadím nalevo vedle samotného textového pole.
2.1.2. Slovník…
- Slovník zobrazuje seznam názvů ostatních ovládacích prvků, formulářů, nahlížecích stránek, kategorií, aplikací a aplikačních skupin, použitých napříč celou aplikací.
- Vyhledávání ve slovníku slouží k navržení správného názvu ovládacího prvku a k udržení konzistence názvosloví v celé aplikaci tak, aby se ovládací prvky se stejným významem umístěné na různých místech v aplikaci nazývaly stejným způsobem.
2.1.3. Datový typ
- Datový typ definuje druh nebo význam hodnot, kterých může ovládací prvek nabývat.
- Rozbalovací seznam obsahuje následující datové typy:
- Textový řetězec
- Celé číslo
- Velké celé číslo
- Desetinné číslo
- Měna
- Datum
- Čas (hh:mm)
- Čas (hh:mm:ss)
- URL
- Síťový odkaz
- Telefonní číslo
- IP adresa
2.1.4. Jednotka
- Jednotka určuje symbol (například „%“), který se zobrazuje napravo vedle samotného textového pole.
2.1.5. Šířka
- Šířka ovládacího prvku uvedená v pixelech.
2.1.6. Hodnota
- Hodnotu definuje databázový dotaz, který je vyhodnocen při otevření nahlížecí stránky, a určuje hodnotu zobrazovanou v textovém poli.
- K hodnotě textového pole je možné přistupovat pomocí proměnných „#textbox1#“, „#textbox2#“, „#textbox3#“ atd. ve skriptu. Index značí pořadí textboxu na nahlížecí stránce.
2.1.7. Možnosti
- Jen ke čtení
- Nastavení ovládacího prvku jen ke čtení určuje, zda má být na nahlížecí stránce textové pole disablované.
- Do disablovaného pole není možné ručně zapisovat hodnoty, samotné textové pole má zašedlé pozadí, a text hodnoty v tomto poli se zobrazuje odlišným fontem než u zbytku ovládacích prvků.
2.2. Záložka „Práva“
2.2.1. Práva
- Práva definují seznam uživatelských skupin a uživatelů, kteří mají oprávnění na zobrazení ovládacího prvku na nahlížecí stránce.
2.2.2. Nahradit práva ostatním ovládacím prvkům
- Funkce „Nahradit práva ostatním ovládacím prvkům“ slouží pro sjednocení práv v rámci celé nahlížecí stránky u ovládacích prvků, které spolu z pohledu práv souvisí.
- Díky odkazu „Zobrazit…“ je možné zobrazit seznam všech ovládacích prvků na nahlížecí stránce včetně nastavení práv těchto ovládacích prvků. U každého ovládacího prvku je zobrazeno zaškrtávací tlačítko, kterým je možné ovládací prvek vybrat. Při uložení ovládacího prvku se následně nastaví stejná práva i těmto vybraným ovládacím prvkům.
- Alternativou pro sjednocení práv v rámci celé nahlížecí stránky je zobrazení reportu dostupného ze záložky „Práva podřízených objektů“ v nastavení nahlížecí stránky.
2.3. Záložka „Administrace“
- Záložka „Administrace“ se zobrazuje pouze u existujících ovládacích prvků.
2.3.1. Umístění
- Výběr nahlížecí stránky, na které je ovládací prvek umístěn.
- Rozbalovací seznam obsahuje všechny nahlížecí stránky umístěné ve stejné aplikaci.
3. Příklady
3.1. Proměnné
- #textbox1#
- #textbox2#
- #textbox3#