www.proxima-soft.sk

[Juraj Z.]

Ako sa pracuje s komponentou PxFlyComboBox?

[admin]

PxFlyComboBox - s�ria comboboxov, zapojen�ch za sebou, vhodn� pre pr�cu zo �trukt�rovan�mi d�tami (napr. v�ber kateg�rii a podkateg�rii)

Here you will find an article about PxFlyComboBox component in English:
http://www.proxima-soft.sk/articles/PxFlyComboBox-set-of-consecutively-linked-comboboxes-suitable-for-work-with-structured-data-category-and-subcategory.html

Komponenta PxFlyComboBox, sl��i na v�ber hodnoty, pri �trukt�rovan�ch zoznamoch, naj�astej�ie pou�itie b�va, ke� sa nejak� objekt za�le�uje do nejakej kateg�rie, a podkateg�rie. Komponenta PxFlyComboBox sa m��e sklada� z nieko�k�ch comboboxov(komponenty DropDownList), prepojen�ch vz�jomne medzi sebou. T�chto comboboxov m��e by� �ubovoln� po�et, 2 a� n. Viac obr�zok:



Na obr�zku m�me vyber n�zvu obce. Preto�e, obc� na Slovensku m�me skoro 3000, bolo by dos� obtia�ne vybera� z tak�hoto zoznamu. Tu n�m u�ah�� pr�cu, komponenta PxFlyComboBox. Pri v�bere konkr�tneho kr�ja, sa n�m do comboboxu okres, vyfiltruj� len tie okresy, za dan� kraj. Ke� si zvol�me konkr�tny okres, tak sa n�m do comboboxu obc� vyfiltruj�, len obce za dan� zvolen� okres.
Naprogramova�, tak�to nie�o, bohu�ia� nie je jednoduch�, ale PxFramework V�m poskytuje r�chle a lacn� rie�enie.

Na to, aby V�m komponenta PxFlyComboBox, spr�vne fungovala mus�te uvali� parameter AddParamFlyComboBox, na dan� komponentu PxWebQuery, ktor� bude zobrazova� alebo pracova� s takto �trukt�rovan�mi d�tami. Defin�cia parametra AddParamFlyComboBox vyzer� nasledovne:

k�d:

wquAdresar.AddParamFlyComboBox("miesto", "idkraj;idokres;idobec",             "idkraj;idokres;idobec", "kraj;okres;obec",             "Obec;Okres", "wquObec", "mvStandard");

Popis Parametrov met�dy AddParamFlyComboBox:
C# syntax:

public void AddParamFlyComboBox(string aFieldName, string aKeyFields,
string aKeyDetailFields, string aValueFields,
string aFieldToView, string aPxWebQueryName,
string aModeToView)


Popis parametrov:

aFieldName - Meno st�pca, ktor� sa vytvor� ako nov� st�pec v tabu�ke na ktor� sa aplikuje met�da AddParamFlyComboBox, a na ktor� sa potom nap�ja komponenta PxFlyComboBox (toto meno st�pca mus� by� jedine�ne, v tabu�ke nesmie existova� st�pec s t�mto menom).
aKeyFields - Hodnota re�azca, do ktorej sa definuj� k���e (Key) st�pcov hlavnej tabu�ky, do ktor�ch sa pri edit�cii komponentou PxFlyComboBox zapisuj� Ide�ka, v na�om pr�pade IdKraja, IdOkresu a IdObce. Tieto st�pce s� zap�san� v porad�, jeden za druh�m, ako sa maj� zobrazi� v komponente PxFlyComboBox. Jednotliv� st�pce s� oddelen� bodko�iarkou.
aKeyDetailFields - Hodnota re�azca, do ktorej sa definuj� k���e (Key) st�pcov tabu�ky ��seln�ka, z ktor�ch sa pri edit�cii komponentou PxFlyComboBox vyberaj� Ide�ka, a zapisuj� do hlavnej tabu�ky. V na�om pr�pade sa jedn� o st�pce IdKraja, IdOkresu a IdObce. Tieto st�pce s� zap�san� v porad�, jeden za druh�m, ako sa maj� zobrazi� v komponente PxFlyComboBox. Jednotliv� st�pce s� oddelen� bodko�iarkou.
aValueFields - Hodnota re�azca, do ktorej sa definuj� hodnoty (Value) st�pcov tabu�ky ��seln�ka, ktor� sa pri edit�cii komponentou PxFlyComboBox zobrazuj� v tejto komponente. V na�om pr�pade sa jedn� o st�pce Kraja, Okresu a Obce. Tieto st�pce s� zap�san� v porad�, jeden za druh�m, ako sa maj� zobrazi� v komponente PxFlyComboBox. Jednotliv� st�pce s� oddelen� bodko�iarkou.
aFieldToView - Hodnota re�azca, ktorou sa definuj� men� st�pcov, ktor� s� zobrazovan� v komponente PxSuperGrid, pod n�zvom st�pca aFieldName. Vypis, alebo v��et t�chto st�pcov nemus� by� kompletn�. Tieto st�pce s� zap�san� v porad�, jeden za druh�m, ako sa maj� zobrazi� v komponente PxSuperGrid. Jednotliv� n�zvy st�pcov s� oddelen� bodko�iarkou.
aPxWebQueryName - N�zov komponenty PxWebQuery, v ktorej je natiahnut� ��seln�k Kraja, Okresu a Obce. Tento ��seln�k je vytvoren� zl��en�m troch ��seln�kov a to v na�om pr�pade ��seln�kov Ckraj, Cokres, CObec.
aModeToView - T�mto re�azcom sa definuje zobrazenie d�t v komponente PxSuperGrid, v na�om pr�pade st�pca zadefinovan�ho v polo�ke aFieldName. Existuj�ce m�dy zobrazenia s� nasledovn�: mvValueBR, mvNameAndBR a mvNormal.

Pri zadan� re�azca "Obec;Okres" do polo�ky FieldToView, nastavenom m�de zobrazenia mvNormal, bude zobrazenie v komponente PxSuperGrid vyzera� nasledovne:



Pri zadan� re�azca "Obec;Okres" do polo�ky FieldToView, nastavenom m�de zobrazenia mvValueBR, bude zobrazenie v komponente PxSuperGrid vyzera� nasledovne:



Pri zadan� re�azca "Obec;Okres" do polo�ky FieldToView, nastavenom m�de zobrazenia mvNameAndBR, bude zobrazenie v komponente PxSuperGrid vyzera� nasledovne:



Pri zadan� re�azca "Obec;Okres;Kraj" do polo�ky FieldToView, nastavenom m�de zobrazenia mvNameAndBR, bude zobrazenie v komponente PxSuperGrid vyzera� nasledovne:



Celkov� zobrazenie komponenty PxSuperGrid, pri uvalen� parametra AddParamFlyCombobox na komponentu PxWebQuery bude vyzera� nasledovne:



Ale vr�me sa ku konkr�tnemu programovaniu s komponentov PxFlyComboBox, n�mu pr�kladu adres�ra os�b a firiem.

Na to aby sme mohli uvali� parameter AddParamFlyComboBox na komponentu wquAdresar, mus�me vytvori� novu komponentu PxWebQuery, a tu nazveme wquObec. V s�bore Adreasar.aspx dopln�me t�to nov� komponentu, a defin�cia bude vyzera� nasledovne:

k�d:

<Prx:PxWebQuery ID="wquObec" runat="server" Value="wquObec"/> <Prx:PxWebQuery ID="wquAdresar" runat="server" Value="wquAdresar"/>

Nezabudnime komponentu wquObec, zadefinova� pred komponentou wquAdresar.

�alej v s�bore Adreasar.aspx.cs na��tame d�ta do komponenty wquObec, a potom urob�me prepojenie tejto komponenty s komponentou wquAdresar, cez parameter AddParamFlyComboBox. Pri definovan� komponenty wquObec, mus�me vytvori� �peci�lny SQL select, do ktor�ho zl��ime tri tabu�ky, a to tabu�ky Ckraj, Cokres, CObec.
Tento SQL pr�kaz vyzer� nasledovne:

k�d:

select   COBEC.ID_OBEC as IDOBEC, COBEC.NAZOV_OBEC as OBEC,   COBEC.ID_OKRES as IDOKRES, COKRES.NAZOV_OKRES as OKRES,   COBEC.ID_KRAJ as IDKRAJ,CKRAJ.NAZOV_KRAJ as KRAJ from   COBEC,COKRES,CKRAJ where   COBEC.ID_OKRES=COKRES.ID_OKRES and   COBEC.ID_KRAJ=CKRAJ.ID_KRAJ

V�sledkom tak�hoto SQL pr�kazu je tabu�ka, viz. na obr�zku dole:



Z takouto tabu�kou, komponenta PxFlyComboBox vie pracova� pomerne celkom dobre. A tu v �al�om m�te v�pis zdrojov�ho k�du s�boru Adresar.aspx.cs, pre naplnenie d�t komponenty wquObec, a jej prepojenie z komponentou wquAdresar, cez parameter AddParamFlyComboBox.

k�d:

protected void Page_Load(object sender, EventArgs e) {   if ((!IsPostBack) && (wquObec.Active == false))   {     wquObec.ConnectString = "User Id=skodapeter;Password=aa;Data Source=xe;";     wquObec.SQLSelect = @"select COBEC.ID_OBEC as IDOBEC, COBEC.NAZOV_OBEC as OBEC,       COBEC.ID_OKRES as IDOKRES, COKRES.NAZOV_OKRES as OKRES,       COBEC.ID_KRAJ as IDKRAJ,CKRAJ.NAZOV_KRAJ as KRAJ     from       COBEC,COKRES,CKRAJ     where COBEC.ID_OKRES=COKRES.ID_OKRES and       COBEC.ID_KRAJ=CKRAJ.ID_KRAJ";     wquObec.Open();     wquObec.Columns["IDOBEC"].Caption = "Id Obec";     wquObec.Columns["OBEC"].Caption = "Obec";     wquObec.Columns["IDOKRES"].Caption = "Id Okres";     wquObec.Columns["OKRES"].Caption = "Okres";     wquObec.Columns["IDKRAJ"].Caption = "Id Kraj";     wquObec.Columns["KRAJ"].Caption = "Kraj";   }   if ((!IsPostBack)&&(wquAdresar.Active==false))   {     string sSQLText1 = "select IDPravForm as Key, Name as Value from PravForm Order By Value";     wquAdresar.ConnectString = "User Id=skodapeter;Password=aa;Data Source=xe;";     wquAdresar.SQLSelect = @"select idadresar , name, address, idpravnaforma,       create_date, invalid_adress, idkraj,       idokres, idobec from Adresar03";     wquAdresar.AddParamKey("idpravnaforma", "Key", "Value", "Value", "Key", sSQLText1);     wquAdresar.AddParamCheck("invalid_adress", "A", "N", false);     wquAdresar.AddParamFlyComboBox("miesto", "idkraj;idokres;idobec",       "idkraj;idokres;idobec", "kraj;okres;obec",       "Obec;Okres;Kraj", "wquObec", "mvNameAndBR");     wquAdresar.Open();     wquAdresar.Columns["idadresar"].Caption = "ID";     wquAdresar.Columns["name"].Caption = "Meno Osoby";     wquAdresar.Columns["idpravnaforma"].Caption = "Pr�vna Forma";     wquAdresar.Columns["address"].Caption = "Ulica";     wquAdresar.Columns["create_date"].Caption = "D�tum zalo�enia";     wquAdresar.Columns["invalid_adress"].Caption = "Adresa neplatn�";     wquAdresar.Columns["miesto"].Caption = "Obec, Okres";   }   else   {   }   grdAdresar.PxDataSource = wquAdresar;   grdAdresar.DataBind(); }

Pokia� chceme vo formul�ri AddAdresar.aspx, chceme pou�i� komponentu PxFlyComboBox na edit�ciu, tak ju v tomto s�bore zadefinujeme nasledovne:

k�d:

<Prx:PxWebQuery ID="wquObec" runat="server" Value="wquObec"/> <Prx:PxWebQuery ID="wquAdresar" runat="server" Value="wquAdresar"/> <Prx:PxEdit ID="edtIDADRESAR" runat="server" AddTableRow="True" TableBegin="True" ></Prx:PxEdit> <Prx:PxEdit ID="edtName" runat="server" AddTableRow="True" ></Prx:PxEdit> <Prx:PxComboBox ID="cmbPravnaForma" runat="server" AddTableRow="True" ></Prx:PxComboBox> <Prx:PxJSDatePicker ID="edtCREATE_DATE" runat="server" AddTableRow="True" ></Prx:PxJSDatePicker> <Prx:PxCheckBox ID="chkInvalid_Adress" runat="server" AddTableRow="True" ></Prx:PxCheckBox> <Prx:PxEdit ID="edtADDRESS" runat="server" AddTableRow="True" TableEnd="True"></Prx:PxEdit> <Prx:PxFlyComboBox ID="fcmbMiesto" runat="server"></Prx:PxFlyComboBox>

V s�bore AddAdresar.aspx.cs prepoj�me komponentu PxFlyComboBox s komponentou wquAdresar, toto prepojenie by malo vyzera� nasledovne:

k�d:

fcmbMiesto.PxDataSource = wquAdresar; fcmbMiesto.FieldName = "miesto";

Pri defin�cii FieldName, treba pou�i� property ColumnName, a nie ToString(), lebo komponenta PxFlyComboBox sa n�m vo formul�ry nezobraz�.

Komponenta PxFlyComboBox nepodporuje zarovnanie a property AddTableRow, TableBegin a TableEnd, ktor� podporuj� ostatn� komponenty PxEdit a pod.

Pri defin�cii v s�bore AddAdresar.aspx, nesmieme e�te zabudn�� okrem definovania riadku komponenty PxFlyComboBox, definova� komponentu wquObec, lebo ak t�to zabudneme definova�, komponenta PxFlyComboBox sa n�m vo formul�ry AddAdresar.aspx nezobraz�.

k�d:

<Prx:PxWebQuery ID="wquObec" runat="server" Value="wquObec"/> <Prx:PxWebQuery ID="wquAdresar" runat="server" Value="wquAdresar"/>

Ak sme nastavili v�etko tak, ako sme mali, v�sledn� formul�r AddAdresar.aspx, bude vyzera� nasledovne:



Popisky v Gride(Title) a popisky v komponente PxFlyComboBox (Caption), sa daj� definova� centr�lne pri defin�cii komponenty wquObec:

k�d:

wquObec.Columns["IDOBEC"].Caption = "Id Obec"; wquObec.Columns["OBEC"].Caption = "Obec"; wquObec.Columns["IDOKRES"].Caption = "Id Okres"; wquObec.Columns["OKRES"].Caption = "Okres"; wquObec.Columns["IDKRAJ"].Caption = "Id Kraj"; wquObec.Columns["KRAJ"].Caption = "Kraj";

Tu n�jdete funk�n� pr�klad s komponentou PxFlyComboBox, aj so zdrojov�mi k�dmi. Tento funk�n� pr�klad na tomto webe, be�� pod datab�zou MySQL 5.0.

PxFlyComboBox - s�ria comboboxov, zapojen�ch za sebou, vhodn� pre pr�cu zo �trukt�rovan�mi d�tami (napr. v�ber kateg�rii a podkateg�rii)