Esplora E-book
Categorie
Esplora Audiolibri
Categorie
Esplora Riviste
Categorie
Esplora Documenti
Categorie
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
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
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.
4
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
Maximize Button .......................................................................................................................... 70
COMMITMENT ...................................................................................................................................
... 73
KEY
ASSIGNMENT ............................................................................................................................... 74
Retrieve ........................................................................................................................................ 75
Menu ............................................................................................................................................. 75
Cancel ........................................................................................................................................... 76
Select ............................................................................................................................................ 76
Cancel ........................................................................................................................................... 85
Cancel ........................................................................................................................................... 87
Cancel ........................................................................................................................................... 92
.. 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 20
th
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
7
1. Comandos GeneXus
1.1. Assign Atributo
(Procedure)<Att> = <Exp>Associa o valor de uma expresso para um atributo (Este
comandoatualiza 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, porexemplo:
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 variveisexistem somente
no ambiente do objeto correspondente e em nenhum outrolugar.A expresso associada a <Exp>
pode ser:
Um Atributo
8
Uma Varivel
Uma Constante
comando usado para chamar uma rotina externa ou um objetoGENEXUS. Parmetros podem ser
atributos, variveis ou valores constantes.Todos os parmetros servem para entrada e sada, assim
valores podem serretornados em qualquer dos parmetros.Se o programa que voc estiver
chamando j existir, no ser necessrioescrever o nome entre apstrofos. GENEXUS ir checar se
o programarealmente existe.O Nome do programa que ser chamado pode ser uma varivel ou
umatributo.
1.4. Change Page
(Procedure, Relatrio)CP <nlines>Causa um salto de pgina quando faltarem menos linhas que
<nlines> napgina que est sendo impressa. Esse comando equivalente a: EJECT ifPagelenght
Currentline for menor que <nlines>.
1.5. Commit
(Procedure, Relatrio, Work Panel)CommitFora um COMMIT quando includo em um
programa.GENEXUS ir ativar o controle de Commitment para todas asProcedures e Transaes,
se nenhum dos dois comandos NOCOMMITMENT ouNOENDTRN tiverem sido especificados,
ser gerado um COMMIT no final daexecuo da Procedure ou Transao.
9
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 umaresposta do
usurio que pode ser Sim ou No. Em ambiente AS/400 osvalores possveis so F12=Cancel ou
Reject e Enter=Accept ou Confirm. Parasaber se o operador confirmou ou rejeitou a mensagem, a
funoCONFIRMED( ) usada.
1.7. Delete
(Procedure)DeleteExclui o registro da Tabela Base associado ao grupo onde o comandoDELETE foi
especificado.Regras:
Recomendao: primeiro exclua os nveis internos antes dos externos.Isto evita qualquer possvel
cancelamento ou travamento do registro.
10
1.8. Do Nome Subrotina
(Transao, Procedure, Relatrio, Work Panel e Web Panels)DO RoutineNamePermite voc
chamar uma subrotina (definida usando o comando Sub).No permitida a passagem de
parmetros; TODAS as variveis do mesmoprograma tambm podem ser utilizados pela subrotina.
1.9. Do While
(Transao, Procedure, Relatrio, Work Panel e Web Panels)Do while <Cond>EnddoSero
executados todos os comandos entre o DO WHILE e o ENDDOenquanto a condio <Cond> for
verdadeira. Para forar a sada do grupo do DOWHILE pode ser usado o comando EXIT.
1.10. Eject
(Procedure, Relatrio)EjectEste comando fora um salto de pgina no programa gerado, quando
asada selecionada est associada a impressora, ou limpa a tela quando a sadaest associada a tela.
1.11. Error_Handler
(Transao, Procedure, Relatrio, Work Panel)Implementado para tratamento de erros para
Client/Server.A regra/comando error_handler prov uma maneira dinmica paraexecutar aes
especficas quando um erro no database relatado em tempode 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.
11
1.12. Exit
(Transao, Procedure, Relatrio, Work Panel)ExitO comando Exit permite abandonar um grupo
For Each, Xfor Each ou DoWhile. O prximo comando a ser executado aps um exit o prximo
comandoaps o comando EndFor, XendFor ou EndDo correspondente ao grupo quecontm o
comando Exit.NOTA: O comando Exit no valido dentro de um FOR EACH LINE.
1.13. Footer
(Procedure, Relatrio)FooterEndDefine as linhas de rodap a serem impressas no final de cada
pgina.Os comandos entre a clusula FOOTER e a clusula END so executadasquando chega-se ao
final da pgina. FOOTERS podem tambm ser definidoscom um FOR EACH dentro, da mesma
forma como HEADERS pode.Se existirem linhas de impresso entre o FOOTER e o END, elas iro
serimpressas dentro da margem inferior (parmetro MB). Se as linhas deFOOTER no couberem
dentro da rea da margem inferior a impresso ircontinuar na prxima pgina.
1.14. For Each
(Procedure, Relatrio, Work Panel)For each [order <Att1> <Att2> ...][Where <Condition> ]
[Defined by <Att1> <Att2> ...]EndforDefine um grupo de atributos genricos por operaes, o
comando ForEach usado para definir acesso ao Banco de Dados.No existem referncias
explcitas para tabelas em um FOR EACH. Vocsomente precisa mencionar QUAIS os Atributos
que voc precisa, e o Genexus
12
resolve o problema de COMO encontr-los. A maneira COMO GENEXUS vaiefetuar a navegao
pode ser vista no relatrio de Especificao. Para foraruma sada de um grupo FOR EACH voc
pode usar o comando EXIT.Existem dois tipos de tabelas associadas a um grupo FOR EACH:
Tabelas que podem ser alcanadas pela Tabela Base, conhecidas comoTabelas Estendidas.Se
existirem atributos que no faam parte da Tabela Base nem dasTabelas Estendidas ir aparecer uma
mensagem de erro no relatrio deEspecificao e o programa no ser gerado.
CLUSULA ORDER
ORDER < Lista de Atributos >A ordem para acessar a Tabela Base de um for Each pode
serespecificada por uma lista ordenada de atributos, informados logo aps ocomando FOR
EACH.NOTA: A clusula ordem bastante usada para definir quebras (Break)em grupos For Each
aninhados. Uma quebra definida sempre que ns temos amesma tabela base em dois grupos For
Each, os atributos da Quebra estodefinidos pelo conjunto de atributos especificados na clusula
Ordem.
CLUSULA WHERE
WHERE <Condio>A clusula WHERE pode ser especificada para estabelecer uma condiopara
o grupo For Each EndFor.Regras:
Vrios comandos WHERE podem ser especificados aps um FOREACH. Neste caso, as condies
WHERE funcionaro como se elasestivessem separadas por um operador .AND..
Um comando WHERE pode, somente, ser especificado imediatamenteaps um FOR EACH ou aps
outro comando WHERE.
13
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
maisprioridade, informando uma Lista de Atributos na clusula DEFINED BY.
1.15. For Each Line
(Work Panel)For each lineEndForFora o processamento de todas as linhas (carregadas) no subfile
emuma Work panel.Esse comando pode ser usado, por exemplo, para marcar todas as linhasque
satisfaam uma certa condio.FOR EACH LINE tem as seguintes restries:
Ele somente ir processar os registros que foram carregados nosubfile. Se voc quiser processar
contedo do subfile usado como o dado para o grfico e o usurio podeescolher 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 asdefinies do grfico (portanto o Graph Wizard no precisa ser
usadotodas as vezes).Onde:
<List> uma lista com os atributos e variveis do Subfile que devemser includs no grfico. O eixo
X pode receber qualquer type varivel(caractere, data ou numrico) e todas as outras variveis
precisamser numricas (eixo Y).
1.18. Header
(Procedure, Relatrio)HeaderEndDefine o cabealho a ser impresso no topo de cada pgina.O
primeiro grupo no Layout padro das Procedures/Reports o grupoHEADER. Os dados dentro
desse grupo so impressos no incio de cada pginado relatrio.Voc pode tambm definir um
cabealho para cada FOR EACH definidono Layout.
15
1.19. If
(Transao, Procedure, Relatrio, Work Panel)If <Cond>[Else]EndifExecutam um bloco de
comando se a condio for avaliada comoverdadeira.
1.20. Line Number
(Procedure, Relatrio)Lineno <Lineno>Especifica o nmero da linha onde o dado ser impresso.
1.21. Load
(Work Panel)LoadEste comando fora a carga de uma nova linha dentro do subfile.Ela bastante
usada quando o Work Panel no tem uma tabela Base, econsequentemente a carga precisa ser feita
na mo ou quando precisamosfazer filtros com atributos de vrias tabelas.
1.22. Margin Botton
(Procedure, Relatrio)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).
16
1.23. Margin Top
(Procedure, Relatrio)MT <nlines>Define o nmero de linhas em branco no topo da pgina.
1.24. Message
(Transao, Procedure, Relatrio, Work Panel)Msg(msg | &<var> [,nowait] [,status])Usado para
mostrar mensagens de aviso. Pode mostrar um literal ou umavarivel contendo uma mensagem.
Nowait:
Armazena a mensagem em uma varivel interna e continua oprocessamento. O usurio no ir ver
mensagem at que o processamento doprograma se encerre. Isto garante uma melhor performance
com menos telasde I/O requeridas.
Status:
A mensagem mostrada no momento em que originada. Ela usadaprincipalmente para dar ao
usurio informaes sobre status deprocessamento.
Nenhuma Opo Especificada:
Exibe a mensagem e aguarda pelopressionamento do <ENTER>.
1.25. New Record
(Procedure)New[When Duplicate]EndNewO comando NEW insere um registro na Tabela Base
determinada peloatributo no grupo NEW-ENDNEW. Chaves duplicadas so checadas.Se a chave j
existir, todos os comandos entre o WHEN DUPLICATE e oENDNEW sero executados. Caso voc
deseje fazer alguma alterao nesseregistro j existente, um grupo FOR EACH ENDFOR precisa
ser especificadodentro do WHEN DUPLICATE.
17
1.26. NoSkip
(Procedure, Relatrio)NoSkipInibe salto de linhas de impresso consecutivas.Este comando precisa
ser colocado imediatamente aps o print block.
1.27. Page Length
(Procedure, Relatrio)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
(Procedure, Relatrio)Print if DetailEvita a impresso do registro se no existirem registros no
Subfile.Este comando precisa ser especificado sempre que voc quiser inibir oprocessamento 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
23
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 umaChave.
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 nenhumAtributo, 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;
24
Esta Regra faz com que a string definida em Texto de Mensagem sejaapresentada na Janela de
Erro da Transao, se a condio for avaliada comoverdade.Todo processamento subsequente,
inclusive outras regras, no seroexecutadas. Portanto, se muitas regras estiverem associadas a uma
nicacondio, a regra Error dever ser a ltima, para que as outras possam serexecutadas.
2.11. ERROR_HANDLER
(Transao, Procedure, Relatrio, Work Panel)Implementado para tratamento de erros para
Client/Server.A regra/comando error_handler prov uma maneira dinmica paraexecutar aes
especficas quando um erro no database relatado em tempode 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 noSubfile, que eventualmente no aparecem na tela. Ela bastante
utilizadaquando precisa-se de um cdigo no Subfile, mas no se quer que ele aparea natela.
25
2.14. MSG
(Transaes)Msg(Texto de Mensagem) IF Condio;Esta regra usada para enviar mensagens de
aviso para o operador. Astring definida em Texto de Mensagem ser apresentada na Janela de
erroda 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 Atributosso sada de dados. Todavia, pode haver ocasies
em que no se deseja que ousurio introduza dados, dependendo de uma condio.Esta regra faz
com que a Transao no aceite a digitao de dados parao Atributo ou varivel associado.
2.16. NOCHECK
(Transaes)Nocheck( Atributo1, Atributo2, ..., Atributon);A regra Nocheck usada para inibir a
checagem de integridadereferencial.
2.17. NOCONFIRM
(Transaes)Noconfirm(Atributo);A regra Noconfirm usada para evitar a confirmao no Nvel.
Quandose passa de um Nvel para o seguinte, uma mensagem apresentada, pedindo aconfirmao
dos dados. Para se evitar o pedido de confirmao, usa-se estaregra.Atributo: usado para indicar o
nvel. Se no for especificado nenhumatributo, ser assumido o primeiro nvel.
26
2.18. NOREAD
(Procedimentos/Relatrios, Work Panels)Noread(<Att1>,<Att2>,...,<Attn>);Essa regra permite
inibir a leitura de uma tabela que navegada emostrada 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 entracom 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
(Transaes, Procedimentos/Relatrios, Work Panels)Parm( Par1, Par2, ..., Parn);Recebe os
programas enviados por outro programa.
Obs.:
Quando um Objeto chamado de outro programa, osparmetros recebidos pela regra PARM( ) so
consideradoscomo uma regra Equal.
2.22. PRINTER
(Procedimentos/Relatrios)Printer(<PrinterFile>);Seleciona o arquivo de impresso a ser usado
pelo AS/400 ou o nome daimpressora, 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 peloGeneXus, quando seleciona-se Visualizar.
2.24. REFCALL
(Transaes)Reffcall(Nome_prog, Atrib1, ... , AtribN);Esta regra usada para chamar um
30
3. Funes Disponveis no GeneXus
3.1. DAY
(Transaes, Procedimentos/Relatrios, Work Panels)Day(<Date>)Tipo retornado: N(2)Retorna o
dia de uma data informada. Se <Date> for uma data nula, ovalor 0 ser retornado.
3.2. MONTH
(Transaes, Procedimentos/Relatrios, Work Panels)Month(<Date>)Tipo retornado: N(2)Retorna o
nmero do ms de uma data informada. Um valor nulo (0) serretornado se a <Date> no for uma
data nula.
31
3.3. YEAR
(Transaes, Procedimentos/Relatrios, Work Panels)Year(<Date>)Tipo retornado: N(4)Retorna o
ano de uma data informada. Se <Date> no for uma data vlida,um valor nulo ser retornado.
3.4. TODAY
(Transaes, Procedimentos/Relatrios, Work Panels)Today( )Tipo retornado: DateRetorna a data
do sistema operacional.
3.5. NOW( )
(Transaes, Procedimentos, Relatrios, Work Panels, Web Panels)Now( )Tipo retornado:
DatetimeRetorna 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: NumricoRetorna um valor
numrico representando as horas/minutos/segundosrespectivamente, no formato da hora informado
do datetime.
32
3.7. DOW
(Transaes, Procedimentos/Relatrios, Work Panels)Dow(<Date>)Tipo retornado: N(1)Retorna um
nmero entre 1 e 7. Este nmero est associado ao dia dasemana (Domingo=1).Se a data contida em
<Date> for nula, o valor retornado ser 0.
3.8. CDOW
(Transaes, Procedimentos/Relatrios, Work Panels)Cdow(<Date>[<Language>])Tipo retornado:
C(9)Retorna o nome do dia da semana de uma determinada data na linguagemselecionada. Espaos
sero retornados se o valor de <Date> for invlido.<Language> deve ser uma das seguintes (caso
no seja informada, serutilizada a linguagem selecionada no Model Properties):spa
Espanholeng Inglspor Portugusita - Italiano
3.9. CMONTH
(Transaes, Procedimentos/Relatrios, Work Panels)Cmonth(<Date>[ , <Language>])Tipo
retornado: C(9)Retorna o nome do ms da data informada na linguagem selecionada. Senenhuma
linguagem for selecionada, ser utilizada a que estiver definida emModel Properties.
3.10. CTOD
A data e a hora da string de parmetros devem ser separados porpelo menos um branco.
No caso de M e/ou N serem omitidos, seus valores default so osparmetros utilizados para
definio do DateTime (primeiroparmetro).
O formato da string retornada o mesmo da funo CtoT, ou seja, adata depende da preferncia
Date format in CtoD function e a hora sempre no formato 24 horas.
3.14. YMDTOD
(Transaes, Procedimentos/Relatrios, Work
Panels)Ymdtod(<NExp1>,<NExp2>,<NExp3>)Retorna a data onde <NExp1> o ano, <NExp2>
o ms e <NExp3> odia.<NExp1>, <NExp2> e <NExp3> devem ser expresses numricas.
3.15. YmdHmstoT
(Transaes, Procedimentos, Relatrios, Work Panels e Web Panels)YmdHmstoT( <NExp1>,
<NExp2>, <NExp3> [ , <NExp4> [ ,<NExp5> [ ,<NExp6>]]])Tipo retornado: Date TimeRetorna
um Date Time associado a data e hora especificados noparmetro. Parmetros omitidos assumem o
valor zero. Todos os parmetrosso expresses numricas.NExp1 representa o ano. Este valor no
se ajusta ao que for indicadona preferncia First year of 20
th
century.NExp2 representa o ms.NExp3 representa o dia.NExp4 representa a hora. Hora deve
ser especificado no formato 24-horas.NExp5 representa os minutos.NExp6 representa os
segundos.Nota: Se somente um dos componentes (dat ou hora) vlido, somenteeste ser
considerado. Por exemplo: YMDHMStoT(1990, 31, 2, 12, 10, 15) irretornar um datetime vlido
com a parte da data nula. A hora ser 12:10:15.
3.16. ADDMTH
(Transaes, Procedimentos/Relatrios, Work Panels)Addmth(<Date>,<NExpression>)
36
Retorna a data referente a adio de <NExpression> meses para <Date>.Um valor nulo retornado
se <Date> for uma data invlida.
3.17. ADDYR
3.26. COLS
(Procedimentos/Relatrios, Work Panels)Cols(&Array( ))Retorna o nmero de colunas de um vetor
bidimensional.
3.27. TIME
(Transaes, Procedimentos/Relatrios, Work Panels)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.
39
3.28. SYSTIME
(Transaes, Procedimentos/Relatrios, Work Panels)Systime( )Retorna a hora do sistema no
formato hh:mm:ss.
3.29. SYSDATE
(Transaes, Procedimentos/Relatrios, Work Panels)Sysdate( )Retorna a data do sistema.
3.30. USERCLS
(Transaes, Procedimentos/Relatrios, Work Panels)Usercls( )Retorna a classe do Usurio definida
no User Profile. Esta regra vlidasomente no AS/400.
3.31. USERID
(Transaes, Procedimentos/Relatrios, Work Panels)Userid( )No ambiente AS/400, esta funo
retorna a identificao do usuriodefinida no User Profile.No ambiente Micro/Lan esta funo
retorna o contedo da varivel deambiente do DOS chamada LOGNAME. Para habilitar o uso
dessa funo, essavarivel dever ser criada para todas as estaes.Em um ambiente Client/Server
esta funo retorna a identificao dousurio conectado ao servidor.
3.32. WRKST
(Transaes, Procedimentos/Relatrios, Work Panels)Wrkst( )
40
Retorna a identificao da Estao de Trabalho correspondente.Em ambiente Micro/Lan retorna o
contedo da varivel de ambiente doDOS, PSTATION. Para habilitar o uso dessa funo, voc
precisa setar estavarivel de ambiente.
3.33. STR
(Transaes, Procedimentos/Relatrios, Work Panels)Str(N1 [ ,N2 [ ,N3]])Converte o valor da
expresso numrica em <N1> para uma stringcaracter, alinhado pela direita, <N2> o tamanho
total de <N1> (incluindo osinal e o ponto decimal), e <N3> o nmero de decimais. Se voc
especificarmenos decimais do que a expresso numrica <N1> possui, o valor
serarredondado.Notas:
43
3.44. ROUND
(Transaes, Procedimentos/Relatrios, Work Panels)Round(<NExp1>,<NCte>)Arredonda o valor
de <NExp1> para <NCte> casas decimais.
3.45. TRUNC
(Transaes, Procedimentos/Relatrios, Work Panels)Trunc(<NExp1>,<NCte>)Trunca o valor de
<NExp1> para <NCte> decimais.
3.46. VAL
(Transaes, Procedimentos/Relatrios, Work Panels)Val(<CExpression>)Esta funo converte um
nmero de uma expresso caracter para umvalor do tipo numrico. Ela processa os nmeros em
uma expresso caracter daesquerda para a direita at que um caracter no numrico encontrado.
3.47. COLOR
(Procedimentos/Relatrios, Work Panels)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
(Procedimentos/Relatrios, Work Panels)RGB( <Red>,<Grn>,<Blu>)
44
Retorna um nmero representando um valor de cor RGB, dados os 3seguintes parmetros:
Red : Nmero na faixa de 0 at 255, inclusive, que representa ocomponente vermelho da cor.
Green : Nmero na faixa de 0 at 255, inclusive, que representa ocomponente verde da cor.
Blue : Nmero na faixa de 0 at 255, inclusive, que representa ocomponente 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
(Transaes, Procedimentos/Relatrios, Work Panels)Null(<Att | Var>)Retorna um valor Boleano
true se o valor do atributo ou varivel fornulo. O valor nulo para campos do tipo Numrico zero,
e para campos tipoCaracter e Data uma string em branco.
3.50. NULLVALUE
(Transaes, Procedimentos/Relatrios, Work Panels)Nullvalue(<Att | Var>)Retorna um valor nulo
do mesmo tipo da definio do Atributo/Varivel.
3.51. LOADBITMAP
(Transaes, Procedimentos/Relatrios, Work Panels)LoadBitmap(< FileName|Att|Var>)Incorpora
Bitmaps no design do Form.A funo LoaBitmap usada para definir qual bitmap ser associada
auma varivel.
45
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 doprograma corrente. O valor no armazenado e ele perdido assim que ousurio deixa
a Transao. Se o atributo <Att> no for especificado, o atributoque est sendo assinalado
assumido.
3.54. AFTER
(Transaes)After(<Event>)Retorna Verdadeiro ou Falso dependendo de que estgio a transao
seencontre.Retorna Verdadeiro se um evento especificado est acontecendo naquelemomento na
transao.Este evento pode ser disparado porque a execuo de uma Transaopassou por um certo
Nvel, um certo atributo foi informado, ocorreu uma Aoem uma Transao ou toda a transao foi
finalizada. GeneXusautomaticamente realiza onde e como uma regra precisa ser
executada.Entretanto, o usurio pode forar que o GeneXus execute uma determinadaregra depois
que um dos eventos seja mencionado.<Event> pode ser: InsertUpdateDeleteConfirm
46
Trn<Att>Level(<Att>)Nota: Quando for includa a regra After em uma regra condicional, aregra
ser executada SOMENTE imediatamente aps o evento After ocorrere em nenhum outro lugar.
3.55. LEVEL
(Transaes)Level(<Att>)Retorna Verdadeiro se a execuo da Transao est no Nvel de umdado
Atributo. GeneXus automaticamente realiza onde e quando uma regraprecisa ser executada.
Contudo o usurio pode forar GeneXus a executar umadada regra a um Nvel especificado da
transao.
3.56. INSERT/UPDATE/DELETE
(Transaes)InsertUpdateDeleteRetorna Verdadeiro quando a transao est em modo
de,respectivamente, Insero/Alterao/Deleo, caso contrrio retorna Falso.
47
4. Operadores Disponveis no GeneXus
48
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 docontrole.1:
Opaco (Default) a cor de fundo do controle preenche o controle eoculta qualquer cor ou grfico
atrs dele.
6.14. FONTNAME
(Tipos de controle: Button, Edit, Check box, Radio Button, Combo Box, DynamicCombo Box,
Subfile, Column)Determina a fonte usada para mostrar o texto num controle. Voc deveassinalar
uma expresso tipo string especificando o fontname a ser usado.Exemplo: EvtBtn.fontName =
Times New RomanOnde EvtBtn o nome do controle de um boto.
55
Em geral, voc deve mudar FontName antes de setar o tamanho e estilodos 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, DynamicCombo Box,
Subfile, Column)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
colunado subfile)
6.16. FONTSIZE
(Tipos de controle: Button, Edit, Check Box, Radio Button, Combo Box, DynamicCombo Box,
Subfile, Column)Determina o tamanho da fonte a ser usado para mostrar o texto
nocontrole.Exemplo: EvtBtn.fontSize = 20Onde EvtBtn o nome de um controle boto e 20 o
tamanho utilizadopara 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, DynamicCombo Box,
Subfile, Frame, Text)Determina a largura e altura respectivamente do controle. Um valornumrico
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.
56
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 = 200A 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.
Umastring 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
59
Ocorre quando o usurio clica o boto esquerdo do mouse sobre ocontrole.Exemplo: Event
text.ClickMsg(Explained text: .............)EndeventNeste exemplo uma mensagem ser exibida
quando o usurio clicar sobreo 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.IsValidCall(TclientInfo,CliCode)EndEventNeste exemplo quando o usurio informar o
cdigo do cliente, outratransao para digitar as informaes da cliente chamada se o cdigo
docliente digitado for vlido.
7.4. RIGHTBUTTON
(Tipos de controle: Edit)Ocorre quando o boto da direita do mouse pressionado sobre
ocontrole.Exemplo: Event CliCode.RightButtonMsg(Enter client code, value range: 1100)EndeventNeste exemplo o boto direito usado para mostrar um textoexplicativo.
60
8. Mtodos
Importante: MTODOS somente funcionam em Visual Basic e VisualFoxpro, os demais geradores
iro ignor-los, com exceo do Mtodo SetFocusque foi implementado em todos os geradores.
8.1. SETFOCUS
(Tipos de controle: Edit, Check Box, Radio Button, Combo Box, Dynamic ComboBox, Button,
Subfile, Frame)Direciona a entrada de dados a um controle especfico.Exemplo: Event
GetClientCall( PgetCli, CliCode, CliName)SupCod.Setfocus()EndEventSuponha que tenhamos
um boto no Form que chama um procedimentopara obter o nome do cliente indicado no cdigo e
ns queremos direcionar aentrada de dados (posicionar o cursor) no atributo SupCode depois do
call.Isto pode ser feito usando o mtodo setfocus com o atributo SupCode dentrodo evento
associado ao boto, como mostrado acima.
8.2. REPAINT
(Tipos de controle: Edit, Check Box, Radio Button, Combo Box, Dynamic ComboBox, Text,
Retngulo)Este mtodo muda as propriedades do controle.Exemplo:Este mtodo usado para
repintar o controle se qualquer das suaspropriedades foi modificada, por exemplo cor, fonte,
tamanho, etc, e voc quermostrar as mudanas.PoNbr.FontBold = 1PoNbr.Repaint( )
8.3. CLEAR, ADDITEM
(Tipos de controle: Combo Box e Dynamic Combo Box)
61
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 DynamicCombo 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 adicionarnovos itens da tabela e carreg-lo com todos os pases do
continenteAmericano, o primeiro item ser All .&Var.clear( )&Var.additem(0, All)for eachWhere
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 ouDynamic Combo Box.Sintaxe: control.removeitem(code)Remove o
primeiro code que for encontrado.
8.5. LOAD
(Tipos de controle: Subfile)Carrega uma nova linha ao subfile de Work Panels e Web Panels.
Estemtodo o mesmo que o comando Load. Deve ser utilizado dentro do eventoLoad como no
exemplo:Event LoadFor each InvCode&InvCode = InvCode&InvDat = InvDate&Type = INV
62
.....sfl_1.Load( )EndforEndEventEste mtodo muito til quando voc tem mais de um subfile no
form(esta feature ser liberada em verses futuras). Neste caso voc especificapara qual subfile a
linha deve ser carregada.sfl_1.Load( ) or sfl_2.Load( )
8.6. SORT
(Tipos de controle: Subfile)Ordena o subfile pelo atributo especificado.Exemplo:
sfl_1.Sort(PrdName)Onde: PrdName um atributo do subfile. O subfile ser ordenado entopor
PrdName, sem a criao de um ndice temporrio, se no existir nenhumndice ordenado pelo
atributo escolhido (esta a diferena entre o mtodoSORT e a regra ORDER)
8.7. PRINTFORM
(Tipos de controle: Frame)Imprime a janela da Work Panel ou transao na impressora
default.Exemplo: Event PrintForm.printform( )EndEventEste 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.
63
Este mtodo muito til se voc tem mais de um subfile no form (estafeature ser liberada em
verses futuras). Neste caso voc pode especificarqual 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, emoutras palavras, so vlidas para
todos os modelos.Modo de uso:Posicione o cursor sobre a propriedade que voc deseja editar,
eselecione a opo desejada no Combo Box no topo da tela.No canto superior esquerdo do editor de
propriedades, h 3 botesusados para salvar ou cancelar as modificaes e assinalar o valor
default.NOTA: Sempre use o boto para assinalar o valor default, no tecle ocaractere *.
MAXIMUN NUMERIC LENGHT
Por default, GeneXus controla a maioria das suas limitaes, tornando otrabalho em diferentes
plataformas vivel partir de uma nica definio, mas possvel mudar estes controles.Esta
preferncia usada para especificar o tamanho mximo de umcampo numrico.Valores: O valor
default desta preferncia 18, mas pode ser alteradopara qualquer valor entre 4 e 30.NOTA:
Valores maiores que 18 somente so suportados pelo gerador RPG.
64
Atributos e variveis no so verificados quando este valor modificado para um valor menor que
18, assim, recomendvelverificar se o novo valor correto.
FUNCTIONS
Esta preferncia usada quando voc deseja utilizar funes que noso explicitamente suportadas
pelo GeneXus.Esta preferncia somente vlida quando os objetos so salvados. (Essapreferncia
nos modelos de prototipao e produo ser validada naespecificao).Assim, voc poder salvar
um objeto que utilize uma funo no standardse esta preferncia no modelo de design estiver
setada como Allow standardfunctions only.Valores:
Allows standard functions only on saving: (Permite somente funesstandard) Somente funes
standard suportadas pelo GeneXuspodem ser utilizadas.
para o novo tipo de gerador. Todos os tipos de geradores definidosaqui iro aparecer na lista de
geradores possveis (Generators Tab) em cadamodelo da Base de Conhecimento. Ento em cada
modelo voc assinalar umgerador em particular (ex.: Visual Basic, RPG, etc.).H 2 tipos de
geradores pr-definidos: Default (usado como default nagerao 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. Seo tipo de gerador selecionado estiver sendo
usado em qualquer modelo voc noser 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 formsdefinidos, dependendo do modelo. Cada modelo tem
uma lista de Form Classesvlidas.A lista do lado esquerdo inclui todas as forms classes existentes
na Basede Conhecimento, com os botes de Add e Remove voc pode selecionar quaisforms 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.
66
9.4. PROMPTS
Aqui voc pode setar as opes de prompts para o modelo principal(Design), as opes
especificadas aqui podem ser utilizadas nos outrosmodelos.Se voc selecionar boto Default
Settings, nenhum efeito especial serusado.Selecionando o boto Design Model Settings, voc
poder especificar umefeito par aos prompts no modelo corrente.
Button Prompt: O atributo aparecer com uma seta para cima ao ladodo mesmo.
Colored Prompt: O atributo aparecer com uma cor diferente. Sevoc escolher esta opo, a cor
especificada aqui ter prefernciasobre qualquer cor especificada para este atributo em qualquer
form.Outros ModelosVoc pode setar a opo de prompt. Aqui voc indicar como os atributospara
os quais GeneXus gera prompts, devero aparecer nos Forms.A opo especificada aqui somente
ter validade para os atributosdefinidos como EDIT.Se voc selecionar Design Model Settings, o
que foi setado no modelo dedesign ser utilizado no modelo corrente.
Button Prompt: O atributo aparecer com uma seta para cima ao ladodo mesmo.
Colored Prompt: O atributo aparecer com uma cor diferente. Sevoc escolher esta opo, a cor
especificada aqui ter prefernciasobre qualquer cor especificada para este atributo em qualquer
form.
67
10. Propriedades das Transaes
A primeira transao deve ter uma CALL chamando a segunda, antes que ocommit seja executado.
Remover o COMMIT da segunda TRN usando a propriedade Commit onExit = NO para que o
COMMMIT da primeira TRN faa o COMMMIT emambas como um todo aps o retorno do
CALL.NOTA:
vlido somente em transaes que no tenham a propriedade doAS/400 Commitment =
Disabled neste caso a propriedade serignorada.
Tambm ser ignorada se o controle da integridade transacional fordesabilitada nas propriedades do
modelo Transactional Integrity =NO. Esta propriedade somente aparecer se o gerador que
vocestiver usando permitir este tipo de controle. (Foxpro for Windowsno 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 deTrabalho) ou transao. Neste
caso, o usurio pode confirmar(COMMIT) ou no (ROLLBACK) as alteraes feitas na base de
dadosdurante a LWU.
vlido somente em transaes que no possuam nem a propriedadeCommit on Exit = YES nem
Commitment = Disabled. No caso dequalquer uma delas existir, a propriedade Confirm
Transactions =YES ser ignorada.
69
Always prompt: mostrar uma mensagem e pedir confirmao dasalteraes em todos os nveis.
Do not prompt on first level: pedir confirmao em todos os nveisda transao, com exceo do
primeiro nvel.O valor default depende do gerador selecionado.NOTA: A regra
Noconfirm(<Atributo>) permite a voc indicar um nvelespecfico que no deve ser pedido
confirmao.
WINDOWS INTERFACE
MenuBar
Esta propriedade usada para associar um menubar a um objeto. Emoutras palavras, o objeto usar
o menubar indicado nesta propriedade. OCombo mostrar todos os menubars existentes.Se um
objeto no tiver um menubar associado, ento um menubardefault ser utilizado.Esta propriedade
vlida somente para Transaes e Work Panels.
Border Style
Esta propriedade especifica o tipo da borda do form. Vlida somentepara os geradores: Visual Basic
e Visual Foxpro.
70
Valores:
Sizeable: este o tipo normal de borda, que : 3D e voc pode mudaro 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 poderser mudado.
Fixed Dialog: a janela ter borda 3D e seu tamanho no poder sermudado.O valor default
Sizeable.
Maximize Button
Especifica se o form deve ter um boto de maximizao. Vlido somentepara geradores: Visual
Basic e Visual Foxpro.Valores:
YES: o form ter boto de maximizao
NO: o form no ter boto de maximizaoO valor default YES.
Minimize Button
Especifica se o form deve ter um boto de minimizao. Vlido somentepara geradores: Visual
Basic e Visual Foxpro.Valores:
-
Form Icon
Esta propriedade utilizada para especificar um nome para o cone doform. Vlido somente para
geradores: Visual Basic e Visual Foxpro.Valores: No possui nenhum valor pr-definido, voc deve
informar o nome docone.
Control Box
Esta propriedade usada para especificar se o menu no canto superioresquerdo da janela ser
ativado com um click do mouse.
71
Valores:
YES: o menu ser ativado com um click do mouse.
NO: o menu no ser ativado com um click do mouse.O valor default YES.
Modal Dialog
Esta propriedade usada para indicar se o objeto utiliza dilogo Modalou no.Dilogo Modal
significa que o programa chamador ficar inativo at que oobjeto chamado seja fechado. Ao
contrrio, o dilogo No-Modal ambos osobjetos ficam ativos ao mesmo tempo, quer dizer, voc
pode trabalhar comambos simultaneamente.Dilogo No-Modal sempre melhor que dilogo
modal, mas nem sempre possvel utiliz-lo. Em particular, quando so passados parmetros e o
objetochamado retorna valores ao objeto chamador, ento o dilogo Modal deve serusado. Os
prompts so um exemplo tpico desse tipo de dilogo, onde atransao espera valores retornados
pelo prompt.Valores:
YES, if parameters specified: Se o objeto tem parmetros ento odilogo Modal ser usado, se no
houver parmetros ento o dilogoNo-modal ser usado.
YES: Dilogo Modal utilizado.
-
Amarelo
Azul
Cinza, esta a cor no GeneXus. No AS/400 convertido paraTurquesa.
Magenta, esta a cor no GeneXus. No AS/400 convertido para Pink(rosa).O valor default :
Default to color rule.
topo-borda3
toopo-direito-canto4
esquerda-borda5
direita-borda6
Boto-esquerdo-canto7
Boto-borda8
Bpto-dirieito-cantoEstes caracteres so enviados diretamente palavra chaveWDWBORDER da
DDS language para telas. Para obter informaes adicionaissobre esta palavra chave, procure no
manual de referncia da DDS.No h valor default para esta preferncia. Isto , se nenhum valor
forespecificado na preferncia, os atributos de tela dependero dos valoresdefault 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 nosprogramas gerados.Valores:
Enabled: O programa gerado COM os controles de integridadetransacional.
Disabled: O programa gerado SEM os controles de integridadetransacional.O valor default
depende do gerador selecionado.
74
NOTA: Esta opo ignorada para Client Server (geradores DB/2 eOracle).Esses DBMs no
permitem a desativao da integridade transacional.
KEY ASSIGNMENT
Exit Key
Esta propriedade usada para alterar a chave de funo relacionada aoExit.Valores: Qualquer
nmero de chave de funo vlida.O valor default 3.
Prompt Key
Esta propriedade usada para alterar a chave de funo relacionada aoPrompt. Esta propriedade
aplica-se somente ao objeto. Esta funo podeinclusive ser desabilitada assinalando-se mesma o
valor 0. Se fordesabilitada, o programa no responde s prompts key e os programas deprompt no
sero gerados.Valores: Qualquer nmero de chave de funo vlida.O valor default 4.NOTA:
Refresh Key
Esta propriedade usada para alterar a chave de funo relacionada aoRefresh.Valores: Qualquer
nmero de chave de funo vlida.O valor default 5.
Insert Mode
Esta propriedade usada para alterar a chave de funo relacionada aoInsert Mode. Esta
propriedade aplica-se somente ao objeto. Esta funo podeinclusive ser desabilitada assinalando-se
mesma o valor default 0, nestecaso, no ser possvel alterar para Modo de Insero na
transao. O cdigopara insero de registros gerado.
75
Valores: Qualquer nmero de chave de funo vlida.O valor default 6.
Previous Record
Esta propriedade usada para alterar a chave de funo relacionada aoPrevious Record. Esta
propriedade aplica-se somente ao objeto. Esta funopode inclusive ser desabilitada assinalando-se
mesma o valor default 0,neste caso, no ser possvel mover-se ao registro anterior e o
cdigocorrespondente no gerado.Valores: Qualquer nmero de chave de funo vlida.O valor
default 7.
Next Record
Esta propriedade usada para alterar a chave de funo relacionada aoNext Record. Esta
propriedade aplica-se somente ao objeto. Esta funo podeinclusive ser desabilitada assinalando-se
mesma o valor default 0, nestecaso, no ser possvel mover-se ao prximo registro e o
cdigocorrespondente no gerado.Valores: Qualquer nmero de chave de funo vlida.O valor
default 8.
Retrieve
Esta propriedade usada para alterar a chave de funo relacionada aoRetrieve. Esta propriedade
aplica-se somente ao objeto. Retrieve no pode serdesabilitada porque aplica-se somente em
Menus.Valores: Qualquer nmero de chave de funo vlida.O valor default 9.
Menu
Esta propriedade usada para alterar a chave de funo relacionada aoacesso ao Menu Bar. Esta
propriedade aplica-se somente ao objeto. Estafuno pode inclusive ser desabilitada assinalando-se
mesma o valor default0, neste caso, no ser possvel acessar o menu bar e o cdigo
Update Mode
Esta propriedade usada para alterar a chave de funo relacionada aoModo de Update. Esta
propriedade aplica-se somente ao objeto. Esta funopode inclusive ser desabilitada assinalando-se
mesma o valor default O,neste caso, no ser possvel alterar para Update na transao e o
cdigo dealterao gerado.Valores: Qualquer nmero de chave de funo vlida.O valor default
11.
Cancel
Esta propriedade usada para alterar a chave de funo relacionada aoCancel.Valores: Qualquer
nmero de chave de funo vlida.O valor default 12.
Delete Mode
Esta propriedade usada para alterar a chave de funo relacionada aoModo Delete. Esta
propriedade aplica-se somente ao objeto. Esta funo podeinclusive ser desabilitada assinalando-se
mesma o valor 0, neste caso, noser possvel alterar o modo para Deleo na transao e o
cdigo de alterao gerado.Valores: Qualquer nmero de chave de funo vlida.O valor default
13.
Select
Esta propriedade usada para alterar a chave de funo relacionada aoSelect. Esta propriedade
aplica-se somente ao objeto. Esta funo podeinclusive ser desabilitada assinalando-se mesma o
valor default 0, nestecaso, o programa no responder chave de autoprompt e o cdigo
deAutoprompt no gerado.Valores: Qualquer nmero de chave de funo vlida.O valor default
16.
77
First Record
Esta propriedade usada para alterar a chave de funo relacionada aoFirst Record. Esta
propriedade aplica-se somente ao objeto. Esta funo podeinclusive ser desabilitada assinalando-se
mesma o valor default 0, nestecaso, no ser possvel acessar o primeiro registro e o cdigo
correspondenteno gerado.Valores: Qualquer nmero de chave de funo vlida.O valor default
19.
Display Mode
Esta propriedade usada para alterar a chave de funo relacionada aoModo de Display. Esta
propriedade aplica-se somente ao objeto. Esta funopode inclusive ser desabilitada assinalando-se
mesma o valor default 0,neste caso, no ser possvel alterar para modo de Display na transao
e ocdigo correspondente gerado.Valores: Qualquer nmero de chave de funo vlida.O valor
default 14.
More Keys
Esta propriedade usada para alterar a chave de funo relacionada aoMore Keys.Valores: Qualquer
nmero de chave de funo vlida.O valor default 24.
78
11. Propriedades das Work Panels
Propriedades permitem definir funes gerais para o objeto.Propriedades das Work Panel incluem
duas principais caractersticas: funesenquanto estiver fazendo a carga e como ser a interface.
11.1. LOADING
LOAD RECORDS
Indica como os registros so carregados no subfile. Normalmente, osubfile carregado mediante
uma requisio explcita.Inicialmente, somente a primeira tela carregada e, conforme o
usurioavana, ento outras telas so carregadas. Isto feito para ganharperformance. Mas em
alguns casos, ns poderemos necessitar carregar osubfile inteiro de uma vez. Para fazer isto,
devemos setar a propriedade LoadRecords como Load All Records. Esta propriedade indica que o
subfile sercarregado por inteiro de uma nica vez.Valores:
Load on request carrega os registros na tela de subfile cada vezque dados so requeridos.
Load all records carrega todos os registros no subfile no EventoLoad.O valor default depende do
gerador selecionado.
LOAD AT STARTUP
Indica se o subfile carregado logo no incio ou aps pedir a parte fixado form. Quando a Work
Panel tem um subfile, o subfile carregado pelaprimeira vez imediatamente aps a tela ser
carregada. Esta propriedade indicaque ns no desejamos que o subfile seja carregado logo no
incio, ao invsdisso, ns queremos que a parte fixa da tela seja pedida antes (normalmenteusadas
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.
79
O valor default depende do gerador selecionado.RESTRIES: Quando no h Tabela Base
associada Work Panel, essapropriedade no tem efeito, e o subfile carregado aps pedir a parte
fixa serpedida.
ALLOW USER TO CANCEL WHILE LOADING
Permite ou inibe o usurio de cancelar a execuo do programa enquantoestiver sendo feita a carga
do subfile. Se esta propriedade for setada comoYES, a Work Panel poder ser cancelada com
ESC.Valores:
YES o programa pode ser cancelado pressionando ESC enquantoestiver sendo feita a carga do
subfile.
NO o programa no pode ser cancelado enquanto estiver sendofeita a carga do subfile.O valor
default depende do gerador selecionado.
AUTOMATIC REFRESH
Esta propriedade muito utilizada quando o subfile composto somentepor variveis e voc deseja
executar um refresh cada vez que houver umamudana na parte fixa da Work Panel.Valores:
Only when variables in conditions change: a work panel trabalha daforma tradicioanl.
When any variable change: o refresh executado cada vez quequalquer varivel da parte fixa da tela
modificado.O valor default depende do gerador selecionado.
REFRESH TIMEOUT (Foxpro for Windows e Visual Basic)
Esta propriedade usada para executar um refresh do subfile sem que ousurio execute nenhuma
opo durante certo perodo de tempo. Este intervalode tempo deve ser especificado em
segundos.Valores: No h valores pr-definidos. Um valor em segundos deve serespecificado. Se 0
ou default so especificados nenhum timeout ser gerado.
80
11.2. WINDOWS INTERFACE
MENUBAR
Esta propriedade usada para associar um menubar a um objeto. Emoutras palavras, o objeto usar
o menubar indicado nesta propriedade. Ocombo mostrar todos os menubars existentes. Se um
objeto no tiver ummenubar associado ento um menubar default ser utilizado. Esta
propriedadesomente vlida para transaes e work panels.
BORDER STYLE
Esta propriedade especifica o tipo da borda do form. Vlida somentepara os geradores: Visual Basic
e Visual Foxpro.Valores:
-
Sizeable: este o tipo normal de borda, que 3D e voc pode mudaro 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 poderser mudado.
Fixed Dialog: a janela ter borda 3D e seu tamanho no poder sermudado.O valor default
Sizeable.
MAXIMIZE BUTTON
Especifica se o form deve ter um boto de maximizao. Vlido somentepara geradores: Visual
Basic e Visual Foxpro.Valores:
YES: o form ter boto de maximizao
NO: o form no ter boto de maximizaoO valor default YES.
81
MINIMIZE BUTTON
Especifica se o form deve ter um boto de minimizao. Vlido somentepara geradores: Visual
Basic e Visual Foxpro.Valores:
YES: o form ter boto de minimizao
NO: o form no ter boto de minimizaoO valor default YES.
FORM ICON
Esta propriedade utilizada para especificar um nome para o cone doform. Vlido somente para
geradores: Visual Basic e Visual Foxpro.Valores: No possui nenhum valor pr-definido, voc deve
informar onome do cone.
CONTROL BOX
Esta propriedade usada para especificar se o menu no canto superioresquerdo 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.O valor default YES.
MODAL DIALOG
Esta propriedade usada para indicar se o objeto utiliza dilogo Modalou no.Dilogo Modal
significa que o programa chamador ficar inativo at que oobjeto chamado seja fechado. Ao
contrrio, com dilogo No-Modal ambos osobjetos ficam ativos ao mesmo tempo, quer dizer, voc
pode trabalhar comambos simultaneamente.
82
Dilogo No-Modal sempre melhor que o dilogo modal, mas nemsempre possvel utiliz-lo.
Em particular, quando so passados parmetros e oobjeto chamado retorna valores ao objeto
chamador, ento o dilogo Modaldeve ser usado. Os Prompts so um exemplo tpico desse tipo de
dilogo, ondea transao espera valores retornados pelo prompt.Valores:
YES, if parameters specified: se o objeto tem parmetros ento odilogo Modal ser usado, se no
houver parmetros ento o dilogoNo-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 carregadocomo 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 aborda ser desenhada de forma
automtica.
YES, user defined border: o form ser gerado como janela popup e aborda pode ser desenhada pelo
usurio no form. Este valor s vlidopara geradores de interface grfica.O valor default depende
do gerador selecionado.NOTA: Quando a tela definida como popup, h algumas limitaes
delinhas e colunas que devem ser respeitados. Se a tela desenhada ultrapassaesses limites, uma
mensagem dada dentro do relatrio de navegao naespecificao.IMPORTANTE: Esta
propriedade no vlida para gerao em ambientewindows.
83
AUTOMATIC BORDER
Exit Key
Esta propriedade usada para alterar a chave de funo relacionada aoExit.Valores: Qualquer
nmero de chave de funo vlida.O valor default 3.
Refresh Key
Esta propriedade usada para alterar a chave de funo relacionada aoRefresh.Valores: Qualquer
nmero de chave de funo vlida.O valor default 5.
85
Cancel
Esta propriedade usada para alterar a chave de funo relacionada aoCancel.Valores: Qualquer
nmero de chave de funo vlida.O valor default 12.
More keys
Esta propriedade usada para alterar a chave de funo relacionada opo More Keys.Valores:
Qualquer nmero de chave de funo vlida.O valor default 24.
86
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 sadaem 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.O valor default depende do gerador selecionado.
Exit Key
Esta propriedade usada para alterar a chave de funo relacionada aoExit.Valores: Qualquer
nmero de chave de funo vlida.O valor default 3.
Refresh Key
Esta propriedade usada para alterar a chave de funo relacionada aoRefresh.Valores: Qualquer
nmero de chave de funo vlida.O valor default 5.
Cancel
Esta propriedade usada para alterar a chave de funo relacionada aoCancel.Valores: Qualquer
nmero de chave de funo vlida.O valor default 12.
88
More keys
Esta propriedade usada para alterar a chave de funo relacionada opo More Keys.Valores:
Exit Key
Esta propriedade usada para alterar a chave de funo relacionada aoExit.Valores: Qualquer
nmero de chave de funo vlida.O valor default 3.
Refresh Key
Esta propriedade usada para alterar a chave de funo relacionada aoRefresh.Valores: Qualquer
nmero de chave de funo vlida.O valor default 5.
Cancel
Esta propriedade usada para alterar a chave de funo relacionada aoCancel.Valores: Qualquer
nmero de chave de funo vlida.
93
O valor default 12.
More keys
Esta propriedade usada para alterar a chave de funo relacionada opo More Keys.Valores:
Qualquer nmero de chave de funo vlida.O valor default 24.
94
14. Propriedades das Web Panels
14.1. FOOTER
FOOTER IMAGE
(
Ainda no implementado)
WEBMASTERS MAIL ADDRESS
Ainda no implementado)
95
15. Propriedades do Modelo Visual Basic
15.1. GENERAL
VISUAL BASIC VERSION
Use esta opo para setar a verso do gerador Visual Basic que serutilizado.Valores:
Visual Basic 4.0 (16 bits)
Visual Basic 4.0 (32 bits)
Visual Basic 5.0O valor default Visual Basic 5.0.
GRID VERSION
O gerador Visual Basic utiliza DataGrid Sheridan (incluindo no produto DataWidgets) para
implementar o grid dos subfiles (NOTA: voc deve instalarSheridans Data Widgets para ser capaz
de executar corretamente suasaplicaes Visual Basic).Esta preferncia usada para especificar a
verso do produto que vocest 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). utilizadapara evitar problemas com a
edio que acontece quando geramos Visual Basic4.0 e executamos sob Windows 3.x.Valores:
Windows 95 a interface do sistema destino ser Windows95
96
Windows 3.x a interface do sistema destino ser Windows3.1 ouWindows3.11O valor default
Windows95.
Caso 1:
Se voc est desenvolvendo uma aplicao numa mquinaexecutando abaixo do Windows 3.11, e a
interface do sistema destino Windows 95, para evitar problemas com os controles de edio voc
devefazer o seguinte:1.
Desenvolver a aplicao (durante a fase de prottipo) com estapreferncia setada para Windows
3.x, para poder prototip-la.2.
Uma vez que a fase de prottipo tenha terminado, mude estapreferncia Windows 95 e gere todos
os programas novamente,ento voc pode distribuir sua aplicao para seus clientes.
Caso 2:
Se voc est desenvolvendo uma aplicao numa mquinaexecutando abaixo do Windows 95, e a
interface do sistema destino Windows 3.11, sete esta preferncia Windows 3.x, e teste a aplicao
comose estivesse no ambiente do cliente.
Caso 3:
Se voc est desenvolvendo uma aplicao numa mquinaexecutando abaixo do Windows 95, e a
interface do sistema destino Windows 95, voc no ter nenhum problema.
Caso 4:
Se voc est desenvolvendo uma aplicao numa mquinaexecutando 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 dedocumento 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, todoobjeto considerado child window da janela principal (esta a interfaceutilizada pela
Microsoft Word).Valores:
YES Aplicao MDI ser gerada
NO Aplicao SDI ser geradaO valor default YES.
97
NOTA: Se o valor dessa preferncia setada como NO (SDI), e maistarde modificada para YES
(MDI) voc deve forar a gerao de todos osprogramas.
ALLOW COLUMN RESIZING
Com esta opo voc pode permitir ao usurio mudar o tamanho das colunas dosubfile em tempo de
execuo.Valores:
YES o usurio ser capaz de modificar o tamanho das colunas dosubfile a qualquer momento.
NO o tamanho das colunas do subfile do programa gerado serespecificado no desenho do mesmo
e o usurio no ser capaz demud-los em tempo de execuo.O valor default YES.
SKIP READ-ONLY COLUMNS
Esta preferncia usada para setar o comportamento da Tab Key emsubfiles 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 seremread-only ou no.O valor
default YES.NOTA: Esta preferncia no afeta o comportamento do mouse, porque omouse pode
ser posicionado em qualquer campo.
CONFIRM
Esta propriedade, baseada na sua escolha, vai estabelecer se vocdeseja confirmar as seguintes
aes
Insert, Delete e Update executadas a nvel de Transao.
Confirm each action: o usurio ser questionado sobreconfirmao aps ter finalizado a entrada de
dados nas aes de
98
Insero e Alterao ou selecionando o modo de deleo em algumnvel da transao.
Do not confirm each action: o usurio NO ser questionadosobre confirmao aps ter finalizado
a entrada de dados nasaes de Insero e Alterao ou selecionando o modo de deleoem algum
nvel da transao.
Entrada de parmetros em Reports e Procedures
Confirm each action: aps a entrada de parmetros nasReports/Procedures, o usurio ser
questionado sobre aconfirmao dos mesmos.
tabela que esto envolvidos na transao so controlados. Oproblema dessa implementao aparece
quando h usurios quebaseiam 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 dosatributos envolvidos na transao. Este parece ser o nvel
decontrole mais indicado, pois situaes incontrolveis no existiro.
O valor default : Check updated tables only.NOTA: Dependendo da linguagem e plataforma que
voc est gerando, odilogo Pseudo conversacional implementado para todas as operaes
100
executadas na Transao (Cobol e RPG para AS/400) ou somente no nvel datransao (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 deassinalar o nome que desejar.
MAIL FUNCTIONS
Voc deve setar esta preferncia para YES para ser capaz de usar asmail functions.Valores:
YES: o desenvolvedor ser capaz de executar GeneXus mail functions
NO: o desenvolvedor NO ser capaz de executar GeneXus mailfunctions.O valor default
NO.NOTA: voc necessitar ter corretamente instalado todos oscomponentes para enviar
mensagens via MAPI (Microsoft Messaging API) etambm ter instalado no somente o Mail
(Microsoft Mail e/ou compatvel) mastambm o arquivo VBX para utilizar a interface
(MSMAPI.VBX).
GRAPHIC FUNCTIONS
O gerador GeneXus Visual Basic prev uma srie de funes paracustomizar seus grficos:
GXMKGR, GXKILLGRAPH, GXSETGRAPHPROPERTY,GXGETGRAPHPROPERTY.Voc
deve setar esta preferncia para YES para ser capaz de usar estasfunes grficas e comandos
grficos do GeneXus.Valores:
YES: Voc ser capaz de chamar as funes grficas usando ocomando CALL do GeneXus e o
comando GeneXus graph.
NO: Voc NO ser capaz de chamar as funes grficas usando ocomando CALL do GeneXus e o
comando GeneXus graph.
101
Tab, Shift-Tab: o movimento de avano feito com a tecla Tab e acombinao das teclas Shift-Tab
faz o movimento de volta.
Enter, Down Arrow, Up Arrow, Tab, Shift-Tab: as teclas Enter, Setapara baixo e Tab sero
interpretadas como movimento para oprximo campo e a Seta para Cima e Shift-tab sero
interpretadascomo movimento para o campo anterior.
+, Down Arrow, Up Arrow, Tab, Shift Tab: as teclas +, Enter, Setapara baixo e Tab sero
interpretadas como 'movimento' para o
106
prximo campo e a Seta para Cima e Shift-Tab sero interpretadascomo 'movimento' para o campo
anterior.O valor default : Tab, Shift-Tab.
ESC KEY ACTION
Essa preferncia somente afeta transaes com mltiplos nveis epermite voc estabelecer como
voc deseja que a tecla ESC funcione.Valores:
Exit Form: voc abortar o programa que est executando aopressionar 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 quedeseja 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 dotipo DATA devem ser
Esta preferncia se aplica gerao automtica de links entre as WebPanels. Esses links so gerados
quando um comando CALL entre duas WebPanels detectado. O objetivo identificar qual o
protocolo default a serusado 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 indicaque o protocolo a ser usado
Secure Hypertext Transfer Protocol.
Unsecure (HTTP): fora a gerao do protocolo HTTP. HTTP indicaque 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 umcdigo
gerado mais verstil (pode ser executado com qualquer protocolo).
109
Entretanto, h alguns browsers (normalmente verses antigas) que nosuportam links sem protocolo
especificado. Por esta razo, e se voc desejasuportar tantos browsers quanto possvel, ns
recomendamos no utilizar Donot specify nesta preferncia.NOTA: se o protocolo HTTPS
usado, voc deve ter Secure WebServer.
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 mostradosmensagens de erro e advertncia quando o Type Control
carregado. Mesmoque o tipo de controlador no dependa da plataforma em que se est gerandouma
aplicao, o tipo de mensagem que mostrada depende da plataforma.Em particular, quando uma
gerao PC executada (o mesmo se aplicapara prottipo ou Produo) as mensagens so Warnings
que permitem que vocprossiga na gerao dos programas. Entretanto, o AS/400 mostra
mensagensde 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 suacompatibilidade em clculos ou funes.Por exemplo: &no Numrico(10)&char
Caracter(10)&data DateVoc pode definir a seguinte expresso em
ProgramSource/Layout/Events/Rules:&no = &data + month(&char)
110
A expresso acima tem dois problemas:A funo month( ) requer um parmetro tipo Date.Uma
expresso de igualdade obriga que ambos os lados da igualdadesejam do mesmo tipo.Assim o
diagrama de navegao ir mostrar todos os Warnings (ou errosdependendo da plataforma)
indicando que a expresso no correta:
Type mismatch in expression <Invalid Expression> <at line X> (Tiposno so compatveis) onde
<Invalid Expression> parte da expressoonde o erro foi detectado e <at line X> indica a linha da
procedure oureport onde o erro foi encontrado.
Type mismatch in Assignment <Invalid Assignment> <at line X> (Tiposno so compatveis na
igualdade) onde <Invalid Assignment> mostrauma assinalao invlida.Ex.: &no=&data +
month(&char)Do exemplo acima as mensagens mostradas sero as seguintes: vamossupor 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 15Tipos de controle em
Conditions:Condies nas Procedures, Reports e Work Panels so controladas bemcomo as
clusulas WHERE, IF ou DO WHILE.Por exemplo:IF str(&no,10) > CTOD(&data).....ENDIFAs
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 asassinalaes so corretas e se as
condies so corretas. (Essescasos j forma mostrados em Expressions e Conditions).
111
-