Programovací přehled DCL (Dialog Control Language)

---

DCL je akronym pro Dialog Control Language, samostatný programovací jazyk, který můžete používat společně s 4MCAD pro vytváření vlasních dialogových oken. Při vytváření dialogových oken pomocí DCL, pracujete s elementy zvané dlaždice, dlaždice klastru (nebo klastry) a atributy. Následující sekce popisují každý typ elementu a  základní syntax používaný k jeho vyjádření.

Dlaždice

Dlaždice je element dialogového okna, jako například tlačítko, textové pole, seznam, obrázek nebo text. Dlaždice jsou běžně vyjádřeny pomocí následujícího syntaxu:

: toggle { }

Všimněte si předpony dvojtečky, za kterým následuje mezera. To znamená, že definujete (dočasně) atributy dlaždice. Název dlaždice zobrazený bez předpony dvojtečky naznačuje, že již byl definován jinde (dříve v souboru DCL nebo v jiném souboru DCL). Stojany obsahují atributy dlaždice (pokud existují), charakteristiky jako barva, související akce nebo štítek.

Dlaždice jsou také třízeny podle podle funkce:

- Aktivní dlaždice (např.: : button { ... }, : toggle { ... }) (zaškrtávací políčko) a: list_box {...}) definují ovládací prvky dialogového okna, které přijímají uživatelské vstupy a / nebo provádějí příkazy a akce.
- Dlaždice textu (např.: : text { ...} a : text_part { ... }) obsluhují řetězce dialogového okna.
- Dlaždice obsluhy chyb (Error handler tiles) (např.: errtile; a ok_cancel_help;) se stará o zobrazování chybových oznámení pro uživatele a standardních potvrzovacích tlačítek, jako např.: OK, Zrušit, Help
. Dlaždice dekoru (Decorator tiles) (např., : image { ... } and : spacer { ... }) zpracovává grafické prvky a mezery v dialogovém okně.

POZNÁMKA

Neexistují žádné dlaždice pro vytváření dialogových oken s kartami.
Soubor DCL nesmí používat následující dlaždice: cluster, tiles, cancel_button, help_button, info_button, and ok_button.

Dlaždice klastr

Klastr je skupina dlaždic, například skupina souvisejících přepínačů (také nazývaných tlačítka volby) nebo skupina zaškrtávacích políček (nazývaných také přepínače). Klastry jsou obvykle (ale ne vždy) obklopeny obdélníkovým obrysem. Jednotlivé prvky dlaždic uvnitř klastru se nazývají klastry vnořené

Klastry jsou formou dlaždice a obvykle mají následující syntaxi:

: boxed_column { }

Opět si všimněte předpony dvojtečky, za kterým následuje mezera. Zábrany obsahují atributy a dlaždice klastru. Rádiové tlačítka mají vlastní klastry, protože definice musí obsahovat nejméně dva přepínače v klastru.

Atributy

V DCL termín atribut označuje charakteristiku dlaždice, například barvu, akci, kterou provádí, jeho označení a tak dále. Program DCL obsahuje několik předdefinovaných Předdefinovaných Atributů (IDR_2) (např. color, multiple_select, and typeface).

Dlaždice může mít mnoho atributů nebo naopak vůbec žádný. Pokud dlaždice nemá žádné atributy, počítá s výchozími hodnotami atributu.

Typický atribut má následující syntaxi:

label = "Pick a viewpoint: ";

Všimněte si středníkového terminátoru. Ne všechny atributy platí pro všechny dlaždice. Ve skutečnosti některé atributy mění svůj význam v závislosti na dlaždici, s jakou jsou používány.

Dlaždice a Jedinečné atributy implementace DCL společnosti 4MCAD

Program DCL má jednu jedinečnou dlaždici a několik atributů, které se nenacházejí v jiných implementacích DCL. Následující tabulka popisuje jedinečnou dlaždici pro implementaci DCL 4MCADu:

Tile	Meaning
: multi_edit_box { }	Creates a multi-line edit box.

Následující tabulka shrnuje atributy, které jsou jedinečné pro implementaci DCL 4MCADu:

Attribute	Meaning
lower_only = flag;	Read all input text as lower case.
pointsize = int;	Point size of text displayed by the dialog box.
read_only - flag;	Text in edit box is non-editable.
typeface = "string";	TrueType typeface displayed by the dialog box.
upper_only = flag;	Read all input text as upper case.

Formát souboru DCL

DCL soubor je ve formátu ASCII, tudiž můžete k psaní nebo editování DCL souborů použít jakýkoliv textový editor (jako např. Microsoft® NotePad nebo Microsoft® Word).

Syntax pro Komentáře v DCL kódu

Komentář k řádku je předznačen //, a to následujícím způsobem:
// A comment line.
Chcete-li do kódu DCL vložit komentáře, použijte / * a * / následovně:
plotdlg : dialog { /* The Plot dialog box*/

Definování odkazů na dlaždice v kódu DCL

Soubor DCL může odkazovat na definice dlaždice v jiném souboru DCL pomocí direktivy include:
@include filename