Comandos Do GeneXus

Sumrio
1.
Comandos GeneXus ................................................................................................................................... 7

1.1. Assign Atributo .................................................................................................................................. 7
1.2. Assign Varivel .................................................................................................................................. 7
1.3. Call ..................................................................................................................................................... 8
1.4. Change Page ....................................................................................................................................... 8
1.5. Commit ............................................................................................................................................... 8
1.6. Confirm .............................................................................................................................................. 9
1.7. Delete.................................................................................................................................................. 9
1.8. Do Nome Subrotina ....................................................................................................................... 10
1.9. Do While .......................................................................................................................................... 10
1.10.
Eject .............................................................................................................................................. 10
1.11.
Error_Handler ............................................................................................................................... 10
1.12.
Exit ............................................................................................................................................... 11
1.13.
Footer............................................................................................................................................ 11
1.14.
For Each ....................................................................................................................................... 11
CLUSULA ORDER .............................................................................................................................. 12
CLUSULA WHERE.............................................................................................................................. 12
CLUSULA DEFINED BY .................................................................................................................... 13
1.15.
For Each Line ............................................................................................................................... 13
1.16.
For Each Selected line .................................................................................................................. 13
1.17.
Graph ............................................................................................................................................ 13
1.18.
Header .......................................................................................................................................... 14
1.19.
If ................................................................................................................................................... 15
1.20.
Line Number................................................................................................................................. 15
1.21.
Load .............................................................................................................................................. 15
1.22.
Margin Botton .............................................................................................................................. 15
1.23.
Margin Top ................................................................................................................................... 16
1.24.
Message ........................................................................................................................................ 16
1.25.
New Record .................................................................................................................................. 16
1.26.
NoSkip .......................................................................................................................................... 17
1.27.
Page Length .................................................................................................................................. 17
1.28.
Print If Detail ................................................................................................................................ 17
1.29.
PrinterCommand........................................................................................................................... 17
1.30.
Refresh.......................................................................................................................................... 18
1.31.
Return ........................................................................................................................................... 18
1.32.
RollBack ....................................................................................................................................... 18
1.33.
Submit .......................................................................................................................................... 18
1.34.
Subroutine .................................................................................................................................... 19
1.35.
Xfor Each ..................................................................................................................................... 19
1.36.
Xfor First ...................................................................................................................................... 19
1.37.
Xnew ............................................................................................................................................ 19
2. Regras dos Objetos GeneXus ................................................................................................................... 20
2.1. ACCEPT ........................................................................................................................................... 20
2.2. ADD ................................................................................................................................................. 21
2.3. ALLOWNULLS ............................................................................................................................... 21
2.4. <ASSIGN> ....................................................................................................................................... 21
2.5. CALL................................................................................................................................................ 21
2.6. COLOR ............................................................................................................................................ 22
2.7. DEFAULT ........................................................................................................................................ 22
2.8. DEFAULT MODE ........................................................................................................................... 23
2.9. EQUAL ............................................................................................................................................ 23
2.10.
ERROR ......................................................................................................................................... 23
2.11.
ERROR_HANDLER .................................................................................................................... 24
2.12. .............................................................................................................................................................. 24
2.13.
HIDDEN ....................................................................................................................................... 24
2.14.
MSG ............................................................................................................................................. 25
2.15.
NOACCEPT ................................................................................................................................. 25
2.16.
NOCHECK ................................................................................................................................... 25
2.17.
NOCONFIRM .............................................................................................................................. 25
2.18.
NOREAD ..................................................................................................................................... 26
2.19.
NOPROMPT ................................................................................................................................ 26
2.20.
ORDER ........................................................................................................................................ 26
2.21.
PARM ........................................................................................................................................... 26
2.22.
PRINTER ..................................................................................................................................... 27
2.23.
PROMPT ...................................................................................................................................... 27
2.24.
REFCALL .................................................................................................................................... 27
2.25.
REFMSG ...................................................................................................................................... 27
2.26.
SEARCH ...................................................................................................................................... 28
2.27.
SERIAL ........................................................................................................................................ 28
2.28.
SUBMIT ....................................................................................................................................... 28
2.29.
SUBTRACT ................................................................................................................................. 28
2.30.
WORKFILE_LINES .................................................................................................................... 29
2.31.
XORDER...................................................................................................................................... 29
3. Funes Disponveis no GeneXus ............................................................................................................ 30
3.1. DAY ................................................................................................................................................. 30
3.2. MONTH ........................................................................................................................................... 30
3.3. YEAR ............................................................................................................................................... 31
3.4. TODAY ............................................................................................................................................ 31
3.5. NOW( ) ............................................................................................................................................. 31
3.6. HOUR, MINUTE, SECONDS ......................................................................................................... 31
3.7. DOW ................................................................................................................................................ 32
3.8. CDOW .............................................................................................................................................. 32
3.9. CMONTH ......................................................................................................................................... 32
3.10.
CTOD ........................................................................................................................................... 32
3.11.
CTOT............................................................................................................................................ 33
3.12.
DTOC ........................................................................................................................................... 34
3.13.
TTOC............................................................................................................................................ 34
3.14.
YMDTOD .................................................................................................................................... 35
3.15.
YmdHmstoT ................................................................................................................................. 35
3.16.
ADDMTH .................................................................................................................................... 35
3.17.
ADDYR ........................................................................................................................................ 36
3.18.
AGE .............................................................................................................................................. 36
3.19.
EOM ............................................................................................................................................. 36
3.20.
TDIFF ........................................................................................................................................... 36
3.21.
TADD ........................................................................................................................................... 37
3.22.
ASK .............................................................................................................................................. 37
3.23.
UDF .............................................................................................................................................. 37
3.24.
UDP .............................................................................................................................................. 37
3.25.
ROWS .......................................................................................................................................... 38
3.26.
COLS ............................................................................................................................................ 38
3.27.
TIME ............................................................................................................................................ 38
3.28.
SYSTIME ..................................................................................................................................... 39
3.29.
SYSDATE .................................................................................................................................... 39
3.30.
USERCLS .................................................................................................................................... 39
3.31.
USERID........................................................................................................................................ 39
3.32.
WRKST ........................................................................................................................................ 39
3.33.
STR ............................................................................................................................................... 40
3.34.
SUBSTR ....................................................................................................................................... 40
3.35.
CONCAT ...................................................................................................................................... 40
3.36.
SPACE.......................................................................................................................................... 41
3.37.
LEN .............................................................................................................................................. 41
3.38.
TRIM ............................................................................................................................................ 41
3.39.
LTRIM.......................................................................................................................................... 41
3.40.
RTRIM ......................................................................................................................................... 42
3.41.
UPPER.......................................................................................................................................... 42
3.42.
LOWER ........................................................................................................................................ 42
3.43.
INT ............................................................................................................................................... 42
3.44.
ROUND ........................................................................................................................................ 43
3.45.
TRUNC ........................................................................................................................................ 43
3.46.
VAL .............................................................................................................................................. 43
3.47.
COLOR ........................................................................................................................................ 43
3.48.
RGB .............................................................................................................................................. 43
3.49.
NULL ........................................................................................................................................... 44
3.50.
NULLVALUE .............................................................................................................................. 44
3.51.
LOADBITMAP ............................................................................................................................ 44
3.52.
OLD .............................................................................................................................................. 45
3.53.
PREVIOUS .................................................................................................................................. 45
3.54.
AFTER ......................................................................................................................................... 45
3.55.
LEVEL ......................................................................................................................................... 46
3.56.
INSERT/UPDATE/DELETE ....................................................................................................... 46
4. Operadores Disponveis no GeneXus ....................................................................................................... 47
5. Variveis Internas do GeneXus ................................................................................................................ 48
5.1. TODAY ............................................................................................................................................ 48
5.2. TIME ................................................................................................................................................ 48
5.3. PAGE................................................................................................................................................ 48
5.4. LINE ................................................................................................................................................. 48
5.5. OUTPUT .......................................................................................................................................... 48
5.6. PGMDESC ....................................................................................................................................... 49
5.7. PGMNAME ...................................................................................................................................... 49
5.8. MODE .............................................................................................................................................. 49
6. Propriedades do GeneXus ........................................................................................................................ 50
6.1. VISIBLE ........................................................................................................................................... 50
6.2. TOLLTIP .......................................................................................................................................... 50
6.3. CAPTION ......................................................................................................................................... 51
6.4. ENABLE .......................................................................................................................................... 51
6.5. ACTIVEPAGE ................................................................................................................................. 51
6.6. PAGECOUNT .................................................................................................................................. 52
6.7. BACKCOLOR, FORECOLOR ........................................................................................................ 52
6.8. TOP, LEFT ....................................................................................................................................... 52
6.9. FILLSTYLE ..................................................................................................................................... 53
6.10.
FILLCOLOR ................................................................................................................................ 53
6.11.
DEFAULT .................................................................................................................................... 53
6.12.
BITMAP ....................................................................................................................................... 54
6.13.
BACKSTYLE............................................................................................................................... 54
6.14.
FONTNAME ................................................................................................................................ 54
6.15.
FONTITALIC, FONTUNDERLINE, FONTBOLD, FONTSTRIKETHRU ............................... 55
6.16.
FONTSIZE ................................................................................................................................... 55
6.17.
WIDTH, HEIGHT ........................................................................................................................ 55
6.18.
TITLE ........................................................................................................................................... 56
6.19.
WINDOWSTATE ........................................................................................................................ 56
6.20.
LINESELECTOR ......................................................................................................................... 56
6.21.
REDRAW ..................................................................................................................................... 57
6.22.
TITLEFORECOLOR, TITLEBACKCOLOR .............................................................................. 57
6.23.
TAG .............................................................................................................................................. 57
6.24.
BORDERSTYLE ......................................................................................................................... 58
7.
Eventos de Controle ................................................................................................................................. 58

7.1. DBCLICK ........................................................................................................................................ 58
7.2. CLICK .............................................................................................................................................. 58
7.3. ISVALID .......................................................................................................................................... 59
7.4. RIGHTBUTTON .............................................................................................................................. 59
8. Mtodos .................................................................................................................................................... 60
8.1. SETFOCUS ...................................................................................................................................... 60
8.2. REPAINT ......................................................................................................................................... 60
8.3. CLEAR, ADDITEM ......................................................................................................................... 60
8.4. REMOVEITEM ............................................................................................................................... 61
8.5. LOAD ............................................................................................................................................... 61
8.6. SORT ................................................................................................................................................ 62
8.7. PRINTFORM ................................................................................................................................... 62
8.8. REFRESH ........................................................................................................................................ 62
9. Propriedades do Modelo Principal ........................................................................................................... 63
9.1. PREFERNCIAS ............................................................................................................................. 63
MAXIMUN NUMERIC LENGHT .......................................................................................................... 63
FUNCTIONS............................................................................................................................................ 64
TIME FORMAT....................................................................................................................................... 64
9.2. GERADORES .................................................................................................................................. 65
9.3. MODEL FORMS ............................................................................................................................. 65
9.4. PROMPTS ........................................................................................................................................ 66
10.
Propriedades das Transaes ................................................................................................................ 67
10.1.
TRANSACTION INTEGRITY INTEGRIDADE TRANSACIONAL .................................. 67
COMMIT ON EXIT ................................................................................................................................. 67
CONFIRM TRANSACTION ................................................................................................................... 68
10.2.
USER INTERFACE INTERFACE COM USURIO .............................................................. 69
CONFIRMATION ................................................................................................................................... 69
WINDOWS INTERFACE ....................................................................................................................... 69
MenuBar ....................................................................................................................................... 69
Border Style .................................................................................................................................. 69
Maximize Button .......................................................................................................................... 70
Minimize Button ........................................................................................................................... 70
Form Icon ..................................................................................................................................... 70
Control Box .................................................................................................................................. 70
Modal Dialog ................................................................................................................................ 71

CHARACTER INTERFACE INTERFACE DE CARACTERES ........................................................ 71
Generate as a Popup Window ....................................................................................................... 71
Automatic Border Color ............................................................................................................ 72
Automatic Border Display Attribute.......................................................................................... 72
Automatic Border Characters .................................................................................................... 73

10.3.
AS/400 SPECIFIC ESPECIFICAES AS/400 ...................................................................... 73
COMMITMENT ...................................................................................................................................... 73
KEY ASSIGNMENT ............................................................................................................................... 74
Exit Key........................................................................................................................................ 74
Prompt Key................................................................................................................................... 74
Refresh Key .................................................................................................................................. 74
Insert Mode................................................................................................................................... 74
Previous Record............................................................................................................................ 75
Next Record .................................................................................................................................. 75
Retrieve ........................................................................................................................................ 75
Menu ............................................................................................................................................. 75
Update Mode ................................................................................................................................ 76
Cancel ........................................................................................................................................... 76
Delete Mode ................................................................................................................................. 76

Select ............................................................................................................................................ 76
First Record .................................................................................................................................. 77
Display Mode ............................................................................................................................... 77
More Keys .................................................................................................................................... 77

11.
Propriedades das Work Panels ............................................................................................................. 78
11.1.
LOADING .................................................................................................................................... 78
LOAD RECORDS ................................................................................................................................... 78
LOAD AT STARTUP .............................................................................................................................. 78
ALLOW USER TO CANCEL WHILE LOADING ................................................................................ 79
AUTOMATIC REFRESH........................................................................................................................ 79
REFRESH TIMEOUT (Foxpro for Windows e Visual Basic) ................................................................. 79
11.2.
WINDOWS INTERFACE ........................................................................................................... 80
MENUBAR .............................................................................................................................................. 80
BORDER STYLE .................................................................................................................................... 80
MAXIMIZE BUTTON ............................................................................................................................ 80
MINIMIZE BUTTON .............................................................................................................................. 81
FORM ICON ............................................................................................................................................ 81
CONTROL BOX ...................................................................................................................................... 81
MODAL DIALOG ................................................................................................................................... 81
11.3.
CHARACTER INTERFACE ....................................................................................................... 82
GENERATE AS A POPUP WINDOW ................................................................................................... 82
AUTOMATIC BORDER ......................................................................................................................... 83
Automatic Border Color ............................................................................................................ 83
Automatic Border Display Attribute.......................................................................................... 83
Automatic Border Characters .................................................................................................... 83

11.4.
KEY ASSIGNMENT ............................................................................................................................... 84
Exit Key........................................................................................................................................ 84
Refresh Key .................................................................................................................................. 84
Cancel ........................................................................................................................................... 85
More keys ..................................................................................................................................... 85

12.
Propriedades dos Relatrios ................................................................................................................. 86
12.1.
OPTIONS ..................................................................................................................................... 86
REPORT OUTPUT .................................................................................................................................. 86
PROMPT FOR CONFIRMATION .......................................................................................................... 86
ALLOW USER TO CANCEL PROCESSING ........................................................................................ 86
FOOTER ON LAST PAGE ..................................................................................................................... 87
12.2.
AS/400 SPECIFIC - ESPECIFICAES AS/400 ....................................................................... 87
KEY ASSIGNMENT ............................................................................................................................... 87
Exit Key........................................................................................................................................ 87
Refresh Key .................................................................................................................................. 87
Cancel ........................................................................................................................................... 87
More keys ..................................................................................................................................... 88

13.
Propriedades dos Procedimentos .......................................................................................................... 89
13.1.
OPTIONS ..................................................................................................................................... 89
REPORT OUTPUT .................................................................................................................................. 89
PROMPT FOR CONFIRMATION .......................................................................................................... 89
ALLOW USER TO CANCEL PROCESSING ........................................................................................ 89
FOOTER ON LAST PAGE ..................................................................................................................... 90
13.2.
TRANSACTION INTEGRITY INTEGRIDADE TRANSACIONAL ..................................... 90
COMMIT ON EXIT ................................................................................................................................. 90
13.3.
COMMITMENT ...................................................................................................................................... 92
KEY ASSIGNMENT ............................................................................................................................... 92
Exit Key........................................................................................................................................ 92

Refresh Key .................................................................................................................................. 92
Cancel ........................................................................................................................................... 92
More keys ..................................................................................................................................... 93

14.
Propriedades das Web Panels ............................................................................................................... 94
14.1.
FOOTER ...................................................................................................................................... 94
FOOTER IMAGE .................................................................................................................................... 94
WEBMASTERS MAIL ADDRESS ....................................................................................................... 94
15.
Propriedades do Modelo Visual Basic ............................................................................................... 95
15.1.
GENERAL ................................................................................................................................... 95
VISUAL BASIC VERSION .................................................................................................................... 95
GRID VERSION ...................................................................................................................................... 95
TARGET SYSTEM INTERFACE ........................................................................................................... 95
GENERATE MDI APPLICATION ......................................................................................................... 96
ALLOW COLUMN RESIZING .............................................................................................................. 97
SKIP READ-ONLY COLUMNS ............................................................................................................. 97
CONFIRM ................................................................................................................................................ 97
AUTOSKIP .............................................................................................................................................. 98
LOCK TYPE ............................................................................................................................................ 98
PSEUDO CONVERSATIONAL DIALOG ............................................................................................. 99
LOCAL DATABASE FILE ................................................................................................................... 100
MAIL FUNCTIONS .............................................................................................................................. 100
GRAPHIC FUNCTIONS ....................................................................................................................... 100
EXCEL OLE FUNCTIONS ................................................................................................................... 101
COMMOM DIALOG FUNCTIONS ..................................................................................................... 101
15.2.
RIGHT BUTTON ....................................................................................................................... 103
CALCULATOR ON SECUNDARY NUMERIC FIELDS ................................................................... 103
CALENDAR ON DATE FIELDS ......................................................................................................... 103
15.3.
PRINTING ................................................................................................................................. 103
LAN PRINTER ...................................................................................................................................... 104
SHOW PRINTER DIALOG ON REPORTS ......................................................................................... 104
PRINT METHOD .................................................................................................................................. 105
15.4.
FORMAT ................................................................................................................................... 105
FIELD EXIT........................................................................................................................................... 105
ESC KEY ACTION ............................................................................................................................... 106
DECIMAL SEPARATOR...................................................................................................................... 106
DATE FORMAT .................................................................................................................................... 106
DATE FORMAT IN CTOD FUNCTION (VISUAL BASIC) ............................................................... 107
TIME FORMAT..................................................................................................................................... 107
FIRST YEAR OF 20th CENTURY ........................................................................................................ 108
15.5.
WEB INFORMATION .............................................................................................................. 108
PROTOCOL SPECIFICATION............................................................................................................. 108
15.6.
TYPE CHECKING .................................................................................................................... 109
CHECK TYPE ERRORS ....................................................................................................................... 109
FUNCTIONS.......................................................................................................................................... 112
15.7.
KEY CONFIGURATION .......................................................................................................... 112
FIRST RECORD .................................................................................................................................... 112
LAST RECORD ..................................................................................................................................... 112
NEXT RECORD .................................................................................................................................... 112
PREVIOUS RECORD ........................................................................................................................... 112
REFRESH KEY ..................................................................................................................................... 112
PROMPT KEY ....................................................................................................................................... 112
15.8. ............................................................................................................................................................ 113
15.9.
OTHER ....................................................................................................................................... 113
MAXIMUN WORKFILE LINES .......................................................................................................... 113
1. Comandos GeneXus
1.1. Assign Atributo
(Procedure)
<Att> = <Exp>
Associa o valor de uma expresso para um atributo (Este comando
atualiza o banco de dados).
A expresso associada a <Exp> pode ser:
um Atributo
uma Varivel
uma Constante
uma Funo
uma Expresso Aritmtica (Data e tipo Numrico somente)
A atualizao precisa ser feita dentro de um grupo FOR EACH ENDFOR.
Vrias tabelas podem ser associadas a um grupo FOR EACH ENDFOR, por
exemplo:
Tabela Base
Tabelas que podem ser acessadas pela Tabela Base (Tabelas Estendidas).
Qualquer atributo dessas tabelas poder ser atualizado.
1.2. Assign Varivel

(Transao, Procedure, Relatrio, Work Panel)
&<Var> = <Exp>
Associa o valor de uma expresso para uma varivel.
Algumas vezes necessrio definir clculos locais dentro de um objeto.
GENEXUS torna isso possvel via VARIVEIS LOCAIS. Essas variveis
existem somente no ambiente do objeto correspondente e em nenhum outro
lugar.
A expresso associada a <Exp> pode ser:
Um Atributo
Uma
Uma
Uma
Uma
Varivel
Constante
Funo (permitido quando uma associao utilizada)
Expresso Aritmtica (Data e tipo Numrico somente)
1.3. Call
CALL([]Pgmname[],[parm1,parm2,...]
Este comando usado para chamar uma rotina externa ou um objeto
GENEXUS. Parmetros podem ser atributos, variveis ou valores constantes.
Todos os parmetros servem para entrada e sada, assim valores podem ser
retornados em qualquer dos parmetros.
Se o programa que voc estiver chamando j existir, no ser necessrio
escrever o nome entre apstrofos. GENEXUS ir checar se o programa
realmente existe.
O Nome do programa que ser chamado pode ser uma varivel ou um
atributo.
1.4. Change Page

(Procedure, Relatrio)
CP <nlines>
Causa um salto de pgina quando faltarem menos linhas que <nlines> na
pgina que est sendo impressa. Esse comando equivalente a: EJECT if
Pagelenght Currentline for menor que <nlines>.
1.5. Commit
(Procedure, Relatrio, Work Panel)
Commit
Fora um COMMIT quando includo em um programa.
GENEXUS ir ativar o controle de Commitment para todas as
Procedures e Transaes, se nenhum dos dois comandos NOCOMMITMENT ou
NOENDTRN tiverem sido especificados, ser gerado um COMMIT no final da
execuo da Procedure ou Transao.
1.6. Confirm
(Transao, Work Panel)
Confirm(msg | &<Var> [,Y | N])
Mostra uma mensagem e aguarda at o usurio informar Sim ou No.
Mostra o texto/varivel (msg /&<var>, respectivamente) em uma janela
(ou linha de mensagem, dependendo do ambiente de trabalho) e aguarda uma
resposta do usurio que pode ser Sim ou No. Em ambiente AS/400 os
valores possveis so F12=Cancel ou Reject e Enter=Accept ou Confirm. Para
saber se o operador confirmou ou rejeitou a mensagem, a funo
CONFIRMED( ) usada.
1.7. Delete
(Procedure)
Delete
Exclui o registro da Tabela Base associado ao grupo onde o comando
DELETE foi especificado.
Regras:
Um comando DELETE pode somente ser usado em um FOR EACHENDFOR.
A Excluso executada exatamente no momento em que o comando
DELETE encontrado.
A integridade referencial no automaticamente checada quando o
comando DELETE especificado.
NOTA:
Se o comando DELETE especificado em um grupo que contenha
grupos aninhados, os dados do grupo corrente podem ser usados
dentro dos grupos aninhados, embora eles no sero fisicamente
deletados.
Recomendao: primeiro exclua os nveis internos antes dos externos.
Isto evita qualquer possvel cancelamento ou travamento do registro.
1.8. Do Nome Subrotina

(Transao, Procedure, Relatrio, Work Panel e Web Panels)
DO RoutineName
Permite voc chamar uma subrotina (definida usando o comando Sub).
No permitida a passagem de parmetros; TODAS as variveis do mesmo
programa tambm podem ser utilizados pela subrotina.
1.9. Do While
(Transao, Procedure, Relatrio, Work Panel e Web Panels)
Do while <Cond>
Enddo
Sero executados todos os comandos entre o DO WHILE e o ENDDO
enquanto a condio <Cond> for verdadeira. Para forar a sada do grupo do DO
WHILE pode ser usado o comando EXIT.
1.10. Eject
Eject
Este comando fora um salto de pgina no programa gerado, quando a
sada selecionada est associada a impressora, ou limpa a tela quando a sada
est associada a tela.
1.11. Error_Handler
Implementado para tratamento de erros para Client/Server.
A regra/comando error_handler prov uma maneira dinmica para
executar aes especficas quando um erro no database relatado em tempo
de execuo do programa.
Quando usado como regra, a sintaxe : Error_handler(subname).
Quando usado como comando, a sintaxe : Error_handler([subname]),
onde, subname o nome de uma subrotina.
10
1.12. Exit
Exit
O comando Exit permite abandonar um grupo For Each, Xfor Each ou Do
While. O prximo comando a ser executado aps um exit o prximo comando
aps o comando EndFor, XendFor ou EndDo correspondente ao grupo que
contm o comando Exit.
NOTA: O comando Exit no valido dentro de um FOR EACH LINE.
1.13. Footer
Footer
End
Define as linhas de rodap a serem impressas no final de cada pgina.
Os comandos entre a clusula FOOTER e a clusula END so executadas
quando chega-se ao final da pgina. FOOTERS podem tambm ser definidos
com um FOR EACH dentro, da mesma forma como HEADERS pode.
Se existirem linhas de impresso entre o FOOTER e o END, elas iro ser
impressas dentro da margem inferior (parmetro MB). Se as linhas de
FOOTER no couberem dentro da rea da margem inferior a impresso ir
continuar na prxima pgina.
1.14. For Each

For each [order <Att1> <Att2> ...]
[Where <Condition> ]
[Defined by <Att1> <Att2> ...]
Endfor
Define um grupo de atributos genricos por operaes, o comando For
Each usado para definir acesso ao Banco de Dados.
No existem referncias explcitas para tabelas em um FOR EACH. Voc
somente precisa mencionar QUAIS os Atributos que voc precisa, e o Genexus
11
resolve o problema de COMO encontr-los. A maneira COMO GENEXUS vai

efetuar a navegao pode ser vista no relatrio de Especificao. Para forar
uma sada de um grupo FOR EACH voc pode usar o comando EXIT.
Existem dois tipos de tabelas associadas a um grupo FOR EACH:
Uma TABELA BASE.
Tabelas que podem ser alcanadas pela Tabela Base, conhecidas como
Tabelas Estendidas.
Se existirem atributos que no faam parte da Tabela Base nem das
Tabelas Estendidas ir aparecer uma mensagem de erro no relatrio de
Especificao e o programa no ser gerado.
CLUSULA ORDER
ORDER < Lista de Atributos >
A ordem para acessar a Tabela Base de um for Each pode ser
especificada por uma lista ordenada de atributos, informados logo aps o
comando FOR EACH.
NOTA: A clusula ordem bastante usada para definir quebras (Break)
em grupos For Each aninhados. Uma quebra definida sempre que ns temos a
mesma tabela base em dois grupos For Each, os atributos da Quebra esto
definidos pelo conjunto de atributos especificados na clusula Ordem.
CLUSULA WHERE
WHERE <Condio>
A clusula WHERE pode ser especificada para estabelecer uma condio
para o grupo For Each EndFor.
Regras:
Vrios comandos WHERE podem ser especificados aps um FOR
EACH. Neste caso, as condies WHERE funcionaro como se elas
estivessem separadas por um operador .AND..
Um comando WHERE pode, somente, ser especificado imediatamente
aps um FOR EACH ou aps outro comando WHERE.
12
CLUSULA DEFINED BY
DEFINED BY < Lista de Atributos >
Este comando permite definir a Tabela Base de um grupo FOR EACH ENDFOR.
Geralmente quando se est definido Procedures/Reports/Work Panels,
os atributos dentro do FOR EACH determinam a Tabela Base. Algumas vezes,
os atributos dentro do grupo no determinam exatamente a Tabela Base (ex.:
mais de uma tabela pode ser encontrada como Tabela Base). Assim
necessrio declarar um grupo para determinar qual a Tabela Base que tem mais
prioridade, informando uma Lista de Atributos na clusula DEFINED BY.
1.15. For Each Line

(Work Panel)
For each line
EndFor
Fora o processamento de todas as linhas (carregadas) no subfile em
uma Work panel.
Esse comando pode ser usado, por exemplo, para marcar todas as linhas
que satisfaam uma certa condio.
FOR EACH LINE tem as seguintes restries:
Ele somente ir processar os registros que foram carregados no
subfile. Se voc quiser processar todos os registros do Subfile, a
regra LOAD ALL precisa ser usada.
Ele processa todas as linhas, tenham elas sido modificadas ou no.
1.16. For Each Selected line

(Work Panel)
For each select line
EndFor
Esse comando funciona de forma similar ao for each lline, porm
somente sero consideradas as linhas marcadas (selecionadas).
1.17. Graph
(Work Panel)
graph([<GraphName>,][<List>]);
13
Permite gerar um grfico a partir das informaes contidas no Subfile.

Isto pode somente ser utilizada por programas gerados para Foxpro for
Windows ou Visual Basic. Quando gerado no Foxpro for Windows, o programa
MS-GRAPH (Includo no Foxpro for Windows) executado sempre que esse
comando for localizado.
contedo do subfile usado como o dado para o grfico e o usurio pode
escolher qual o tipo de grfico que ser usado. possvel alterar os valores,
imprimir o grfico e v-lo em 3D, etc. Este comando ir armazenar todas as
definies do grfico (portanto o Graph Wizard no precisa ser usado
todas as vezes).
Onde:
<GraphName> corresponde ao caminho e nome para o arquivo que
contm o grfico.
Se o arquivo correspondente ao grfico no existir, o Graph
Wizard ser chamado. Uma vez que o grfico definido voc
precisar salv-lo com o mesmo nome usado em <GraphName>. Se voc
quiser modificar a definio do grfico voc precisa dar um duplo
clique sobre a janela do grfico.
<List> uma lista com os atributos e variveis do Subfile que devem
ser includs no grfico. O eixo X pode receber qualquer type varivel
(caractere, data ou numrico) e todas as outras variveis precisam
ser numricas (eixo Y).
1.18. Header
Header
End
Define o cabealho a ser impresso no topo de cada pgina.
O primeiro grupo no Layout padro das Procedures/Reports o grupo
HEADER. Os dados dentro desse grupo so impressos no incio de cada pgina
do relatrio.
Voc pode tambm definir um cabealho para cada FOR EACH definido
no Layout.
14
1.19. If
If <Cond>
[Else]
Endif
Executam um bloco de comando se a condio for avaliada como
verdadeira.
1.20. Line Number

Lineno <Lineno>
Especifica o nmero da linha onde o dado ser impresso.
1.21. Load
(Work Panel)
Load
Este comando fora a carga de uma nova linha dentro do subfile.
Ela bastante usada quando o Work Panel no tem uma tabela Base, e
consequentemente a carga precisa ser feita na mo ou quando precisamos
fazer filtros com atributos de vrias tabelas.
1.22. Margin Botton

MB <nlines>
Configura o nmero de linhas em branco no final de uma pgina.
Se margin Botton no for especificado, 6 linhas sero assumidas
(<nlines> = 6).
15
1.23. Margin Top

MT <nlines>
Define o nmero de linhas em branco no topo da pgina.
1.24. Message
Msg(msg | &<var> [,nowait] [,status])
Usado para mostrar mensagens de aviso. Pode mostrar um literal ou uma
varivel contendo uma mensagem.
Nowait: Armazena a mensagem em uma varivel interna e continua o
processamento. O usurio no ir ver mensagem at que o processamento do
programa se encerre. Isto garante uma melhor performance com menos telas
de I/O requeridas.
Status: A mensagem mostrada no momento em que originada. Ela usada
principalmente para dar ao usurio informaes sobre status de
processamento.
Nenhuma Opo Especificada: Exibe a mensagem e aguarda pelo
pressionamento do <ENTER>.
1.25. New Record

(Procedure)
New
[When Duplicate]
EndNew
O comando NEW insere um registro na Tabela Base determinada pelo
atributo no grupo NEW-ENDNEW. Chaves duplicadas so checadas.
Se a chave j existir, todos os comandos entre o WHEN DUPLICATE e o
ENDNEW sero executados. Caso voc deseje fazer alguma alterao nesse
registro j existente, um grupo FOR EACH ENDFOR precisa ser especificado
dentro do WHEN DUPLICATE.
16
1.26. NoSkip
NoSkip
Inibe salto de linhas de impresso consecutivas.
Este comando precisa ser colocado imediatamente aps o print block.
1.27. Page Length

PL <nlines>
Configura o tamanho da pgina para Reports/Procedures.
O nmero de linhas que sero impressos o nmero especificado por
<nlines>, menos a margem inferior (valor default 6).
1.28. Print If Detail

Print if Detail
Evita a impresso do registro se no existirem registros no Subfile.
Este comando precisa ser especificado sempre que voc quiser inibir o
processamento de um FOR EACH caso no haja registros de detalhe para ele.
Ele pode ser colocado em qualquer lugar dentro de um grupo.
1.29. PrinterCommand
PrnCmd <\Onn | String>
Manda seqncias de controle para a impressora.
<\Onn | String> um string caracter contendo caracteres ou um cdigo
ASCII de 3 dgitos precedido por uma \ onde no mnimo um espao separa o
PRNCMD and <\Onn | String>. Os parmetros dependem de cada impressora e
podem ser encontrado no Manual da Impressora.
17
1.30. Refresh
(Work Panel)
Refresh [Keep]
Atualiza as informaes mostradas no subfile.
Opo KEEP:
Este parmetro indica que quando o comando Refresh for executado, o
Subfile ser posicionado sobre o registro que estava em foco anteriormente.
1.31. Return
Return
Encerra o programa e retorna a execuo ao programa que o chamou.
1.32. RollBack
RollBack
O comando ROLLBACK invalida um conjunto de alteraes do banco de
dados em uma LWU (Logical work Unit).
Consideraes:
O comando ROLLBACK ignorado pelos ambientes que no usam
Integridade Transacional.
1.33. Submit
SUBMIT(Usr-pgm,SubmitParms[<Parm1> <Parm2> ...])
Processa certas tarefas da aplicao em modo batch.
Os ambientes que no permitem a execuo de tarefas batch (como o
DOS) consideram o SUBMIT como se fosse um comando CALL e ignoram os
parmetros especficos do SUBMIT.
18
1.34. Subroutine
Sub RoutineName
EndSub
Permite que sejam definidas rotinas que sero disparadas quando um
comando DO for executado. Todas as variveis do mesmo programa fonte pode
tambm ser usadas dentro da subrotina.
1.35. Xfor Each

Xfor each <FileName> [INDEX <Indexname>]
Where <Condition>
Xendfor
Define um loop interativo para um arquivo externo (File View), usando
ndice especificado (se existir) e filtra dados de acordo com a condio
declarada na opo WHERE.
1.36. Xfor First

Xfor first <FileName> [INDEX <IndexName>]
Where <Condition>
Xendfor
Este comando similar ao comando XFOR EACH, porm ele no fica em
loop. Ele retorna o primeiro registro (se existir um registro) de um arquivo
externo utilizando o ndice especificado e filtrando dados de acordo com a
condio declarada na opo WHERE.
1.37. Xnew
(Procedure)
Xnew <FileName> Xendnew
19
O comando XNEW insere um registro em um File View (arquivo externo).
2. Regras dos Objetos GeneXus
2.1. ACCEPT
(Transaes)
Accept(&varivel, Atributo);
Esta Regra permite aceitao de uma Varivel em Tela.
A ordem da entrada do valor para a Varivel em um Nvel, depender da
posio das Variveis e dos Atributos na Tela.
20
2.2. ADD
(Transaes)
Add( Atributo1, Atributo2) if Condio;
Esta regra adiciona o valor de Atributo1 ao Atributo2, se a Condio for
avaliada como verdadeira.
Esta Adio leva em conta as operaes de Insero, Atualizao e
Remoo.
Exemplo:
Add( Qtdcompra, Qtdestq);
Se o atributo Qtdcompra for atualizado, o Atributo Qtdestq tambm o
ser, pelo valor diferencial da atualizao.
2.3. ALLOWNULLS
(Transaes)
Allownulls( Atrib1, Atrib2, ..., AtribN )
Esta regra usada para permitir valores NULOS para atributos nos
quais so feitos verificao da integridade referencial.
2.4. <ASSIGN>
(Transaes, Relatrio/Procedimentos)
Atributo | &Varivel = Expresso IF Condio;
Esta regra usada para assinalar o valor de uma expresso a um dado
atributo. Em contraste com Frmulas, o valor atribudo ao Atributo ou
varivel somente quando a Transao estiver sendo processada.
2.5. CALL
(Transaes, Procedimentos, Relatrios, Work Panels)
CALL(Prog_usurio,Par1,...,Parn) IF Condio;
Desvia a execuo temporariamente para outro programa.
O Prog_usurio, que pode ser: um nome de programa, atributo ou
varivel, ser chamado sempre que a Condio for avaliada como Verdadeira.
Exemplo:
21
&Pgm = WProg
Call(&Pgm, &V1,&V2);
2.6. COLOR
(Transaes, Work Panels)
Color( <gxcolor> ); //Permite a definio das cores default para tela.
Color(<gxcolor>,[<attri>|<var>)(if <cond>]; //Define cores para atributos
ou variveis.
Onde:
<GxColor> = <Displaycolor>[,<AcceptColor>]
<DisplayColor> = <ColorPair>
<AcceptColor> = <ColorPair>
<ColorPair> = <ColorSet> [/ <ColorSet>]
<ColorSet> = <Color> [ <DsAttri> ]
<Color> = WHT | BLK | RED | GRN | BRW | MGN
BLU | CYN | YLW | RI | X
<DspAttri> = + | *
Cada <ColorPair> define a cor de frente e a cor de fundo.
Abreviaturas de Cores: WHT = branco
BLK = preto
RED = vermelho
GRN = verde
BRW = marrom
MGN = magenta
BLU = azul
CYN = cinza
YLW = amarelo
RI
= imagem reversa
X
= escondido
Um asterisco (*) em <DspAttri> representa um elemento BLINKING e
um sinal mais (+), em HIGHLIGHTS.
Ex.:
color(RED+, Saldo) if saldo < 0;
Color(WHT, Saldo) if saldo > = 0;
2.7. DEFAULT
(Transaes, Procedimentos/Relatrios, Work Panels)
22
Default( Atributo, xxx);

Onde xxx pode ser: Atributo, Constante ou Funo.
Esta Regra assinala o valor de xxx ao Atributo no momento da Insero,
e permite que o usurio mude esse valor.
Exemplo: Default(Peddat, today( ) );
Esta regra no vlida para um Atributo que faa parte de uma
Chave.
2.8. DEFAULT MODE

(Transaes)
Default_mode(Ao, Atributo);
usada para forar um modo especfico em um Nvel de Transao.
Ao: Pode ser uma das seguintes: INSERT, UPDATE ou DELETE.
Atributo: usado para indicar o Nvel. Se no for especificado nenhum
Atributo, ser assumido o primeiro Nvel.
2.9. EQUAL
(Transaes)
Equal( Atributo, xxx);
Onde xxx pode ser: Atributo, Constante ou Funo.
Esta Regra assinala o valor de xxx ao Atributo no momento da Insero.
Esse valor no pode ser mudado pelo usurio.
2.10. ERROR
(Transaes)
Error(Texto de Mensagem) IF Condia;
23
Esta Regra faz com que a string definida em Texto de Mensagem seja
apresentada na Janela de Erro da Transao, se a condio for avaliada como
verdade.
Todo processamento subsequente, inclusive outras regras, no sero
executadas. Portanto, se muitas regras estiverem associadas a uma nica
condio, a regra Error dever ser a ltima, para que as outras possam ser
executadas.
2.11. ERROR_HANDLER
Implementado para tratamento de erros para Client/Server.
A regra/comando error_handler prov uma maneira dinmica para
executar aes especficas quando um erro no database relatado em tempo
de execuo do programa.
Quando usado como regra, a sintaxe : Error_handler(subname);
Quando usado como comando, a sintaxe : Error_handler([subname])
Onde:
Subname o nome de uma subrotina.
2.12.
2.13. HIDDEN
(Work Panels)
Hidden(<Parm1>,<Parm2>,...,<Parmn>);
Esta regra usada para incluir atributos ou variveis especficas no
Subfile, que eventualmente no aparecem na tela. Ela bastante utilizada
quando precisa-se de um cdigo no Subfile, mas no se quer que ele aparea na
tela.
24
2.14. MSG
(Transaes)
Msg(Texto de Mensagem) IF Condio;
Esta regra usada para enviar mensagens de aviso para o operador. A
string definida em Texto de Mensagem ser apresentada na Janela de erro
da Transao se a for avaliada como verdade.
2.15. NOACCEPT
(Transaes, Work Panels)
Noaccept( Atributo | &Varivel) IF Condio;
GeneXus avalia quais Atributos so entrada de dados, e quais Atributos
so sada de dados. Todavia, pode haver ocasies em que no se deseja que o
usurio introduza dados, dependendo de uma condio.
Esta regra faz com que a Transao no aceite a digitao de dados para
o Atributo ou varivel associado.
2.16. NOCHECK
(Transaes)
Nocheck( Atributo1, Atributo2, ..., Atributon);
A regra Nocheck usada para inibir a checagem de integridade
referencial.
2.17. NOCONFIRM
(Transaes)
Noconfirm(Atributo);
A regra Noconfirm usada para evitar a confirmao no Nvel. Quando
se passa de um Nvel para o seguinte, uma mensagem apresentada, pedindo a
confirmao dos dados. Para se evitar o pedido de confirmao, usa-se esta
regra.
Atributo: usado para indicar o nvel. Se no for especificado nenhum
atributo, ser assumido o primeiro nvel.
25
2.18. NOREAD
(Procedimentos/Relatrios, Work Panels)
Noread(<Att1>,<Att2>,...,<Attn>);
Essa regra permite inibir a leitura de uma tabela que navegada e
mostrada no diagrama de navegao quando especificado.
2.19. NOPROMPT
(Transaes)
Noprompt( Atrib1, Atrib2, ..., AtribN)
Atrib1, Atrib2, AtribN so identificadores da chave da tabela.
Essa regra usada para evitar o Prompt (Visualizar) quando se entra
com um valor para a Chave Estrangeira que no existe na Tabela.
2.20. ORDER
(Work Panels)
Order(<Att1>,<Att2>,...,<Attn>);
Estabelece a ordem de leitura da tabela base da Work Panel.
Se essa regra omitida, a chave primria da tabela base ser usada.
2.21. PARM
Parm( Par1, Par2, ..., Parn);
Recebe os programas enviados por outro programa.
Obs.:
Transaes que possuem a regra PARM( ) no aparecem no

Menu.
26
Quando um Objeto chamado de outro programa, os

parmetros recebidos pela regra PARM( ) so considerados
como uma regra Equal.
2.22. PRINTER
(Procedimentos/Relatrios)
Printer(<PrinterFile>);
Seleciona o arquivo de impresso a ser usado pelo AS/400 ou o nome da
impressora, definido por uma varivel de ambientes DOS, na gerao Xbase.
2.23. PROMPT
(Transaes)
Prompt(Programa, Atrib1, Atrib2, ... , AtribN);
Chama o programa definido, ao invs do programa default criado pelo
GeneXus, quando seleciona-se Visualizar.
2.24. REFCALL
(Transaes)
Reffcall(Nome_prog, Atrib1, ... , AtribN);
Esta regra usada para chamar um Programa quando a integridade
referencial tenta ser quebrada.
2.25. REFMSG
(Transaes)
Refmsg(Texto, Atrib1, ..., AtribN)
27
Esta regra usada para mudar as mensagens geradas por GeneXus

quando verificando as Integridades Referenciais em tempo de Insero ou
Atualizao.
Exemplo: Refmsg(O CLIENTE NO ESTA CADASTRADO, Clicod);
2.26. SEARCH
(Work Panels)
Search(<Cond>);
Seleciona um posicionamento condicional para o subfile.
A diferena dessa regra para uma condition que ela no filtra os dados
do subfile, ela somente posiciona o ponteiro.
2.27. SERIAL
(Transaes)
Serial( Atributo1, Atributo2, Passo);
Esta regra faz com que o Atributo1 seja incrementado para o valor
contido em Atributo2 mais o valor do Passo, toda vez que um novo registro for
adicionado Tabela onde Atributo1 esteja.
Se Atributo1 no faz parte do Identificador, o usurio dever digitar
um valor que no existe, para que Atributo1 assuma o modo INSERO, e
receba o prximo valor serializado.
2.28. SUBMIT
(Transaes)
SUBMIT(Usr-pgm,SubmitParms[,<Parm1>,<Parm2>,...])[IF <Cond>];
Processa relatrios e procedimentos em modo batch, desde que esses
no tenham interaes com o usurio.
2.29. SUBTRACT
(Transaes)
Subtract( Atributo1, Atributo2) if condio;
28
Esta regra Subtrai o valor de Atributo1 do Atributo2, se a Condio for

avaliada como verdadeira. Esta Subtrao leva em conta as operaes de
Insero, Atualizao e Remoo.
Exemplo: Subtract( Qtd, Qtdestq);
2.30. WORKFILE_LINES
(Work Panels)
Workfile_lines(<NoLines>);
Estabelece o tamanho mximo para o subfile.
Os Subfiles em um ambiente PC so carregadas em um arquivo
temporrio. O tamanho mximo para o subfile no AS/400 de 9.999 linhas,
contudo, no existem restries quando PC ou LANs so usados.
Esta liberdade pode causar problemas, por exemplo, se voc est
trabalhando com uma Work Panel ou Transao que carrega 300.000 registros
da tabela base e o usurio vai para o fim do arquivo (Ctrl-End). Neste caso um
arquivo temporrio contendo 300.000 registros ser gerado.
2.31. XORDER
(Work Panels)
Essa regra utilizada em Work Panels que utilizam arquivos externos.
Ela indica qual o arquivo base do subfile, e qual ndice ser usado para
carreg-lo (caso no seja indicado, a ordem fsica ser usada).
29
3. Funes Disponveis no GeneXus

3.1. DAY
Day(<Date>)
Tipo retornado: N(2)
Retorna o dia de uma data informada. Se <Date> for uma data nula, o
valor 0 ser retornado.
3.2. MONTH
Month(<Date>)
Retorna o nmero do ms de uma data informada. Um valor nulo (0) ser
retornado se a <Date> no for uma data nula.
30
3.3. YEAR
Year(<Date>)
Retorna o ano de uma data informada. Se <Date> no for uma data vlida,
um valor nulo ser retornado.
3.4. TODAY
Today( )
Tipo retornado: Date
Retorna a data do sistema operacional.
3.5. NOW( )
(Transaes, Procedimentos, Relatrios, Work Panels, Web Panels)
Now( )
Tipo retornado: Datetime
Retorna a data e a hora corrente.
3.6. HOUR, MINUTE, SECONDS

(Transaes, Procedimentos, Relatrios, Work Panels, Web Panels)
Hour( <Date Time> ) / Minute(<DateTime>) / Seconds(<Date Time>);
Tipo retornado: Numrico
Retorna um valor numrico representando as horas/minutos/segundos
respectivamente, no formato da hora informado do datetime.
31
3.7. DOW
Dow(<Date>)
Retorna um nmero entre 1 e 7. Este nmero est associado ao dia da
semana (Domingo=1).
Se a data contida em <Date> for nula, o valor retornado ser 0.
3.8. CDOW
Cdow(<Date>[<Language>])
Tipo retornado: C(9)
Retorna o nome do dia da semana de uma determinada data na linguagem
selecionada. Espaos sero retornados se o valor de <Date> for invlido.
<Language> deve ser uma das seguintes (caso no seja informada, ser
utilizada a linguagem selecionada no Model Properties):
spa Espanhol
eng Ingls
por Portugus
ita - Italiano
3.9. CMONTH
Cmonth(<Date>[ , <Language>])
Retorna o nome do ms da data informada na linguagem selecionada. Se
nenhuma linguagem for selecionada, ser utilizada a que estiver definida em
Model Properties.
3.10. CTOD
Ctod(nn/nn/yy)
32
Converte uma String em Data.

A string de caracteres pode ser mm/dd/yy ou dd/mm/yy dependendo
da linguagem corrente, onde: mm representa o ms com dois dgitos; dd
representa o dia com 2 dgitos; yy representa a ano com 2 dgitos.
Em ambiente Micro, o valor default depende da linguagem selecionada:
Ingls
mm/dd/yy
Portugus/Espanhol
dd/mm/yy
3.11. CTOT
(Transaes, Procedimentos, Relatrios, Work Panels e Web Panels)
CtoT(nn/nn/yy hh[:mm[:ss]][AM|PM])
Converte uma String em DateTime. A primeira parte dos parmetros
representa a data e a segunda parte a hora.
nn/nn/yy tem o formato M/D/A ou o especificado na preferncia Date
format in CTOD function.
Se AM|PM especificado, hh pode variar de 0-12. Caso contrrio, ir
variar entre 0-23.
{00:00:00AM} equivalente a {12:00:00AM}, Meia-noite
{00:00:00PM} equivalente a {12:00:00PM}, Meio-dia
{00:00:00} a {11:59:59} equivalente a {12:00:00AM} a {11:59:59AM}
{12:00:00} a {23:59:59} equivalente a {12:00:00PM} a {11:59:59PM}
24:00:00 no uma hora vlida.
Notas:
A data e a hora da string de parmetros devem ser separados por
pelo menos um branco.
Se qualquer parte da string (data e hora) for omitido, assumido
nulo.
Se qualquer parte da string no vlida, o DateTime resultante ser
nulo.
Se no for especificdo nem AM nem PM, o formato 24-horas
assumido.
33
3.12. DTOC
Dtoc(<Date>)
Retorna a String associada a data especificada.
3.13. TTOC
TtoC( <DateTime>[ ,M[ ,N]])
Tipo retornado: Caractere
Retorna caractere associado ao DateTime, com o formato especificado
por M e N.
Os valores possveis para M e N so os mesmos usados na definio do
tipo DateTime.
Valores possveis para M:
0
Data no pedida nem mostrada
8
Data mostrada em 8 dgitos (99/99/99)
9
Data mostrada em 10 dgitos (99/99/9999)
Valores possveis para N:
2
Somente a parte das horas mostrado no formato 24 horas
5
Hora e minuto so mostrados separados pelo smbolo
separador de horas. O formato 24 horas utilizado.
8
Hora completa mostrada (incluindo segundos). O formato
24 horas usado.
possvel tambm setar valor nulo (0) para N. Neste caso, somente a
parte da data obtido.
Exemplos:
TtoC( DT, 8, 0)
TtoC( DT, 10, 0)
TtoC( DT, 0, 0) NO vlido.
Notas:
No caso de M e/ou N serem omitidos, seus valores default so os
parmetros utilizados para definio do DateTime (primeiro
parmetro).
No caso da combinao M/N no ser vlida, os valores assumidos so:
M=10 e N=8.
34
O formato da string retornada o mesmo da funo CtoT, ou seja, a

data depende da preferncia Date format in CtoD function e a hora
sempre no formato 24 horas.
3.14. YMDTOD
Ymdtod(<NExp1>,<NExp2>,<NExp3>)
Retorna a data onde <NExp1> o ano, <NExp2> o ms e <NExp3> o
dia.
<NExp1>, <NExp2> e <NExp3> devem ser expresses numricas.
3.15. YmdHmstoT
YmdHmstoT( <NExp1>, <NExp2>, <NExp3> [ , <NExp4> [ ,<NExp5> [ ,<NExp6>]]])
Tipo retornado: Date Time
Retorna um Date Time associado a data e hora especificados no
parmetro. Parmetros omitidos assumem o valor zero. Todos os parmetros
so expresses numricas.
NExp1 representa o ano. Este valor no se ajusta ao que for indicado
na preferncia First year of 20th century.
NExp2 representa o ms.
NExp3 representa o dia.
NExp4 representa a hora. Hora deve ser especificado no formato 24horas.
NExp5 representa os minutos.
NExp6 representa os segundos.
Nota: Se somente um dos componentes (dat ou hora) vlido, somente
este ser considerado. Por exemplo: YMDHMStoT(1990, 31, 2, 12, 10, 15) ir
retornar um datetime vlido com a parte da data nula. A hora ser 12:10:15.
3.16. ADDMTH
Addmth(<Date>,<NExpression>)
35
Retorna a data referente a adio de <NExpression> meses para <Date>.

Um valor nulo retornado se <Date> for uma data invlida.
3.17. ADDYR
Addyr(<Date>,<NExpression>)
Retorna a data correspondente a <Date> mais <NExpression> anos.
3.18. AGE
Age(<DExpression1>[ ,<DExpression2>])
Retorna a quantidade de anos entre <DExpression1> e <DExpression2>.
Se <DExpression2> no for especificada, a funo Today( ) assumida.
3.19. EOM
Eom(<Date>)
Retorna o nmero do ltimo dia correspondente ao ms referente a data
informada.
3.20. TDIFF
TDiff( <DateTimeExpr1>, <DateTimeExpr2>)
Tipo retornado: Numrico.
Retorna os segundos da diferena entre dois DateTime recebidos como
parmetros (DateTimeExpr1 DateTimeExpr2)
Se DateTimeExpr2 for maior que DateTimeExpr1, um valor negativo
ser retornado.
36
3.21. TADD
TAdd( <DateTimeExpr>, <SecondsExpr> )
Tipo retornado: DateTime
Soma os segundos informados
<DateTimeEspr>.
em
<SecondsExpr>)
ao
datetime
3.22. ASK
Ask(msg text)
Pede ao usurio para que informe o valor de um Atributo ou varivel
antes de entrar no objeto.
msg text a mensagem que ser mostrada quando for solicitado o valor.
Exemplo:
&CliIni = ask(Cliente Inicial: );
&CliFin = ask(Cliente Final: );
3.23. UDF
Udf(Usr-Pgm, Par1, .., Parn)
Chama uma rotina que no usa tabelas e retorna um resultado.
Programas que NO USAM TABELAS podem ser referenciados usando a
funo UDF.
Quando voc escreve o cdigo para UsrPgm, deve incluir um parmetro
a mais no final da lista de parmetros, que dever conter o valor retornado
para a funo. Os outros parmetros no podero retornar nenhum valor.
Exemplo: TotalPoints = UDF(PCalPts, PilotNbr)
3.24. UDP
Udp(Usr-pgm, Paar1, ..., Parn)
37
A funo UDP chama um programa que pode USAR TABELAS e retorna

um valor.
Quando o cdigo para o programa UsrPgm for escrito, dever ser
includo no final da lista de parmetros, um parmetro o qual conter o valor
que ser retornado pela funo.
Note que a funo UDP fecha as tabelas antes da chamada ser feita, e
abre-as novamente aps retornar. Se Usr-Pgm no usa tabelas, a funo UDF
recomendada para que ganhe performance.
3.25. ROWS
Rows(&Array( ))
Retorna o nmero de linhas definidas para um vetor.
3.26. COLS
Cols(&Array( ))
Retorna o nmero de colunas de um vetor bidimensional.
3.27. TIME
Time( )
Retorna a hora no formato hh:mm:ss.
No AS/400, esta funo retorna a hora inicial do JOB.
No ambiente Micro/LAN, retorna a HORA DO SISTEMA, assim Time( )
e SYSTIME( ) so equivalentes.
38
3.28. SYSTIME
Systime( )
Retorna a hora do sistema no formato hh:mm:ss.
3.29. SYSDATE
Sysdate( )
Retorna a data do sistema.
3.30. USERCLS
Usercls( )
Retorna a classe do Usurio definida no User Profile. Esta regra vlida
somente no AS/400.
3.31. USERID
Userid( )
No ambiente AS/400, esta funo retorna a identificao do usurio
definida no User Profile.
No ambiente Micro/Lan esta funo retorna o contedo da varivel de
ambiente do DOS chamada LOGNAME. Para habilitar o uso dessa funo, essa
varivel dever ser criada para todas as estaes.
Em um ambiente Client/Server esta funo retorna a identificao do
usurio conectado ao servidor.
3.32. WRKST
Wrkst( )
39
Retorna a identificao da Estao de Trabalho correspondente.

Em ambiente Micro/Lan retorna o contedo da varivel de ambiente do
DOS, PSTATION. Para habilitar o uso dessa funo, voc precisa setar esta
varivel de ambiente.
3.33. STR
Str(N1 [ ,N2 [ ,N3]])
Converte o valor da expresso numrica em <N1> para uma string
caracter, alinhado pela direita, <N2> o tamanho total de <N1> (incluindo o
sinal e o ponto decimal), e <N3> o nmero de decimais. Se voc especificar
menos decimais do que a expresso numrica <N1> possui, o valor ser
arredondado.
Notas:
Zeros no significativos sero truncados.
O valor Default para N2 = 10
O valor Default para N3 = 0
3.34. SUBSTR
Substr(S1,N1,N2)
Retorna a substring de um dado informado.
Retorna a substring de S1 comeando na Posio N1, com um tamanho de
N2 caracteres.
3.35. CONCAT
Concat( S1, S2 [ ,S3])
Concatena duas strings incluindo um separador se informado.
40
Retorna a string resultante da concatenao de S1 e S2 e o separador

S3. Os brancos das strings S1 e S2 so truncados. Se S3 no for especificado,
no sero inseridos separadores.
3.36. SPACE
Space(<Att | Var | Const>)
Retorna uma string caracter com a quantidade informada de espaos em
branco.
No AS/400, o atributo ou varivel que recebe a funo, ser
completamente preenchido com espaos, independente do valor informado para
o argumento.
3.37. LEN
Len(S1)
Retorna o nmero de caracteres de uma expresso.
3.38. TRIM
Trim(<Str>)
Remove todos os brancos a esquerda e a direita da expresso caracter
<Str> informada.
3.39. LTRIM
LTrim (<Str>)
41
Remove todos os brancos a esquerda da expresso caracter <Str>. Esta

funo especialmente til para remover os brancos que so inseridos quando
voc utiliza a funo Str( ) para converter um valor numrico para uma string
caracter.
3.40. RTRIM
Rtrim(<Str>)
Remove os brancos a direita de uma string caracter informada.
3.41. UPPER
Upper(<Str>)
Retorna a correspondente maiscula da string <Str>. Cada letra
minscula (a - z) convertida em letra maiscula (A - Z) no resultado da
funo, todos os outros caracteres permanecem inalterados.
3.42. LOWER
Lower( <Str>)
Converte todas as letras maisculas (A Z) da expresso caracter <Str>
para letras minsculas (a z). Todos os outros caracteres da expresso
permanecero inalterados.
3.43. INT
Int( <Exp>)
Esta funo retorna a parte inteira da expresso <Exp>.
42
3.44. ROUND
Round(<NExp1>,<NCte>)
Arredonda o valor de <NExp1> para <NCte> casas decimais.
3.45. TRUNC
Trunc(<NExp1>,<NCte>)
Trunca o valor de <NExp1> para <NCte> decimais.
3.46. VAL
Val(<CExpression>)
Esta funo converte um nmero de uma expresso caracter para um
valor do tipo numrico. Ela processa os nmeros em uma expresso caracter da
esquerda para a direita at que um caracter no numrico encontrado.
3.47. COLOR
Color(<GXColor>);
Color(<GXColor>,[<Att1>|&<Var>]) [IF <Cond>];
Permite o uso de cores para os atributos, variveis e tela.
(Idem a regra COLOR).
3.48. RGB
RGB( <Red>,<Grn>,<Blu>)
43
Retorna um nmero representando um valor de cor RGB, dados os 3

seguintes parmetros:
Red : Nmero na faixa de 0 at 255, inclusive, que representa o
componente vermelho da cor.
Green : Nmero na faixa de 0 at 255, inclusive, que representa o
componente verde da cor.
Blue : Nmero na faixa de 0 at 255, inclusive, que representa o
componente azul da cor.
Um valor de cor RGB especifica a intensidade relativa de vermelho,
verde e azul para gerar uma determinada cor.
3.49. NULL
Null(<Att | Var>)
Retorna um valor Boleano true se o valor do atributo ou varivel for
nulo. O valor nulo para campos do tipo Numrico zero, e para campos tipo
Caracter e Data uma string em branco.
3.50. NULLVALUE
Nullvalue(<Att | Var>)
Retorna um valor nulo do mesmo tipo da definio do Atributo/Varivel.
3.51. LOADBITMAP
LoadBitmap(< FileName|Att|Var>)
Incorpora Bitmaps no design do Form.
A funo LoaBitmap usada para definir qual bitmap ser associada a
uma varivel.
44
3.52. OLD
(Transaes)
Old(<Att>)
Retorna o ltimo valor armazenado de um dado atributo <Att>
3.53. PREVIOUS
(Transaes)
Previous( )
Previous(<Att>)
Retorna o valor de <Att> usado na ltima insero da transao do
programa corrente. O valor no armazenado e ele perdido assim que o
usurio deixa a Transao. Se o atributo <Att> no for especificado, o atributo
que est sendo assinalado assumido.
3.54. AFTER
(Transaes)
After(<Event>)
Retorna Verdadeiro ou Falso dependendo de que estgio a transao se
encontre.
Retorna Verdadeiro se um evento especificado est acontecendo naquele
momento na transao.
Este evento pode ser disparado porque a execuo de uma Transao
passou por um certo Nvel, um certo atributo foi informado, ocorreu uma Ao
em uma Transao ou toda a transao foi finalizada. GeneXus
automaticamente realiza onde e como uma regra precisa ser executada.
Entretanto, o usurio pode forar que o GeneXus execute uma determinada
regra depois que um dos eventos seja mencionado.
<Event> pode ser: Insert
Update
Delete
Confirm
45
Trn
<Att>
Level(<Att>)
Nota: Quando for includa a regra After em uma regra condicional, a
regra ser executada SOMENTE imediatamente aps o evento After ocorrer
e em nenhum outro lugar.
3.55. LEVEL
(Transaes)
Level(<Att>)
Retorna Verdadeiro se a execuo da Transao est no Nvel de um
dado Atributo. GeneXus automaticamente realiza onde e quando uma regra
precisa ser executada. Contudo o usurio pode forar GeneXus a executar uma
dada regra a um Nvel especificado da transao.
3.56. INSERT/UPDATE/DELETE
(Transaes)
Insert
Update
Delete
Retorna Verdadeiro quando a transao est em modo de,
respectivamente, Insero/Alterao/Deleo, caso contrrio retorna Falso.
46
4. Operadores Disponveis no GeneXus

Operadores aritmticos ....................: +, -, *, /, ^
Operadores lgicos .............................: .AND. .OR. .NOT.
Operadores relacionais ......................: (, ), =, <, >, <>, >=, <=, LIKE
47
5. Variveis Internas do GeneXus
5.1. TODAY
Contm a data do sistema.
Formato: DD/MM/AAAA
5.2. TIME
Contm a hora do sistema.
Formato: HH:MM:SS
5.3. PAGE
Formato : N(4)
Contm a pgina corrente do Relatrio.
5.4. LINE
A varivel &Line contm a linha corrente do Relatrio, ou Procedimento,
no momento da execuo.
Nota: Tome cuidado para no alterar o valor de &Line, porque seno
GeneXus perder o controle de ejeo.
5.5. OUTPUT
A varivel de sada contm o cdigo do dispositivo de sada corrente.
Pode ser : SRC ou PRN
48
5.6. PGMDESC
(Transaes, Procedimentos, Relatrios, Work Panels E Web Panels)
Esta varivel contm a descrio do programa ativo. Esta descrio a
informada na opo Information. Tipo Caracter(30).
5.7. PGMNAME
Esta varivel contm o nome do programa ativo. O nome o especificado
na opo Information. Tipo caracter(30).
Exemplo: call(Pprocess, &Pgmname, Parm1, ...);
Suponha que tenhamos a procedure (Pprocess) que chamado por vrios
programas. Esta procedure processa as informaes conforme o programa
chamador. Se chamado por vrios, ns podemos incluir o nome do programa na
lista de parmetros para identificar quem est chamando o procedimento.
5.8. MODE
(Transaes)
Formato : C(3)
Permite determinar o modo vlido pelo qual a Transao poder
trabalhar.
Valores vlidos:
INS para inserir
UPD para atualizar
DEL para deletar
Nota: O contedo de &Mode deve ser letras maisculas.
Funciona somente se recebido como parmetro.
Apesar de no estar disponvel na lista de variveis do GeneXus, ao voc
defini-la, independente das caractersticas que informar, o formato acima
sempre prevalecer.
49
6. Propriedades do GeneXus
Importante: estas propriedades somente so vlidas para Visual Basic e
Visual Foxpro, os demais geradores vo ignor-las.
6.1. VISIBLE
(Tipos de controle: Todos)
Determina qual controle visvel ou escondido.
Valores:
0: Falso -> o controle no ser visvel no form.
1: Verdadeiro -> o controle ser visvel no form.
NOTA: Uma vez que o controle foi assinalado invisvel
(Controle.Visible=0) ele permanece dessa maneira at que voc o torne visvel
novamente (Controle.Visible=1).
Exemplo:
bitmap.Visible = 0 if RoupaCat = 2;
Bitmap.Visible = 1 if RoupaCat <>2;
Para mostrar a foto da roupa dependendo da categoria, deveramos
fazer as regras acima.
6.2. TOLLTIP
(Tipos de controle: Button, Edit, Check Box)
Atribui um tip um controle quando o mouse estiver posicionado sobre o
mesmo. Uma string deve ser informada.
Exemplo: Assinalando um tip ao boto cujo nome TESTE.
Event start
Teste.tooltiptext= informaes para teste
EndEvent
50
6.3. CAPTION
(Tipos de controle: Button, Frame, Text, Radio Button)
Forms: Determina o texto a ser mostrado como ttulo na barra de ttulos
do form. Quando o form minimizado, o texto mostrado abaixo do cone do
Form.
Outros controles: Determina o texto a ser mostrado no controle.
Exemplo:
Form.Caption = My Form Update if update;
Form.Caption = My Form Delete if delete;
Form.Caption = My Form Insert if insert;
Neste exemplo, o ttulo do form muda dependendo do modo corrente
(ins., del. ou alt.).
6.4. ENABLE
(Tipos de controle: Button, Edit, Check Box, Radio Button, Combo Box, Subfile,
Frame, Text)
Determina se o controle pode responder aos eventos de usurio.
Valores:
1: (Verdadeiro)
Permite o objeto responder aos eventos.
2: (Falso)
Impede o objeto de responder aos eventos.
Exemplos: 1) EvtBtn.Enabled = 0 if update;
Este boto DESABILITADO se estiver em modo Update.
2) Att2.Enabled = 0 if .not. Null(Att1);
Atributo Att2 no pode ser editado se atributo Att1 no
for nulo.
3) subfile.Enabled = 0 if update;
O subfile no pode ser acessado se estiver em modo
Update (Dados no subfile no podem ser modificados).
6.5. ACTIVEPAGE
(Tipos de controle: Tab)
usada para indicar qual a pgina ativa de um tab control. Esta ser
visvel para o usurio.
Exemplo: MyTab.ActivePage = 1
// a primeira pgina ativada
51
MyTab.ActivePage = Mytab.Activepage + 1 // move para a

prxima pgina.
NOTA: esta propriedade no implementada no gerador Visual Basic 4.0
6.6. PAGECOUNT
(Tipos de controle: Tab)
usada para obter o nmero de pginas de um tab control.
normalmente usada junto com a propriedade ActivePage.
Exemplo: IF MyTab.ActivePage < MyTab.PageCount
MyTab.ActivePage = MyTab.ActivePage + 1
ELSE
Btn_Next.Caption = Finish
ENDIF
NOTA: esta propriedade no implementada no gerador Visual Basic 4.0
6.7. BACKCOLOR, FORECOLOR

Determina as cores de fundo e frente respectivamente de um controle.
Um valor numrico representando um RGB color value deve ser assinalado.
Exemplo: Para que a cor de fundo de um controle de edio seja verde,
devemos fazer: EditCrtl.Backcolor = RGB(0,255,0)
Exemplo: Para que a cor de frente de um controle de edio seja azul,
devemos fazer: EditCrtl.Forecolor = RGB(0,0,255)
6.8. TOP, LEFT

Determina a distncia interna (em pixels) entre o canto
superior/esquerdo do controle e o canto superior/esquerdo de quem contm
(Frame ou Screen).
Exemplo:
Form.Top = 500;
Form.Left = 600;
52
Neste exemplo o form do objeto ser mostrado 500 pixels abaixo do

topo da pgina e 600 pixels esquerda na execuo.
6.9. FILLSTYLE
(Tipos de controle: Retngulo)
Determina a sombra utilizada para preenchimento do retngulo.
Valores:
0
Solid
1
Transparente
2
Linha Horizontal
3
Linha Vertical
4
Upward Diagonal
5
Downward Diagonal
6
Cruzado
7
Cruzado em Diagonal
Exemplo:
textframe.FillStyle = 2;
Neste exemplo o retngulo cujo nome nome textframe ser exibido
assim:
TEXTO
6.10. FILLCOLOR
(Tipos de controle: Retngulo)
Determina a cor usada para preenchimento do retngulo. Um valor
numrico representado um RGB color value deve ser assinalado. O Fill check
box no dilogo de propriedades do controle retngulo tambm deve ser
assinalado.
Exemplo:
textframe.FillColor = rgb(255,255,0);
6.11. DEFAULT
(Tipos de controle: Boto)
53
utilizado para especificar qual o boto de comando default.

Valores:
0: Falso
1: Verdadeiro
Somente um boto de comando no form pode ser default. Quando um
boto de comando setado como verdadeiro, automaticamente todos os demais
botes no form sero setados como Falso.
6.12. BITMAP
(Tipos de controle: Boto e Bitmap)
usada para mostrar o bitmap assinalado no path.
Exemplos: 1) EventBtn.Bitmap = loadbitmap(c:\mypath\mypict.bmp)
2) &bmp = c:\mypath\mypict.bmp;
EventBtn.Bitmap = loadbitmap(&bmp);
Nestes exemplo o bitmap gravado em c:\mypath\mypict.bmp ser
mostrado sobre o boto EventBtn.
6.13. BACKSTYLE
(Tipos de controle: Texto)
Determina se um rtulo ou fundo de um objeto transparente ou opaco.
Valores:
0: Transparente cor de fundo e qualquer grfico so visveis atrs do
controle.
1: Opaco (Default) a cor de fundo do controle preenche o controle e
oculta qualquer cor ou grfico atrs dele.
6.14. FONTNAME
(Tipos de controle: Button, Edit, Check box, Radio Button, Combo Box, Dynamic
Combo Box, Subfile, Column)
Determina a fonte usada para mostrar o texto num controle. Voc deve
assinalar uma expresso tipo string especificando o fontname a ser usado.
Exemplo: EvtBtn.fontName = Times New Roman
Onde EvtBtn o nome do controle de um boto.
54
Em geral, voc deve mudar FontName antes de setar o tamanho e estilo

dos atributos com as propriedades FontSize, FontBold, FontItalic,
FontStrikethru e FontUnderline.
6.15. FONTITALIC, FONTUNDERLINE, FONTBOLD,

FONTSTRIKETHRU
(Tipos de controle: Button, Edit, Check Box, Radio Button, combo Box, Dynamic
Determina o estilo da fonte nos seguintes formatos: FontItalic,
FontUnderline, FontBold, FontStrikethru.
Valores:
1: (Verdadeiro)
Ativa a formatao no estilo escolhido.
2: (Falso)
Desativa a formatao no estilo escolhido.
Exemplo:
subcol1.FontItalic = 1 (onde subcoll o nome de uma coluna
do subfile)
6.16. FONTSIZE
(Tipos de controle: Button, Edit, Check Box, Radio Button, Combo Box, Dynamic
Determina o tamanho da fonte a ser usado para mostrar o texto no
controle.
Exemplo:
EvtBtn.fontSize = 20
Onde EvtBtn o nome de um controle boto e 20 o tamanho utilizado
para a font default (ou para a fonte setada na propriedade FontName).
6.17. WIDTH, HEIGHT

(Tipos de controle: Button, Edit, Check Box, Radio Button, Combo Box, Dynamic
Combo Box, Subfile, Frame, Text)
Determina a largura e altura respectivamente do controle. Um valor
numrico deve ser assinalado.
NOTA: A unidade de escala para medir largura e altura em Visual Basic
TWIPS (aproximadamente 1/15 pixel) que a unidade padro do VB.
55
Em verses futuras deste gerador, a unidade de escala ser pixels.

A unidade de escala para medir largura e altura em Visual FoxPro
pixels.
Exemplo:
foto.Width = 200 (foto um controle tipo bitmap)
Foto.Height = 200
A dimenso deste controle tipo bitmap ser 200 x 200 unidades.
6.18. TITLE
(Tipos de controle: Column)
Determina o ttulo das colunas do subfile em tempo de execuo. Uma
string de caracteres deve ser informada.
Exemplo:
subfcol1.Title = Descrio;
6.19. WINDOWSTATE
(Tipos de controle: Frame)
Determina o estado visual de um form em tempo de execuo.
Valores:
0: Normal.
1: Minimizado (diminui para um cone).
2: Maximizado (aumenta para o estado mximo).
Exemplo:
Form.WindowState = 2;
Neste exemplo o form ser maximizado (embora o usurio possa
manualmente mudar o tamanho do form durante a execuo)
6.20. LINESELECTOR
(Tipos de controle: Subfile)
Esta propriedade indica se o subfile possui a borda esquerda.
Valores:
0: Falso.
O subfile NO ter a borda esquerda.
1: Verdadeiro.
O subfile ter a borda esquerda.
56
6.21. REDRAW
Esta propriedade indica se o subfile ser redesenhado.
Valores:
1: Verdadeiro.
O subfile ser redesenhado.
2: Falso.
O subfile no ser redesenhado.
Exemplo:
subfile.Redraw = 0;
subfale.FontName = Small Fonts;
subfcol1.Title = Name;
subfcol2.Title = Address;
subfcol2.FontItalic = 1;
subfile.Redraw = 1;
Neste exemplo, todas as alteraes no subfile so executadas antes
(nome das colunas, fontes, etc) e ento o subfile redesenhado. Isto feito
somente para melhorar performance.
6.22. TITLEFORECOLOR, TITLEBACKCOLOR

(Tipos de controle: Column)
Determina a cor de frente e de fundo respectivamente, do ttulo de uma
coluna do subfile.
Um valor numrico representando uma RGB color value deve ser
informado.
Exemplo:
subfcol1.TitleForeColor = rgb(0 ,255 ,0 );
Isto mudar a cor de frente do ttulo da coluna para verde.
Exemplo:
subfcol1.TitleBackColor = rgb(0 ,255 ,0);
Isto mudar a cor de fundo do ttulo da coluna para verde.
6.23. TAG
Esta propriedade usada para assinalar uma string de identificao ao
controle (sem afetar nenhuma das outras propriedades setadas). Esta
propriedade muito til quando voc precisa checar a identificao do
controle. Uma string de caracteres deve ser informada.
57
Exemplo:
CrtlName.tag = associated text
6.24. BORDERSTYLE
Determina o estilo de borda de um subfile.
Valores:
0: None (Sem borda)
1: Fixed Single (borda simples e sem alterao de tamanho).
2: Sizable (Este o valor default).
3: Fixed Double (Borda 3D e sem alterao de tamanho).
Exemplo:
subfile.BorderStyle = 0;
Neste exemplo o subfile no ter borda.
7. Eventos de Controle
7.1. DBCLICK
(Tipos de controle: Bitmap, Text, Edit)
Ocorre quando o usurio pressiona o boto esquerdo do mouse duas
vezes sobre um mesmo controle. Para um Form, o evento DblClick ocorre
quando o usurio d um duplo clique sobre um controle desabilitado ou uma rea
em branco do Form. Para um controle, isto ocorre quando o usurio d um duplo
clique sobre um controle com o boto esquerdo do mouse.
Exemplo:
Event foto.DblClick
Call(wShowcli, CliCode)
Endevent
Neste exemplo quando o usurio clicar duplamente sobre o bitmap que
contm a foto do cliente, uma Work panel, que mostra as informaes do
cliente, chamada.
7.2. CLICK
(Tipos de controle: Bitmap, Column, Text, Radio Button, Check Box, Dynamic
Combo Box, Combo Box, Edit)
58
Ocorre quando o usurio clica o boto esquerdo do mouse sobre o

controle.
Exemplo:
Event text.Click
Msg(Explained text: .............)
Endevent
Neste exemplo uma mensagem ser exibida quando o usurio clicar sobre
o controle tipo texto chamado text.
7.3. ISVALID
(Tipos de controle: Radio Button, Check Box, Dynamic Combo Box, Combo Box,
Edit)
Ocorre quando a entrada do campo vlida.
Exemplo:
Event CliCode.IsValid
Call(TclientInfo,CliCode)
EndEvent
Neste exemplo quando o usurio informar o cdigo do cliente, outra
transao para digitar as informaes da cliente chamada se o cdigo do
cliente digitado for vlido.
7.4. RIGHTBUTTON
(Tipos de controle: Edit)
Ocorre quando o boto da direita do mouse pressionado sobre o
controle.
Exemplo:
Event CliCode.RightButton
Msg(Enter client code, value range: 1-100)
Endevent
Neste exemplo o boto direito usado para mostrar um texto
explicativo.
59
8. Mtodos
Importante: MTODOS somente funcionam em Visual Basic e Visual
Foxpro, os demais geradores iro ignor-los, com exceo do Mtodo SetFocus
que foi implementado em todos os geradores.
8.1. SETFOCUS
(Tipos de controle: Edit, Check Box, Radio Button, Combo Box, Dynamic Combo
Box, Button, Subfile, Frame)
Direciona a entrada de dados a um controle especfico.
Exemplo:
Event GetClient
Call( PgetCli, CliCode, CliName)
SupCod.Setfocus()
EndEvent
Suponha que tenhamos um boto no Form que chama um procedimento
para obter o nome do cliente indicado no cdigo e ns queremos direcionar a
entrada de dados (posicionar o cursor) no atributo SupCode depois do call.
Isto pode ser feito usando o mtodo setfocus com o atributo SupCode dentro
do evento associado ao boto, como mostrado acima.
8.2. REPAINT
(Tipos de controle: Edit, Check Box, Radio Button, Combo Box, Dynamic Combo
Box, Text, Retngulo)
Este mtodo muda as propriedades do controle.
Exemplo:
Este mtodo usado para repintar o controle se qualquer das suas
propriedades foi modificada, por exemplo cor, fonte, tamanho, etc, e voc quer
mostrar as mudanas.
PoNbr.FontBold = 1
PoNbr.Repaint( )
8.3. CLEAR, ADDITEM

(Tipos de controle: Combo Box e Dynamic Combo Box)
60
Clear: Apaga todos os itens de um Combo Box ou Dynamic Combo Box.

AddItem: Adiciona um novo tem no fim de um Combo Box ou Dynamic
Combo Box.
Sintaxe: controle.additem(cdigo, descrio[ ,ndice])
ndice opcional e representa a posio onde o item inserido.
Se nenhum ndice especificado o tem adicionado no fim.
Exemplo: Vamos apagar o contedo de um Combo Box antes de adicionar
novos itens da tabela e carreg-lo com todos os pases do continente
Americano, o primeiro item ser All .
&Var.clear( )
&Var.additem(0, All)
for each
Where continentCod = AME
&Var.additem(CountryCod,CountryName)
EndFor
8.4. REMOVEITEM
(Tipos de controle: Combo Box e Dynamic Combo Box)
Apaga o item, cujo cdigo indicado pelo cdigo, de um combo Box ou
Dynamic Combo Box.
Sintaxe: control.removeitem(code)
Remove o primeiro code que for encontrado.
8.5. LOAD
Carrega uma nova linha ao subfile de Work Panels e Web Panels. Este
mtodo o mesmo que o comando Load. Deve ser utilizado dentro do evento
Load como no exemplo:
Event Load
For each InvCode
&InvCode = InvCode
&InvDat = InvDate
&Type = INV
61
.....
sfl_1.Load( )
Endfor
EndEvent
Este mtodo muito til quando voc tem mais de um subfile no form
(esta feature ser liberada em verses futuras). Neste caso voc especifica
para qual subfile a linha deve ser carregada.
sfl_1.Load( ) or sfl_2.Load( )
8.6. SORT
Ordena o subfile pelo atributo especificado.
Exemplo:
sfl_1.Sort(PrdName)
Onde: PrdName um atributo do subfile. O subfile ser ordenado ento
por PrdName, sem a criao de um ndice temporrio, se no existir nenhum
ndice ordenado pelo atributo escolhido (esta a diferena entre o mtodo
SORT e a regra ORDER)
8.7. PRINTFORM
(Tipos de controle: Frame)
Imprime a janela da Work Panel ou transao na impressora default.
Exemplo:
Event Print
Form.printform( )
EndEvent
Este evento pode ser associado a um boto e imprime a janela corrente.
NOTA: Este mtodo no est implementado em Visual Foxpro.
8.8. REFRESH
(Tipos de controle: Frame e Subfile)
Atualiza os valores no subfile ou form.
62
Este mtodo muito til se voc tem mais de um subfile no form (esta
feature ser liberada em verses futuras). Neste caso voc pode especificar
qual subfile voc quer realizar o refresh:
Sfl_1.Refresh( ) or sfl_2.Refresh( )
Tambm pode ser utilizado para atualizar valores de qualquer atributo.
9. Propriedades do Modelo Principal

9.1. PREFERNCIAS
Estas preferncias so definidas para a Base de Conhecimento, em
outras palavras, so vlidas para todos os modelos.
Modo de uso:
Posicione o cursor sobre a propriedade que voc deseja editar, e
selecione a opo desejada no Combo Box no topo da tela.
No canto superior esquerdo do editor de propriedades, h 3 botes
usados para salvar ou cancelar as modificaes e assinalar o valor default.
NOTA: Sempre use o boto para assinalar o valor default, no tecle o
caractere *.
MAXIMUN NUMERIC LENGHT

Por default, GeneXus controla a maioria das suas limitaes, tornando o
trabalho em diferentes plataformas vivel partir de uma nica definio, mas
possvel mudar estes controles.
Esta preferncia usada para especificar o tamanho mximo de um
campo numrico.
Valores: O valor default desta preferncia 18, mas pode ser alterado
para qualquer valor entre 4 e 30.
NOTA:
Valores maiores que 18 somente so suportados pelo gerador RPG.
63
Atributos e variveis no so verificados quando este valor

modificado para um valor menor que 18, assim, recomendvel
verificar se o novo valor correto.
FUNCTIONS
Esta preferncia usada quando voc deseja utilizar funes que no
so explicitamente suportadas pelo GeneXus.
Esta preferncia somente vlida quando os objetos so salvados. (Essa
preferncia nos modelos de prototipao e produo ser validada na
especificao).
Assim, voc poder salvar um objeto que utilize uma funo no standard
se esta preferncia no modelo de design estiver setada como Allow standard
functions only.
Valores:
Allows standard functions only on saving: (Permite somente funes
standard) Somente funes standard suportadas pelo GeneXus
podem ser utilizadas.
Allows non-standard functionsnon saving: (Permite funes nostandard) Funes so documentadas pelo GeneXus podem ser
utilizadas.
Valor default: Allows standard functions only on saving.
TIME FORMAT
Controla o formato no qual a parte das horas dos atributos tipo Date
Time so pedidos e mostrados (tanto na tela quanto na impresso). Tambm
controla o tamanho dos atributos/variveis do tipo Date Time.
Esta preferncia definida na Base de Conhecimento (design) mas, cada
modelo pode ter um valor diferente para a mesma.
Valores:
Language dependent: depende da linguagem selecionada de acordo
com a tabela seguinte:
Linguagem
Formato da Hora
Ingls
12 horas
Espanhol
24 horas
Portugus
24 horas
64
Italiano
24 horas
Valor default: depende da linguagem.
NOTA: Se o uso do formato 12 Horas especificado ou inferido, de
acordo com a linguagem selecionada, os campos tero 3 caracteres a mais (tela
ou impressora) correspondendo s strings AM ou PM.
9.2. GERADORES
Neste dilogo voc pode definir todos os tipos de geradores que voc
usar nos modelos para gerar seus programas.
Escolha o boto New Type para adicionar um tipo novo, voc deve definir
um nome para o novo tipo de gerador. Todos os tipos de geradores definidos
aqui iro aparecer na lista de geradores possveis (Generators Tab) em cada
modelo da Base de Conhecimento. Ento em cada modelo voc assinalar um
gerador em particular (ex.: Visual Basic, RPG, etc.).
H 2 tipos de geradores pr-definidos: Default (usado como default na
gerao dos programas) e Reorg (usado para reorganizao das base de dados)
cujos nomes no podem ser mudados.
Tecle o boto Delete Type para apagar o tipo de gerador selecionado. Se
o tipo de gerador selecionado estiver sendo usado em qualquer modelo voc no
ser capaz de apag-lo (uma mensagem de erro ser mostrada).
9.3. MODEL FORMS

Voc pode definir mais de uma tela para projetos que utilizem forms
(Transao/Work Panels). Na especificao voc pode escolher um dos forms
definidos, dependendo do modelo. Cada modelo tem uma lista de Form Classes
vlidas.
A lista do lado esquerdo inclui todas as forms classes existentes na Base
de Conhecimento, com os botes de Add e Remove voc pode selecionar quais
forms ir utilizar no modelo corrente.
H duas forms classes pr-definidas: G Grfica e T Texto.
Estas no podem ser apagadas ou renomeadas. A lista do lado direito
especfica para cada modelo.
65
9.4. PROMPTS
Aqui voc pode setar as opes de prompts para o modelo principal
(Design), as opes especificadas aqui podem ser utilizadas nos outros
modelos.
Se voc selecionar boto Default Settings, nenhum efeito especial ser
usado.
Selecionando o boto Design Model Settings, voc poder especificar um
efeito par aos prompts no modelo corrente.
Button Prompt: O atributo aparecer com uma seta para cima ao lado
do mesmo.
Colored Prompt: O atributo aparecer com uma cor diferente. Se
voc escolher esta opo, a cor especificada aqui ter preferncia
sobre qualquer cor especificada para este atributo em qualquer form.
Outros Modelos
Voc pode setar a opo de prompt. Aqui voc indicar como os atributos
para os quais GeneXus gera prompts, devero aparecer nos Forms.
A opo especificada aqui somente ter validade para os atributos
definidos como EDIT.
Se voc selecionar Design Model Settings, o que foi setado no modelo de
design ser utilizado no modelo corrente.
Button Prompt: O atributo aparecer com uma seta para cima ao lado
do mesmo.
Colored Prompt: O atributo aparecer com uma cor diferente. Se
voc escolher esta opo, a cor especificada aqui ter preferncia
sobre qualquer cor especificada para este atributo em qualquer form.
66
10. Propriedades das Transaes

10.1. TRANSACTION INTEGRITY INTEGRIDADE
TRANSACIONAL
COMMIT ON EXIT
Programas gerados pelo GeneXus executam commits no fim de cada
transao (referenciando-se ao conceito database transaction, no ao objeto
GeneXus). Este commit automtico includo em todos os programas que
atualizam base de dados. No includo em Reports, Work Panels, Web Panels
e procedimentos que no atualizam base de dados.
Esta propriedade usada para controlar ou no se o commmit
automtico realizado.
Esta propriedade faz sentido em Transaes e Procedures que alteram
a bse de dados e so chamados por outros programas. Neste caso, o programa
chamador (ou programa chamador do chamador) responsvel pelo commit ou
rollback da LW (Logical Work Unit).
Valores:
YES o programa gerado executa um commit no fim da LWU.
NO o programa gerado no executa um commit no fim da LWU.
O valor default depende do gerador selecionado.
Exemplo: Voc pode encontrar a situao de ter que dividir uma
transao em duas. Um exemplo tpico descrito no exemplo que segue. Muitos
dados devem ser digitados na Transao de cadastramento de funcionrio,
assim necessitamos dividir a mesma em duas: dados do empregado e dados da
funo. Para ter as duas transaes funcionando em conjunto, ns colocamos no
final da primeira transao, um CALL para a segunda TRN.
TRN: Funcionrio
TRN: Funo
................................
...............................
................................
...............................
CALL Tfuno
...............................
................................
................................
Commit
67
Commit on Exit = YES

Commit on Exit = NO
O que mostra o exemplo acima que uma vez dado entrada nos dados na
primeira transao, ns iremos imediatamente dar entrada nos dados da
segunda TRN. Mas ns queremos unificar as duas TRNs para que formem uma
nica LWU (Unidade Lgica de Trabalho), para fazer isso necessrio:
A primeira transao deve ter uma CALL chamando a segunda, antes que o
commit seja executado.
Remover o COMMIT da segunda TRN usando a propriedade Commit on
Exit = NO para que o COMMMIT da primeira TRN faa o COMMMIT em
ambas como um todo aps o retorno do CALL.
NOTA:
- vlido somente em transaes que no tenham a propriedade do
AS/400 Commitment = Disabled neste caso a propriedade ser
ignorada.
- Tambm ser ignorada se o controle da integridade transacional for
desabilitada nas propriedades do modelo Transactional Integrity =
NO. Esta propriedade somente aparecer se o gerador que voc
estiver usando permitir este tipo de controle. (Foxpro for Windows
no mostrar esta opo).
CONFIRM TRANSACTION
Fora a confirmao da transao permitindo COMMIT ou ROLLBACK.
Valores:
YES Fora uma confirmao a nvel de LWU (Unidade Lgica de
Trabalho) ou transao. Neste caso, o usurio pode confirmar
(COMMIT) ou no (ROLLBACK) as alteraes feitas na base de dados
durante a LWU.
NO Nenhuma confirmao da LWU pedida e automaticamente
executado o comando COMMIT.
O valor default depende do gerador.
NOTA:
vlido somente em transaes que no possuam nem a propriedade
Commit on Exit = YES nem Commitment = Disabled. No caso de
qualquer uma delas existir, a propriedade Confirm Transactions =
YES ser ignorada.
68
Tambm ser ignorada se o controle da integridade transacional for

desabilitado nas propriedades do modelo Transactional Integrity
= NO.
10.2. USER INTERFACE INTERFACE COM USURIO
CONFIRMATION
Indica se o usurio deseja ou no que a confirmao seja pedida ao
passar de um nvel para outro. Ao passar de um nvel para o prximo, uma
mensagem mostrada e o usurio deve confirmar a entrada de dados.
Valores:
Always prompt: mostrar uma mensagem e pedir confirmao das
alteraes em todos os nveis.
Never prompt: nenhuma confirmao pedida em nenhum nvel da
transao.
Do not prompt on first level: pedir confirmao em todos os nveis
da transao, com exceo do primeiro nvel.
NOTA: A regra Noconfirm(<Atributo>) permite a voc indicar um nvel
especfico que no deve ser pedido confirmao.
WINDOWS INTERFACE
MenuBar
Esta propriedade usada para associar um menubar a um objeto. Em

outras palavras, o objeto usar o menubar indicado nesta propriedade. O
Combo mostrar todos os menubars existentes.
Se um objeto no tiver um menubar associado, ento um menubar
default ser utilizado.
Esta propriedade vlida somente para Transaes e Work Panels.
Border Style
Esta propriedade especifica o tipo da borda do form. Vlida somente

para os geradores: Visual Basic e Visual Foxpro.
69
Valores:
- Sizeable: este o tipo normal de borda, que : 3D e voc pode mudar
o tamanho da janela com o mouse.
- None: a janela no ter borda nem ttulo.
- Fixed Single: a janela ter borda simples e seu tamanho no poder
ser mudado.
- Fixed Dialog: a janela ter borda 3D e seu tamanho no poder ser
mudado.
O valor default Sizeable.
Maximize Button
Especifica se o form deve ter um boto de maximizao. Vlido somente

para geradores: Visual Basic e Visual Foxpro.
Valores:
- YES: o form ter boto de maximizao
- NO: o form no ter boto de maximizao
O valor default YES.
Minimize Button
Especifica se o form deve ter um boto de minimizao. Vlido somente

Valores:
- YES: o form ter boto de minimizao
- NO: o form no ter boto de minimizao
Form Icon
Esta propriedade utilizada para especificar um nome para o cone do

form. Vlido somente para geradores: Visual Basic e Visual Foxpro.
Valores: No possui nenhum valor pr-definido, voc deve informar o nome do
cone.
Control Box
Esta propriedade usada para especificar se o menu no canto superior

esquerdo da janela ser ativado com um click do mouse.
70
Valores:
- YES: o menu ser ativado com um click do mouse.
- NO: o menu no ser ativado com um click do mouse.
Modal Dialog
Esta propriedade usada para indicar se o objeto utiliza dilogo Modal

ou no.
Dilogo Modal significa que o programa chamador ficar inativo at que o
objeto chamado seja fechado. Ao contrrio, o dilogo No-Modal ambos os
objetos ficam ativos ao mesmo tempo, quer dizer, voc pode trabalhar com
ambos simultaneamente.
Dilogo No-Modal sempre melhor que dilogo modal, mas nem sempre
possvel utiliz-lo. Em particular, quando so passados parmetros e o objeto
chamado retorna valores ao objeto chamador, ento o dilogo Modal deve ser
usado. Os prompts so um exemplo tpico desse tipo de dilogo, onde a
transao espera valores retornados pelo prompt.
Valores:
- YES, if parameters specified: Se o objeto tem parmetros ento o
dilogo Modal ser usado, se no houver parmetros ento o dilogo
No-modal ser usado.
- YES: Dilogo Modal utilizado.
- NO: Dilogo No-Modal utilizado.
O valor default : YES, if parameters specified.
CHARACTER INTERFACE INTERFACE DE CARACTERES
Generate as a Popup Window
Esta propriedade usada para indicar que o form deve ser carregado
como uma janela de Poupup (sobrepor a janela anterior ao invs de
substitu-la). Neste caso, parte das duas janelas podem ser vistas
simultaneamente.
Valores:
- NO: A janela mostrada totalmente como poup-up.
- YES, automatic border: O form ser gerado como janela popup e a
borda ser desenhada de forma automtica.
71
YES, user defined border: O form ser gerado como janela popup e a
borda pode ser desenhada pelo usurio no form. Este valor s vlido
para geradores de interface grfica.
NOTA: Quando a tela definida como popup, h algumas limitaes de
linhas e colunas que devem ser respeitados. Se a tela desenhada ultrapassa
esses limites, uma mensagem dada dentro do relatrio de navegao na
especificao.
IMPORTANTE: Esta propriedade no vlida para gerao em ambiente
windows.
-
Automatic Border Color
Esta propriedade usada para controlar a cor da borda da janela dos

objetos definidos como janelas popup no AS/400.
Valores:
- Default to color rule: Segue a cor da regra color se a mesma existir.
Caso contrrio, VERDE utilizado.
- Verde
- Branco
- Vermelho
- Amarelo
- Azul
- Cinza, esta a cor no GeneXus. No AS/400 convertido para
Turquesa.
- Magenta, esta a cor no GeneXus. No AS/400 convertido para Pink
(rosa).
O valor default : Default to color rule.
Automatic Border Display Attribute
Esta propriedade usada para definir como deve ser mostrado o

atributo dos objetos definidos como janelas popup no AS/400.
Valores:
- Reverse Image: Imagem reversa
- High: Mostrar mais forte (negrito)
- Blinking: Piscando
- No display: No mostrar.
O default : Default to color rule.
72
Automatic Border Characters
Esta propriedade usada para definir os caracteres a serem usados

para cada um dos cantos e lados da janela do objeto definido como janela
popup no AS/400. Deve ter exatamente 8 caracteres. Cada caracter usado
para desenhar (em ordem):
Caracter
Desenha
1
topo-esquerdo-canto
2
topo-borda
3
toopo-direito-canto
4
esquerda-borda
5
direita-borda
6
Boto-esquerdo-canto
7
Boto-borda
8
Bpto-dirieito-canto
Estes caracteres so enviados diretamente palavra chave
WDWBORDER da DDS language para telas. Para obter informaes adicionais
sobre esta palavra chave, procure no manual de referncia da DDS.
No h valor default para esta preferncia. Isto , se nenhum valor for
especificado na preferncia, os atributos de tela dependero dos valores
default do AS/400.
NOTA: No use o caracter (apstrofo) nesta propriedade.
10.3. AS/400 SPECIFIC ESPECIFICAES AS/400

COMMITMENT
Habilita e desabilita o controle da integridade transacional nos
programas gerados.
Valores:
- Enabled: O programa gerado COM os controles de integridade
transacional.
- Disabled: O programa gerado SEM os controles de integridade
transacional.
73
NOTA: Esta opo ignorada para Client Server (geradores DB/2 e

Oracle).
Esses DBMs no permitem a desativao da integridade transacional.
KEY ASSIGNMENT
Exit Key
Esta propriedade usada para alterar a chave de funo relacionada ao
Exit.
Valores: Qualquer nmero de chave de funo vlida.
O valor default 3.
Prompt Key

Prompt. Esta propriedade aplica-se somente ao objeto. Esta funo pode
inclusive ser desabilitada assinalando-se mesma o valor 0. Se for
desabilitada, o programa no responde s prompts key e os programas de
prompt no sero gerados.
O valor default 4.
NOTA: Apesar de aceitar 1 como valor vlido, o gerador ignora-o.
Refresh Key

Refresh.
O valor default 5.
Insert Mode

Insert Mode. Esta propriedade aplica-se somente ao objeto. Esta funo pode
inclusive ser desabilitada assinalando-se mesma o valor default 0, neste
caso, no ser possvel alterar para Modo de Insero na transao. O cdigo
para insero de registros gerado.
74

O valor default 6.
Previous Record

Previous Record. Esta propriedade aplica-se somente ao objeto. Esta funo
pode inclusive ser desabilitada assinalando-se mesma o valor default 0,
neste caso, no ser possvel mover-se ao registro anterior e o cdigo
correspondente no gerado.
O valor default 7.
Next Record

Next Record. Esta propriedade aplica-se somente ao objeto. Esta funo pode
caso, no ser possvel mover-se ao prximo registro e o cdigo
correspondente no gerado.
O valor default 8.
Retrieve

Retrieve. Esta propriedade aplica-se somente ao objeto. Retrieve no pode ser
desabilitada porque aplica-se somente em Menus.
O valor default 9.
Menu

acesso ao Menu Bar. Esta propriedade aplica-se somente ao objeto. Esta
funo pode inclusive ser desabilitada assinalando-se mesma o valor default
0, neste caso, no ser possvel acessar o menu bar e o cdigo correspondente
no gerado.
75
O valor default 10.
Update Mode

Modo de Update. Esta propriedade aplica-se somente ao objeto. Esta funo
pode inclusive ser desabilitada assinalando-se mesma o valor default O,
neste caso, no ser possvel alterar para Update na transao e o cdigo de
alterao gerado.
O valor default 11.
Cancel

Cancel.
O valor default 12.
Delete Mode

Modo Delete. Esta propriedade aplica-se somente ao objeto. Esta funo pode
inclusive ser desabilitada assinalando-se mesma o valor 0, neste caso, no
ser possvel alterar o modo para Deleo na transao e o cdigo de alterao
gerado.
O valor default 13.
Select

Select. Esta propriedade aplica-se somente ao objeto. Esta funo pode
caso, o programa no responder chave de autoprompt e o cdigo de
Autoprompt no gerado.
O valor default 16.
76
First Record

First Record. Esta propriedade aplica-se somente ao objeto. Esta funo pode
caso, no ser possvel acessar o primeiro registro e o cdigo correspondente
no gerado.
O valor default 19.
Display Mode

Modo de Display. Esta propriedade aplica-se somente ao objeto. Esta funo
pode inclusive ser desabilitada assinalando-se mesma o valor default 0,
neste caso, no ser possvel alterar para modo de Display na transao e o
cdigo correspondente gerado.
O valor default 14.
More Keys

More Keys.
O valor default 24.
77
11. Propriedades das Work Panels

Propriedades permitem definir funes gerais para o objeto.
Propriedades das Work Panel incluem duas principais caractersticas: funes
enquanto estiver fazendo a carga e como ser a interface.
11.1. LOADING
LOAD RECORDS
Indica como os registros so carregados no subfile. Normalmente, o
subfile carregado mediante uma requisio explcita.
Inicialmente, somente a primeira tela carregada e, conforme o usurio
avana, ento outras telas so carregadas. Isto feito para ganhar
performance. Mas em alguns casos, ns poderemos necessitar carregar o
subfile inteiro de uma vez. Para fazer isto, devemos setar a propriedade Load
Records como Load All Records. Esta propriedade indica que o subfile ser
carregado por inteiro de uma nica vez.
Valores:
- Load on request carrega os registros na tela de subfile cada vez
que dados so requeridos.
- Load all records carrega todos os registros no subfile no Evento
Load.
LOAD AT STARTUP
Indica se o subfile carregado logo no incio ou aps pedir a parte fixa
do form. Quando a Work Panel tem um subfile, o subfile carregado pela
primeira vez imediatamente aps a tela ser carregada. Esta propriedade indica
que ns no desejamos que o subfile seja carregado logo no incio, ao invs
disso, ns queremos que a parte fixa da tela seja pedida antes (normalmente
usadas nas conditions) e ento carregar o subfile.
Valores:
- YES o subfile carregado imediatamente aps a carga da tela.
- NO o subfile carregado aps pedir a parte fixa da tela.
78

RESTRIES: Quando no h Tabela Base associada Work Panel, essa
propriedade no tem efeito, e o subfile carregado aps pedir a parte fixa ser
pedida.
ALLOW USER TO CANCEL WHILE LOADING

Permite ou inibe o usurio de cancelar a execuo do programa enquanto
estiver sendo feita a carga do subfile. Se esta propriedade for setada como
YES, a Work Panel poder ser cancelada com ESC.
Valores:
- YES o programa pode ser cancelado pressionando ESC enquanto
estiver sendo feita a carga do subfile.
- NO o programa no pode ser cancelado enquanto estiver sendo
feita a carga do subfile.
AUTOMATIC REFRESH
Esta propriedade muito utilizada quando o subfile composto somente
por variveis e voc deseja executar um refresh cada vez que houver uma
mudana na parte fixa da Work Panel.
Valores:
- Only when variables in conditions change: a work panel trabalha da
forma tradicioanl.
- When any variable change: o refresh executado cada vez que
qualquer varivel da parte fixa da tela modificado.
REFRESH TIMEOUT (Foxpro for Windows e Visual Basic)

Esta propriedade usada para executar um refresh do subfile sem que o
usurio execute nenhuma opo durante certo perodo de tempo. Este intervalo
de tempo deve ser especificado em segundos.
Valores: No h valores pr-definidos. Um valor em segundos deve ser
especificado. Se 0 ou default so especificados nenhum timeout ser gerado.
79
11.2. WINDOWS INTERFACE
MENUBAR
Esta propriedade usada para associar um menubar a um objeto. Em
outras palavras, o objeto usar o menubar indicado nesta propriedade. O
combo mostrar todos os menubars existentes. Se um objeto no tiver um
menubar associado ento um menubar default ser utilizado. Esta propriedade
somente vlida para transaes e work panels.
BORDER STYLE
Esta propriedade especifica o tipo da borda do form. Vlida somente
para os geradores: Visual Basic e Visual Foxpro.
Valores:
- Sizeable: este o tipo normal de borda, que 3D e voc pode mudar
o tamanho da janela com o mouse.
- None: a janela no ter borda nem ttulo.
- Fixed Single: a janela ter borda simples e seu tamanho no poder
ser mudado.
- Fixed Dialog: a janela ter borda 3D e seu tamanho no poder ser
mudado.
O valor default Sizeable.
MAXIMIZE BUTTON
Especifica se o form deve ter um boto de maximizao. Vlido somente
Valores:
- YES: o form ter boto de maximizao
- NO: o form no ter boto de maximizao
80
MINIMIZE BUTTON
Especifica se o form deve ter um boto de minimizao. Vlido somente
Valores:
- YES: o form ter boto de minimizao
- NO: o form no ter boto de minimizao
FORM ICON
Esta propriedade utilizada para especificar um nome para o cone do
form. Vlido somente para geradores: Visual Basic e Visual Foxpro.
Valores: No possui nenhum valor pr-definido, voc deve informar o
nome do cone.
CONTROL BOX
Esta propriedade usada para especificar se o menu no canto superior
esquerdo da janela ser ativado com um click do mouse.
Valores:
- YES: o menu ser ativado com um click do mouse.
- NO: o menu no ser ativado com um click do mouse.
MODAL DIALOG
Esta propriedade usada para indicar se o objeto utiliza dilogo Modal
ou no.
Dilogo Modal significa que o programa chamador ficar inativo at que o
objeto chamado seja fechado. Ao contrrio, com dilogo No-Modal ambos os
objetos ficam ativos ao mesmo tempo, quer dizer, voc pode trabalhar com
ambos simultaneamente.
81
Dilogo No-Modal sempre melhor que o dilogo modal, mas nem

sempre possvel utiliz-lo. Em particular, quando so passados parmetros e o
objeto chamado retorna valores ao objeto chamador, ento o dilogo Modal
deve ser usado. Os Prompts so um exemplo tpico desse tipo de dilogo, onde
a transao espera valores retornados pelo prompt.
Valores:
- YES, if parameters specified: se o objeto tem parmetros ento o
dilogo Modal ser usado, se no houver parmetros ento o dilogo
No-Modal ser usado.
- YES: Dilogo Modal utilizado.
- NO: Dilogo No-Modal utilizado.
O valor default : YES, if parameters specified.
11.3. CHARACTER INTERFACE
GENERATE AS A POPUP WINDOW

Esta propriedade usada para indicar que o form deve ser carregado
como uma janela de Popup (sobrepor a janela anterior ao invs de substitu-la).
Neste caso, parte das duas janelas podem ser vistas simultaneamente.
Valores:
- NO: a janela mostrada totalmente como popup.
- YES, automatic border: o form ser gerado como janela popup e a
borda ser desenhada de forma automtica.
- YES, user defined border: o form ser gerado como janela popup e a
borda pode ser desenhada pelo usurio no form. Este valor s vlido
para geradores de interface grfica.
NOTA: Quando a tela definida como popup, h algumas limitaes de
linhas e colunas que devem ser respeitados. Se a tela desenhada ultrapassa
esses limites, uma mensagem dada dentro do relatrio de navegao na
especificao.
IMPORTANTE: Esta propriedade no vlida para gerao em ambiente
windows.
82
AUTOMATIC BORDER
Automatic Border Color
Esta propriedade usada para controlar a cor da borda da janela dos

objetos definidos como janelas popup no AS/400.
Valores:
Caso contrrio, VERDE utilizado.
- Verde
- Branco
- Vermelho
- Amarelo
- Azul
- Cinza, esta a cor no GeneXus. No AS/400 convertido para
Turquesa.
- Magenta, esta a cor no GeneXus. No AS/400 convertido para Pink
(rosa).
O valor default : Default to color rule.
Automatic Border Display Attribute
Esta propriedade usada para definir como deve ser mostrado o

atributo dos objetos definidos como janelas popup no AS/400.
Valores:
- Reverse Image: Imagem reversa
- High: Mostrar mais forte (negrito)
- Blinking: Piscando
- No display: No mostrar.
O default : Default to color rule.
Automatic Border Characters
Esta propriedade usada para definir os caracteres a serem usados

para cada um dos cantos e lados da janela do objeto definido como janela
popup no AS/400. Deve ter exatamente 8 caracteres. Cada caracter usado
para desenhar (em ordem):
Caracter
Desenha
83
1
topo-esquerdo-canto
2
topo-borda
3
topo-direito-canto
4
esquerda-borda
5
direita-borda
6
Boto-esquerdo-canto
7
Boto-borda
8
Boto-direito-canto
Esses caracteres so enviados diretamente palavra chave
WDWBORDER da DDS language para telas. Para obter informaes adicionais
sobre esta palavra chave, procure no manual de referncia da DDS.
No h valor default para esta preferncia. Isto , se nenhum valor for
especificado na preferncia, os atributos de tela dependero dos valores
default do AS/400.
NOTA: No use o caracter (apstrofo) nesta propriedade.
KEY ASSIGNMENT
Exit Key
Exit.
O valor default 3.
Refresh Key

Refresh.
O valor default 5.
84
Cancel

Cancel.
O valor default 12.
More keys
Esta propriedade usada para alterar a chave de funo relacionada

opo More Keys.
O valor default 24.
85
12. Propriedades dos Relatrios

12.1. OPTIONS
REPORT OUTPUT
Especifica a sada a ser utilizada para Report/Procedure.
Valores:
- Ask User: O usurio ser questionado para onde deseja enviar a sada
em tempo de execuo.
- Only to Screen: A sada enviada direto para tela.
- Only to Printer: A sada enviada direto para impressora.
O valor default depende da gerador selecionado.
PROMPT FOR CONFIRMATION

usado para evitar a confirmao usual que ocorre aps as funes ASK
(para pedir dados) de Report/Procedures.
Valores:
- YES Ao usurio pedido confirmao aps entrada de dados.
- NO Evita confirmao.
ALLOW USER TO CANCEL PROCESSING

Indica se o programa pode ser cancelado pela tecla ESC. Num relatrio
que imprime nota e chamado de uma transao, muito apropriado setar
esta propriedade como NO, para ter certeza que a nota ser sempre impressa.
Valores:
- YES possvel cancelar o programa.
- NO no possvel cancelar o programa.
86
FOOTER ON LAST PAGE

Esta propriedade usada para indicar se os rodaps definidos pelo
usurio devem ou no ser impressos na ltima pgina de um relatrio.
Valores:
- YES O rodap ser impresso em todas as pginas, inclusive na
ltima.
- NO O rodap no impresso na ltima pgina.
12.2. AS/400 SPECIFIC - ESPECIFICAES AS/400
KEY ASSIGNMENT
Exit Key
Exit.
O valor default 3.
Refresh Key

Refresh.
O valor default 5.
Cancel

Cancel.
O valor default 12.
87
More keys

opo More Keys.
O valor default 24.
88
13. Propriedades dos Procedimentos

13.1. OPTIONS
REPORT OUTPUT
Especifica a sada utilizada para Report/Procedure.
Valores:
- Ask User: O usurio ser questionado para onde deseja enviar a sada
em tempo de execuo.
- Only to Screen: A sada enviada direto para tela.
- Only to Printer: A sada enviada direto para impressora.
PROMPT FOR CONFIRMATION

usado para evitar a confirmao usual que ocorre aps as funes ASK
(para pedir dados) de Report/Procedures.
Valores:
- YES Ao usurio pedido confirmao aps entrada de dados.
- NO Evita confirmao.
ALLOW USER TO CANCEL PROCESSING

Indica se o programa pode ser cancelado pela tecla ESC. Num relatrio que
imprime nota e chamado de uma transao, muito apropriado setar esta
propriedade como NO, para ter certeza que a nota ser sempre impressa.
Valores:
- YES possvel cancelar o programa.
- NO no possvel cancelar o programa.
89
FOOTER ON LAST PAGE

Esta propriedade usada para indicar se os rodaps definidos pelo
usurio devem ou no ser impressos na ltima pgina de um relatrio.
Valores:
- YES O rodap ser impresso em todas as pginas, inclusive na
ltima.
- NO O rodap no impresso na ltima pgina.
13.2. TRANSACTION INTEGRITY INTEGRIDADE

TRANSACIONAL
COMMIT ON EXIT
Programas gerados pelo GeneXus executam commits no fim da cada
transao (referenciando-se ao conceito de database transaction, no ao
objeto GeneXus). Este commit automtico includo em todos os programas
que atualizam base de dados. No includo em Reports, Work Panels, Web
Panels e procedimentos que no atualizam a base de dados.
Esta propriedade usada para controlar ou no se o commit automtico
realizado.
Esta propriedade faz sentido em Transaes e Procedures que alteram a base
de dados e so chamados por outros programas. Neste caso, o programa
chamador (ou o programa chamador do chamador) responsvel pelo commit ou
rollback da LWU (Logical Work Unit).
Valores:
- YES o programa gerado executa um commit no fim da LWU.
- NO o programa gerado no executa um commit no fim da LWU.
Exemplo: Voc pode encontrar a situao de ter que dividir em duas. Um
exemplo tpico descrito no exemplo que segue: muitos dados devem ser
digitados na transao de cadastramento de funcionrio, assim necessitamos
dividir a mesma em duas: dados do empregado e dados da funo. Para ter as
90
duas transaes funcionando em conjunto, ns colocamos no final da primeira

transao, um CALL para a segunda TRN.
TRN: Funcionrio
.........................
.........................
CALL Tfuncao
.........................
.........................
Commit
TRN: Funo
.........................
.........................
.........................
Commit on Exit = YES
Commit on Exit = NO
O que mostra o exemplo acima que uma vez dado entrada nos dados na
primeira transao, ns iremos imediatamente dar entrada nos dados da
segunda TRN. Mas ns queremos unificar as duas TRNs para que formem uma
nica LWU (Unidade Lgica de Trabalho), para fazer isso necessrio:
- A primeira transao deve ter um CALL chamando a segunda, antes
que o commit seja executado.
- Remover o COMMIT da segunda TRN usando a propriedade Commit
on Exit = NO para que o COMMIT da primeira TRN faa o
COMMIT em ambas como um todo aps o retorno do CALL.
NOTA:
- vlido somente em transaes que no tenham a propriedade do
AS/400 Commitment = Disabled neste caso a propriedade ser
ignorada.
- Tambm ser ignorada se o controle da integridade transacional for
desabilitado nas propriedades do modelo Transactional Integrity =
NO. Esta propriedade somente aparecer se o gerador que voc
estiver usando permitir este tipo de controle. (Foxpro for Windows
no mostrar esta opo).
91
COMMITMENT
Inibe ou desabilita o controle da integridade transacional nos programas
gerados.
Valores:
- Enabled o programa gerado com controle de integridade
transacional.
- Disabled o programa gerado sem os controles de integridade
transacional.
NOTA: Esta opo ignorada para Client Server (geradores DB/2 e
Oracle) porque este DBMs no permitem a desativao da integridade
Transacional.
KEY ASSIGNMENT
Exit Key
Exit.
O valor default 3.
Refresh Key

Refresh.
O valor default 5.
Cancel

Cancel.
92
O valor default 12.
More keys

opo More Keys.
O valor default 24.
93
14. Propriedades das Web Panels

14.1. FOOTER
FOOTER IMAGE
(Ainda no implementado)
WEBMASTERS MAIL ADDRESS

Ainda no implementado)
94
15. Propriedades do Modelo Visual Basic

15.1. GENERAL
VISUAL BASIC VERSION

Use esta opo para setar a verso do gerador Visual Basic que ser
utilizado.
Valores:
- Visual Basic 4.0 (16 bits)
- Visual Basic 4.0 (32 bits)
- Visual Basic 5.0
O valor default Visual Basic 5.0.
GRID VERSION
O gerador Visual Basic utiliza DataGrid Sheridan (incluindo no produto Data
Widgets) para implementar o grid dos subfiles (NOTA: voc deve instalar
Sheridans Data Widgets para ser capaz de executar corretamente suas
aplicaes Visual Basic).
Esta preferncia usada para especificar a verso do produto que voc
est usando.
Valores:
- Sheridan DataGrid 2.0c
- Sheridan DataGrid 3.0
- O valor default : Sheridan DataGrid 2.0c
TARGET SYSTEM INTERFACE

Indica qual a verso de sistema no usurio final (destino). utilizada
para evitar problemas com a edio que acontece quando geramos Visual Basic
4.0 e executamos sob Windows 3.x.
Valores:
- Windows 95 a interface do sistema destino ser Windows95
95
Windows 3.x a interface do sistema destino ser Windows3.1 ou

Windows3.11
O valor default Windows95.
-
Caso 1: Se voc est desenvolvendo uma aplicao numa mquina

executando abaixo do Windows 3.11, e a interface do sistema destino
Windows 95, para evitar problemas com os controles de edio voc deve
fazer o seguinte:
1. Desenvolver a aplicao (durante a fase de prottipo) com esta
preferncia setada para Windows 3.x, para poder prototip-la.
2. Uma vez que a fase de prottipo tenha terminado, mude esta
preferncia Windows 95 e gere todos os programas novamente,
ento voc pode distribuir sua aplicao para seus clientes.
executando abaixo do Windows 95, e a interface do sistema destino
Windows 3.11, sete esta preferncia Windows 3.x, e teste a aplicao como
se estivesse no ambiente do cliente.
executando abaixo do Windows 95, e a interface do sistema destino
Windows 95, voc no ter nenhum problema.
executando abaixo do Windows 3.11, e a interface do sistema destino
Windows 3.11, voc no ter nenhum problema.
GENERATE MDI APPLICATION

Esta preferncia usada para indicar qual tipo de interface de
documento tero as aplicaes geradas: SDI (Single Document Interface
Interface de documentao simples) ou MDI (Multiple Document Interface
Interface de documentao mltipla).
Com SDI toda transao ou Work Panel ser uma janela independente
(esta a interface utilizada pela Microsoft Exchange). No caso do MDI, todo
objeto considerado child window da janela principal (esta a interface
utilizada pela Microsoft Word).
Valores:
- YES Aplicao MDI ser gerada
- NO Aplicao SDI ser gerada
96
NOTA: Se o valor dessa preferncia setada como NO (SDI), e mais

tarde modificada para YES (MDI) voc deve forar a gerao de todos os
programas.
ALLOW COLUMN RESIZING

Com esta opo voc pode permitir ao usurio mudar o tamanho das colunas do
subfile em tempo de execuo.
Valores:
- YES o usurio ser capaz de modificar o tamanho das colunas do
subfile a qualquer momento.
- NO o tamanho das colunas do subfile do programa gerado ser
especificado no desenho do mesmo e o usurio no ser capaz de
mud-los em tempo de execuo.
SKIP READ-ONLY COLUMNS

Esta preferncia usada para setar o comportamento da Tab Key em
subfiles ao gerar cdigo Visual Basic.
Valores:
- YES a Tab Key pula variveis e atributos read-only.
- NO a Tab Key passa por todos os campos, independente de serem
read-only ou no.
NOTA: Esta preferncia no afeta o comportamento do mouse, porque o
mouse pode ser posicionado em qualquer campo.
CONFIRM
Esta propriedade, baseada na sua escolha, vai estabelecer se voc
deseja confirmar as seguintes aes
- Insert, Delete e Update executadas a nvel de Transao.
- Confirm each action: o usurio ser questionado sobre
confirmao aps ter finalizado a entrada de dados nas aes de
97
Insero e Alterao ou selecionando o modo de deleo em algum

nvel da transao.
Do not confirm each action: o usurio NO ser questionado
sobre confirmao aps ter finalizado a entrada de dados nas
aes de Insero e Alterao ou selecionando o modo de deleo
em algum nvel da transao.
Entrada de parmetros em Reports e Procedures

- Confirm each action: aps a entrada de parmetros nas
Reports/Procedures, o usurio ser questionado sobre a
confirmao dos mesmos.
- Do not confirm each action: aps a entrada de parmetros nas
Reports/Procedures, o usurio NO ser questionado sobre a
confirmao dos mesmos.
O valor default Confirm each action.
NOTA; Voc pode sobrescrever esta propriedade num objeto em
particular alterando a propriedade Confirm para o objeto selecionado.
-
AUTOSKIP
Salto automtico para o prximo campo quando o corrente preenchido.
Por exemplo: quando o quarto dgito de um campo de 4 dgitos digitado,
feito um salto automtico para o prximo campo.
Opes:
- YES Salto automtico para o prximo campo quando o corrente
preenchido.
- NO Uma tecla de entrada deve ser pressionada para mover o cursor
para o prximo campo, quando o corrente preenchido.
O valor default NO.
LOCK TYPE
Esta preferncia controla o tipo de lock que ser executado pelo Visual
Basic no Access.
Valores:
- Pessimistic: o lock executado quando o registro lido.
98
Optimistic: o lock no executado quando o registro lido e sim

controla se ele foi modificado ou no por outro usurio na hora de
regrav-lo.
O valor default Pessimistic.
NOTA: Voc deve levar em considerao que o Access loca pginas e no
registros.
-
PSEUDO CONVERSATIONAL DIALOG

Com esta opo, voc pode escolher se a aplicao gerada ter Dilogo
Conversacional ou Dilogo Pseudo Conversacional para implementar o controle
de concorrncia.
Com o dilogo pseudo-conversacional ns tendemos a reduzir o tempo de
lock de registro ao mnimo, o que quer dizer que somente sero locados os
registros durante o process-time. Isto incrementa a concorrncia na base de
dados.
O conceito bsico ler sem locar, permitindo ao usurio fazer
alteraes e ento, em tempo de processamento, verificar se nenhum outro
usurio j alterou o mesmo registro. Se isto ocorrer, uma mensagem de erro
mostrada e o usurio de refazer a operao.
Valores:
- Use conversational dialog: implementa dilogo conversacional.
- Check updated tables only: implementa dilogo pseudoconversacional. Neste caso, o controle executado a nvel de tabela.
Se a tabela modificada dentro de um nvel, todos os atributos
daquela tabela que esto envolvidos na transao so controlados. O
problema dessa implementao aparece quando h usurios que
baseiam suas decises em tabelas no alteradas na transao.
- Check all acessed tables: implementa dilogo pseudo-conversacional.
Neste caso, o controle executado sobre todas as tabelas dos
atributos envolvidos na transao. Este parece ser o nvel de
controle mais indicado, pois situaes incontrolveis no existiro.
O valor default : Check updated tables only.
NOTA: Dependendo da linguagem e plataforma que voc est gerando, o
dilogo Pseudo conversacional implementado para todas as operaes
99
executadas na Transao (Cobol e RPG para AS/400) ou somente no nvel da

transao (nos casos dos Xbase ou Visual Basic).
LOCAL DATABASE FILE

Especifica o nome da base de dados local quando gerando Visual Basic.
Valores: O nome default GX_DATA.MDB, mas voc capaz de
assinalar o nome que desejar.
MAIL FUNCTIONS
Voc deve setar esta preferncia para YES para ser capaz de usar as
mail functions.
Valores:
- YES: o desenvolvedor ser capaz de executar GeneXus mail functions
- NO: o desenvolvedor NO ser capaz de executar GeneXus mail
functions.
O valor default NO.
NOTA: voc necessitar ter corretamente instalado todos os
componentes para enviar mensagens via MAPI (Microsoft Messaging API) e
tambm ter instalado no somente o Mail (Microsoft Mail e/ou compatvel) mas
tambm o arquivo VBX para utilizar a interface (MSMAPI.VBX).
GRAPHIC FUNCTIONS
O gerador GeneXus Visual Basic prev uma srie de funes para
customizar seus grficos: GXMKGR, GXKILLGRAPH, GXSETGRAPHPROPERTY,
GXGETGRAPHPROPERTY.
Voc deve setar esta preferncia para YES para ser capaz de usar estas
funes grficas e comandos grficos do GeneXus.
Valores:
- YES: Voc ser capaz de chamar as funes grficas usando o
comando CALL do GeneXus e o comando GeneXus graph.
- NO: Voc NO ser capaz de chamar as funes grficas usando o
comando CALL do GeneXus e o comando GeneXus graph.
100
O valor default NO.
EXCEL OLE FUNCTIONS

Voc pode usar OLE para estabelecer a comunicao entre uma aplicao
gerada pelo GeneXus e Excel.
Para ser capaz de fazer isso, algumas funes standard devem ser
avaliadas. Voc deve setar esta preferncia para YES para ser capaz de usar
Excel do GeneXus para Visual Basic.
Valores:
- YES: o desenvolvedor ser capaz de executar as funes Excel do
GeneXus.
- NO: o desenvolvedor NO ser capaz de executar as funes Excel
do GeneXus.
O valor default NO.
COMMOM DIALOG FUNCTIONS

Common Dialogs so uma srie de dilogos usados por diferentes
aplicaes e vlidas no Windows. Um exemplo de Common Dialogs so: abrir um
arquivo, escolher uma cor, escolher uma fonte, etc...
Voc deve setar esta preferncia para YES para ser capaz de usar o
GeneXus Common Dialogs.
Valores:
- YES: o desenvolvedor ser capaz de chamar o GeneXus Common
Dialogs com o comando CALL.
- NO: o desenvolvedor NO ser capaz de chamar o GeneXus Common
Dialogs com o comando CALL.
O valor default NO.
A sintaxe para usar estas rotinas a seguinte:
Select Color Dialog
Call(GxSelColor,&selected,&default)
&selected = Cor de output selecionada (Long)
&Default = Cor default (Long)
Select Directory Dialog
Call(GxSelDir,&selected,&defaultpath,&caption)
&selected = Diretrio de sada selecionado (String)
101
&defaultpath = Diretrio default de entrada (String)

&caption = Edit Box Caption (String)
File Open Dialog
Call(GxSelFile,&selected,&initialpath,&extensions,&caption,&buttoncap
tion, &buttontype)
&selected = Nome do arquivo de sada selecionado (String)
&initialpath = Caminho default (String)
&extensions = default de extenso (String)
&caption = Ttulo do Box (String)
&buttoncaption = Nome do boto de seleo (String)
&buttontype = Flag para habilitar o boto no Dilogo (inteiro)
Save as Dialog
Call(GxNewFile,&selected,&initialpath,&defaultname,&extensions,&cap
tion)
&selected = Nome do arquivo de sada selecionado (String)
&initialpath = Input Caminho default para procura (String)
&defaultname = Input Default nome de arquivo (String)
Select Font Dialog
Call(GxSelFont,&SelectedFont,&SelectedSize,&SelectedStyle)
&SelectedFont = Nome da fonte de sada selecionado (String)
&SelectedSize = Tamanho da fonte selecionada (String)
&SelectedStyle = Nome da fonte de sada selecionado (String)
Select Picture File Dialog
Call(GxSelPict,&selected,&initialpath,&extensions,&caption,&buttoncap
tion)
&selected = Arquivo Selecionado (String)
&initialpath = Input Caminho default para procura (String)
&buttoncaption = Nome boto selecionado (String)
Printer Dialog
Call(GxSelPrn,&selected)
&selected = Nome da Impressora Selecionada (String)
Copy File
102
Call(GxXopyFile,&Source,&Target)
&Source = Nome do arquivo de entrada (String)
&Target = Nome do arquivo de destino (String)
Calculator
Call(GxCalculate,&Result)
&Result = valor numrico de entrada/sada (Numrico)
15.2. RIGHT BUTTON
CALCULATOR ON SECUNDARY NUMERIC FIELDS

Para os campos numricos que no tem associado um prompt, uma
calculadora ser chamada quando for clicado o boto direito do mouse sobre o
mesmo.
Valores:
- YES: Voc ser capaz de chamar a calculadora clicando o boto
direito do mouse sobre o campo numrico.
- NO: Voc NO ter a facilidade de chamar a calculadora clicando o
boto direito do mouse sobre o campo numrico.
CALENDAR ON DATE FIELDS

Se voc clicar o boto direito do mouse sobre um campo tipo DATE, um
calendrio ser mostrado permitindo a voc selecionar uma data.
Valores:
- YES: Voc ser capaz de chamar um calendrio ao clicar o boto
direito do mouse sobre um campo tipo DATE.
- NO: Voc NO ter facilidade de chamar um calendrio ao clicar o
boto direito do mouse sobre um campo tipo DATE.
15.3. PRINTING
103
LAN PRINTER
Essa propriedade permite voc definir a impressora default para onde
os relatrios sero enviados.
Se nenhuma Impressora de Rede especificada, ento a default (LTP1)
assumida.
Quando o relatrio impresso, os seguintes passos so efetuados:
1. Se Printer Property definida para um objeto em particular, ento o
relatrio enviado impressora indicada no objeto.
2. Se Printer Property no definida, GeneXus procura pela impressora
de rede indicada no Model Property e imprime o relatrio na
impressora indicada.
3. Se nenhuma propriedade de impressora de rede encontrada ento
LPT1 usada.
Diferentes strings devem ser definidos dependendo da linguagem e do
tipo de rede:
Para FoxPro e DBASE os seguintes devem ser definidos:
Sintaxe para Microsoft Networks: \\<server>\<printer>
Onde <server> o nome do servidor
<printer> o nome da impressora
Exemplo: \\ARTECH\\PRXX
Sintaxe para Novell networks: \\<spooler>
Para maiores informaes sobre o comando SET PRINTER TO, procure
nos manuais de referncia do FoxPro ou DbaseIV.
Exemplo: \\SPOOLER \N \Q=WORD4039
Para Clipper:
Sintaxe para LAN Printer: <printer port>
Exemplo: LPT2.
SHOW PRINTER DIALOG ON REPORTS

Permite voc especificar se deseja mostrar o <Printer Dialog> antes de
imprimir seu relatrio ou voc deseja envi-lo diretamente impressora.
Valores:
- YES o dilogo da impressora ser mostrado antes dos relatrios
serem enviados impressora.
- NO o relatrio ser enviado diretamente impressora. Nenhum
<dilogo de impressora> ser mostrado.
104
O valor defualt YES.
PRINT METHOD
Essa preferncia usada para selecionar o mtodo de impresso que o
gerador Visual Basic deve utilizar. Voc pode escolher impresso nativa Visual
Basic ou Report Viewer GeneXus.
Valores:
- VB Native Printing: relatrios so impressos usando Visual Basic
Native printing.
- Report Viewer: relatrios so impressos usando GeneXus Report
Viewer.
O valor default : VB Native Printing.
NOTA: se voc utilizar GeneXus Report Viewer voc deve ter instalado
um driver de impressora na mquina onde o programa ser executado, de outro
jeito Report Viewer no funcionar corretamente.
15.4. FORMAT
FIELD EXIT
Essa preferncia controla a tecla que capaz de mover o cursor entre
os campos do programa gerado. Isto afeta exclusivamente o tipo de controle
Edit (no afeta Radio Buttons, Combo Boxes, etc)
Valores:
- Tab, Shift-Tab: o movimento de avano feito com a tecla Tab e a
combinao das teclas Shift-Tab faz o movimento de volta.
- Enter, Down Arrow, Up Arrow, Tab, Shift-Tab: as teclas Enter, Seta
para baixo e Tab sero interpretadas como movimento para o
prximo campo e a Seta para Cima e Shift-tab sero interpretadas
como movimento para o campo anterior.
- +, Down Arrow, Up Arrow, Tab, Shift Tab: as teclas +, Enter, Seta
para baixo e Tab sero interpretadas como 'movimento' para o
105
prximo campo e a Seta para Cima e Shift-Tab sero interpretadas

como 'movimento' para o campo anterior.
O valor default : Tab, Shift-Tab.
ESC KEY ACTION

Essa preferncia somente afeta transaes com mltiplos nveis e
permite voc estabelecer como voc deseja que a tecla ESC funcione.
Valores:
- Exit Form: voc abortar o programa que est executando ao
pressionar a tecla ESC.
- Change Level: a tecla ESC vai alternar o nvel ao ser pressionada.
O valor default : Exit Form.
DECIMAL SEPARATOR
Esta opo permite ao usurio configurar o separador decimal que
deseja usar.
O valor default corresponde linguagem do modelo do Design Model.
- Ingls: assume . Ponto.
- Espanhol: assume , Vrgula.
- Portugus: assume , Vrgula.
- Italiano: assume , Vrgula.
DATE FORMAT
Essa opo permite voc especificar o formato no qual os atributos do
tipo DATA devem ser pedidos/mostrados nos programas gerados.
Valores:
- Language Dependent: o formato do tipo date depender da linguagem
selecionada no modelo corrente. Os formatos assumidos para cada
linguagem so:
Ingls.......: mm/dd/yy
Portugus: dd/mm/yy
Espanhol..: dd/mm/yy
Italiano....: dd/mm/yy
106
Mm/dd/yy: ms/dia/ano
dd/mm/yy: dia/ms/ano
O valor default : Language Dependent.
DATE FORMAT IN CTOD FUNCTION (VISUAL BASIC)

Essa opo permite voc especificar o formato no qual a funo CTOD
interpretar os parmetros.
Valores:
- Language Dependent: o formato do tipo date depender da linguagem
selecionada no modelo corrente. Os formatos assumidos para cada
linguagem so:
Ingls.......: mm/dd/yy
Portugus: dd/mm/yy
Espanhol..: dd/mm/yy
Italiano....: dd/mm/yy
Mm/dd/yy: ms/dia/ano
dd/mm/yy: dia/ms/ano
O valor default : Language Dependent.
TIME FORMAT
Controla o formato no qual a parte das horas dos atributos tipo
datetime so pedidos e mostrados (tanto na tela como na impresso). Tambm
controla o tamanho dos atributos/variveis tipo datetime. Essa preferncia
aplicada Base de Conhecimento, mas cada modelo pode ter um valor diferente
para essa preferncia.
Valores:
- Language Dependent: Depende da linguagem selecionada de acordo
com a seguinte tabela:
Linguagem
Formato Hora
Ingls
12 horas
Espanhol
24 horas
Portugus
24 horas
Italiano
24 horas
107
O valor default : language Dependent.

NOTA: Se o uso do formato 12 horas especificado ou inferido,
dependendo da linguagem selecionada, os campos tero 3 caracteres a mais
(tela ou impressora) correspondente s strings AM ou PM.
FIRST YEAR OF 20th CENTURY
Informe a partir de qual ano que deve ser considerado como sculo 20.
Todo ano (parte de um campo date) menor que o informado nesta preferncia,
ser considerado sculo 21 (2000...).
O valor default : 40.
15.5. WEB INFORMATION
PROTOCOL SPECIFICATION
Esta preferncia se aplica gerao automtica de links entre as Web
Panels. Esses links so gerados quando um comando CALL entre duas Web
Panels detectado. O objetivo identificar qual o protocolo default a ser
usado quando os links so construdos.
Um link tem a seguinte estrutura:
<A HREF=protocol:program[?parameters]>Text</A>
Valores:
- Secure (HTTPS): fora a gerao do protocolo HTTPS. HTTPS indica
que o protocolo a ser usado Secure Hypertext Transfer Protocol.
- Unsecure (HTTP): fora a gerao do protocolo HTTP. HTTP indica
que o protocolo a ser usado Hypertext Transfer Protocol.
- Do Not Specify: nenhum protocolo especificado, o protocolo atual
usado.
O valor default : Unsecure (HTTP).
Em geral, ns recomendamos o uso do Do Not Specify para obter um
cdigo gerado mais verstil (pode ser executado com qualquer protocolo).
108
Entretanto, h alguns browsers (normalmente verses antigas) que no

suportam links sem protocolo especificado. Por esta razo, e se voc deseja
suportar tantos browsers quanto possvel, ns recomendamos no utilizar Do
not specify nesta preferncia.
NOTA: se o protocolo HTTPS usado, voc deve ter Secure Web
Server.
15.6. TYPE CHECKING
CHECK TYPE ERRORS

Type Controls so usados para checar se expresses, condies,
frmulas e regras so vlidas. Voc pode definir se quer que sejam mostrados
mensagens de erro e advertncia quando o Type Control carregado. Mesmo
que o tipo de controlador no dependa da plataforma em que se est gerando
uma aplicao, o tipo de mensagem que mostrada depende da plataforma.
Em particular, quando uma gerao PC executada (o mesmo se aplica
para prottipo ou Produo) as mensagens so Warnings que permitem que voc
prossiga na gerao dos programas. Entretanto, o AS/400 mostra mensagens
de erro e no permite a gerao dos programas.
Valores:
- YES: Se por algum motivo voc deseja que o mesmo critrio que
utilizado pelo gerador AS/400 seja utilizado para ambientes Xbases
(PC), voc deve selecionar YES para esta propriedade.
- NO: Se voc selecionar NO, o tipo de controle para Xbase
executado na especificao.
O valor default : YES.
Tipos de controle em expresses:
Todas as expresses GeneXus sero analisadas para testar sua
compatibilidade em clculos ou funes.
Por exemplo: &no
Numrico(10)
&char
Caracter(10)
&data
Date
Voc
pode
definir
a
seguinte
expresso
em
Program
Source/Layout/Events/Rules:
&no = &data + month(&char)
109
A expresso acima tem dois problemas:

A funo month( ) requer um parmetro tipo Date.
Uma expresso de igualdade obriga que ambos os lados da igualdade
sejam do mesmo tipo.
Assim o diagrama de navegao ir mostrar todos os Warnings (ou erros
dependendo da plataforma) indicando que a expresso no correta:
- Type mismatch in expression <Invalid Expression> <at line X> (Tipos
no so compatveis) onde <Invalid Expression> parte da expresso
onde o erro foi detectado e <at line X> indica a linha da procedure ou
report onde o erro foi encontrado.
- Type mismatch in Assignment <Invalid Assignment> <at line X> (Tipos
no so compatveis na igualdade) onde <Invalid Assignment> mostra
uma assinalao invlida.
Ex.: &no=&data + month(&char)
Do exemplo acima as mensagens mostradas sero as seguintes: vamos
supor que o erro aconteceu na linha 15 de um relatrio:
- Type mismatch in expression month(&char) at line 15.
- Type mismatch in assignment &no=&data + month(&char) at line 15
Tipos de controle em Conditions:
Condies nas Procedures, Reports e Work Panels so controladas bem
como as clusulas WHERE, IF ou DO WHILE.
Por exemplo:
IF str(&no,10) > CTOD(&data)
.....
ENDIF
As mensagens ou erros nas conditions sero os seguintes:
- Type mismatch in conditional expression <condition> onde <condition>
indica qual a condio incorreta.
- Type mismatch in expression CTOD(&data).
- Type mismatch in conditional expression str(&no,10) > CTOD(&data).
Tipos de controle em Frmulas:
H basicamente dois tipos de frmulas:
- EXPRESSIONS: Expresses sero analisadas para controlar se as
assinalaes so corretas e se as condies so corretas. (Esses
casos j forma mostrados em Expressions e Conditions).
110
AGGREGATE-SELECT: H seis tipos de frmulas Aggregate-Select

(max, min, find, set, sum, count). Elas so compostas dos seguintes
parmetros:
Frmula = formula(Atributo,Condition,Default,Return)
O atributo Return usado quando frmulas MAX( ) e MIN( ) so
utilizadas.
Os seguintes casos so controlados:
- Frmula e Atributo devem ser do mesmo tipo (Exceto para as
frmulas MAX( ) e MIN( ));
- Frmula e Default devem ser do mesmo tipo;
- Frmula e Return devem ser do mesmo tipo;
- A validade da condio tambm controlada.
No caso de haver parmetros com erro mostrado:
- Type mismatch in formula <Formula> in <TypeOfParameter>
parameter onde <formula> o atributo formula e <TypeOfParameter>
indica o parmetro invlido.
Exemplo:
Formula = Numrico(10)
AttrNo = Numrico(10)
AttrData = Date 8
AttrFirst = Caracter(10)
AttrReturn = Date 8
A frmula mostrada abaixo dar as seguintes mensagens:
Formula
=
max(AttrFirst,str(AttrNo,10)>CTOD(AttrData),90,
AttrReturn)
Type mismatch in formula in default parameter
Type mismatch in formula in return parameter.
A mensagem correspondente condio na frmula :
Type mismatch in condition str(AttrNo,10) <> CTOD(AttrData) in
frmula Formula.
-
Tipos de controle nas Regras das Transaes:

A maioria das regras das transaes so transformadas em assinalaes
e a consistncia dos tipos de dados tambm deve ser controlado. As regras
Default, Equal, Add, Subtract, etc tambm so controladas.
As regras condicionais tambm tem sua consistncia checada, ex.> Error,
Msg, etc.
111
Em ambos os casos as mensagens mostradas so as mesmas mostradas

acima.
FUNCTIONS
Permite o uso de funes especficas, que no so suportadas por todos
os geradores.
Se funes especficas no so explicitamente suportados pelo GeneXus
(ex.: TRIM, LEFT, etc, porque so vlidos no AS/400) e elas so utilizadas, um
erro ser mostrado.
Valores:
- Allows non-standard functions when specyfing: inibe o controle da
sintaxe mencionada acima na especificao.
- Error on non-standard functions when specyfing: o controle da
sintaxe mencionada acima feita na especificao.
O valor default : Error on non-standard functions when specyfing.
15.7. KEY CONFIGURATION

FIRST RECORD
LAST RECORD
NEXT RECORD
PREVIOUS RECORD
REFRESH KEY
Permite voc selecionar qual tecla ser utilizada como tecla de Refresh.
O valor default F5.
PROMPT KEY
Permite voc selecionar qual tecla ser utilizada como Prompt das
Transaes.
112
O valor default F4.

Voc deve evitar assinalar a mesma tecla de funo para duas aes
diferentes porque isso no controlado pelo gerador.
15.8.
15.9. OTHER
MAXIMUN WORKFILE LINES
Os subfiles em ambiente PC so carregados em arquivos temporrios. O
tamanho mximo de um subfile na AS/400 9.999 linhas, mas em ambiente PC
ou rede no h restries. Esta liberdade pode causar problemas, por exemplo:
se voc est trabalhando com uma Work Panel ou Transao que carrega
300.000 registros e o usurio vai para o final do mesmo (Ctrl-End), neste caso
o arquivo temporrio carregar 300.000 registros.
Se nenhuma das condies acima satisfeita ento 9.999 linhas so
assumidas como limite do subfile.
Quando o limite ultrapassado, a seguinte mensagem mostrada:
Number of lines exceeded xxxx
E voc pode continuar trabalhando, mas nenhum outro registro ser
carregado.
Valores: qualquer valor numrico positivo.
113

Comandos Do GeneXus

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Comandos Do GeneXus

Uploaded by

Copyright:

Available Formats

Sumrio

Comandos GeneXus ................................................................................................................................... 7

Eventos de Controle ................................................................................................................................. 58

Border Style .................................................................................................................................. 69

Maximize Button .......................................................................................................................... 70

Minimize Button ........................................................................................................................... 70

Form Icon ..................................................................................................................................... 70

Control Box .................................................................................................................................. 70

Modal Dialog ................................................................................................................................ 71

Generate as a Popup Window ....................................................................................................... 71

Automatic Border Color ............................................................................................................ 72

Automatic Border Display Attribute.......................................................................................... 72

Automatic Border Characters .................................................................................................... 73

Refresh Key .................................................................................................................................. 74

Next Record .................................................................................................................................. 75

Update Mode ................................................................................................................................ 76

Delete Mode ................................................................................................................................. 76

First Record .................................................................................................................................. 77

Display Mode ............................................................................................................................... 77

More Keys .................................................................................................................................... 77

Automatic Border Color ............................................................................................................ 83

Automatic Border Display Attribute.......................................................................................... 83

Automatic Border Characters .................................................................................................... 83

Refresh Key .................................................................................................................................. 84

More keys ..................................................................................................................................... 85

Refresh Key .................................................................................................................................. 87

More keys ..................................................................................................................................... 88

More keys ..................................................................................................................................... 93

1.2. Assign Varivel

1.4. Change Page

1.8. Do Nome Subrotina

1.14. For Each

resolve o problema de COMO encontr-los. A maneira COMO GENEXUS vai

1.15. For Each Line

1.16. For Each Selected line

Permite gerar um grfico a partir das informaes contidas no Subfile.

1.20. Line Number

1.22. Margin Botton

1.23. Margin Top

1.25. New Record

1.27. Page Length

1.28. Print If Detail

1.35. Xfor Each

1.36. Xfor First

O comando XNEW insere um registro em um File View (arquivo externo).

2. Regras dos Objetos GeneXus

Default( Atributo, xxx);

2.8. DEFAULT MODE

Transaes que possuem a regra PARM( ) no aparecem no

Quando um Objeto chamado de outro programa, os

Esta regra usada para mudar as mensagens geradas por GeneXus

Esta regra Subtrai o valor de Atributo1 do Atributo2, se a Condio for

3. Funes Disponveis no GeneXus

3.6. HOUR, MINUTE, SECONDS

Converte uma String em Data.

O formato da string retornada o mesmo da funo CtoT, ou seja, a

Retorna a data referente a adio de <NExpression> meses para <Date>.

A funo UDP chama um programa que pode USAR TABELAS e retorna

Retorna a identificao da Estao de Trabalho correspondente.

Retorna a string resultante da concatenao de S1 e S2 e o separador

Remove todos os brancos a esquerda da expresso caracter <Str>. Esta

Retorna um nmero representando um valor de cor RGB, dados os 3

4. Operadores Disponveis no GeneXus

5. Variveis Internas do GeneXus