4D Doc Center : Create resource file

4D v12.4

Create resource file


Create resource file ( resNomArq {; tipoArquivo {; *}} ) -> Resultado

Parâmetro	Tipo	Descrição
resNomArq	cadeia	Nome curto ou longo do arquivo de resources, ou cadeia vazia para caixa de diálogo Salvar Arquivo
tipoArquivo	cadeia	Tipo de arquivo Mac OS (cadeia de 4 caracteres) ou extensão de arquivo Windows (cadeia de 1 a 3 caracteres) ou, se for omitido, um documento Resource ("res"/.RES).
*		Se passado = usar data fork
Resultado	DocRef	Número de referência do arquivo de Resouce

Descrição

O comando Create resource file cria e abre um novo arquivo de recursos a partir do nome ou rota de aceso completa que é passada em resNomArq.

Se passa um nome de arquivo, o arquivo será localizado na mesma pasta que o arquivo de estrutura do banco. Passe uma rota de acesso completa para criar um arquivo de recursos em outra pasta.

Se o arquivo já existir e não está aberto, Create resource file o substitui pelo novo arquivo de recursos vazio. Se o arquivo estiver aberto, se retorna um erro de E/S.

Se passa uma cadeia vazia em resNomArq, aparece a caixa de diálogo de guardar arquivos, permitindo ao usuário escolher a localização do arquivo de recursos a criar. Se cancela o diálogo, não é criado nenhum arquivo de recursos; Create resource file retorna um valor nulo em DocRef e a variável sistema OK toma o valor 0.

Se o arquivo de recursos se cria e abre corretamente, Create resource file retorna seu número de referência do arquivo de recursos e a variável OK toma o valor 1. Se o arquivo de recursos não puder ser criado, um erro é gerado.

Em Macintosh, o tipo por padrão de um arquivo criado com Create resource file es “res ”. Em Windows, a extensão do arquivo por padrão es “.res”. Para criar um arquivo de outro tipo:

Em Macintosh, passe o tipo do arquivo no parâmetro opcional tipoArquivo.
Em Windows, passe em tipoArquivo uma extensão Windows de 1 a 3 caracteres ou um tipo de arquivo Macintosh associado com a ajuda do comando MAP FILE TYPES.

Por padrão, se for omitido o parâmetro *, o comando cria e abre o recurso fork do arquivo. Se se passa o parâmetro *, o comando cria e abre o data fork do arquivo (utilizável em Mac OS e Windows). Para maior informação, consulte a seção Recursos.

Lembre chamar CLOSE RESOURCE FILE para o arquivo de recursos. Note, entretanto, que ao sair da aplicação (ou ao abrir outro banco de dados), 4D fecha automaticamente todos os arquivos de recursos abertos utilizando Create resource file ou Open resource file

Exemplo 1

O exemplo a seguir cria e abre, no Windows o arquivo de recursos “MinhasPrefs.res” localizado na pasta do banco:

$vhResArquivo:=Create resource file("MinhasPrefs";*)

Em Macintosh, o exemplo trata de criar e abrir o arquivo “MinhasPrefs”.

Exemplo 2

O exemplo a seguir cria e abre em Windows o arquivo de recursos “MinhasPrefs.rsr” localizado na pasta do banco:

$vhResArquivo:=Create resource file("MinhasPrefs";"rsr")

Em Macintosh, o exemplo cria e abre o arquivo “MinhasPrefs”.

Exemplo 3

O exemplo a seguir mostra a caixa de diálogo de salvar arquivos:

 $vhResArquivo:=Create resource file("")

 If(OK=1)

    ALERT("Acaba de criar “"+Document+"”.")

    CLOSE RESOURCE FILE($vhResArquivo)

 End if

Variáveis e conjuntos do sistema

Se o arquivo de recursos é criado e aberto corretamente, a variável OK toma o valor 1. Se o arquivo de recursos não puder ser criado, ou se o usuário clicou em Cancelar na caixa de diálogo de salvar arquivos, a variável OK toma o valor 0 (zero).

Se o arquivo de recursos é criado e abre corretamente, através da caixa de diálogo de salvar arquivos, a variável sistema Document contém a rota de acesso ao arquivo.

Gestão de erros

Se o arquivo de recursos não pode ser criado e aberto por um problema de recurso o E/S, é gerado un erro. Pode interceptar este erro com a ajuda de um método de gestão de erros instalado pelo comando ON ERR CALL.