4D v16.3
GET RESOURCE
- Manual de linguagem 4D
-
- Recursos
-
- Recursos
- CLOSE RESOURCE FILE
- GET ICON RESOURCE
- Get indexed string
- GET PICTURE RESOURCE
- GET RESOURCE
- Get resource name
- Get resource properties
- Get string resource
- Get text resource
- Open resource file
- RESOURCE LIST
- RESOURCE TYPE LIST
- STRING LIST TO ARRAY
- _o_ARRAY TO STRING LIST
- _o_Create resource file
- _o_DELETE RESOURCE
- _o_Get component resource ID
- _o_SET PICTURE RESOURCE
- _o_SET RESOURCE
- _o_SET RESOURCE NAME
- _o_SET RESOURCE PROPERTIES
- _o_SET STRING RESOURCE
- _o_SET TEXT RESOURCE
GET RESOURCE
| GET RESOURCE ( resTipo ; resNum ; resDados {; resArquivo} ) | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| resTipo | String |
|
tipo de resource de 4 caracteres | |||||
| resNum | Inteiro longo |
|
Número do recurso | |||||
| resDados | BLOB |
|
Campo BLOB ou variável para receber os dados | |||||
|
Conteúdos do resource | |||||||
| resArquivo | refDoc |
|
Número de referência do arquivo Resource, ou todos os arquivos de referência abertos, se omitido | |||||
o comando GET RESOURCE retorna no campo o a variável BLOB resDados o conteúdo do recurso cujo tipo e número se passa em resTipo e resNum.
Importante: deve passar uma string de 4 caracteres em resTipo.
Se não se encontra o recurso, o parâmetro resDados não muda e a variável OK toma o valor 0 (zero).
Se passa um número de referência de arquivo de recursos válido em resArquivo, o recurso é procurado apenas nesse arquivo. Se não passa resArquivo, a primeira ocorrência do recurso encontrada na string de arquivos de recursos é retornada.
Nota: o tamanho de um recurso pode ser de vários megabytes.
Lembre que trabalha com recursos baseados em Mac OS. Sem importar a plataforma, os valores internos dos recursos como os Inteiros Longos são armazenados usando ordenação de bytes ("byte ordering") Macintosh. No Windows, para os dados dos recursos padrão (tais como os recursos listas de cadeias e os recursos imagens) a ordenação de bytes é automaticamente inversa ("byte swapping") quando for necessário. Por outra parte, se criar e utilizar suas próprias estruturas de dados internas, você decide se aplica a ordenação inversa aos dados que extraiu do BLOB (por exemplo, ao passar Macintosh byte ordering a um comando como BLOB to longint).
Ver o exemplo do comando SET RESOURCE.
A variável sistema OK assume o valor 1 se o recurso for encontrado, do contrário assume o valor 0 (zero).
Se não houver memória suficiente para carregar a imagem, um erro é gerado. Pode interceptar esse erro com a ajuda de um método de gestão de erros instalado pelo comando ON ERR CALL.
Produto: 4D
Tema: Recursos
Número
508
Criado por: 4D v6
Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)
