
A sintaxe global utilizada na definição de Caixas de Diálogo é o seguinte:
DIALOG <xi>,<yi>,<xl>,<yl> [chars | units]
[caption <título>]
[style <dialog_style>]
[help <arqhelp>]
[font <fonte> [<tam>]
[start <numc>]
[verify <func>(<par1>, ... , <parn>)]
[init <func>(<par1>, ... , <parn>)]
[cancel <func>(<par1>, ... , <parn>)]]
CheckBox <nome> <varl> <xi>,<yi>,<xl>,<yl> [<comum>]
EditText NULL <varc> <xi>,<yi>,<xl>,<yl> [<comum>]
RichEdit NULL <arq> <xi>,<yi>,<xl>,<yl> [<comum>]
GroupBox <nome> <varl> <xi>,<yi>,<xl>,<yl> [<comum>]
RadioButton <nome> NULL <xi>,<yi>,<xl>,<yl> [<comum>]
DefPushButton <nome> | BITMAP ("<bitmap>") <varn> <xi>,<yi>,<xl>,<yl> [<comum>]
PushButton <nome> | BITMAP ("<bitmap>") NULL <xi>,<yi>,<xl>,<yl> [<comum>]
Ctext <texto> NULL <xi>,<yi>,<xl>,<yl> [font (<font>,<tam>)] [ID <expc>] [ENABLE | DISABLE]
Ltext <texto> NULL <xi>,<yi>,<xl>,<yl> [font (<font>,<tam>)] [ID <expc>] [ENABLE | DISABLE]
Rtext <texto> NULL <xi>,<yi>,<xl>,<yl> [font (<font>,<tam>)] [ID <expc>] [ENABLE | DISABLE]
VarText NULL <texto> <xi>,<yi>,<xl>,<yl> [<comum>]
ListBox <vetc> <varn> <xi>,<yi>,<xl>,<yl> [<estilo>] [<comum>]
ComboBox <vetc> <varc> <xi>,<yi>,<xl>,<yl> [<comum>]
Image NULL <varc> <xi>,<yi>,<xl>,<yl> [ID <expc>] [ENABLE | DISABLE]
Icon <icon> <num> <xi>,<yi>,0,0
Histogram <varn1> <varn2> <xi>,<yi>,<xl>,<yl> [<osbserv>]
Animation <expc> <var> <xi>,<yi>,<xl>,<yl> [<observ1>]
ProgressBar <varn1> <varn2> <xi>,<yi>,<xl>,<yl> [<observ1>]
MonthCalendar <expc> <var> <xi>,<yi>,<xl>,<yl> [<observ1>]
Grid NULL | <arq> <num> <xi>,<yi>,<xl>,<yl> [<observ1>]
Column <cab> <vet> | <item> <xi>,<yi>,<xl>,<yl>
EndDialog
Observações importantes
O parâmetro <comum> na sintaxe acima engloba as seguintes opções comuns a esse grupo de controles:
[IDOK | CANCEL]
[CONTEXTid(<num>)]
[Message <texto>] | [Message <vetor>]
[tip (<texto)]
[VALID <func> (<par1>, … ,<parn>)]
[WHEN <func> (<par1>, … ,<parn>)]
[PICTURE <cad>]
[Font(<cad>,<num>)]
[Select <func> (<par1>, … ,<parn>)]
[DBLCLK <func> (<par1>, … ,<parn>)]
DISABLE | ENABLE
ID(<iden>
String(<iden>)
O parâmetro <observ1> na sintaxe acima indica que deverão ser consultados os detalhes específicos desse controle, que apresentaremos mais adiante.
As opções Message, Select e DblClk se aplicam apenas aos controles ListBox e ComboBox.
A opção String se aplica apenas ao controle EditText.
É importante observar que ao utilizarmos objetos do tipo BITMAP ou ICON, é criado, de forma automática, o arquivo de recursos correspondente, com o sufixo .RC. Este arquivo, que é único para cada programa e suas rotinas, será compilado pelo resource compiler (RC.EXE) e "ligado" com o programa principal. Desta forma, quando houver necessidade de definir BitMap ou ICONs em subrotinas, compiladas separadamente, é necessário utilizar a opção de controle $RC, no inicio do programa principal e de todas as subrotinas que utilizam BitMap e ICONs, conforme o seguinte exemplo, onde temos o programa Prog1.f e a subrotina Rot1.f:
$Library Bibxyz
$RC=prog1.RC
Prog
...
Do Rot1
$Library Bibxyz
$RC=prog1.RC
Proc
...
SetWindow Icon("World.ico")
