4D Pack

Introdução 4D_Pack : ANSI Streams 4D_Pack : Picture Files 4D_Pack : Printing 4D_Pack : User Interface 4D_Pack : Utilities Lista alfabética dos comandos

- 1 -

Introdução

Apresentação de 4D_Pack

- 2 -

Apresentação de 4D_Pack

O plug-in 4D_Pack oferece aos desenvolvedores 4D úteis rotinas adicionais.Os nomes dos comandos 4D_Pack tem o prefixo “AP” para evitar toda confusão com os comandos 4D. Também utilizam aconvenção maiúsculas/minúsculas dependendo de se são comandos ou funções.

Instalação

Instale o plug-in 4D_Pack ao igual que qualquer outro plug-in 4D: coloque ele na pasta Plugins localizada junto a aplicaçãoexecutável ou ao lado do arquivo estrutura da base. Para mais informação, consulte a seção Instalar plugins ou componentes noManual de Desenho.

A partir de 4D v14 (Windows) e de 4D v14 R5 (OS X), o plug-in 4D Pack também se oferece em uma versão 64 bits. Desta formavocê pode tomar vantagem da arquitetura de 64 bits em uma configuração utilizando 4D Server Windows 64 bits ou 4D Server OSX 64 bits. A versão de 64 bits está incluída no pacote do plug-in. Não se requer nenhuma instalação específica.

Nota de compatibilidade: o comando _o_AP Save BMP 8 bits não é suportado na versão de 64 bits de 4D Pack para OS X.

Comandos 4D Pack excluídos

Devido as mudanças na tecnologia e a integração continua de novas funcionalidades 4D, os comandos 4D Pack foram excluídosdas versões sucessivas. Nesta seção se enumeram os comandos que foram excluídos, assim como suas alternativasrecomendadas.

Comandos eliminados em 4D Pack v14

- 3 -

Comandoseliminados Substituído por (se aplica)

APAVAILABLEMEMORY

GET MEMORY STATISTICS

AP CLOSEHELP, APHELPINDEX, APHELP ONHELP, APHELP ONKEY

Comandos obsoletos - A aplicação Windows Help (WinHlp32.exe) já não está integrada em Windows a partir deWindows Vista.

AP Createmethod, APModifymethod

METHOD SET CODE("myMeth";vCode;*) METHOD SETATTRIBUTE("myMeth";vInvisible;2;v4DAction;3;vWebService;4;vWSDL;5;vExported;7;vSQL;8; vRemote;1024;vFolderName;*)

AP Doesmethodexist

METHOD GET NAMES($arrNames;"myMeth") $exists:=(Size of array($arrNames)>0) // -> True se o método existe

AP Getpicture type Comandos do tema "Imagens"

AP Gettemplates Comandos obsoletos

_APExternalclock, APSETCLOCK

TimePicker Widget (4D v14)

AP RectDragger SET DRAG ICON

APTimestampto GMT

$laDate:=String(Curent date;ISO Date GMT;Current time) // devolve, por exemplo "2013-05-06T12:19:23Z"

AP GETPARAM, APSETPARAM

Comandos obsoletos - Os parêmetros secundários administrados por estes comandos já não se mantém.

Nota aos usuários de versões anteriores de 4D_Pack AP PICT DRAGGER -> Utilize as funções de arrastar e soltar integradas de 4D (MouseDown, MouseX e MouseY no caso doseventos de tipo “clique”)AP PICT UPDATER and %AP Pict displayer -> Utilize um campo imagemAP Read Picture BLOB -> Utilize BLOB TO PICTUREAP Read Picture File - > Utilize READ PICTURE FILEAP Save GIF -> Utilize CONVERT PICTURE + WRITE PICTURE FILEAP SET PICT MODE -> Utilize SET FORMATAP Select document -> Utilize Select documentAP Set palette -> Utilize Select RGB ColorAP Sublaunch -> Utilize LAUNCH EXTERNAL PROCESSAP PrintDefault -> Utilize AP BLOB to print settings + AP Print settings to BLOBAP Text to PrintRec -> Utilize AP BLOB to print settings + AP Print settings to BLOBAP PrintRec to text -> Utilize AP BLOB to print settings + AP Print settings to BLOBAP PrValidate -> Utilize AP BLOB to print settings + AP Print settings to BLOBAP Toolbar installed -> Utilize Tool bar height (devolve 0 se a barra de ferramentas está oculta)AP SET WEB FILTERS -> Utilize SET DATABASE PARAMETER e Get database parameterAP ShellExecute (Mac OS) --> Utilize LAUNCH EXTERNAL PROCESSAP Add table and fields -> Utilize o motor 4D SQLAP Create relation -> Atualmente não há uma solução alternativa

- 4 -

4D_Pack : ANSI Streams

_o_AP FCLOSE _o_AP fopen _o_AP FPRINT _o_AP fread

- 5 -

_o_AP FCLOSE

_o_AP FCLOSE ( valorFopen ) Parâmetro Tipo DescriçãovalorFopen Inteiro longo Referencia da porta ou do arquivo devolvido pelo comando AF fopen

Descrição

O comando _o_AP FCLOSE fecha a porta ou o arquivo aberto anteriormente pelo comando _o_AP fopen.

- 6 -

_o_AP fopen

_o_AP fopen ( toOpen ; modo ) -> Resultado Parâmetro Tipo DescriçãotoOpen String Nome do arquivo ou porta a abrirmodo Inteiro Modo de abertura 0 = só escritura 1 = só leituraResultado Inteiro longo Valor a utilizar com AP FPRINT, ou 0 se o arquivo ou a porta não podem ser abertos

Descrição

O comando _o_AP fopen chama ao comando ANSI C fopen, que permite a abertura de portas em série ou em paralelo (emWindows) ou a criação direta de arquivos.

O valor devolvido por esta função se utiliza com o comando _o_AP FPRINT para escrever na porta ou para escrever o arquivo. Oarquivo ou porta aberta pode ser fechada com o comando _o_AP FCLOSE.

Nota: Em Mac OS, esta função só funciona com a criação direta de arquivos.

Exemplo 1

Escritura de "olá mundo" na porta paralela:

port:=_o_AP fopen("LPT1";0) _o_AP FPRINT(port;"olá mundo") _o_AP FCLOSE(port)

Exemplo 2

Escritura de "olá mundo" na porta serial:

port:=_o_AP fopen("COM1";0) _o_AP FPRINT(port;"olá mundo") _o_AP FCLOSE(port)

Exemplo 3

Escritura de "olá mundo" no arquivo "meuArquivo":

port:=_o_AP fopen("C:\MyDoc.txt";0) _o_AP FPRINT(port;"olá mundo") _o_AP FCLOSE(port)

Exemplo 4

Leitura de um arquivo:

port:=_o_AP fopen("C:\MyDoc.txt";1) MyVar:=_o_AP fread(port) _o_AP FCLOSE(port)

- 7 -

_o_AP FPRINT

_o_AP FPRINT ( valorFopen ; dados ) Parâmetro Tipo DescriçãovalorFopen Inteiro longo Referencia da porta ou do arquivo devolvido pelo comando AF fopendados Texto Dados a enviar à porta ou arquivo

Descrição

O comando AP FPRINT envia o texto dados especificados à porta ou ao arquivo aberto pelo comando _o_AP fopen cujareferencia é passada em valorFopen.

Os dados se enviam como estão, sem nenhum tipo de conversão. Como 4D utiliza a tabela ASCII Macintosh internamente, vocêdeve realizar a conversão necessária em Windows. Para isso, utilize o comando 4D _o_Mac to Win.

- 8 -

_o_AP fread

_o_AP fread ( valorFopen ) -> Resultado Parâmetro Tipo DescriçãovalorFopen Inteiro longo Referencia da porta ou do arquivo devolvido pelo comando AF fopenResultado Texto Texto da porta ou do arquivo

Descrição

_o_AP fread lê os dados da porta ou do arquivo aberto pelo comando _o_AP fopen cuja referencia é passada em valorFopen edevolve em forma de texto.

Os dados se devolvem sem nenhum tipo de conversão. Como 4D utiliza internamente a tabela ASCII Macintosh, deve realizar aconversão necessária em Windows. Para isso, utilize o comando 4D _o_Win to Mac.

- 9 -

4D_Pack : Picture Files

AP Is Picture Deprecated _o_AP Save BMP 8 bits

- 10 -

AP Is Picture Deprecated

AP Is Picture Deprecated ( ptrPict ) -> Resultado Parâmetro Tipo DescriçãoptrPict Ponteiro Ponteiro para o campo de imagem ou variável a testarResultado Inteiro longo 0 = formato válido, 1 = formato obsoleto (PICT)

Descrição

O comando AP Is Picture Deprecated devolve 1 se a imagem referenciada pelo parâmetro ptrPict contém o formato PICT(obsoleto) PICT e 0 em caso contrário. Uma imagem será considerada obsoleta se está em formato PICT ou se contém o formatoPICT (imagens inseridas por arrastar soltar podem incluir vários formatos). Em ptrPict, passe um ponteiro ao campo imagem, a variável imagem ou o elemento de array imagem 4D a provar. Este comando tem a intenção de preparar o desenvolvimento de suas aplicações para as próximas versões principais de 4D. Naverdade, o formato "PICT" Mac foi declarado obsoleto por Apple desde várias versões atrás de Mac OS (ver a descrição doformato PICT em Wikipedia). Se manteve em 4D por razões de compatibilidade, mas que já não é compatível a partir de 4D v14.Para se preparar para a migração de suas aplicações, pode começar a usar este comando com o fim de detectar todas asimagens PICT em sua base e converter elas a um formato nativo (por exemplo PNG) com ajuda do comando CONVERT PICTURE.Tenha em conta que uma vez convertidas a um formato, as imagens só contém este novo formato.

Nota: A eliminação do formato PICT requer de um análises prévio no caso das imagens destinadas a impressão. O formato PICT éum formato vetorial, pode ser utilizado em particular em Windows para impressão, quando está presente. Assim, neste contexto, épreferível converter as imagens PICT a outro formato vetorial, por exemplo EMF.

Exemplo

Você quer provar e converter todas as imagens da livraria:

C_LONGINT($vlPict;$vPictCount;$vPictRef;$vTotal) C_TEXT($vPictName) C_POINTER($vPointer) C_PICTURE($vpPict) ARRAY TEXT($arrPictNames;0) ARRAY LONGINT($arrPictRefs;0) $vTotal:=0 PICTURE LIBRARY LIST($arrPictRefs;$arrPictNames) $vPictCount:=Size of array($arrPictRefs) If($vPictCount>0) For($vlPict;1;$vPictCount) // para cada imagem $vPictRef:=$arrPictRefs{$vlPict} $vPictName:=$arrPictNames{$vlPict} GET PICTURE FROM LIBRARY($arrPictRefs{$vlPict};$vpPict) $vPointer:=->$vpPict // pass a pointer $isObs:=AP Is Picture Deprecated($vPointer) If($isObs=1) // if format is obsolete CONVERT PICTURE($vPointer->;".PNG") // conversão a png // e guardar na livraria SET PICTURE TO LIBRARY($vPointer->;$vPictRef;$vPictName) $vTotal:=$vTotal+1 End if End for ALERT(String($vTotal)+" picture(s) out of "+String($vPictCount)+" were converted to png.") Else ALERT("A livraria de imagens está vazia") End if

- 11 -

_o_AP Save BMP 8 bits

_o_AP Save BMP 8 bits ( imagem ; arquivo ) -> Resultado Parâmetro Tipo Descriçãoimagem Imagem Nome de uma variável imagem 4Darquivo Texto Nome do arquivo na qual o BMP será guardadoResultado Inteiro longo 0, se a operação foi um sucesso; caso contrário um código de erro do sistema

Descrição

Nota de compatibilidade:

este comando é obsoleto, só se conserva por razões de compatibilidade e será eliminado em futuras versões dos plug-in. Serecomenda usar os comandos de 4D das "imagens" do tema.Este comando não é suportado na versão 64 bits de 4D Pack para OS X.

_o_AP Save BMP 8 bits guarda qualquer variável imagem 4D em formato BMP em 8 bits não comprimidos (256 cores). Se umarquivo com o mesmo nome se encontra no lugar onde deseja guardar a imagem, será substituído sem prévio aviso. Este comandofunciona nas plataformas Macintosh e Windows.

Se a operação se completou com sucesso, a função devolve 0, caso contrário, devolve um código de erro negativo.

- 12 -

4D_Pack : Printing

AP BLOB to print settings AP Print settings to BLOB

- 13 -

AP BLOB to print settings

AP BLOB to print settings ( paramImp ; paramTipo ) -> Resultado Parâmetro Tipo DescriçãoparamImp BLOB BLOB com os parâmetros de impressãoparamTipo Inteiro longo 0 = configuração e impressão, 1 = impressãoResultado Inteiro longo 1 = Operação com sucesso, 0 = sem impressora atual, -1 Parâmetros incorretos

Descrição

O comando AP BLOB to print settings substituição a configuração de impressão atual de 4D pelos parâmetros armazenados noBLOB paramImp. Este BLOB deve ter sido gerado pelo comando AP Print settings to BLOB.O parâmetro paramImp contém dois tipos de parâmetros:

Parâmetros de configuração: papel, orientação, escala,Parâmetros de impressão tais como: número de cópias, alimentação, etc.

Pode optar por carregar só os parâmetros de impressão.Se passar 0 em tipoParam ou omite este parâmetro, todos os parâmetros se utilizam. Se passar 1, somente se utilizam osparâmetros de impressão, os parâmetros de desenho permanecem sem mudanças.Os novos parâmetros de impressão se aplicam a toda base e por toda a sessão, sempre e quando nenhum comando, como PAGESETUP, SET PRINT OPTION ou PRINT SELECTION sem o parâmetro > os modifique.Os parâmetros definidos são utilizados particularmente pelos comandos PRINT SELECTION, PRINT LABEL, PRINT RECORD,Print form e QR REPORT, assim como pelos comandos de menu de 4D, incluindo os do entorno Desenho.Os comandos PRINT SELECTION, PRINT LABEL e PRINT RECORD devem ser chamados com o parâmetro > (se corresponde)para que os valores definidos por AP BLOB to print settings se conservem.Nota: Os parâmetros de impressão não tem o mesmo formato em Windows e Mac OS. Portanto, a compatibilidade do BLOBparamImp entre as duas plataformas não está garantida.O comando devolve 1 se o BLOB foi carregado corretamente, 0 se não se seleciona a impressora atual e -1 se o BLOB é incorreto.

- 14 -

AP Print settings to BLOB

AP Print settings to BLOB ( paramImp ) -> Resultado Parâmetro Tipo DescriçãoparamImp BLOB BLOB que recebe os parâmetros de impressãoResultado Inteiro longo Código de erro: 1 = Operação bem sucedida 0 = sem impressora atual

Descrição

O comando AP Print settings to BLOB guarda os parâmetros de impressão atuais de 4D no BLOB paramImp.O parâmetro paramImp guarda todos os parâmetros utilizados para a impressão:

Parâmetros de configuração: papel, orientação, escala,Parâmetros de impressão como: número de cópias, alimentação, etc.

O BLOB gerado não deve ser modificado por programação; só pode ser utilizado pelo comando AP BLOB to print settings.O comando devolve 1 se o BLOB foi gerado corretamente e 0 se não foi selecionada nenhuma impressora atual.

- 15 -

4D_Pack : User Interface

AP FULL SCREEN AP NORMAL SCREEN

- 16 -

AP FULL SCREEN

AP FULL SCREEN Este comando não requer parâmetros

Description

O comando AP FULL SCREEN permite ocultar a barra de menus e a barra de título da janela da aplicação 4D e passar esta janelaa tela completa.

Este comando permite usar toda a tela, o que é muito interessante por exemplo no caso de uma aplicação multimedia ou de umjogo.Nota: Este comando só funciona em Windows.

- 17 -

AP NORMAL SCREEN

AP NORMAL SCREEN Este comando não requer parâmetros

Descrição

O comando AP NORMAL SCREEN permite mudar o tamanho da barra de menus e da barra de título ocultas pelo comando APFULL SCREEN.

Este comando só funciona em Windows.

- 18 -

4D_Pack : Utilities

AP Get field infos AP Get table info AP Get tips state AP SET TIPS STATE _o_AP Get file MD5 digest _o_AP ShellExecute

- 19 -

AP Get field infos

AP Get field infos ( numTabela ; numCampo ; tabelaRel ; campoRel ; atributos ; lista ) -> Resultado Parâmetro Tipo DescriçãonumTabela Inteiro Número de tabelanumCampo Inteiro Número do campotabelaRel Inteiro Tabela relacionadacampoRel Inteiro Campo relacionadoatributos Inteiro longo Atributos do campolista String Lista de seleçãoResultado Inteiro Código de erro

Descrição

AP Get field infos devolve informação específica sobre um campo.Dado o número de tabela e de campo, o comando devolve a tabela e número de campo associados, respectivamente.Se não há relação com o campo dado, tabelaRel e campoRel tomam o valor 0.Cada um dos 16 bits de atributos tem um significado preciso. Cada bit pode ser lido graças aos Operadores de bits da linguagem4D.

Bit: Vale 1 se o campo é: Ignorado se o tipo é15 Indexado Texto, Imagem, Subtabela ou Blob14 Indexado único Texto, Imagem ou Subtabela ou Blob ou se o bit 15 vale 013 Obrigatório Subtabela12 Lista de seleção Imagem, Subtabela ou Blob11 Modificável Subtabela10 Editável Subtabela8 Invisível6 uma relação automática Muitos a 1 Texto, Imagem, Subtabela ou Blob5 uma relação automática 1 a Muitos Texto, Imagem, Subtabela ou Blob2 e1

uma relação automática 1 a Muitos cuja integridadereferencial é:00 A integridade referencial não está ativa01 Não modifica os registros relacionados10 Eliminação dos registros relacionados11 Eliminação de registros relacionados não permitidos

0 uma relação automática N a 1 com atualização automática Texto, Imagem, Subtabela, Blob, ou se o bit 5 não foidefinido

- 20 -

AP Get table info

AP Get table info ( numTabela ; invisivel ; eliminaçao ) -> Resultado Parâmetro Tipo DescriçãonumTabela Inteiro Número de tabelainvisivel Inteiro 1, se a tabela é invisível 0, se a tabela é visíveleliminaçao Inteiro 1, eliminação física dos registros 0, eliminação lógica dos registrosResultado Inteiro Código de erro

Descrição

AP Get table info devolve informação sobre as tabelas 4D.

Dado o número da tabela, o parâmetro invisivel toma o valor 1 se a tabela se declara como invisível em modo Desenho, casocontrário toma o valor 0.

A variável eliminaçao toma o valor 1 para a eliminação física dos registros ou 0 para a eliminação lógica. A eliminação física dosregistros é mais lenta que a lógica, mas impede a reaparição do registro em caso de reconstrução da base para análises dosmarcadores.

- 21 -

AP Get tips state

AP Get tips state -> Resultado Parâmetro Tipo DescriçãoResultado Inteiro longo Estado das mensagens de ajuda de 4D

Descrição

AP Get tips state devolve 1 se as mensagens de ajuda se mostram; caso contrário devolve 0.

- 22 -

AP SET TIPS STATE

AP SET TIPS STATE ( estado ) Parâmetro Tipo Descriçãoestado Inteiro Estado das mensagens de ajuda 0 = Não mostrar as mensagens 1 = Mostrar as mensagens

Descrição

O comando AP SET TIPS STATE permite mostrar ou não as mensagens de ajuda.

- 23 -

_o_AP Get file MD5 digest

_o_AP Get file MD5 digest ( viaArquivo ; digest ; fork ) -> Resultado Parâmetro Tipo DescriçãoviaArquivo Texto Via completa do arquivodigest Texto Digest MD5 do arquivofork Inteiro longo 0=Data fork, 1=Resource forkResultado Inteiro longo Código do erro

Descrição

Nota de compatibilidade: A partir de 4D v13, o comando _o_AP Get file MD5 digest é obsoleto e não deve ser utilizado. Deveser substituído pelo comando 4D Generate digest . _o_AP Get file MD5 digest se conserva por razões de compatibilidade.

- 24 -

_o_AP ShellExecute

_o_AP ShellExecute ( nomeArquivo ; modo ; param ) -> Resultado Parâmetro Tipo DescriçãonomeArquivo String Nome do arquivo ou do documento a executarmodo Inteiro longo Estado da janela ao abrirparam Texto Parâmetros da aplicaçãoResultado Inteiro longo 0, se a execução do comando é correta; caso contrário código de erro

Descrição

Nota de compatibilidade: Este comando é obsoleto, somente se conserva por razões de compatibilidade e será eliminado emfuturas versões do plug-in. Se recomenda usar o comando LAUNCH EXTERNAL PROCESS de 4D. Leve em conta que desde aversão 11.0 de 4D, AP ShellExecute só funciona em Windows.

Nota: Este comando só funciona em Windows. Em Mac OS, não tem nenhum efeito.

O comando _o_AP ShellExecute permite lançar uma aplicação ou abrir um documento desde uma base 4D.

No parâmetro nomeArquivo, passe o nome ou via de acesso completa (absoluta) do arquivo a lançar. Quando a aplicação oudocumento a abrir se encontra junto a estrutura da base, é possível passar só o nome de arquivo ou uma via de acesso relativa.Só tem que indicar o nome do documento e Windows se encarrega da execução da aplicação associada.

O parâmetro modo permite especificar o modo de visualização da janela na que será lançada a aplicação:

Se passar 0, a janela aparecerá normal;Se passar 1, a janela aparecerá na tela completa;Se passar 2, a janela será reduzida e aparecerá na barra de tarefas de Windows.

O parâmetro param permite passar todo tipo de parâmetro adicional que possa ser necessário para a aplicação executada. Porexemplo, se utiliza este comando para lançar um navegador web, pode passar um URL específico neste parâmetro.

Exemplo 1

Este exemplo abre um documento de tipo Word® localizado na raiz do disco principal:

`Em Windows $err:=_o_AP ShellExecute("C:\Test.doc")

Exemplo 2

Este exemplo lança o navegador de Internet browser por padrão na tela completa no site de 4D:

$err:=_o_AP ShellExecute("www.4d.com";"1")

Exemplo 3

Este exemplo abre o site de 4D em tela completa em Netscape® sem importar qual seja o navegador de Internet por padrão:

$err:=_o_AP ShellExecute("C:\Program Files\Netscape\NETSCAPE.EXE";"1";"www.4d.com")

Exemplo 4

Este exemplo abre o Explorador Windows em uma janela normal e mostra o conteúdo da pasta Music:

$err:=_o_AP ShellExecute("C:\WINDOWS\explorer.exe";0;"C:\Music")

- 25 -