Články o Px Frameworku:

PxRadioButtonList - komponenta pre zobrazenie a výber hodnoty zo zoznamu

Komponenta PxRadioButtonList má mnoho podobných property, ako komponenta PxEdit. Preto nemá zmysel sa nimi podrobne zaoberať, môžete si prečítať kapitolu o komponente PxEdit. Veci, ktoré boli podrobne popísané pri komponente PxEdit, budú tuná prejdené len telegraficky, zbežne.

Pomocou komponenty PxRadioButtonList môžeme automaticky editovať stĺpec riadka tabuľky, ktorý je natiahnutý v komponente PxWebQuery. Vytvoríme si súbor AddAdresar.aspx, a do neho zapíšeme nasledujúcu definíciu komponenty PxRadioButtonList:

Súbor AddAdresar.aspx:



V súbore AddAdresar.aspx.cs, si zase zadefinujeme prepojenie komponenty PxRadioButtonList s komponentou PxWebQuery, a jej prepojenie na konkrétny stĺpec tabuľky.

Súbor AddAdresar.aspx.cs:



Komponenta PxRadioButtonList podporuje automatické načítanie hodnoty z parametru komponenty PxWebQuery, a automatické uloženie zvolenej hodnoty do databázy, pri vykonaní príkazu Post() na komponente PxWebQuery. Tým že komponenta PxRadioButtonList umožňuje, vybrať len jednu položku zo zoznamu, je možne zadať na komponente PxWebQuery, ako tieto stavy budú zobrazované a zapísané do databázy. Na definíciu sa používa parameter s názvom metódy AddParamRadioList. Metóda AddParamRadiokList je metódou komponenty PxWebQuery.

Popis Parametrov metódy AddParamRadioList:
C# syntax:



Popis parametrov:

aFieldName - Meno stĺpca v tabuľke na ktorý sa aplikuje metóda AddParamRadioList
aDataKey - Meno stĺpca do ktorého sa zadá reťazec kľúčov, oddelených bodkočiarkou, v tomto prípade to je "1;2"
aDataValue - Meno stĺpca do ktorého sa zadá reťazec hodnôt (value), oddelených bodkočiarkou, v tom poradí ako boli zadané hodnoty kľúčou, v tomto prípade to je "Posudzovať;Neposudzovať". Tento text bude aj zobrazený pri jednotlivých butónoch v komponente PxRadioButtonList
aFieldToView - tu sa zadáva meno stĺpca, ktorého hodnota sa bude zobrazovať v Gride(PxSuperGrid), v tomto prípade sú to texty "Value" a "Key".
aFieldToDB - tu sa zadáva meno stĺpca, ktorého hodnota bude zapísaná do databázy, v tomto prípade sú to texty "Value" a "Key".

Príklad zadania v súbore AddAdresar.aspx.cs v metóde Page_Load:



Po uvalení parametra AddParamRadioList na komponentu PxWebQuery, a napojení komponenty PxRadioButtonList, si táto komponenta pri načítaní automaticky natiahne dáta z parametra, a pri ukladaní sa automaticky uloží zvolená hodnota do databázy.




Na zarovnanie komponenty sa opäť používajú property AddTableRow, TableBegin a TableEnd, ktoré sú dobre popísané a rozobrané v časti kde je popísaná komponenta PxEdit.

Názov popiskov Caption, alebo názvy stĺpcov v gride(Title) môžete zadať centrálne, pri definícii komponenty PxWebQuery, kde hodnota v hranatých zátvorkách je názov stĺpca:



Zmena popisku komponenty PxRadioButtonList (Label):
Zmenu popisku komponenty PxRadioButtonList, okrem centrálnej definície, môžeme vykonať nasledujúcim spôsobom:



Pokiaľ by sme chceli umiestniť popisok komponenty PxRadioButtonList nad telo komponenty(tak ako je to na hornom obrázku), použijeme k tomu property CaptionOnTop, viac príklad dole:



Komponenta PxRadioButtonList bola vybavená navyše nulovacím tlačítkom, ktoré sa aktivuje nastavením property ThreeState na hodnotu "true". Nulovacie tlačítko slúži na vynulovanie obsahu komponenty PxRadioButtonList.



To ako vyzerá komponenta PxRadioButtonList s nulovacím tlačítkom, vidíte na obrázku dole.