List Box

DCL - Dialog Control Language: Introdução 2009@FEUP/DEMec-SDI
DCL – Dialog Control Language:

Introdução
João Manuel R. S. Tavares
Bibliografia
 Material disponível no AfraLisp.net em http://www.afralisp.net
 Programação em AutoCAD, Curso Completo
Fernando Luís Ferreira, João Santos
FCA
 Sistema de ajuda do AutoCAD
2 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares
João Manuel R. S. Tavares 1

Introdução
 A Dialog Control Language permite criar interfaces gráficas (caixas de
diálogo e de mensagens) para aplicações em AutoLISP/Visual Lisp
 Cada caixa de diálogo deve ser definida (dialog definition) em ficheiros
de definição com a extensão dcl
 Cada controlo de um diálogo necessita ser definido (tile definition) e é
referenciado no código lisp pelo seu nome (key)
 Cada propriedade (property) de um controlo (tile) é designada por
atributo do diálogo (attribute)
 Cada método de um controlo é designado por expressão de acção
(action expression)
 O Visual Lisp Editor possibilita a previsão de um diálogo definido num
ficheiro dcl (em Tools, Interface Tools)
Introdução (cont.)
 No ficheiro base.dcl do AutoCAD existem definições e estruturas úteis que
podem ser usadas (para usar, incluir @include "base.dcl" no ficheiro
respectivo)
 Na definição dos diálogos (ficheiros dcl):
 São usados { } em vez de ( )
 Para definir propriedades usa-se o sinal =
 As linhas de atributos terminam com ;
 Comentários são indicados com // ou /* */
 As definições são iniciadas com :
 Criação
C i ã dde um diál
diálogo:
 Sintaxe: nome : dialog { conteúdo }

 Exemplo (ficheiro hello.dcl):
hello : dialog { // é dado o nome "hello" à
// caixa de diálogo
label = "Primeira Caixa de Diálogo"; // título a aparecer na caixa
: text { // início de zona de texto
label = "Hello, world"; // texto a aparecer
} // fim da zona de texto
: button { // é criado um botão OK para terminar
key = "terminado"; // o valor da tecla
label = "OK"; // o nome da tecla
is_default = true; // declara que este é o botão por omissão
} // fim do botão "ok"
}
 Exemplo (ficheiro hello.lsp):
(Defun c:hello ()
(setq dcl_id (load_dialog "hello.dcl")) ; o file é carregado

(if (not (new_dialog "hello" dcl_id)) ; verifica se existe o ficheiro
(exit) ; se não existe saí
)
(start_dialog)
d l ; é mostrada
d a caixa de
d
dialogo
(unload_dialog dcl_id) ; retira a recém-criada caixa
)

 Definição de um controlo (tile):
 nome : item1 [ : item2 : item3 …]
{ atributo = valor ; … }
 Referência a um controlo predefinido:
 : nome {
atributo = valor ;
…
}
 Exemplo (ficheiro hello1.dcl):
hello : dialog { // é dado o nome "hello" à
// caixa de diálogo
label = "Primeira Caixa de Diálogo"; // título a aparecer na caixa
: text { // início de zona de texto
label = "Hello, world"; // texto a aparecer
} // fim da zona de texto
ok_only; // botão "ok" predefinido
}

 Exemplo (ok_cancel.dcl)
ex_cancel : dialog { // é dado o nome "ex_cancel" à
// caixa
i dde diál
diálogo
label = "Exemplo Ok_Cancel"; // título a aparecer na caixa
spacer_0; // espaçamento
ok_cancel; // botões "ok" e "cancel"
// predefinidos
}
 Exemplo (ficheiro hello1.lsp):
(Defun c:hello ()
(setq dcl_id (load_dialog "hello1.dcl")) ; o ficheiro é carregado
(if (not (new_dialog "hello" dcl_id)) ; verifica se existe o ficheiro
(exit) ; se não existe saí
)
(start_dialog) ; é mostrada a caixa de diálogo

(unload_dialog dcl_id) ; retira a recém-criada caixa
)

Controlos Predefinidos
 Exit Buttons e Error Tiles  Decorative e Informative Tiles
 ok_only
 image
 ok_cancel
 text
 ok_cancel_help
ok cancel help
 ok_cancel_help_errtile  spacer
 ok_cancel_help_info  spacer_0
 errtile  spacer_1
 Predefined Active Tiles  Text Clusters
 button
 ncatenation
 edit_box
 list_box  paragraph
 popup_list  text_part
 radio_button
 toggle
 slider
 image_button
Controlos Predefinidos (cont.)

 Tile Clusters
 boxed_column
 boxed_radio_column
 boxed_radio_row
 boxed_row
 column
 dialog
 radio_column
 radio_row
 row

Atributos de Controlos
 Globais
 alignment
 fixed_height
 fixed_width
fi d id h
 height
 width
 Aplicam-se a: All Tiles
 Action Tiles
 action
 is_enabled
 is_tab_stop
 key
 mnemonic
 Aplicam-se a: button; edit_box; image_button; list_box; popup_list;
radio_button; slider; toggle; radio_column; radio_row
Atributos de Controlos (cont.)

 Tile Clusters
 children_alignment
 children_fixed_height
_ _ g
 children_fixed_width
 Aplicam-se a: row; column; radio_row; radio_column; boxed_row;
boxed_column; boxed_radio_row; boxed_radio_column
 Specific Tiles
 allow_accept
 Aplicam-se a: edit_box; image_button; list_box
 aspect_ration
 Aplicam-se a: image; image_button
 big_increment
 Aplicam-se a: slider


 Specific Tiles (cont.)
 color
 Aplicam-se a: image; image_button
 edit_limit
 Aplicam-se a: edit_box
 edit_width
 Aplicam-se a: edit_box; popup_list
 fixed_width_font
 Aplicam-se a: edit_box; popup_list
 initial_focus
initial focus
 Aplicam-se a: dialog
 is_cancel
 Aplicam-se a: button

 is_default
 Aplicam-se a: button
 label
 Aplicam-se a: boxed_row; boxed_column; boxed_radio_row;
boxed_radio_column; button; dialog; edit_box; list_box; popup_list;
radio_button; text; toggle
 layout
 list
 Aplicam-se
A li a: list_box;
li t b popup_list
li t
 max_value
 min_value


 multiple_select
 Aplicam-se a: list_box
 password_char
 Aplicam-se a: edit_box
 small_increment
 tabs
 Aplicam-se a: list_box; popup_list
 tab_truncate
tab truncate
 Aplicam-se a: list_box; popup_list
 value
 Aplicam-se a: text; todos active tiles (excepto buttons e image_buttons)
Funções AutoLISP para diálogos DCL

 (load_dialog ficheiro.dcl) ; carrega file
 (new_dialog nome dcl_id acção ecrã) ; carrega diálogo
 ((start_dialog)
_ g) ; mostra diálogo
g
 (done_dialog saida) ; fecha diálogo e retorna saída
 (term_dialog) ; fecha todos diálogos abertos
 (unload_dialog dcl_id) ; descarrega diálogo
 (action_tile key expressão) ; estabelece acção para tile key
 (get_attr key atributo) ; obter valor do tile key (string)
 ( t til key)
(get_tile k ) ; obter
bt valorl ddo tile
til key
k (string)
(ti )
 (set_tile key valor) ; atribuir valor para o tile key (string)
 (mode_tile key modo) ; define modo (0 - activa, 1 - desactiva, 2 -
destaca, 3 - selecciona conteúdo, 4 - muda destaque de uma imagem)

Funções AutoLISP para diálogos DCL (cont.)

 (start_list key operação indice) ; inicia lista
 (add_list string) ; adiciona string numa lista
 ( d li t)
(end_list) ; termina
t i lilista t
 (start_image key) ; inicia criação de imagem
 (dimx_tile key) ; dimensão de imagem em x
 (dimy_tile key) ; dimensão de imagem em y
 (vector_image xini yini xfim yfim cor) ; desenha vector
 (fill_image xini yini larg alt cor) ; desenha rectângulo
 (slide_image xini yini larg alt nomeslide) ; inserir slide
 (end_image) ; termina criação de imagem




Exemplo: file TEST_DCL1.DCL

//DCL CODING STARTS HERE
test_dcl1
: dialog
{
label = "Test
Test Dialog No 11";;
: text // controlo de texto
{
label = "This is a Test Message";
alignment = centered;
}
: button // definição de um botão
{
key = "accept"; // nome do botão
label = "Close"; // etiqueta
q do botão
is_default = true; // controlo por defeito
fixed_width = true;
alignment = centered; // alinhamento
}
}
//DCL CODING ENDS HERE
Exemplo: file TEST_DCL1.LSP

; AUTOLISP CODING STARTS HERE
(prompt "\nType TEST_DCL1 to run.....") ; indicação no prompt do autocad após load do programa
(defun C:TEST_DCL1 ()
(setq dcl
dcl_id
id (load
(load_dialog
dialog "test
test_dcl1.dcl
dcl1 dcl"))
)) ; load do ficheiro de definição
(if (not (new_dialog "test_dcl1" dcl_id)) ; carregamento do diálogo em memoria
(exit)
) ; if
(action_tile "accept" "(done_dialog)") ; action_tile – quando carrega no botão, fecha o diálogo
(start_dialog) ; mostrar diálogo
(unload_dialog dcl_id) ; descarregar o diálogo da memoria
(princ)
) ; defun
(princ)
; AUTOLISP CODING ENDS HERE

Exemplo: Notas
 Cada linha de atributo no ficheiro de definição do diálogo
termina com ;
 Comentários indicados com //
 Sensível a maiúsculas e a minúsculas
 Sequência de utilização:
 Load do ficheiro do diálogo
 Load da definição do diálogo
 Executar instrução(ões)
ç ( ) action_tile
 Iniciar o diálogo
 Descarregar o diálogo da memória

//DCL CODING STARTS HERE alignment = centered;
test_dcl2 edit_limit = 3; // input max. 3 chars
: dialog edit_width = 3; // largura max. 3 chars
{ value = ""; // valor inicial
label = "Test Dialog No 2"; }
: edit_box : button
{ {
label = "Enter Your Name :"; key = "accept";
mnemonic = "N"; // char sublinhado label = "OK";
key = "name"; is_default = true;
alignment = centered; fixed_width = true;
edit_limit = 30; // max. 30 chars alignment = centered;
edit width = 30; // larg.
edit_width larg max.
max 30 chars }
} : errtile // para mensagem de erro
: edit_box {
{ width = 34;
label = "Enter Your Age :"; }
mnemonic = "A"; }
key = "age"; //DCL CODING ENDS HERE


(prompt "\nType TEST_DCL2 to run.....")
(defun C:TEST_DCL2 (/ dcl_id)
(setqq dcl_id (load_dialogg "test_dcl2.dcl"))
(if (not (new_dialog "test_dcl2" dcl_id))
(exit)
) ; if
(set_tile "name" "Enter Name Here") ; define conteúdo em run-time
(mode_tile "name" 2) ; permite override
(action_tile "name" "(setq name $value)") ; após selecção atribui valor à variável name
(action_tile "age" "(setq age $value)") ; após selecção atribui valor à variável age
(action_tile "accept" "(val1)") ; após selecção chama subprograma
(
(start_dialog)
d l ) ; mostra ddiálogo
ál
(unload_dialog dcl_id)
(alert (strcat "Your name is " name ; message box
"\nand you are " age
" years of age."
)
)
Exemplo: file TEST_DCL2.LSP (cont.)

(princ)
) ; defun
;-----------------------
(defun val1 ()
(if (= (get_tile "name") "Enter Name Here") ; receber valor no controlo
(progn
(set_tile "error" "You must enter a name!") ; por valor no controlo
(mode_tile "name" 2)
) ; progn
(val2) ; chama subprograma
) ; if
) ; defun
;-------------------
(defun val2 ()
(if (< (atoi (get_tile "age")) 1) ; receber valor no controlo
(progn
(set_tile "error" "Invalid Age - Please Try Again!!") ; por valor no controlo
(mode_tile "age" 2)
)


; progn
(done_dialog) ; fecha diálogo
) ; if
) ; defun
(princ)
;AUTOLISP CODING ENDS HERE

afra : dialog { }
label = "A" ; }
: column { : row {
: row { : button {
: button { label = "Save";
label = "OK"; key = "save";
key = "accept"; mnemonic = "S";
mnemonic = "O"; alignment = centered;
alignment = centered; width = 12;
width = 12; }
is_default = true; // tem de existir um : button {
// default label = "Load";
} key = "load";
load ;
: button { mnemonic = "L";
label = "Cancel"; alignment = centered;
key = "cancel"; width = 12;
mnemonic = "C"; }
alignment = centered; }
width = 12;

Exemplo: file TEST_DCL3.DCL (cont.)

: row {
: button {
label = "Help...";
key = "help";
mnemonic = "H";
width = 12;
}
: button {
label = "About...";
key = "About";
mnemonic = "H";
width = 12;
}
}
}
}

(prompt "\nType TEST_DCL3 to run.....")
(defun C:TEST_DCL3 (/ dcl_id)
(setqq
dcl_id (load_dialog
" TEST_DCL3.DCL"
)
)
(if (not (new_dialog "afra" dcl_id))
(exit)
) ; if
(start_dialog) ; sai do diálogo quando seleccionar o botão OK
( l d d l ddcl_id)
(unload_dialog l d)
(princ)
) ; defun


samp : dialog { //dialog name
label = "Structural Holes" ; //give it a label
: row { //define row
: boxed_radio_column { //define radio column
label = "Type" ; //give it a label
: radio_button { //define radion button
key = "rb1" ; //give it a name
label = "Bolt Holes &Site" ; //give it a label
value = "1" ; //switch it on
} //end definition
: radio_button { //define radio button
l b l = "B
label "Bolt
l Holes
H l Sho&p"
Sh "; //
//give it a llabel
b l
} //end definition
label = "Bolt Holes &Hidden" ; //give it a label
} //end definition

label = "Bolt Holes &Ctsnk" ; //give it a label
} //end definition
label = "Bolt Holes &Elevation" ; //give it a label
} //end definition
: radio_button { //define radion button
label = "Bolt Holes &Slotted" ; //give it a label
} //end definition
} // d radio
//end d column
l
: boxed_column { //define boxed column
label = "&Size"; //give it a label
: popup_list { //define popup list
key = "selections"; //give it a name
value = "5”; //initial value
}


} //end boxed column
} //end row
: edit_box { //define edit box
keyy = "eb1" ; //give
g it a name
label = "Slot &Length (O/All Slot)" ; //give it a label
edit_width = 6 ; //6 characters only
} //end edit box
: slider { //defin slider
key = "myslider" ; //give it a name
max_value = 100; //upper value
min_value = 0; //lower value
value = "50"; //initial value
} // d slider
//end ld
: boxed_row { //*define boxed row
: toggle { //*define toggle
key = "tog1"; //*give it a name
label = "Ortho On/Off"; //*give it a label
}

: toggle { //*define toggle
key = "tog2"; //*give it a name
label = "Snap On/Off"; //*give it a label
} //*end definition
} //*end boxed row
ok_cancel ; //predifined OK/Cancel
: row { //define row
: image { //define image tile
key = "im" ; //give it a name
height = 1.0 ; //and a height
width = 1.0 ; //and now a width
} //end image
: paragraphh { //d f paragraphh
//define
: text_part { //define text
label = "Designed and Created"; //give it some text
} //end text
: text_part { //define more text
label = "by Kenny Ramage"; //some more text
} //end text


} //end paragraph
} //end row
} //end dialog

(defun C:samp () ; define function
(setq lngth 50.0) ; preset slot length
(setq hole "site") ; preset hole type
(setqq siz "M20") ; ppreset hole size
(setq NAMES '("M6" "M8" "M10" "M12" "M16" "M20" "M24" "M30“) ; define list
)
(setq ; setq
dcl_id (load_dialog
" TEST_DCL4.DCL"
)
) ; load dialog
(if (not (new_dialog "samp" dcl_id) ; test for dialog
) ; not
(exit) ; exit if no dialog
) ; if
(setq w (dimx_tile "im") ; get image tile width
h (dimy_tile "im") ; get image tile height
) ; setq


(start_image "im") ; start the image
(fill_image 0 0 w h 5) ; fill it with blue
(end_image) ; end image
(start_list "selections") ; start the list box
(mapcar 'add_list NAMES) ; fill the list box
(end_list) ; end list
(set_tile "eb1" "50") ; put dat into edit box
(mode_tile "eb1" 1) ; disable edit box
(mode_tile "myslider" 1) ; disable slider
(setq orth (itoa (getvar "orthomode"))) ; *get orthomode value
(set_tile "tog1" orth) ; *switch toggle on or off
(setq sna (itoa (getvar "snapmode"))) ; *get snap value
(
(set_tile
l ""tog2"
2" sna)) ; *switch
* h toggle
l on or off
ff
(action_tile
"myslider" ; if user moves slider
"(slider_action $value $reason)"
) ; pass arguments to slider_action

(action_tile
"eb1" ; is user enters slot length
"(ebox_action $value $reason)"
) ; ppass arguments
g to ebox_action
(defun slider_action (val why) ; define function
(if (or (= why 2) (= why 1)) ; check values
(set_tile "eb1" val)
)
) ; update edit box
(defun ebox_action (val why) ; define function
(if (or (= why 2) (= why 1)) ; check values
(set_tile "myslider" val)
)
) ; update slider
(action_tile "tog1" "(setq orth $value)") ; *get ortho toggle value
(action_tile "tog2" "(setq sna $value)") ; *get snap toggle value
(action_tile "rb1" "(setq hole \"site\")") ; store hole type
(action_tile "rb2" "(setq hole \"shop\")") ; store hole type


(action_tile "rb3" "(setq hole \"hid\")") ; store hole type
(action_tile "rb4" "(setq hole \"ctsk\")") ; store hole type
(action_tile "rb5" "(setq hole \"elev\")") ; store hole type
(action_tile
"rb6"
"(setq hole \"slot\") ; store hole type
(mode_tile \"eb1\" 0) ; enable edit box
(mode_tile \"myslider\" 0) ; enable slider
(mode_tile \"eb1\" 2)"
) ; switch focus to edit box
(action_tile
"cancel" ; if cancel button pressed
"(d
"(done_dialog)
d l ) ((setq userclick
l k nil)"
l)" ; close
l ddialog,
l set flflag
) ; action_tile
(action_tile
"accept" ; if O.K. pressed
(strcat ; string 'em together
"(progn

(setq SIZ (atof (get_tile \"selections\")))" ; get list selection
"(setq lngth (atof (get_tile \"eb1\")))" ; get slot length
"(setvar \"orthomode\" (atoi orth))" ; *ortho on/off
"(setvar \"snapmode\"
p (atoi sna))" ; *snapp on/off
" (done_dialog)(setq userclick T))" ; close dialog, set flag
) ; strcat
) ; action tile
(start_dialog) ; start dialog
(unload_dialog dcl_id) ; unload
(if userclick ; check O.K. was selected
(progn
(setq SIZ (fix SIZ)) ; convert to integer
(
(setq SIZ ((nthh SIZ NAMES)) ; get the
h size
) ; progn
) ; if userclick
(princ)
) ; defun C:samp
(princ)

List Box

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

List Box

Caricato da

Copyright:

Formati disponibili

DCL - Dialog Control Language: Introdução 2009@FEUP/DEMec-SDI

DCL – Dialog Control Language:

2 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 1

3 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

4 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 2

(setq dcl_id (load_dialog "hello.dcl")) ; o file é carregado

6 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 3

7 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

8 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 4

9 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

(start_dialog) ; é mostrada a caixa de diálogo

10 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 5

11 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

Controlos Predefinidos (cont.)

12 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 6

Atributos de Controlos (cont.)

14 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 7

Atributos de Controlos (cont.)

15 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

Atributos de Controlos (cont.)

16 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 8

Atributos de Controlos (cont.)

17 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

Funções AutoLISP para diálogos DCL

18 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 9

Funções AutoLISP para diálogos DCL (cont.)

19 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

Funções AutoLISP para diálogos DCL (cont.)

20 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 10

Funções AutoLISP para diálogos DCL (cont.)

21 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

Funções AutoLISP para diálogos DCL (cont.)

22 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 11

Funções AutoLISP para diálogos DCL (cont.)

23 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

Funções AutoLISP para diálogos DCL (cont.)

24 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 12

Funções AutoLISP para diálogos DCL (cont.)

25 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

Funções AutoLISP para diálogos DCL (cont.)

26 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 13

Exemplo: file TEST_DCL1.DCL

27 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

Exemplo: file TEST_DCL1.LSP

28 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

João Manuel R. S. Tavares 14

29 CFAC: DCL - Dialog Control Language: Introdução 2009@João Tavares

Exemplo: file TEST_DCL2.DCL

João Manuel R. S. Tavares 15

Exemplo: file TEST_DCL2.LSP