Com Ref - Analýza: Dialog - Uživatelská Příručka Epi Info ™

2023 Autor: Stephanie Arnold | [email protected]. Naposledy změněno: 2023-11-26 09:30

Referenční příručka

Příkazy pro analýzu: DIALOG

Popis

Tento příkaz poskytuje interakci s uživatelem z programu. Dialogy mohou zobrazovat informace, požadovat a přijímat vstupy a seznamy nabídek pro výběr.

Syntax

Jednoduchá forma

DIALOG “” {TITLETEXT =””}}

• představuje text, který se má zobrazit jako zpráva.
• představuje text, který se použije jako titulek pro dialogové okno. Pokud je příkaz Dialog vynechán, zobrazí se v záhlaví dialogového okna „Analýza“.

Získejte variabilní formulář

DIALOG “” {TITLETEXT =””}}

DIALOG „““, „ “, „ “, …, ““{TITLETEXT =" "}}

• představuje zadanou proměnnou pro uložení hodnoty.

• představuje vyhrazené slovo a / nebo masku, která definuje typ vstupu, který má být přijat a uložen v proměnné. Platné typy záznamů:

  • TEXTINPUT určuje vstup jako text.
  • YN určuje vstup jako logický.
  • DATEFORMAT (“”) určuje vstup jako datum; pokud není zadána maska data, použije se krátké datum systému.
  • „“Určuje vstup jako číselný. Tato možnost je označena jako „pouze číslo“. Číselná maska by měla být textový řetězec (např. „####“nebo „##. ###“), který označuje typ dat, která mají být zadána. # označuje číslici.
  • Není-li zadáno žádné, je vstupní proměnná interpretována pokud možno jako číslo. Pokud hodnota není platné číslo, ale je platným datem, je interpretována jako datum. Jinak dojde k chybě.
• představuje hodnotu v rozevíracím seznamu možností. Každá hodnota obsažená v příkazu se zobrazí jako jedna položka v seznamu.
• řídí typ souborů, které se zobrazují pro výběr. Skládá se ze střídavého popisu a filtračních prvků oddělených svislými pruhy. Zobrazí se popis, který si můžete vybrat. Soubory vybere odpovídající prvek filtru. Pokud je tento prvek ponechán prázdný, lze vybrat všechny soubory. Syntaxe je vytvořena pomocí možností Otevřít soubor a Uložit soubor z rozbalovací nabídky Formát dialogu.

Seznam hodnotových formulářů

DIALOG “” {TITLETEXT =””}}

DIALOG “” DBVALUES

{TITLETEXT = "}}

Jsou DATABASY a DBVIEWS

Komentáře

Jednoduchá forma DIALOG umísťuje dialogové okno na obrazovku pomocí poskytnutého textu pomocí tlačítka OK.

Formulář Získat proměnnou DIALOG zobrazí textovou výzvu a poskytuje prostředky pro zadání hodnoty.

• Pokud je zadáno YN, jsou zobrazena tlačítka „Ano“, „Ne“a „Zrušit“a zadaná proměnná je nastavena na (+), (-) nebo (.).
• Pokud je zadán TEXTINPUT nebo není zadán žádný typ záznamu, je pomocí tlačítek OK a Storno zadáno pole pro odpověď uživatele. Pokud je vybrána možnost Zrušit, je proměnné přiřazena hodnota vstupu s chybějící hodnotou.
• Formulář Získat proměnnou příkazu DIALOG může také zobrazit dialog pro výběr souboru. Pokud se používá READ, zobrazí se pouze existující soubory. Pokud je použit WRITE a je vybrán existující soubor, zobrazí se Přepsat? výzva.
• Formulář s více možnostmi DIALOG zobrazí textovou výzvu a poskytuje rozbalovací seznam pro výběr mezi hodnotami pomocí tlačítek OK a Storno. Pokud je vybrána možnost Zrušit, je proměnné přiřazena hodnota vstupu s chybějící hodnotou. Proměnná bude typ textu.
• Formulář Datum příkazu DIALOG používá speciální ovládací prvek pro přijetí vstupu. Každá část data (rok, měsíc a den) lze nezávisle zvětšit nebo zmenšit pomocí rozevíracího kalendáře. Pomocí tohoto ovládacího prvku nelze vybrat neplatné datum.

Formulář Seznam hodnot DIALOG zobrazuje rozbalovací seznam databází nebo proměnných formulářů s prezentovanými OK a Storno. Pokud je vybrána možnost Zrušit, je proměnné přiřazena hodnota vašeho vstupu s chybějící hodnotou. Proměnná bude typ textu. Formulář VARIABLE VALUE DIALOG zobrazuje pole se seznamem různých hodnot zadané proměnné v zadané databázi. Pokud je vybrána možnost Zrušit, je proměnné přiřazena hodnota vstupu s chybějící hodnotou. Proměnná bude stejného typu jako proměnná databáze.

Date Mask

Date Mask
*	Formát systémového času
!	Dlouhé datum systému

Numerická maska

Numerická maska
#	Zástupný symbol číslice (vyžaduje se zadání).
.	Desítkový zástupný znak. Skutečně použitý znak je znak zadaný jako desetinné místo v mezinárodním nastavení počítače.
,	Tisíce oddělovač. Skutečně použitý znak je znak zadaný jako tiskový zástupný symbol v mezinárodních nastaveních počítače.
9	Zástupný symbol. (Vstup nepovinný).
Interpunkce	Zahrnuto v displeji.

Vlastní formáty

Vlastní formáty
D	Jedno nebo dvoumístný den.
Dd	Dvoumístný den. Jednociferným denním hodnotám předchází nula.
Ddd	Zkratka třídenního dne v týdnu.
dddd	Celý název dne v týdnu.
H	Jedno nebo dvouciferné ve 12hodinovém formátu.
Hh	Dvouciferná hodina ve 12hodinovém formátu. Hodnotám jedné číslice předchází nula.
H	Jedno nebo dvouciferná hodina ve 24hodinovém formátu.
HH	Dvouciferná hodina ve 24hodinovém formátu. Hodnotám jedné číslice předchází nula.
M	Jedno- nebo dvouciferná minuta.
Mm	Dvouciferná minuta. Hodnotám jedné číslice předchází nula.
M	Jedno nebo dvoumístné číslo měsíce.
MM	Dvoumístné číslo měsíce. Hodnotám jedné číslice předchází nula.
MMM	Zkratka třímístného měsíce.
MMMM	Celé jméno měsíce.
S	Jedno nebo dvouciferné sekundy.
Ss	Dvouciferná sekunda. Jednociferným denním hodnotám předchází nula.
T	Zkratka AM / PM s jedním písmenem. AM se zobrazí jako A.
Tt	Zkratka AM / PM se dvěma písmeny. AM se zobrazuje jako AM.
Y	Jednociferný rok. 1997 se zobrazí jako 7.
Yy	Poslední dvě číslice roku. 1997 se zobrazí jako 97.
Yyyy	Celý rok. 1997 se zobrazuje jako 1997.
Interpunkce	Zahrnuto v displeji

Příklady

Příklad 1: Zobrazí se výzva, která vás upozorní na to, že dokončení následujících příkazů může trvat několik minut kvůli jejich složitosti.

DIALOG "Upozornění: Tento skript může trvat několik minut, než se dokončí" TITLETEXT = "Warning"

Příklad 2: Příkaz DIALOG se používá k získání data dodaného uživatelem pro výpočet věku pacienta. Pokud neuvedete datum (stiskněte tlačítko Storno), použije se místo toho výchozí datum ukončení obsažené ve zdroji dat průzkumu.

PŘEČTĚTE SI {. / Projects / Sample / Sample.prj}: Dohled DEFINE UpdateDate DATEFORMAT DEFINUJTE DATUMFORMÁT PODROBNOSTI ASSIGN SubmitDate = EventDate DIALOG "Zadejte nové datum ukončení pro data průzkumu:" Datum aktualizace DATEFORMÁT "MM-DD-RRRR" DEFINUJTE NewAge NUMERIC ASSIGN NewAge = ROKY (SubmitDate, UpdateDate) GRAPH NewAge GRAPHTYPE = "Sloupec"

Příklad 3: Zobrazí se rozevírací seznam možností. Seznam obsahuje část příkazu; v tomto případě několik okresů ve státě Georgia. Váš výběr je dočasně přiřazen ke všem záznamům ve formuláři.

PŘEČTĚTE SI {. / Projects / Sample / Sample.prj}: Dohled DEFINUJTE TEXTINPUT NewCounty DIALOG "Vyberte kraj" NewCounty "Fulton", "Baldwin", "DeKalb", "Cobb" ASSIGN CountyName = NewCounty LIST CountyName

Příklad 4: Zobrazí se rozevírací seznam možností. Každá položka seznamu je načtena ze sloupce X_COORD datové tabulky SohoDead.

PŘEČTĚTE SI {. / Projects / Sample / Sample.prj}: SohoDead DEFINE Souřadnice TEXTINPUT DIALOG Souřadnice „Vybrat souřadnice“DBVALUES SohoDead X_COORD TITLETEXT = "Souřadnice"

Příklad 5: Zobrazí se dialogové okno, které vám umožní zadat číslo. Vstupní maska se používá k vynucení vstupu na tři celé číslice a jednu desetinnou číslici. Váš vstup je dočasně přiřazen ke každému záznamu ve formuláři.

PŘEČTĚTE SI {. / Projects / Sample / Sample.prj}: Oswego DEFINUJTE NewAge NUMERIC DIALOG "Zadejte věk pacienta" NewAge "###. #" ASSIGN Věk = NewAge SEZNAM Věk

Příklad 6: Zobrazí se dialogové okno, které vám umožní zadat číslo. Vstupní maska se používá k vynucení vašeho vstupu na jednu nebo dvě celé číslice a na jedno desetinné místo. (9 představuje volitelnou číslici.) Váš vstup je dočasně přiřazen ke každému záznamu ve formuláři.

PŘEČTĚTE SI {. / Projects / Sample / Sample.prj}: Oswego DEFINUJTE NewAge NUMERIC DIALOG "Zadejte věk pacienta" NewAge "9 ##. #" ASSIGN Věk = NewAge SEZNAM Věk