Použití a příklad

Webové rozšíření Seznam položek má parametry pro základní funkci a další parametry pro přizpůsobení jeho obsahu.

Jedná se o tyto primární parametry:

  • Klíče položky: Odkaz na rozsah buněk, které obsahují jedinečné názvy položek a akcí pro další zpracování. Při aktivaci akce odešle hodnota Actions.Input.Text jednu z těchto hodnot:
    • Actions.Input.Text="Row": Položka se vybere.
    • Actions.Input.Text="Edit": Došlo ke kliknutí na tlačítko Upravit.
    • Actions.Input.Text="Delete": Došlo ke kliknutí na tlačítko Odstranit.
  • Data položky: Odkaz na rozsah buněk obsahující data položky nebo na buňku obsahující data XML ze stejných dat. První sloupec rozsahu dat je vyhrazen pro tyto volitelné vlastnosti klíčů položek:
  • Nadpis (řetězec)
  • Popis 1 (řetězec)
  • Popis 2 (řetězec)
  • Časová značka (řetězec)
  • Viditelné (logická hodnota): Pokud je nastavení False, je položka skrytá. Výchozí nastavení je True.
  • Povoleno (booleovská hodnota): Pokud je hodnota False, položka je deaktivována. Výchozí nastavení je True.
  • Vybráno (logická hodnota): Pokud je hodnota True, položka bude vybrána. Výchozí nastavení je False.
  • Upravit (logická hodnota): Pokud je hodnota True, zobrazí se vložené ikony Upravit a Odstranit. Výchozí nastavení je False.
Tyto další parametry umožňují vlastní nastavení obsahu. Zadáním parametru ="" se stanoví využití výchozích hodnot, je-li to možné.
Poznámka

Pokud můžete zadat text, například pro chybovou zprávu, použijte funkci TRANSLATEUNIQUESTRING, aby byl zajištěn překlad textu, pokud se změní jazyk uživatelského rozhraní.

  • Vícenásobný výběr: Pokud je hodnota True, je povolen vícenásobný výběr. Výchozí nastavení je False.
  • Zástupný symbol vyhledávacího pole: Ve výchozím nastavení je vyhledávací pole viditelné a prázdné. Chcete-li deaktivovat zaškrtávací políčko, zadejte hodnotu False.
  • Chybová zpráva: Pokud ve výchozím nastavení nejsou žádné položky seznamu, zobrazí se chybová zpráva Nejsou dostupné žádné položky.
  • Hlavní nadpis: Nadpis seznamu. Ve výchozím nastavení se nezobrazí žádný nadpis.
  • Barva hlavního nadpisu: Výchozí barva nadpisu je #368ac0.
  • Barva nadpisu: Výchozí barva písma nadpisu je #1a1a1.
  • Vybraná barva: Barva, kterou je vybraný řádek zvýrazněn. Výchozí hodnota je #c8e9f4.
  • Text vybraných položek: Standardně je text Vybráno. Tento parametr lze použít pouze v případě, že je povolen vícenásobný výběr.
  • Akce odebrání: Definujte akci pro buňku, která se spustí po kliknutí na tlačítko Odebrat. Výchozí text je Odebrat. Tento parametr lze použít pouze v případě, že je povolen vícenásobný výběr.
  • Skrýt boční ohraničení: Zadáním hodnoty True skryjete levé a pravé ohraničení řádku. Standardně je ohraničení viditelné.
  • Barva ohraničení: Standardně je barva ohraničení #d8d8d8.
  1. Vytvořte report Application Studio.
  2. Vložte tato vzorová data do rozsahu B8:H12:
    Klíč Nadpis Popis1 Popis2 Povoleno Vybráno Upravit
    a Položka A Popis A FALSE TRUE
    b Položka B Popis B Podrobné informace B FALSE FALSE FALSE
    c Položka C Popis C TRUE FALSE
    u Položka D Popis D FALSE FALSE
  3. Vytvořte proměnnou reportu s názvem rv_SelectedItem a jako hodnotu a výchozí hodnotu zadejte c a vyberte ji jako hodnotu. Ve vlastnostech proměnné zadejte False jako hodnotu možnosti Je neměnný.
  4. Do buňky G9 zadejte =ReportVariables.rv_SelectedItem.Text=B9. Zkopírujte vzorec do buněk G10, G11 a G12.
    Po této aktualizaci si buňky uchovávají své původní texty.
  5. U každé buňky klíče (B9, B10, B11 a B12) vytvořte akci s těmito charakteristikami:
    Akce: Typ
    Jako typ akce vyberte možnost Nastavit parametry.
    Akce: Režim
    Jako režim vyberte Webové rozšíření.
    Akce: Podmínka
    Zadejte =Actions.Input.Text="ROW".
    Poznámka

    Tato podmínka je neplatná, pokud není režim akce webové rozšíření.

    Parametry: Název
    Klikněte na možnost Přidat parametr a vyberte proměnnou rv_SelectedItem.
    Parametry: Vlastnost
    Zadejte Selected Value(.Text).
    Parametry: Hodnota
    Pro akci v buňce B9 zadejte =B9. U ostatních akcí zadejte =B10, =B11 a =B12.
  6. Vytvořte proměnnou reportu s názvem rv_TitleItemA a jako hodnotu zadejte Položka A. Ve vlastnostech proměnné zadejte jako výchozí hodnotu Položka A a jako hodnotu možnosti Je neměnný vyberte možnost False.
  7. V buňce C9 zadejte =ReportVariables.rv_TitleItemA.Text a stiskněte klávesu Enter.
    Po této aktualizaci si buňka ponechá svůj původní text.
  8. V buňce B9 vytvořte akci s těmito charakteristikami:
    Akce: Typ
    Jako typ akce vyberte možnost Nastavit parametry.
    Akce: Režim
    Jako režim vyberte Webové rozšíření.
    Akce: Podmínka
    Zadejte =Actions.Input.Text="EDIT"
    Poznámka

    Tato podmínka je neplatná, pokud není režim akce webové rozšíření.

    Parametry: Název
    Klikněte na možnost Přidat parametr a vyberte proměnnou rv_TitleItemA.
    Parametry: Vlastnost
    Vyberte Value(.Text)
    Parametry: Hodnota
    Zadejte ="Edited Item A".
  9. Do buňky B13 zadejte tento vzorec SETPROPERTY: 
    =SETPROPERTY("",B9:B12,C8,C9:C12,D8,D9:D12,E8,E9:E12,F8,F9:F12,G8,G9:G12,H8,H9:H12)
  10. Na panelu nástrojů Objekty klikněte na možnost Webové rozšíření a dvojitě klikněte na webové rozšíření Seznam položek.
    Kurzor se změní na křížek.
  11. Přetáhnutím kurzorem vložíte, stanovíte velikost a pozici webového rozšíření.
  12. Zadejte tyto parametry.
    Jedinečné názvy
    Zadejte rozsah buněk, které obsahují jedinečné názvy položek seznamu. V tomto příkladu zadejte =B9:B12.
    Data položky
    Zadejte rozsah buněk, který definuje datovou tabulku pro rozšíření. V tomto příkladu zadejte =B13.
  13. Volitelně zadejte hodnoty pro tyto parametry nebo zadejte ="" pro použití výchozích hodnot.
    Hlavní nadpis
    Ve výchozím nastavení nemá seznam nadpis. Volitelně zadejte nadpis.
    Barva písma hlavního nadpisu
    Je-li zadán hlavní nadpis, je jeho výchozí barva modrá (#368ac0). Volitelně zadejte jinou hodnotu barvy.
    Zástupný symbol vyhledávacího pole
    Ve výchozím nastavení je vyhledávací pole prázdné. Volitelně zadejte text k zobrazení v poli. Chcete-li skrýt vyhledávací pole, zadejte hodnotu FALSE (rozlišuje malá a velká písmena).
    Chybová zpráva
    Ve výchozím nastavení se nezobrazí žádná chyba, pokud nejsou k dispozici žádné položky. Volitelně zadejte chybovou zprávu. Pomocí funkce TRANSLATESTRING usnadníte překlad chyby, pokud dojde ke změně jazyka uživatelského rozhraní.
    Barva písma nadpisu
    Ve výchozím nastavení je název položek seznamu tmavě šedý (#1a1a1a). Volitelně zadejte jinou hodnotu barvy.
    Vybraná barva
    Zadejte barvu, kterou je vybraná položka seznamu zvýrazněná. Výchozí nastavení je světle modrá (#c8e9f4). Volitelně zadejte jinou hodnotu barvy.
    Vícenásobný výběr
    Ve výchozím nastavení můžete vybrat pouze jednotlivé položky. Chcete-li aktivovat zaškrtávací políčka pro výběr více položek, zadejte hodnotu ="TRUE".
    Skrýt boční ohraničení
    Ve výchozím nastavení má každý řádek ohraničení vlevo a vpravo. Chcete-li toto ohraničení skrýt, zadejte hodnotu "=TRUE".
    Barva ohraničení
    Ve výchozím nastavení je ohraničení seznamu nahoře a po stranách světle šedé (#d8d8d8). Volitelně zadejte jinou hodnotu barvy.
    Text vybraných položek
    Je-li vícenásobný výběr aktivní, je uveden počet vybraných položek s údajem Vybráno. Volitelně zadejte jiný text. Pomocí funkce TRANSLATESTRINGUNIQUE usnadníte překlad textu, pokud dojde ke změně jazyka uživatelského rozhraní.
    Tlačítko Odebrat na panelu akcí

    Je-li vícenásobný výběr aktivní, můžete zobrazit tlačítko Odebrat pro zrušení výběru vybraných položek. Zadejte odkaz na buňku, která obsahuje slovo Odebrat.

    Pomocí funkce TRANSLATESTRING usnadníte překlad tlačítka, pokud dojde ke změně jazyka uživatelského rozhraní.