4D v12.4
SET RESOURCE PROPERTIES
- Manual de lenguaje 4D
-
- Recursos
-
- Recursos
- ARRAY TO STRING LIST
- CLOSE RESOURCE FILE
- Create resource file
- DELETE RESOURCE
- Get component resource ID
- 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
- SET PICTURE RESOURCE
- SET RESOURCE
- SET RESOURCE NAME
- SET RESOURCE PROPERTIES
- SET STRING RESOURCE
- SET TEXT RESOURCE
- STRING LIST TO ARRAY
SET RESOURCE PROPERTIES
| SET RESOURCE PROPERTIES ( resTipo ; resNum ; resAttr {; resArchivo} ) | ||||||||
| Parámetro | Tipo | Descripción | ||||||
| resTipo | Cadena |
|
Tipo de recurso (4 caracteres) | |||||
| resNum | Entero largo |
|
Número de referencia del recurso | |||||
| resAttr | Entero largo |
|
Nuevos atributos del recurso | |||||
| resArchivo | DocRef |
|
Número de referencia del archivo de recursos o Archivo de recursos actual, si se omite | |||||
El comando SET RESOURCE PROPERTIES cambia los atributos del recurso cuyo tipo se pasa en el parámetro resTipo y cuyo número se pasa en resNum.
Si pasa un número de referencia de archivo de recursos válido en el parámetro opcional resArchivo, el recurso se busca en ese archivo únicamente. Si no pasa resArchivo, el recurso se busca en los archivos de recursos abiertos.
Si el recurso no existe, SET RESOURCE PROPERTIES no hace nada y la variable OK toma el valor 0 (cero).
El valor numérico que se pasa en resAttr debe considerarse como un valor binario donde cada bit tiene un significado particular. Las siguientes constantes predefinidas son proporcionadas por 4D:
| Constante | Tipo | Valor |
| Changed resource bit | Entero largo | 1 |
| Preloaded resource bit | Entero largo | 2 |
| Changed resource mask | Entero largo | 2 |
| Protected resource bit | Entero largo | 3 |
| Locked resource bit | Entero largo | 4 |
| Preloaded resource mask | Entero largo | 4 |
| Purgeable resource bit | Entero largo | 5 |
| System heap resource bit | Entero largo | 6 |
| Protected resource mask | Entero largo | 8 |
| Locked resource mask | Entero largo | 16 |
| Purgeable resource mask | Entero largo | 32 |
| System heap resource mask | Entero largo | 64 |
Utilizando estas constantes, puede definir el valor de los atributos de los recursos. Ver los ejemplos a continuación.
Memoria del sistema heap
Si utiliza este atributo, el recurso será cargado en la memoria del sistema en lugar de en la memoria de 4D. No debe utilizar este atributo, a menos que realmente sepa lo que está haciendo.
Purgable
Si utiliza este atributo, después de cargar el recurso, puede purgarlo de la memoria si es necesario más espacio para ubicar otros datos. Como usted carga los recursos en los BLOB 4D, recomendamos tener todos sus recursos purgables para reducir el uso de memoria. Sin embargo, si accede con frecuencia a este recurso durante una sesión de trabajo, usted podría querer volverlo no purgable para reducir el acceso al disco debido a la carga frecuente de un recurso purgado.
Bloqueado
Si se utiliza este atributo, el recurso no puede ser reubicado después de cargarse en memoria. Un recurso bloqueado no puede ser purgado incluso si es purgable. El bloqueo de un recurso tiene el efecto indeseable de fragmentar la memoria. NO utilice este atributo, a menos que sepa exactamente lo que está haciendo.
Protegido
Si este atributo está definido, no puede modificar el nombre, número de identificación o el contenido del recurso. Tampoco es posible borrar este recurso. Sin embargo, puede llamar SET RESOURCE PROPERTIES para borrar este atributo; luego puede modificar o borrar el recurso. La mayor parte del tiempo, no utilizará este atributo.
Nota: este atributo no tiene efecto en Windows.
Precargado
Si se utiliza este atributo, el recurso se carga automáticamente en memoria y el archivo en el cual está ubicado se abre. Este atributo es útil para la optimización de la carga de recursos durante la apertura de un archivo de recursos. La mayoría del tiempo, no utilizará este atributo.
Modificado
Si este atributo se utiliza, el recurso se marca como “debe ser guardado en disco” cuando el archivo de recursos donde se encuentra se cierra. Como el comando 4D SET RESOURCE se encarga de la escritura y reescritura de los recursos internamente, no debe utilizar este atributo, a menos que realmente sepa lo que está haciendo.
Por lo general no utilizará el atributo purgable y con menos frecuencia aún Precargado y Protegido.
Advertencia: NO cambie los atributos de recursos que pertenecen a 4D o a los archivos del sistema. Si lo hace, podría provocar errores en el sistema.
Consulte el ejemplo del comando Get resource name.
El siguiente ejemplo vuelve el recurso 'STR#' ID=17000 purgable y deja los otros atributos intactos:
$vlResAttr:=Get resource properties('STR#';17000;$vhResFile)
SET RESOURCE PROPERTIES('STR#';17000;$vlResAttr ?+Purgeable resource bit;$vhMyResFile)El siguiente ejemplo vuelve el recurso 'STR#' ID=17000 purgable, pero no cambia los otros atributos:
$vlResAttr:=Get resource properties('STR#';17000;$vhResArchivo)
SET RESOURCE PROPERTIES('STR#';17000;$vlResAttr ?+Purgeable resource bit;$vhResArchivo)El siguiente ejemplo vuelve el recurso 'STR#' ID=17000 precargado y no purgable:
SET RESOURCE PROPERTIES('STR#';17000;Preloaded resource mask;$vhResArchivo)La variable sistema OK toma el valor 0 si el recurso no existe; de lo contrario, toma el valor 1.
Producto: 4D
Tema: Recursos
Número
516
Creado por: 4D v6
