diff --git a/docs/Events/overview.md b/docs/Events/overview.md index 462bf67efa6a2d..3dedf933bc4874 100644 --- a/docs/Events/overview.md +++ b/docs/Events/overview.md @@ -50,68 +50,68 @@ The number of objects involved in an event depends on the nature of the event. The following table summarizes how object and form methods are called for each event type: -|Event|Object Methods|Form Method|Which Objects| -|---|---|----|---| -|On Load|Yes|Yes|All objects| -|On Unload|Yes|Yes|All objects| -|On Validate|Yes|Yes|All objects| -|On Clicked|Yes |Yes|Involved object only| -|On Double Clicked|Yes|Yes|Involved object only| -|On Before Keystroke|Yes|Yes|Involved object only| -|On After Keystroke|Yes|Yes|Involved object only| -|On After Edit|Yes|Yes|Involved object only| -|On Getting Focus|Yes|Yes|Involved object only| -|On Losing Focus|Yes|Yes|Involved object only| -|On Activate|Never|Yes|None| -|On Deactivate|Never|Yes|None| -|On Outside Call|Never|Yes|None| -|On Page Change|Never|Yes|None| -|On Begin Drag Over|Yes|Yes|Involved object only| -|On Drop|Yes|Yes|Involved object only| -|On Drag Over|Yes|Never |Involved object only| -|On Mouse Enter|Yes|Yes|All objects| -|On Mouse Move|Yes|Yes|All objects| -|On Mouse Leave|Yes|Yes|All objects| -|On Mouse Up|Yes|Never|Involved object only| -|On Menu Selected|Never|Yes|None| -|On Bound variable change|Never|Yes|None| -|On Data Change|Yes|Yes|Involved object only| -|On Plug in Area|Yes|Yes|Involved object only| -|On Header|Yes|Yes|All objects| -|On Printing Detail|Yes|Yes |All objects| -|On Printing Break|Yes |Yes|All objects| -|On Printing Footer|Yes |Yes|All objects| -|On Close Box|Never|Yes |None| -|On Display Detail|Yes|Yes|All objects| -|On Open Detail|Yes (List box)|Yes|None except List boxes| -|On Close Detail|Yes (List box)|Yes|None except List boxes| -|On Resize|Never|Yes|None| -|On Selection Change|Yes|Yes|Involved object only| -|On Load Record|Never|Yes|None| -|On Timer|Never|Yes|None| -|On Scroll|Yes|Never|Involved object only| -|On Before Data Entry|Yes (List box)|Never|Involved object only| -|On Column Moved|Yes (List box)|Never|Involved object only| -|On Row Moved|Yes (List box)|Never|Involved object only| -|On Column Resize|Yes (List box and 4D View Pro Area)| Never|Involved object only| -|On Header Click|Yes (List box and 4D View Pro Area)|Never|Involved object only| -|On Footer Click|Yes (List box)|Never|Involved object only| -|On After Sort|Yes (List box)|Never|Involved object only| -|On Long Click|Yes (Button)|Yes|Involved object only| -|On Alternative Click|Yes (Button and List box)|Never| Involved object only| -|On Expand|Yes (Hier. list and list box)|Never|Involved object only| -|On Collapse|Yes (Hier. list and list box)|Never|Involved object only| -|On Delete Action|Yes (Hier. list and list box)|Never|Involved object only| -|On URL Resource Loading|Yes (Web Area)|Never|Involved object only| -|On Begin URL Loading|Yes (Web Area)|Never|Involved object only| -|On URL Loading Error|Yes (Web Area)|Never|Involved object only| -|On URL Filtering|Yes (Web Area)|Never|Involved object only| -|On End URL Loading|Yes (Web Area)|Never|Involved object only| -|On Open External Link|Yes (Web Area)|Never|Involved object only| -|On Window Opening Denied|Yes (Web Area)|Never|Involved object only| -|On VP Range Changed|Yes (4D View Pro Area)|Never|Involved object only| -|On VP Ready|Yes (4D View Pro Area)|Never|Involved object only| -|On Row Resize|Yes (4D View Pro Area)|Never|Involved object only| +|Event|Code|Object Methods|Form Method|Which Objects| +|---|---|---|----|---| +|On Activate|11|Never|Yes|None| +|On After Edit|45|Yes|Yes|Involved object only| +|On After Keystroke|28|Yes|Yes|Involved object only| +|On After Sort|30|Yes (List box)|Never|Involved object only| +|On Alternative Click|38|Yes (Button and List box)|Never| Involved object only| +|On Before Data Entry|41|Yes (List box)|Never|Involved object only| +|On Before Keystroke|17|Yes|Yes|Involved object only| +|On Begin Drag Over|46|Yes|Yes|Involved object only| +|On Begin URL Loading|47|Yes (Web Area)|Never|Involved object only| +|On Bound variable change|54|Never|Yes|None| +|On Clicked|4|Yes |Yes|Involved object only| +|On Close Box|22|Never|Yes |None| +|On Close Detail|26|Yes (List box)|Yes|None except List boxes| +|On Collapse|44|Yes (Hier. list and list box)|Never|Involved object only| +|On Column Moved|32|Yes (List box)|Never|Involved object only| +|On Column Resize|33|Yes (List box and 4D View Pro Area)| Never|Involved object only| +|On Data Change|20|Yes|Yes|Involved object only| +|On Deactivate|12|Never|Yes|None| +|On Delete Action|58|Yes (Hier. list and list box)|Never|Involved object only| +|On Display Detail|8|Yes|Yes|All objects| +|On Double Clicked|13|Yes|Yes|Involved object only| +|On Drag Over|21|Yes|Never |Involved object only| +|On Drop|16|Yes|Yes|Involved object only| +|On End URL Loading|49|Yes (Web Area)|Never|Involved object only| +|On Expand|43|Yes (Hier. list and list box)|Never|Involved object only| +|On Footer Click|57|Yes (List box)|Never|Involved object only| +|On Getting Focus|15|Yes|Yes|Involved object only| +|On Header|5|Yes|Yes|All objects| +|On Header Click|42|Yes (List box and 4D View Pro Area)|Never|Involved object only| +|On Load|1|Yes|Yes|All objects| +|On Load Record|40|Never|Yes|None| +|On Long Click|39|Yes (Button)|Yes|Involved object only| +|On Losing Focus|14|Yes|Yes|Involved object only| +|On Menu Selected|18|Never|Yes|None| +|On Mouse Enter|35|Yes|Yes|All objects| +|On Mouse Leave|36|Yes|Yes|All objects| +|On Mouse Move|37|Yes|Yes|All objects| +|On Mouse Up|2|Yes|Never|Involved object only| +|On Open Detail|25|Yes (List box)|Yes|None except List boxes| +|On Open External Link|52|Yes (Web Area)|Never|Involved object only| +|On Outside Call|10|Never|Yes|None| +|On Page Change|56|Never|Yes|None| +|On Plug in Area|19|Yes|Yes|Involved object only| +|On Printing Break|6|Yes |Yes|All objects| +|On Printing Detail|23|Yes|Yes |All objects| +|On Printing Footer|7|Yes |Yes|All objects| +|On Resize|29|Never|Yes|None| +|On Row Moved|34|Yes (List box)|Never|Involved object only| +|On Row Resize|60|Yes (4D View Pro Area)|Never|Involved object only| +|On Scroll|59|Yes|Never|Involved object only| +|On Selection Change|31|Yes|Yes|Involved object only| +|On Timer|27|Never|Yes|None| +|On Unload|24|Yes|Yes|All objects| +|On URL Filtering|51|Yes (Web Area)|Never|Involved object only| +|On URL Loading Error|50|Yes (Web Area)|Never|Involved object only| +|On URL Resource Loading|48|Yes (Web Area)|Never|Involved object only| +|On Validate|3|Yes|Yes|All objects| +|On VP Range Changed|61|Yes (4D View Pro Area)|Never|Involved object only| +|On VP Ready|9|Yes (4D View Pro Area)|Never|Involved object only| +|On Window Opening Denied|53|Yes (Web Area)|Never|Involved object only| Always keep in mind that, for any event, the method of a form or an object is called if the corresponding event property is selected for the form or objects. The benefit of disabling events in the Design environment (using the Property List of the Form editor) is that you can reduce the number of calls to methods and therefore significantly optimize the execution speed of your forms. diff --git a/docs/language-legacy/File and Folder/zip-create-archive.md b/docs/language-legacy/File and Folder/zip-create-archive.md index fa69aacdaf91ca..b9825ffdb16267 100644 --- a/docs/language-legacy/File and Folder/zip-create-archive.md +++ b/docs/language-legacy/File and Folder/zip-create-archive.md @@ -50,8 +50,8 @@ You can pass a 4D.File, a 4D.Folder, or a zip structure object as first paramete |Property|Type|Description| |---|---|---| |compression|Integer|
  • `ZIP Compression standard`: Deflate compression (default)
  • `ZIP Compression LZMA`: LZMA compression
  • `ZIP Compression XZ`: XZ compression
  • `ZIP Compression none`: No compression
    • | -|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -|encryption|Integer|The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted: | +|encryption|Integer|The encryption to use if a password is set:| |password|Text|A password to use if encryption is required.| |files|Collection|
  • a collection of `4D.File` or `4D.Folder` objects or
  • a collection of objects with the following properties:
    • PropertyTypeDescription
    source4D.File or 4D.FolderFile or Folder
    destinationText(optional) - Specify a relative filepath to change the organization of the contents of the archive
    optionnumber(optional) - `ZIP Ignore invisible files` or 0 to compress all of the file
    | |callback|4D.Function|A callback formula that will receive the compression progress (0 - 100) in $1.| diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Admin/data-collect.md b/i18n/es/docusaurus-plugin-content-docs/current/Admin/data-collect.md index 6d17d7ebc6c656..c9185fc9e8c3a7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Admin/data-collect.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Admin/data-collect.md @@ -37,10 +37,12 @@ También se recogen algunos datos a intervalos regulares. | cacheReadCount | Object | Número de lecturas en la caché | | classUsage | Object | Número de instancias de ciertas clases de lenguaje | | connectionSystems | Collection | Sistema operativo del cliente sin el número de compilación (entre paréntesis) y número de clientes que lo utilizan | +| databases[].backupSettings | Object | Valores actuales de la configuración de copias de seguridad | | databases[].cacheSize | Number | Tamaño de caché en bytes | | databases[].compatibilitySettings | Object | Configuración de compatibilidad activada | | databases[].externalDatastoreOpened | Number | Número de llamadas a `Open datastore` | | databases[].fluentUI | Boolean | True si la opción "Utilizar Fluent UI en Windows" está seleccionada | +| databases[].flushCacheInterval | Number | Período de tiempo definido entre cada guardado automático de la caché de datos | | databases[].id | Number | ID de la base de datos | | databases[].internalDatastoreOpened | Number | Número de veces que un servidor externo abre el almacén de datos | | databases[].maxConcurrent4DClients | Number | Número máximo de sesiones 4D Client simultáneas (utilizando una licencia 4D Client) durante el intervalo de recolección | @@ -52,6 +54,7 @@ También se recogen algunos datos a intervalos regulares. | databases[].numberOfKeepRecordSyncInfo | Number | Número de tablas con la opción "Activar la replicación" marcada | | databases[].numberOfRecordsMax | Number | Número total de registros | | databases[].numberOfTables | Number | Número de tablas | +| databases[].numberOfUncaughtExecutionErrors | Number | Número de veces que se muestra un error de ejecución como alerta | | databases[].qodly.webforms | Number | Número de formularios web Qodly | | databases[].remoteDebugger4DRemoteAttachments | Number | Número de adjuntos al depurador remoto desde un 4D remoto | | databases[].remoteDebuggerQodlyAttachments | Number | Número de archivos adjuntos al depurador remoto de Qodly | @@ -92,6 +95,7 @@ También se recogen algunos datos a intervalos regulares. | isEncrypted | Boolean | True si el archivo de datos está encriptado | | isEngined | Boolean | True si la aplicación se fusiona con 4D Volume Desktop | | isProjectMode | Boolean | True si la aplicación es un proyecto | +| isShadowCopyActivated | Boolean | True if the Volume Shadow Copy feature is enabled (Windows only | | LDAPLogin | Number | Número de llamadas a `LDAP LOGIN` | | license.sffPrimaryKey | Number | Número de producto del servidor principal | | machine.CPU | Text | Nombre, tipo y velocidad del procesador | @@ -102,6 +106,7 @@ También se recogen algunos datos a intervalos regulares. | maximumUsedPhysicalMemory | Number | Uso máximo de la memoria física | | maximumUsedVirtualMemory | Number | Uso máximo de la memoria virtual | | mobile | Collection | Información sobre sesiones móviles | +| numberOfCrashes | Number | Número de veces que se ha bloqueado 4D | | numberOfWebServices | Number | Número de métodos publicados como servicios web | | ODBCLogin | Number | Número de llamadas a `SQL LOGIN` utilizando ODBC | | phpCall | Number | Número de llamadas a `PHP execute` | diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Events/overview.md b/i18n/es/docusaurus-plugin-content-docs/current/Events/overview.md index 118c302d472f12..648d7fd48c9981 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Events/overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Events/overview.md @@ -48,68 +48,68 @@ El número de objetos asociados a un evento depende de la naturaleza del mismo. El número de objetos asociados a un evento depende de la naturaleza del mismo. -| Evento | Método objeto | Método formulario | Objetos | -| ------------------------ | ---------------------------------------------------------------- | ----------------- | ------------------------------- | -| On Load | Sí | Sí | Todos los objetos | -| On Unload | Sí | Sí | Todos los objetos | -| On Validate | Sí | Sí | Todos los objetos | -| On Clicked | Sí | Sí | Objetos involucrados únicamente | -| On Double Clicked | Sí | Sí | Objetos involucrados únicamente | -| On Before Keystroke | Sí | Sí | Objetos involucrados únicamente | -| On After Keystroke | Sí | Sí | Objetos involucrados únicamente | -| On After Edit | Sí | Sí | Objetos involucrados únicamente | -| On Getting Focus | Sí | Sí | Objetos involucrados únicamente | -| On Losing Focus | Sí | Sí | Objetos involucrados únicamente | -| On Activate | Nunca | Sí | Ninguno | -| On Deactivate | Nunca | Sí | Ninguno | -| On Outside Call | Nunca | Sí | Ninguno | -| On Page Change | Nunca | Sí | Ninguno | -| On Begin Drag Over | Sí | Sí | Objetos involucrados únicamente | -| On Drop | Sí | Sí | Objetos involucrados únicamente | -| On Drag Over | Sí | Nunca | Objetos involucrados únicamente | -| On Mouse Enter | Sí | Sí | Todos los objetos | -| On Mouse Move | Sí | Sí | Todos los objetos | -| On Mouse Leave | Sí | Sí | Todos los objetos | -| On Mouse Up | Sí | Nunca | Objetos involucrados únicamente | -| On Menu Selected | Nunca | Sí | Ninguno | -| On Bound variable change | Nunca | Sí | Ninguno | -| On Data Change | Sí | Sí | Objetos involucrados únicamente | -| On Plug in Area | Sí | Sí | Objetos involucrados únicamente | -| On Header | Sí | Sí | Todos los objetos | -| On Printing Detail | Sí | Sí | Todos los objetos | -| On Printing Break | Sí | Sí | Todos los objetos | -| On Printing Footer | Sí | Sí | Todos los objetos | -| On Close Box | Nunca | Sí | Ninguno | -| On Display Detail | Sí | Sí | Todos los objetos | -| On Open Detail | Sí (List box) | Sí | Ninguna, excepto los list box | -| On Close Detail | Sí (List box) | Sí | Ninguna, excepto los list box | -| On Resize | Nunca | Sí | Ninguno | -| On Selection Change | Sí | Sí | Objetos involucrados únicamente | -| On Load Record | Nunca | Sí | Ninguno | -| On Timer | Nunca | Sí | Ninguno | -| On Scroll | Sí | Nunca | Objetos involucrados únicamente | -| On Before Data Entry | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Column Moved | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Row Moved | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Column Resize | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Header Click | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Footer Click | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On After Sort | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Long Click | Sí (botón) | Sí | Objetos involucrados únicamente | -| On Alternative Click | Sí (Botón y List box) | Nunca | Objetos involucrados únicamente | -| On Expand | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On Collapse | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On Delete Action | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On URL Resource Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Begin URL Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On URL Loading Error | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On URL Filtering | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On End URL Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Open External Link | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Window Opening Denied | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On VP Range Changed | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On VP Ready | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Row Resize | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| Evento | Code | Método objeto | Método formulario | Objetos | +| ------------------------ | ---- | ---------------------------------------------------------------- | ----------------- | ------------------------------- | +| On Activate | 11 | Nunca | Sí | Ninguno | +| On After Edit | 45 | Sí | Sí | Objetos involucrados únicamente | +| On After Keystroke | 28 | Sí | Sí | Objetos involucrados únicamente | +| On After Sort | 30 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Alternative Click | 38 | Sí (Botón y List box) | Nunca | Objetos involucrados únicamente | +| On Before Data Entry | 41 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Before Keystroke | 17 | Sí | Sí | Objetos involucrados únicamente | +| On Begin Drag Over | 46 | Sí | Sí | Objetos involucrados únicamente | +| On Begin URL Loading | 47 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Bound variable change | 54 | Nunca | Sí | Ninguno | +| On Clicked | 4 | Sí | Sí | Objetos involucrados únicamente | +| On Close Box | 22 | Nunca | Sí | Ninguno | +| On Close Detail | 26 | Sí (List box) | Sí | Ninguna, excepto los list box | +| On Collapse | 44 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Column Moved | 32 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Column Resize | 33 | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Data Change | 20 | Sí | Sí | Objetos involucrados únicamente | +| On Deactivate | 12 | Nunca | Sí | Ninguno | +| On Delete Action | 58 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Display Detail | 8 | Sí | Sí | Todos los objetos | +| On Double Clicked | 13 | Sí | Sí | Objetos involucrados únicamente | +| On Drag Over | 21 | Sí | Nunca | Objetos involucrados únicamente | +| On Drop | 16 | Sí | Sí | Objetos involucrados únicamente | +| On End URL Loading | 49 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Expand | 43 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Footer Click | 57 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Getting Focus | 15 | Sí | Sí | Objetos involucrados únicamente | +| On Header | 5 | Sí | Sí | Todos los objetos | +| On Header Click | 42 | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Load | 1 | Sí | Sí | Todos los objetos | +| On Load Record | 40 | Nunca | Sí | Ninguno | +| On Long Click | 39 | Sí (botón) | Sí | Objetos involucrados únicamente | +| On Losing Focus | 14 | Sí | Sí | Objetos involucrados únicamente | +| On Menu Selected | 18 | Nunca | Sí | Ninguno | +| On Mouse Enter | 35 | Sí | Sí | Todos los objetos | +| On Mouse Leave | 36 | Sí | Sí | Todos los objetos | +| On Mouse Move | 37 | Sí | Sí | Todos los objetos | +| On Mouse Up | 2 | Sí | Nunca | Objetos involucrados únicamente | +| On Open Detail | 25 | Sí (List box) | Sí | Ninguna, excepto los list box | +| On Open External Link | 52 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Outside Call | 10 | Nunca | Sí | Ninguno | +| On Page Change | 56 | Nunca | Sí | Ninguno | +| On Plug in Area | 19 | Sí | Sí | Objetos involucrados únicamente | +| On Printing Break | 6 | Sí | Sí | Todos los objetos | +| On Printing Detail | 23 | Sí | Sí | Todos los objetos | +| On Printing Footer | 7 | Sí | Sí | Todos los objetos | +| On Resize | 29 | Nunca | Sí | Ninguno | +| On Row Moved | 34 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Row Resize | 60 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Scroll | 59 | Sí | Nunca | Objetos involucrados únicamente | +| On Selection Change | 31 | Sí | Sí | Objetos involucrados únicamente | +| On Timer | 27 | Nunca | Sí | Ninguno | +| On Unload | 24 | Sí | Sí | Todos los objetos | +| On URL Filtering | 51 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On URL Loading Error | 50 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On URL Resource Loading | 48 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Validate | 3 | Sí | Sí | Todos los objetos | +| On VP Range Changed | 61 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On VP Ready | 9 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Window Opening Denied | 53 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | Tenga siempre en cuenta que, para todo evento, se llama al método de un formulario o de un objeto si se selecciona la correspondiente propiedad del evento para el formulario o los objetos. La ventaja de desactivar los eventos en el entorno de diseño (utilizando la lista de propiedades del editor de formularios) es que puede reducir el número de llamadas a los métodos y, por tanto, optimizar significativamente la velocidad de ejecución de sus formularios. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md b/i18n/es/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md index 6a9b41bb93ffcc..e9ba46a80b9850 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md @@ -49,7 +49,7 @@ Puede pasar un objeto 4D.File, 4D.Folder, o una estructura zip como primer pará | Propiedad | Tipo | Descripción | | ------------ | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Compresión Deflate (por defecto)
  • `ZIP Compression LZMA`: Compression LZMA
  • `ZIP Compresión XZ`: Compression XZ
  • `ZIP Compresión`: sin compresión
    • | -| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omite:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | +| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omite: | | encryption | Integer | El cifrado a usar si se define una contraseña:
  • `ZIP Encryption AES128`: encriptación AES utilizando llave de 128 bits.
  • `ZIP Encryption AES192`: encriptación AES utilizando llave de 192 bits.
  • `ZIP Encryption AES256`: encriptación AES utilizando llave de 256 bits (por defecto si se define la contraseña).
  • `ZIP Encryption none`: los datos no están cifrados (por defecto si no se define una contraseña)
    • | | contraseña | Text | Una contraseña a utilizar si se requiere encriptación. | | Histórico | Collection |
  • una colección de objetos `4D.File` o `4D.Folder` o
  • una colección de objetos con las siguientes propiedades:
    • PropiedadTipoDescripción
    source4D.Archivo o 4D.CarpetaArchivo o Carpeta
    destinoTexto(opcional) - Especifique una ruta de archivo relativa para cambiar la organización del contenido del archivo
    optionnumber(opcional) - `ZIP Ignore invisible files` o 0 para comprimir todo el archivo
    | @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## Ver también -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## Propiedades diff --git a/i18n/es/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md b/i18n/es/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md index 5264cbbcc606ef..7f2af22130cf18 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ Para extraer desde la carpeta root: ## Ver también -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## Propiedades diff --git a/i18n/es/docusaurus-plugin-content-docs/current/server/service.md b/i18n/es/docusaurus-plugin-content-docs/current/server/service.md index 72ff0a0f0441a2..5cb40e749d24f5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/server/service.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/server/service.md @@ -34,5 +34,5 @@ Para dar de baja su aplicación, seleccione **Dar de baja la aplicación actual* Para anular el registro de todas las bases de datos de 4D Server a la vez, seleccione **Anular el registro de todos los servicios del servidor** en el menú **Archivo** de 4D Server. Este comando se atenúa si no hay ningún servicio 4D Server activado. -You cannot change the service registration status of 4D Server from within 4D Server, if the application has been launched as a service on start-up. En este caso, los tres elementos del menú están desactivados. Para detener el servicio, utilice el panel de control **Servicios**. +No es posible modificar el estado de registro del servicio de 4D Server desde el propio 4D Server si la aplicación se ha iniciado como servicio al arrancar el sistema. En este caso, los tres elementos del menú están desactivados. Para detener el servicio, utilice el panel de control **Servicios**. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md b/i18n/es/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md index 9ba3141af38033..98d4df4b17d980 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md @@ -77,7 +77,7 @@ Puede pasar un objeto 4D.File, 4D.Folder, o una estructura zip como primer pará | Propiedad | Tipo | Descripción | | ------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: reducir la compresión (por defecto)
  • `ZIP Compression LZMA`: compresión LZMA
  • `ZIP Compression XZ`: compresión XZ
  • `ZIP Compression none`: sin compresión
    • | -| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omiten:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | +| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omiten: | | encryption | Integer | La encriptación a utilizar si se define una contraseña:
  • `ZIP Encryption AES128`: encriptación AES con una llave de 128 bits.
  • `ZIP Encryption AES192`: encriptación AES con una llave de 192 bits.
  • `ZIP Encryption AES256`: encriptación AES con una llave de 256 bits (por defecto si se define la contraseña).
  • `ZIP Encryption none`: los datos no están encriptados (por defecto si no se define una contraseña)
    • | | contraseña | Text | Una contraseña a utilizar si se requiere encriptación. | | Histórico | Collection |
  • una colección de objetos `4D.File` o `4D.Folder` o
  • una colección de objetos con las siguientes propiedades:
    • PropiedadTipoDescripción
    source4D.File o 4D.FolderFile o Folder
    destinationText(opcional) - Especifica una ruta de archivo relativa para cambiar la organización del contenido del archivo
    optionnumber(opcional) - `ZIP Ignore invisible files` o 0 para comprimir todo el archivo
    | diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md index 924626c22cedb8..1ff861bb04b851 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md @@ -75,14 +75,14 @@ Puede pasar un objeto 4D.File, 4D.Folder, o una estructura zip como primer pará - *zipStructure*: pase un objeto que describa el objeto ZIP archivo. Las siguientes propiedades están disponibles para definir la estructura: -| Propiedad | Tipo | Descripción | -| ------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| compression | Integer |
  • `ZIP Compression standard`: reducir la compresión (por defecto)
  • `ZIP Compression LZMA`: compresión LZMA
  • `ZIP Compression XZ`: compresión XZ
  • `ZIP Compression none`: sin compresión
    • | -| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omiten:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | La encriptación a utilizar si se define una contraseña:
  • `ZIP Encryption AES128`: encriptación AES con una llave de 128 bits.
  • `ZIP Encryption AES192`: encriptación AES con una llave de 192 bits.
  • `ZIP Encryption AES256`: encriptación AES con una llave de 256 bits (por defecto si se define la contraseña).
  • `ZIP Encryption none`: los datos no están encriptados (por defecto si no se define una contraseña)
    • | -| contraseña | Text | Una contraseña a utilizar si se requiere encriptación. | -| Histórico | Collection |
  • una colección de objetos `4D.File` o `4D.Folder` o
  • una colección de objetos con las siguientes propiedades:
    • PropiedadTipoDescripción
    source4D.File o 4D.FolderFile o Folder
    destinationText(opcional) - Especifica una ruta de archivo relativa para cambiar la organización del contenido del archivo
    optionnumber(opcional) - `ZIP Ignore invisible files` o 0 para comprimir todo el archivo
    | -| retrollamada | 4D.Function | Una fórmula de retrollamada que recibirá la progresión de la compresión (0 - 100) en $1. | +| Propiedad | Tipo | Descripción | +| ------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| compression | Integer |
  • `ZIP Compression standard`: reducir la compresión (por defecto)
  • `ZIP Compression LZMA`: compresión LZMA
  • `ZIP Compression XZ`: compresión XZ
  • `ZIP Compression none`: sin compresión
    • | +| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omiten: | +| encryption | Integer | La encriptación a utilizar si se define una contraseña: | +| contraseña | Text | Una contraseña a utilizar si se requiere encriptación. | +| Histórico | Collection |
  • una colección de objetos `4D.File` o `4D.Folder` o
  • una colección de objetos con las siguientes propiedades:
    • PropiedadTipoDescripción
    source4D.File o 4D.FolderFile o Folder
    destinationText(opcional) - Especifica una ruta de archivo relativa para cambiar la organización del contenido del archivo
    optionnumber(opcional) - `ZIP Ignore invisible files` o 0 para comprimir todo el archivo
    | +| retrollamada | 4D.Function | Una fórmula de retrollamada que recibirá la progresión de la compresión (0 - 100) en $1. | En el parámetro *destinationFile*, pase un objeto `4D.File` describiendo el archivo ZIP a crear (nombre, ubicación, etc.). Se aconseja utilizar la extensión ".zip" si quiere que el archivo ZIP sea procesado automáticamente por cualquier software. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/Events/overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20/Events/overview.md index 462b586912af54..8d1ead12039cd1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/Events/overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/Events/overview.md @@ -49,70 +49,71 @@ El número de objetos asociados a un evento depende de la naturaleza del mismo. El número de objetos asociados a un evento depende de la naturaleza del mismo. -| Evento | Método objeto | Método formulario | Objetos | -| ------------------------ | -------------------------------- | ----------------- | ------------------------------- | -| On Load | Sí | Sí | Todos los objetos | -| On Unload | Sí | Sí | Todos los objetos | -| On Validate | Sí | Sí | Todos los objetos | -| On Clicked | Sí | Sí | Objetos involucrados únicamente | -| On Double Clicked | Sí | Sí | Objetos involucrados únicamente | -| On Before Keystroke | Sí | Sí | Objetos involucrados únicamente | -| On After Keystroke | Sí | Sí | Objetos involucrados únicamente | -| On After Edit | Sí | Sí | Objetos involucrados únicamente | -| On Getting Focus | Sí | Sí | Objetos involucrados únicamente | -| On Losing Focus | Sí | Sí | Objetos involucrados únicamente | -| On Activate | Nunca | Sí | Ninguno | -| On Deactivate | Nunca | Sí | Ninguno | -| On Outside Call | Nunca | Sí | Ninguno | -| On Page Change | Nunca | Sí | Ninguno | -| On Begin Drag Over | Sí | Sí | Objetos involucrados únicamente | -| On Drop | Sí | Sí | Objetos involucrados únicamente | -| On Drag Over | Sí | Nunca | Objetos involucrados únicamente | -| On Mouse Enter | Sí | Sí | Todos los objetos | -| On Mouse Move | Sí | Sí | Todos los objetos | -| On Mouse Leave | Sí | Sí | Todos los objetos | -| On Mouse Up | Sí | Nunca | Objetos involucrados únicamente | -| On Menu Selected | Nunca | Sí | Ninguno | -| On Bound variable change | Nunca | Sí | Ninguno | -| On Data Change | Sí | Sí | Objetos involucrados únicamente | -| On Plug in Area | Sí | Sí | Objetos involucrados únicamente | -| On Header | Sí | Sí | Todos los objetos | -| On Printing Detail | Sí | Sí | Todos los objetos | -| On Printing Break | Sí | Sí | Todos los objetos | -| On Printing Footer | Sí | Sí | Todos los objetos | -| On Close Box | Nunca | Sí | Ninguno | -| On Display Detail | Sí | Sí | Todos los objetos | -| On Open Detail | Sí (List box) | Sí | Ninguna, excepto los list box | -| On Close Detail | Sí (List box) | Sí | Ninguna, excepto los list box | -| On Resize | Nunca | Sí | Ninguno | -| On Selection Change | Sí | Sí | Objetos involucrados únicamente | -| On Load Record | Nunca | Sí | Ninguno | -| On Timer | Nunca | Sí | Ninguno | -| On Scroll | Sí | Nunca | Objetos involucrados únicamente | -| On Before Data Entry | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Column Moved | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Row Moved | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Column Resize | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Header Click | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Footer Click | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On After Sort | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Long Click | Sí (botón) | Sí | Objetos involucrados únicamente | -| On Alternative Click | Sí (Botón y List box) | Nunca | Objetos involucrados únicamente | -| On Expand | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On Collapse | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On Delete Action | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On URL Resource Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Begin URL Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On URL Loading Error | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On URL Filtering | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On End URL Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Open External Link | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Window Opening Denied | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On VP Range Changed | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On VP Ready | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Row Resize | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| Evento | Code | Método objeto | Método formulario | Objetos | +| ------------------------ | ---- | -------------------------------- | ----------------- | ------------------------------- | +| On Activate | 11 | Nunca | Sí | Ninguno | +| On After Edit | 45 | Sí | Sí | Objetos involucrados únicamente | +| On After Keystroke | 28 | Sí | Sí | Objetos involucrados únicamente | +| On After Sort | 30 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Alternative Click | 38 | Sí (Botón y List box) | Nunca | Objetos involucrados únicamente | +| On Before Data Entry | 41 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Before Keystroke | 17 | Sí | Sí | Objetos involucrados únicamente | +| On Begin Drag Over | 46 | Sí | Sí | Objetos involucrados únicamente | +| On Begin URL Loading | 47 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Bound variable change | 54 | Nunca | Sí | Ninguno | +| On Clicked | 4 | Sí | Sí | Objetos involucrados únicamente | +| On Close Box | 22 | Nunca | Sí | Ninguno | +| On Close Detail | 26 | Sí (List box) | Sí | Ninguna, excepto los list box | +| On Collapse | 44 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Column Moved | 32 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Column Resize | 33 | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Data Change | 20 | Sí | Sí | Objetos involucrados únicamente | +| On Deactivate | 12 | Nunca | Sí | Ninguno | +| On Delete Action | 58 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Display Detail | 8 | Sí | Sí | Todos los objetos | +| On Double Clicked | 13 | Sí | Sí | Objetos involucrados únicamente | +| On Drag Over | 21 | Sí | Nunca | Objetos involucrados únicamente | +| On Drop | 16 | Sí | Sí | Objetos involucrados únicamente | +| On End URL Loading | 49 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Expand | 43 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Footer Click | 57 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Getting Focus | 15 | Sí | Sí | Objetos involucrados únicamente | +| On Header | 5 | Sí | Sí | Todos los objetos | +| On Header Click | 42 | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Load | 1 | Sí | Sí | Todos los objetos | +| On Load Record | 40 | Nunca | Sí | Ninguno | +| On Long Click | 39 | Sí (botón) | Sí | Objetos involucrados únicamente | +| On Losing Focus | 14 | Sí | Sí | Objetos involucrados únicamente | +| On Menu Selected | 18 | Nunca | Sí | Ninguno | +| On Mouse Enter | 35 | Sí | Sí | Todos los objetos | +| On Mouse Leave | 36 | Sí | Sí | Todos los objetos | +| On Mouse Move | 37 | Sí | Sí | Todos los objetos | +| On Mouse Up | 2 | Sí | Nunca | Objetos involucrados únicamente | +| On Open Detail | 25 | Sí (List box) | Sí | Ninguna, excepto los list box | +| On Open External Link | 52 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Outside Call | 10 | Nunca | Sí | Ninguno | +| On Page Change | 56 | Nunca | Sí | Ninguno | +| On Plug in Area | 19 | Sí | Sí | Objetos involucrados únicamente | +| On Printing Break | 6 | Sí | Sí | Todos los objetos | +| On Printing Detail | 23 | Sí | Sí | Todos los objetos | +| On Printing Footer | 7 | Sí | Sí | Todos los objetos | +| On Resize | 29 | Nunca | Sí | Ninguno | +| On Row Moved | 34 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Row Resize | 60 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Scroll | 59 | Sí | Nunca | Objetos involucrados únicamente | +| On Selection Change | 31 | Sí | Sí | Objetos involucrados únicamente | +| On Timer | 27 | Nunca | Sí | Ninguno | +| On Unload | 24 | Sí | Sí | Todos los objetos | +| On URL Filtering | 51 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On URL Loading Error | 50 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On URL Resource Loading | 48 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Validate | 3 | Sí | Sí | Todos los objetos | +| On VP Range Changed | 61 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On VP Ready | 9 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Window Opening Denied | 53 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | Tenga siempre en cuenta que, para todo evento, se llama al método de un formulario o de un objeto si se selecciona la correspondiente propiedad del evento para el formulario o los objetos. La ventaja de desactivar los eventos en el entorno de diseño (utilizando la lista de propiedades del editor de formularios) es que puede reducir el número de llamadas a los métodos y, por tanto, optimizar significativamente la velocidad de ejecución de sus formularios. > ATENCIÓN: los eventos [On Load](onLoad.md) y [On Unload](onUnload.md) se generan para los objetos si están activados a la vez para los objetos y para el formulario al que pertenecen los objetos. Si los eventos están activados sólo para los objetos, no se producirán; estos dos eventos también deben estar activados a nivel del formulario. + diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md index 118c302d472f12..648d7fd48c9981 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md @@ -48,68 +48,68 @@ El número de objetos asociados a un evento depende de la naturaleza del mismo. El número de objetos asociados a un evento depende de la naturaleza del mismo. -| Evento | Método objeto | Método formulario | Objetos | -| ------------------------ | ---------------------------------------------------------------- | ----------------- | ------------------------------- | -| On Load | Sí | Sí | Todos los objetos | -| On Unload | Sí | Sí | Todos los objetos | -| On Validate | Sí | Sí | Todos los objetos | -| On Clicked | Sí | Sí | Objetos involucrados únicamente | -| On Double Clicked | Sí | Sí | Objetos involucrados únicamente | -| On Before Keystroke | Sí | Sí | Objetos involucrados únicamente | -| On After Keystroke | Sí | Sí | Objetos involucrados únicamente | -| On After Edit | Sí | Sí | Objetos involucrados únicamente | -| On Getting Focus | Sí | Sí | Objetos involucrados únicamente | -| On Losing Focus | Sí | Sí | Objetos involucrados únicamente | -| On Activate | Nunca | Sí | Ninguno | -| On Deactivate | Nunca | Sí | Ninguno | -| On Outside Call | Nunca | Sí | Ninguno | -| On Page Change | Nunca | Sí | Ninguno | -| On Begin Drag Over | Sí | Sí | Objetos involucrados únicamente | -| On Drop | Sí | Sí | Objetos involucrados únicamente | -| On Drag Over | Sí | Nunca | Objetos involucrados únicamente | -| On Mouse Enter | Sí | Sí | Todos los objetos | -| On Mouse Move | Sí | Sí | Todos los objetos | -| On Mouse Leave | Sí | Sí | Todos los objetos | -| On Mouse Up | Sí | Nunca | Objetos involucrados únicamente | -| On Menu Selected | Nunca | Sí | Ninguno | -| On Bound variable change | Nunca | Sí | Ninguno | -| On Data Change | Sí | Sí | Objetos involucrados únicamente | -| On Plug in Area | Sí | Sí | Objetos involucrados únicamente | -| On Header | Sí | Sí | Todos los objetos | -| On Printing Detail | Sí | Sí | Todos los objetos | -| On Printing Break | Sí | Sí | Todos los objetos | -| On Printing Footer | Sí | Sí | Todos los objetos | -| On Close Box | Nunca | Sí | Ninguno | -| On Display Detail | Sí | Sí | Todos los objetos | -| On Open Detail | Sí (List box) | Sí | Ninguna, excepto los list box | -| On Close Detail | Sí (List box) | Sí | Ninguna, excepto los list box | -| On Resize | Nunca | Sí | Ninguno | -| On Selection Change | Sí | Sí | Objetos involucrados únicamente | -| On Load Record | Nunca | Sí | Ninguno | -| On Timer | Nunca | Sí | Ninguno | -| On Scroll | Sí | Nunca | Objetos involucrados únicamente | -| On Before Data Entry | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Column Moved | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Row Moved | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Column Resize | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Header Click | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Footer Click | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On After Sort | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Long Click | Sí (botón) | Sí | Objetos involucrados únicamente | -| On Alternative Click | Sí (Botón y List box) | Nunca | Objetos involucrados únicamente | -| On Expand | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On Collapse | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On Delete Action | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On URL Resource Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Begin URL Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On URL Loading Error | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On URL Filtering | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On End URL Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Open External Link | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Window Opening Denied | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On VP Range Changed | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On VP Ready | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Row Resize | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| Evento | Code | Método objeto | Método formulario | Objetos | +| ------------------------ | ---- | ---------------------------------------------------------------- | ----------------- | ------------------------------- | +| On Activate | 11 | Nunca | Sí | Ninguno | +| On After Edit | 45 | Sí | Sí | Objetos involucrados únicamente | +| On After Keystroke | 28 | Sí | Sí | Objetos involucrados únicamente | +| On After Sort | 30 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Alternative Click | 38 | Sí (Botón y List box) | Nunca | Objetos involucrados únicamente | +| On Before Data Entry | 41 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Before Keystroke | 17 | Sí | Sí | Objetos involucrados únicamente | +| On Begin Drag Over | 46 | Sí | Sí | Objetos involucrados únicamente | +| On Begin URL Loading | 47 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Bound variable change | 54 | Nunca | Sí | Ninguno | +| On Clicked | 4 | Sí | Sí | Objetos involucrados únicamente | +| On Close Box | 22 | Nunca | Sí | Ninguno | +| On Close Detail | 26 | Sí (List box) | Sí | Ninguna, excepto los list box | +| On Collapse | 44 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Column Moved | 32 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Column Resize | 33 | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Data Change | 20 | Sí | Sí | Objetos involucrados únicamente | +| On Deactivate | 12 | Nunca | Sí | Ninguno | +| On Delete Action | 58 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Display Detail | 8 | Sí | Sí | Todos los objetos | +| On Double Clicked | 13 | Sí | Sí | Objetos involucrados únicamente | +| On Drag Over | 21 | Sí | Nunca | Objetos involucrados únicamente | +| On Drop | 16 | Sí | Sí | Objetos involucrados únicamente | +| On End URL Loading | 49 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Expand | 43 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Footer Click | 57 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Getting Focus | 15 | Sí | Sí | Objetos involucrados únicamente | +| On Header | 5 | Sí | Sí | Todos los objetos | +| On Header Click | 42 | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Load | 1 | Sí | Sí | Todos los objetos | +| On Load Record | 40 | Nunca | Sí | Ninguno | +| On Long Click | 39 | Sí (botón) | Sí | Objetos involucrados únicamente | +| On Losing Focus | 14 | Sí | Sí | Objetos involucrados únicamente | +| On Menu Selected | 18 | Nunca | Sí | Ninguno | +| On Mouse Enter | 35 | Sí | Sí | Todos los objetos | +| On Mouse Leave | 36 | Sí | Sí | Todos los objetos | +| On Mouse Move | 37 | Sí | Sí | Todos los objetos | +| On Mouse Up | 2 | Sí | Nunca | Objetos involucrados únicamente | +| On Open Detail | 25 | Sí (List box) | Sí | Ninguna, excepto los list box | +| On Open External Link | 52 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Outside Call | 10 | Nunca | Sí | Ninguno | +| On Page Change | 56 | Nunca | Sí | Ninguno | +| On Plug in Area | 19 | Sí | Sí | Objetos involucrados únicamente | +| On Printing Break | 6 | Sí | Sí | Todos los objetos | +| On Printing Detail | 23 | Sí | Sí | Todos los objetos | +| On Printing Footer | 7 | Sí | Sí | Todos los objetos | +| On Resize | 29 | Nunca | Sí | Ninguno | +| On Row Moved | 34 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Row Resize | 60 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Scroll | 59 | Sí | Nunca | Objetos involucrados únicamente | +| On Selection Change | 31 | Sí | Sí | Objetos involucrados únicamente | +| On Timer | 27 | Nunca | Sí | Ninguno | +| On Unload | 24 | Sí | Sí | Todos los objetos | +| On URL Filtering | 51 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On URL Loading Error | 50 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On URL Resource Loading | 48 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Validate | 3 | Sí | Sí | Todos los objetos | +| On VP Range Changed | 61 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On VP Ready | 9 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Window Opening Denied | 53 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | Tenga siempre en cuenta que, para todo evento, se llama al método de un formulario o de un objeto si se selecciona la correspondiente propiedad del evento para el formulario o los objetos. La ventaja de desactivar los eventos en el entorno de diseño (utilizando la lista de propiedades del editor de formularios) es que puede reducir el número de llamadas a los métodos y, por tanto, optimizar significativamente la velocidad de ejecución de sus formularios. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md index 6a9b41bb93ffcc..e9ba46a80b9850 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md @@ -49,7 +49,7 @@ Puede pasar un objeto 4D.File, 4D.Folder, o una estructura zip como primer pará | Propiedad | Tipo | Descripción | | ------------ | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Compresión Deflate (por defecto)
  • `ZIP Compression LZMA`: Compression LZMA
  • `ZIP Compresión XZ`: Compression XZ
  • `ZIP Compresión`: sin compresión
    • | -| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omite:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | +| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omite: | | encryption | Integer | El cifrado a usar si se define una contraseña:
  • `ZIP Encryption AES128`: encriptación AES utilizando llave de 128 bits.
  • `ZIP Encryption AES192`: encriptación AES utilizando llave de 192 bits.
  • `ZIP Encryption AES256`: encriptación AES utilizando llave de 256 bits (por defecto si se define la contraseña).
  • `ZIP Encryption none`: los datos no están cifrados (por defecto si no se define una contraseña)
    • | | contraseña | Text | Una contraseña a utilizar si se requiere encriptación. | | Histórico | Collection |
  • una colección de objetos `4D.File` o `4D.Folder` o
  • una colección de objetos con las siguientes propiedades:
    • PropiedadTipoDescripción
    source4D.Archivo o 4D.CarpetaArchivo o Carpeta
    destinoTexto(opcional) - Especifique una ruta de archivo relativa para cambiar la organización del contenido del archivo
    optionnumber(opcional) - `ZIP Ignore invisible files` o 0 para comprimir todo el archivo
    | @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## Ver también -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## Propiedades diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md index 5264cbbcc606ef..7f2af22130cf18 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ Para extraer desde la carpeta root: ## Ver también -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## Propiedades diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md index 118c302d472f12..648d7fd48c9981 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md @@ -48,68 +48,68 @@ El número de objetos asociados a un evento depende de la naturaleza del mismo. El número de objetos asociados a un evento depende de la naturaleza del mismo. -| Evento | Método objeto | Método formulario | Objetos | -| ------------------------ | ---------------------------------------------------------------- | ----------------- | ------------------------------- | -| On Load | Sí | Sí | Todos los objetos | -| On Unload | Sí | Sí | Todos los objetos | -| On Validate | Sí | Sí | Todos los objetos | -| On Clicked | Sí | Sí | Objetos involucrados únicamente | -| On Double Clicked | Sí | Sí | Objetos involucrados únicamente | -| On Before Keystroke | Sí | Sí | Objetos involucrados únicamente | -| On After Keystroke | Sí | Sí | Objetos involucrados únicamente | -| On After Edit | Sí | Sí | Objetos involucrados únicamente | -| On Getting Focus | Sí | Sí | Objetos involucrados únicamente | -| On Losing Focus | Sí | Sí | Objetos involucrados únicamente | -| On Activate | Nunca | Sí | Ninguno | -| On Deactivate | Nunca | Sí | Ninguno | -| On Outside Call | Nunca | Sí | Ninguno | -| On Page Change | Nunca | Sí | Ninguno | -| On Begin Drag Over | Sí | Sí | Objetos involucrados únicamente | -| On Drop | Sí | Sí | Objetos involucrados únicamente | -| On Drag Over | Sí | Nunca | Objetos involucrados únicamente | -| On Mouse Enter | Sí | Sí | Todos los objetos | -| On Mouse Move | Sí | Sí | Todos los objetos | -| On Mouse Leave | Sí | Sí | Todos los objetos | -| On Mouse Up | Sí | Nunca | Objetos involucrados únicamente | -| On Menu Selected | Nunca | Sí | Ninguno | -| On Bound variable change | Nunca | Sí | Ninguno | -| On Data Change | Sí | Sí | Objetos involucrados únicamente | -| On Plug in Area | Sí | Sí | Objetos involucrados únicamente | -| On Header | Sí | Sí | Todos los objetos | -| On Printing Detail | Sí | Sí | Todos los objetos | -| On Printing Break | Sí | Sí | Todos los objetos | -| On Printing Footer | Sí | Sí | Todos los objetos | -| On Close Box | Nunca | Sí | Ninguno | -| On Display Detail | Sí | Sí | Todos los objetos | -| On Open Detail | Sí (List box) | Sí | Ninguna, excepto los list box | -| On Close Detail | Sí (List box) | Sí | Ninguna, excepto los list box | -| On Resize | Nunca | Sí | Ninguno | -| On Selection Change | Sí | Sí | Objetos involucrados únicamente | -| On Load Record | Nunca | Sí | Ninguno | -| On Timer | Nunca | Sí | Ninguno | -| On Scroll | Sí | Nunca | Objetos involucrados únicamente | -| On Before Data Entry | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Column Moved | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Row Moved | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Column Resize | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Header Click | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Footer Click | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On After Sort | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Long Click | Sí (botón) | Sí | Objetos involucrados únicamente | -| On Alternative Click | Sí (Botón y List box) | Nunca | Objetos involucrados únicamente | -| On Expand | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On Collapse | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On Delete Action | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On URL Resource Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Begin URL Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On URL Loading Error | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On URL Filtering | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On End URL Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Open External Link | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Window Opening Denied | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On VP Range Changed | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On VP Ready | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Row Resize | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| Evento | Code | Método objeto | Método formulario | Objetos | +| ------------------------ | ---- | ---------------------------------------------------------------- | ----------------- | ------------------------------- | +| On Activate | 11 | Nunca | Sí | Ninguno | +| On After Edit | 45 | Sí | Sí | Objetos involucrados únicamente | +| On After Keystroke | 28 | Sí | Sí | Objetos involucrados únicamente | +| On After Sort | 30 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Alternative Click | 38 | Sí (Botón y List box) | Nunca | Objetos involucrados únicamente | +| On Before Data Entry | 41 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Before Keystroke | 17 | Sí | Sí | Objetos involucrados únicamente | +| On Begin Drag Over | 46 | Sí | Sí | Objetos involucrados únicamente | +| On Begin URL Loading | 47 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Bound variable change | 54 | Nunca | Sí | Ninguno | +| On Clicked | 4 | Sí | Sí | Objetos involucrados únicamente | +| On Close Box | 22 | Nunca | Sí | Ninguno | +| On Close Detail | 26 | Sí (List box) | Sí | Ninguna, excepto los list box | +| On Collapse | 44 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Column Moved | 32 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Column Resize | 33 | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Data Change | 20 | Sí | Sí | Objetos involucrados únicamente | +| On Deactivate | 12 | Nunca | Sí | Ninguno | +| On Delete Action | 58 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Display Detail | 8 | Sí | Sí | Todos los objetos | +| On Double Clicked | 13 | Sí | Sí | Objetos involucrados únicamente | +| On Drag Over | 21 | Sí | Nunca | Objetos involucrados únicamente | +| On Drop | 16 | Sí | Sí | Objetos involucrados únicamente | +| On End URL Loading | 49 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Expand | 43 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Footer Click | 57 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Getting Focus | 15 | Sí | Sí | Objetos involucrados únicamente | +| On Header | 5 | Sí | Sí | Todos los objetos | +| On Header Click | 42 | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Load | 1 | Sí | Sí | Todos los objetos | +| On Load Record | 40 | Nunca | Sí | Ninguno | +| On Long Click | 39 | Sí (botón) | Sí | Objetos involucrados únicamente | +| On Losing Focus | 14 | Sí | Sí | Objetos involucrados únicamente | +| On Menu Selected | 18 | Nunca | Sí | Ninguno | +| On Mouse Enter | 35 | Sí | Sí | Todos los objetos | +| On Mouse Leave | 36 | Sí | Sí | Todos los objetos | +| On Mouse Move | 37 | Sí | Sí | Todos los objetos | +| On Mouse Up | 2 | Sí | Nunca | Objetos involucrados únicamente | +| On Open Detail | 25 | Sí (List box) | Sí | Ninguna, excepto los list box | +| On Open External Link | 52 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Outside Call | 10 | Nunca | Sí | Ninguno | +| On Page Change | 56 | Nunca | Sí | Ninguno | +| On Plug in Area | 19 | Sí | Sí | Objetos involucrados únicamente | +| On Printing Break | 6 | Sí | Sí | Todos los objetos | +| On Printing Detail | 23 | Sí | Sí | Todos los objetos | +| On Printing Footer | 7 | Sí | Sí | Todos los objetos | +| On Resize | 29 | Nunca | Sí | Ninguno | +| On Row Moved | 34 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Row Resize | 60 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Scroll | 59 | Sí | Nunca | Objetos involucrados únicamente | +| On Selection Change | 31 | Sí | Sí | Objetos involucrados únicamente | +| On Timer | 27 | Nunca | Sí | Ninguno | +| On Unload | 24 | Sí | Sí | Todos los objetos | +| On URL Filtering | 51 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On URL Loading Error | 50 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On URL Resource Loading | 48 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Validate | 3 | Sí | Sí | Todos los objetos | +| On VP Range Changed | 61 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On VP Ready | 9 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Window Opening Denied | 53 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | Tenga siempre en cuenta que, para todo evento, se llama al método de un formulario o de un objeto si se selecciona la correspondiente propiedad del evento para el formulario o los objetos. La ventaja de desactivar los eventos en el entorno de diseño (utilizando la lista de propiedades del editor de formularios) es que puede reducir el número de llamadas a los métodos y, por tanto, optimizar significativamente la velocidad de ejecución de sus formularios. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md index 6a9b41bb93ffcc..e9ba46a80b9850 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md @@ -49,7 +49,7 @@ Puede pasar un objeto 4D.File, 4D.Folder, o una estructura zip como primer pará | Propiedad | Tipo | Descripción | | ------------ | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Compresión Deflate (por defecto)
  • `ZIP Compression LZMA`: Compression LZMA
  • `ZIP Compresión XZ`: Compression XZ
  • `ZIP Compresión`: sin compresión
    • | -| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omite:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | +| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omite: | | encryption | Integer | El cifrado a usar si se define una contraseña:
  • `ZIP Encryption AES128`: encriptación AES utilizando llave de 128 bits.
  • `ZIP Encryption AES192`: encriptación AES utilizando llave de 192 bits.
  • `ZIP Encryption AES256`: encriptación AES utilizando llave de 256 bits (por defecto si se define la contraseña).
  • `ZIP Encryption none`: los datos no están cifrados (por defecto si no se define una contraseña)
    • | | contraseña | Text | Una contraseña a utilizar si se requiere encriptación. | | Histórico | Collection |
  • una colección de objetos `4D.File` o `4D.Folder` o
  • una colección de objetos con las siguientes propiedades:
    • PropiedadTipoDescripción
    source4D.Archivo o 4D.CarpetaArchivo o Carpeta
    destinoTexto(opcional) - Especifique una ruta de archivo relativa para cambiar la organización del contenido del archivo
    optionnumber(opcional) - `ZIP Ignore invisible files` o 0 para comprimir todo el archivo
    | @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## Ver también -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## Propiedades diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md index 5264cbbcc606ef..7f2af22130cf18 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ Para extraer desde la carpeta root: ## Ver también -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## Propiedades diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/Events/overview.md b/i18n/es/docusaurus-plugin-content-docs/version-21/Events/overview.md index cd5d6b107e2d73..648d7fd48c9981 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/Events/overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/Events/overview.md @@ -5,7 +5,7 @@ title: Eventos formulario Los eventos formulario son eventos que pueden llevar a la ejecución del método de formulario y/o del o de los métodos objeto de formulario. Los eventos de formulario le permiten controlar el flujo de su aplicación y escribir código que se ejecuta sólo cuando ocurre un evento específico. -En su código, usted controla los eventos utilizando el comando [`FORM Event`](../commands/form-event.md), que devuelve el evento accionado. Por ejemplo: +En su código, usted controla los eventos utilizando el comando [`FORM Event`](../commands/form-event), que devuelve el evento accionado. Por ejemplo: ```4d //code of a button @@ -18,7 +18,7 @@ End if ## Objeto evento -Cada evento es devuelto como un objeto por el comando [`FORM Event`](../commands/form-event.md). Por defecto, contiene las siguientes propiedades: +Cada evento es devuelto como un objeto por el comando [`FORM Event`](../commands/form-event). Por defecto, contiene las siguientes propiedades: | Propiedad | Tipo | Descripción | | ----------- | ------------ | ---------------------------------------------------------------------------------------------------------- | @@ -48,70 +48,71 @@ El número de objetos asociados a un evento depende de la naturaleza del mismo. El número de objetos asociados a un evento depende de la naturaleza del mismo. -| Evento | Método objeto | Método formulario | Objetos | -| ------------------------ | ---------------------------------------------------------------- | ----------------- | ------------------------------- | -| On Load | Sí | Sí | Todos los objetos | -| On Unload | Sí | Sí | Todos los objetos | -| On Validate | Sí | Sí | Todos los objetos | -| On Clicked | Sí | Sí | Objetos involucrados únicamente | -| On Double Clicked | Sí | Sí | Objetos involucrados únicamente | -| On Before Keystroke | Sí | Sí | Objetos involucrados únicamente | -| On After Keystroke | Sí | Sí | Objetos involucrados únicamente | -| On After Edit | Sí | Sí | Objetos involucrados únicamente | -| On Getting Focus | Sí | Sí | Objetos involucrados únicamente | -| On Losing Focus | Sí | Sí | Objetos involucrados únicamente | -| On Activate | Nunca | Sí | Ninguno | -| On Deactivate | Nunca | Sí | Ninguno | -| On Outside Call | Nunca | Sí | Ninguno | -| On Page Change | Nunca | Sí | Ninguno | -| On Begin Drag Over | Sí | Sí | Objetos involucrados únicamente | -| On Drop | Sí | Sí | Objetos involucrados únicamente | -| On Drag Over | Sí | Nunca | Objetos involucrados únicamente | -| On Mouse Enter | Sí | Sí | Todos los objetos | -| On Mouse Move | Sí | Sí | Todos los objetos | -| On Mouse Leave | Sí | Sí | Todos los objetos | -| On Mouse Up | Sí | Nunca | Objetos involucrados únicamente | -| On Menu Selected | Nunca | Sí | Ninguno | -| On Bound variable change | Nunca | Sí | Ninguno | -| On Data Change | Sí | Sí | Objetos involucrados únicamente | -| On Plug in Area | Sí | Sí | Objetos involucrados únicamente | -| On Header | Sí | Sí | Todos los objetos | -| On Printing Detail | Sí | Sí | Todos los objetos | -| On Printing Break | Sí | Sí | Todos los objetos | -| On Printing Footer | Sí | Sí | Todos los objetos | -| On Close Box | Nunca | Sí | Ninguno | -| On Display Detail | Sí | Sí | Todos los objetos | -| On Open Detail | Sí (List box) | Sí | Ninguna, excepto los list box | -| On Close Detail | Sí (List box) | Sí | Ninguna, excepto los list box | -| On Resize | Nunca | Sí | Ninguno | -| On Selection Change | Sí | Sí | Objetos involucrados únicamente | -| On Load Record | Nunca | Sí | Ninguno | -| On Timer | Nunca | Sí | Ninguno | -| On Scroll | Sí | Nunca | Objetos involucrados únicamente | -| On Before Data Entry | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Column Moved | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Row Moved | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Column Resize | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Header Click | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Footer Click | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On After Sort | Sí (List box) | Nunca | Objetos involucrados únicamente | -| On Long Click | Sí (botón) | Sí | Objetos involucrados únicamente | -| On Alternative Click | Sí (Botón y List box) | Nunca | Objetos involucrados únicamente | -| On Expand | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On Collapse | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On Delete Action | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | -| On URL Resource Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Begin URL Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On URL Loading Error | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On URL Filtering | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On End URL Loading | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Open External Link | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On Window Opening Denied | Sí (Área Web) | Nunca | Objetos involucrados únicamente | -| On VP Range Changed | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On VP Ready | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | -| On Row Resize | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| Evento | Code | Método objeto | Método formulario | Objetos | +| ------------------------ | ---- | ---------------------------------------------------------------- | ----------------- | ------------------------------- | +| On Activate | 11 | Nunca | Sí | Ninguno | +| On After Edit | 45 | Sí | Sí | Objetos involucrados únicamente | +| On After Keystroke | 28 | Sí | Sí | Objetos involucrados únicamente | +| On After Sort | 30 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Alternative Click | 38 | Sí (Botón y List box) | Nunca | Objetos involucrados únicamente | +| On Before Data Entry | 41 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Before Keystroke | 17 | Sí | Sí | Objetos involucrados únicamente | +| On Begin Drag Over | 46 | Sí | Sí | Objetos involucrados únicamente | +| On Begin URL Loading | 47 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Bound variable change | 54 | Nunca | Sí | Ninguno | +| On Clicked | 4 | Sí | Sí | Objetos involucrados únicamente | +| On Close Box | 22 | Nunca | Sí | Ninguno | +| On Close Detail | 26 | Sí (List box) | Sí | Ninguna, excepto los list box | +| On Collapse | 44 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Column Moved | 32 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Column Resize | 33 | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Data Change | 20 | Sí | Sí | Objetos involucrados únicamente | +| On Deactivate | 12 | Nunca | Sí | Ninguno | +| On Delete Action | 58 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Display Detail | 8 | Sí | Sí | Todos los objetos | +| On Double Clicked | 13 | Sí | Sí | Objetos involucrados únicamente | +| On Drag Over | 21 | Sí | Nunca | Objetos involucrados únicamente | +| On Drop | 16 | Sí | Sí | Objetos involucrados únicamente | +| On End URL Loading | 49 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Expand | 43 | Sí (Lista jerarq. y list box) | Nunca | Objetos involucrados únicamente | +| On Footer Click | 57 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Getting Focus | 15 | Sí | Sí | Objetos involucrados únicamente | +| On Header | 5 | Sí | Sí | Todos los objetos | +| On Header Click | 42 | Sí (List box y Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Load | 1 | Sí | Sí | Todos los objetos | +| On Load Record | 40 | Nunca | Sí | Ninguno | +| On Long Click | 39 | Sí (botón) | Sí | Objetos involucrados únicamente | +| On Losing Focus | 14 | Sí | Sí | Objetos involucrados únicamente | +| On Menu Selected | 18 | Nunca | Sí | Ninguno | +| On Mouse Enter | 35 | Sí | Sí | Todos los objetos | +| On Mouse Leave | 36 | Sí | Sí | Todos los objetos | +| On Mouse Move | 37 | Sí | Sí | Todos los objetos | +| On Mouse Up | 2 | Sí | Nunca | Objetos involucrados únicamente | +| On Open Detail | 25 | Sí (List box) | Sí | Ninguna, excepto los list box | +| On Open External Link | 52 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Outside Call | 10 | Nunca | Sí | Ninguno | +| On Page Change | 56 | Nunca | Sí | Ninguno | +| On Plug in Area | 19 | Sí | Sí | Objetos involucrados únicamente | +| On Printing Break | 6 | Sí | Sí | Todos los objetos | +| On Printing Detail | 23 | Sí | Sí | Todos los objetos | +| On Printing Footer | 7 | Sí | Sí | Todos los objetos | +| On Resize | 29 | Nunca | Sí | Ninguno | +| On Row Moved | 34 | Sí (List box) | Nunca | Objetos involucrados únicamente | +| On Row Resize | 60 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Scroll | 59 | Sí | Nunca | Objetos involucrados únicamente | +| On Selection Change | 31 | Sí | Sí | Objetos involucrados únicamente | +| On Timer | 27 | Nunca | Sí | Ninguno | +| On Unload | 24 | Sí | Sí | Todos los objetos | +| On URL Filtering | 51 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On URL Loading Error | 50 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On URL Resource Loading | 48 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | +| On Validate | 3 | Sí | Sí | Todos los objetos | +| On VP Range Changed | 61 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On VP Ready | 9 | Sí (Área 4D View Pro) | Nunca | Objetos involucrados únicamente | +| On Window Opening Denied | 53 | Sí (Área Web) | Nunca | Objetos involucrados únicamente | Tenga siempre en cuenta que, para todo evento, se llama al método de un formulario o de un objeto si se selecciona la correspondiente propiedad del evento para el formulario o los objetos. La ventaja de desactivar los eventos en el entorno de diseño (utilizando la lista de propiedades del editor de formularios) es que puede reducir el número de llamadas a los métodos y, por tanto, optimizar significativamente la velocidad de ejecución de sus formularios. > Excepto en los eventos [En carga](onLoad.md) y [En descarga](onUnload.md) (ver más abajo), si la propiedad del evento formulario no está seleccionada para un evento determinado, esto no impide las llamadas a los métodos objetos cuya misma propiedad de eve En otras palabras, la activación o desactivación de un evento a nivel de formulario no tiene ningún efecto sobre las propiedades del evento del objeto. Si los eventos están activados sólo para los objetos, no se producirán; estos dos eventos también deben estar activados a nivel del formulario. + diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md b/i18n/es/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md index 02bbf74cf63ee2..fac2fb49c3f3a1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md @@ -45,14 +45,14 @@ Puede pasar un objeto 4D.File, 4D.Folder, o una estructura zip como primer pará - *zipStructure*: pase un objeto que describa el objeto ZIP archivo. Las siguientes propiedades están disponibles para definir la estructura: -| Propiedad | Tipo | Descripción | -| ------------ | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| compression | Integer |
  • `ZIP Compression standard`: Compresión Deflate (por defecto)
  • `ZIP Compression LZMA`: Compression LZMA
  • `ZIP Compresión XZ`: Compression XZ
  • `ZIP Compresión`: sin compresión
    • | -| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Valores por defecto si se omite:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | El cifrado a utilizar si se define una contraseña
  • :`ZIP Encryption AES128`: Cifrado AES con clave de 128 bits.
  • `ZIP Encryption AES192`: cifrado AES con una clave de 192 bits.
  • `ZIP Encryption AES256`: encriptación AES con una llave de 256 bits (por defecto si se define la contraseña).
  • `ZIP Encryption none`: los datos no se encriptan (por defecto si no se define contraseña).
    • | -| contraseña | Text | Una contraseña a utilizar si se requiere encriptación. | -| Histórico | Collection |
  • una colección de objetos `4D.File` o `4D.Folder` o
  • una colección de objetos con las siguientes propiedades:
    • PropiedadTipoDescripción
    source4D.Archivo o 4D.CarpetaArchivo o Carpeta
    destinoTexto(opcional) - Especifique una ruta de archivo relativa para cambiar la organización del contenido del archivo
    optionnumber(opcional) - `ZIP Ignore invisible files` o 0 para comprimir todo el archivo
    | -| retrollamada | 4D.Function | Una fórmula de retrollamada que recibirá la progresión de la compresión (0 - 100) en $1. | +| Propiedad | Tipo | Descripción | +| ------------ | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| compression | Integer |
  • `ZIP Compression standard`: Compresión Deflate (por defecto)
  • `ZIP Compression LZMA`: Compression LZMA
  • `ZIP Compresión XZ`: Compression XZ
  • `ZIP Compresión`: sin compresión
    • | +| level | Integer | Nivel de compresión. Valores posibles: 1 a 10. Un valor más bajo producirá un archivo más grande, mientras que un valor más alto producirá un archivo más pequeño. Sin embargo, el nivel de compresión influye en el rendimiento. Default values if omitted: | +| encryption | Integer | The encryption to use if a password is set: | +| contraseña | Text | Una contraseña a utilizar si se requiere encriptación. | +| Histórico | Collection |
  • una colección de objetos `4D.File` o `4D.Folder` o
  • una colección de objetos con las siguientes propiedades:
    • PropiedadTipoDescripción
    source4D.Archivo o 4D.CarpetaArchivo o Carpeta
    destinoTexto(opcional) - Especifique una ruta de archivo relativa para cambiar la organización del contenido del archivo
    optionnumber(opcional) - `ZIP Ignore invisible files` o 0 para comprimir todo el archivo
    | +| retrollamada | 4D.Function | Una fórmula de retrollamada que recibirá la progresión de la compresión (0 - 100) en $1. | En el parámetro *destinationFile*, pase un objeto `4D.File` que describa el archivo ZIP a crear (nombre, ubicación, etc.). Se aconseja utilizar la extensión ".zip" si quiere que el archivo ZIP sea procesado automáticamente por cualquier software. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Admin/data-collect.md b/i18n/fr/docusaurus-plugin-content-docs/current/Admin/data-collect.md index 64d9ff9a007ea4..3374812340dcf9 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Admin/data-collect.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Admin/data-collect.md @@ -37,10 +37,12 @@ Certaines données sont également collectées à intervalles réguliers. | cacheReadCount | Object | Nombre de lectures dans le cache | | classUsage | Object | Nombre d'instances de certaines classes du langage | | connectionSystems | Collection | Système d'exploitation du client sans le numéro de build (entre parenthèses) et nombre de clients qui l'utilisent | +| databases[].backupSettings | Object | Current backup settings values | | databases[].cacheSize | Number | Taille du cache en octets | | databases[].compatibilitySettings | Object | Paramètres de compatibilité activés | | databases[].externalDatastoreOpened | Number | Nombre d'appels à `Open datastore` | | databases[].fluentUI | Boolean | Vrai si l'option "Utiliser Fluent UI sous Windows" est sélectionnée | +| databases[].flushCacheInterval | Number | Defined time period between each automatic saving of the data cache | | databases[].id | Number | ID de la base de données | | databases[].internalDatastoreOpened | Number | Nombre de fois où le datastore est ouvert par un serveur externe | | databases[].maxConcurrent4DClients | Number | Nombre maximum de sessions 4D Client simultanées (utilisant une licence 4D Client) sur l'intervalle de collecte | @@ -52,6 +54,7 @@ Certaines données sont également collectées à intervalles réguliers. | databases[].numberOfKeepRecordSyncInfo | Number | Nombre de tables dont l'option "Activer la réplication" est cochée | | databases[].numberOfRecordsMax | Number | Nombre total d'enregistrements | | databases[].numberOfTables | Number | Nombre de tables | +| databases[].numberOfUncaughtExecutionErrors | Number | Number of times an execution error is displayed as an alert | | databases[].qodly.webforms | Number | Nombre de webforms Qodly | | databases[].remoteDebugger4DRemoteAttachments | Number | Nombre de rattachements au débogueur distant à partir d'un 4D distant | | databases[].remoteDebuggerQodlyAttachments | Number | Nombre de rattachements au débogueur distant à partir de Qodly | @@ -92,6 +95,7 @@ Certaines données sont également collectées à intervalles réguliers. | isEncrypted | Boolean | Vrai si le fichier de données est chiffré | | isEngined | Boolean | True si l'application est fusionnée avec 4D Volume Desktop | | isProjectMode | Boolean | True si l'application est un projet | +| isShadowCopyActivated | Boolean | True if the Volume Shadow Copy feature is enabled (Windows only | | LDAPLogin | Number | Nombre d'appels à la fonction `LDAP LOGIN` | | license.sffPrimaryKey | Number | Numéro de produit du serveur principal | | machine.CPU | Text | Nom, type et vitesse du processeur | @@ -102,6 +106,7 @@ Certaines données sont également collectées à intervalles réguliers. | maximumUsedPhysicalMemory | Number | Utilisation maximale de la mémoire physique | | maximumUsedVirtualMemory | Number | Utilisation maximale de la mémoire virtuelle | | mobile | Collection | Informations sur les sessions mobiles | +| numberOfCrashes | Number | Number of times 4D has crashed | | numberOfWebServices | Number | Nombre de méthodes publiées en tant que Services Web | | ODBCLogin | Number | Nombre d'appels à `SQL LOGIN` utilisant ODBC | | phpCall | Number | Nombre d'appels à `PHP execute` | diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/Events/overview.md b/i18n/fr/docusaurus-plugin-content-docs/current/Events/overview.md index d4ee3bf70015fe..a53136e95d81c3 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/Events/overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/Events/overview.md @@ -48,68 +48,68 @@ Le nombre d'objets associés à un événement dépend de la nature de l'événe Le tableau suivant résume la manière dont les méthodes objet et formulaire sont appelées pour chaque type d'événement : -| Evénement | Méthode objet | Méthode formulaire | Objets | -| ------------------------ | ------------------------------------------------------------------ | ------------------ | --------------------------- | -| On Load | Oui | Oui | Tous les objets | -| On Unload | Oui | Oui | Tous les objets | -| On Validate | Oui | Oui | Tous les objets | -| On Clicked | Oui | Oui | Objets concernés uniquement | -| On Double Clicked | Oui | Oui | Objets concernés uniquement | -| On Before Keystroke | Oui | Oui | Objets concernés uniquement | -| On After Keystroke | Oui | Oui | Objets concernés uniquement | -| On After Edit | Oui | Oui | Objets concernés uniquement | -| On Getting Focus | Oui | Oui | Objets concernés uniquement | -| On Losing Focus | Oui | Oui | Objets concernés uniquement | -| On Activate | Jamais | Oui | Aucun | -| On Deactivate | Jamais | Oui | Aucun | -| On Outside Call | Jamais | Oui | Aucun | -| On Page Change | Jamais | Oui | Aucun | -| On Begin Drag Over | Oui | Oui | Objets concernés uniquement | -| On Drop | Oui | Oui | Objets concernés uniquement | -| On Drag Over | Oui | Jamais | Objets concernés uniquement | -| On Mouse Enter | Oui | Oui | Tous les objets | -| On Mouse Move | Oui | Oui | Tous les objets | -| On Mouse Leave | Oui | Oui | Tous les objets | -| On Mouse Up | Oui | Jamais | Objets concernés uniquement | -| On Menu Selected | Jamais | Oui | Aucun | -| On Bound variable change | Jamais | Oui | Aucun | -| On Data Change | Oui | Oui | Objets concernés uniquement | -| On Plug in Area | Oui | Oui | Objets concernés uniquement | -| On Header | Oui | Oui | Tous les objets | -| On Printing Detail | Oui | Oui | Tous les objets | -| On Printing Break | Oui | Oui | Tous les objets | -| On Printing Footer | Oui | Oui | Tous les objets | -| On Close Box | Jamais | Oui | Aucun | -| On Display Detail | Oui | Oui | Tous les objets | -| On Open Detail | Oui (List box) | Oui | Aucun, excepté les List box | -| On Close Detail | Oui (List box) | Oui | Aucun, excepté les List box | -| On Resize | Jamais | Oui | Aucun | -| On Selection Change | Oui | Oui | Objets concernés uniquement | -| On Load Record | Jamais | Oui | Aucun | -| On Timer | Jamais | Oui | Aucun | -| On Scroll | Oui | Jamais | Objets concernés uniquement | -| On Before Data Entry | Oui (List box) | Jamais | Objets concernés uniquement | -| On Column Moved | Oui (List box) | Jamais | Objets concernés uniquement | -| On Row Moved | Oui (List box) | Jamais | Objets concernés uniquement | -| On Column Resize | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | -| On Header Click | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | -| On Footer Click | Oui (List box) | Jamais | Objets concernés uniquement | -| On After Sort | Oui (List box) | Jamais | Objets concernés uniquement | -| On Long Click | Oui (Bouton) | Oui | Objets concernés uniquement | -| On Alternative Click | Oui (Bouton et List box) | Jamais | Objets concernés uniquement | -| On Expand | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On Collapse | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On Delete Action | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On URL Resource Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Begin URL Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On URL Loading Error | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On URL Filtering | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On End URL Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Open External Link | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Window Opening Denied | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On VP Range Changed | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | -| On VP Ready | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | -| On Row Resize | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| Evénement | Code | Méthode objet | Méthode formulaire | Objets | +| ------------------------ | ---- | ------------------------------------------------------------------ | ------------------ | --------------------------- | +| On Activate | 11 | Jamais | Oui | Aucun | +| On After Edit | 45 | Oui | Oui | Objets concernés uniquement | +| On After Keystroke | 28 | Oui | Oui | Objets concernés uniquement | +| On After Sort | 30 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Alternative Click | 38 | Oui (Bouton et List box) | Jamais | Objets concernés uniquement | +| On Before Data Entry | 41 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Before Keystroke | 17 | Oui | Oui | Objets concernés uniquement | +| On Begin Drag Over | 46 | Oui | Oui | Objets concernés uniquement | +| On Begin URL Loading | 47 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Bound variable change | 54 | Jamais | Oui | Aucun | +| On Clicked | 4 | Oui | Oui | Objets concernés uniquement | +| On Close Box | 22 | Jamais | Oui | Aucun | +| On Close Detail | 26 | Oui (List box) | Oui | Aucun, excepté les List box | +| On Collapse | 44 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Column Moved | 32 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Column Resize | 33 | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | +| On Data Change | 20 | Oui | Oui | Objets concernés uniquement | +| On Deactivate | 12 | Jamais | Oui | Aucun | +| On Delete Action | 58 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Display Detail | 8 | Oui | Oui | Tous les objets | +| On Double Clicked | 13 | Oui | Oui | Objets concernés uniquement | +| On Drag Over | 21 | Oui | Jamais | Objets concernés uniquement | +| On Drop | 16 | Oui | Oui | Objets concernés uniquement | +| On End URL Loading | 49 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Expand | 43 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Footer Click | 57 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Getting Focus | 15 | Oui | Oui | Objets concernés uniquement | +| On Header | 5 | Oui | Oui | Tous les objets | +| On Header Click | 42 | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | +| On Load | 1 | Oui | Oui | Tous les objets | +| On Load Record | 40 | Jamais | Oui | Aucun | +| On Long Click | 39 | Oui (Bouton) | Oui | Objets concernés uniquement | +| On Losing Focus | 14 | Oui | Oui | Objets concernés uniquement | +| On Menu Selected | 18 | Jamais | Oui | Aucun | +| On Mouse Enter | 35 | Oui | Oui | Tous les objets | +| On Mouse Leave | 36 | Oui | Oui | Tous les objets | +| On Mouse Move | 37 | Oui | Oui | Tous les objets | +| On Mouse Up | 2 | Oui | Jamais | Objets concernés uniquement | +| On Open Detail | 25 | Oui (List box) | Oui | Aucun, excepté les List box | +| On Open External Link | 52 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Outside Call | 10 | Jamais | Oui | Aucun | +| On Page Change | 56 | Jamais | Oui | Aucun | +| On Plug in Area | 19 | Oui | Oui | Objets concernés uniquement | +| On Printing Break | 6 | Oui | Oui | Tous les objets | +| On Printing Detail | 23 | Oui | Oui | Tous les objets | +| On Printing Footer | 7 | Oui | Oui | Tous les objets | +| On Resize | 29 | Jamais | Oui | Aucun | +| On Row Moved | 34 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Row Resize | 60 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On Scroll | 59 | Oui | Jamais | Objets concernés uniquement | +| On Selection Change | 31 | Oui | Oui | Objets concernés uniquement | +| On Timer | 27 | Jamais | Oui | Aucun | +| On Unload | 24 | Oui | Oui | Tous les objets | +| On URL Filtering | 51 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On URL Loading Error | 50 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On URL Resource Loading | 48 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Validate | 3 | Oui | Oui | Tous les objets | +| On VP Range Changed | 61 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On VP Ready | 9 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On Window Opening Denied | 53 | Oui (Zone Web) | Jamais | Objets concernés uniquement | Gardez toujours à l'esprit que, pour tout événement, la méthode d'un formulaire ou d'un objet est appelée si la propriété d'événement correspondante est sélectionnée pour le formulaire ou les objets. L'avantage de la désactivation des événements dans l'environnement de développement (à l'aide de la liste des propriétés de l'éditeur de formulaires) est la réduction du nombre d'appels vers des méthodes et par conséquent l'optimisation de la vitesse d'exécution de vos formulaires. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/folder.md b/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/folder.md index 8ff6cd5b8cc711..d45ea55fc16bf8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/folder.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/folder.md @@ -77,10 +77,10 @@ Si la commande est appelée à partir d'un composant, passez le paramètre optio ## Voir également -[classe `4D.Folder`](../../API/FolderClass.md) -[File](../commands/file)\ -[Object to path](../../commands-legacy/object-to-path)\ -[Path to object](../../commands-legacy/path-to-object) +[classe `4D.Folder`](../../API/FolderClass.md) +[File](../commands/file) +[Object to path](../../commands-legacy/object-to-path) +[Path to object](../../commands-legacy/path-to-object) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md b/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md index 437e187c33af76..38e0a5a669c012 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md @@ -49,17 +49,17 @@ Vous pouvez passer un objet 4D.File, 4D.Folder, ou une structure Zip en tant que | Propriété | Type | Description | | ----------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard` : Compression Deflate (par défaut)
  • `ZIP Compression LZMA` : Compression LZMA
  • `ZIP Compression XZ` : Compression XZ
  • `ZIP Compression none` : Pas de compression
    • | -| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Valeurs par défaut si omis :
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | Le cryptage à utiliser si un mot de passe est défini
  • :`ZIP Encryption AES128` : Cryptage AES avec une clé de 128 bits.
  • `ZIP Encryption AES192`: Cryptage AES avec une clé de 192 bits.
  • `ZIP Encryption AES256`: Cryptage AES à l'aide d'une clé de 256 bits (par défaut si un mot de passe est défini).
  • `ZIP Encryption none`: les données ne sont pas cryptées (par défaut si aucun mot de passe n'est défini)
    • | +| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Valeurs par défaut si omis : | +| encryption | Integer | Le cryptage à utiliser si un mot de passe est défini | | password | Text | Un mot de passe à définir si le chiffrement est requis. | -| Historique | Collection |
  • une collection d'objets `4D.File` ou `4D.Folder` ou
  • une collection d'objets avec les propriétés suivantes :
    • PropriétéTypeDescription
    source4D.File ou 4D.FolderFichier ou dossier
    destinationTexte(facultatif) - Spécifie un chemin relatif pour changer l'organisation du contenu de l'archive
    optionnombre(facultatif) - `ZIP Ignore invisible files` ou 0 pour compresser l'intégralité du fichier
    | +| files | Collection |
    PropriétéTypeDescription
    source4D.File ou 4D.FolderFichier ou dossier
    destinationTexte(facultatif) - Spécifie un chemin relatif pour changer l'organisation du contenu de l'archive
    optionnumérique(facultatif) - `ZIP Ignore invisible files` ou 0 pour compresser l'intégralité du fichier
    | | callback | 4D.Function | Une formule de rétro-appel qui recevra la progression de la compression (0 à 100) dans $1. | -Dans le paramètre *destinationFile*, passez un objet `4D.File` décrivant l'archive ZIP à créer (nom, emplacement, etc.). Il est conseillé d'utiliser l'extension ".zip" si vous souhaitez que l'archive ZIP soit traitée automatiquement par un logiciel. +Dans le paramètre *destinationFile*, passez un objet `4D.File` décrivant l'archive ZIP à créer (nom, emplacement, etc.). Il est conseillé d'utiliser l'extension ".zip" si vous souhaitez que l'archive ZIP soit traitée automatiquement par n'importe quel logiciel. Une fois que l'archive est créée, vous pouvez utiliser la commande [ZIP Read archive](../commands/zip-read-archive) pour y accéder. -**Status object** +**Objet statut** L'objet statut retourné contient les propriétés suivantes : @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## Voir également -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md b/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md index 70f90d1885755c..4c036b9f1e6819 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ Pour extraire à partir du dossier root : ## Voir également -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/Process (Communications)/call-worker.md b/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/Process (Communications)/call-worker.md index bb569a28b8e2bb..590ef0dea51957 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/Process (Communications)/call-worker.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/language-legacy/Process (Communications)/call-worker.md @@ -65,23 +65,23 @@ Dans un formulaire, un bouton démarre un calcul, par exemple des statistiques p Voici la méthode du bouton : ```4d -  //appelle le process worker vNomWorker avec le paramètre - var $vAnn: éeInteger - $vAnnée:=2015 //peut être sélectionné par l’utilisateur dans le formulaire - CALL WORKER("monWorker";Formula(workerMethod);vAnnée;Current form window) +  //appelle le worker monWorker avec le paramètre + var $vAnnée : Integer + $vAnnée:=2015 //peut avoir été sélectionné par l’utilisateur dans le formulaire + CALL WORKER("monWorker";Formula(workerMethod);$vAnnée;Current form window) ``` -Voici le code de *méthodeWorker* : +Voici le code de *workerMethod* : ```4d   //voici la méthode du worker   //peut être préemptif ou coopératif  #DECLARE($vAnnéeInteger;$fenetreInteger) //référence de l'année et de la fenêtre - var $vR: ésultatStatistiquesObject //stockage de résultats statistiques + var $vRésultatStatistiques : Object //stockage de résultats statistiques  ... //calcul des statistiques   //une fois le calcul terminé, rappel du formulaire avec les valeurs calculées   //$vRésultatStatistiques peut afficher les résultats dans le formulaire - CALL FORM($fenetre;Formula(affichageStats);vRésultatStatistiques) + CALL FORM($fenetre;Formula(affichageStats);$vRésultatStatistiques) ``` ## Voir aussi diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md index daa2e3f8b86fe9..5edc09d2c35be1 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md @@ -77,13 +77,13 @@ Vous pouvez passer un objet 4D.File, 4D.Folder, ou une structure Zip en tant que | Propriété | Type | Description | | ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Réduire la compression (par défaut)
  • `ZIP Compression LZMA`: compression LZMA
  • `ZIP Compression XZ`: compression XZ
  • `ZIP Compression none`: Pas de compression
    • | -| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Valeur par défaut (si omis) :
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | +| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Valeur par défaut (si omis) : | | encryption | Integer | Le chiffrement à utiliser si un mot de passe est défini :
  • `ZIP Encryption AES128`: chiffrement AES à l'aide d'une clé 128 octets.
  • `ZIP Encryption AES192`: chiffrement AES à l'aide d'une clé 192 octets.
  • `ZIP Encryption AES256`: chiffrement AES à l'aide d'une clé 256 octets (par défaut si un mot de passe est défini).
  • `ZIP Encryption none`: les données ne sont pas chiffrées (par défaut si aucun mot de passe n'est défini)
    • | | password | Text | Un mot de passe à définir si le chiffrement est requis. | | Historique | Collection |
  • une collection d'objets `4D.File` ou `4D.Folder` ou
  • une collection d'objets dont les propriétés sont les suivantes :
    • PropriétéTypeDescription
    source4D.File ou 4D.FolderFile ou Folder
    destinationText(facultatif) - Indiquer un chemin de fichier relatif pour modifier l'organisation du contenu de l'archive
    optionnumber(facultatif) - `ZIP Ignore invisible files` ou 0 pour compresser tout le fichier
    | | callback | 4D.Function | Une formule de rétro-appel qui recevra la progression de la compression (0 à 100) dans $1. | -Dans le paramètre *destinationFile*, passez un objet `4D.File` décrivant l'archive ZIP à créer (nom, emplacement, etc.). Il est conseillé d'utiliser l'extension ".zip" si vous souhaitez que l'archive ZIP soit traitée automatiquement par un logiciel. +Dans le paramètre *destinationFile*, passez un objet `4D.File` décrivant l'archive ZIP à créer (nom, emplacement, etc.). Il est conseillé d'utiliser l'extension ".zip" si vous souhaitez que l'archive ZIP soit traitée automatiquement par n'importe quel logiciel. Une fois que l'archive est créée, vous pouvez utiliser la commande [ZIP Read archive](#zip-read-archive) pour y accéder. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md b/i18n/fr/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md index 844e542a8b8f4c..c4f3f86731c3ac 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md @@ -75,14 +75,14 @@ Vous pouvez passer un objet 4D.File, 4D.Folder, ou une structure Zip en tant que - *zipStructure* : passez un objet décrivant l'objet ZIP archive. Les propriétés suivantes sont disponibles pour définir la structure : -| Propriété | Type | Description | -| ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| compression | Integer |
  • `ZIP Compression standard`: Réduire la compression (par défaut)
  • `ZIP Compression LZMA`: compression LZMA
  • `ZIP Compression XZ`: compression XZ
  • `ZIP Compression none`: Pas de compression
    • | -| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Valeur par défaut (si omis) :
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | Le chiffrement à utiliser si un mot de passe est défini :
  • `ZIP Encryption AES128`: chiffrement AES à l'aide d'une clé 128 octets.
  • `ZIP Encryption AES192`: chiffrement AES à l'aide d'une clé 192 octets.
  • `ZIP Encryption AES256`: chiffrement AES à l'aide d'une clé 256 octets (par défaut si un mot de passe est défini).
  • `ZIP Encryption none`: les données ne sont pas chiffrées (par défaut si aucun mot de passe n'est défini)
    • | -| password | Text | Un mot de passe à définir si le chiffrement est requis. | -| Historique | Collection |
  • une collection d'objets `4D.File` ou `4D.Folder` ou
  • une collection d'objets dont les propriétés sont les suivantes :
    • PropriétéTypeDescription
    source4D.File ou 4D.FolderFile ou Folder
    destinationText(facultatif) - Indiquer un chemin de fichier relatif pour modifier l'organisation du contenu de l'archive
    optionnumber(facultatif) - `ZIP Ignore invisible files` ou 0 pour compresser tout le fichier
    | -| callback | 4D.Function | Une formule de rétro-appel qui recevra la progression de la compression (0 à 100) dans $1. | +| Propriété | Type | Description | +| ----------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| compression | Integer |
  • `ZIP Compression standard`: Réduire la compression (par défaut)
  • `ZIP Compression LZMA`: compression LZMA
  • `ZIP Compression XZ`: compression XZ
  • `ZIP Compression none`: Pas de compression
    • | +| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Valeur par défaut (si omis) : | +| encryption | Integer | Le chiffrement à utiliser si un mot de passe est défini : | +| password | Text | Un mot de passe à définir si le chiffrement est requis. | +| Historique | Collection |
  • une collection d'objets `4D.File` ou `4D.Folder` ou
  • une collection d'objets dont les propriétés sont les suivantes :
    • PropriétéTypeDescription
    source4D.File ou 4D.FolderFile ou Folder
    destinationText(facultatif) - Indiquer un chemin de fichier relatif pour modifier l'organisation du contenu de l'archive
    optionnumber(facultatif) - `ZIP Ignore invisible files` ou 0 pour compresser tout le fichier
    | +| callback | 4D.Function | Une formule de rétro-appel qui recevra la progression de la compression (0 à 100) dans $1. | Dans le paramètre *destinationFile*, passez un objet `4D.File` décrivant l'archive ZIP à créer (nom, emplacement, etc.). Il est conseillé d'utiliser l'extension ".zip" si vous souhaitez que l'archive ZIP soit traitée automatiquement par un logiciel. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-20/Events/overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-20/Events/overview.md index f491fe60298353..e34660f38b97d1 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-20/Events/overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-20/Events/overview.md @@ -49,70 +49,71 @@ Le nombre d'objets associés à un événement dépend de la nature de l'événe Le tableau suivant résume la manière dont les méthodes objet et formulaire sont appelées pour chaque type d'événement : -| Evénement | Méthode objet | Méthode formulaire | Objets | -| ------------------------ | ---------------------------------- | ------------------ | --------------------------- | -| On Load | Oui | Oui | Tous les objets | -| On Unload | Oui | Oui | Tous les objets | -| On Validate | Oui | Oui | Tous les objets | -| On Clicked | Oui | Oui | Objets concernés uniquement | -| On Double Clicked | Oui | Oui | Objets concernés uniquement | -| On Before Keystroke | Oui | Oui | Objets concernés uniquement | -| On After Keystroke | Oui | Oui | Objets concernés uniquement | -| On After Edit | Oui | Oui | Objets concernés uniquement | -| On Getting Focus | Oui | Oui | Objets concernés uniquement | -| On Losing Focus | Oui | Oui | Objets concernés uniquement | -| On Activate | Jamais | Oui | Aucun | -| On Deactivate | Jamais | Oui | Aucun | -| On Outside Call | Jamais | Oui | Aucun | -| On Page Change | Jamais | Oui | Aucun | -| On Begin Drag Over | Oui | Oui | Objets concernés uniquement | -| On Drop | Oui | Oui | Objets concernés uniquement | -| On Drag Over | Oui | Jamais | Objets concernés uniquement | -| On Mouse Enter | Oui | Oui | Tous les objets | -| On Mouse Move | Oui | Oui | Tous les objets | -| On Mouse Leave | Oui | Oui | Tous les objets | -| On Mouse Up | Oui | Jamais | Objets concernés uniquement | -| On Menu Selected | Jamais | Oui | Aucun | -| On Bound variable change | Jamais | Oui | Aucun | -| On Data Change | Oui | Oui | Objets concernés uniquement | -| On Plug in Area | Oui | Oui | Objets concernés uniquement | -| On Header | Oui | Oui | Tous les objets | -| On Printing Detail | Oui | Oui | Tous les objets | -| On Printing Break | Oui | Oui | Tous les objets | -| On Printing Footer | Oui | Oui | Tous les objets | -| On Close Box | Jamais | Oui | Aucun | -| On Display Detail | Oui | Oui | Tous les objets | -| On Open Detail | Oui (List box) | Oui | Aucun, excepté les List box | -| On Close Detail | Oui (List box) | Oui | Aucun, excepté les List box | -| On Resize | Jamais | Oui | Aucun | -| On Selection Change | Oui | Oui | Objets concernés uniquement | -| On Load Record | Jamais | Oui | Aucun | -| On Timer | Jamais | Oui | Aucun | -| On Scroll | Oui | Jamais | Objets concernés uniquement | -| On Before Data Entry | Oui (List box) | Jamais | Objets concernés uniquement | -| On Column Moved | Oui (List box) | Jamais | Objets concernés uniquement | -| On Row Moved | Oui (List box) | Jamais | Objets concernés uniquement | -| On Column Resize | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | -| On Header Click | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | -| On Footer Click | Oui (List box) | Jamais | Objets concernés uniquement | -| On After Sort | Oui (List box) | Jamais | Objets concernés uniquement | -| On Long Click | Oui (Bouton) | Oui | Objets concernés uniquement | -| On Alternative Click | Oui (Bouton et List box) | Jamais | Objets concernés uniquement | -| On Expand | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On Collapse | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On Delete Action | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On URL Resource Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Begin URL Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On URL Loading Error | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On URL Filtering | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On End URL Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Open External Link | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Window Opening Denied | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On VP Range Changed | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | -| On VP Ready | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | -| On Row Resize | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| Evénement | Code | Méthode objet | Méthode formulaire | Objets | +| ------------------------ | ---- | ---------------------------------- | ------------------ | --------------------------- | +| On Activate | 11 | Jamais | Oui | Aucun | +| On After Edit | 45 | Oui | Oui | Objets concernés uniquement | +| On After Keystroke | 28 | Oui | Oui | Objets concernés uniquement | +| On After Sort | 30 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Alternative Click | 38 | Oui (Bouton et List box) | Jamais | Objets concernés uniquement | +| On Before Data Entry | 41 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Before Keystroke | 17 | Oui | Oui | Objets concernés uniquement | +| On Begin Drag Over | 46 | Oui | Oui | Objets concernés uniquement | +| On Begin URL Loading | 47 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Bound variable change | 54 | Jamais | Oui | Aucun | +| On Clicked | 4 | Oui | Oui | Objets concernés uniquement | +| On Close Box | 22 | Jamais | Oui | Aucun | +| On Close Detail | 26 | Oui (List box) | Oui | Aucun, excepté les List box | +| On Collapse | 44 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Column Moved | 32 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Column Resize | 33 | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | +| On Data Change | 20 | Oui | Oui | Objets concernés uniquement | +| On Deactivate | 12 | Jamais | Oui | Aucun | +| On Delete Action | 58 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Display Detail | 8 | Oui | Oui | Tous les objets | +| On Double Clicked | 13 | Oui | Oui | Objets concernés uniquement | +| On Drag Over | 21 | Oui | Jamais | Objets concernés uniquement | +| On Drop | 16 | Oui | Oui | Objets concernés uniquement | +| On End URL Loading | 49 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Expand | 43 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Footer Click | 57 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Getting Focus | 15 | Oui | Oui | Objets concernés uniquement | +| On Header | 5 | Oui | Oui | Tous les objets | +| On Header Click | 42 | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | +| On Load | 1 | Oui | Oui | Tous les objets | +| On Load Record | 40 | Jamais | Oui | Aucun | +| On Long Click | 39 | Oui (Bouton) | Oui | Objets concernés uniquement | +| On Losing Focus | 14 | Oui | Oui | Objets concernés uniquement | +| On Menu Selected | 18 | Jamais | Oui | Aucun | +| On Mouse Enter | 35 | Oui | Oui | Tous les objets | +| On Mouse Leave | 36 | Oui | Oui | Tous les objets | +| On Mouse Move | 37 | Oui | Oui | Tous les objets | +| On Mouse Up | 2 | Oui | Jamais | Objets concernés uniquement | +| On Open Detail | 25 | Oui (List box) | Oui | Aucun, excepté les List box | +| On Open External Link | 52 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Outside Call | 10 | Jamais | Oui | Aucun | +| On Page Change | 56 | Jamais | Oui | Aucun | +| On Plug in Area | 19 | Oui | Oui | Objets concernés uniquement | +| On Printing Break | 6 | Oui | Oui | Tous les objets | +| On Printing Detail | 23 | Oui | Oui | Tous les objets | +| On Printing Footer | 7 | Oui | Oui | Tous les objets | +| On Resize | 29 | Jamais | Oui | Aucun | +| On Row Moved | 34 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Row Resize | 60 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On Scroll | 59 | Oui | Jamais | Objets concernés uniquement | +| On Selection Change | 31 | Oui | Oui | Objets concernés uniquement | +| On Timer | 27 | Jamais | Oui | Aucun | +| On Unload | 24 | Oui | Oui | Tous les objets | +| On URL Filtering | 51 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On URL Loading Error | 50 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On URL Resource Loading | 48 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Validate | 3 | Oui | Oui | Tous les objets | +| On VP Range Changed | 61 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On VP Ready | 9 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On Window Opening Denied | 53 | Oui (Zone Web) | Jamais | Objets concernés uniquement | Gardez toujours à l'esprit que, pour tout événement, la méthode d'un formulaire ou d'un objet est appelée si la propriété d'événement correspondante est sélectionnée pour le formulaire ou les objets. L'avantage de la désactivation des événements dans l'environnement de développement (à l'aide de la liste des propriétés de l'éditeur de formulaires) est la réduction du nombre d'appels vers des méthodes et par conséquent l'optimisation de la vitesse d'exécution de vos formulaires. > ATTENTION : Les événements [On Load](onLoad.md) et [On Unload](onUnload.md) sont générés pour les objets s'ils sont activés à la fois pour les objets et pour le formulaire auquel appartiennent les objets. Si les événements sont activés pour les objets uniquement, ils ne se produiront pas; ces deux événements doivent également être activés au niveau du formulaire. + diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md index d4ee3bf70015fe..a53136e95d81c3 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md @@ -48,68 +48,68 @@ Le nombre d'objets associés à un événement dépend de la nature de l'événe Le tableau suivant résume la manière dont les méthodes objet et formulaire sont appelées pour chaque type d'événement : -| Evénement | Méthode objet | Méthode formulaire | Objets | -| ------------------------ | ------------------------------------------------------------------ | ------------------ | --------------------------- | -| On Load | Oui | Oui | Tous les objets | -| On Unload | Oui | Oui | Tous les objets | -| On Validate | Oui | Oui | Tous les objets | -| On Clicked | Oui | Oui | Objets concernés uniquement | -| On Double Clicked | Oui | Oui | Objets concernés uniquement | -| On Before Keystroke | Oui | Oui | Objets concernés uniquement | -| On After Keystroke | Oui | Oui | Objets concernés uniquement | -| On After Edit | Oui | Oui | Objets concernés uniquement | -| On Getting Focus | Oui | Oui | Objets concernés uniquement | -| On Losing Focus | Oui | Oui | Objets concernés uniquement | -| On Activate | Jamais | Oui | Aucun | -| On Deactivate | Jamais | Oui | Aucun | -| On Outside Call | Jamais | Oui | Aucun | -| On Page Change | Jamais | Oui | Aucun | -| On Begin Drag Over | Oui | Oui | Objets concernés uniquement | -| On Drop | Oui | Oui | Objets concernés uniquement | -| On Drag Over | Oui | Jamais | Objets concernés uniquement | -| On Mouse Enter | Oui | Oui | Tous les objets | -| On Mouse Move | Oui | Oui | Tous les objets | -| On Mouse Leave | Oui | Oui | Tous les objets | -| On Mouse Up | Oui | Jamais | Objets concernés uniquement | -| On Menu Selected | Jamais | Oui | Aucun | -| On Bound variable change | Jamais | Oui | Aucun | -| On Data Change | Oui | Oui | Objets concernés uniquement | -| On Plug in Area | Oui | Oui | Objets concernés uniquement | -| On Header | Oui | Oui | Tous les objets | -| On Printing Detail | Oui | Oui | Tous les objets | -| On Printing Break | Oui | Oui | Tous les objets | -| On Printing Footer | Oui | Oui | Tous les objets | -| On Close Box | Jamais | Oui | Aucun | -| On Display Detail | Oui | Oui | Tous les objets | -| On Open Detail | Oui (List box) | Oui | Aucun, excepté les List box | -| On Close Detail | Oui (List box) | Oui | Aucun, excepté les List box | -| On Resize | Jamais | Oui | Aucun | -| On Selection Change | Oui | Oui | Objets concernés uniquement | -| On Load Record | Jamais | Oui | Aucun | -| On Timer | Jamais | Oui | Aucun | -| On Scroll | Oui | Jamais | Objets concernés uniquement | -| On Before Data Entry | Oui (List box) | Jamais | Objets concernés uniquement | -| On Column Moved | Oui (List box) | Jamais | Objets concernés uniquement | -| On Row Moved | Oui (List box) | Jamais | Objets concernés uniquement | -| On Column Resize | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | -| On Header Click | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | -| On Footer Click | Oui (List box) | Jamais | Objets concernés uniquement | -| On After Sort | Oui (List box) | Jamais | Objets concernés uniquement | -| On Long Click | Oui (Bouton) | Oui | Objets concernés uniquement | -| On Alternative Click | Oui (Bouton et List box) | Jamais | Objets concernés uniquement | -| On Expand | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On Collapse | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On Delete Action | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On URL Resource Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Begin URL Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On URL Loading Error | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On URL Filtering | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On End URL Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Open External Link | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Window Opening Denied | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On VP Range Changed | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | -| On VP Ready | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | -| On Row Resize | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| Evénement | Code | Méthode objet | Méthode formulaire | Objets | +| ------------------------ | ---- | ------------------------------------------------------------------ | ------------------ | --------------------------- | +| On Activate | 11 | Jamais | Oui | Aucun | +| On After Edit | 45 | Oui | Oui | Objets concernés uniquement | +| On After Keystroke | 28 | Oui | Oui | Objets concernés uniquement | +| On After Sort | 30 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Alternative Click | 38 | Oui (Bouton et List box) | Jamais | Objets concernés uniquement | +| On Before Data Entry | 41 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Before Keystroke | 17 | Oui | Oui | Objets concernés uniquement | +| On Begin Drag Over | 46 | Oui | Oui | Objets concernés uniquement | +| On Begin URL Loading | 47 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Bound variable change | 54 | Jamais | Oui | Aucun | +| On Clicked | 4 | Oui | Oui | Objets concernés uniquement | +| On Close Box | 22 | Jamais | Oui | Aucun | +| On Close Detail | 26 | Oui (List box) | Oui | Aucun, excepté les List box | +| On Collapse | 44 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Column Moved | 32 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Column Resize | 33 | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | +| On Data Change | 20 | Oui | Oui | Objets concernés uniquement | +| On Deactivate | 12 | Jamais | Oui | Aucun | +| On Delete Action | 58 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Display Detail | 8 | Oui | Oui | Tous les objets | +| On Double Clicked | 13 | Oui | Oui | Objets concernés uniquement | +| On Drag Over | 21 | Oui | Jamais | Objets concernés uniquement | +| On Drop | 16 | Oui | Oui | Objets concernés uniquement | +| On End URL Loading | 49 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Expand | 43 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Footer Click | 57 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Getting Focus | 15 | Oui | Oui | Objets concernés uniquement | +| On Header | 5 | Oui | Oui | Tous les objets | +| On Header Click | 42 | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | +| On Load | 1 | Oui | Oui | Tous les objets | +| On Load Record | 40 | Jamais | Oui | Aucun | +| On Long Click | 39 | Oui (Bouton) | Oui | Objets concernés uniquement | +| On Losing Focus | 14 | Oui | Oui | Objets concernés uniquement | +| On Menu Selected | 18 | Jamais | Oui | Aucun | +| On Mouse Enter | 35 | Oui | Oui | Tous les objets | +| On Mouse Leave | 36 | Oui | Oui | Tous les objets | +| On Mouse Move | 37 | Oui | Oui | Tous les objets | +| On Mouse Up | 2 | Oui | Jamais | Objets concernés uniquement | +| On Open Detail | 25 | Oui (List box) | Oui | Aucun, excepté les List box | +| On Open External Link | 52 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Outside Call | 10 | Jamais | Oui | Aucun | +| On Page Change | 56 | Jamais | Oui | Aucun | +| On Plug in Area | 19 | Oui | Oui | Objets concernés uniquement | +| On Printing Break | 6 | Oui | Oui | Tous les objets | +| On Printing Detail | 23 | Oui | Oui | Tous les objets | +| On Printing Footer | 7 | Oui | Oui | Tous les objets | +| On Resize | 29 | Jamais | Oui | Aucun | +| On Row Moved | 34 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Row Resize | 60 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On Scroll | 59 | Oui | Jamais | Objets concernés uniquement | +| On Selection Change | 31 | Oui | Oui | Objets concernés uniquement | +| On Timer | 27 | Jamais | Oui | Aucun | +| On Unload | 24 | Oui | Oui | Tous les objets | +| On URL Filtering | 51 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On URL Loading Error | 50 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On URL Resource Loading | 48 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Validate | 3 | Oui | Oui | Tous les objets | +| On VP Range Changed | 61 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On VP Ready | 9 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On Window Opening Denied | 53 | Oui (Zone Web) | Jamais | Objets concernés uniquement | Gardez toujours à l'esprit que, pour tout événement, la méthode d'un formulaire ou d'un objet est appelée si la propriété d'événement correspondante est sélectionnée pour le formulaire ou les objets. L'avantage de la désactivation des événements dans l'environnement de développement (à l'aide de la liste des propriétés de l'éditeur de formulaires) est la réduction du nombre d'appels vers des méthodes et par conséquent l'optimisation de la vitesse d'exécution de vos formulaires. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/folder.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/folder.md index 8ff6cd5b8cc711..d45ea55fc16bf8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/folder.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/folder.md @@ -77,10 +77,10 @@ Si la commande est appelée à partir d'un composant, passez le paramètre optio ## Voir également -[classe `4D.Folder`](../../API/FolderClass.md) -[File](../commands/file)\ -[Object to path](../../commands-legacy/object-to-path)\ -[Path to object](../../commands-legacy/path-to-object) +[classe `4D.Folder`](../../API/FolderClass.md) +[File](../commands/file) +[Object to path](../../commands-legacy/object-to-path) +[Path to object](../../commands-legacy/path-to-object) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md index 437e187c33af76..4446e9969fbff8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md @@ -49,13 +49,13 @@ Vous pouvez passer un objet 4D.File, 4D.Folder, ou une structure Zip en tant que | Propriété | Type | Description | | ----------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard` : Compression Deflate (par défaut)
  • `ZIP Compression LZMA` : Compression LZMA
  • `ZIP Compression XZ` : Compression XZ
  • `ZIP Compression none` : Pas de compression
    • | -| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Valeurs par défaut si omis :
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | Le cryptage à utiliser si un mot de passe est défini
  • :`ZIP Encryption AES128` : Cryptage AES avec une clé de 128 bits.
  • `ZIP Encryption AES192`: Cryptage AES avec une clé de 192 bits.
  • `ZIP Encryption AES256`: Cryptage AES à l'aide d'une clé de 256 bits (par défaut si un mot de passe est défini).
  • `ZIP Encryption none`: les données ne sont pas cryptées (par défaut si aucun mot de passe n'est défini)
    • | +| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Valeurs par défaut si omis : | +| encryption | Integer | Le cryptage à utiliser si un mot de passe est défini | | password | Text | Un mot de passe à définir si le chiffrement est requis. | -| Historique | Collection |
  • une collection d'objets `4D.File` ou `4D.Folder` ou
  • une collection d'objets avec les propriétés suivantes :
    • PropriétéTypeDescription
    source4D.File ou 4D.FolderFichier ou dossier
    destinationTexte(facultatif) - Spécifie un chemin relatif pour changer l'organisation du contenu de l'archive
    optionnombre(facultatif) - `ZIP Ignore invisible files` ou 0 pour compresser l'intégralité du fichier
    | +| files | Collection |
    PropriétéTypeDescription
    source4D.File ou 4D.FolderFichier ou dossier
    destinationTexte(facultatif) - Spécifie un chemin relatif pour changer l'organisation du contenu de l'archive
    optionnumérique(facultatif) - `ZIP Ignore invisible files` ou 0 pour compresser l'intégralité du fichier
    | | callback | 4D.Function | Une formule de rétro-appel qui recevra la progression de la compression (0 à 100) dans $1. | -Dans le paramètre *destinationFile*, passez un objet `4D.File` décrivant l'archive ZIP à créer (nom, emplacement, etc.). Il est conseillé d'utiliser l'extension ".zip" si vous souhaitez que l'archive ZIP soit traitée automatiquement par un logiciel. +Dans le paramètre *destinationFile*, passez un objet `4D.File` décrivant l'archive ZIP à créer (nom, emplacement, etc.). Il est conseillé d'utiliser l'extension ".zip" si vous souhaitez que l'archive ZIP soit traitée automatiquement par n'importe quel logiciel. Une fois que l'archive est créée, vous pouvez utiliser la commande [ZIP Read archive](../commands/zip-read-archive) pour y accéder. @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## Voir également -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md index 70f90d1885755c..4c036b9f1e6819 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ Pour extraire à partir du dossier root : ## Voir également -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/Process (Communications)/call-worker.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/Process (Communications)/call-worker.md index 49d12a87fdf145..417fedc1b54228 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/Process (Communications)/call-worker.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R3/language-legacy/Process (Communications)/call-worker.md @@ -65,23 +65,23 @@ Dans un formulaire, un bouton démarre un calcul, par exemple des statistiques p Voici la méthode du bouton : ```4d -  //appelle le process worker vNomWorker avec le paramètre - var $vAnn: éeInteger - $vAnnée:=2015 //peut être sélectionné par l’utilisateur dans le formulaire - CALL WORKER("monWorker";Formula(workerMethod);vAnnée;Current form window) +  //appelle le worker monWorker avec le paramètre + var $vAnnée : Integer + $vAnnée:=2015 //peut avoir été sélectionné par l’utilisateur dans le formulaire + CALL WORKER("monWorker";Formula(workerMethod);$vAnnée;Current form window) ``` -Voici le code de *méthodeWorker* : +Voici le code de *workerMethod* : ```4d   //voici la méthode du worker   //peut être préemptif ou coopératif  #DECLARE($vAnnéeInteger;$fenetreInteger) //référence de l'année et de la fenêtre - var $vR: ésultatStatistiquesObject //stockage de résultats statistiques + var $vRésultatStatistiques : Object //stockage de résultats statistiques  ... //calcul des statistiques   //une fois le calcul terminé, rappel du formulaire avec les valeurs calculées   //$vRésultatStatistiques peut afficher les résultats dans le formulaire - CALL FORM($fenetre;Formula(affichageStats);vRésultatStatistiques) + CALL FORM($fenetre;Formula(affichageStats);$vRésultatStatistiques) ``` ## Voir aussi diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md index d4ee3bf70015fe..a53136e95d81c3 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md @@ -48,68 +48,68 @@ Le nombre d'objets associés à un événement dépend de la nature de l'événe Le tableau suivant résume la manière dont les méthodes objet et formulaire sont appelées pour chaque type d'événement : -| Evénement | Méthode objet | Méthode formulaire | Objets | -| ------------------------ | ------------------------------------------------------------------ | ------------------ | --------------------------- | -| On Load | Oui | Oui | Tous les objets | -| On Unload | Oui | Oui | Tous les objets | -| On Validate | Oui | Oui | Tous les objets | -| On Clicked | Oui | Oui | Objets concernés uniquement | -| On Double Clicked | Oui | Oui | Objets concernés uniquement | -| On Before Keystroke | Oui | Oui | Objets concernés uniquement | -| On After Keystroke | Oui | Oui | Objets concernés uniquement | -| On After Edit | Oui | Oui | Objets concernés uniquement | -| On Getting Focus | Oui | Oui | Objets concernés uniquement | -| On Losing Focus | Oui | Oui | Objets concernés uniquement | -| On Activate | Jamais | Oui | Aucun | -| On Deactivate | Jamais | Oui | Aucun | -| On Outside Call | Jamais | Oui | Aucun | -| On Page Change | Jamais | Oui | Aucun | -| On Begin Drag Over | Oui | Oui | Objets concernés uniquement | -| On Drop | Oui | Oui | Objets concernés uniquement | -| On Drag Over | Oui | Jamais | Objets concernés uniquement | -| On Mouse Enter | Oui | Oui | Tous les objets | -| On Mouse Move | Oui | Oui | Tous les objets | -| On Mouse Leave | Oui | Oui | Tous les objets | -| On Mouse Up | Oui | Jamais | Objets concernés uniquement | -| On Menu Selected | Jamais | Oui | Aucun | -| On Bound variable change | Jamais | Oui | Aucun | -| On Data Change | Oui | Oui | Objets concernés uniquement | -| On Plug in Area | Oui | Oui | Objets concernés uniquement | -| On Header | Oui | Oui | Tous les objets | -| On Printing Detail | Oui | Oui | Tous les objets | -| On Printing Break | Oui | Oui | Tous les objets | -| On Printing Footer | Oui | Oui | Tous les objets | -| On Close Box | Jamais | Oui | Aucun | -| On Display Detail | Oui | Oui | Tous les objets | -| On Open Detail | Oui (List box) | Oui | Aucun, excepté les List box | -| On Close Detail | Oui (List box) | Oui | Aucun, excepté les List box | -| On Resize | Jamais | Oui | Aucun | -| On Selection Change | Oui | Oui | Objets concernés uniquement | -| On Load Record | Jamais | Oui | Aucun | -| On Timer | Jamais | Oui | Aucun | -| On Scroll | Oui | Jamais | Objets concernés uniquement | -| On Before Data Entry | Oui (List box) | Jamais | Objets concernés uniquement | -| On Column Moved | Oui (List box) | Jamais | Objets concernés uniquement | -| On Row Moved | Oui (List box) | Jamais | Objets concernés uniquement | -| On Column Resize | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | -| On Header Click | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | -| On Footer Click | Oui (List box) | Jamais | Objets concernés uniquement | -| On After Sort | Oui (List box) | Jamais | Objets concernés uniquement | -| On Long Click | Oui (Bouton) | Oui | Objets concernés uniquement | -| On Alternative Click | Oui (Bouton et List box) | Jamais | Objets concernés uniquement | -| On Expand | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On Collapse | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On Delete Action | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On URL Resource Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Begin URL Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On URL Loading Error | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On URL Filtering | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On End URL Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Open External Link | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Window Opening Denied | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On VP Range Changed | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | -| On VP Ready | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | -| On Row Resize | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| Evénement | Code | Méthode objet | Méthode formulaire | Objets | +| ------------------------ | ---- | ------------------------------------------------------------------ | ------------------ | --------------------------- | +| On Activate | 11 | Jamais | Oui | Aucun | +| On After Edit | 45 | Oui | Oui | Objets concernés uniquement | +| On After Keystroke | 28 | Oui | Oui | Objets concernés uniquement | +| On After Sort | 30 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Alternative Click | 38 | Oui (Bouton et List box) | Jamais | Objets concernés uniquement | +| On Before Data Entry | 41 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Before Keystroke | 17 | Oui | Oui | Objets concernés uniquement | +| On Begin Drag Over | 46 | Oui | Oui | Objets concernés uniquement | +| On Begin URL Loading | 47 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Bound variable change | 54 | Jamais | Oui | Aucun | +| On Clicked | 4 | Oui | Oui | Objets concernés uniquement | +| On Close Box | 22 | Jamais | Oui | Aucun | +| On Close Detail | 26 | Oui (List box) | Oui | Aucun, excepté les List box | +| On Collapse | 44 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Column Moved | 32 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Column Resize | 33 | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | +| On Data Change | 20 | Oui | Oui | Objets concernés uniquement | +| On Deactivate | 12 | Jamais | Oui | Aucun | +| On Delete Action | 58 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Display Detail | 8 | Oui | Oui | Tous les objets | +| On Double Clicked | 13 | Oui | Oui | Objets concernés uniquement | +| On Drag Over | 21 | Oui | Jamais | Objets concernés uniquement | +| On Drop | 16 | Oui | Oui | Objets concernés uniquement | +| On End URL Loading | 49 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Expand | 43 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Footer Click | 57 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Getting Focus | 15 | Oui | Oui | Objets concernés uniquement | +| On Header | 5 | Oui | Oui | Tous les objets | +| On Header Click | 42 | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | +| On Load | 1 | Oui | Oui | Tous les objets | +| On Load Record | 40 | Jamais | Oui | Aucun | +| On Long Click | 39 | Oui (Bouton) | Oui | Objets concernés uniquement | +| On Losing Focus | 14 | Oui | Oui | Objets concernés uniquement | +| On Menu Selected | 18 | Jamais | Oui | Aucun | +| On Mouse Enter | 35 | Oui | Oui | Tous les objets | +| On Mouse Leave | 36 | Oui | Oui | Tous les objets | +| On Mouse Move | 37 | Oui | Oui | Tous les objets | +| On Mouse Up | 2 | Oui | Jamais | Objets concernés uniquement | +| On Open Detail | 25 | Oui (List box) | Oui | Aucun, excepté les List box | +| On Open External Link | 52 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Outside Call | 10 | Jamais | Oui | Aucun | +| On Page Change | 56 | Jamais | Oui | Aucun | +| On Plug in Area | 19 | Oui | Oui | Objets concernés uniquement | +| On Printing Break | 6 | Oui | Oui | Tous les objets | +| On Printing Detail | 23 | Oui | Oui | Tous les objets | +| On Printing Footer | 7 | Oui | Oui | Tous les objets | +| On Resize | 29 | Jamais | Oui | Aucun | +| On Row Moved | 34 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Row Resize | 60 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On Scroll | 59 | Oui | Jamais | Objets concernés uniquement | +| On Selection Change | 31 | Oui | Oui | Objets concernés uniquement | +| On Timer | 27 | Jamais | Oui | Aucun | +| On Unload | 24 | Oui | Oui | Tous les objets | +| On URL Filtering | 51 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On URL Loading Error | 50 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On URL Resource Loading | 48 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Validate | 3 | Oui | Oui | Tous les objets | +| On VP Range Changed | 61 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On VP Ready | 9 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On Window Opening Denied | 53 | Oui (Zone Web) | Jamais | Objets concernés uniquement | Gardez toujours à l'esprit que, pour tout événement, la méthode d'un formulaire ou d'un objet est appelée si la propriété d'événement correspondante est sélectionnée pour le formulaire ou les objets. L'avantage de la désactivation des événements dans l'environnement de développement (à l'aide de la liste des propriétés de l'éditeur de formulaires) est la réduction du nombre d'appels vers des méthodes et par conséquent l'optimisation de la vitesse d'exécution de vos formulaires. diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/folder.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/folder.md index 8ff6cd5b8cc711..d45ea55fc16bf8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/folder.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/folder.md @@ -77,10 +77,10 @@ Si la commande est appelée à partir d'un composant, passez le paramètre optio ## Voir également -[classe `4D.Folder`](../../API/FolderClass.md) -[File](../commands/file)\ -[Object to path](../../commands-legacy/object-to-path)\ -[Path to object](../../commands-legacy/path-to-object) +[classe `4D.Folder`](../../API/FolderClass.md) +[File](../commands/file) +[Object to path](../../commands-legacy/object-to-path) +[Path to object](../../commands-legacy/path-to-object) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md index 437e187c33af76..4446e9969fbff8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md @@ -49,13 +49,13 @@ Vous pouvez passer un objet 4D.File, 4D.Folder, ou une structure Zip en tant que | Propriété | Type | Description | | ----------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard` : Compression Deflate (par défaut)
  • `ZIP Compression LZMA` : Compression LZMA
  • `ZIP Compression XZ` : Compression XZ
  • `ZIP Compression none` : Pas de compression
    • | -| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Valeurs par défaut si omis :
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | Le cryptage à utiliser si un mot de passe est défini
  • :`ZIP Encryption AES128` : Cryptage AES avec une clé de 128 bits.
  • `ZIP Encryption AES192`: Cryptage AES avec une clé de 192 bits.
  • `ZIP Encryption AES256`: Cryptage AES à l'aide d'une clé de 256 bits (par défaut si un mot de passe est défini).
  • `ZIP Encryption none`: les données ne sont pas cryptées (par défaut si aucun mot de passe n'est défini)
    • | +| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Valeurs par défaut si omis : | +| encryption | Integer | Le cryptage à utiliser si un mot de passe est défini | | password | Text | Un mot de passe à définir si le chiffrement est requis. | -| Historique | Collection |
  • une collection d'objets `4D.File` ou `4D.Folder` ou
  • une collection d'objets avec les propriétés suivantes :
    • PropriétéTypeDescription
    source4D.File ou 4D.FolderFichier ou dossier
    destinationTexte(facultatif) - Spécifie un chemin relatif pour changer l'organisation du contenu de l'archive
    optionnombre(facultatif) - `ZIP Ignore invisible files` ou 0 pour compresser l'intégralité du fichier
    | +| files | Collection |
    PropriétéTypeDescription
    source4D.File ou 4D.FolderFichier ou dossier
    destinationTexte(facultatif) - Spécifie un chemin relatif pour changer l'organisation du contenu de l'archive
    optionnumérique(facultatif) - `ZIP Ignore invisible files` ou 0 pour compresser l'intégralité du fichier
    | | callback | 4D.Function | Une formule de rétro-appel qui recevra la progression de la compression (0 à 100) dans $1. | -Dans le paramètre *destinationFile*, passez un objet `4D.File` décrivant l'archive ZIP à créer (nom, emplacement, etc.). Il est conseillé d'utiliser l'extension ".zip" si vous souhaitez que l'archive ZIP soit traitée automatiquement par un logiciel. +Dans le paramètre *destinationFile*, passez un objet `4D.File` décrivant l'archive ZIP à créer (nom, emplacement, etc.). Il est conseillé d'utiliser l'extension ".zip" si vous souhaitez que l'archive ZIP soit traitée automatiquement par n'importe quel logiciel. Une fois que l'archive est créée, vous pouvez utiliser la commande [ZIP Read archive](../commands/zip-read-archive) pour y accéder. @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## Voir également -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md index 70f90d1885755c..4c036b9f1e6819 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ Pour extraire à partir du dossier root : ## Voir également -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## Propriétés diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/Process (Communications)/call-worker.md b/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/Process (Communications)/call-worker.md index bb569a28b8e2bb..590ef0dea51957 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/Process (Communications)/call-worker.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21-R4/language-legacy/Process (Communications)/call-worker.md @@ -65,23 +65,23 @@ Dans un formulaire, un bouton démarre un calcul, par exemple des statistiques p Voici la méthode du bouton : ```4d -  //appelle le process worker vNomWorker avec le paramètre - var $vAnn: éeInteger - $vAnnée:=2015 //peut être sélectionné par l’utilisateur dans le formulaire - CALL WORKER("monWorker";Formula(workerMethod);vAnnée;Current form window) +  //appelle le worker monWorker avec le paramètre + var $vAnnée : Integer + $vAnnée:=2015 //peut avoir été sélectionné par l’utilisateur dans le formulaire + CALL WORKER("monWorker";Formula(workerMethod);$vAnnée;Current form window) ``` -Voici le code de *méthodeWorker* : +Voici le code de *workerMethod* : ```4d   //voici la méthode du worker   //peut être préemptif ou coopératif  #DECLARE($vAnnéeInteger;$fenetreInteger) //référence de l'année et de la fenêtre - var $vR: ésultatStatistiquesObject //stockage de résultats statistiques + var $vRésultatStatistiques : Object //stockage de résultats statistiques  ... //calcul des statistiques   //une fois le calcul terminé, rappel du formulaire avec les valeurs calculées   //$vRésultatStatistiques peut afficher les résultats dans le formulaire - CALL FORM($fenetre;Formula(affichageStats);vRésultatStatistiques) + CALL FORM($fenetre;Formula(affichageStats);$vRésultatStatistiques) ``` ## Voir aussi diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/Events/overview.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/Events/overview.md index 43d244be457b0c..a53136e95d81c3 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/Events/overview.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/Events/overview.md @@ -5,7 +5,7 @@ title: Evénements formulaire Les événements formulaire sont des événements qui peuvent conduire à l'exécution de la méthode de formulaire et/ou de la ou des méthodes objet de formulaire. Les événements de formulaire vous permettent de contrôler le flux de votre application et d'écrire du code qui n'est exécuté que lorsqu'un événement spécifique se produit. -Dans votre code, vous contrôlez les événements à l'aide de la commande [`FORM Event`](../commands/form-event.md), qui renvoie l'événement déclenché. Par exemple : +Dans votre code, vous contrôlez les événements à l'aide de la commande [`FORM Event`](../commands/form-event), qui renvoie l'événement déclenché. Par exemple : ```4d //code d'un bouton @@ -18,7 +18,7 @@ End if ## Objet événement -Chaque événement est renvoyé sous forme d'objet par la commande [`FORM Event`](../commands/form-event.md). Par défaut, il contient les propriétés suivantes : +Chaque événement est renvoyé sous forme d'objet par la commande [`FORM Event`](../commands/form-event). Par défaut, il contient les propriétés suivantes : | Propriété | Type | Description | | ----------- | ----------- | ---------------------------------------------------------------------------------------------------------------- | @@ -48,70 +48,71 @@ Le nombre d'objets associés à un événement dépend de la nature de l'événe Le tableau suivant résume la manière dont les méthodes objet et formulaire sont appelées pour chaque type d'événement : -| Evénement | Méthode objet | Méthode formulaire | Objets | -| ------------------------ | ------------------------------------------------------------------ | ------------------ | --------------------------- | -| On Load | Oui | Oui | Tous les objets | -| On Unload | Oui | Oui | Tous les objets | -| On Validate | Oui | Oui | Tous les objets | -| On Clicked | Oui | Oui | Objets concernés uniquement | -| On Double Clicked | Oui | Oui | Objets concernés uniquement | -| On Before Keystroke | Oui | Oui | Objets concernés uniquement | -| On After Keystroke | Oui | Oui | Objets concernés uniquement | -| On After Edit | Oui | Oui | Objets concernés uniquement | -| On Getting Focus | Oui | Oui | Objets concernés uniquement | -| On Losing Focus | Oui | Oui | Objets concernés uniquement | -| On Activate | Jamais | Oui | Aucun | -| On Deactivate | Jamais | Oui | Aucun | -| On Outside Call | Jamais | Oui | Aucun | -| On Page Change | Jamais | Oui | Aucun | -| On Begin Drag Over | Oui | Oui | Objets concernés uniquement | -| On Drop | Oui | Oui | Objets concernés uniquement | -| On Drag Over | Oui | Jamais | Objets concernés uniquement | -| On Mouse Enter | Oui | Oui | Tous les objets | -| On Mouse Move | Oui | Oui | Tous les objets | -| On Mouse Leave | Oui | Oui | Tous les objets | -| On Mouse Up | Oui | Jamais | Objets concernés uniquement | -| On Menu Selected | Jamais | Oui | Aucun | -| On Bound variable change | Jamais | Oui | Aucun | -| On Data Change | Oui | Oui | Objets concernés uniquement | -| On Plug in Area | Oui | Oui | Objets concernés uniquement | -| On Header | Oui | Oui | Tous les objets | -| On Printing Detail | Oui | Oui | Tous les objets | -| On Printing Break | Oui | Oui | Tous les objets | -| On Printing Footer | Oui | Oui | Tous les objets | -| On Close Box | Jamais | Oui | Aucun | -| On Display Detail | Oui | Oui | Tous les objets | -| On Open Detail | Oui (List box) | Oui | Aucun, excepté les List box | -| On Close Detail | Oui (List box) | Oui | Aucun, excepté les List box | -| On Resize | Jamais | Oui | Aucun | -| On Selection Change | Oui | Oui | Objets concernés uniquement | -| On Load Record | Jamais | Oui | Aucun | -| On Timer | Jamais | Oui | Aucun | -| On Scroll | Oui | Jamais | Objets concernés uniquement | -| On Before Data Entry | Oui (List box) | Jamais | Objets concernés uniquement | -| On Column Moved | Oui (List box) | Jamais | Objets concernés uniquement | -| On Row Moved | Oui (List box) | Jamais | Objets concernés uniquement | -| On Column Resize | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | -| On Header Click | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | -| On Footer Click | Oui (List box) | Jamais | Objets concernés uniquement | -| On After Sort | Oui (List box) | Jamais | Objets concernés uniquement | -| On Long Click | Oui (Bouton) | Oui | Objets concernés uniquement | -| On Alternative Click | Oui (Bouton et List box) | Jamais | Objets concernés uniquement | -| On Expand | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On Collapse | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On Delete Action | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | -| On URL Resource Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Begin URL Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On URL Loading Error | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On URL Filtering | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On End URL Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Open External Link | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On Window Opening Denied | Oui (Zone Web) | Jamais | Objets concernés uniquement | -| On VP Range Changed | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | -| On VP Ready | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | -| On Row Resize | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| Evénement | Code | Méthode objet | Méthode formulaire | Objets | +| ------------------------ | ---- | ------------------------------------------------------------------ | ------------------ | --------------------------- | +| On Activate | 11 | Jamais | Oui | Aucun | +| On After Edit | 45 | Oui | Oui | Objets concernés uniquement | +| On After Keystroke | 28 | Oui | Oui | Objets concernés uniquement | +| On After Sort | 30 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Alternative Click | 38 | Oui (Bouton et List box) | Jamais | Objets concernés uniquement | +| On Before Data Entry | 41 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Before Keystroke | 17 | Oui | Oui | Objets concernés uniquement | +| On Begin Drag Over | 46 | Oui | Oui | Objets concernés uniquement | +| On Begin URL Loading | 47 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Bound variable change | 54 | Jamais | Oui | Aucun | +| On Clicked | 4 | Oui | Oui | Objets concernés uniquement | +| On Close Box | 22 | Jamais | Oui | Aucun | +| On Close Detail | 26 | Oui (List box) | Oui | Aucun, excepté les List box | +| On Collapse | 44 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Column Moved | 32 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Column Resize | 33 | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | +| On Data Change | 20 | Oui | Oui | Objets concernés uniquement | +| On Deactivate | 12 | Jamais | Oui | Aucun | +| On Delete Action | 58 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Display Detail | 8 | Oui | Oui | Tous les objets | +| On Double Clicked | 13 | Oui | Oui | Objets concernés uniquement | +| On Drag Over | 21 | Oui | Jamais | Objets concernés uniquement | +| On Drop | 16 | Oui | Oui | Objets concernés uniquement | +| On End URL Loading | 49 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Expand | 43 | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| On Footer Click | 57 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Getting Focus | 15 | Oui | Oui | Objets concernés uniquement | +| On Header | 5 | Oui | Oui | Tous les objets | +| On Header Click | 42 | Oui (List box et Zone 4D View Pro) | Jamais | Objets concernés uniquement | +| On Load | 1 | Oui | Oui | Tous les objets | +| On Load Record | 40 | Jamais | Oui | Aucun | +| On Long Click | 39 | Oui (Bouton) | Oui | Objets concernés uniquement | +| On Losing Focus | 14 | Oui | Oui | Objets concernés uniquement | +| On Menu Selected | 18 | Jamais | Oui | Aucun | +| On Mouse Enter | 35 | Oui | Oui | Tous les objets | +| On Mouse Leave | 36 | Oui | Oui | Tous les objets | +| On Mouse Move | 37 | Oui | Oui | Tous les objets | +| On Mouse Up | 2 | Oui | Jamais | Objets concernés uniquement | +| On Open Detail | 25 | Oui (List box) | Oui | Aucun, excepté les List box | +| On Open External Link | 52 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Outside Call | 10 | Jamais | Oui | Aucun | +| On Page Change | 56 | Jamais | Oui | Aucun | +| On Plug in Area | 19 | Oui | Oui | Objets concernés uniquement | +| On Printing Break | 6 | Oui | Oui | Tous les objets | +| On Printing Detail | 23 | Oui | Oui | Tous les objets | +| On Printing Footer | 7 | Oui | Oui | Tous les objets | +| On Resize | 29 | Jamais | Oui | Aucun | +| On Row Moved | 34 | Oui (List box) | Jamais | Objets concernés uniquement | +| On Row Resize | 60 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On Scroll | 59 | Oui | Jamais | Objets concernés uniquement | +| On Selection Change | 31 | Oui | Oui | Objets concernés uniquement | +| On Timer | 27 | Jamais | Oui | Aucun | +| On Unload | 24 | Oui | Oui | Tous les objets | +| On URL Filtering | 51 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On URL Loading Error | 50 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On URL Resource Loading | 48 | Oui (Zone Web) | Jamais | Objets concernés uniquement | +| On Validate | 3 | Oui | Oui | Tous les objets | +| On VP Range Changed | 61 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On VP Ready | 9 | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | +| On Window Opening Denied | 53 | Oui (Zone Web) | Jamais | Objets concernés uniquement | Gardez toujours à l'esprit que, pour tout événement, la méthode d'un formulaire ou d'un objet est appelée si la propriété d'événement correspondante est sélectionnée pour le formulaire ou les objets. L'avantage de la désactivation des événements dans l'environnement de développement (à l'aide de la liste des propriétés de l'éditeur de formulaires) est la réduction du nombre d'appels vers des méthodes et par conséquent l'optimisation de la vitesse d'exécution de vos formulaires. > ATTENTION : Les événements [On Load](onLoad.md) et [On Unload](onUnload.md) sont générés pour les objets s'ils sont activés à la fois pour les objets et pour le formulaire auquel appartiennent les objets. Si les événements sont activés pour les objets uniquement, ils ne se produiront pas; ces deux événements doivent également être activés au niveau du formulaire. + diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/commands-legacy/call-worker.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/commands-legacy/call-worker.md index 80028bd7ee8e7a..13096015ad4dd2 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/commands-legacy/call-worker.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/commands-legacy/call-worker.md @@ -65,23 +65,23 @@ Dans un formulaire, un bouton démarre un calcul, par exemple des statistiques p Voici la méthode du bouton : ```4d -  //appelle le process worker vNomWorker avec le paramètre - var $vAnn: éeInteger - $vAnnée:=2015 //peut être sélectionné par l’utilisateur dans le formulaire - CALL WORKER("monWorker";Formula(workerMethod);vAnnée;Current form window) +  //appelle le worker monWorker avec le paramètre + var $vAnnée : Integer + $vAnnée:=2015 //peut avoir été sélectionné par l’utilisateur dans le formulaire + CALL WORKER("monWorker";Formula(workerMethod);$vAnnée;Current form window) ``` -Voici le code de *méthodeWorker* : +Voici le code de *workerMethod* : ```4d   //voici la méthode du worker   //peut être préemptif ou coopératif  #DECLARE($vAnnéeInteger;$fenetreInteger) //référence de l'année et de la fenêtre - var $vR: ésultatStatistiquesObject //stockage de résultats statistiques + var $vRésultatStatistiques : Object //stockage de résultats statistiques  ... //calcul des statistiques   //une fois le calcul terminé, rappel du formulaire avec les valeurs calculées   //$vRésultatStatistiques peut afficher les résultats dans le formulaire - CALL FORM($fenetre;Formula(affichageStats);vRésultatStatistiques) + CALL FORM($fenetre;Formula(affichageStats);$vRésultatStatistiques) ``` ## Voir aussi diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md b/i18n/fr/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md index c640734d60a9fe..5093dab76b92a3 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md @@ -45,14 +45,14 @@ Vous pouvez passer un objet 4D.File, 4D.Folder, ou une structure Zip en tant que - *zipStructure* : passez un objet décrivant l'objet ZIP archive. Les propriétés suivantes sont disponibles pour définir la structure : -| Propriété | Type | Description | -| ----------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| compression | Integer |
  • `ZIP Compression standard` : Compression Deflate (par défaut)
  • `ZIP Compression LZMA` : Compression LZMA
  • `ZIP Compression XZ` : Compression XZ
  • `ZIP Compression none` : Pas de compression
    • | -| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Valeurs par défaut si omis :
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | Le cryptage à utiliser si un mot de passe est défini
  • :`ZIP Encryption AES128` : Cryptage AES avec une clé de 128 bits.
  • `ZIP Encryption AES192`: Cryptage AES avec une clé de 192 bits.
  • `ZIP Encryption AES256`: Cryptage AES à l'aide d'une clé de 256 bits (par défaut si un mot de passe est défini).
  • `ZIP Encryption none`: les données ne sont pas cryptées (par défaut si aucun mot de passe n'est défini)
    • | -| password | Text | Un mot de passe à définir si le chiffrement est requis. | -| Historique | Collection |
  • une collection d'objets `4D.File` ou `4D.Folder` ou
  • une collection d'objets avec les propriétés suivantes :
    • PropriétéTypeDescription
    source4D.File ou 4D.FolderFichier ou dossier
    destinationTexte(facultatif) - Spécifie un chemin relatif pour changer l'organisation du contenu de l'archive
    optionnombre(facultatif) - `ZIP Ignore invisible files` ou 0 pour compresser l'intégralité du fichier
    | -| callback | 4D.Function | Une formule de rétro-appel qui recevra la progression de la compression (0 à 100) dans $1. | +| Propriété | Type | Description | +| ----------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| compression | Integer |
  • `ZIP Compression standard` : Compression Deflate (par défaut)
  • `ZIP Compression LZMA` : Compression LZMA
  • `ZIP Compression XZ` : Compression XZ
  • `ZIP Compression none` : Pas de compression
    • | +| level | Integer | Niveau de compression. Valeurs possibles : 1 à 10. Une valeur plus faible produira un fichier plus volumineux, tandis qu'une valeur plus élevée produira un fichier plus petit. Le niveau de compression a toutefois un impact sur les performances. Default values if omitted: | +| encryption | Integer | The encryption to use if a password is set: | +| password | Text | Un mot de passe à définir si le chiffrement est requis. | +| Historique | Collection |
  • une collection d'objets `4D.File` ou `4D.Folder` ou
  • une collection d'objets avec les propriétés suivantes :
    • PropriétéTypeDescription
    source4D.File ou 4D.FolderFichier ou dossier
    destinationTexte(facultatif) - Spécifie un chemin relatif pour changer l'organisation du contenu de l'archive
    optionnombre(facultatif) - `ZIP Ignore invisible files` ou 0 pour compresser l'intégralité du fichier
    | +| callback | 4D.Function | Une formule de rétro-appel qui recevra la progression de la compression (0 à 100) dans $1. | Dans le paramètre *destinationFile*, passez un objet `4D.File` décrivant l'archive ZIP à créer (nom, emplacement, etc.). Il est conseillé d'utiliser l'extension ".zip" si vous souhaitez que l'archive ZIP soit traitée automatiquement par un logiciel. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Admin/data-collect.md b/i18n/ja/docusaurus-plugin-content-docs/current/Admin/data-collect.md index 09b0dcd4a17e4c..138d67d5c9de1a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Admin/data-collect.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Admin/data-collect.md @@ -3,7 +3,7 @@ id: data-collect title: データ収集 --- -4D製品を改善し続けるために、実行中の 4D Server アプリケーションの使用状況データを自動的に収集します。 収集されたデータは、ユーザーエクスペリエンスに影響を与えない形で送信されます。 個人データは収集されません。 個人データ保護に関する4D ポリシーの詳細については、[こちらのページ](https://us.4d.com/privacy-policy)を参照してください。 +4D製品を改善し続けるために、実行中の 4D Server アプリケーションの使用状況データを自動的に収集します。収集されたデータは、ユーザーエクスペリエンスに影響を与えない形で送信されます。個人データは収集されません。個人データ保護に関する4D ポリシーの詳細については、[こちらのページ](https://us.4d.com/privacy-policy)を参照してください。 以下の章では次のようなことを説明しています: @@ -37,10 +37,12 @@ title: データ収集 | cacheReadCount | Object | キャッシュの読み出し回数 | | classUsage | Object | 特定の言語クラスのインスタンス数 | | connectionSystems | Collection | ビルド番号 (括弧内) なしのクライアントOSと、それを使用しているクライアント数 | +| databases[].backupSettings | Object | カレントのバックアップ設定値 | | databases[].cacheSize | Number | キャッシュのサイズ (バイト単位) | | databases[].compatibilitySettings | Object | 有効化された互換性設定 | | databases[].externalDatastoreOpened | Number | `Open datastore` への呼び出し回数 | | databases[].fluentUI | Boolean | Windows上でFluent UIを使用 設定がチェックされている場合にはTrue | +| databases[].flushCacheInterval | Number | データキャッシュの各自動保存間の時間として定義された時間間隔 | | databases[].id | Number | データベースID | | databases[].internalDatastoreOpened | Number | 外部サーバーによってデータストアが開かれた回数 | | databases[].maxConcurrent4DClients | Number | 回収期間の中での、(4D クライアントライセンスを使用した)同時4Dクライアントセッションの最大数 | @@ -52,6 +54,7 @@ title: データ収集 | databases[].numberOfKeepRecordSyncInfo | Number | "複製を許可"オプションがチェックされているテーブルの数 | | databases[].numberOfRecordsMax | Number | レコードの総数 | | databases[].numberOfTables | Number | テーブルの総数 | +| databases[].numberOfUncaughtExecutionErrors | Number | 実行エラーがアラートとして表示された回数 | | databases[].qodly.webforms | Number | Qodly Webフォームの数 | | databases[].remoteDebugger4DRemoteAttachments | Number | リモート4D から有効化されているリモートデバッガーの数 | | databases[].remoteDebuggerQodlyAttachments | Number | Qodly から有効化されているリモートデバッガーの数 | @@ -92,6 +95,7 @@ title: データ収集 | isEncrypted | Boolean | データファイルが暗号化されていれば true | | isEngined | Boolean | アプリケーションに 4D Volume Desktop が組み込まれている場合は true | | isProjectMode | Boolean | アプリケーションがプロジェクトの場合は true | +| isShadowCopyActivated | Boolean | ボリュームシャドウコピー機能が有効化されていればTrue (Windows のみ)。 | | LDAPLogin | Number | `LDAP LOGIN` の呼び出し回数 | | license.sffPrimaryKey | Number | サーバーのマスタープロダクト番号 | | machine.CPU | Text | プロセッサーの名前、種類、および速度 | @@ -102,6 +106,7 @@ title: データ収集 | maximumUsedPhysicalMemory | Number | 最大使用した物理メモリ | | maximumUsedVirtualMemory | Number | 最大使用した仮想メモリ | | mobile | Collection | モバイルセッションに関する情報 | +| numberOfCrashes | Number | 4D がクラッシュした回数 | | numberOfWebServices | Number | Webサービスとして公開されているメソッドの数 | | ODBCLogin | Number | ODBC を使用しての `SQL LOGIN`への呼出回数 | | phpCall | Number | `PHP execute` の呼び出し回数 | @@ -140,12 +145,12 @@ title: データ収集 ## 保存先と送信先 -収集されたデータは、4D Server の起動やシャットダウンなどの特定のイベントが発生した際に、データベースごとにテキストファイル(JSON 形式)に書き込まれます。 このファイルは[active 4D folder](../commands/get-4d-folder) 内、つまり以下の場所に保存されます: +収集されたデータは、4D Server の起動やシャットダウンなどの特定のイベントが発生した際に、データベースごとにテキストファイル(JSON 形式)に書き込まれます。このファイルは[active 4D folder](../commands/get-4d-folder) 内、つまり以下の場所に保存されます: - Windows: `Users\[userName]\AppData\Roaming\4D Server` - macOS: `/Users/[userName]/Library/ApplicationSupport/4D Server` -週に一度、ファイルはネットワーク経由で自動的に 4D に送信されます。 その後、ファイルは Active 4D Folder から削除されます。 +週に一度、ファイルはネットワーク経由で自動的に 4D に送信されます。その後、ファイルは Active 4D Folder から削除されます。 ![](../assets/en/Admin/data-collect.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Events/overview.md b/i18n/ja/docusaurus-plugin-content-docs/current/Events/overview.md index deaf17bc306ed8..b2f2cc3162d960 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Events/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Events/overview.md @@ -3,9 +3,9 @@ id: overview title: フォームイベント --- -フォームイベントとは、フォームメソッドやフォームオブジェクトメソッドの実行につながるイベントのことです。 フォームイベントにより、アプリケーションの流れをコントロールしたり、特定のイベントが発生したときにのみ実行されるコードを書くことができます。 +フォームイベントとは、フォームメソッドやフォームオブジェクトメソッドの実行につながるイベントのことです。フォームイベントにより、アプリケーションの流れをコントロールしたり、特定のイベントが発生したときにのみ実行されるコードを書くことができます。 -コードの中では、トリガーされたイベントを返す [`FORM Event`](../commands/form-event) コマンドを使ってイベントを制御します。 例: +コードの中では、トリガーされたイベントを返す [`FORM Event`](../commands/form-event) コマンドを使ってイベントを制御します。例: ```4d // ボタンのコード @@ -18,15 +18,15 @@ End if ## イベントオブジェクト -それぞれのイベントは、[`FORM Event`](../commands/form-event) コマンドによってオブジェクトとして返されます。 デフォルトで、以下のプロパティが含まれています: +それぞれのイベントは、[`FORM Event`](../commands/form-event) コマンドによってオブジェクトとして返されます。デフォルトで、以下のプロパティが含まれています: | プロパティ | 型 | 説明 | | ----------- | ------- | ----------------------------------------------------------------- | | objectName | text | イベントをトリガーしているオブジェクト名。フォームによってトリガーされている場合には含まれていません。 | -| code | longint | フォームイベントの数値。 フォームイベントの数値。 `Form event code` によっても返されます。 | +| code | longint | フォームイベントの数値。フォームイベントの数値。 `Form event code` によっても返されます。 | | description | text | フォームイベント名 (例: "On After Edit") | -イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。 特に: +イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。特に: - [リストボックス](FormObjects/listbox-object.md#supported-form-events) および [リストボックス列](FormObjects/listbox-column.md#supported-form-events) は、`columnName` や `isRowSelected` といった、[追加のプロパティ](FormObjects/listbox-object.md#supported-form-events) を返します。 - [4D View Pro エリア](FormObjects/viewProArea_overview.md) は、`sheetName` や `action` といったプロパティを [On After Edit](onAfterEdit.md) イベントオブジェクトに返します。 @@ -38,9 +38,9 @@ End if - まず 4D は、フォーム中のオブジェクトをブラウズし、発生したオブジェクトイベントがプロパティで選択されているすべてのオブジェクトのオブジェクトメソッドを呼び出します。 - 次に、発生したイベントに対応するフォームイベントがフォームのプロパティで選択されていれば、フォームメソッドを呼び出します。 -オブジェクトメソッドが特定の順序で呼び出されることを期待することはできません。 おおまかに言って、オブジェクトメソッドは常にフォームメソッドよりも前に呼び出されます。 オブジェクトがサブフォームの場合、サブフォームのリストフォームのオブジェクトメソッドが呼び出され、次にリストフォームのフォームメソッドが呼び出されます。 そして 4D は引き続き、親フォームのオブジェクトメソッドを呼び出します。 つまり、オブジェクトがサブフォームの時、 4D はサブフォームオブジェクト内で、オブジェクトとフォームメソッドと同じルールを適用します。 +オブジェクトメソッドが特定の順序で呼び出されることを期待することはできません。おおまかに言って、オブジェクトメソッドは常にフォームメソッドよりも前に呼び出されます。オブジェクトがサブフォームの場合、サブフォームのリストフォームのオブジェクトメソッドが呼び出され、次にリストフォームのフォームメソッドが呼び出されます。そして 4D は引き続き、親フォームのオブジェクトメソッドを呼び出します。つまり、オブジェクトがサブフォームの時、 4D はサブフォームオブジェクト内で、オブジェクトとフォームメソッドと同じルールを適用します。 -[On Load](onLoad.md) と [On Unload](onUnload.md) イベントを除き(後述参照)、発生したイベントがフォームイベントプロパティで選択されていなかったとしても、オブジェクトプロパティで選択されていれば、そのオブジェクトメソッドの呼び出しが妨げられることはありません。 言い換えれば、フォームレベルでイベントを有効あるいは無効にしても、オブジェクトイベントプロパティには影響ありません。 +[On Load](onLoad.md) と [On Unload](onUnload.md) イベントを除き(後述参照)、発生したイベントがフォームイベントプロパティで選択されていなかったとしても、オブジェクトプロパティで選択されていれば、そのオブジェクトメソッドの呼び出しが妨げられることはありません。言い換えれば、フォームレベルでイベントを有効あるいは無効にしても、オブジェクトイベントプロパティには影響ありません。 特定のイベントに関連するオブジェクトの数は、イベントの性質により異なります。 @@ -48,71 +48,71 @@ End if 以下の表は、それぞれのイベントごとにどのようにオブジェクトメソッドとフォームメソッドが呼ばれるかを概説します: -| イベント | オブジェクトメソッド | フォームメソッド | 対象オブジェクト | -| ------------------------ | ----------------------------------------------- | -------- | ------------ | -| On Load | ◯ | ◯ | すべてのオブジェクト | -| On Unload | ◯ | ◯ | すべてのオブジェクト | -| On Validate | ◯ | ◯ | すべてのオブジェクト | -| On Clicked | ◯ | ◯ | 関係するオブジェクトのみ | -| On Double Clicked | ◯ | ◯ | 関係するオブジェクトのみ | -| On Before Keystroke | ◯ | ◯ | 関係するオブジェクトのみ | -| On After Keystroke | ◯ | ◯ | 関係するオブジェクトのみ | -| On After Edit | ◯ | ◯ | 関係するオブジェクトのみ | -| On Getting Focus | ◯ | ◯ | 関係するオブジェクトのみ | -| On Losing Focus | ◯ | ◯ | 関係するオブジェクトのみ | -| On Activate | X | ◯ | なし | -| On Deactivate | X | ◯ | なし | -| On Outside Call | X | ◯ | なし | -| On Page Change | X | ◯ | なし | -| On Begin Drag Over | ◯ | ◯ | 関係するオブジェクトのみ | -| On Drop | ◯ | ◯ | 関係するオブジェクトのみ | -| On Drag Over | ◯ | X | 関係するオブジェクトのみ | -| On Mouse Enter | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Move | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Leave | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Up | ◯ | X | 関係するオブジェクトのみ | -| On Menu Selected | X | ◯ | なし | -| On Bound variable change | X | ◯ | なし | -| On Data Change | ◯ | ◯ | 関係するオブジェクトのみ | -| On Plug in Area | ◯ | ◯ | 関係するオブジェクトのみ | -| On Header | ◯ | ◯ | すべてのオブジェクト | -| On Printing Detail | ◯ | ◯ | すべてのオブジェクト | -| On Printing Break | ◯ | ◯ | すべてのオブジェクト | -| On Printing Footer | ◯ | ◯ | すべてのオブジェクト | -| On Close Box | X | ◯ | なし | -| On Display Detail | ◯ | ◯ | すべてのオブジェクト | -| On Open Detail | ◯ (リストボックス) | ◯ | リストボックスのみ | -| On Close Detail | ◯ (リストボックス) | ◯ | リストボックスのみ | -| On Resize | X | ◯ | なし | -| On Selection Change | ◯ | ◯ | 関係するオブジェクトのみ | -| On Load Record | X | ◯ | なし | -| On Timer | X | ◯ | なし | -| On Scroll | ◯ | X | 関係するオブジェクトのみ | -| On Before Data Entry | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Column Moved | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Row Moved | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Column Resize | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Header Click | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Footer Click | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On After Sort | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Long Click | ◯ (ボタン) | ◯ | 関係するオブジェクトのみ | -| On Alternative Click | ◯ (ボタンとリストボックス) | X | 関係するオブジェクトのみ | -| On Expand | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On Collapse | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On Delete Action | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On URL Resource Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Begin URL Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On URL Loading Error | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On URL Filtering | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On End URL Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Open External Link | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Window Opening Denied | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On VP Range Changed | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On VP Ready | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Row Resize | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | - -イベントに対応するプロパティが選択されている場合にのみ、フォームやオブジェクトのメソッドが呼び出されることに留意してください。 デザインモードのフォームエディターのプロパティリストでイベントを無効にすると、メソッドが呼び出される回数を減らすことができ、フォームの実行速度を最適化できます。 - -> 警告: オブジェクトの [On Load](onLoad.md) と [On Unload](onUnload.md) イベントが生成されるには、オブジェクトとオブジェクトが属するフォーム の両方で有効にされていなければなりません。 オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 +| イベント | コード | オブジェクトメソッド | フォームメソッド | 対象オブジェクト | +| ------------------------ | --- | ----------------------------------------------- | -------- | ------------ | +| On Activate | 11 | X | ◯ | なし | +| On After Edit | 45 | ◯ | ◯ | 関係するオブジェクトのみ | +| On After Keystroke | 28 | ◯ | ◯ | 関係するオブジェクトのみ | +| On After Sort | 30 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Alternative Click | 38 | ◯ (ボタンとリストボックス) | X | 関係するオブジェクトのみ | +| On Before Data Entry | 41 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Before Keystroke | 17 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Begin Drag Over | 46 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Begin URL Loading | 47 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Bound variable change | 54 | X | ◯ | なし | +| On Clicked | 4 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Close Box | 22 | X | ◯ | なし | +| On Close Detail | 26 | ◯ (リストボックス) | ◯ | リストボックスのみ | +| On Collapse | 44 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Column Moved | 32 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Column Resize | 33 | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Data Change | 20 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Deactivate | 12 | X | ◯ | なし | +| On Delete Action | 58 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Display Detail | 8 | ◯ | ◯ | すべてのオブジェクト | +| On Double Clicked | 13 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Drag Over | 21 | ◯ | X | 関係するオブジェクトのみ | +| On Drop | 16 | ◯ | ◯ | 関係するオブジェクトのみ | +| On End URL Loading | 49 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Expand | 43 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Footer Click | 57 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Getting Focus | 15 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Header | 5 | ◯ | ◯ | すべてのオブジェクト | +| On Header Click | 42 | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Load | 1 | ◯ | ◯ | すべてのオブジェクト | +| On Load Record | 40 | X | ◯ | なし | +| On Long Click | 39 | ◯ (ボタン) | ◯ | 関係するオブジェクトのみ | +| On Losing Focus | 14 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Menu Selected | 18 | X | ◯ | なし | +| On Mouse Enter | 35 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Leave | 36 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Move | 37 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Up | 2 | ◯ | X | 関係するオブジェクトのみ | +| On Open Detail | 25 | ◯ (リストボックス) | ◯ | リストボックスのみ | +| On Open External Link | 52 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Outside Call | 10 | X | ◯ | なし | +| On Page Change | 56 | X | ◯ | なし | +| On Plug in Area | 19 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Printing Break | 6 | ◯ | ◯ | すべてのオブジェクト | +| On Printing Detail | 23 | ◯ | ◯ | すべてのオブジェクト | +| On Printing Footer | 7 | ◯ | ◯ | すべてのオブジェクト | +| On Resize | 29 | X | ◯ | なし | +| On Row Moved | 34 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Row Resize | 60 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Scroll | 59 | ◯ | X | 関係するオブジェクトのみ | +| On Selection Change | 31 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Timer | 27 | X | ◯ | なし | +| On Unload | 24 | ◯ | ◯ | すべてのオブジェクト | +| On URL Filtering | 51 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On URL Loading Error | 50 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On URL Resource Loading | 48 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Validate | 3 | ◯ | ◯ | すべてのオブジェクト | +| On VP Range Changed | 61 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On VP Ready | 9 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Window Opening Denied | 53 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | + +イベントに対応するプロパティが選択されている場合にのみ、フォームやオブジェクトのメソッドが呼び出されることに留意してください。デザインモードのフォームエディターのプロパティリストでイベントを無効にすると、メソッドが呼び出される回数を減らすことができ、フォームの実行速度を最適化できます。 + +> 警告: オブジェクトの [On Load](onLoad.md) と [On Unload](onUnload.md) イベントが生成されるには、オブジェクトとオブジェクトが属するフォーム の両方で有効にされていなければなりません。オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md b/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md index e5ce387e15ec05..b7078e739ed537 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/Project/components.md @@ -3,9 +3,9 @@ id: components title: 依存関係 --- -4D [プロジェクトアーキテクチャー](../Project/architecture.md) はモジュール式です。 [**コンポーネント**](../../Concepts/components.md) や [**プラグイン**](../Concepts/plug-ins.md) をインストールすることで、4Dプロジェクトに追加機能を持たせることができます。 コンポーネントは4D コードで書かれていますが、プラグインは[あらゆる言語を使用してビルドすることができます](../Extensions/develop-plug-ins.md)。 +4D [プロジェクトアーキテクチャー](../Project/architecture.md) はモジュール式です。[**コンポーネント**](../../Concepts/components.md) や [**プラグイン**](../Concepts/plug-ins.md) をインストールすることで、4Dプロジェクトに追加機能を持たせることができます。コンポーネントは4D コードで書かれていますが、プラグインは[あらゆる言語を使用してビルドすることができます](../Extensions/develop-plug-ins.md)。 -You can [develop](../Extensions/develop-components.md) and [build](../Desktop/building.md) your own 4D components, or download public components proposed by 4D or the 4D community on the [**4D Corner platform**](https://corner.4d.com/). +独自の 4Dコンポーネントを [開発](../Extensions/develop-components.md) し、[ビルド](../Desktop/building.md) することもできますし、4D あるいは4Dコミュニティによって公開されているパブリックなコンポーネントを [**4D Corner プラットフォーム**](https://corner.4d.com/) からダウンロードすることもできます。 4D 環境にインストールされると、拡張機能は特別なプロパティを持つ**依存関係** として扱われます。 @@ -14,13 +14,13 @@ You can [develop](../Extensions/develop-components.md) and [build](../Desktop/bu コンポーネントは、インタープリターまたは [コンパイル済み](./compiler.md#compile-components) のものが使えます。 - インタープリターモードで動作する 4Dプロジェクトは、インタープリターまたはコンパイル済みどちらのコンポーネントも使用できます。 -- コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。 この場合、コンパイル済みコンポーネントのみが利用可能です。 +- コンパイルモードで実行される 4Dプロジェクトでは、インタープリターのコンポーネントを使用できません。この場合、コンパイル済みコンポーネントのみが利用可能です。 ### パッケージフォルダー コンポーネントのパッケージフォルダー (*MyComponent.4dbase* フォルダー) には以下のものを含めることができます: -- **インタープリター版コンポーネント**の場合: 標準の [Project フォルダー](../Project/architecture.md)。 [プロジェクトの**Components** フォルダー](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダー名の末尾を **.4dbase** にする必要があります。 +- **インタープリター版コンポーネント**の場合: 標準の [Project フォルダー](../Project/architecture.md)。[プロジェクトの**Components** フォルダー](architecture.md#コンポーネント)にインストールする場合には、パッケージフォルダー名の末尾を **.4dbase** にする必要があります。 - **コンパイル版コンポーネント**の場合: - .4DZ ファイル、*Resources* フォルダー、*Info.plist* ファイルを格納している"Contents" フォルダー推奨されるアーキテクチャー) - *Resources* などの他のフォルダーを格納している.4DZ ファイル。 @@ -37,7 +37,7 @@ You can [develop](../Extensions/develop-components.md) and [build](../Desktop/bu :::note -この章では、**4D** と **4D Server** 環境でのコンポーネントの使用方法について説明します。 他の環境では、コンポーネントの管理は異なります: +この章では、**4D** と **4D Server** 環境でのコンポーネントの使用方法について説明します。他の環境では、コンポーネントの管理は異なります: - [リモートモードの 4D](../Desktop/clientServer.md) では、サーバーがコンポーネントを読み込み、リモートアプリケーションに送信します。 - 統合されたアプリケーションでは、コンポーネントは [ビルドする際に組み込まれます](../Desktop/building.md#プラグインコンポーネントページ)。 @@ -63,7 +63,7 @@ You can [develop](../Extensions/develop-components.md) and [build](../Desktop/bu #### dependencies.json -**dependencies.json** ファイルは、4Dプロジェクトに必要なすべてのコンポーネントを宣言します。 このファイルは、4Dプロジェクトフォルダーの **Sources** フォルダーに置く必要があります。例: +**dependencies.json** ファイルは、4Dプロジェクトに必要なすべてのコンポーネントを宣言します。このファイルは、4Dプロジェクトフォルダーの **Sources** フォルダーに置く必要があります。例: ``` /MyProjectRoot/Project/Sources/dependencies.json @@ -76,7 +76,7 @@ You can [develop](../Extensions/develop-components.md) and [build](../Desktop/bu #### environment4d.json -**environment4d.json** ファイルは必須ではありません。 このファイルは、**dependencies.json** ファイル内で宣言された一部またはすべてのコンポーネントのついて、**カスタムパス** を定義するのに使用します。 このファイルは、プロジェクトパッケージフォルダーまたはその親フォルダーのいずれかに保存することができます (ルートまでの任意のレベル)。 +**environment4d.json** ファイルは必須ではありません。このファイルは、**dependencies.json** ファイル内で宣言された一部またはすべてのコンポーネントのついて、**カスタムパス** を定義するのに使用します。このファイルは、プロジェクトパッケージフォルダーまたはその親フォルダーのいずれかに保存することができます (ルートまでの任意のレベル)。 このアーキテクチャーの主な利点は次のとおりです: @@ -169,9 +169,9 @@ flowchart TB パスは、POSIXシンタックスで表します ([POSIXシンタックス](../Concepts/paths#posix-シンタックス) 参照)。 -相対パスは、[`environment4d.json`](#environment4djson) ファイルを基準とした相対パスです。 絶対パスは、ユーザーのマシンにリンクされています。 +相対パスは、[`environment4d.json`](#environment4djson) ファイルを基準とした相対パスです。絶対パスは、ユーザーのマシンにリンクされています。 -コンポーネントアーキテクチャーの柔軟性と移植性のため、ほとんどの場合、相対パスを使用することが **推奨** されます (特に、プロジェクトがソース管理ツールにホストされている場合)。 絶対パスは、1台のマシンと 1人のユーザーに特化したコンポーネントの場合にのみ使用すべきです。 +コンポーネントアーキテクチャーの柔軟性と移植性のため、ほとんどの場合、相対パスを使用することが **推奨** されます (特に、プロジェクトがソース管理ツールにホストされている場合)。絶対パスは、1台のマシンと 1人のユーザーに特化したコンポーネントの場合にのみ使用すべきです。 ### Gitホスティングプラットフォームに保存されたコンポーネント{#components-stored-on-git-hosting-platforms} @@ -188,7 +188,7 @@ GitHub またはGitLab に保存された 4Dコンポーネントを直接参照 #### GitHubリポジトリの設定 1. ZIP形式でコンポーネントファイルを圧縮します。 -2. GitHubリポジトリと同じ名前をこのアーカイブに付けます。 例えば、"my-4D-Component" というリポジトリに対しては、アーカイブは"my-4D-Component.zip" という名前をつけなければなりません。 +2. GitHubリポジトリと同じ名前をこのアーカイブに付けます。例えば、"my-4D-Component" というリポジトリに対しては、アーカイブは"my-4D-Component.zip" という名前をつけなければなりません。 - このリポジトリの [GitHubリリース](https://docs.github.com/ja/repositories/releasing-projects-on-github/managing-releases-in-a-repository) にアーカイブを統合します。 @@ -196,7 +196,7 @@ GitHub またはGitLab に保存された 4Dコンポーネントを直接参照 #### GitLabリポジトリの設定 -GitLab リリースは対象の名前とURL のみを保存するため、アップロードされたファイルは含みません。 コンポーネントのzip ファイルをリンクとして提供する必要があります。 +GitLab リリースは対象の名前とURL のみを保存するため、アップロードされたファイルは含みません。コンポーネントのzip ファイルをリンクとして提供する必要があります。 1. コンポーネントのzip ファイルをどこか(外部サーバー、またはを[GitLab パッケージレジストリ](#gitlabパッケージレジストリを使用) (汎用パッケージ)を使用して)アップロードします。 2. コンポーネントに対して[GitLab リリース](https://docs.gitlab.com/user/project/releases/) を作成し、そこにコンポーネントのファイルへのリンクをリリースアセットとして含めます。 @@ -205,7 +205,7 @@ GitLab リリースは対象の名前とURL のみを保存するため、アッ #### Gitlabパッケージレジストリを使用 -[GitLab パッケージレジストリ](https://docs.gitlab.com/user/packages/package_registry/) を使用すると、ファイルをGitLab 自身にファイルをホストすることができるようになります。 主な利点は、認証されたアクセス、安全かつバージョン分けされたURL、またリリースタグにバイナリーを割り当てることができる機能などです。 パッケージレジストリを使用するには: +[GitLab パッケージレジストリ](https://docs.gitlab.com/user/packages/package_registry/) を使用すると、ファイルをGitLab 自身にファイルをホストすることができるようになります。主な利点は、認証されたアクセス、安全かつバージョン分けされたURL、またリリースタグにバイナリーを割り当てることができる機能などです。パッケージレジストリを使用するには: 1. コンポーネントファイルをビルドします(例: *MyComponent.zip*) 2. それをスクリプトを使用して[汎用パッケージリポジトリ](https://docs.gitlab.com/user/packages/generic_packages/) へとアップロードします([GitLab ドキュメンテーション内の例題](https://docs.gitlab.com/user/packages/generic_packages/#publish-a-single-file))。 @@ -242,7 +242,7 @@ GitHub およびGitLab に保存されているコンポーネントは [**depen ``` - (GitLab 依存関係のみ) "host" プロパティを使用してプライベートなGitLab のセルフホストインスタンスを宣言します。 "gitlab" プロパティのみを使用する場合、それはhttps://gitlab.com にホストされているGitLab リポジトリであるということを意味します。 -- "myGitHubComponent1" は宣言とパス定義の両方がされていますが、"myComponent2" は宣言されているだけです。 そのため、[**environment4d.json**](#environment4djson) ファイルにパスを定義する必要があります: +- "myGitHubComponent1" は宣言とパス定義の両方がされていますが、"myComponent2" は宣言されているだけです。そのため、[**environment4d.json**](#environment4djson) ファイルにパスを定義する必要があります: ```json title="environment4d.json" { @@ -258,7 +258,7 @@ GitHub およびGitLab に保存されているコンポーネントは [**depen #### タグとバージョン -GitHubでリリースが作成されると、そこに**タグ** と**バージョン** が関連づけられます。 依存関係マネージャーはこれらの情報を使用してコンポーネントの自動利用可能性を管理します。 +GitHubでリリースが作成されると、そこに**タグ** と**バージョン** が関連づけられます。依存関係マネージャーはこれらの情報を使用してコンポーネントの自動利用可能性を管理します。 :::note @@ -266,7 +266,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ ::: -- **タグ** はリリースを一意に参照するテキストです。 [**dependencies.json** ファイル](#dependenciesjson) および [**environment4d.json**](#environment4djson) ファイルでは、プロジェクトで使用するリリースタグを指定することができます。 たとえば: +- **タグ** はリリースを一意に参照するテキストです。 [**dependencies.json** ファイル](#dependenciesjson) および [**environment4d.json**](#environment4djson) ファイルでは、プロジェクトで使用するリリースタグを指定することができます。たとえば: ```json title="dependencies.json" { @@ -279,7 +279,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ } ``` -- リリースは **バージョン** によっても識別されます。 使用されるバージョニングシステムは一般的に使用されている [*セマンティックバージョニング*](https://regex101.com/r/Ly7O1x/3/) コンセプトに基づいています。 各バージョン番号は次のように識別されます: `majorNumber.minorNumber.pathNumber`。 タグと同様に、プロジェクトで使用したいコンポーネントのバージョンを指定することができます。例: +- リリースは **バージョン** によっても識別されます。使用されるバージョニングシステムは一般的に使用されている [*セマンティックバージョニング*](https://regex101.com/r/Ly7O1x/3/) コンセプトに基づいています。各バージョン番号は次のように識別されます: `majorNumber.minorNumber.pathNumber`。タグと同様に、プロジェクトで使用したいコンポーネントのバージョンを指定することができます。例: ```json title="dependencies.json" { @@ -311,15 +311,15 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ タグやバージョンを指定しない場合、4D は自動的に "latest" バージョンを取得します。 -依存関係マネージャーはコンポーネントの更新がGitHub上で利用可能かどうかを定期的にチェックします。 コンポーネントに対して新しいバージョンが利用可能だった場合、[設定に応じて](#依存関係バージョン範囲)依存関係一覧の中で更新マークが表示されます。 +依存関係マネージャーはコンポーネントの更新がGitHub上で利用可能かどうかを定期的にチェックします。コンポーネントに対して新しいバージョンが利用可能だった場合、[設定に応じて](#依存関係バージョン範囲)依存関係一覧の中で更新マークが表示されます。 #### 4Dバージョンタグの命名規則 [**4Dのバージョンに追随する**](#依存関係のバージョン範囲を定義) 依存関係ルールを使用したい場合、コンポーネントのリリースのタグは、特定の命名規則に従う必要があります。 -- **LTS バージョン**: `x.y.p` パターン。ここでの`x.y` は追随したいメインの4D バージョンを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの *x.y* のLTS バージョンを追随すると指定した場合、依存関係マネージャーはそれを"x.\* の最新バージョン"(利用可能であれば)、あるいは"x 未満のバージョン"と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、 "20.4" という指定は依存関係マネージャーによって"バージョン 20.\* の最新コンポーネント、または20 未満のバージョン"として解決されます。 +- **LTS バージョン**: `x.y.p` パターン。ここでの`x.y` は追随したいメインの4D バージョンを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。プロジェクトが4D バージョンの *x.y* のLTS バージョンを追随すると指定した場合、依存関係マネージャーはそれを"x.\* の最新バージョン"(利用可能であれば)、あるいは"x 未満のバージョン"と解釈します。もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。たとえば、 "20.4" という指定は依存関係マネージャーによって"バージョン 20.\* の最新コンポーネント、または20 未満のバージョン"として解決されます。 -- **R-リリースバージョン**: `xRy.p` パターン。ここでの`x` と `y` は追随したいメインの4D Rリリースを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。 プロジェクトが4D バージョンの*xRy* バージョンを追随すると指定した場合、依存関係マネージャーはそれを"xR(y+1) 未満の最新バージョン"(利用可能であれば) と解釈します。 もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。 たとえば、"20R9" という指定は依存関係マネージャーによって"20R10 未満の最新コンポーネントバージョン"として解決されます。 +- **R-リリースバージョン**: `xRy.p` パターン。ここでの`x` と `y` は追随したいメインの4D Rリリースを表し、`p` (オプション) はパッチバージョンや他の追加のアップデートなどのために使用することができます。プロジェクトが4D バージョンの*xRy* バージョンを追随すると指定した場合、依存関係マネージャーはそれを"xR(y+1) 未満の最新バージョン"(利用可能であれば) と解釈します。もしそのようなバージョンが存在しない場合、その旨がユーザーに通知されます。たとえば、"20R9" という指定は依存関係マネージャーによって"20R10 未満の最新コンポーネントバージョン"として解決されます。 :::note @@ -343,7 +343,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ #### 依存関係のローカルキャッシュ -参照された GitHub およびGitLab コンポーネントはローカルのキャッシュフォルダーにダウンロードされ、その後環境に読み込まれます。 ローカルキャッシュフォルダーは以下の場所に保存されます: +参照された GitHub およびGitLab コンポーネントはローカルのキャッシュフォルダーにダウンロードされ、その後環境に読み込まれます。ローカルキャッシュフォルダーは以下の場所に保存されます: - macOS: `$HOME/Library/Caches//Dependencies` - Windows: `C:\Users\\AppData\Local\\Dependencies` @@ -352,14 +352,14 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ ### 依存関係の自動解決 -コンポーネントを([ローカルで](#local-components) 、あるいは [Git ホスティングプラットフォーム経由で](#components-stored-on-git-hosting-platforms))追加またはアップデートした場合、4D コンポーネントが必要とする依存関係を自動的に解決してインストールします。 構成には次の内容が含まれます: +コンポーネントを([ローカルで](#local-components) 、あるいは [Git ホスティングプラットフォーム経由で](#components-stored-on-git-hosting-platforms))追加またはアップデートした場合、4D コンポーネントが必要とする依存関係を自動的に解決してインストールします。構成には次の内容が含まれます: - **一次依存関係**: `dependencies.json` ファイル内で明示的に宣言したコンポーネント - **二次依存関係**: 一次依存関係または他の二次依存関係が必要とするコンポーネントで、自動的に解決され、インストールされます。 -依存関係マネージャーは、それぞれのコンポーネントが持つ `dependencies.json` ファイルを読み込み、可能な限り指定されたバージョンを遵守しつつ全ての必要な依存関係を回帰的にインストールします。 これによって、ネストされた依存関係を手動で特定し、一つずつ追加しなくても済むようになります。 +依存関係マネージャーは、それぞれのコンポーネントが持つ `dependencies.json` ファイルを読み込み、可能な限り指定されたバージョンを遵守しつつ全ての必要な依存関係を回帰的にインストールします。これによって、ネストされた依存関係を手動で特定し、一つずつ追加しなくても済むようになります。 -- **コンフリクトの解決**: 複数の依存関係が同じコンポーネントの[異なるバージョン](#defining-a-dependency-version-range) を必要とする場合、依存関係マネージャーは全ての重なったバージョン範囲を満たすバージョンを探し出すことでコンフリクトを自動的に解決しようとします。 一次依存関係が二次依存関係とコンフリクトを起こした場合には、一次依存関係が優先されます。 +- **コンフリクトの解決**: 複数の依存関係が同じコンポーネントの[異なるバージョン](#defining-a-dependency-version-range) を必要とする場合、依存関係マネージャーは全ての重なったバージョン範囲を満たすバージョンを探し出すことでコンフリクトを自動的に解決しようとします。一次依存関係が二次依存関係とコンフリクトを起こした場合には、一次依存関係が優先されます。 :::note @@ -371,7 +371,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ プロジェクトの [`userPreferences` フォルダー](architecture.md#userpreferencesusername) に `dependency-lock.json` ファイルが作成されます。 -このファイルは、依存関係・パス・url・読み込みエラー・その他の情報などをログに記録します。 これは、コンポーネントの読み込み管理やトラブルシューティングに役立ちます。 +このファイルは、依存関係・パス・url・読み込みエラー・その他の情報などをログに記録します。これは、コンポーネントの読み込み管理やトラブルシューティングに役立ちます。 ## プロジェクトの依存関係をモニタリング {#monitoring-project-dependencies} @@ -385,7 +385,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ - 4D Server では、**ウインドウ/プロジェクト依存関係** メニューアイテムを選択します。
    ![dependency-menu-server](../assets/en/Project/dependency-menu-server.png) -依存関係パネルが表示されます。 依存関係は ABC順にソートされます。 +依存関係パネルが表示されます。依存関係は ABC順にソートされます。 ![dependency](../assets/en/Project/dependency.png) @@ -393,14 +393,14 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ ### 依存関係のフィルタリング -デフォルトでは、依存関係マネージャーによって識別されたすべての依存関係は、それらの [ステータス](#依存関係のステータス) に関係なくリストされます。 依存関係パネル上部のタブを選択することで、依存関係のステータスに応じてリストの表示をフィルタリングできます: +デフォルトでは、依存関係マネージャーによって識別されたすべての依存関係は、それらの [ステータス](#依存関係のステータス) に関係なくリストされます。依存関係パネル上部のタブを選択することで、依存関係のステータスに応じてリストの表示をフィルタリングできます: ![dependency-tabs](../assets/en/Project/dependency-tabs.png) - **全て**: 一次依存関係(宣言されたもの)と二次依存関係(自動的に解決されたもの)を含めた全ての依存関係がフラットな一覧ビューで表示します。 -- **宣言済み**: `dependencies.json` ファイルで明示的に宣言された一次依存関係。 このタブを使用することで、あなたが直接追加した依存関係と[自動的に解決された](#自動依存関係解決)を区別するのに役立ちます。 -- **アクティブ**: プロジェクトに読み込まれ、使用できる依存関係。 実際にロードされた *Overloading* な依存関係が含まれます。 *Overloaded* である方の依存関係は、その他の競合している依存関係とともに **コンフリクト** パネルに表示されます。 -- **非アクティブ**: プロジェクトに読み込まれておらず、利用できない依存関係。 このステータスには様々な理由が考えられます: ファイルの欠落、バージョンの非互換性など… +- **宣言済み**: `dependencies.json` ファイルで明示的に宣言された一次依存関係。このタブを使用することで、あなたが直接追加した依存関係と[自動的に解決された](#自動依存関係解決)を区別するのに役立ちます。 +- **アクティブ**: プロジェクトに読み込まれ、使用できる依存関係。実際にロードされた *Overloading* な依存関係が含まれます。 *Overloaded* である方の依存関係は、その他の競合している依存関係とともに **コンフリクト** パネルに表示されます。 +- **非アクティブ**: プロジェクトに読み込まれておらず、利用できない依存関係。このステータスには様々な理由が考えられます: ファイルの欠落、バージョンの非互換性など… - **コンフリクト**: ロードはされたものの、より低い[優先レベル](#優先順位) にある依存関係を少なくとも一つはオーバーロードする依存関係。 *Overloaded* な依存関係も表示されるため、競合の原因を確認し、適切に対処することができます。 ### 二次依存関係 @@ -409,7 +409,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ ![recursive-dependency](../assets/en/Project/recursive.png) -二次依存関係の上をホバーすると、それを必要とする親依存関係を示すツールTip が表示されます。 二次依存関係は直接 [削除する](#依存関係の削除) ことはできません。それを必要とする一次依存関係を削除するか編集する必要があります。 +二次依存関係の上をホバーすると、それを必要とする親依存関係を示すツールTip が表示されます。二次依存関係は直接 [削除する](#依存関係の削除) ことはできません。それを必要とする一次依存関係を削除するか編集する必要があります。 ### 依存関係のステータス @@ -442,7 +442,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ ### 依存関係のオリジン -依存関係パネルには、各依存関係のオリジン (由来) にかかわらず、プロジェクトの依存関係すべてがリストされます。 依存関係のオリジンは、名前の下に表示されるタグによって判断することができます: +依存関係パネルには、各依存関係のオリジン (由来) にかかわらず、プロジェクトの依存関係すべてがリストされます。依存関係のオリジンは、名前の下に表示されるタグによって判断することができます: ![dependency-origin](../assets/en/Project/dependency-origin.png) @@ -475,11 +475,11 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ ### ローカルな依存関係の追加 -ローカルな依存関係を追加するには、パネルのフッターエリアの **[+]** ボタンをクリックします。 次のようなダイアログボックスが表示されます: +ローカルな依存関係を追加するには、パネルのフッターエリアの **[+]** ボタンをクリックします。次のようなダイアログボックスが表示されます: ![dependency-add](../assets/en/Project/dependency-add.png) -**ローカル** タブが選択されていることを確認し、**...** ボタンをクリックします。 標準の "ファイルを開く" ダイアログボックスが表示され、追加するコンポーネントを選択できます。 [**.4DZ**](../Desktop/building.md#コンポーネントをビルド) または [**.4DProject**](architecture.md#applicationname4dproject-ファイル) ファイルを選択できます。 +**ローカル** タブが選択されていることを確認し、**...** ボタンをクリックします。標準の "ファイルを開く" ダイアログボックスが表示され、追加するコンポーネントを選択できます。 [**.4DZ**](../Desktop/building.md#コンポーネントをビルド) または [**.4DProject**](architecture.md#applicationname4dproject-ファイル) ファイルを選択できます。 選択した項目が有効であれば、その名前と場所がダイアログボックスに表示されます。 @@ -490,7 +490,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ プロジェクトに依存関係を追加するには、**追加** をクリックします。 - プロジェクトパッケージフォルダーの隣 (デフォルトの場所) にあるコンポーネントを選択すると、[**dependencies.json**](#dependenciesjson)ファイル内で宣言されます。 -- プロジェクトのパッケージフォルダーの隣にないコンポーネントを選択した場合、そのコンポーネントは [**dependencies.json**](#dependenciesjson) ファイルで宣言され、そのパスも [**environment4d.json**](#environment4djson) ファイルで宣言されます (注記参照)。 依存関係パネルでは、[相対パスまたは絶対パス](#相対パス-vs-絶対パス) のどちらを保存するか尋ねられます。 +- プロジェクトのパッケージフォルダーの隣にないコンポーネントを選択した場合、そのコンポーネントは [**dependencies.json**](#dependenciesjson) ファイルで宣言され、そのパスも [**environment4d.json**](#environment4djson) ファイルで宣言されます (注記参照)。依存関係パネルでは、[相対パスまたは絶対パス](#相対パス-vs-絶対パス) のどちらを保存するか尋ねられます。 :::note @@ -498,7 +498,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ ::: -この依存関係は、[非アクティブな依存関係のリスト](#依存関係のステータス) に **Available after restart** (再起動後に利用可能) というステータスで追加されます。 このコンポーネントはアプリケーションの再起動後にロードされます。 +この依存関係は、[非アクティブな依存関係のリスト](#依存関係のステータス) に **Available after restart** (再起動後に利用可能) というステータスで追加されます。このコンポーネントはアプリケーションの再起動後にロードされます。 ### GitHubまたはGitLab依存関係を追加する @@ -518,7 +518,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ ::: -2. 依存関係の GitHub またはGitLab リポジトリのパスを入力します。 例: +2. 依存関係の GitHub またはGitLab リポジトリのパスを入力します。例: - **リポジトリURL** (例: "https://github.com/vdelachaux/UI-with-Classes") - (GitLab のみ) セルフホストインスタンスのプライベートなサーバーのURL (例: "https://git-my-server.com/4d/components/mycomponent") @@ -526,7 +526,7 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ ![dependency-add-git-2](../assets/en/Project/dependency-add-git-2.png) -接続が確立されると、入力エリアの右側にアイコン ![dependency-gitlogo](../assets/en/Project/dependency-gitlogo.png) が表示されます。 このアイコンをクリックすると、既定のブラウザーでリポジトリを開くことができます。 +接続が確立されると、入力エリアの右側にアイコン ![dependency-gitlogo](../assets/en/Project/dependency-gitlogo.png) が表示されます。このアイコンをクリックすると、既定のブラウザーでリポジトリを開くことができます。 :::note @@ -534,11 +534,11 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ ::: -3. このプロジェクトで使用する[依存関係のバージョン範囲](#タグとバージョン) を定義します。 デフォルトでは"自動更新する(latest)" (GitHub) または "Highest" (GitLab) が選択されており、これは最新のバージョンが自動的に使用されるということを意味します。 +3. このプロジェクトで使用する[依存関係のバージョン範囲](#タグとバージョン) を定義します。デフォルトでは"自動更新する(latest)" (GitHub) または "Highest" (GitLab) が選択されており、これは最新のバージョンが自動的に使用されるということを意味します。 4. プロジェクトに依存関係を追加するには、**追加** ボタンをクリックします。 -依存関係は[**dependencies.json**](#dependenciesjson) ファイル内で宣言され、[無効化依存関係一覧](#dependency-status) 内に、**Available at restart** のステータスで追加されます。 このコンポーネントはアプリケーションの再起動後にロードされます。 +依存関係は[**dependencies.json**](#dependenciesjson) ファイル内で宣言され、[無効化依存関係一覧](#dependency-status) 内に、**Available at restart** のステータスで追加されます。このコンポーネントはアプリケーションの再起動後にロードされます。 #### 依存関係のバージョン範囲を定義 @@ -546,11 +546,11 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ ![dependency-git-tag](../assets/en/Project/dependency-git-tag.png) -- **4D のバージョンに追随する** (デフォルト、推奨されるオプション): 実行中の4D バージョンと互換性のある最新のコンポーネントリリースをダウンロードします。 この依存関係ルールは、コンポーネントのリリースタグが適切な[命名規則](#4dバージョンタグの命名規則) に従っていた場合にのみ使用できます。 このオプションは、特に[4D によって開発されたコンポーネント](../Extensions/overview.md#4d-によって開発されたコンポーネント) に対して推奨されます。 +- **4D のバージョンに追随する** (デフォルト、推奨されるオプション): 実行中の4D バージョンと互換性のある最新のコンポーネントリリースをダウンロードします。この依存関係ルールは、コンポーネントのリリースタグが適切な[命名規則](#4dバージョンタグの命名規則) に従っていた場合にのみ使用できます。このオプションは、特に[4D によって開発されたコンポーネント](../Extensions/overview.md#4d-によって開発されたコンポーネント) に対して推奨されます。 - **メジャー更新の手前まで**: [セマンティックバージョニングの範囲](#タグとバージョン)を定義して、更新を次のメジャーバージョンの手前までに制限します。 - **マイナー更新の手前まで**: 上と同様に、更新を次のマイナーバージョンの手前までに制限します。 - **自動更新しない(タグ指定)**: 利用可能なリストから [特定のタグ](#セマンティックバージョン範囲]) を選択するか、手動で入力します。 -- **自動更新する(latest)** (GitHub) あるいは **自動更新する(Highest)** (GitLab): 対応するタグを持ったリリースをダウンロードすることを許可します。これらは通常最新のリリースです。 **警告:** このオプションを使用するのは開発の初期段階では便利かもしれませんが、ベータリリースを含め新しいリリースを自動的に取り込むため、予期せぬアップデートや変更を引き起こす可能性があります。そのため、製品環境や共有プロジェクトでは避けた方が賢明です。 +- **自動更新する(latest)** (GitHub) あるいは **自動更新する(Highest)** (GitLab): 対応するタグを持ったリリースをダウンロードすることを許可します。これらは通常最新のリリースです。**警告:** このオプションを使用するのは開発の初期段階では便利かもしれませんが、ベータリリースを含め新しいリリースを自動的に取り込むため、予期せぬアップデートや変更を引き起こす可能性があります。そのため、製品環境や共有プロジェクトでは避けた方が賢明です。 現在の依存関係バージョンは、依存関係の項目の右側に表示されます: @@ -558,33 +558,33 @@ GitHubでリリースが作成されると、そこに**タグ** と**バージ #### 依存関係バージョン範囲の変更 -一覧に表示された依存関係に対して[バージョン設定](#依存関係のバージョン範囲を定義) を編集することができます: 編集する依存関係を選択し、コンテキストメニューから**依存関係を編集...** を選択して下さい。 "依存関係を編集" ダイアログボックス内にて、依存関係のルールメニューを編集し、**適用** をクリックします。 +一覧に表示された依存関係に対して[バージョン設定](#依存関係のバージョン範囲を定義) を編集することができます: 編集する依存関係を選択し、コンテキストメニューから**依存関係を編集...** を選択して下さい。"依存関係を編集" ダイアログボックス内にて、依存関係のルールメニューを編集し、**適用** をクリックします。 バージョン範囲の変更は、自動アップデート機能を使用しているときに依存関係を特定のバージョン番号にロックしておきたいときに有用です。 -### Using 4D Corner +### 4D Cornerを使用する -The [**4D Corner platform**](https://corner.4d.com/) proposes a comprehensive list of ready-to-use 4D components, proposed from the 4D company or from the 4D community. You can browse or search the list to find any component meeting to your needs. +[**4D Corner プラットフォーム**](https://corner.4d.com/) は、4D 社または4D コミュニティによって公開されたすぐに使える4D コンポーネントの包括的なリストを掲載しています。リストの中を閲覧または検索して、ご要望にあうコンポーネントをお探しください。 ![4d-corner](../assets/en/Project/4d-corner.png) -You can open the [4D Corner platform](https://corner.4d.com/) from the Dependency manager, either in the top of the [Add a dependency window](#adding-a-github-or-gitlab-dependency), or by selecting **Discover more components on 4D Corner...** from the menu at the bottom of the Dependency manager window: +依存関係マネージャーからを開くこともできます。[依存関係を追加ウィンドウ](#githubまたはgitlab依存関係を追加する) のトップから、あるいは依存関係マネージャーウィンドウの下部のメニューから**4D Corner でさらにコンポーネントを探す...** を選択することで開けます。 ![4d-corner-access](../assets/en/Project/4d-corner-access.png) -To install a component from the 4D Corner platform: +4D Corner プラットフォームからコンポーネントをインストールするには、以下のようにします: -1. Click on the "Copy link" button on the top right corner of the component tile: +1. コンポーネントファイルの右上隅の"リンクをコピー"ボタンをクリック: ![copy button](../assets/en/Project/4d-corner-copy.png) -2. Open the Dependency manager and click on the **[+]** button. +2. 依存関係マネージャーを開き、**[+]** ボタンをクリックします。 -The dependency link is automatically added in the address area: +依存関係のリンクがアドレスエリアに自動的に追加されます: ![add dependency](../assets/en/Project/4d-corner-add.png) -3. [Configure the dependency reference](#adding-a-github-or-gitlab-dependency) and click **Add**. +3. [依存関係参照を設定](#githubまたはgitlab依存関係を追加する) し、**追加** をクリックします。 :::tip 関連したblog 記事 @@ -594,7 +594,7 @@ The dependency link is automatically added in the address area: ### 依存関係の更新 -依存関係マネージャーは GitHub 上の更新を統合的に管理する方法を提供します。 以下の機能がサポートされています: +依存関係マネージャーは GitHub 上の更新を統合的に管理する方法を提供します。以下の機能がサポートされています: - 利用可能なバージョンの自動および手動でのチェック - コンポーネントの自動および手動での更新 @@ -603,7 +603,7 @@ The dependency link is automatically added in the address area: #### 新バージョンをチェック -依存関係は、GitHub 上での更新を定期的にチェックされています。 このチェックはバックグラウンドで透過的に行われています。 +依存関係は、GitHub 上での更新を定期的にチェックされています。このチェックはバックグラウンドで透過的に行われています。 :::note @@ -647,16 +647,16 @@ The dependency link is automatically added in the address area: 更新コマンドを選択すると: -- ダイアログボックスが表示され**プロジェクトを再起動する**ことが提示されます。再起動することによって更新された依存関係が直ちに利用可能になります。 通常、更新された依存関係を直ちに有効化するためにプロジェクトを再起動することが推奨されます。 +- ダイアログボックスが表示され**プロジェクトを再起動する**ことが提示されます。再起動することによって更新された依存関係が直ちに利用可能になります。通常、更新された依存関係を直ちに有効化するためにプロジェクトを再起動することが推奨されます。 - **あとで** をクリックすると、更新コマンドはメニューには表示されなくなります。これは次回起動時に更新が予定されるということになります。 #### 自動アップデート 依存関係マネージャーウィンドウの下部の**オプション**メニューから、**自動アップデート** オプションを選択することができます。 -このオプションがチェックされている場合(デフォルトでチェック)、GitHub コンポーネントあるいはGitLab コンポーネントで[コンポーネントバージョン設定](#defining-a-dependency-version-range) に合致している新しいバージョンは、次回プロジェクト起動時に自動的に更新されます。 このオプションは手動で更新を洗濯する必要性を排除することで、日々の依存関係アップデートの管理を容易にします。 +このオプションがチェックされている場合(デフォルトでチェック)、GitHub コンポーネントあるいはGitLab コンポーネントで[コンポーネントバージョン設定](#defining-a-dependency-version-range) に合致している新しいバージョンは、次回プロジェクト起動時に自動的に更新されます。このオプションは手動で更新を洗濯する必要性を排除することで、日々の依存関係アップデートの管理を容易にします。 -このオプションがチェックされていない場合、[コンポーネントバージョン設定](#github依存関係バージョン範囲の定義) に合致している新しいコンポーネントバージョンは、利用可能であることが表示されるに止まり、[手動での更新](#依存関係の更新) を必要とします。 依存関係の更新を正確に監視したい場合には、**自動アップデート** オプションの選択を外します。 +このオプションがチェックされていない場合、[コンポーネントバージョン設定](#github依存関係バージョン範囲の定義) に合致している新しいコンポーネントバージョンは、利用可能であることが表示されるに止まり、[手動での更新](#依存関係の更新) を必要とします。依存関係の更新を正確に監視したい場合には、**自動アップデート** オプションの選択を外します。 ### アクセストークンの提供 @@ -683,28 +683,28 @@ GitHub またはGitLab アクセストークンを提供するには、次のい #### トークンの編集 -パーソナルアクセストークンはホストにつき 1つしか入力できません。 入力したトークンは、その後 **編集** することができます。 +パーソナルアクセストークンはホストにつき 1つしか入力できません。入力したトークンは、その後 **編集** することができます。 提供されたトークンは、[アクティブな4Dフォルダー](../commands/get-4d-folder#active-4d-folder) 内の**github.json** ファイルに保存されます。 ### 依存関係の削除 -依存関係パネルから依存関係を削除するには、対象の依存関係を選択し、パネルの **-** ボタンをクリックするか、コンテキストメニューから **依存関係の削除...** を選択します。 依存関係は複数選択することができ、その場合、操作は選択したすべての依存関係に適用されます。 +依存関係パネルから依存関係を削除するには、対象の依存関係を選択し、パネルの **-** ボタンをクリックするか、コンテキストメニューから **依存関係の削除...** を選択します。依存関係は複数選択することができ、その場合、操作は選択したすべての依存関係に適用されます。 :::note -依存関係パネルを使用して削除できるのは、[**dependencies.json**](#dependenciesjson) ファイルで宣言されている一次依存関係に限られます。 二次依存関係は直接削除することはできません。二次依存関係を削除するには、それを必要とする一次依存関係を削除する必要があります。 選択した依存関係を削除できない場合、**-** ボタンは無効化され、**依存関係の削除...** メニュー項目は非表示になります。 +依存関係パネルを使用して削除できるのは、[**dependencies.json**](#dependenciesjson) ファイルで宣言されている一次依存関係に限られます。二次依存関係は直接削除することはできません。二次依存関係を削除するには、それを必要とする一次依存関係を削除する必要があります。選択した依存関係を削除できない場合、**-** ボタンは無効化され、**依存関係の削除...** メニュー項目は非表示になります。 ::: -確認用のダイアログボックスが表示されます。 依存関係が **environment4d.json** ファイルで宣言されている場合、以下のオプションでそれを削除することができます: +確認用のダイアログボックスが表示されます。依存関係が **environment4d.json** ファイルで宣言されている場合、以下のオプションでそれを削除することができます: ![dependency-remove](../assets/en/Project/remove-comp.png) -ダイアログボックスを確定すると、削除された依存関係の [ステータス](#依存関係のステータス) には "Unloaded after restart" (再起動時にアンロード) フラグが自動的に付きます。 このコンポーネントはアプリケーションの再起動時にアンロードされます。 +ダイアログボックスを確定すると、削除された依存関係の [ステータス](#依存関係のステータス) には "Unloaded after restart" (再起動時にアンロード) フラグが自動的に付きます。このコンポーネントはアプリケーションの再起動時にアンロードされます。 #### 依存関係の使用に関する警告 -プロジェクト内の他の依存関係が必要とする一次依存関係を削除しようとした場合、その依存関係が使用されているという警告が表示されます。 そのまま削除した場合にはそれを必要としている依存関係コンポーネントが正常に動作しなくなる可能性があるため、システムはどの依存関係がそれを必要としているかを表示した上で、削除するかどうかの確認を求めます。 +プロジェクト内の他の依存関係が必要とする一次依存関係を削除しようとした場合、その依存関係が使用されているという警告が表示されます。そのまま削除した場合にはそれを必要としている依存関係コンポーネントが正常に動作しなくなる可能性があるため、システムはどの依存関係がそれを必要としているかを表示した上で、削除するかどうかの確認を求めます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md b/i18n/ja/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md index 0ccfde243239af..49155d8c3d0a14 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md @@ -49,7 +49,7 @@ displayed_sidebar: docs | プロパティ | 型 | 説明 | | ----------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Deflate圧縮 (デフォルト)
  • `ZIP Compression LZMA`: LZMA圧縮
  • `ZIP Compression XZ`: XZ圧縮
  • `ZIP Compression none`: 圧縮なし
    • | -| level | Integer | 圧縮レベル。 とりうる値: 1 - 10。 低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。 ただし、圧縮レベルはパフォーマンスに影響します。 デフォルト値 (省略時):
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | +| level | Integer | 圧縮レベル。 とりうる値: 1 - 10。 低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。 ただし、圧縮レベルはパフォーマンスに影響します。 デフォルト値 (省略時):
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | | encryption | Integer | パスワードが設定されていた場合に使用する暗号化方法:
  • `ZIP Encryption AES128`: 128-bit キーを使った AES による暗号化
  • `ZIP Encryption AES192`: 192-bit キーを使った AES による暗号化
  • `ZIP Encryption AES256`: 256-bit キーを使った AES による暗号化 (パスワードが設定されている場合のデフォルト)
  • `ZIP Encryption none`: 暗号化なし (パスワードが設定されてない場合のデフォルト)
    • | | password | Text | 暗号化が必要な場合に使用するパスワード | | files | Collection |
  • `4D.File` または` 4D.Folder` オブジェクトのコレクション
  • 以下のプロパティを持ったオブジェクトのコレクション:
    • プロパティタイプ説明
    source4D.File または 4D.FolderFile または Folder
    destinationText(任意) - アーカイブのコンテンツ構成を変更するための相対ファイルパス
    optionnumber(任意) - `ZIP Ignore invisible files` で非表示ファイルを無視、0 を渡すと全ファイルを圧縮
    | @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## 参照 -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## プロパティ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md b/i18n/ja/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md index c6d2ea5562f2b0..33d4b26916d8d2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ root フォルダーから取り出します: ## 参照 -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## プロパティ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/settings/security.md b/i18n/ja/docusaurus-plugin-content-docs/current/settings/security.md index 1725ec57b07f3b..d1adb393ce8e11 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/settings/security.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/settings/security.md @@ -11,59 +11,57 @@ title: セキュリティページ > これらの設定は、シングルユーザーモードで開かれたプロジェクトデータベースには適用されません。 -#### Design and Runtime Explorer Access +#### デザイン環境やランタイムエクスプローラー -Gives the specified group the ability to enter the Design environment of the database and display the Runtime Explorer. +データベースのデザインモードにアクセスし、ランタイムエクスプローラーを表示する権利を特定のグループに付与します。 注: -- デザインモードへのアクセスグループを設定すると、データ読み込みダイアログの **テーブルを作成** オプションが無効となります。 このダイアログボックスに関する詳細は [ファイルからデータを読み込む](https://doc.4d.com/4Dv20/4D/20.2/Importing-data-from-files.300-6750325.ja.html) を参照ください。 +- デザインモードへのアクセスグループを設定すると、データ読み込みダイアログの **テーブルを作成** オプションが無効となります。このダイアログボックスに関する詳細は [ファイルからデータを読み込む](https://doc.4d.com/4Dv20/4D/20.2/Importing-data-from-files.300-6750325.ja.html) を参照ください。 - Designer とAdministrator は常にデザインモードとランタイムエクスプローラーにアクセスできます。 設定されるアクセスグループのメンバーに含められる必要はありません。 ユーザーおよびグループに関する詳細は [ユーザー＆グループ](../Users/handling_users_groups.md) の章をご参照ください。 -#### Default User +#### デフォルトユーザ -When a Default User has been set, every user that opens the database or logs onto it has the same access privileges and restrictions defined for this Default User. ユーザー名の入力が不要になるだけでなく、 ユーザー名の入力が不要になるだけでなく、 デフォルトユーザーにパスワードを割り当てていない場合、パスワードダイアログボックスは表示されず、データベースが直接開かれます。 +デフォルトユーザーが設定されると、データベースを開く、あるいはデータベースにログインするすべてのユーザーは、このデフォルトユーザーに定義されたアクセス権と同じ制限を持つことになります。ユーザー名の入力が不要になるだけでなく、ユーザー名の入力が不要になるだけでなく、 デフォルトユーザーにパスワードを割り当てていない場合、パスワードダイアログボックスは表示されず、データベースが直接開かれます。 このオプションを使用することで、完全なデータコントロールシステムを維持しつつ、データベースへのアクセスをシンプルにすることができます。 - デフォルトユーザーにパスワードを割り当てた場合、データベースが開かれるときにダイアログが表示され、パスワードの入力を求められます。 - デフォルトユーザーにパスワードを割り当てていない場合、パスワードダイアログボックスは表示されません。 - **Note:** You can "force" the display of the User Identification dialog box when the "Default User" mode is active, for instance in order to connect as Administrator or Designer. これには、データベースを開いたり接続したりする際に **Shift**キーを押したままにします。 + **注意:** "デフォルトユーザー" モードが有効になっているときでも、強制的にユーザー認証ダイアログを表示させることができます。 これはたとえば Administrator や Designer としてログインするために必要となります。これには、データベースを開いたり接続したりする際に **Shift**キーを押したままにします。 -#### Display User List in Password Dialog Box +#### パスワードダイアログにユーザーリストを表示する -If this option is checked, users must choose their name from the list of users and enter their password in the User Identification dialog box. オプションが選択されていない場合、ユーザーは名前とパスワードの両方を入力します。 パスワードダイアログボックスの 2つのバージョンに関する詳細は [アクセスシステムの概要](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.ja.html) を参照ください。 +このオプションが選択されていると、ユーザー認証ダイアログにユーザーリストが表示され、ユーザーはその中から名前を選択し、パスワードを入力することになります。オプションが選択されていない場合、ユーザーは名前とパスワードの両方を入力します。パスワードダイアログボックスの 2つのバージョンに関する詳細は [アクセスシステムの概要](https://doc.4d.com/4Dv20/4D/20.2/Access-system-overview.300-6750353.ja.html) を参照ください。 -#### User List in Alphabetical Order (only available if the previous option is checked) +#### ユーザーリストをABC順に表示する(前のオプションがチェックされている時のみ利用可能) -When this option is checked, the list of users in the password entry dialog box is sorted by alphabetical order. +このオプションがチェックされていると、パスワード入力ダイアログボックスに表示されるユーザーの一覧がアルファベット順に並べ替えられます。 -#### Users can change their password +#### ユーザーは自分のパスワードを変更可能 -When this option is checked, a **Change** button is displayed in the User Identification dialog box. このボタンを使用すると、パスワードを変更するためのダイアログボックスが表示されます (このダイアログに関する詳細は [パスワードアクセスシステムの保守](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.ja.html) の "ユーザーによるパスワードの変更" を参照ください)。 必要であれば **変更** ボタンを非表示にし、パスワードの変更を禁止することができます。 それには、このオプションの選択を外します。 +このオプションが選択されていると、ユーザー認証ダイアログに **変更** ボタンが表示されます。このボタンを使用すると、パスワードを変更するためのダイアログボックスが表示されます (このダイアログに関する詳細は [パスワードアクセスシステムの保守](https://doc.4d.com/4Dv20/4D/20.2/Ensuring-system-maintenance.300-6750352.ja.html) の "ユーザーによるパスワードの変更" を参照ください)。必要であれば **変更** ボタンを非表示にし、パスワードの変更を禁止することができます。それには、このオプションの選択を外します。 ## オプション -#### Filtering of commands and project methods in the formula editor and in the 4D View Pro and 4D Write Pro documents +#### フォーミュラエディタと4D View Proと4D Write Pro ドキュメントで使用できるメソッドとプロジェクトメソッドの制限 -For security reasons, by default 4D restricts access to the commands, functions and project methods in the [Formula editor](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.en.html) in Application mode or added to multistyle areas (using [`ST INSERT EXPRESSION`](../commands/st-insert-expression)), 4D Write Pro and 4D View Pro documents: only certain 4D functions and project methods that have been explicitly declared using the [`SET ALLOWED METHODS`](../commands/set-allowed-methods) command can be used. 以下のオプションを使用して、部分的あるいは全体的にこのフィルタリングを無効にできます。 +セキュリティのため 4D はデフォルトで、アプリケーションモードの [フォーミュラエディター](https://doc.4d.com/4Dv20/4D/20.2/Formula-editor.200-6750079.ja.html) においてコマンド、関数、プロジェクトメソッドへのアクセスを制限しています。これは、[`ST INSERT EXPRESSION`](../commands/st-insert-expression) コマンドによってマルチスタイルエリアに追加されるフォーミュラエディターの他、4D View Pro および 4D Write Proドキュメントにおいても同様です。[`SET ALLOWED METHODS`](../commands/set-allowed-methods) コマンドを使用して明示的に許可された 4D 関数やプロジェクトメソッドのみを使用することができます。以下のオプションを使用して、部分的あるいは全体的にこのフィルタリングを無効にできます。 - **すべてのユーザーを制限する** (デフォルトオプション): Designer と Administrator を含むすべてのユーザーに対し、コマンドや関数、プロジェクトメソッドへのアクセスを制限します。 -- **DesignerとAdministratorは制限しない**: このオプションは Designer と Administrator のみに、4Dコマンドやメソッドへの完全なアクセスを与えます。 他のユーザーには制限をかけつつ、管理者に無制限のアクセスを与えたい場合に使用できます。 開発段階では、このモードを使用してすべてのフォーミュラやレポート等を自由にテストできます。 運用時には、一時的にコマンドやメソッドへのアクセスを与えるためなどに使用できます。 これを行うには、コマンドへのフルアクセスが必要なダイアログを呼び出したり印刷処理を開始したりする前に ([`CHANGE CURRENT USER`](../commands/change-current-user) コマンドを使用して) ユーザーを切り替えます。そしてその処理が終了したのちに元のユーザーに戻します。 - **注:** 前のオプションを使用してフルアクセスが有効にされると、このオプションは効果を失います。 +- **DesignerとAdministratorは制限しない**: このオプションは Designer と Administrator のみに、4Dコマンドやメソッドへの完全なアクセスを与えます。他のユーザーには制限をかけつつ、管理者に無制限のアクセスを与えたい場合に使用できます。開発段階では、このモードを使用してすべてのフォーミュラやレポート等を自由にテストできます。運用時には、一時的にコマンドやメソッドへのアクセスを与えるためなどに使用できます。これを行うには、コマンドへのフルアクセスが必要なダイアログを呼び出したり印刷処理を開始したりする前に ([`CHANGE CURRENT USER`](../commands/change-current-user) コマンドを使用して) ユーザーを切り替えます。そしてその処理が終了したのちに元のユーザーに戻します。**注:** 前のオプションを使用してフルアクセスが有効にされると、このオプションは効果を失います。 -- **誰も制限しない**: このオプションはフォーミュラの制御を無効にします。 このオプションが選択されると、ユーザーはすべての 4Dコマンドおよびプラグインコマンド、さらにはプロジェクトメソッドを使用できます (非表示のものを除く)。 - **注意:** このオプションは[`SET ALLOWED METHODS`](../commands/set-allowed-methods) コマンドよりも優先されます。 このオプションが選択されると、コマンドの効果はなくなります。 +- **誰も制限しない**: このオプションはフォーミュラの制御を無効にします。このオプションが選択されると、ユーザーはすべての 4Dコマンドおよびプラグインコマンド、さらにはプロジェクトメソッドを使用できます (非表示のものを除く)。**注意:** このオプションは[`SET ALLOWED METHODS`](../commands/set-allowed-methods) コマンドよりも優先されます。このオプションが選択されると、コマンドの効果はなくなります。 -#### Enable User Settings +#### ユーザー設定を有効にする -You need to check this option to be able to display separated dialog boxes for user settings. このオプションが選択されると、設定をおこなうダイアログが最大 3つになります: **ストラクチャー設定**、**ユーザー設定**、そして **データファイル用のユーザー設定** です。 詳細は [ユーザー設定](../settings/overview.md#ユーザー設定) を参照ください。 +外部ファイル化したユーザー設定を使用するにはこのオプションを選択します。このオプションが選択されると、設定をおこなうダイアログが最大 3つになります: **ストラクチャー設定**、**ユーザー設定**、そして **データファイル用のユーザー設定** です。詳細は [ユーザー設定](../settings/overview.md#ユーザー設定) を参照ください。 -#### Execute "On Host Database Event" method of the components +#### コンポーネントの "On Host Database Event" メソッドを実行 -The [On Host Database Event database method](../commands/on-host-database-event-database-method) facilitates the initialization and backup phases for 4D components. セキュリティ上の理由から、このメソッドの実行はそれぞれのホストデータベースにおいて明示的に許可されなければなりません。 そのためにはこのオプションをチェックします。 デフォルトでは、チェックされていません。 +[On Host Database Event database method](../commands/on-host-database-event-database-method) は 4Dコンポーネントの初期化とバックアップフェーズを容易にします。セキュリティ上の理由から、このメソッドの実行はそれぞれのホストデータベースにおいて明示的に許可されなければなりません。そのためにはこのオプションをチェックします。デフォルトでは、チェックされていません。 このオプションがチェックされていると: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md index 349c02b1d3453d..3192eabb552ceb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md @@ -77,7 +77,7 @@ End if | プロパティ | 型 | 説明 | | ----------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Deflate圧縮 (デフォルト)
  • `ZIP Compression LZMA`: LZMA圧縮
  • `ZIP Compression XZ`: XZ圧縮
  • `ZIP Compression none`: 圧縮なし
    • | -| level | Integer | 圧縮レベル。 とりうる値: 1 - 10。 低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。 ただし、圧縮レベルはパフォーマンスに影響します。 デフォルト値 (省略時):
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | +| level | Integer | 圧縮レベル。 とりうる値: 1 - 10。 低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。 ただし、圧縮レベルはパフォーマンスに影響します。 デフォルト値 (省略時):
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | | encryption | Integer | パスワードが設定されていた場合に使用する暗号化方法:
  • `ZIP Encryption AES128`: 128-bit キーを使った AES による暗号化
  • `ZIP Encryption AES192`: 192-bit キーを使った AES による暗号化
  • `ZIP Encryption AES256`: 256-bit キーを使った AES による暗号化 (パスワードが設定されている場合のデフォルト)
  • `ZIP Encryption none`: 暗号化なし (パスワードが設定されてない場合のデフォルト)
    • | | password | Text | 暗号化が必要な場合に使用するパスワード | | files | Collection |
  • `4D.File` または `4D.Folder` オブジェクトのコレクション
  • 以下のプロパティを持ったオブジェクトのコレクション:
    • プロパティ型説明
    source4D.File または 4D.FolderFile または Folder
    destinationText(任意) - アーカイブのコンテンツ構成を変更するための相対ファイルパス
    optionnumber(任意) - `ZIP Ignore invisible files` で非表示ファイルを無視、0 を渡すと全ファイルを圧縮
    | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md index 1581c5fc008bfc..e992e71475ff91 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/CollectionClass.md @@ -104,7 +104,7 @@ Collection クラスは [コレクション](Concepts/dt_collection.md) 型の 任意で、一つ以上の *value* 引数を渡すことで、あらかじめ値の入った新しいコレクションを作成することができます。 -または、あとから代入によって要素を一つずつ追加・編集していくことができます。 例: +または、あとから代入によって要素を一つずつ追加・編集していくことができます。例: ```4d myCol[10]:="My new element" @@ -112,12 +112,12 @@ Collection クラスは [コレクション](Concepts/dt_collection.md) 型の コレクションの最終要素を超える要素番号 (インデックス) を指定した場合、コレクションは自動的にリサイズされ、合い間の要素にはすべて **null** 値が割り当てられらます。 -サポートされている型 (数値、テキスト、日付、ピクチャー、ポインター、オブジェクト、コレクション等) であれば、個数に制限なく値を渡すことができます。 配列とは異なり、コレクションでは異なる型のデータを混ぜることができます。 +サポートされている型 (数値、テキスト、日付、ピクチャー、ポインター、オブジェクト、コレクション等) であれば、個数に制限なく値を渡すことができます。配列とは異なり、コレクションでは異なる型のデータを混ぜることができます。 ただし以下の変換問題については注意する必要があります: * 渡されたポインターは、そのまま保存されます。ポインターは `JSON Stringify` コマンドを使用することで評価されます。 -* 日付は、"dates inside objects" データベース設定に応じて、"yyyy-mm-dd" という日付、または "YYYY-MM-DDTHH:mm:ss.SSSZ" というフォーマットの文字列で保存されます。 コレクションに保存する前に 4D日付をテキストに変換した場合、プログラムはデフォルトでローカルのタイムゾーンを使用します。 このふるまいは `SET DATABASE PARAMETER` コマンドで `Dates inside objects` セレクターを使用することで変更可能です。 +* 日付は、"dates inside objects" データベース設定に応じて、"yyyy-mm-dd" という日付、または "YYYY-MM-DDTHH:mm:ss.SSSZ" というフォーマットの文字列で保存されます。コレクションに保存する前に 4D日付をテキストに変換した場合、プログラムはデフォルトでローカルのタイムゾーンを使用します。このふるまいは `SET DATABASE PARAMETER` コマンドで `Dates inside objects` セレクターを使用することで変更可能です。 * 時間を渡した場合、それはミリ秒の数 (実数) として保存されます。 #### 例題 1 @@ -186,7 +186,7 @@ Collection クラスは [コレクション](Concepts/dt_collection.md) 型の `New shared collection` コマンドは、 空の、あるいは値の入った新規の共有コレクションを作成し、その参照を返します 。 -このコレクションに要素を追加する場合には [`Use...End use`](Concepts/shared.md#useend-use) 構造でくくる必要があり、そうしない場合にはエラーが返されます。ただし、[`push()`](#push) や [`map()`](#map) などの関数を使用して要素を追加する場合は、自動で内部的に *Use...End use* が使用されるため、必要ありません。 ただし、属性の読み取りは [`Use...End use`](Concepts/shared#useend-use) 構造の外側でも可能です。 +このコレクションに要素を追加する場合には [`Use...End use`](Concepts/shared.md#useend-use) 構造でくくる必要があり、そうしない場合にはエラーが返されます。ただし、[`push()`](#push) や [`map()`](#map) などの関数を使用して要素を追加する場合は、自動で内部的に *Use...End use* が使用されるため、必要ありません。ただし、属性の読み取りは [`Use...End use`](Concepts/shared#useend-use) 構造の外側でも可能です。 :::info @@ -200,13 +200,13 @@ Collection クラスは [コレクション](Concepts/dt_collection.md) 型の > `var : Collection` や `C_COLLECTION` ステートメントはコレクション型の変数を宣言しますが、コレクション自体は作成しないという点に注意してください。 -任意で、一つ以上の *value* 引数を渡すことで、あらかじめ値の入った新しい共有コレクションを作成することができます。 または、あとからオブジェクト記法による代入で要素を一つずつ追加・編集していくことができます (例題参照)。 +任意で、一つ以上の *value* 引数を渡すことで、あらかじめ値の入った新しい共有コレクションを作成することができます。または、あとからオブジェクト記法による代入で要素を一つずつ追加・編集していくことができます (例題参照)。 共有コレクションの最終要素を超える要素番号 (インデックス) を指定した場合、共有コレクションは自動的にリサイズされ、合い間の要素にはすべて **null** 値が割り当てられらます。 以下のサポートされる型であれば、いくつでも値を渡すことができます: -* 数値 (実数、倍長整数...)。 数値は常に実数として保存されます。 +* 数値 (実数、倍長整数...)。数値は常に実数として保存されます。 * text * boolean * date @@ -531,22 +531,22 @@ $c2:=$c.concat(6;7;8) //[1,2,3,4,5,6,7,8] 任意の *option* パラメーターには、以下のどちらか (あるいは両方) の定数を渡すことができます: -| option | 説明 | -| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ck resolve pointers` | オリジナルのコレクションがポインター型の値を格納している場合、デフォルトではコピー先のオブジェクトもポインターを格納します。 しかしながら、`ck resolve pointers` 定数を渡すことで、コピー時にポインターを解決することができます。 この場合、コレクション内の各ポインターはコピー時に解決され、解決済みの値が使用されます。 | -| `ck shared` | 共有コレクションに対して適用された場合でも、`copy()` はデフォルトで通常の (非共有の) コレクションを返します。 共有コレクションを作成するには、`ck shared` 定数を渡します。 この場合には、*groupWith* パラメーターに引数を渡して他の共有オブジェクトまたは共有コレクションに関連づけることもできます (以下参照)。 | +| option | 説明 | +| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ck resolve pointers` | オリジナルのコレクションがポインター型の値を格納している場合、デフォルトではコピー先のオブジェクトもポインターを格納します。しかしながら、`ck resolve pointers` 定数を渡すことで、コピー時にポインターを解決することができます。この場合、コレクション内の各ポインターはコピー時に解決され、解決済みの値が使用されます。 | +| `ck shared` | 共有コレクションに対して適用された場合でも、`copy()` はデフォルトで通常の (非共有の) コレクションを返します。共有コレクションを作成するには、`ck shared` 定数を渡します。この場合には、*groupWith* パラメーターに引数を渡して他の共有オブジェクトまたは共有コレクションに関連づけることもできます (以下参照)。 | *groupWithCol* または *groupWithObj* 引数を渡すと、結果のコレクションを関連づけるコレクションまたはオブジェクトを指定できます。 :::note -データストア、データクラス、およびエンティティオブジェクトはコピーできません。 これらを対象に `.copy()` を呼び出すと、`Null` 値が返されます。 +データストア、データクラス、およびエンティティオブジェクトはコピーできません。これらを対象に `.copy()` を呼び出すと、`Null` 値が返されます。 ::: #### 例題 1 -通常の (非共有の) コレクション *$lastnames * を、共有オブジェクト *$sharedObject* 内にコピーします。 このためには、まず共有コレクション (*$sharedLastnames*) を作成する必要があります。 +通常の (非共有の) コレクション *$lastnames * を、共有オブジェクト *$sharedObject* 内にコピーします。このためには、まず共有コレクション (*$sharedLastnames*) を作成する必要があります。 ```4d var $sharedObject : Object @@ -569,7 +569,7 @@ End use #### 例題 2 -どちらも共有コレクションである *$sharedColl1* と*$sharedColl2* を結合します。 これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。 そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 +どちらも共有コレクションである *$sharedColl1* と*$sharedColl2* を結合します。これらは異なる共有グループに所属しているため、直接結合した場合にはエラーが生成されます。そこで、 *$sharedColl1* のコピーを作成し、*$sharedColl2* をそのコピーの共有グループ先に指定します。 ```4d var $sharedColl1;$sharedColl2;$copyColl : Collection @@ -586,7 +586,7 @@ $sharedColl2:=New shared collection(New shared object("lastname";"Brown")) #### 例題 3 -通常のコレクション (*$lastnames*) があり、それをアプリケーションの **Storage** に入れます。 これには、先に共有コレクション (*$sharedLastnames*) を作成しておく必要があります。 +通常のコレクション (*$lastnames*) があり、それをアプリケーションの **Storage** に入れます。これには、先に共有コレクション (*$sharedLastnames*) を作成しておく必要があります。 ```4d var $lastnames;$sharedLastnames : Collection @@ -660,7 +660,7 @@ End use `.count()` 関数は、 コレクション内の、null ではない要素の個数を返します。 -コレクションがオブジェクトを含んでいる場合、*propertyPath* 引数を渡すことができます。 この場合、*propertyPath* で指定したパスを含む要素のみがカウントされます。 +コレクションがオブジェクトを含んでいる場合、*propertyPath* 引数を渡すことができます。この場合、*propertyPath* で指定したパスを含む要素のみがカウントされます。 #### 例題 @@ -806,10 +806,10 @@ End use *options* 引数として、以下の定数を 1つ、または組み合わせで渡すことができます: -| 定数 | 値 | 説明 | -| ----------------- | -- | ------------------------------------------------------------------------------------------------------------------------------------- | -| `ck diacritical` | 8 | 文字の大小とアクセントを区別して評価をおこないます。 省略された場合のデフォルトでは、アクセント等の発音区別符号を無視した評価が実行されます。 | -| `ck count values` | 32 | 特定の値を持つ要素の数 (重複がなければ 1、重複があればその数) を返します。 このオプションを渡すと、`.distinct()` は、`{"value":*value*;"count":*count*}` のプロパティを含むオブジェクトのコレクションを返します。 | +| 定数 | 値 | 説明 | +| ----------------- | -- | ------------------------------------------------------------------------------------------------------------------------------------ | +| `ck diacritical` | 8 | 文字の大小とアクセントを区別して評価をおこないます。省略された場合のデフォルトでは、アクセント等の発音区別符号を無視した評価が実行されます。 | +| `ck count values` | 32 | 特定の値を持つ要素の数 (重複がなければ 1、重複があればその数) を返します。このオプションを渡すと、`.distinct()` は、`{"value":*value*;"count":*count*}` のプロパティを含むオブジェクトのコレクションを返します。 | #### 例題 @@ -866,12 +866,12 @@ End use :::note 注記 -- `.equal()` 関数は、コレクション内の文字列、ブール値、数値、および null型要素の等価性をチェックするだけです。 ネイティブオブジェクトの等価性はチェックされません。 +- `.equal()` 関数は、コレクション内の文字列、ブール値、数値、および null型要素の等価性をチェックするだけです。ネイティブオブジェクトの等価性はチェックされません。 - **null**値の要素は undefined要素と同じとはみなされません。 ::: -デフォルトでは、アクセント等の発音区別符号を無視した評価が実行されます。 評価の際に文字の大小を区別したり、アクセント記号を区別したい場合には、option に `ck diacritical` 定数を渡します。 +デフォルトでは、アクセント等の発音区別符号を無視した評価が実行されます。評価の際に文字の大小を区別したり、アクセント記号を区別したい場合には、option に `ck diacritical` 定数を渡します。 #### 例題 @@ -940,7 +940,7 @@ End use - *formula* (推奨シンタックス)、関数やプロジェクトメソッドを含むあらゆる実行可能な式を格納できる [Formula オブジェクト](FunctionClass.md)。 - または *methodName*、プロジェクトメソッドの名前 (テキスト)。 -コールバックには、*param* (任意) に指定した引数が渡されます。 引数の有無にかかわらず、コールバックは任意のテストを実行でき、テストを満たす要素に対しては **true** を返さなくてはなりません。 コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 +コールバックには、*param* (任意) に指定した引数が渡されます。引数の有無にかかわらず、コールバックは任意のテストを実行でき、テストを満たす要素に対しては **true** を返さなくてはなりません。コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 コールバックは以下の引数を受け取ります: @@ -951,11 +951,11 @@ End use また、コールバックは以下のパラメーターを設定できます: * (メソッドを使用する場合は必須) *$1.result* (ブール): 要素の値の評価が成功した場合には **true** 、それ以外は **false** -* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。 返された値は最後に計算されたものです。 +* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。返された値は最後に計算されたものです。 `.every()` 関数は、**false** として評価されたコレクション要素を発見すると、コールバックの呼び出しをやめて **false** を返します。 -デフォルトでは、`.every()` はコレクション全体をテストします。 任意で、*startFrom* にテストを開始する要素のインデックスを渡すこともできます。 +デフォルトでは、`.every()` はコレクション全体をテストします。任意で、*startFrom* にテストを開始する要素のインデックスを渡すこともできます。 * *startFrom* がコレクションの length 以上だった場合、**false** が返されます。これはコレクションがテストされていないことを意味します。 * *startFrom* < 0 の場合には、コレクションの終わりからのオフセットであるとみなされます(*startFrom:=startFrom+length*)。 @@ -1119,7 +1119,7 @@ $c2:=$c.extract("name";"City";"zc";"Zip") //$c2=[{Zip:35060},{City:null,Zip:3504 引数に矛盾がある場合、次のように解釈されます: -* *startFrom* < 0 の場合、*startFrom:=startFrom+length* として再計算されます (コレクションの終端からのオフセットであるとみなされます)。 再計算された値も負の値だった場合、*startFrom* は 0 に設定されます。 +* *startFrom* < 0 の場合、*startFrom:=startFrom+length* として再計算されます (コレクションの終端からのオフセットであるとみなされます)。再計算された値も負の値だった場合、*startFrom* は 0 に設定されます。 * *end* < 0 の場合、それは *end:=end+length* として再計算されます。 * 渡された値、あるいは再計算された値が *end* < *startFrom* の場合、関数はなにもしません。 @@ -1171,7 +1171,7 @@ $c2:=$c.extract("name";"City";"zc";"Zip") //$c2=[{Zip:35060},{City:null,Zip:3504 #### 説明 -`.filter()` 関数は、 元のコレクション要素のうち、*formula* フォーミュラまたは *methodName* メソッドの結果が **true** になる要素をすべて格納した新しいコレクションを返します。 この関数は ***シャロウ・コピー*** を返します。つまり、元のコレクションにオブジェクト要素やコレクション要素が含まれていた場合、それらの参照は戻り値のコレクションで共有されます。 また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 +`.filter()` 関数は、 元のコレクション要素のうち、*formula* フォーミュラまたは *methodName* メソッドの結果が **true** になる要素をすべて格納した新しいコレクションを返します。この関数は ***シャロウ・コピー*** を返します。つまり、元のコレクションにオブジェクト要素やコレクション要素が含まれていた場合、それらの参照は戻り値のコレクションで共有されます。また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 > この関数は、元のコレクションを変更しません。 次のいずれかを使用して、コレクション要素をフィルターするために実行されるコールバックを指定します: @@ -1179,7 +1179,7 @@ $c2:=$c.extract("name";"City";"zc";"Zip") //$c2=[{Zip:35060},{City:null,Zip:3504 - *formula* (推奨シンタックス)、関数やプロジェクトメソッドを含むあらゆる実行可能な式を格納できる [Formula オブジェクト](FunctionClass.md)。 - または *methodName*、プロジェクトメソッドの名前 (テキスト)。 -コールバックには、オブジェクトが 1番目の引数 (*$1*) として渡され、任意の *param* 引数がその後に続きます。 引数の有無にかかわらず、コールバックは任意のテストを実行でき、条件を満たす要素に対しては **true** を返すことで、新規コレクションにプッシュします。 +コールバックには、オブジェクトが 1番目の引数 (*$1*) として渡され、任意の *param* 引数がその後に続きます。引数の有無にかかわらず、コールバックは任意のテストを実行でき、条件を満たす要素に対しては **true** を返すことで、新規コレクションにプッシュします。 コールバックは以下の引数を受け取ります: @@ -1190,7 +1190,7 @@ $c2:=$c.extract("name";"City";"zc";"Zip") //$c2=[{Zip:35060},{City:null,Zip:3504 また、コールバックは以下のパラメーターを設定できます: * *$1.result* (ブール): 要素の値がフィルター条件に合致する場合には **true** 、それ以外は **false**。 -* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。 返された値は最後に計算されたものです。 +* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。返された値は最後に計算されたものです。 :::note @@ -1284,7 +1284,7 @@ var $diff:=$c1.filter(Formula(Not($c2.includes($1.value)))) - *formula* (推奨シンタックス)、関数やプロジェクトメソッドを含むあらゆる実行可能な式を格納できる [Formula オブジェクト](FunctionClass.md)。 - または *methodName*、プロジェクトメソッドの名前 (テキスト)。 -コールバックには、*param* (任意) に指定した引数が渡されます。 コールバックには、*param* (任意) に指定した引数が渡されます。 コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 +コールバックには、*param* (任意) に指定した引数が渡されます。コールバックには、*param* (任意) に指定した引数が渡されます。コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 コールバックは以下の引数を受け取ります: @@ -1295,13 +1295,13 @@ var $diff:=$c1.filter(Formula(Not($c2.includes($1.value)))) また、コールバックは以下のパラメーターを設定できます: * (メソッドを使用する場合は必須) *$1.result* (ブール): 要素の値が検索条件に合致する場合には **true** 、それ以外は **false**。 -* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。 返された値は最後に計算されたものです。 +* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。返された値は最後に計算されたものです。 -デフォルトでは、`.find()` はコレクション全体をテストします。 任意で、*startFrom* に検索を開始する要素のインデックスを渡すこともできます。 +デフォルトでは、`.find()` はコレクション全体をテストします。任意で、*startFrom* に検索を開始する要素のインデックスを渡すこともできます。 * *startFrom* がコレクションの length 以上だった場合、-1 が返されます。これはコレクションが検索されていないことを意味します。 -* *startFrom* < 0 の場合には、コレクションの終わりからのオフセットであるとみなされます(*startFrom:=startFrom+length*)。 **注:** *startFrom* が負の値であっても、コレクションは左から右へと検索されます。 +* *startFrom* < 0 の場合には、コレクションの終わりからのオフセットであるとみなされます(*startFrom:=startFrom+length*)。**注:** *startFrom* が負の値であっても、コレクションは左から右へと検索されます。 * *startFrom* = 0 の場合、コレクション全体がテストされます (デフォルト)。 @@ -1378,7 +1378,7 @@ $c2:=$c.find(Formula($1.value.name=$2); "Clanton") //$c2={name:Clanton,zc:35046 - *formula* (推奨シンタックス)、関数やプロジェクトメソッドを含むあらゆる実行可能な式を格納できる [Formula オブジェクト](FunctionClass.md)。 - *methodName*、プロジェクトメソッドの名前 (テキスト)。 -コールバックには、*param* (任意) に指定した引数が渡されます。 コールバックには、*param* (任意) に指定した引数が渡されます。 コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 +コールバックには、*param* (任意) に指定した引数が渡されます。コールバックには、*param* (任意) に指定した引数が渡されます。コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 コールバックは以下の引数を受け取ります: @@ -1389,12 +1389,12 @@ $c2:=$c.find(Formula($1.value.name=$2); "Clanton") //$c2={name:Clanton,zc:35046 また、コールバックは以下のパラメーターを設定できます: * (メソッドを使用する場合は必須) *$1.result* (ブール): 要素の値が検索条件に合致する場合には **true** 、それ以外は **false**。 -* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。 返された値は最後に計算されたものです。 +* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。返された値は最後に計算されたものです。 -デフォルトでは、`.findIndex()` はコレクション全体をテストします。 任意で、*startFrom* に検索を開始する要素のインデックスを渡すこともできます。 +デフォルトでは、`.findIndex()` はコレクション全体をテストします。任意で、*startFrom* に検索を開始する要素のインデックスを渡すこともできます。 * *startFrom* がコレクションの length 以上だった場合、-1 が返されます。これはコレクションが検索されていないことを意味します。 -* *startFrom* < 0 の場合には、コレクションの終わりからのオフセットであるとみなされます(*startFrom:=startFrom+length*)。 **注:** *startFrom* が負の値であっても、コレクションは左から右へと検索されます。 +* *startFrom* < 0 の場合には、コレクションの終わりからのオフセットであるとみなされます(*startFrom:=startFrom+length*)。**注:** *startFrom* が負の値であっても、コレクションは左から右へと検索されます。 * *startFrom* = 0 の場合、コレクション全体がテストされます (デフォルト)。 #### 例題 @@ -1486,7 +1486,7 @@ $first:=$emptyCol.first() // このコードは undefined を返します |引数|型||説明| |---------|--- |:---:|------| -|depth|Integer |->|ネストされたコレクションの階層をどの範囲まで平坦化するか。 デフォルト = 1| +|depth|Integer |->|ネストされたコレクションの階層をどの範囲まで平坦化するか。デフォルト = 1| |戻り値|Collection |<-|Flattened collection| @@ -1552,7 +1552,7 @@ $col.flat(MAXLONG) #### 説明 -`.fill()` 関数は、 コレクションを *value* 引数の値で満たし、同コレクションを返します。。 オプションとして、*startFrom* および *end* インデックスを渡して代入開始位置および終了位置を指定することもできます +`.fill()` 関数は、 コレクションを *value* 引数の値で満たし、同コレクションを返します。。オプションとして、*startFrom* および *end* インデックスを渡して代入開始位置および終了位置を指定することもできます この機能は、[`map()`](#map) の呼び出し後に、depth = 1 で [`flat()`](#flat) を呼び出すのと同じです。 > この関数は、元のコレクションを変更しません。 @@ -1563,7 +1563,7 @@ $col.flat(MAXLONG) - *formula* (推奨シンタックス)、関数やプロジェクトメソッドを含むあらゆる実行可能な式を格納できる [Formula オブジェクト](FunctionClass.md)。 - または *methodName*、プロジェクトメソッドの名前 (テキスト)。 -コールバックには、*param* (任意) に指定した引数が渡されます。 コールバックには、*param* (任意) に指定した引数が渡されます。 コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 +コールバックには、*param* (任意) に指定した引数が渡されます。コールバックには、*param* (任意) に指定した引数が渡されます。コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 コールバックは以下の引数を受け取ります: @@ -1574,7 +1574,7 @@ $col.flat(MAXLONG) また、コールバックは以下のパラメーターを設定できます: * (メソッドを使用した場合は必須) *$1.result* (任意の型): 結果のコレクションに追加する、変換された値 -* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。 返された値は最後に計算されたものです。 +* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。返された値は最後に計算されたものです。 #### 例題 1 @@ -1652,7 +1652,7 @@ $c2:=$c.flatMap($f; $c.sum()) `.includes()` 関数は、 *toSearch* に指定した式がコレクション内で見つかれば true を、そうでなければ false を返します。 > この関数は、元のコレクションを変更しません。 -*toSearch* パラメーターには、コレクション内で検索する式を渡します。 以下のものを渡すことができます: +*toSearch* パラメーターには、コレクション内で検索する式を渡します。以下のものを渡すことができます: * スカラー値 (テキスト、数値、ブール、日付) * null 値 @@ -1720,7 +1720,7 @@ $c2:=$c.flatMap($f; $c.sum()) `.indexOf()` 関数は、 *toSearch* 引数の式をコレクション要素の中から検索し、最初に見つかった要素のインデックス (見つからなかった場合には -1) を返します。 > この関数は、元のコレクションを変更しません。 -*toSearch* パラメーターには、コレクション内で検索する式を渡します。 以下のものを渡すことができます: +*toSearch* パラメーターには、コレクション内で検索する式を渡します。以下のものを渡すことができます: * スカラー値 (テキスト、数値、ブール、日付) * null 値 @@ -1731,7 +1731,7 @@ $c2:=$c.flatMap($f; $c.sum()) オプションとして、*startFrom* 引数を渡すことで、検索を開始するコレクション要素のインデックスを指定することができます。 * *startFrom* がコレクションの length 以上だった場合、-1 が返されます。これはコレクションが検索されていないことを意味します。 -* *startFrom* < 0 の場合には、コレクションの終わりからのオフセットであるとみなされます(*startFrom:=startFrom+length*)。 **注:** *startFrom* が負の値であっても、コレクションは左から右へと検索されます。 +* *startFrom* < 0 の場合には、コレクションの終わりからのオフセットであるとみなされます(*startFrom:=startFrom+length*)。**注:** *startFrom* が負の値であっても、コレクションは左から右へと検索されます。 * *startFrom* = 0 の場合、コレクション全体がテストされます (デフォルト)。 #### 例題 @@ -1778,7 +1778,7 @@ $c2:=$c.flatMap($f; $c.sum()) #### 説明 -`.indices()` 関数は [`.query()`](#query) 関数と同様に機能しますが、 *queryString* 引数の検索条件に合致する、元のコレクション要素のインデックスを返します(コレクション要素自体は返しません)。 インデックスは、昇順に返されます。 +`.indices()` 関数は [`.query()`](#query) 関数と同様に機能しますが、 *queryString* 引数の検索条件に合致する、元のコレクション要素のインデックスを返します(コレクション要素自体は返しません)。インデックスは、昇順に返されます。 > この関数は、元のコレクションを変更しません。 *queryString* 引数には、以下のシンタックスを使用します: @@ -1897,7 +1897,7 @@ propertyPath 比較演算子 値 {logicalOperator propertyPath 比較演算子 `.join()` 関数は、 *delimiter* に渡した文字列を区切り文字として、コレクションの全要素を一つの文字列につなげます。戻り値はつなげられた文字列です。 > この関数は、元のコレクションを変更しません。 -デフォルトで、コレクションの null あるいは空の要素も戻り値の文字列に含めます。 これらを戻り値の文字列に含めたくない場合は、*option* パラメーターに `ck ignore null or empty` 定数を渡します。 +デフォルトで、コレクションの null あるいは空の要素も戻り値の文字列に含めます。これらを戻り値の文字列に含めたくない場合は、*option* パラメーターに `ck ignore null or empty` 定数を渡します。 #### 例題 @@ -1998,7 +1998,7 @@ $last:=$emptyCol.last() // このコードは undefined を返します `.lastIndexOf()` 関数は、 *toSearch* 引数の式をコレクション要素の中から検索し、最後に見つかった要素のインデックスを返します(見つからなかった場合には -1)。 > この関数は、元のコレクションを変更しません。 -*toSearch* パラメーターには、コレクション内で検索する式を渡します。 以下のものを渡すことができます: +*toSearch* パラメーターには、コレクション内で検索する式を渡します。以下のものを渡すことができます: * スカラー値 (テキスト、数値、ブール、日付) * null 値 @@ -2009,7 +2009,7 @@ $last:=$emptyCol.last() // このコードは undefined を返します オプションとして、*startFrom* 引数を渡すことで、逆順検索を開始するコレクション要素のインデックスを指定することができます。 * *startFrom* が、コレクションの length から 1を引いた数字 (coll.length-1) 以上の場合、コレクション全体が検索されます (デフォルト)。 -* *startFrom* < 0 の場合、*startFrom:=startFrom+length* として再計算されます (コレクションの終端からのオフセットであるとみなされます)。 計算結果も負の値である場合、-1 が返されます。これはコレクションが検索されていないことを意味します。 **注:** *startFrom* が負の値であっても、コレクションは右から左へと検索されます。 +* *startFrom* < 0 の場合、*startFrom:=startFrom+length* として再計算されます (コレクションの終端からのオフセットであるとみなされます)。計算結果も負の値である場合、-1 が返されます。これはコレクションが検索されていないことを意味します。**注:** *startFrom* が負の値であっても、コレクションは右から左へと検索されます。 * *startFrom* = 0 の場合、-1 が返されます。これはコレクションが検索されていないことを意味します。 #### 例題 @@ -2050,7 +2050,7 @@ $last:=$emptyCol.last() // このコードは undefined を返します `.length` プロパティは、 コレクション内の要素数を返します。 -`.length` プロパティは、コレクション作成時に初期化されます。 要素を追加・削除すると、必要に応じて length は更新されます。 このプロパティは **読み取り専用** です (これを使用してコレクションのサイズを設定することはできません)。 +`.length` プロパティは、コレクション作成時に初期化されます。要素を追加・削除すると、必要に応じて length は更新されます。このプロパティは **読み取り専用** です (これを使用してコレクションのサイズを設定することはできません)。 #### 例題 @@ -2097,7 +2097,7 @@ $last:=$emptyCol.last() // このコードは undefined を返します #### 説明 -`.map()` 関数は、 `.map()` 関数は、。 オプションとして、*startFrom* および *end* インデックスを渡して代入開始位置および終了位置を指定することもできます `.map()` は常に、元のコレクションと同じサイズのコレクションを返します (*$1.stop* が使用された場合を除く (後述参照))。 +`.map()` 関数は、 `.map()` 関数は、。オプションとして、*startFrom* および *end* インデックスを渡して代入開始位置および終了位置を指定することもできます `.map()` は常に、元のコレクションと同じサイズのコレクションを返します (*$1.stop* が使用された場合を除く (後述参照))。 > この関数は、元のコレクションを変更しません。 @@ -2106,7 +2106,7 @@ $last:=$emptyCol.last() // このコードは undefined を返します - *formula* (推奨シンタックス)、関数やプロジェクトメソッドを含むあらゆる実行可能な式を格納できる [Formula オブジェクト](FunctionClass.md)。 - または *methodName*、プロジェクトメソッドの名前 (テキスト)。 -コールバックには、*param* (任意) に指定した引数が渡されます。 コールバックには、*param* (任意) に指定した引数が渡されます。 コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 +コールバックには、*param* (任意) に指定した引数が渡されます。コールバックには、*param* (任意) に指定した引数が渡されます。コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 コールバックは以下の引数を受け取ります: @@ -2117,7 +2117,7 @@ $last:=$emptyCol.last() // このコードは undefined を返します また、コールバックは以下のパラメーターを設定できます: * (メソッドを使用した場合は必須) *$1.result* (任意の型): 結果のコレクションに追加する、変換された値 -* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。 返された値は最後に計算されたものです。 +* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。返された値は最後に計算されたものです。 #### 例題 @@ -2278,16 +2278,16 @@ $c2:=$c.map(Formula(Round(($1.value/$2)*100; 2)); $c.sum()) .orderBy() 関数は、 コレクションの要素を指定順に並べ替えた新しいコレクションを返します。 -この関数は *シャロウ・コピー* を返します。つまり、元のコレクションにオブジェクト要素やコレクション要素が含まれていた場合、それらの参照は戻り値のコレクションで共有されます。 また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 +この関数は *シャロウ・コピー* を返します。つまり、元のコレクションにオブジェクト要素やコレクション要素が含まれていた場合、それらの参照は戻り値のコレクションで共有されます。また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 > この関数は、元のコレクションを変更しません。 -引数を渡さなかった場合、メソッドはコレクション内のスカラー値を昇順に並べ替えます (オブジェクトやコレクションなどの他の型は内部的な順序で返されます)。 この自動並べ替え順は、*ascOrDesc* パラメーターに `ck ascending` あるいは `ck descending` 定数を渡すことで変更できます (以下参照)。 +引数を渡さなかった場合、メソッドはコレクション内のスカラー値を昇順に並べ替えます (オブジェクトやコレクションなどの他の型は内部的な順序で返されます)。この自動並べ替え順は、*ascOrDesc* パラメーターに `ck ascending` あるいは `ck descending` 定数を渡すことで変更できます (以下参照)。 -また、引数を渡すことで、コレクション要素をどのように並べ替えるかを指定することもできます。 次の 3つのシンタックスがサポートされています: +また、引数を渡すことで、コレクション要素をどのように並べ替えるかを指定することもできます。次の 3つのシンタックスがサポートされています: -* *pathStrings* : Text (フォーミュラ)。 **シンタックス**: `propertyPath1 {desc または asc}, propertyPath2 {desc または asc},...` (デフォルトの並び順: asc)。 *pathStrings* はカンマで区切られた、1〜n のプロパティパスと並び順 (任意) で構成されたフォーミュラを格納します。 プロパティを渡す順番が、コレクション要素の並べ替えの優先順位を決定します。 デフォルトでは、プロパティは昇順に並べ替えられます。 並び順を設定するには、プロパティパスの後に半角スペースで区切ったあとに、昇順を指定するには "asc"、降順を指定するには "desc" を渡します。 +* *pathStrings* : Text (フォーミュラ)。**シンタックス**: `propertyPath1 {desc または asc}, propertyPath2 {desc または asc},...` (デフォルトの並び順: asc)。 *pathStrings* はカンマで区切られた、1〜n のプロパティパスと並び順 (任意) で構成されたフォーミュラを格納します。プロパティを渡す順番が、コレクション要素の並べ替えの優先順位を決定します。デフォルトでは、プロパティは昇順に並べ替えられます。並び順を設定するには、プロパティパスの後に半角スペースで区切ったあとに、昇順を指定するには "asc"、降順を指定するには "desc" を渡します。 -* *pathObjects* : Collection。 *pathObjects* コレクションには必要な数だけオブジェクトを追加することができます。 デフォルトでは、プロパティは昇順に並べ替えられます ("descending" は false)。 コレクションの各要素は、以下の構造を持つオブジェクトを格納します: +* *pathObjects* : Collection。 *pathObjects* コレクションには必要な数だけオブジェクトを追加することができます。デフォルトでは、プロパティは昇順に並べ替えられます ("descending" は false)。コレクションの各要素は、以下の構造を持つオブジェクトを格納します: ```4d { @@ -2306,7 +2306,7 @@ $c2:=$c.map(Formula(Round(($1.value/$2)*100; 2)); $c.sum()) このシンタックスは、コレクション内のスカラー値のみを並べ替えます (オブジェクトやコレクションなどの他の型は並べ替えされないまま返されます)。 -コレクションが異なる型の要素を格納している場合、それらはまず型ごとにグループ分けされ、そのあとで並べ替えられます。 型は以下の順番で返されます: +コレクションが異なる型の要素を格納している場合、それらはまず型ごとにグループ分けされ、そのあとで並べ替えられます。型は以下の順番で返されます: 1. null 2. ブール @@ -2425,7 +2425,7 @@ $c2:=$c.map(Formula(Round(($1.value/$2)*100; 2)); $c.sum()) `.orderByMethod()` 関数は、 `.orderByMethod()` 関数は、。 -この関数は *シャロウ・コピー* を返します。つまり、元のコレクションにオブジェクト要素やコレクション要素が含まれていた場合、それらの参照は戻り値のコレクションで共有されます。 また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 +この関数は *シャロウ・コピー* を返します。つまり、元のコレクションにオブジェクト要素やコレクション要素が含まれていた場合、それらの参照は戻り値のコレクションで共有されます。また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 > この関数は、元のコレクションを変更しません。 @@ -2435,7 +2435,7 @@ $c2:=$c.map(Formula(Round(($1.value/$2)*100; 2)); $c.sum()) - または *methodName*、プロジェクトメソッドの名前 (テキスト)。 -コールバックには、二つの値を比較して、最初の値が二つ目の値より低い場合に **true** を返すコードの名称を渡します。 必要に応じて、 *extraParam* に指定した引数をコールバックに渡せます。 +コールバックには、二つの値を比較して、最初の値が二つ目の値より低い場合に **true** を返すコードの名称を渡します。必要に応じて、 *extraParam* に指定した引数をコールバックに渡せます。 コールバックは以下の引数を受け取ります: @@ -2648,7 +2648,7 @@ $1.result:=(Compare strings($1.value;$1.value2;$2)<0) #### 説明 -`.query()` 関数は、 検索条件に合致するオブジェクトコレクションの要素をすべて返します 。検索条件は、*queryString* および、任意の *value* や *querySettings* パラメーターによって定義されます。 また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 +`.query()` 関数は、 検索条件に合致するオブジェクトコレクションの要素をすべて返します 。検索条件は、*queryString* および、任意の *value* や *querySettings* パラメーターによって定義されます。また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 > この関数は、元のコレクションを変更しません。 *queryString* 引数には、以下のシンタックスを使用します: @@ -2771,7 +2771,7 @@ propertyPath 比較演算子 値 {logicalOperator propertyPath 比較演算子 コールバックはコレクションの各要素を受け取り、任意の処理を実行して、結果を *$1.accumulator* に蓄積します。この値は最終的に *$1.value* に返されます。 -*initValue* に引数を渡すことで、アキュムレーターを初期化することができます。 省略された場合は、*$1.accumulator* は *Undefined* から開始されます。 +*initValue* に引数を渡すことで、アキュムレーターを初期化することができます。省略された場合は、*$1.accumulator* は *Undefined* から開始されます。 コールバックは以下の引数を受け取ります: @@ -2782,7 +2782,7 @@ propertyPath 比較演算子 値 {logicalOperator propertyPath 比較演算子 コールバックは以下の引数を受け取ります: * *$1.accumulator*: メソッドで変更する値。*initValue* によって初期化します。 -* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。 返された値は最後に計算されたものです。 +* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。返された値は最後に計算されたものです。 #### 例題 1 @@ -2865,7 +2865,7 @@ $r:=$c.reduce(Formula($1.accumulator=$1.value); 1) // 86400 を返す コールバックはコレクションの各要素を受け取り、任意の処理を実行して、結果を *$1.accumulator* に蓄積します。この値は最終的に *$1.value* に返されます。 -*initValue* に引数を渡すことで、アキュムレーターを初期化することができます。 省略された場合は、*$1.accumulator* は *Undefined* から開始されます。 +*initValue* に引数を渡すことで、アキュムレーターを初期化することができます。省略された場合は、*$1.accumulator* は *Undefined* から開始されます。 コールバックは以下の引数を受け取ります: @@ -2876,7 +2876,7 @@ $r:=$c.reduce(Formula($1.accumulator=$1.value); 1) // 86400 を返す コールバックは以下の引数を受け取ります: * *$1.accumulator*: メソッドで変更する値。*initValue* によって初期化します。 -* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。 返された値は最後に計算されたものです。 +* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。返された値は最後に計算されたものです。 #### 例題 1 @@ -2953,7 +2953,7 @@ $r:=$c.reduceRight(Formula($1.accumulator=$1.value); 1) // 86400 を返す > このコマンドは、元のコレクションを変更します。 *index* パラメーターには、削除するコレクション要素の位置を渡します。 -> **警告**: コレクション要素は 0 起点である点に注意してください。 指定した *index* がコレクションの length より大きい場合、実際の開始インデックスはコレクションの length に設定されます。 +> **警告**: コレクション要素は 0 起点である点に注意してください。指定した *index* がコレクションの length より大きい場合、実際の開始インデックスはコレクションの length に設定されます。 * *index* < 0 の場合、*index:=index+length* として再計算されます (コレクションの終端からのオフセットであるとみなされます)。 * 計算結果も負の値である場合、*index* は 0 に設定されます。 @@ -3076,7 +3076,7 @@ $r:=$c.reduceRight(Formula($1.accumulator=$1.value); 1) // 86400 を返す #### 説明 -`.reverse()` 関数は、 `.reverse()` 関数は、。 また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 +`.reverse()` 関数は、 `.reverse()` 関数は、。また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 > この関数は、元のコレクションを変更しません。 #### 例題 @@ -3173,7 +3173,7 @@ $r:=$c.reduceRight(Formula($1.accumulator=$1.value); 1) // 86400 を返す #### 説明 -`.slice()` 関数は、 コレクションの一部を、新しいコレクションとして返します。抜粋するのは、*startFrom* の位置 (含まれる) から *end* の位置 (含まれない) までの要素です。 この関数は *シャロウ・コピー* を返します。 また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 +`.slice()` 関数は、 コレクションの一部を、新しいコレクションとして返します。抜粋するのは、*startFrom* の位置 (含まれる) から *end* の位置 (含まれない) までの要素です。この関数は *シャロウ・コピー* を返します。また、元のコレクションが共有コレクションであった場合、返されるコレクションもまた共有コレクションになります。 > この関数は、元のコレクションを変更しません。 戻り値のコレクションには、*startFrom* 引数で指定した要素 (含まれる) から、*end* 引数で指定した要素まで (含まれない) の全要素が格納されます。 *startFrom* 引数のみを渡した場合には、*startFrom* 引数で指定した要素から最後の要素までが戻り値のコレクションに格納されます。 @@ -3239,7 +3239,7 @@ $r:=$c.reduceRight(Formula($1.accumulator=$1.value); 1) // 86400 を返す - *formula* (推奨シンタックス)、関数やプロジェクトメソッドを含むあらゆる実行可能な式を格納できる [Formula オブジェクト](FunctionClass.md)。 - または *methodName*、プロジェクトメソッドの名前 (テキスト)。 -コールバックには、*param* (任意) に指定した引数が渡されます。 引数の有無にかかわらず、コールバックは任意のテストを実行でき、テストを満たす要素に対しては **true** を返さなくてはなりません。 コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 +コールバックには、*param* (任意) に指定した引数が渡されます。引数の有無にかかわらず、コールバックは任意のテストを実行でき、テストを満たす要素に対しては **true** を返さなくてはなりません。コールバックは最初のパラメーター ($1) に `Object` を受け取ります。 コールバックは以下の引数を受け取ります: @@ -3251,11 +3251,11 @@ $r:=$c.reduceRight(Formula($1.accumulator=$1.value); 1) // 86400 を返す また、コールバックは以下のパラメーターを設定できます: * (メソッドを使用する場合は必須) *$1.result* (ブール): 要素の値の評価が成功した場合には **true** 、それ以外は **false** -* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。 返された値は最後に計算されたものです。 +* *$1.stop* (ブール、任意): メソッドコールバックを止める場合には **true**。返された値は最後に計算されたものです。 `.some()` 関数は、true を返す最初のコレクション要素を発見すると、コールバックの呼び出しをやめて **true** を返します。 -デフォルトでは、`.some()` はコレクション全体をテストします。 オプションとして、*startFrom* 引数を渡すことで、テストを開始するコレクション要素のインデックスを指定することができます。 +デフォルトでは、`.some()` はコレクション全体をテストします。オプションとして、*startFrom* 引数を渡すことで、テストを開始するコレクション要素のインデックスを指定することができます。 * *startFrom* がコレクションの length 以上だった場合、**false** が返されます。これはコレクションがテストされていないことを意味します。 * *startFrom* < 0 の場合には、コレクションの終わりからのオフセットであるとみなされます。 @@ -3323,7 +3323,7 @@ $r:=$c.reduceRight(Formula($1.accumulator=$1.value); 1) // 86400 を返す `.sort()` 関数は、 `.sort()` 関数は、 。 > このコマンドは、元のコレクションを変更します。 -引数もなしに呼び出された場合、`.sort()` はスカラー値 (数値、テキスト、日付、ブール) のみを並べ替えます。 デフォルトでは、要素はそれぞれの型に応じて昇順で並べ替えられます。 *ascOrDesc* 引数には、以下の定数のいずれか一つを渡すことができます: +引数もなしに呼び出された場合、`.sort()` はスカラー値 (数値、テキスト、日付、ブール) のみを並べ替えます。デフォルトでは、要素はそれぞれの型に応じて昇順で並べ替えられます。 *ascOrDesc* 引数には、以下の定数のいずれか一つを渡すことができます: |定数| 型|値|詳細| |---|---|---|---| @@ -3332,7 +3332,7 @@ $r:=$c.reduceRight(Formula($1.accumulator=$1.value); 1) // 86400 を返す このシンタックスはコレクション内のスカラー値のみを並び替えます(オブジェクトやコレクションなどの他の型の要素は並べ替えされません)。 - コレクションが異なる型の要素を格納している場合、それらはまず型ごとにグループ分けされ、そのあとで並べ替えられます。 型は以下の順番で返されます: + コレクションが異なる型の要素を格納している場合、それらはまず型ごとにグループ分けされ、そのあとで並べ替えられます。型は以下の順番で返されます: 1. null 2. ブール @@ -3343,7 +3343,7 @@ $r:=$c.reduceRight(Formula($1.accumulator=$1.value); 1) // 86400 を返す 7. 日付 -カスタマイズされた順番や、型に関係なくコレクション要素を並べ替えたい場合には、並べ替え順を定義するコールバックを *formula* ([Formula オブジェクト](FunctionClass.md)) または *methodName* (テキスト) に渡します。 戻り値は、二つの要素の相対的な順番を示すブール値です。 *$1.value* が *$1.value2* より小さい場合に **true** を、*$1.value* が *$1.value2* より大きい場合に **false** を返します。 必要に応じて、 追加の引数をコールバックに渡せます。 +カスタマイズされた順番や、型に関係なくコレクション要素を並べ替えたい場合には、並べ替え順を定義するコールバックを *formula* ([Formula オブジェクト](FunctionClass.md)) または *methodName* (テキスト) に渡します。戻り値は、二つの要素の相対的な順番を示すブール値です。 *$1.value* が *$1.value2* より小さい場合に **true** を、*$1.value* が *$1.value2* より大きい場合に **false** を返します。必要に応じて、 追加の引数をコールバックに渡せます。 コールバックは以下の引数を受け取ります: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md index 95d681c1536c06..3457eee7458b92 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md @@ -50,23 +50,23 @@ title: DataClass 返される属性オブジェクトには以下のプロパティが格納されています: -| プロパティ | 型 | 説明 | -| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| autoFilled | Boolean | 属性値が 4D によって自動生成される場合に true です。 このプロパティは次の 4Dフィールドプロパティに対応しています: 数値型フィールドの "自動インクリメント" および UUID (文字型)フィールドの "自動UUID"。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | -| exposed | Boolean | 属性が REST で公開されている場合に trueです | -| fieldNumber | integer | 属性の内部的な 4Dフィールド番号。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | -| fieldType | Integer | 属性の 4Dデータベースフィールドタイプ。 これは属性の種類 (`kind`) によります。 とりうる値:
  • `.kind` = "storage" の場合は、対応する 4Dフィールドタイプ ([`Value type`](https://doc.4d.com/4dv20/help/command/ja/page1509.html) 参照)
  • `.kind` = "relatedEntity" の場合: 38 (`is object`)
  • `.kind` = "relatedEntities" の場合: 42 (`is collection`)
  • `.kind` = "calculated" または "alias" の場合: 結果の値 (フィールドタイプ、relatedEntity または relatedEntities) に応じて、上に同じ
    • | -| indexed | Boolean | 属性に対して B-tree もしくは クラスターB-Tree インデックスが設定されている場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | -| inverseName | Text | リレーション先の属性名。 `.kind` = "relatedEntity" または "relatedEntities" の場合にのみ返されます。 | -| keywordIndexed | Boolean | 属性にキーワードインデックスが存在すれば true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | -| kind | Text | 属性の種類。 とりうる値:
  • "storage": ストレージ (あるいはスカラー) 属性。 つまり、属性は値を保存しており、他の属性への参照ではありません。
  • "calculated": 計算属性。 [`get` 関数](../ORDA/ordaClasses.md#function-get-attributename) によって定義されます。
  • "alias": [他の属性](../ORDA/ordaClasses.md#エイリアス属性-1) を指し示す属性。
  • "relatedEntity": N対1 リレーション属性 (エンティティへの参照)
  • "relatedEntities": 1対N リレーション属性 (エンティティセレクションへの参照)
    • | -| 必須 | Boolean | 属性において Null値の入力が拒否されている場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 注記: このプロパティは、4Dデータベースレベルの "Null値の入力を拒否" フィールドプロパティと対応しています。 フィールドのデータ入力制御オプションである既存の "必須入力" プロパティとは無関係です。 | -| name | Text | 属性名 (文字列) | -| path | Text | リレーションに基づく [エイリアス属性](../ORDA/ordaClasses.md#エイリアス属性-1) のパス。 | -| readOnly | Boolean | 読み取り専用属性の場合に trueです。 たとえば、[`set` 関数](../ORDA/ordaClasses.md#function-set-attributename) を持たない計算属性は読み取り専用です。 | -| relatedDataClass | Text | 属性にリレートされているデータクラスの名称。 `.kind` = "relatedEntity" または "relatedEntities" の場合にのみ返されます。 | -| type | Text | 属性の概念的な値タイプ。 汎用的なプログラミングに有用です。 これは属性の種類 (`kind`) によります。 とりうる値:
  • `.kind` = "storage" の場合: "blob", "bool", "date", "image", "number", "object", または "string"。 時間を含め、数値型の場合は "number" が返されます; UUID、文字列、テキスト型属性の場合は "string" が返されます; [BLOBオブジェクト](../Concepts/dt_blob.md#blob-types) の場合は "blob" が返されます。
  • `.kind` = "relatedEntity" の場合: リレートされたデータクラス名
  • `.kind` = "relatedEntities" の場合: リレートされたデータクラス名 + "Selection" 接尾辞
  • `.kind` = "calculated" または "alias" の場合: 結果の値に応じて、上に同じ
    • | -| unique | Boolean | 属性値が重複不可の場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | +| プロパティ | 型 | 説明 | +| ---------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| autoFilled | Boolean | 属性値が 4D によって自動生成される場合に true です。このプロパティは次の 4Dフィールドプロパティに対応しています: 数値型フィールドの "自動インクリメント" および UUID (文字型)フィールドの "自動UUID"。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | +| exposed | Boolean | 属性が REST で公開されている場合に trueです | +| fieldNumber | integer | 属性の内部的な 4Dフィールド番号。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | +| fieldType | Integer | 属性の 4Dデータベースフィールドタイプ。これは属性の種類 (`kind`) によります。とりうる値:
  • `.kind` = "storage" の場合は、対応する 4Dフィールドタイプ ([`Value type`](https://doc.4d.com/4dv20/help/command/ja/page1509.html) 参照)
  • `.kind` = "relatedEntity" の場合: 38 (`is object`)
  • `.kind` = "relatedEntities" の場合: 42 (`is collection`)
  • `.kind` = "calculated" または "alias" の場合: 結果の値 (フィールドタイプ、relatedEntity または relatedEntities) に応じて、上に同じ
    • | +| indexed | Boolean | 属性に対して B-tree もしくは クラスターB-Tree インデックスが設定されている場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | +| inverseName | Text | リレーション先の属性名。 `.kind` = "relatedEntity" または "relatedEntities" の場合にのみ返されます。 | +| keywordIndexed | Boolean | 属性にキーワードインデックスが存在すれば true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | +| kind | Text | 属性の種類。とりうる値:
  • "storage": ストレージ (あるいはスカラー) 属性。 つまり、属性は値を保存しており、他の属性への参照ではありません。
  • "calculated": 計算属性。 [`get` 関数](../ORDA/ordaClasses.md#function-get-attributename) によって定義されます。
  • "alias": [他の属性](../ORDA/ordaClasses.md#エイリアス属性-1) を指し示す属性。
  • "relatedEntity": N対1 リレーション属性 (エンティティへの参照)
  • "relatedEntities": 1対N リレーション属性 (エンティティセレクションへの参照)
    • | +| 必須 | Boolean | 属性において Null値の入力が拒否されている場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。注記: このプロパティは、4Dデータベースレベルの "Null値の入力を拒否" フィールドプロパティと対応しています。フィールドのデータ入力制御オプションである既存の "必須入力" プロパティとは無関係です。 | +| name | Text | 属性名 (文字列) | +| path | Text | リレーションに基づく [エイリアス属性](../ORDA/ordaClasses.md#エイリアス属性-1) のパス。 | +| readOnly | Boolean | 読み取り専用属性の場合に trueです。たとえば、[`set` 関数](../ORDA/ordaClasses.md#function-set-attributename) を持たない計算属性は読み取り専用です。 | +| relatedDataClass | Text | 属性にリレートされているデータクラスの名称。 `.kind` = "relatedEntity" または "relatedEntities" の場合にのみ返されます。 | +| type | Text | 属性の概念的な値タイプ。 汎用的なプログラミングに有用です。これは属性の種類 (`kind`) によります。とりうる値:
  • `.kind` = "storage" の場合: "blob", "bool", "date", "image", "number", "object", または "string"。時間を含め、数値型の場合は "number" が返されます; UUID、文字列、テキスト型属性の場合は "string" が返されます; [BLOBオブジェクト](../Concepts/dt_blob.md#blob-types) の場合は "blob" が返されます。
  • `.kind` = "relatedEntity" の場合: リレートされたデータクラス名
  • `.kind` = "relatedEntities" の場合: リレートされたデータクラス名 + "Selection" 接尾辞
  • `.kind` = "calculated" または "alias" の場合: 結果の値に応じて、上に同じ
    • | +| unique | Boolean | 属性値が重複不可の場合に true です。 `.kind` が "relatedEntity" または "relatedEntities" の場合には、このプロパティは返されません。 | :::tip @@ -148,7 +148,7 @@ var $firstnameAtt;$employerAtt;$employeesAtt : Object `.all()` 関数は データストアをクエリして、データクラスの全エンティティをエンティティセレクションとして返します。 -エンティティはデフォルトの順番で返され、通常は作成順になっています。 ただし、エンティティ削除後に新規追加した場合には、デフォルトの順番は作成順を反映しない点に留意が必要です。 +エンティティはデフォルトの順番で返され、通常は作成順になっています。ただし、エンティティ削除後に新規追加した場合には、デフォルトの順番は作成順を反映しない点に留意が必要です。 エンティティが見つからない場合、空のエンティティセレクションが返されます。 @@ -156,11 +156,11 @@ var $firstnameAtt;$employerAtt;$employeesAtt : Object **settings** -任意の *settings* パラメーターには、追加オプションを格納したオブジェクトを渡すことができます。 以下のプロパティがサポートされています: +任意の *settings* パラメーターには、追加オプションを格納したオブジェクトを渡すことができます。以下のプロパティがサポートされています: -| プロパティ | 型 | 説明 | -| ------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| context | Text | エンティティセレクションに適用されている最適化コンテキストのラベル。 エンティティセレクションを扱うコードはこのコンテキストを使うことで最適化の恩恵を受けます。 [ORDA クライアントサーバー通信](../ORDA/remoteDatastores.md#クライアントサーバーの最適化)で使用することができます。 | +| プロパティ | 型 | 説明 | +| ------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| context | Text | エンティティセレクションに適用されている最適化コンテキストのラベル。エンティティセレクションを扱うコードはこのコンテキストを使うことで最適化の恩恵を受けます。 [ORDA クライアントサーバー通信](../ORDA/remoteDatastores.md#クライアントサーバーの最適化)で使用することができます。 | > データクラス内の総エンティティ数を知るには、`ds.myClass.all().length` 式よりも最適化された [`getCount()`](#getcount) 関数を使用することが推奨されます。 @@ -257,23 +257,23 @@ $ds.Persons.clearRemoteCache() `.fromCollection()` 関数は、 *objectCol* 引数のオブジェクトのコレクションに基づいてデータクラスのエンティティを更新あるいは作成し、対応するエンティティセレクションを返します。 -*objectCol* パラメーターには、データクラスの既存エンティティを更新、または新規エンティティを作成するためのオブジェクトのコレクションを渡します。 プロパティ名は、データクラスの属性名と同一である必要があります。 プロパティ名がデータクラスに存在しない場合、それは無視されます。 コレクション内で属性値が定義されていない場合、その値は null になります。 +*objectCol* パラメーターには、データクラスの既存エンティティを更新、または新規エンティティを作成するためのオブジェクトのコレクションを渡します。プロパティ名は、データクラスの属性名と同一である必要があります。プロパティ名がデータクラスに存在しない場合、それは無視されます。コレクション内で属性値が定義されていない場合、その値は null になります。 -コレクションのオブジェクト要素とエンティティのマッピングは、**属性名** と **型の合致** をもって行われます。 オブジェクトプロパティがエンティティ属性と同じ名前であっても、型が合致しない場合には、エンティティの属性は空のままです。 +コレクションのオブジェクト要素とエンティティのマッピングは、**属性名** と **型の合致** をもって行われます。オブジェクトプロパティがエンティティ属性と同じ名前であっても、型が合致しない場合には、エンティティの属性は空のままです。 **作成モードと更新モード** *objectCol* 引数の各オブジェクトついて: -* オブジェクトがブール型の "\_\_NEW" プロパティを含み、それが **false** に設定されている場合(あるいは "\_\_NEW" プロパティが含まれていない場合)、オブジェクトの対応する値でエンティティが更新あるいは作成されます。 プライマリーキーに関するチェックはおこなわれません: - * プライマリーキーが指定されていて実在する場合、エンティティは更新されます。 この場合、プライマリーキーはそのまま、あるいは "\_\_KEY" プロパティを (プライマリーキー値とともに) 使って指定することができます。 +* オブジェクトがブール型の "\_\_NEW" プロパティを含み、それが **false** に設定されている場合(あるいは "\_\_NEW" プロパティが含まれていない場合)、オブジェクトの対応する値でエンティティが更新あるいは作成されます。プライマリーキーに関するチェックはおこなわれません: + * プライマリーキーが指定されていて実在する場合、エンティティは更新されます。この場合、プライマリーキーはそのまま、あるいは "\_\_KEY" プロパティを (プライマリーキー値とともに) 使って指定することができます。 * そのまま指定したプライマリーキーが実在しない場合、エンティティは作成されます。 * プライマリーキーを指定していない場合、エンティティは作成され、標準のデータベースのルールに基づいてプライマリーキー値が割り当てられます。 -* オブジェクトがブール型の "\_\_NEW" プロパティを含み、それが **true** に設定されている場合、オブジェクトの対応する値でエンティティが作成されます。 プライマリーキーに関するチェックがおこなわれます: +* オブジェクトがブール型の "\_\_NEW" プロパティを含み、それが **true** に設定されている場合、オブジェクトの対応する値でエンティティが作成されます。プライマリーキーに関するチェックがおこなわれます: * そのまま指定したプライマリーキーが実在する場合、エラーが返されます。 * そのまま指定したプライマリーキーが実在しない場合、エンティティは作成されます。 * プライマリーキーを指定していない場合、エンティティは作成され、標準のデータベースのルールに基づいてプライマリーキー値が割り当てられます。 -> プライマリーキーを指定していない場合、エンティティは作成され、標準のデータベースのルールに基づいてプライマリーキー値が割り当てられます。 > 値を持つ "\_\_KEY" プロパティは、"\_\_NEW" プロパティが **false** に設定 (あるいは省略) されていて、かつ対応するエンティティが存在する場合のみ、考慮されます。 それ以外の場合には、"\_\_KEY" プロパティ値は無視されるため、プライマリーキーの値はそのまま渡さなければなりません。 +> プライマリーキーを指定していない場合、エンティティは作成され、標準のデータベースのルールに基づいてプライマリーキー値が割り当てられます。 > 値を持つ "\_\_KEY" プロパティは、"\_\_NEW" プロパティが **false** に設定 (あるいは省略) されていて、かつ対応するエンティティが存在する場合のみ、考慮されます。それ以外の場合には、"\_\_KEY" プロパティ値は無視されるため、プライマリーキーの値はそのまま渡さなければなりません。 **リレートエンティティ** @@ -284,15 +284,15 @@ $ds.Persons.clearRemoteCache() **スタンプ** -"\_\_STAMP" プロパティが指定された場合、データストアのスタンプとのチェックがおこなわれ、エラーが返されることがあります ("与えられたスタンプはテーブルXXX のレコード# XXのカレントのものと合致しません")。 詳細については [エンティティロッキング](ORDA/entities.md#エンティティロッキング) を参照ください。 +"\_\_STAMP" プロパティが指定された場合、データストアのスタンプとのチェックがおこなわれ、エラーが返されることがあります ("与えられたスタンプはテーブルXXX のレコード# XXのカレントのものと合致しません")。詳細については [エンティティロッキング](ORDA/entities.md#エンティティロッキング) を参照ください。 **settings** -任意の *settings* パラメーターには、追加オプションを格納したオブジェクトを渡すことができます。 以下のプロパティがサポートされています: +任意の *settings* パラメーターには、追加オプションを格納したオブジェクトを渡すことができます。以下のプロパティがサポートされています: -| プロパティ | 型 | 説明 | -| ------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| context | Text | エンティティセレクションに適用されている最適化コンテキストのラベル。 エンティティセレクションを扱うコードはこのコンテキストを使うことで最適化の恩恵を受けます。 [ORDA クライアントサーバー通信](../ORDA/remoteDatastores.md#クライアントサーバーの最適化)で使用することができます。 | +| プロパティ | 型 | 説明 | +| ------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| context | Text | エンティティセレクションに適用されている最適化コンテキストのラベル。エンティティセレクションを扱うコードはこのコンテキストを使うことで最適化の恩恵を受けます。 [ORDA クライアントサーバー通信](../ORDA/remoteDatastores.md#クライアントサーバーの最適化)で使用することができます。 | #### 例題 1 @@ -457,7 +457,7 @@ $ds.Persons.clearRemoteCache() `.get()` 関数は データクラスをクエリして、*primaryKey* に渡したプライマリーキーに合致するエンティティを返します。 -*primaryKey* には、取得したいエンティティのプライマリーキーの値を渡します。 値の型は、データストアで設定されたプライマリーキーの型 (倍長整数あるいはテキスト) と合致している必要があります。 [`.getKey()`](EntityClass.md#getkey) 関数に `dk key as string` 引数を渡すと、プライマリーキーの値が常にテキスト型で返されるように指定することができます。 +*primaryKey* には、取得したいエンティティのプライマリーキーの値を渡します。値の型は、データストアで設定されたプライマリーキーの型 (倍長整数あるいはテキスト) と合致している必要があります。 [`.getKey()`](EntityClass.md#getkey) 関数に `dk key as string` 引数を渡すと、プライマリーキーの値が常にテキスト型で返されるように指定することができます。 *primaryKey* 引数のプライマリーキーを持つエンティティが見つからない場合、**Null** エンティティが返されます。 @@ -465,15 +465,15 @@ $ds.Persons.clearRemoteCache() **settings** -任意の *settings* パラメーターには、追加オプションを格納したオブジェクトを渡すことができます。 以下のプロパティがサポートされています: +任意の *settings* パラメーターには、追加オプションを格納したオブジェクトを渡すことができます。以下のプロパティがサポートされています: -| プロパティ | 型 | 説明 | -| ------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -| context | Text | エンティティに適用されている自動の最適化コンテキストのラベル。 エンティティを読み込む以降のコードは、このコンテキストを使うことで最適化の恩恵を受けます。 [ORDA クライアントサーバー通信](../ORDA/remoteDatastores.md#クライアントサーバーの最適化)で使用することができます。 | +| プロパティ | 型 | 説明 | +| ------- | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | +| context | Text | エンティティに適用されている自動の最適化コンテキストのラベル。エンティティを読み込む以降のコードは、このコンテキストを使うことで最適化の恩恵を受けます。 [ORDA クライアントサーバー通信](../ORDA/remoteDatastores.md#クライアントサーバーの最適化)で使用することができます。 | :::info -*settings* パラメーターを**使わずに** `.get()` 関数を使用した場合には、属性値を求めるリクエストが直接サーバーに送信されます([ORDAキャッシュ](../ORDA/remoteDatastores.md#ORDAキャッシュ)は使われません)。 一方、*settings* パラメーターを介して `context` を渡す形で `.get()` 関数を呼び出すと、コンテキストに対応する ORDAキャッシュから属性値が取得されます。 この場合、[`reload()`](EntityClass.md#reload) を呼び出して、最新のデータがサーバーから取得されていることを確認することをお勧めします。 +*settings* パラメーターを**使わずに** `.get()` 関数を使用した場合には、属性値を求めるリクエストが直接サーバーに送信されます([ORDAキャッシュ](../ORDA/remoteDatastores.md#ORDAキャッシュ)は使われません)。一方、*settings* パラメーターを介して `context` を渡す形で `.get()` 関数を呼び出すと、コンテキストに対応する ORDAキャッシュから属性値が取得されます。この場合、[`reload()`](EntityClass.md#reload) を呼び出して、最新のデータがサーバーから取得されていることを確認することをお勧めします。 ::: @@ -636,7 +636,7 @@ $number:=$ds.Persons.getCount() #### 説明 -`.getInfo()` 関数は、 データクラスの情報を提供するオブジェクトを返します。 このメソッドは汎用的なコードを書くのに有用です。 +`.getInfo()` 関数は、 データクラスの情報を提供するオブジェクトを返します。このメソッドは汎用的なコードを書くのに有用です。 **返されるオブジェクト** @@ -710,7 +710,7 @@ $number:=$ds.Persons.getCount() -> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。 ほとんどの場合、使用する必要はないでしょう。 +> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。ほとんどの場合、使用する必要はないでしょう。 #### 説明 @@ -749,11 +749,11 @@ $number:=$ds.Persons.getCount() #### 例題 -次の例で、`$ds.Persons.all()` は、先頭エンティティをそのすべての属性とともにロードします。 その後リクエストの最適化がおこなわれ、`firstname` と `address.city` のみがロードされます。 +次の例で、`$ds.Persons.all()` は、先頭エンティティをそのすべての属性とともにロードします。その後リクエストの最適化がおこなわれ、`firstname` と `address.city` のみがロードされます。 `address.city` は、`Persons` データクラスのキャッシュにロードされることに注意してください。 -`Address` データクラスの先頭エンティティだけがキャッシュに格納されます。 先頭エンティティは、ループの最初の繰り返しでロードされます。 +`Address` データクラスの先頭エンティティだけがキャッシュに格納されます。先頭エンティティは、ループの最初の繰り返しでロードされます。 ```4d var $ds : 4D.DataStoreImplementation @@ -806,7 +806,7 @@ $cacheAddress:=$ds.Adress.getRemoteCache() `.new()` 関数は、 メモリ内にデータクラスに空のエンティティを新規作成しそれを返します。 -エンティティオブジェクトはメモリ内に作成されますが、[`.save( )`](EntityClass.md#save) 関数が呼び出されるまでデータベースには保存されません。 エンティティを保存する前に削除した場合、復元することはできません。 +エンティティオブジェクトはメモリ内に作成されますが、[`.save( )`](EntityClass.md#save) 関数が呼び出されるまでデータベースには保存されません。エンティティを保存する前に削除した場合、復元することはできません。 **4D Server**: クライアント/サーバーにおいては、対応するテーブルのプライマリーキーが自動インクリメントであった場合、エンティティがサーバー側に保存されたときに計算されます。 @@ -857,9 +857,9 @@ $cacheAddress:=$ds.Adress.getRemoteCache() > 追加可能なエンティティセレクションについての詳細は [共有可能/追加可能なエンティティセレクション](ORDA/entities.md#shareable-or-alterable-entity-selections) を参照ください。 -順列ありのエンティティセレクションを作成するには、*keepOrder* に `dk keep ordered` セレクターを渡します。 この引数を省略した場合のデフォルト、あるいは `dk non ordered` セレクターを渡した場合には、関数は順列なしのエンティティセレクションを返します。 順列なしのエンティティセレクションの方が速いですが、エンティティの位置に頼ることはできません。 詳細については、[エンティティセレクションの順列あり/順列なし](ORDA/dsMapping.md#エンティティセレクションの順列あり順列なし) を参照ください。 +順列ありのエンティティセレクションを作成するには、*keepOrder* に `dk keep ordered` セレクターを渡します。この引数を省略した場合のデフォルト、あるいは `dk non ordered` セレクターを渡した場合には、関数は順列なしのエンティティセレクションを返します。順列なしのエンティティセレクションの方が速いですが、エンティティの位置に頼ることはできません。詳細については、[エンティティセレクションの順列あり/順列なし](ORDA/dsMapping.md#エンティティセレクションの順列あり順列なし) を参照ください。 -作成された時点では、エンティティセレクションにエンティティは含まれていません(`mySelection.length` は0を返します)。 あとから [`add()`](EntitySelectionClass.md#add) 関数を呼び出すことで、エンティティセレクションを徐々にビルドしていくことができます。 +作成された時点では、エンティティセレクションにエンティティは含まれていません(`mySelection.length` は0を返します)。あとから [`add()`](EntitySelectionClass.md#add) 関数を呼び出すことで、エンティティセレクションを徐々にビルドしていくことができます。 #### 例題 @@ -902,7 +902,7 @@ $cacheAddress:=$ds.Adress.getRemoteCache() #### 説明 -`.query()` 関数は、 データクラスの全エンティティから、*queryString* または *formula* と任意の *value* 引数で指定した検索条件に合致するエンティティを検索します。 戻り値は、見つかったエンティティをすべて格納する `EntitySelection` 型の新しいオブジェクトです。 この関数には、レイジーローディングが適用されます。 +`.query()` 関数は、 データクラスの全エンティティから、*queryString* または *formula* と任意の *value* 引数で指定した検索条件に合致するエンティティを検索します。 戻り値は、見つかったエンティティをすべて格納する `EntitySelection` 型の新しいオブジェクトです。この関数には、レイジーローディングが適用されます。 エンティティが見つからない場合、空のエンティティセレクションが返されます。 @@ -918,64 +918,64 @@ attributePath|formula 比較演算子 値 詳細は以下の通りです: -* **attributePath**: クエリの実行対象となる属性パス。 この引数は、単純な名前 ("country" など) のほか、あらゆる有効な属性パス ("country.name" など) の形をとることができます。 属性パスが `Collection` 型である場合、すべてのオカレンスを管理するには `[]` 記法を使用してください (例: `children[].age` など)。 +* **attributePath**: クエリの実行対象となる属性パス。この引数は、単純な名前 ("country" など) のほか、あらゆる有効な属性パス ("country.name" など) の形をとることができます。属性パスが `Collection` 型である場合、すべてのオカレンスを管理するには `[]` 記法を使用してください (例: `children[].age` など)。 > *queryString* には、すべての種類の引数を混ぜて渡すことができます。 *queryString* 引数は、*attributePath* と *formula* と *値* に以下のものを含めることができます: -* **formula**: テキストまたはオブジェクト形式で渡された有効なフォーミュラ。 フォーミュラは処理されるエンティティごとに評価され、ブール値を返さなくてはなりません。 処理中のエンティティはフォーミュラ内において `This` で参照されます。 +* **formula**: テキストまたはオブジェクト形式で渡された有効なフォーミュラ。フォーミュラは処理されるエンティティごとに評価され、ブール値を返さなくてはなりません。処理中のエンティティはフォーミュラ内において `This` で参照されます。 - * **テキスト**: フォーミュラ文字列の前に `eval( )` ステートメントが必要です。 これにより、クエリが式を正しく解釈します。 例: *"eval(length(This.lastname) >=30)"* - * **オブジェクト**: [フォーミュラオブジェクト](FunctionClass.md) は **プレースホルダー** (後述参照) を使って受け渡します。 このフォーミュラは、[`Formula`](FunctionClass.md#formula) または [`Formula from string`](FunctionClass.md#formula-from-string) コマンドによって作成されたものでなくてはなりません。 > * 4Dフォーミュラは、`&` および `|` 記号のみを論理演算子としてサポートすることに留意が必要です。 > * フォーミュラ以外にも検索条件がある場合、クエリエンジンの最適化によってほかの検索条件 (たとえばインデックス属性) の処理が優先される場合があり、その場合はエンティティのサブセットのみがフォーミュラの評価対象となります。 + * **テキスト**: フォーミュラ文字列の前に `eval( )` ステートメントが必要です。 これにより、クエリが式を正しく解釈します。例: *"eval(length(This.lastname) >=30)"* + * **オブジェクト**: [フォーミュラオブジェクト](FunctionClass.md) は **プレースホルダー** (後述参照) を使って受け渡します。このフォーミュラは、[`Formula`](FunctionClass.md#formula) または [`Formula from string`](FunctionClass.md#formula-from-string) コマンドによって作成されたものでなくてはなりません。 > * 4Dフォーミュラは、`&` および `|` 記号のみを論理演算子としてサポートすることに留意が必要です。 > * フォーミュラ以外にも検索条件がある場合、クエリエンジンの最適化によってほかの検索条件 (たとえばインデックス属性) の処理が優先される場合があり、その場合はエンティティのサブセットのみがフォーミュラの評価対象となります。 > * 4Dフォーミュラは、`&` および `|` 記号のみを論理演算子としてサポートすることに留意が必要です。 > * フォーミュラ以外にも検索条件がある場合、クエリエンジンの最適化によってほかの検索条件 (たとえばインデックス属性) の処理が優先される場合があり、その場合はエンティティのサブセットのみがフォーミュラの評価対象となります。 - クエリに使用するフォーミュラは $1 に引数を受け取ることができます。 詳細については後述の **フォーミュラ引数** を参照ください。 -> * フォーミュラが複雑な場合など、`queryString` パラメーターを使わずに、`formula` パラメーターにオブジェクトを直接渡すこともできます。 後述の **フォーミュラ引数** を参照ください。 + クエリに使用するフォーミュラは $1 に引数を受け取ることができます。詳細については後述の **フォーミュラ引数** を参照ください。 +> * フォーミュラが複雑な場合など、`queryString` パラメーターを使わずに、`formula` パラメーターにオブジェクトを直接渡すこともできます。後述の **フォーミュラ引数** を参照ください。 > * セキュリティのため、 `query()` 関数内のフォーミュラ使用を禁止することができます。 `querySettings` パラメーターの説明を参照ください。 -* *querySettings* 引数は、追加のオプションを格納したオブジェクトです。 以下のプロパティがサポートされています: - - | 比較 | 記号 | 説明 | - | ------------- | ----------- | --------------------------------------------------------------------------------------- | - | 等しい | =, == | 一致するデータを取得します。 ワイルドカード (@) をサポートし、文字の大小/アクセントの有無は区別しません。 | - | | ===, IS | 一致するデータを取得します。 ワイルドカード (@) は標準の文字として認識され、文字の大小/アクセント記号の有無は区別しません。 | - | 等しくない | #, != | ワイルドカード (@) をサポートします。 "宣言に Not 条件を適用" と同じです ([後述参照](#コレクションにおける-等しくない)) | - | | !==, IS NOT | ワイルドカード (@) は標準の文字として認識されます | - | 宣言に Not 条件を適用 | NOT | 複数の演算子が含まれる宣言の前に NOT を使用する場合にはカッコをつける必要があります。 "等しくない" と同じです ([後述参照](#コレクションにおける-等しくない)) | - | 小さい | < | | - | 大きい | > | | - | 以下 | <= | | - | 以上 | >= | | - | 含まれる | IN | コレクション、あるいは複数の値のうち、どれか一つの値と等しいデータを取得します。 ワイルドカード (@) をサポートします。 | - | キーワードを含む | % | キーワードは、文字列あるいはピクチャー型の属性内で使用されるものが対象です。 | - -* **値**: コレクションの各要素、あるいはエンティティセレクションの各エンティティのプロパティのカレント値に対して比較する値。 **プレースホルダー** (後述の **プレースホルダーの使用** 参照) か、あるいはデータ型プロパティと同じ型の式を使用することができます。 スカラー型(テキスト、日付、数値、など)で型が合致しない場合、4D は可能な限り**value** 引数の値を属性のデータ型へと変換しようとします。 例えば、**value** 引数に"v20" という文字列が整数属性と比較するために与えられた場合、それは 20 へと変換されます。 定数値を使用する場合、以下の原則に従う必要があります: - * **テキスト** テキスト型の定数値の場合は単一引用符つき、あるいはなしでも渡すことができます(後述の **引用符を使用する** 参照)。 文字列中の文字列を検索する ("含まれる" クエリ) には、ワイルドカード記号 (@) を使用して検索文字列を指定します (例: "@Smith@")。 また以下のキーワードはテキスト定数においては使用できません: true, false。 +* *querySettings* 引数は、追加のオプションを格納したオブジェクトです。以下のプロパティがサポートされています: + + | 比較 | 記号 | 説明 | + | ------------- | ----------- | -------------------------------------------------------------------------------------- | + | 等しい | =, == | 一致するデータを取得します。 ワイルドカード (@) をサポートし、文字の大小/アクセントの有無は区別しません。 | + | | ===, IS | 一致するデータを取得します。 ワイルドカード (@) は標準の文字として認識され、文字の大小/アクセント記号の有無は区別しません。 | + | 等しくない | #, != | ワイルドカード (@) をサポートします。"宣言に Not 条件を適用" と同じです ([後述参照](#コレクションにおける-等しくない)) | + | | !==, IS NOT | ワイルドカード (@) は標準の文字として認識されます | + | 宣言に Not 条件を適用 | NOT | 複数の演算子が含まれる宣言の前に NOT を使用する場合にはカッコをつける必要があります。"等しくない" と同じです ([後述参照](#コレクションにおける-等しくない)) | + | 小さい | < | | + | 大きい | > | | + | 以下 | <= | | + | 以上 | >= | | + | 含まれる | IN | コレクション、あるいは複数の値のうち、どれか一つの値と等しいデータを取得します。 ワイルドカード (@) をサポートします。 | + | キーワードを含む | % | キーワードは、文字列あるいはピクチャー型の属性内で使用されるものが対象です。 | + +* **値**: コレクションの各要素、あるいはエンティティセレクションの各エンティティのプロパティのカレント値に対して比較する値。**プレースホルダー** (後述の **プレースホルダーの使用** 参照) か、あるいはデータ型プロパティと同じ型の式を使用することができます。スカラー型(テキスト、日付、数値、など)で型が合致しない場合、4D は可能な限り**value** 引数の値を属性のデータ型へと変換しようとします。例えば、**value** 引数に"v20" という文字列が整数属性と比較するために与えられた場合、それは 20 へと変換されます。定数値を使用する場合、以下の原則に従う必要があります: + * **テキスト** テキスト型の定数値の場合は単一引用符つき、あるいはなしでも渡すことができます(後述の **引用符を使用する** 参照)。文字列中の文字列を検索する ("含まれる" クエリ) には、ワイルドカード記号 (@) を使用して検索文字列を指定します (例: "@Smith@")。また以下のキーワードはテキスト定数においては使用できません: true, false。 * **ブール** 型の定数値: **true** または **false** (文字の大小を区別します) * **数値** 型の定数値: 浮動小数点は '.' * **日付** 型の定数値: "YYYY-MM-DD" フォーマット。 * **null** 定数値: "null" キーワードを使用した場合、**null** と **undefined** プロパティの両方が検索されます。 * IN 記号を使用したクエリの場合、*値* はコレクションか、attributePath の型に合致する、\[ ] でくくられたカンマ区切りの値である必要があります (文字列においては、`"` の記号は `\` でエスケープする必要があります)。 -* **論理演算子**: 複数の条件をクエリ内で結合させるのに使用します(任意)。 以下の論理演算子のいずれか一つを使用できます (名前あるいは記号のどちらかを渡します): +* **論理演算子**: 複数の条件をクエリ内で結合させるのに使用します(任意)。以下の論理演算子のいずれか一つを使用できます (名前あるいは記号のどちらかを渡します): | 結合 | 記号 | | --- | ----------------------- | | AND | &, &&, and | | OR | |,||, or | -* **order by attributePath**: クエリに "order by attributePath" ステートメントを追加することで、結果をソートすることができます。 カンマで区切ることで、複数の order by ステートメントを使用することもできます (例: order by *attributePath1* desc, *attributePath2* asc)。 デフォルトの並び順は昇順です。 並び順を指定するには、降順の場合は 'desc'、昇順の場合は 'asc' を追加します。 >このステートメントを使用した場合、順序ありエンティティセレクションが返されます (詳細については [エンティティセレクションの順列あり/順列なし](ORDA/dsMapping.md#エンティティセレクションの順列あり順列なし) を参照ください)。 +* **order by attributePath**: クエリに "order by attributePath" ステートメントを追加することで、結果をソートすることができます。カンマで区切ることで、複数の order by ステートメントを使用することもできます (例: order by *attributePath1* desc, *attributePath2* asc)。デフォルトの並び順は昇順です。並び順を指定するには、降順の場合は 'desc'、昇順の場合は 'asc' を追加します。 >このステートメントを使用した場合、順序ありエンティティセレクションが返されます (詳細については [エンティティセレクションの順列あり/順列なし](ORDA/dsMapping.md#エンティティセレクションの順列あり順列なし) を参照ください)。 #### 引用符を使用する -クエリに変数や式を使用することができます。 例: +クエリに変数や式を使用することができます。例: ```4d "employee.name = 'smith' AND employee.firstname = 'john'" ``` -> 単一引用符 (') は、クエリ文字列を分解してしまうため、検索値としてはサポートされていません。 たとえば、"comp.name = 'John's pizza' " はエラーを生成します。 単一引用符を含む値を検索するには、プレースホルダーを使用します (後述参照)。 +> 単一引用符 (') は、クエリ文字列を分解してしまうため、検索値としてはサポートされていません。たとえば、"comp.name = 'John's pizza' " はエラーを生成します。単一引用符を含む値を検索するには、プレースホルダーを使用します (後述参照)。 #### カッコを使用する -クエリ内でカッコを使用すると、計算に優先順位をつけることができます。 たとえば、以下のようにクエリを整理することができます: +クエリ内でカッコを使用すると、計算に優先順位をつけることができます。たとえば、以下のようにクエリを整理することができます: ```4d "(employee.age >= 30 OR employee.age <= 65) AND (employee.salary <= 10000 OR employee.status = 'Manager')" @@ -983,14 +983,14 @@ attributePath|formula 比較演算子 値 #### プレースホルダーを使用する -4D では、*queryString* 引数内の *attributePath*、*formula* および *値* にプレースホルダーを使用することができます。 プレースホルダーとは、クエリ文字列に挿入するパラメーターで、クエリ文字列が評価される際に他の値で置き換えられるものです。 プレースホルダーの値はクエリ開始時に一度だけ評価されます。 各要素に対して毎回評価されるわけではありません。 +4D では、*queryString* 引数内の *attributePath*、*formula* および *値* にプレースホルダーを使用することができます。プレースホルダーとは、クエリ文字列に挿入するパラメーターで、クエリ文字列が評価される際に他の値で置き換えられるものです。プレースホルダーの値はクエリ開始時に一度だけ評価されます。 各要素に対して毎回評価されるわけではありません。 **インデックスプレースホルダー** および **命名プレースホルダー** です: -| | インデックスプレースホルダー | 命名プレースホルダー | -| -- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -| 定義 | *queryString* に `:paramIndex` (例 :1, :2...) という形式でパラメーターが挿入され、それに対応する値は後に続く *value* 引数が提供します。 最大で 128個の *value* 引数を渡すことができます。 | `:paramName` (例: myparam など) という形でパラメーターが挿入され、その値は *querySettings* 引数の attributes または parameters オブジェクトで提供されます。 | -| 例題 | `$r:=class.query(":1=:2";"city";"Chicago")` | `$o.attributes:=New object("att";"city")`
    `$o.parameters:=New object("name";"Chicago")`
    `$r:=class.query(":att=:name";$o)` | +| | インデックスプレースホルダー | 命名プレースホルダー | +| -- | ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | +| 定義 | *queryString* に `:paramIndex` (例 :1, :2...) という形式でパラメーターが挿入され、それに対応する値は後に続く *value* 引数が提供します。最大で 128個の *value* 引数を渡すことができます。 | `:paramName` (例: myparam など) という形でパラメーターが挿入され、その値は *querySettings* 引数の attributes または parameters オブジェクトで提供されます。 | +| 例題 | `$r:=class.query(":1=:2";"city";"Chicago")` | `$o.attributes:=New object("att";"city")`
    `$o.parameters:=New object("name";"Chicago")`
    `$r:=class.query(":att=:name";$o)` | *queryString* には、すべての種類の引数を混ぜて渡すことができます。 *queryString* 引数は、*attributePath* と *formula* と *値* に以下のものを含めることができます: @@ -999,14 +999,14 @@ attributePath|formula 比較演算子 値 以下の理由から、クエリでのプレースホルダーの使用が **推奨されます**: -1. 悪意あるコードの挿入を防ぎます: ユーザーによって値が代入された変数をクエリ文字列として直接使用した場合、余計なクエリ引数を入力することでユーザーがクエリ条件を変更する可能性があります。 たとえば、以下のようなクエリ文字列を考えます: +1. 悪意あるコードの挿入を防ぎます: ユーザーによって値が代入された変数をクエリ文字列として直接使用した場合、余計なクエリ引数を入力することでユーザーがクエリ条件を変更する可能性があります。たとえば、以下のようなクエリ文字列を考えます: ```4d $vquery:="status = 'public' & name = "+myname // ユーザーが自分の名前を入力します $result:=$col.query($vquery) ``` - 非公開のデータがフィルタリングされているため、このクエリは一見安全なように見えます。 しかしながら、もしユーザーが *myname* に *smith OR status='private'* のような入力をした場合、クエリ文字列は解釈時に変更され、非公開データも返してしまう可能性があります。 + 非公開のデータがフィルタリングされているため、このクエリは一見安全なように見えます。しかしながら、もしユーザーが *myname* に *smith OR status='private'* のような入力をした場合、クエリ文字列は解釈時に変更され、非公開データも返してしまう可能性があります。 プレースホルダーを使用した場合、セキュリティ条件を上書きすることは不可能です: @@ -1018,7 +1018,7 @@ attributePath|formula 比較演算子 値 2. フォーマットや文字の問題を心配する必要がありません。 これは、*attributePath* や *値* がたとえば "."、"[' ...などの英数字でない文字を格納している可能性がある場合にとくに有用です。 -3. クエリに変数や式を使用することができます。 例: +3. クエリに変数や式を使用することができます。例: ```4d $result:=$col.query("address.city = :1 & name =:2";$city;$myVar+"@") @@ -1027,13 +1027,13 @@ attributePath|formula 比較演算子 値 #### null値を検索する -null値を検索する場合、プレースホルダーシンタックスは使用できません。 なぜならクエリエンジンは null を予期せぬ比較値としてみなすからです。 たとえば、以下のクエリを実行した場合: +null値を検索する場合、プレースホルダーシンタックスは使用できません。 なぜならクエリエンジンは null を予期せぬ比較値としてみなすからです。たとえば、以下のクエリを実行した場合: ```4d $vSingles:=ds.Person.query("spouse = :1";Null) // 機能しません ``` -この場合 4D は null値を、引数の評価 (別のクエリから渡された属性など) に起因するエラーと解釈するため、期待した結果は得られません。 このようなクエリをおこなうには、直接的なシンタックスを使用する必要があります: +この場合 4D は null値を、引数の評価 (別のクエリから渡された属性など) に起因するエラーと解釈するため、期待した結果は得られません。このようなクエリをおこなうには、直接的なシンタックスを使用する必要があります: ```4d $vSingles:=ds.Person.query("spouse = null") // 正しいシンタックス @@ -1041,7 +1041,7 @@ $vSingles:=ds.Person.query("spouse = :1";Null) // 機能しません #### null または未定義の値と等しくない -"*value* と等しくない" 比較演算子は(`#` または `!=`) は値がnull または未定義である属性は返しません。 例えば、以下のクエリは"info.married" のステータスが `false` である人物のみを返し、"info.married" プロパティが"null" または欠けている人物は返しません: +"*value* と等しくない" 比較演算子は(`#` または `!=`) は値がnull または未定義である属性は返しません。例えば、以下のクエリは"info.married" のステータスが `false` である人物のみを返し、"info.married" プロパティが"null" または欠けている人物は返しません: ```4d $notMarried:=ds.Person.query("info.married#true") // 属性の値がfalseである人物のみを探す @@ -1056,7 +1056,7 @@ $notMarried:=ds.Person.query("info.married#true | info.married=null") // 属性 #### コレクションにおける "等しくない" -コレクションを含むデータクラス属性内を検索する場合、"*値* と等しくない" 比較演算子 (`#` または `!=`) は、すべてのプロパティが *値* と異なる要素を検索します (ほかの比較演算子とは異なり、少なくとも 1つのプロパティが *値* と異なる要素は検索しません)。 つまり、"Not(プロパティ値が *value* と等しいコレクション要素を検索する)" を検索することと同じです。 たとえば、以下のような エンティティがあるとき: +コレクションを含むデータクラス属性内を検索する場合、"*値* と等しくない" 比較演算子 (`#` または `!=`) は、すべてのプロパティが *値* と異なる要素を検索します (ほかの比較演算子とは異なり、少なくとも 1つのプロパティが *値* と異なる要素は検索しません)。つまり、"Not(プロパティ値が *value* と等しいコレクション要素を検索する)" を検索することと同じです。たとえば、以下のような エンティティがあるとき: ``` エンティティ1: @@ -1113,11 +1113,11 @@ ds.Class.query("info.coll[a].val != :1";0) :::info -この機能は、データクラスおよび [エンティティセレクション](EntitySelectionClass.md#query) をクエリする場合にのみ利用可能です。 [コレクション](CollectionClass.md#query) をクエリする場合には利用できません。 +この機能は、データクラスおよび [エンティティセレクション](EntitySelectionClass.md#query) をクエリする場合にのみ利用可能です。[コレクション](CollectionClass.md#query) をクエリする場合には利用できません。 ::: -コレクションを含むデータクラス属性を対象に、AND 演算子で結合された複数のクエリ条件を使用して検索するにあたって、検索条件に合致するプロパティが複数のコレクション要素にバラけているのではなく、一つのコレクション要素がすべてまとまっているエンティティを探したいとします。 これには、すべての条件に合致するコレクション要素のみが検出されるよう、クエリ条件をコレクション要素にリンクする必要があります。 +コレクションを含むデータクラス属性を対象に、AND 演算子で結合された複数のクエリ条件を使用して検索するにあたって、検索条件に合致するプロパティが複数のコレクション要素にバラけているのではなく、一つのコレクション要素がすべてまとまっているエンティティを探したいとします。これには、すべての条件に合致するコレクション要素のみが検出されるよう、クエリ条件をコレクション要素にリンクする必要があります。 たとえば、以下のような 2件のエンティティがあるとき: @@ -1142,7 +1142,7 @@ ds.People.places: } ] } ``` -"locations" 属性に、"kind=home" かつ "city=paris" である要素を持つ人を探したいとします。 以下のように書いた場合: +"locations" 属性に、"kind=home" かつ "city=paris" である要素を持つ人を探したいとします。以下のように書いた場合: ```4d ds.People.query("places.locations[].kind= :1 and places.locations[].city= :2";"home";"paris") @@ -1150,10 +1150,10 @@ ds.People.query("places.locations[].kind= :1 and places.locations[].city= :2";"h ... クエリは "martin" と "smith" の**両方**を返します。 なぜなら "smith" も "kind=home" である "location" 要素を持っており、"city=paris" である "location" 要素をも持っているからです (ですがこれら 2つは異なるコレクション要素です)。 -検索条件に合致する属性が同一のコレクション要素に含まれるエンティティのみを取得するには、**クエリ条件をリンク** します。 クエリ条件をリンクするには: +検索条件に合致する属性が同一のコレクション要素に含まれるエンティティのみを取得するには、**クエリ条件をリンク** します。クエリ条件をリンクするには: -* リンクする最初のクエリ条件にてパスの \[] 内に文字を追加し、同様に他のクエリ条件でも同じ文字を追加します。 例: `locations[a].city and locations[a].kind`。 ローマ字であればどの文字でも使用可能です (文字の大小は区別されません)。 -* 同じクエリ内に、異なるリンク条件を追加するには、別の文字を使用します。 単一のクエリ内では、最大で 26組のリンク条件を使用することができます。 +* リンクする最初のクエリ条件にてパスの \[] 内に文字を追加し、同様に他のクエリ条件でも同じ文字を追加します。例: `locations[a].city and locations[a].kind`。ローマ字であればどの文字でも使用可能です (文字の大小は区別されません)。 +* 同じクエリ内に、異なるリンク条件を追加するには、別の文字を使用します。単一のクエリ内では、最大で 26組のリンク条件を使用することができます。 上記の 2件のエンティティにおいて、以下のように書いた場合: @@ -1167,7 +1167,7 @@ ds.People.query("places.locations[a].kind= :1 and places.locations[a].city= :2"; #### N対Nリレーションのクエリ -ORDA は、N対Nリレーションにおけるクエリを容易にするための特別な構文を提供します。 このような場合には `AND` 演算子を使って、同じ属性内に格納されている異なる値を検索する必要があるかもしれません。 たとえば、以下のようなストラクチャーの場合を考えます: +ORDA は、N対Nリレーションにおけるクエリを容易にするための特別な構文を提供します。このような場合には `AND` 演算子を使って、同じ属性内に格納されている異なる値を検索する必要があるかもしれません。たとえば、以下のようなストラクチャーの場合を考えます: ![alt-text](../assets/en/API/manytomany.png) @@ -1187,7 +1187,7 @@ $es:=ds.Movie.query("roles.actor.lastName = :1 AND roles.actor.lastName = :2";"H "relationAttribute.attribute = :1 AND relationAttribute{x}.attribute = :2 [AND relationAttribute{y}.attribute...]" ``` -**{x}** は、リレーション属性のために新たな参照を作成するよう、ORDA に指示します。 すると、ORDA は必要なビットマップ操作を内部で実行します。 **x** には **0 以外** の任意の数値を使用できます: {1}、{2}、{1540}...。 ORDA は、各クラスインデックス用の一意な参照をクエリ内においてのみ必要とします。 +**{x}** は、リレーション属性のために新たな参照を作成するよう、ORDA に指示します。すると、ORDA は必要なビットマップ操作を内部で実行します。 **x** には **0 以外** の任意の数値を使用できます: {1}、{2}、{1540}...。 ORDA は、各クラスインデックス用の一意な参照をクエリ内においてのみ必要とします。 この例では、次のようになります: @@ -1201,11 +1201,11 @@ $es:=ds.Movie.query("roles.actor.lastName = :1 AND roles.actor{2}.lastName = :2" #### formula 引数 -*queryString* 引数にフォーミュラを挿入 (上記参照) する代わりに、formula オブジェクトをブール検索条件として直接渡すことができます。 トークナイズの利点を生かせる、コードが検索しやすく読みやすい、などといった面から、クエリにおけるフォーミュラオブジェクトの使用は **推奨されています**。 +*queryString* 引数にフォーミュラを挿入 (上記参照) する代わりに、formula オブジェクトをブール検索条件として直接渡すことができます。トークナイズの利点を生かせる、コードが検索しやすく読みやすい、などといった面から、クエリにおけるフォーミュラオブジェクトの使用は **推奨されています**。 -このフォーミュラは、[`Formula`](FunctionClass.md#formula) または [`Formula from string`](FunctionClass.md#formula-from-string) コマンドによって作成されたものでなくてはなりません。 > * 4Dフォーミュラは、`&` および `|` 記号のみを論理演算子としてサポートすることに留意が必要です。 > * フォーミュラ以外にも検索条件がある場合、クエリエンジンの最適化によってほかの検索条件 (たとえばインデックス属性) の処理が優先される場合があり、その場合はエンティティのサブセットのみがフォーミュラの評価対象となります。 この場合において: +このフォーミュラは、[`Formula`](FunctionClass.md#formula) または [`Formula from string`](FunctionClass.md#formula-from-string) コマンドによって作成されたものでなくてはなりません。 > * 4Dフォーミュラは、`&` および `|` 記号のみを論理演算子としてサポートすることに留意が必要です。 > * フォーミュラ以外にも検索条件がある場合、クエリエンジンの最適化によってほかの検索条件 (たとえばインデックス属性) の処理が優先される場合があり、その場合はエンティティのサブセットのみがフォーミュラの評価対象となります。この場合において: -* フォーミュラは処理されるエンティティごとに評価され、true または false を返さなくてはなりません。 クエリの実行中、フォーミュラの結果がブール値でなかった場合、それは false であるとみなされます。 +* フォーミュラは処理されるエンティティごとに評価され、true または false を返さなくてはなりません。クエリの実行中、フォーミュラの結果がブール値でなかった場合、それは false であるとみなされます。 * *queryString* または *formula* に **値の命名プレースホルダー** を使用した場合に渡すオブジェクト。 * `Formula` オブジェクトが **null** の場合、エラー1626 ("テキストまたはフォーミュラが必要です") が生成されます。 > セキュリティのため、 `query()` 関数内のフォーミュラ使用を禁止することができます。 *querySettings* パラメーターの説明を参照ください。 @@ -1226,25 +1226,25 @@ $es:=ds.Movie.query("roles.actor.lastName = :1 AND roles.actor{2}.lastName = :2" さらなる使用例は、例題3にて紹介されています。 -**4D Server**: クライアント/サーバーにおいては、フォーミュラはサーバー上で実行されます。 このコンテキストにおいては、`querySettings.args` オブジェクトのみがフォーミュラに送信されます。 +**4D Server**: クライアント/サーバーにおいては、フォーミュラはサーバー上で実行されます。このコンテキストにおいては、`querySettings.args` オブジェクトのみがフォーミュラに送信されます。 #### querySettings 引数 -任意の *settings* パラメーターには、追加オプションを格納したオブジェクトを渡すことができます。 以下のプロパティがサポートされています: +任意の *settings* パラメーターには、追加オプションを格納したオブジェクトを渡すことができます。以下のプロパティがサポートされています: -| プロパティ | 型 | 説明 | -| ------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| parameters | Object | *queryString* に `:paramIndex` (例 :1, :2...) という形式でパラメーターが挿入され、それに対応する値は後に続く *value* 引数が提供します。 インデックスプレースホルダー (value引数として値を直接渡す方法) と命名プレースホルダーは、同じクエリ内で同時に使用することができます。 | -| attributes | Object | *queryString* または *formula* に **属性パスの命名プレースホルダー** を使用した場合に渡すオブジェクト。 プロパティは、*queryString* または *formula* に属性パスの代わりに挿入されたプレースホルダー名 (":placeholder"など) で、値は、属性パスを表す文字列または文字列のコレクションです。 値には、データクラスのスカラー属性・リレート属性・オブジェクトフィールド内のプロパティへの属性パスを指定することができます。
    型説明
    Stringドット記法を使用して表現された attributePath (例: "name" または "user.address.zipCode")
    String の Collectionコレクションの各要素が attributePath の階層を表します (例: ["name"] または ["user","address","zipCode"])。 コレクションを使用することで、ドット記法に準じていない名前の属性に対してもクエリすることができます (例: \["4Dv17.1","en/fr"])。
    インデックスプレースホルダー (*value* 引数として値を直接渡す方法) と命名プレースホルダーは、同じクエリ内で同時に使用することができます。 | -| args | Object | フォーミュラに渡す引数。 **args** オブジェクトは、フォーミュラ内の $1 が受け取るので、その値は *$1.property* という形で利用可能です (例題3 参照)。 | -| allowFormulas | Boolean | クエリ内でフォーミュラの呼び出しを許可するには true (デフォルト)。 フォーミュラ実行を禁止するには false を渡します。 false に設定されているときに、フォーミュラが `query()` に渡された場合、エラーが発生します (1278 - フォーミュラはこのメンバーメソッドでは許可されていません)。 | -| context | Text | エンティティセレクションに適用されている自動の最適化コンテキストのラベル。 エンティティセレクションを扱うコードはこのコンテキストを使うことで最適化の恩恵を受けます。 この機能はクライアント/サーバー処理を想定して設計されています。 詳細な情報については、[**クライアント/サーバーの最適化**](../ORDA/remoteDatastores.md#クライアントサーバーの最適化) の章を参照ください。 | -| queryPlan | Boolean | 戻り値のエンティティコレクションに、実行する直前のクエリの詳細 (クエリプラン) を含めるかどうかを指定します。 返されるプロパティは、クエリプラン あるいはサブクエリ (複合クエリの場合) を格納したオブジェクトです。 このオプションはアプリケーションの開発フェーズにおいて有用です。 このオプションは通常 queryPath と組み合わせて使用されます。 省略時のデフォルト: false。 **注:** このプロパティは `entitySelection.query()` および `dataClass.query()` 関数においてのみサポートされます。 | -| queryPath | Boolean | 戻り値のエンティティコレクションに、実際に実行されたクエリの詳細を含めるかどうかを指定します。 返されたプロパティは、クエリで実際に使用されたパス (通常は queryPlan と同一ですが、エンジンがクエリを最適化した場合には異なる場合があります)、処理時間と検出レコード数を格納したオブジェクトです。 このオプションはアプリケーションの開発フェーズにおいて有用です。 省略時のデフォルト: false。 **注:** このプロパティは `entitySelection.query()` および `dataClass.query()` 関数においてのみサポートされます。 | +| プロパティ | 型 | 説明 | +| ------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| parameters | Object | *queryString* に `:paramIndex` (例 :1, :2...) という形式でパラメーターが挿入され、それに対応する値は後に続く *value* 引数が提供します。インデックスプレースホルダー (value引数として値を直接渡す方法) と命名プレースホルダーは、同じクエリ内で同時に使用することができます。 | +| attributes | Object | *queryString* または *formula* に **属性パスの命名プレースホルダー** を使用した場合に渡すオブジェクト。プロパティは、*queryString* または *formula* に属性パスの代わりに挿入されたプレースホルダー名 (":placeholder"など) で、値は、属性パスを表す文字列または文字列のコレクションです。値には、データクラスのスカラー属性・リレート属性・オブジェクトフィールド内のプロパティへの属性パスを指定することができます。
    型説明
    Stringドット記法を使用して表現された attributePath (例: "name" または "user.address.zipCode")
    String の Collectionコレクションの各要素が attributePath の階層を表します (例: ["name"] または ["user","address","zipCode"])。コレクションを使用することで、ドット記法に準じていない名前の属性に対してもクエリすることができます (例: \["4Dv17.1","en/fr"])。
    インデックスプレースホルダー (*value* 引数として値を直接渡す方法) と命名プレースホルダーは、同じクエリ内で同時に使用することができます。 | +| args | Object | フォーミュラに渡す引数。 **args** オブジェクトは、フォーミュラ内の $1 が受け取るので、その値は *$1.property* という形で利用可能です (例題3 参照)。 | +| allowFormulas | Boolean | クエリ内でフォーミュラの呼び出しを許可するには true (デフォルト)。フォーミュラ実行を禁止するには false を渡します。 false に設定されているときに、フォーミュラが `query()` に渡された場合、エラーが発生します (1278 - フォーミュラはこのメンバーメソッドでは許可されていません)。 | +| context | Text | エンティティセレクションに適用されている自動の最適化コンテキストのラベル。エンティティセレクションを扱うコードはこのコンテキストを使うことで最適化の恩恵を受けます。この機能はクライアント/サーバー処理を想定して設計されています。 詳細な情報については、[**クライアント/サーバーの最適化**](../ORDA/remoteDatastores.md#クライアントサーバーの最適化) の章を参照ください。 | +| queryPlan | Boolean | 戻り値のエンティティコレクションに、実行する直前のクエリの詳細 (クエリプラン) を含めるかどうかを指定します。返されるプロパティは、クエリプラン あるいはサブクエリ (複合クエリの場合) を格納したオブジェクトです。このオプションはアプリケーションの開発フェーズにおいて有用です。このオプションは通常 queryPath と組み合わせて使用されます。省略時のデフォルト: false。**注:** このプロパティは `entitySelection.query()` および `dataClass.query()` 関数においてのみサポートされます。 | +| queryPath | Boolean | 戻り値のエンティティコレクションに、実際に実行されたクエリの詳細を含めるかどうかを指定します。返されたプロパティは、クエリで実際に使用されたパス (通常は queryPlan と同一ですが、エンジンがクエリを最適化した場合には異なる場合があります)、処理時間と検出レコード数を格納したオブジェクトです。このオプションはアプリケーションの開発フェーズにおいて有用です。省略時のデフォルト: false。**注:** このプロパティは `entitySelection.query()` および `dataClass.query()` 関数においてのみサポートされます。 | #### queryPlan と queryPath について -`queryPlan`/`queryPath` に格納される情報には、クエリの種類 (インデックスあるいはシーケンシャル)、必要なサブクエリおよびその連結演算子が含まれます。 クエリパスには、見つかったエンティティの数と各検索条件を実行するのにかかった時間も含まれます。 この情報は、アプリケーションの開発中に解析することで有効に活用できます。 一般的には、クエリプランとクエリパスの詳細は同一になるはずですが、4D はパフォーマンス向上のために動的な最適化をクエリ実行時に実装することがあり、異なることもあります。 たとえば、その方が早いと判断した場合には、4Dエンジンはインデックス付きクエリをシーケンシャルなものへと動的に変換することがあります。 これは検索されているエンティティの数が少ないときに起こりえます。 +`queryPlan`/`queryPath` に格納される情報には、クエリの種類 (インデックスあるいはシーケンシャル)、必要なサブクエリおよびその連結演算子が含まれます。クエリパスには、見つかったエンティティの数と各検索条件を実行するのにかかった時間も含まれます。この情報は、アプリケーションの開発中に解析することで有効に活用できます。一般的には、クエリプランとクエリパスの詳細は同一になるはずですが、4D はパフォーマンス向上のために動的な最適化をクエリ実行時に実装することがあり、異なることもあります。たとえば、その方が早いと判断した場合には、4Dエンジンはインデックス付きクエリをシーケンシャルなものへと動的に変換することがあります。これは検索されているエンティティの数が少ないときに起こりえます。 たとえば、以下のクエリを実行した場合: @@ -1578,7 +1578,7 @@ softwares:{ -> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。 ほとんどの場合、使用する必要はないでしょう。 +> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。ほとんどの場合、使用する必要はないでしょう。 #### 説明 @@ -1591,17 +1591,17 @@ softwares:{ | timeout | Integer | タイムアウト (秒単位)。 | | maxEntries | Integer | エンティティの最大数 | -`timeout` は、データクラスの ORDAキャッシュのタイムアウトを設定します (デフォルトは 30秒)。 タイムアウトを過ぎると、キャッシュ内のデータクラスのエンティティは期限切れとみなされます。 これは、次のことを意味します: +`timeout` は、データクラスの ORDAキャッシュのタイムアウトを設定します (デフォルトは 30秒)。タイムアウトを過ぎると、キャッシュ内のデータクラスのエンティティは期限切れとみなされます。これは、次のことを意味します: * データはまだ存在します * 次にそのデータが必要になったときには、サーバーに要求します * エンティティの最大数に達すると、4D は期限切れのデータを自動的に削除します -`timeout` プロパティを設定すると、すでにキャッシュに存在するエンティティに新しいタイムアウトが設定されます。 これは頻繁に変更されないデータを扱う場合、つまり、サーバーへの新たな要求が必要ない場合に便利です。 +`timeout` プロパティを設定すると、すでにキャッシュに存在するエンティティに新しいタイムアウトが設定されます。これは頻繁に変更されないデータを扱う場合、つまり、サーバーへの新たな要求が必要ない場合に便利です。 -`maxEntries` は、ORDAキャッシュ内のエンティティの最大数を設定します。 デフォルトは 30,000 です。 +`maxEntries` は、ORDAキャッシュ内のエンティティの最大数を設定します。デフォルトは 30,000 です。 -最小エントリー数は 300 のため、`maxEntries` の値は 300以上でなくてはなりません。 それ以外の場合は無視され、最大エントリー数は 300 に設定されます。 +最小エントリー数は 300 のため、`maxEntries` の値は 300以上でなくてはなりません。それ以外の場合は無視され、最大エントリー数は 300 に設定されます。 `timeout` および `maxEntries` として有効なプロパティが渡されない場合、キャッシュはデフォルト値または以前に設定された値のまま変更されません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataStoreClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataStoreClass.md index 14a48536c4f465..07e3ee5e042616 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataStoreClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/DataStoreClass.md @@ -60,9 +60,9 @@ title: DataStore `ds` コマンドは、 カレントの 4Dデータベース、または *localID* で指定したデータベースに合致するデータストアの参照を返します。 -*localID* を省略した (または空の文字列 "" を渡した) 場合には、ローカル4Dデータベース (4D Server でリモートデータベースを開いている場合にはそのデータベース) に合致するデータストアの参照を返します。 データストアは自動的に開かれ、`ds` を介して直接利用することができます。 +*localID* を省略した (または空の文字列 "" を渡した) 場合には、ローカル4Dデータベース (4D Server でリモートデータベースを開いている場合にはそのデータベース) に合致するデータストアの参照を返します。データストアは自動的に開かれ、`ds` を介して直接利用することができます。 -開かれているリモートデータストアのローカルIDを *localID* パラメーターに渡すと、その参照を取得できます。 このデータストアは、あらかじめカレントデータベース (ホストまたはコンポーネント) によって [`Open datastore`](#open-datastore) コマンドで開かれている必要があります。 このコマンドを使用したときにローカルIDが定義されます。 +開かれているリモートデータストアのローカルIDを *localID* パラメーターに渡すと、その参照を取得できます。このデータストアは、あらかじめカレントデータベース (ホストまたはコンポーネント) によって [`Open datastore`](#open-datastore) コマンドで開かれている必要があります。このコマンドを使用したときにローカルIDが定義されます。 > ローカルIDのスコープは、当該データストアを開いたデータベースです。 *localID* に合致するデータストアが見つからない場合、コマンドは **Null** を返します。 @@ -140,7 +140,7 @@ $foreignStudents:=Open datastore($connectTo;"foreign") 合致するデータベースが見つからない場合、`Open datastore` は **Null** を返します。 -*localID* 引数は、リモートデータストア上で開かれるセッションのローカルエイリアスです。 *localID* 引数の ID がすでにアプリケーションに存在している場合、その ID が使用されています。 そうでない場合、データストアオブジェクトが使用されたときに *localID* のセッションが新規に作成されます。 +*localID* 引数は、リモートデータストア上で開かれるセッションのローカルエイリアスです。 *localID* 引数の ID がすでにアプリケーションに存在している場合、その ID が使用されています。そうでない場合、データストアオブジェクトが使用されたときに *localID* のセッションが新規に作成されます。 `4D.DataStoreImplementation` のオブジェクトは[変換のルール](ORDA/dsMapping.md#general-rules)に従い、リモートデータストアからマッピングされます。 @@ -152,23 +152,23 @@ $foreignStudents:=Open datastore($connectTo;"foreign") //$myds と $myds2 は同一のものです ``` -*connectionInfo* には、接続したいリモートデータストアの詳細を格納したオブジェクトを渡します。 オブジェクトは以下のプロパティを格納することができます (*hostname* を除き、すべてのプロパティは任意です): +*connectionInfo* には、接続したいリモートデータストアの詳細を格納したオブジェクトを渡します。オブジェクトは以下のプロパティを格納することができます (*hostname* を除き、すべてのプロパティは任意です): -| プロパティ | 型 | 説明 | -| ----------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| hostname | Text | リモートデータストアの名前または IPアドレス + ":" + ポート番号 (ポート番号は必須) | -| user | Text | ユーザー名 | -| password | Text | ユーザーパスワード。 デフォルトでは、パスワードは平文で送信されるため、`tls` プロパティに `true` を渡して暗号化通信を使用することが**強く推奨**されます。 | -| idleTimeout | Integer | アクティビティがなかった場合に、セッションがタイムアウトするまでの時間 (分単位)。 この時間を過ぎると、4D によって自動的にセッションが閉じられます。 省略時のデフォルトは 60 (1時間) です。 60 (分) 未満の値を指定することはできません (60 未満の値を渡した場合、タイムアウトは 60 (分) に設定されます)。 詳細については、[**セッションの終了**](../ORDA/remoteDatastores.md#セッションの終了) を参照ください。 | -| tls | Boolean | 安全な接続を使用します(*)。 省略時のデフォルトは false です。 可能なかぎり安全な接続を使用することが推奨されます。 | -| passwordAlgorithm | Text | [`Validate password`](https://doc.4d.com/4dv20/help/command/ja/page638.html) コマンドで *digest* パラメーターを `true` に設定してサーバーがパスワードを検証する場合は、"4d-rest-digest" を指定します。 | -| type | Text | "4D Server" でなければなりません | +| プロパティ | 型 | 説明 | +| ----------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| hostname | Text | リモートデータストアの名前または IPアドレス + ":" + ポート番号 (ポート番号は必須) | +| user | Text | ユーザー名 | +| password | Text | ユーザーパスワード。デフォルトでは、パスワードは平文で送信されるため、`tls` プロパティに `true` を渡して暗号化通信を使用することが**強く推奨**されます。 | +| idleTimeout | Integer | アクティビティがなかった場合に、セッションがタイムアウトするまでの時間 (分単位)。 この時間を過ぎると、4D によって自動的にセッションが閉じられます。省略時のデフォルトは 60 (1時間) です。 60 (分) 未満の値を指定することはできません (60 未満の値を渡した場合、タイムアウトは 60 (分) に設定されます)。詳細については、[**セッションの終了**](../ORDA/remoteDatastores.md#セッションの終了) を参照ください。 | +| tls | Boolean | 安全な接続を使用します(*)。省略時のデフォルトは false です。可能なかぎり安全な接続を使用することが推奨されます。 | +| passwordAlgorithm | Text | [`Validate password`](https://doc.4d.com/4dv20/help/command/ja/page638.html) コマンドで *digest* パラメーターを `true` に設定してサーバーがパスワードを検証する場合は、"4d-rest-digest" を指定します。 | +| type | Text | "4D Server" でなければなりません | (*) tls が true だった場合、以下の条件が満たされていれば、HTTPSプロトコルが使用されます: * リモートデータストアで HTTPS が有効化されている。 * 指定されたポート番号は、データベース設定で設定されている HTTPS ポートと合致している。 -* データベースに有効な証明書と非公開暗号鍵がインストールされている。 条件を満たさない場合、エラー "1610 - ホスト xxx へのリモートリクエストに失敗しました" が生成されます。 +* データベースに有効な証明書と非公開暗号鍵がインストールされている。条件を満たさない場合、エラー "1610 - ホスト xxx へのリモートリクエストに失敗しました" が生成されます。 #### 例題 1 @@ -212,7 +212,7 @@ ALERT("They are "+String($foreignStudents.Students.all().length)+" foreign stude #### エラー管理 -エラーが起きた場合、コマンドは **Null** を返します。 リモートデータベースにアクセスできなかった場合 (アドレス違い、Webサーバーが開始されていない、http/https が有効化されていない、等)、エラー1610 "ホスト XXX へのリモートリクエストに失敗しました" が生成されます。 このエラーは `ON ERR CALL` で実装されたメソッドで割り込み可能です。 +エラーが起きた場合、コマンドは **Null** を返します。リモートデータベースにアクセスできなかった場合 (アドレス違い、Webサーバーが開始されていない、http/https が有効化されていない、等)、エラー1610 "ホスト XXX へのリモートリクエストに失敗しました" が生成されます。このエラーは `ON ERR CALL` で実装されたメソッドで割り込み可能です。 ## *.dataclassName* @@ -229,7 +229,7 @@ ALERT("They are "+String($foreignStudents.Students.all().length)+" foreign stude #### 説明 -データストアの各データクラスは [DataStore オブジェクト](ORDA/dsMapping.md#データストア) のプロパティとして利用可能です。 戻り値のオブジェクトには、 データクラスの詳細が格納されています。 +データストアの各データクラスは [DataStore オブジェクト](ORDA/dsMapping.md#データストア) のプロパティとして利用可能です。戻り値のオブジェクトには、 データクラスの詳細が格納されています。 #### 例題 @@ -275,7 +275,7 @@ ALERT("They are "+String($foreignStudents.Students.all().length)+" foreign stude `.cancelTransaction()` 関数は、トランザクション中におこなわれたデータ変更をすべてキャンセルします。 -複数のトランザクションをネストすること (サブトランザクション) が可能です。 メイントランザクションがキャンセルされると、サブトランザクションも (たとえ個々に[`.validateTransaction()`](#validatetransaction) 関数で承認されていても) すべてキャンセルされます。 +複数のトランザクションをネストすること (サブトランザクション) が可能です。メイントランザクションがキャンセルされると、サブトランザクションも (たとえ個々に[`.validateTransaction()`](#validatetransaction) 関数で承認されていても) すべてキャンセルされます。 #### 例題 @@ -309,7 +309,7 @@ ALERT("They are "+String($foreignStudents.Students.all().length)+" foreign stude `.clearAllRemoteContexts()` 関数は、 データストアのすべてのアクティブコンテキストの全属性をクリアします。 -この機能は主にデバッグで使用されます。 注意しなければならないのは、デバッガーを開くと、デバッガーはサーバーにリクエストを送り、データクラス属性をすべてクエリして表示することです。 このため、不要なデータでコンテキストが過負荷になることがあります。 +この機能は主にデバッグで使用されます。注意しなければならないのは、デバッガーを開くと、デバッガーはサーバーにリクエストを送り、データクラス属性をすべてクエリして表示することです。このため、不要なデータでコンテキストが過負荷になることがあります。 そのような場合は、`.clearAllRemoteContexts()` を使用してコンテキストをクリアし、クリーンな状態を保つことができます。 @@ -342,7 +342,7 @@ ALERT("They are "+String($foreignStudents.Students.all().length)+" foreign stude #### 説明 -`.encryptionStatus()` 関数は、 カレントデータファイルの暗号化状態を示すオブジェクトを返します 。 カレントデータファイルとはつまり、`ds` データストアのデータファイルです。 各テーブルの状態も提供されます。 +`.encryptionStatus()` 関数は、 カレントデータファイルの暗号化状態を示すオブジェクトを返します 。 カレントデータファイルとはつまり、`ds` データストアのデータファイルです。各テーブルの状態も提供されます。 > その他のデータファイルの暗号化状態を調べるには、`Data file encryption status` コマンドを使います。 **戻り値** @@ -419,7 +419,7 @@ ALERT("They are "+String($foreignStudents.Students.all().length)+" foreign stude #### 説明 -`.flushAndLock()` 関数は、 ローカルデータストアのキャッシュをフラッシュし、データベースに対して他のプロセスが書き込み操作をおこなうのを防ぎます。 これにより、データストアは凍結状態におかれます。 この関数は、たとえばアプリケーションのスナップショットを実行する前に呼び出す必要があります。 +`.flushAndLock()` 関数は、 ローカルデータストアのキャッシュをフラッシュし、データベースに対して他のプロセスが書き込み操作をおこなうのを防ぎます。これにより、データストアは凍結状態におかれます。この関数は、たとえばアプリケーションのスナップショットを実行する前に呼び出す必要があります。 :::info @@ -447,7 +447,7 @@ ALERT("They are "+String($foreignStudents.Students.all().length)+" foreign stude :::caution -[バックアップ](../Backup/backup.md) や [VSS](https://doc.4d.com/4Dv19R7/4D/19-R7/Using-Volume-Shadow-Copy-Service-on-Windows.300-6078959.ja.html) 、[MSC](../MSC/overview.md) を含む他の 4D機能およびサービスもデータストアをロックすることがあります。 予期せぬ相互作用を避けるため、`.flushAndLock()` を呼び出す前に、データストアをロックするような他の操作がおこなわれていないことを確認してください。 +[バックアップ](../Backup/backup.md) や [VSS](https://doc.4d.com/4Dv19R7/4D/19-R7/Using-Volume-Shadow-Copy-Service-on-Windows.300-6078959.ja.html) 、[MSC](../MSC/overview.md) を含む他の 4D機能およびサービスもデータストアをロックすることがあります。予期せぬ相互作用を避けるため、`.flushAndLock()` を呼び出す前に、データストアをロックするような他の操作がおこなわれていないことを確認してください。 ::: @@ -498,7 +498,7 @@ ds.unlock() // コピー操作をおこなったので、データストアの -> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。 ほとんどの場合、使用する必要はないでしょう。 +> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。ほとんどの場合、使用する必要はないでしょう。 #### 説明 @@ -579,16 +579,16 @@ $info:=$ds.getAllRemoteContexts() #### 説明 -`.getInfo()` 関数は、 データストアの情報を提供するオブジェクトを返します。 このメソッドは汎用的なコードを書くのに有用です。 +`.getInfo()` 関数は、 データストアの情報を提供するオブジェクトを返します。このメソッドは汎用的なコードを書くのに有用です。 **返されるオブジェクト** -| プロパティ | 型 | 説明 | -| ---------- | ------- | ----------------------------------------------------------------------------------------- | -| type | string |
  • "4D": ds で利用可能なメインデータストア
  • "4D Server": Open datastore で開かれたリモートデータストア
    • | -| networked | boolean |
  • true: ネットワーク接続を介してアクセスされたデータストア
  • false: ネットワーク接続を介さずにアクセスしているデータストア (ローカルデータベース)
    • | -| localID | text | マシン上のデータストアID。 これは、`Open datastore` コマンドで返される localId 文字列です。 メインデータストアの場合は空の文字列 ("") です。 | -| connection | object | リモートデータストア接続の情報を格納したオブジェクト (メインデータストアの場合は返されません)。 次のプロパティを含みます:
    プロパティ型説明
    hostnametextリモートデータストアの IPアドレスまたは名称 + ":" + ポート番号
    tlsbooleanリモートデータストアとセキュア接続を利用している場合は true
    idleTimeoutnumberセッション非アクティブタイムアウト (分単位)。
    usertextリモートデータストアにて認証されたユーザー
    | +| プロパティ | 型 | 説明 | +| ---------- | ------- | ---------------------------------------------------------------------------------------- | +| type | string |
  • "4D": ds で利用可能なメインデータストア
  • "4D Server": Open datastore で開かれたリモートデータストア
    • | +| networked | boolean |
  • true: ネットワーク接続を介してアクセスされたデータストア
  • false: ネットワーク接続を介さずにアクセスしているデータストア (ローカルデータベース)
    • | +| localID | text | マシン上のデータストアID。これは、`Open datastore` コマンドで返される localId 文字列です。メインデータストアの場合は空の文字列 ("") です。 | +| connection | object | リモートデータストア接続の情報を格納したオブジェクト (メインデータストアの場合は返されません)。次のプロパティを含みます:
    プロパティ型説明
    hostnametextリモートデータストアの IPアドレスまたは名称 + ":" + ポート番号
    tlsbooleanリモートデータストアとセキュア接続を利用している場合は true
    idleTimeoutnumberセッション非アクティブタイムアウト (分単位)。
    usertextリモートデータストアにて認証されたユーザー
    | * `.getInfo()` 関数が、4D Server またはシングルユーザー版 4D 上で実行された場合、`networked` は false となります。 * `.getInfo()` 関数が、リモート版 4D 上で実行された場合、`networked` は true となります。 @@ -649,7 +649,7 @@ $info:=$remoteDS.getInfo() -> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。 ほとんどの場合、使用する必要はないでしょう。 +> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。ほとんどの場合、使用する必要はないでしょう。 #### 説明 @@ -661,12 +661,12 @@ $info:=$remoteDS.getInfo() 戻り値のオブジェクトには、以下のプロパティが格納されています: -| プロパティ | 型 | 説明 | -| ---------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| name | Text | コンテキストの名称 | -| main | Text | コンテキストに関連する属性 (複数の場合はカンマ区切り) | -| dataclass | Text | データクラスの名称 | -| currentItem (任意) | Text | コンテキストがリストボックスとリンクしている場合の [ページモード](../ORDA/remoteDatastores.md#エンティティセレクション型リストボックス) の属性。 コンテキスト名がリストボックスに使用されていない場合、または currentItem に対応するコンテキストが存在しない場合は、`Null` または空のテキスト要素として返されます。 | +| プロパティ | 型 | 説明 | +| ---------------- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| name | Text | コンテキストの名称 | +| main | Text | コンテキストに関連する属性 (複数の場合はカンマ区切り) | +| dataclass | Text | データクラスの名称 | +| currentItem (任意) | Text | コンテキストがリストボックスとリンクしている場合の [ページモード](../ORDA/remoteDatastores.md#エンティティセレクション型リストボックス) の属性。コンテキスト名がリストボックスに使用されていない場合、または currentItem に対応するコンテキストが存在しない場合は、`Null` または空のテキスト要素として返されます。 | コンテキストは属性に対するフィルターとして動作するため、*main* が空で返された場合、それはフィルターが適用されておらず、サーバーがすべてのデータクラス属性を返すことを意味します。 @@ -705,11 +705,11 @@ $info:=$remoteDS.getInfo() `.getRequestLog()` 関数は、 クライアント側のメモリに記録されている ORDAリクエストを返します。 ORDAリクエストのログが、[`.startRequestLog()`](#startrequestlog) 関数によって事前に有効化されている必要があります。 -このメソッドはリモートの 4D で呼び出す必要があり、そうでない場合には空のコレクションを返します。 これはクライアント/サーバー環境でのデバッグを想定して設計されています。 +このメソッドはリモートの 4D で呼び出す必要があり、そうでない場合には空のコレクションを返します。これはクライアント/サーバー環境でのデバッグを想定して設計されています。 **戻り値** -スタックされたリクエストオブジェクトのコレクションが返されます。 直近のリクエストにはインデックス 0 が振られています。 +スタックされたリクエストオブジェクトのコレクションが返されます。直近のリクエストにはインデックス 0 が振られています。 ORDAリクエストログのフォーマットの詳細は、[**ORDAクライアントリクエスト**](https://doc.4d.com/4Dv18R6/4D/18-R6/Description-of-log-files.300-5217819.ja.html#4385373) の章を参照ください。 @@ -822,13 +822,13 @@ ORDAリクエストログのフォーマットの詳細は、[**ORDAクライア #### 説明 -`.makeSelectionsAlterable()` 関数は、 カレントアプリケーションのデータストアにおいて、すべての新規エンティティセレクションをデフォルトで追加可能に設定します ([リモートデータストア](ORDA/remoteDatastores.md) を含む)。 これはたとえば `On Startup` データベースメソッドなどで、一度だけ使用することが想定されています。 +`.makeSelectionsAlterable()` 関数は、 カレントアプリケーションのデータストアにおいて、すべての新規エンティティセレクションをデフォルトで追加可能に設定します ([リモートデータストア](ORDA/remoteDatastores.md) を含む)。これはたとえば `On Startup` データベースメソッドなどで、一度だけ使用することが想定されています。 この関数が呼ばれなかった場合、新規エンティティセレクションが共有可能かどうかは、共有可能エンティティセレクションを"元"にしたのか、あるいは[どんな関数を呼び出して作成したのか](ORDA/entities.md#共有可能追加可能なエンティティセレクション)で決まります。 > この関数は、`OB Copy` または [`.copy()`](./EntitySelectionClass.md#copy) に `ck shared` オプションを明示的に使用して作成されたエンティティセレクションには適用されません。 -> **互換性に関する注記**: このメソッドは 4D v18 R5 より前のバージョンから変換されたプロジェクトで、[.add()](EntitySelectionClass.md#add) の呼び出しを使用しているものにおいてのみ使用してください。 このコンテキストにおいては、`.makeSelectionsAlterable()` を使用することで、既存プロジェクト内で以前の 4D のふるまいを再現し、時間を節約できます。 逆に、4D v18 R5 以降のバージョンで作成された新規プロジェクトにおいては、この関数の使用は **推奨されていません**。 エンティティセレクションを共有可能にできないため、パフォーマンスとスケーラビリティの観点で妨げになるからです。 +> **互換性に関する注記**: このメソッドは 4D v18 R5 より前のバージョンから変換されたプロジェクトで、[.add()](EntitySelectionClass.md#add) の呼び出しを使用しているものにおいてのみ使用してください。このコンテキストにおいては、`.makeSelectionsAlterable()` を使用することで、既存プロジェクト内で以前の 4D のふるまいを再現し、時間を節約できます。逆に、4D v18 R5 以降のバージョンで作成された新規プロジェクトにおいては、この関数の使用は **推奨されていません**。 エンティティセレクションを共有可能にできないため、パフォーマンスとスケーラビリティの観点で妨げになるからです。 @@ -859,13 +859,13 @@ ORDAリクエストログのフォーマットの詳細は、[**ORDAクライア #### 説明 -`.provideDataKey()` 関数は、 データストアのカレントデータファイルのデータ暗号化キーを受け取り、暗号化されたデータと合致するかどうかチェックします。 この関数は、暗号化されたデータベースを開くときや、データファイルの再暗号化など暗号化キーが必要となる暗号化オペレーションを実行する際に使用します。 -> * `.provideDataKey()` 関数は暗号化されたデータベース内で呼び出される必要があります。 暗号化されていないデータベース内で呼び出した場合、エラー2003 (暗号化キーはデータと合致しません) が返されます。 データベースが暗号化されているかどうかを調べるには `Data file encryption status` コマンドを使用します。 +`.provideDataKey()` 関数は、 データストアのカレントデータファイルのデータ暗号化キーを受け取り、暗号化されたデータと合致するかどうかチェックします。この関数は、暗号化されたデータベースを開くときや、データファイルの再暗号化など暗号化キーが必要となる暗号化オペレーションを実行する際に使用します。 +> * `.provideDataKey()` 関数は暗号化されたデータベース内で呼び出される必要があります。暗号化されていないデータベース内で呼び出した場合、エラー2003 (暗号化キーはデータと合致しません) が返されます。データベースが暗号化されているかどうかを調べるには `Data file encryption status` コマンドを使用します。 > * リモートの 4D または暗号化されたリモートデータストアから、`.provideDataKey()` 関数を呼び出すことはできません。 -*curPassPhrase* パラメーターを使用する場合は、データ暗号化キーの生成に使用した文字列を渡します。 このパラメーターを使用した場合、暗号化キーが生成されます。 +*curPassPhrase* パラメーターを使用する場合は、データ暗号化キーの生成に使用した文字列を渡します。このパラメーターを使用した場合、暗号化キーが生成されます。 -*curDataKey* パラメーターを使用する場合は、データ暗号化キー (*encodedKey* プロパティ) を格納するオブジェクトを渡します。 このキーは、`New data key` コマンドで生成された可能性があります。 +*curDataKey* パラメーターを使用する場合は、データ暗号化キー (*encodedKey* プロパティ) を格納するオブジェクトを渡します。このキーは、`New data key` コマンドで生成された可能性があります。 有効な暗号化キーが提供された場合、そのキーはメモリ内の *keyChain* に追加され、暗号化モードが有効になります: @@ -882,7 +882,7 @@ ORDAリクエストログのフォーマットの詳細は、[**ORDAクライア | | | | 以下のプロパティは、success が *FALSE* であった場合にのみ返されます。 | | status | | Number | エラーコード (提供された暗号化キーが間違っていた場合には 4) | | statusText | | Text | エラーメッセージ | -| errors | | Collection | エラーのスタック。 最初のエラーに最も高いインデックスが割り当てられます。 | +| errors | | Collection | エラーのスタック。最初のエラーに最も高いインデックスが割り当てられます。 | | | \[ ].componentSignature | Text | 内部コンポーネント名 | | | \[ ].errCode | Number | エラー番号 | | | \[ ].message | Text | エラーメッセージ | @@ -934,9 +934,9 @@ ORDAリクエストログのフォーマットの詳細は、[**ORDAクライア `.setAdminProtection()` 関数は、 `WebAdmin`セッションにおける [データエクスプローラー](Admin/dataExplorer.md) 含め、[Web管理ポート](Admin/webAdmin.md#httpポート)上でのデータアクセスを無効に設定することができます。 -この関数が呼び出されなかった場合のデフォルトでは、データエクスプローラーを使用した `WebAdmin` 権限を持つセッションについて、Web管理ポート上のデータアクセスは常に許可されます。 環境によっては (たとえば、アプリケーションサーバーが第三者のマシン上でホストされている場合)、 管理者に対して [access key](Admin/webAdmin.md#access-key) 設定を含むサーバー設定の編集は許可しても、データ閲覧はできないようにしたいかもしれません。 +この関数が呼び出されなかった場合のデフォルトでは、データエクスプローラーを使用した `WebAdmin` 権限を持つセッションについて、Web管理ポート上のデータアクセスは常に許可されます。環境によっては (たとえば、アプリケーションサーバーが第三者のマシン上でホストされている場合)、 管理者に対して [access key](Admin/webAdmin.md#access-key) 設定を含むサーバー設定の編集は許可しても、データ閲覧はできないようにしたいかもしれません。 -このような場合にこの関数を呼び出すことで、ユーザーセッションが `WebAdmin` 権限を持っていても、マシンの Web管理ポート上でのデータエクスプローラーによるデータアクセスを無効にすることができます。 この関数を実行するとデータファイルは即座に保護され、そのステータスがディスク上に保存されます: アプリケーションを再起動しても、データファイルは保護されたままです。 +このような場合にこの関数を呼び出すことで、ユーザーセッションが `WebAdmin` 権限を持っていても、マシンの Web管理ポート上でのデータエクスプローラーによるデータアクセスを無効にすることができます。この関数を実行するとデータファイルは即座に保護され、そのステータスがディスク上に保存されます: アプリケーションを再起動しても、データファイルは保護されたままです。 #### 例題 @@ -981,11 +981,11 @@ ORDAリクエストログのフォーマットの詳細は、[**ORDAクライア -> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。 ほとんどの場合、使用する必要はないでしょう。 +> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。ほとんどの場合、使用する必要はないでしょう。 #### 説明 -`.setRemoteContextInfo()` 関数は、 指定したデータクラス属性を *contextName* の最適化コンテキストにリンクします。 指定した属性に対して最適化コンテキストが既に存在する場合、このコマンドはそれを置き換えます。 +`.setRemoteContextInfo()` 関数は、 指定したデータクラス属性を *contextName* の最適化コンテキストにリンクします。指定した属性に対して最適化コンテキストが既に存在する場合、このコマンドはそれを置き換えます。 ORDAクラスの関数にコンテキストを渡すと、RESTリクエストの最適化が即座に発動します: @@ -1000,16 +1000,16 @@ ORDAクラスの関数にコンテキストを渡すと、RESTリクエストの コンテキストにリンクする属性を指定するには、*attributes* (テキスト) にカンマ区切りの属性リストを渡すか、属性名のコレクションを *attributesColl* (テキストのコレクション) に渡します。 -*attributes* が空のテキスト、または *attributesColl* が空のコレクションの場合、データクラスのすべてのスカラー属性が最適化コンテキストに置かれます。 データクラスに存在しない属性を渡した場合、それは無視され、エラーが返されます。 +*attributes* が空のテキスト、または *attributesColl* が空のコレクションの場合、データクラスのすべてのスカラー属性が最適化コンテキストに置かれます。データクラスに存在しない属性を渡した場合、それは無視され、エラーが返されます。 *contextType* を渡して、コンテキストが標準コンテキストか、リストボックスに表示されているカレントエンティティセレクション項目のコンテキストかを指定することができます。 * "main" (デフォルト) を渡すと、*contextName* は標準コンテキストを指定します。 -* "currentItem" の場合には、渡された属性はカレント項目のコンテキストに置かれます。 [エンティティセレクション型リストボックス](../ORDA/remoteDatastores.md#エンティティセレクション型リストボックス) を参照ください。 +* "currentItem" の場合には、渡された属性はカレント項目のコンテキストに置かれます。[エンティティセレクション型リストボックス](../ORDA/remoteDatastores.md#エンティティセレクション型リストボックス) を参照ください。 *pageLength* には、サーバーに要求するデータクラスエンティティの数を指定します。 -エンティティセレクションであるリレーション属性 (1対N) について、*pageLength* を渡すことができます。 シンタックスは、`relationAttributeName:pageLength` です (例: employees:20)。 +エンティティセレクションであるリレーション属性 (1対N) について、*pageLength* を渡すことができます。シンタックスは、`relationAttributeName:pageLength` です (例: employees:20)。 #### 例題 1 @@ -1044,7 +1044,7 @@ $info:=$ds.getRemoteContextInfo("contextA") #### 例題 2 -以下のコードでは、`Address` データクラスのエンティティ 30件のページをサーバーに要求しています。 返されるエンティティは、`zipCode` 属性のみを含みます。 +以下のコードでは、`Address` データクラスのエンティティ 30件のページをサーバーに要求しています。返されるエンティティは、`zipCode` 属性のみを含みます。 各 `Address` エンティティに対して、20件の Persons エンティティが返され、それらには `lastname` と `firstname` 属性のみが含まれます: @@ -1113,7 +1113,7 @@ Form.currentItemLearntAttributes:=Form.selectedPerson.getRemoteContextAttributes #### 説明 -`.startRequestLog()` 関数は、 クライアント側またはサーバー側で ORDAリクエストのログを開始します。 これはクライアント/サーバー環境でのデバッグを想定して設計されています。 +`.startRequestLog()` 関数は、 クライアント側またはサーバー側で ORDAリクエストのログを開始します。これはクライアント/サーバー環境でのデバッグを想定して設計されています。 :::info @@ -1123,21 +1123,21 @@ ORDAリクエストログのフォーマットの詳細は、[**ORDAリクエス #### クライアント側 -クライアント側の ORDAリクエストログを作成するには、リモートマシン上でこの関数を呼び出します。 ログは、渡した引数によってファイルまたはメモリに送ることができます: +クライアント側の ORDAリクエストログを作成するには、リモートマシン上でこの関数を呼び出します。ログは、渡した引数によってファイルまたはメモリに送ることができます: -* `File` コマンドで作成された *file* オブジェクトを渡した場合、ログデータはオブジェクト (JSON フォーマット) のコレクションとしてこのファイルに書き込まれます。 各オブジェクトは一つのリクエストを表します。
    ファイルがまだ存在しない場合には、作成されます。 もしファイルが既に存在する場合、新しいログデータはそこに追加されていきます。 メモリへのログ記録が既に始まっている状態で、 `.startRequestLog()`が file 引数付きで呼び出された場合、メモリに記録されていたログは停止され消去されます。 +* `File` コマンドで作成された *file* オブジェクトを渡した場合、ログデータはオブジェクト (JSON フォーマット) のコレクションとしてこのファイルに書き込まれます。各オブジェクトは一つのリクエストを表します。
    ファイルがまだ存在しない場合には、作成されます。もしファイルが既に存在する場合、新しいログデータはそこに追加されていきます。メモリへのログ記録が既に始まっている状態で、 `.startRequestLog()`が file 引数付きで呼び出された場合、メモリに記録されていたログは停止され消去されます。 > JSON 評価を実行するには、ファイルの終わりに手動で \] 文字を追加する必要があります。 -* 引数を何も渡さなかった場合、ログはメモリに記録されていきます。 前もって `.startRequestLog()` が*reqNum* 引数付きで 呼び出されていた場合 (ただし `.stopRequestLog()` の前)、ログが次回消去されるかまたは`.stopRequestLog()` が呼び出されるまで、ログデータはメモリ内にスタックされます。 +* 引数を何も渡さなかった場合、ログはメモリに記録されていきます。前もって `.startRequestLog()` が*reqNum* 引数付きで 呼び出されていた場合 (ただし `.stopRequestLog()` の前)、ログが次回消去されるかまたは`.stopRequestLog()` が呼び出されるまで、ログデータはメモリ内にスタックされます。 * 引数を何も渡さなかった場合、ログはメモリに記録されていきます。
    ファイルへのログ記録が既に始まっている状態で、`.startRequestLog()` が *reqNum* 引数付きで呼び出された場合、ファイルへのログは停止されます。 #### サーバー側 -サーバー側の ORDAリクエストログを作成するには、サーバーマシン上でこの関数を呼び出します。 ログは、`.jsonl` 形式のファイルに書き込まれます。 各オブジェクトは 1つのリクエストを表します。 ファイルが存在しない場合は、作成されます。 もしファイルが既に存在する場合、新しいログデータはそこに追加されていきます。 +サーバー側の ORDAリクエストログを作成するには、サーバーマシン上でこの関数を呼び出します。ログは、`.jsonl` 形式のファイルに書き込まれます。各オブジェクトは 1つのリクエストを表します。ファイルが存在しない場合は、作成されます。もしファイルが既に存在する場合、新しいログデータはそこに追加されていきます。 - *file* 引数を渡した場合、ログデータはこのファイルの指定位置に書き込まれます。 - *file* 引数を省略した場合、または引数が NULL の場合、ログデータは *ordaRequests.jsonl* という名前のファイルに書き込まれ、"/LOGS" フォルダーに保存されます。 -- *options* 引数を使って、サーバーのレスポンスをログに記録するかどうか、および本文をログに含めるかどうかを指定することができます。 引数を省略した場合のデフォルトでは、全レスポンスがログに記録されます。 この引数には、以下の定数を使用することができます: +- *options* 引数を使って、サーバーのレスポンスをログに記録するかどうか、および本文をログに含めるかどうかを指定することができます。引数を省略した場合のデフォルトでは、全レスポンスがログに記録されます。この引数には、以下の定数を使用することができます: | 定数 | 説明 | | ----------------------------- | ----------------------- | @@ -1228,10 +1228,10 @@ SET DATABASE PARAMETER(4D Server Log Recording;0) #### 説明 -`.startTransaction()` 関数は、 対象データストアに対応するデータベース上で、カレントプロセス内のトランザクションを開始します。 トランザクションプロセス中にデータストアのエンティティに加えられた変更は、トランザクションが確定されるかキャンセルされるまで一時的に保管されたままになります。 +`.startTransaction()` 関数は、 対象データストアに対応するデータベース上で、カレントプロセス内のトランザクションを開始します。トランザクションプロセス中にデータストアのエンティティに加えられた変更は、トランザクションが確定されるかキャンセルされるまで一時的に保管されたままになります。 > このメソッドがメインのデータストア (`ds` コマンドで返されるデータストア) で呼ばれた場合、トランザクションはメインのデータストアとそのデータベースで実行されるすべてのオペレーションに適用されます。 これには、そこで実行される ORDA とクラシック言語も含まれます。 -複数のトランザクションをネストすること (サブトランザクション) が可能です。 個々のトランザクションまたはサブトランザクションは、それぞれキャンセルするか確定される必要があります。 メイントランザクションがキャンセルされると、サブトランザクションも (たとえ個々に`.validateTransaction()` 関数で承認されていても) すべてキャンセルされます。 +複数のトランザクションをネストすること (サブトランザクション) が可能です。個々のトランザクションまたはサブトランザクションは、それぞれキャンセルするか確定される必要があります。メイントランザクションがキャンセルされると、サブトランザクションも (たとえ個々に`.validateTransaction()` 関数で承認されていても) すべてキャンセルされます。 #### 例題 @@ -1296,7 +1296,7 @@ End if `.stopRequestLog()` 関数は、 クライアント側またはサーバー側の ORDAリクエストのログをすべて停止します。 -実際には、ディスク上で開かれているドキュメントを閉じます。 クライアント側で、メモリ上でログの記録が開始されていた場合、そのログを停止します。 +実際には、ディスク上で開かれているドキュメントを閉じます。クライアント側で、メモリ上でログの記録が開始されていた場合、そのログを停止します。 ORDAリクエストログがマシン上で開始されていない場合、この関数は何もしません。 @@ -1333,7 +1333,7 @@ ORDAリクエストログがマシン上で開始されていない場合、こ #### 説明 -`.unlock()` 関数は、 データストアにおける、書き込み操作に対する現在のロックが同じプロセスで設定されていた場合、そのロックを解除します。 ローカルデータストアの書き込み操作は、[`.flushAndLock()`](#flushandlock) 関数を使用してロックすることができます。 +`.unlock()` 関数は、 データストアにおける、書き込み操作に対する現在のロックが同じプロセスで設定されていた場合、そのロックを解除します。ローカルデータストアの書き込み操作は、[`.flushAndLock()`](#flushandlock) 関数を使用してロックすることができます。 現在のロックがデータストアの唯一のロックであった場合、書き込み操作は直ちに可能になります。 `.flushAndLock()` 関数がプロセス内で複数回呼ばれている場合、データストアのロックを解除するには、同じ回数だけ `.unlock()` を呼び出す必要があります。 @@ -1376,7 +1376,7 @@ ORDAリクエストログがマシン上で開始されていない場合、こ この関数は、トランザクション中におこなわれたデータストア上のデータの変更を保存します。 -複数のトランザクションをネストすること (サブトランザクション) が可能です。 メイントランザクションがキャンセルされると、サブトランザクションも (たとえ個々にこの関数で承認されていても) すべてキャンセルされます。 +複数のトランザクションをネストすること (サブトランザクション) が可能です。メイントランザクションがキャンセルされると、サブトランザクションも (たとえ個々にこの関数で承認されていても) すべてキャンセルされます。 #### 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/Directory.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/Directory.md index 8fc0f3c9a85608..918fc573c7bbf6 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/Directory.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/Directory.md @@ -84,7 +84,7 @@ title: Directory クラス #### 説明 -`.extension` プロパティは、 フォルダー名の拡張子を返します (あれば)。 拡張子は必ず"." で始まります。 フォルダー名が拡張子を持たない場合には、このプロパティは空の文字列を返します。 +`.extension` プロパティは、 フォルダー名の拡張子を返します (あれば)。拡張子は必ず"." で始まります。フォルダー名が拡張子を持たない場合には、このプロパティは空の文字列を返します。 このプロパティは **読み取り専用** です。 @@ -218,7 +218,7 @@ title: Directory クラス #### 説明 -`.isPackage` プロパティは、 フォルダーが macOS上のパッケージである (かつディスク上に存在している) 場合に true を返します。 それ以外の場合は false を返します。 +`.isPackage` プロパティは、 フォルダーが macOS上のパッケージである (かつディスク上に存在している) 場合に true を返します。それ以外の場合は false を返します。 Windows 上においては、`.isPackage` は常に **false** を返します。 @@ -331,7 +331,7 @@ Windows 上においては、`.isPackage` は常に **false** を返します。 #### 説明 -`.parent` プロパティは、 対象フォルダーの親フォルダーオブジェクトを返します。 パスがシステムパスを表す場合 (例: "/DATA/")、システムパスが返されます。 +`.parent` プロパティは、 対象フォルダーの親フォルダーオブジェクトを返します。パスがシステムパスを表す場合 (例: "/DATA/")、システムパスが返されます。 親フォルダーが存在しない場合 (root) は、このプロパティは null値を返します。 @@ -355,7 +355,7 @@ Windows 上においては、`.isPackage` は常に **false** を返します。 #### 説明 -`.path` プロパティは、 フォルダーの POSIXパスを返します。 パスがファイルシステムを表す場合 (例: "/DATA/")、ファイルシステムが返されます。 +`.path` プロパティは、 フォルダーの POSIXパスを返します。パスがファイルシステムを表す場合 (例: "/DATA/")、ファイルシステムが返されます。 このプロパティは **読み取り専用** です。 @@ -416,7 +416,7 @@ Windows 上においては、`.isPackage` は常に **false** を返します。 *destinationFolder* 引数が指定するフォルダーはディスク上に存在している必要があり、そうでない場合にはエラーが生成されます。 -デフォルトで、フォルダーは元の名前を維持したままコピーされます。 コピーの際にフォルダー名を変更したい場合、新しい名前を *newName* に渡します。 新しい名前は命名規則に則っている必要があります (例: ":", "/", 等の文字を含んでいない、など)。 そうでない場合、エラーが返されます。 +デフォルトで、フォルダーは元の名前を維持したままコピーされます。コピーの際にフォルダー名を変更したい場合、新しい名前を *newName* に渡します。新しい名前は命名規則に則っている必要があります (例: ":", "/", 等の文字を含んでいない、など)。 そうでない場合、エラーが返されます。 *destinationFolder* 引数が指定するフォルダー内に同じ名前のフォルダーが既に存在する場合、4D はデフォルトでエラーを生成します。 *overwrite* に `fk overwrite` 定数を渡すことで、既存のフォルダーを無視して上書きすることができます: @@ -469,7 +469,7 @@ $copiedImages:=$userImages.copyTo(Folder(fk database folder);fk overwrite) `.file()` 関数は、 `Folder` オブジェクト内に `File` オブジェクトを作成し、その参照を返します。 -*path* には、返すべきファイルの相対的パスを POSIX 形式で渡します。 このパスは、親フォルダーを起点として評価されます。 +*path* には、返すべきファイルの相対的パスを POSIX 形式で渡します。このパスは、親フォルダーを起点として評価されます。 **戻り値** @@ -579,7 +579,7 @@ $myPDF:=Folder(fk documents folder).file("Pictures/info.pdf") `.folder()` 関数は、 親の `Folder` オブジェクト内に新しい `Folder` オブジェクトを作成し、その参照を返します。 -*path* には、返すべきフォルダーの相対的パスを POSIX 形式で渡します。 このパスは、親フォルダーを起点として評価されます。 +*path* には、返すべきフォルダーの相対的パスを POSIX 形式で渡します。このパスは、親フォルダーを起点として評価されます。 **戻り値** @@ -674,7 +674,7 @@ $myPDF:=Folder(fk documents folder).file("Pictures/info.pdf") `.getIcon()` 関数は、 フォルダーのアイコンを返します。 -任意の *size* 引数を渡すと、返されるアイコンのサイズをピクセル単位で指定することができます。 この値は、実際にはアイコンを格納している正方形の一辺の長さを表しています。 アイコンは通常、32x32ピクセル ("大きいアイコン") または 16x16ピクセル ("小さいアイコン") で定義されています。 この引数に 0 を渡すか省略した場合、"大きいアイコン" が返されます。 +任意の *size* 引数を渡すと、返されるアイコンのサイズをピクセル単位で指定することができます。この値は、実際にはアイコンを格納している正方形の一辺の長さを表しています。アイコンは通常、32x32ピクセル ("大きいアイコン") または 16x16ピクセル ("小さいアイコン") で定義されています。この引数に 0 を渡すか省略した場合、"大きいアイコン" が返されます。 フォルダーがディスク上に存在しない場合、デフォルトの空のアイコンが返されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/Document.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/Document.md index 21a8684e3c954f..655e92d35516e3 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/Document.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/Document.md @@ -80,7 +80,7 @@ title: Document クラス #### 説明 -`.extension` プロパティは、 ファイル名の拡張子を返します (あれば)。 拡張子は必ず"." で始まります。 ファイル名が拡張子を持たない場合には、このプロパティは空の文字列を返します。 +`.extension` プロパティは、 ファイル名の拡張子を返します (あれば)。拡張子は必ず"." で始まります。ファイル名が拡張子を持たない場合には、このプロパティは空の文字列を返します。 このプロパティは **読み取り専用** です。 @@ -290,7 +290,7 @@ title: Document クラス #### 説明 -`.original` プロパティは、 エイリアス、ショートカット、シンボリックリンクファイルのターゲット要素を返します。 ターゲット要素は以下のいずれかです: +`.original` プロパティは、 エイリアス、ショートカット、シンボリックリンクファイルのターゲット要素を返します。ターゲット要素は以下のいずれかです: * File オブジェクト * Folder オブジェクト @@ -315,7 +315,7 @@ title: Document クラス #### 説明 -`.parent` プロパティは、 `.parent` プロパティは、。 パスがシステムパスを表す場合 (例: "/DATA/")、システムパスが返されます。 +`.parent` プロパティは、 `.parent` プロパティは、。パスがシステムパスを表す場合 (例: "/DATA/")、システムパスが返されます。 このプロパティは **読み取り専用** です。 @@ -335,7 +335,7 @@ title: Document クラス #### 説明 -`.path` プロパティは、 `.path` プロパティは、。 パスがファイルシステムを表す場合 (例: "/DATA/")、ファイルシステムが返されます。 +`.path` プロパティは、 `.path` プロパティは、。パスがファイルシステムを表す場合 (例: "/DATA/")、ファイルシステムが返されます。 このプロパティは **読み取り専用** です。 @@ -375,7 +375,7 @@ title: Document クラス #### 説明 -`.size` プロパティは、 ファイルのサイズ (バイト単位) を返します。 ファイルがディスク上に存在しない場合、サイズは 0 になります。 +`.size` プロパティは、 ファイルのサイズ (バイト単位) を返します。ファイルがディスク上に存在しない場合、サイズは 0 になります。 このプロパティは **読み取り専用** です。 @@ -412,7 +412,7 @@ title: Document クラス *destinationFolder* 引数が指定するフォルダーはディスク上に存在している必要があり、そうでない場合にはエラーが生成されます。 -デフォルトで、ファイルは元の名前を維持したままコピーされます。 コピーの際にフォルダー名を変更したい場合、新しい名前を *newName* に渡します。 新しい名前は命名規則に則っている必要があります (例: ":", "/", 等の文字を含んでいない、など)。 そうでない場合、エラーが返されます。 +デフォルトで、ファイルは元の名前を維持したままコピーされます。コピーの際にフォルダー名を変更したい場合、新しい名前を *newName* に渡します。新しい名前は命名規則に則っている必要があります (例: ":", "/", 等の文字を含んでいない、など)。 そうでない場合、エラーが返されます。 *destinationFolder* 引数が指定するフォルダー内に同じ名前のファイルが既に存在する場合、4D はデフォルトでエラーを生成します。 *overwrite* に `fk overwrite` 定数を渡すことで、既存のフォルダーを無視して上書きすることができます: @@ -508,7 +508,7 @@ $copy:=$source.copyTo(Folder("/PACKAGE");fk overwrite) `.getIcon()` 関数は、 ファイルのアイコンを返します。 -任意の *size* 引数を渡すと、返されるアイコンのサイズをピクセル単位で指定することができます。 この値は、実際にはアイコンを格納している正方形の一辺の長さを表しています。 アイコンは通常、32x32ピクセル ("大きいアイコン") または 16x16ピクセル ("小さいアイコン") で定義されています。 この引数に 0 を渡すか省略した場合、"大きいアイコン" が返されます。 +任意の *size* 引数を渡すと、返されるアイコンのサイズをピクセル単位で指定することができます。この値は、実際にはアイコンを格納している正方形の一辺の長さを表しています。アイコンは通常、32x32ピクセル ("大きいアイコン") または 16x16ピクセル ("小さいアイコン") で定義されています。この引数に 0 を渡すか省略した場合、"大きいアイコン" が返されます。 ファイルがディスク上に存在しない場合、デフォルトの空のアイコンが返されます。 @@ -547,14 +547,14 @@ $copy:=$source.copyTo(Folder("/PACKAGE");fk overwrite) `.getText()` 関数は、 ファイルのコンテンツをテキストとして返します 。 -任意で、コンテンツの読み取りに使用する文字セットを渡します。 これには、次の二つの方法があります: +任意で、コンテンツの読み取りに使用する文字セットを渡します。これには、次の二つの方法があります: * *charSetName* に標準の文字セット名を含んだ文字列 ("ISO-8859-1" や "UTF-8" など) を渡します。 * *charSetNum* に標準の文字セット名の MIBEnum ID (倍長整数) を渡します。 > 4D によってサポートされている文字セットの一覧については、`CONVERT FROM TEXT` コマンドを参照ください。 -ドキュメントにバイトオーダーマーク (BOM) が含まれている場合、4D は *charSetName* または *charSetNum* 引数で設定されている文字セットではなく、BOM で指定されたものを使用します (結果として引数は無視されます)。 ドキュメントに BOM が含まれておらず、また *charSetName* および *charSetNum* 引数が渡されなかった場合、4D はデフォルトで "UTF-8" を文字セットとして使用します。 +ドキュメントにバイトオーダーマーク (BOM) が含まれている場合、4D は *charSetName* または *charSetNum* 引数で設定されている文字セットではなく、BOM で指定されたものを使用します (結果として引数は無視されます)。ドキュメントに BOM が含まれておらず、また *charSetName* および *charSetNum* 引数が渡されなかった場合、4D はデフォルトで "UTF-8" を文字セットとして使用します。 *breakMode* には、ドキュメントの改行文字に対しておこなう処理を指定する倍長整数を渡します。 "System Documents" テーマの、以下の定数を使用することができます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntityClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntityClass.md index 9546019e5434cf..4cc258aedc3f11 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntityClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/EntityClass.md @@ -3,7 +3,7 @@ id: EntityClass title: Entity --- -レコードとテーブルの関係と同様に、[エンティティ](ORDA/dsMapping.md#エンティティ) は [データクラス](ORDA/dsMapping.md#データクラス) のインスタンスです。 エンティティはデータクラスと同じ属性を持つほか、データ値や、特有のプロパティおよび関数を持ちます。 +レコードとテーブルの関係と同様に、[エンティティ](ORDA/dsMapping.md#エンティティ) は [データクラス](ORDA/dsMapping.md#データクラス) のインスタンスです。エンティティはデータクラスと同じ属性を持つほか、データ値や、特有のプロパティおよび関数を持ちます。 ### 概要 @@ -54,8 +54,8 @@ title: Entity この属性値タイプは属性の種類 ([](DataClassClass.md#attributename).kind; リレーションまたはストレージ) によります。 * *attributeName* で指定した属性がストレージ型の場合: `.attributeName` は *attributeName* と同じ型の値を返します。 -* この関数は、種類 ([kind](DataClassClass.md#attributename)) が **storage** あるいは **relatedEntity** であるプロパティに適用されます。 リレート先のエンティティそのものが変更された場合 (外部キーの変更)、リレーションの名称とそのプライマリーキー名が *attributeName* プロパティに返されます (リレーション名についての *value* および *otherValue* は空になります)。 -* *attributeName* で指定した属性がリレートエンティティズ型の場合: `.attributeName` はリレートエンティティの新しいエンティティセレクションを返します。 重複しているエンティティは取り除かれます (返されるのは順列なしのエンティティセレクションです)。 +* この関数は、種類 ([kind](DataClassClass.md#attributename)) が **storage** あるいは **relatedEntity** であるプロパティに適用されます。リレート先のエンティティそのものが変更された場合 (外部キーの変更)、リレーションの名称とそのプライマリーキー名が *attributeName* プロパティに返されます (リレーション名についての *value* および *otherValue* は空になります)。 +* *attributeName* で指定した属性がリレートエンティティズ型の場合: `.attributeName` はリレートエンティティの新しいエンティティセレクションを返します。重複しているエンティティは取り除かれます (返されるのは順列なしのエンティティセレクションです)。 #### 例題 @@ -96,10 +96,10 @@ title: Entity `.clone()` 関数は、 対象エンティティと同じレコードを参照する新規エンティティをメモリ内に作成します。 -この関数を使用するとエンティティを個別に更新することができます。 ただし、パフォーマンス上の理由から、新しいエンティティはクローンされたエンティティのオブジェクト属性と同じ参照を共有すると言う点に注意して下さい。 +この関数を使用するとエンティティを個別に更新することができます。ただし、パフォーマンス上の理由から、新しいエンティティはクローンされたエンティティのオブジェクト属性と同じ参照を共有すると言う点に注意して下さい。 > エンティティに対して何らかの変更をおこなった場合、それらは [`.save()`](#save) 関数が実行されたときのみ、参照先のレコードに保存されるという点に注意してください。 -この関数は、すでにデータベースに保存されているエンティティに対してのみ使用可能です。 新規に作成されたエンティティ([`.isNew()`](#isnew) が **true** を返すもの) に対して呼び出すことはできません。 +この関数は、すでにデータベースに保存されているエンティティに対してのみ使用可能です。新規に作成されたエンティティ([`.isNew()`](#isnew) が **true** を返すもの) に対して呼び出すことはできません。 #### 例題 1 @@ -156,7 +156,7 @@ title: Entity *entityToCompare* には、オリジナルのエンティティと比較をするエンティティを渡します。 -*attributesToCompare* 引数で、比較する属性を指定することができます。 これを渡した場合、指定された属性に対してのみ比較がおこなわれます。 省略時には、エンティティ間の差異がすべて返されます。 +*attributesToCompare* 引数で、比較する属性を指定することができます。これを渡した場合、指定された属性に対してのみ比較がおこなわれます。省略時には、エンティティ間の差異がすべて返されます。 エンティティの差異は、以下のプロパティを持つオブジェクトのコレクションとして返されます: @@ -166,7 +166,7 @@ title: Entity | value | any - 属性の型による | オリジナルエンティティの属性値 | | otherValue | any - 属性の型による | *entityToCompare* の属性値 | -コレクションに含まれるのは異なる値を持っていた属性のみです。 差異が見つからない場合、`diff()` は空のコレクションを返します。 +コレクションに含まれるのは異なる値を持っていた属性のみです。差異が見つからない場合、`diff()` は空のコレクションを返します。 この関数は、種類 ([kind](DataClassClass.md#attributename)) が **storage** あるいは **relatedEntity** であるプロパティに適用されます。 *attributeName* で指定した属性がリレートエンティティ型の場合: `.attributeName` はリレートエンティティを返します。 @@ -354,7 +354,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ #### 説明 -`.drop()` 関数は、 データストアからエンティティに格納されているデータを削除します。 データクラスに対応するテーブルからエンティティが削除される一方、 エンティティそのものはメモリ内に残るという点に注意してください。 +`.drop()` 関数は、 データストアからエンティティに格納されているデータを削除します。データクラスに対応するテーブルからエンティティが削除される一方、 エンティティそのものはメモリ内に残るという点に注意してください。 マルチユーザー、あるいはマルチプロセスアプリケーションにおいて、`.drop()` 関数は ["オプティミスティック・ロック"](ORDA/entities.md#entity-locking) 機構のもとで実行されます。 これはレコードが保存されるたびに内部的なロックスタンプが自動的に増分していくという機構です。 @@ -389,13 +389,13 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ (\*) エラー時には *Result* オブジェクトの *status* あるいは *statusText* プロパティに以下のいずれかの値が返されます: -| 定数 | 値 | 説明 | -| ----------------------------------------- | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。 このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 entity.drop( ) を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 entity.lock( ) を使用するとき、このエラーは dk reload drop if stamp changed オプションを使用した場合に返されることがあります。
    • **割り当てられた statusText**: "Entity does not exist anymore" (エンティティはもう存在しません) | -| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
    **割り当てられた statusText**: "既にロックされています" | -| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    **割り当てられた statusText**: "その他のエラー" | -| `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
  • entity.save( ) の場合: dk auto merge オプションが使用されていない場合に限りエラー
  • entity.drop( ) の場合: dk force drop if stamp changed オプションが使用されていない場合に限りエラー
  • entity.lock( ) の場合: dk reload if stamp changed オプションが使用されていない場合に限りエラー
  • **割り当てられた statusText**: "Stamp has changed"
    • | -| `dk status wrong permission` | 1 | 現在の権限では、エンティティを削除することはできません。 **割り当てられた statusText**: "Permission Error" (権限エラー) | +| 定数 | 値 | 説明 | +| ----------------------------------------- | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 entity.drop( ) を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 entity.lock( ) を使用するとき、このエラーは dk reload drop if stamp changed オプションを使用した場合に返されることがあります。
    • **割り当てられた statusText**: "Entity does not exist anymore" (エンティティはもう存在しません) | +| `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
    **割り当てられた statusText**: "既にロックされています" | +| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    **割り当てられた statusText**: "その他のエラー" | +| `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
  • entity.save( ) の場合: dk auto merge オプションが使用されていない場合に限りエラー
  • entity.drop( ) の場合: dk force drop if stamp changed オプションが使用されていない場合に限りエラー
  • entity.lock( ) の場合: dk reload if stamp changed オプションが使用されていない場合に限りエラー
  • **割り当てられた statusText**: "Stamp has changed"
    • | +| `dk status wrong permission` | 1 | 現在の権限では、エンティティを削除することはできません。**割り当てられた statusText**: "Permission Error" (権限エラー) | #### 例題 1 @@ -509,8 +509,8 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ オブジェクトとエンティティ間のマッピングは属性名でおこなわれます: * オブジェクトのプロパティがデータクラスに存在しない場合、それは無視されます。 -* データタイプは同じである必要があります。 オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換)) 参照)、それ以外の場合にはその属性は更新されません。 -* プライマリーキーはそのまま、あるいは "__KEY" プロパティを (プライマリーキー値とともに) 使って指定することができます。 その値のエンティティがデータクラス内に存在しない場合には、[.save()](#save) が呼び出されたときに指定値を使ってエンティティが作成されます。 プライマリーキーを指定していない場合、エンティティは作成され、データベースのルールに基づいてプライマリーキー値が割り当てられます。 自動インクリメント機能はプライマリーキーが null の場合にのみ計算されます。 +* データタイプは同じである必要があります。オブジェクトとデータクラス間で型が合致しない場合、4D は可能であればデータを変換しようとし ([`データタイプの変換`](Concepts/data-types.md#データタイプの変換)) 参照)、それ以外の場合にはその属性は更新されません。 +* プライマリーキーはそのまま、あるいは "__KEY" プロパティを (プライマリーキー値とともに) 使って指定することができます。その値のエンティティがデータクラス内に存在しない場合には、[.save()](#save) が呼び出されたときに指定値を使ってエンティティが作成されます。プライマリーキーを指定していない場合、エンティティは作成され、データベースのルールに基づいてプライマリーキー値が割り当てられます。自動インクリメント機能はプライマリーキーが null の場合にのみ計算されます。 *filler* 引数のオブジェクトは、以下の条件のいずれかを満たしている場合にはリレートエンティティを扱うことができます: @@ -590,7 +590,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ #### 説明 -`.getDataClass()` 関数は、 エンティティのデータクラスを返します。 この関数は汎用的なコードを書くのに有用です。 +`.getDataClass()` 関数は、 エンティティのデータクラスを返します。この関数は汎用的なコードを書くのに有用です。 #### 例題 @@ -677,7 +677,7 @@ vCompareResult3 ($e1 において更新された (touch された) 属性のみ -> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。 ほとんどの場合、使用する必要はないでしょう。 +> **上級者向け:** この機能は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。ほとんどの場合、使用する必要はないでしょう。 #### 説明 @@ -786,8 +786,8 @@ $info:=$address.getRemoteContextAttributes() `.getStamp()` 関数は、 エンティティのスタンプの値を返します。 -内部スタンプは、エンティティが保存されるたびに 4D によって自動的にインクリメントされます。 これは同じエンティティに対する複数のユーザーの同時アクセス・編集を管理します。 この機構の詳細については、[**エンティティロッキング**](ORDA/entities.md#エンティティロッキング) を参照ください。 -> (一度も保存されていない) 新規エンティティに対しては、このメソッドは 0 を返します。 しかしながら、エンティティがまだ作成されたばかりかどうかを調べるには、[isNew()](#isnew) の使用が推奨されます。 +内部スタンプは、エンティティが保存されるたびに 4D によって自動的にインクリメントされます。これは同じエンティティに対する複数のユーザーの同時アクセス・編集を管理します。 この機構の詳細については、[**エンティティロッキング**](ORDA/entities.md#エンティティロッキング) を参照ください。 +> (一度も保存されていない) 新規エンティティに対しては、このメソッドは 0 を返します。しかしながら、エンティティがまだ作成されたばかりかどうかを調べるには、[isNew()](#isnew) の使用が推奨されます。 #### 例題 @@ -882,7 +882,7 @@ $info:=$address.getRemoteContextAttributes() #### 説明 -`.isNew()` 関数は、 対象エンティティが作成されたばかりで、まだデータストアに保存されていない場合に true を返します。 そうでない場合には、false を返します。 +`.isNew()` 関数は、 対象エンティティが作成されたばかりで、まだデータストアに保存されていない場合に true を返します。そうでない場合には、false を返します。 #### 例題 @@ -965,14 +965,14 @@ $info:=$address.getRemoteContextAttributes() #### 説明 -`.lock()` 関数は、 対象エンティティが参照するレコードにペシミスティック・ロックをかけます。 [ロック](ORDA/entities.md#エンティティロッキング)はレコードと、カレントプロセス内の当該エンティティの参照すべてに対してかけられます。 +`.lock()` 関数は、 対象エンティティが参照するレコードにペシミスティック・ロックをかけます。[ロック](ORDA/entities.md#エンティティロッキング)はレコードと、カレントプロセス内の当該エンティティの参照すべてに対してかけられます。 -他のプロセスからはこのレコードがロックされて見えます (この関数を使って同エンティティをロックしようとした場合、`result.success` プロパティには false が返されます)。 ロックをおこなったセッション内で実行される関数のみが、当該エンティティの属性を編集・保存できます。 他のセッションは同エンティティを読み取り専用にロードできますが、値の入力・保存はできません。 +他のプロセスからはこのレコードがロックされて見えます (この関数を使って同エンティティをロックしようとした場合、`result.success` プロパティには false が返されます)。ロックをおこなったセッション内で実行される関数のみが、当該エンティティの属性を編集・保存できます。他のセッションは同エンティティを読み取り専用にロードできますが、値の入力・保存はできません。 `.lock()` でロックされたレコードは、以下の場合にロック解除されます: * 同プロセス内で合致するエンティティに対して [`.unlock()`](#unlock) 関数が呼び出された場合 -* メモリ内のどのエンティティからも参照されなくなった場合、自動的にロックが解除されます。 たとえば、エンティティのローカル参照に対してのみロックがかかっていた場合、関数の実行が終了すればロックは解除されます。 メモリ内にエンティティへの参照がある限り、レコードはロックされたままです。 +* メモリ内のどのエンティティからも参照されなくなった場合、自動的にロックが解除されます。たとえば、エンティティのローカル参照に対してのみロックがかかっていた場合、関数の実行が終了すればロックは解除されます。メモリ内にエンティティへの参照がある限り、レコードはロックされたままです。 :::note 注記 @@ -999,7 +999,7 @@ $info:=$address.getRemoteContextAttributes() | statusText(\*) | | text | エラーの詳細、以下参照 | | | | | ***ペシミスティック・ロックエラーの場合にのみ利用可能:*** | | lockKindText | | text | "Locked by record" 4Dプロセスによるロック、"Locked by session" RESTセッションによるロック | -| lockInfo | | object | ロック元についての情報。 返されるプロパティはロック元 (4Dプロセスまたは RESTセッション) によって異なります。 | +| lockInfo | | object | ロック元についての情報。返されるプロパティはロック元 (4Dプロセスまたは RESTセッション) によって異なります。 | | | | | ***4Dプロセスによるロックの場合:*** | | | task_id | number | プロセスID | | | user_name | text | マシン上でのセッションユーザー名 | @@ -1022,7 +1022,7 @@ $info:=$address.getRemoteContextAttributes() | 定数 | 値 | 説明 | | ----------------------------------------- | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。 このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 entity.drop( ) を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 entity.lock( ) を使用するとき、このエラーは dk reload drop if stamp changed オプションを使用した場合に返されることがあります。

    • **割り当てられた statusText**: "Entity does not exist anymore" (エンティティはもう存在しません) | +| `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 entity.drop( ) を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 entity.lock( ) を使用するとき、このエラーは dk reload drop if stamp changed オプションを使用した場合に返されることがあります。

    • **割り当てられた statusText**: "Entity does not exist anymore" (エンティティはもう存在しません) | | `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
    **割り当てられた statusText**: "既にロックされています" | | `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    **割り当てられた statusText**: "その他のエラー" | | `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
  • entity.save( ) の場合: dk auto merge オプションが使用されていない場合に限りエラー
  • entity.drop( ) の場合: dk force drop if stamp changed オプションが使用されていない場合に限りエラー
  • entity.lock( ) の場合: dk reload if stamp changed オプションが使用されていない場合に限りエラー

    • **割り当てられた statusText**: "スタンプが変更されています" | @@ -1093,7 +1093,7 @@ $info:=$address.getRemoteContextAttributes() 対象エンティティが所属する既存エンティティセレクションが存在しない場合 (つまり [entity.getSelection()](#getselection) が Null を返す場合)、関数は Null値を返します。 -エンティティセレクション内に有効な次のエンティティが存在しない場合 (セレクションの最終エンティティの場合)、関数は Null を返します。 次のエンティティがドロップされていた場合、関数はその次の有効なエンティティを返します (セレクションの最後に辿り着くと Null を返します)。 +エンティティセレクション内に有効な次のエンティティが存在しない場合 (セレクションの最終エンティティの場合)、関数は Null を返します。次のエンティティがドロップされていた場合、関数はその次の有効なエンティティを返します (セレクションの最後に辿り着くと Null を返します)。 #### 例題 @@ -1137,7 +1137,7 @@ $info:=$address.getRemoteContextAttributes() 対象エンティティが所属する既存エンティティセレクションが存在しない場合 (つまり [entity.getSelection()](#getselection) が Null を返す場合)、関数は Null値を返します。 -エンティティセレクション内に有効な前のエンティティが存在しない場合 (セレクションの先頭エンティティの場合)、関数は Null を返します。 前のエンティティがドロップされていた場合、関数はその前の有効なエンティティを返します (セレクションの先頭に辿り着くと Null を返します)。 +エンティティセレクション内に有効な前のエンティティが存在しない場合 (セレクションの先頭エンティティの場合)、関数は Null を返します。前のエンティティがドロップされていた場合、関数はその前の有効なエンティティを返します (セレクションの先頭に辿り着くと Null を返します)。 #### 例題 @@ -1176,7 +1176,7 @@ $info:=$address.getRemoteContextAttributes() #### 説明 -`.reload()` 関数は、 エンティティの中身をメモリ内にリロードしますこの時、リロード元となるのはデータストアのデータクラスに対応するテーブルに保存されている情報です。 エンティティが同じプライマリーキーで存在している場合にのみリロードは実行されます。 +`.reload()` 関数は、 エンティティの中身をメモリ内にリロードしますこの時、リロード元となるのはデータストアのデータクラスに対応するテーブルに保存されている情報です。エンティティが同じプライマリーキーで存在している場合にのみリロードは実行されます。 **戻り値** @@ -1190,10 +1190,10 @@ $info:=$address.getRemoteContextAttributes() (\*) エラー時には *Result* オブジェクトの *status* あるいは *statusText* プロパティに以下のいずれかの値が返されます: -| 定数 | 値 | 説明 | -| ----------------------------------------- | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。 このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 entity.drop( ) を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 entity.lock( ) を使用するとき、このエラーは dk reload drop if stamp changed オプションを使用した場合に返されることがあります。

    • ***割り当てられた statusText***: "エンティティはもう存在しません" | -| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    ***割り当てられた statusText***: "その他のエラー" | +| 定数 | 値 | 説明 | +| ----------------------------------------- | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 entity.drop( ) を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 entity.lock( ) を使用するとき、このエラーは dk reload drop if stamp changed オプションを使用した場合に返されることがあります。

    • ***割り当てられた statusText***: "エンティティはもう存在しません" | +| `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    ***割り当てられた statusText***: "その他のエラー" | #### 例題 @@ -1242,16 +1242,16 @@ $info:=$address.getRemoteContextAttributes() #### 説明 -`.save()` 関数は、 エンティティの変更内容を保存します 。 変更内容は、データクラスに対応するテーブル内に保存されます。 エンティティを作成したあと、あるいはエンティティに対して保存したい変更をおこなったあとにはこの関数を呼び出す必要があります。 +`.save()` 関数は、 エンティティの変更内容を保存します 。 変更内容は、データクラスに対応するテーブル内に保存されます。エンティティを作成したあと、あるいはエンティティに対して保存したい変更をおこなったあとにはこの関数を呼び出す必要があります。 -保存処理は、少なくとも一つのエンティティ属性が "touched" である (更新されている) 場合にのみ実行されます ([`.touched()`](#touched) および [`.touchedAttributes()`](#touchedattributes) 関数参照)。 そうでない場合、関数は何もしません (トリガーは呼び出されません)。 +保存処理は、少なくとも一つのエンティティ属性が "touched" である (更新されている) 場合にのみ実行されます ([`.touched()`](#touched) および [`.touchedAttributes()`](#touchedattributes) 関数参照)。そうでない場合、関数は何もしません (トリガーは呼び出されません)。 マルチユーザー、あるいはマルチプロセスアプリケーションにおいて、`.save()` 関数は ["オプティミスティック・ロック"](ORDA/entities.md#entity-locking) 機構のもとで実行されます。 これはレコードが保存されるたびに内部的なロックスタンプが自動的に増分していくという機構です。 *mode* 引数を渡さなかった場合のデフォルトでは、いずれの属性に関わらず同エンティティが他のプロセスまたはユーザーによって変更されていた場合にエラーを返します (以下参照)。 -*mode* に `dk auto merge` オプションを渡すと自動マージモードが有効化され、別のプロセス/ユーザーが同エンティティに対して同時に変更をおこなっていても、異なる属性に対する変更であればエラーは生成されません。 エンティティに保存されるデータは、別々の変更処理の組み合わせ ("マージ (併合)") になります (同じ属性に対して変更がおこなわれた場合には、自動マージモードであっても保存は失敗し、エラーが返されます)。 -> ピクチャー・オブジェクト・テキスト型属性で、レコードの外にデータを保存している場合には、自動マージモードは利用できません。 これらの属性に同時の変更があった場合には `dk status stamp has changed` エラーになります。 +*mode* に `dk auto merge` オプションを渡すと自動マージモードが有効化され、別のプロセス/ユーザーが同エンティティに対して同時に変更をおこなっていても、異なる属性に対する変更であればエラーは生成されません。エンティティに保存されるデータは、別々の変更処理の組み合わせ ("マージ (併合)") になります (同じ属性に対して変更がおこなわれた場合には、自動マージモードであっても保存は失敗し、エラーが返されます)。 +> ピクチャー・オブジェクト・テキスト型属性で、レコードの外にデータを保存している場合には、自動マージモードは利用できません。これらの属性に同時の変更があった場合には `dk status stamp has changed` エラーになります。 **戻り値** @@ -1287,11 +1287,11 @@ $info:=$address.getRemoteContextAttributes() | 定数 | 値 | 説明 | | ----------------------------------------- | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `dk status automerge failed` | 6 | ロック解除が成功した場合には true、それ以外は false ドロップされたエンティティや、ロックされてないレコード、あるいは他のプロセスや他のエンティティによってロックされたレコードに対してロック解除を実行した場合、success には false が返されます。 | -| `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。 このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 entity.drop( ) を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 entity.lock( ) を使用するとき、このエラーは dk reload drop if stamp changed オプションを使用した場合に返されることがあります。

    • **割り当てられた statusText**: "エンティティはもう存在しません" | +| `dk status entity does not exist anymore` | 5 | エンティティはもうデータ内に存在していません。このエラーは以下のような場合に起きえます:
  • エンティティがドロップされている (スタンプが変更されていて、メモリ空間は解放されている)
  • エンティティがドロップされていて、他のプライマリーキー値を持つエンティティで置き換えられている (スタンプは変更されていて、新しいエンティティがメモリ空間を使用している)。 entity.drop( ) を使用するとき、このエラーは dk force drop if stamp changed オプションを使用した場合に返されることがあります。 entity.lock( ) を使用するとき、このエラーは dk reload drop if stamp changed オプションを使用した場合に返されることがあります。

    • **割り当てられた statusText**: "エンティティはもう存在しません" | | `dk status locked` | 3 | エンティティはペシミスティック・ロックでロックされています。
    **割り当てられた statusText**: "既にロックされています" | | `dk status serious error` | 4 | 深刻なエラーとは、低レベルのデータベースエラー (例: 重複キー)、ハードウェアエラーなどです。
    **割り当てられた statusText**: "その他のエラー" | | `dk status stamp has changed` | 2 | エンティティの内部的なスタンプ値がデータ内に保存されているエンティティのものと合致しません (オプティミスティック・ロック)。
  • entity.save( ) の場合: dk auto merge オプションが使用されていない場合に限りエラー
  • entity.drop( ) の場合: dk force drop if stamp changed オプションが使用されていない場合に限りエラー
  • entity.lock( ) の場合: dk reload if stamp changed オプションが使用されていない場合に限りエラー

    • **割り当てられた statusText**: "スタンプが変更されています" | -| `dk status wrong permission` | 1 | 現在の権限では、エンティティを保存することはできません。 **割り当てられた statusText**: "Permission Error" (権限エラー) | +| `dk status wrong permission` | 1 | 現在の権限では、エンティティを保存することはできません。**割り当てられた statusText**: "Permission Error" (権限エラー) | #### 例題 1 @@ -1381,15 +1381,15 @@ $info:=$address.getRemoteContextAttributes() #### 説明 -データクラス属性はすべて、エンティティのプロパティとして利用可能です。 各エンティティのプロパティは、当該。 エンティティの属性値を格納します +データクラス属性はすべて、エンティティのプロパティとして利用可能です。 各エンティティのプロパティは、当該。エンティティの属性値を格納します *filterString* 引数が空の文字列、あるいは "*" の場合、以下のいずれかが返されます: * すべてのストレージエンティティ属性 -* リレートエンティティ型の属性 ([kind](DataClassClass.md#attributename) が `relatedEntity`) : リレートエンティティと同じ名前 (N対1リレーション名) のプロパティ。 属性は単純な形式で取得されます。 +* リレートエンティティ型の属性 ([kind](DataClassClass.md#attributename) が `relatedEntity`) : リレートエンティティと同じ名前 (N対1リレーション名) のプロパティ。属性は単純な形式で取得されます。 * リレートエンティティズ型の属性 ([kind](DataClassClass.md#attributename) が `relatedEntities`): 属性は返されません。 -最初の引数として、取得するエンティティ属性を渡します。 以下のものを渡すことができます: +最初の引数として、取得するエンティティ属性を渡します。以下のものを渡すことができます: * リレートエンティティズの一部のプロパティを取得します: * *filterCol*: 文字列のコレクション: \["propertyPath1","propertyPath2";...] @@ -1671,9 +1671,9 @@ employeeObject:=employeeSelected.toObject("directReports.*") `.touched()` 関数は、 エンティティがメモリに読み込まれてから、あるいは保存されてから、エンティティ属性が変更されたかどうかをテストします。 -属性が更新あるいは計算されていた場合、関数は true を返し、それ以外は false を返します。 この関数を使用することで、エンティティを保存する必要があるかどうかを確認することができます。 +属性が更新あるいは計算されていた場合、関数は true を返し、それ以外は false を返します。この関数を使用することで、エンティティを保存する必要があるかどうかを確認することができます。 -この関数は、([`.new( )`](DataClassClass.md#new) で作成された) 新規エンティティに対しては常に false を返します。 ただし、エンティティの属性を計算する関数を使用した場合には、`.touched()` 関数は true を返します。 たとえば、プライマリーキーを計算するために [`.getKey()`](#getkey) を呼び出した場合、`.touched()` メソッドは true を返します。 +この関数は、([`.new( )`](DataClassClass.md#new) で作成された) 新規エンティティに対しては常に false を返します。ただし、エンティティの属性を計算する関数を使用した場合には、`.touched()` 関数は true を返します。たとえば、プライマリーキーを計算するために [`.getKey()`](#getkey) を呼び出した場合、`.touched()` メソッドは true を返します。 #### 例題 @@ -1819,10 +1819,10 @@ employeeObject:=employeeSelected.toObject("directReports.*") `.unlock()` によって返されるオブジェクトには以下のプロパティが格納されます: -| プロパティ | 型 | 説明 | -| ------------ | ------- | --------------------------------------------------------------------------------------------------------------------------------------- | -| success | Boolean | ロック解除が成功した場合には true、それ以外は false。 ドロップされたエンティティや、ロックされてないレコード、あるいは他のプロセスや他のエンティティによってロックされたレコードに対してロック解除を実行した場合、success には false が返されます。 | -| wasNotLocked | Boolean | ("success" がFalse だったときのみ)エンティティがプロセス内でロックされていなかった場合にTrue。 | +| プロパティ | 型 | 説明 | +| ------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------- | +| success | Boolean | ロック解除が成功した場合には true、それ以外は false。ドロップされたエンティティや、ロックされてないレコード、あるいは他のプロセスや他のエンティティによってロックされたレコードに対してロック解除を実行した場合、success には false が返されます。 | +| wasNotLocked | Boolean | ("success" がFalse だったときのみ)エンティティがプロセス内でロックされていなかった場合にTrue。 | #### 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/FileClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/FileClass.md index f659e642e837fb..d855bc0689016d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/FileClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/FileClass.md @@ -3,7 +3,7 @@ id: FileClass title: File --- -`File` オブジェクトは [`File`](#file) コマンドによって作成されます。 これらのオブジェクトには、(実在しているか否かに関わらず) ディスクファイルへの参照が格納されます。 たとえば、新規ファイルを作成するために `File` コマンドを実行した場合、有効な `File` オブジェクトが作成されますが、[`file.create()`](#create) 関数を呼び出すまで、ディスク上にはなにも保存されていません。 +`File` オブジェクトは [`File`](#file) コマンドによって作成されます。これらのオブジェクトには、(実在しているか否かに関わらず) ディスクファイルへの参照が格納されます。たとえば、新規ファイルを作成するために `File` コマンドを実行した場合、有効な `File` オブジェクトが作成されますが、[`file.create()`](#create) 関数を呼び出すまで、ディスク上にはなにも保存されていません。 ### 例題 @@ -16,7 +16,7 @@ $created:=File("/PACKAGE/SpecialPrefs/"+Current user+".myPrefs").create() ### パス名 -`File` オブジェクトは、`filesystems` や `posix` シンタックスを含む、いくつかのパス名をサポートしています。 使用できるパス名についての詳細は [**パス名**](../Concepts/paths.md) ページを参照ください。 +`File` オブジェクトは、`filesystems` や `posix` シンタックスを含む、いくつかのパス名をサポートしています。使用できるパス名についての詳細は [**パス名**](../Concepts/paths.md) ページを参照ください。 @@ -86,15 +86,15 @@ $created:=File("/PACKAGE/SpecialPrefs/"+Current user+".myPrefs").create() #### 説明 -`File` コマンドは、 `4D.File` 型の新しいオブジェクトを作成して返します 。。 このコマンドは 2種類のシンタックスを受け入れます。 +`File` コマンドは、 `4D.File` 型の新しいオブジェクトを作成して返します 。。このコマンドは 2種類のシンタックスを受け入れます。 **File ( path { ; pathType } { ; \* })** -*path* には、ファイルパス文字列を渡します。 カスタムの文字列または [ファイルシステム](../Concepts/paths.md#filesystem-pathnames) (例: "/DATA/myfile.txt") を渡すことができます。 +*path* には、ファイルパス文字列を渡します。カスタムの文字列または [ファイルシステム](../Concepts/paths.md#filesystem-pathnames) (例: "/DATA/myfile.txt") を渡すことができます。 > `File` コマンドでは絶対パス名のみがサポートされます。 -デフォルトで、4D は POSIXシンタックスで表現されたパスを期待します。 プラットフォームパス名 (Windows または macOS) を使用する場合、*pathType* 引数を使用してそのことを宣言する必要があります。 以下の定数を使用することができます: +デフォルトで、4D は POSIXシンタックスで表現されたパスを期待します。プラットフォームパス名 (Windows または macOS) を使用する場合、*pathType* 引数を使用してそのことを宣言する必要があります。以下の定数を使用することができます: | 定数 | 値 | 説明 | | ---------------- | - | ---------------------------------------------- | @@ -105,33 +105,33 @@ $created:=File("/PACKAGE/SpecialPrefs/"+Current user+".myPrefs").create() *fileConstant* には、以下の定数のどれか一つを指定して 4Dビルトインの、またはシステムファイルを渡します: -| 定数 | 値 | 説明 | -| --------------------------------- | -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Backup history file | 19 | バックアップ履歴ファイル。 バックアップ保存先フォルダーに保存されています。 | -| Backup log file | 13 | カレントのバックアップのログファイル。 アプリケーションの Logs フォルダーに保存されています。 | -| Backup settings file | 1 | プロジェクトの Settings フォルダーにある、デフォルトの backup.4DSettings ファイル (xml 形式) | -| Backup settings file for data | 17 | データフォルダーの Settings フォルダーにある、データファイル用の backup.4DSettings ファイル (xml 形式) | -| Build application log file | 14 | アプリケーションビルダーのカレントログファイル (xml 形式)。 Logs フォルダーに保存されています。 | -| Build application settings file | 20 | アプリケーションビルダーのデフォルト設定ファイル ("buildApp.4DSettings")。 プロジェクトの Settings フォルダーに保存されています。 | -| Compacting log file | 6 | Compact data file コマンドによって、あるいはメンテナンス&セキュリティセンター (MSC) によって作成された、直近の圧縮のログファイル。 Logs フォルダーに保存されています。 | -| Current backup settings file | 18 | アプリケーションが現在使用している backup.4DSettings ファイル。 使用されるのはデフォルトのバックアップ設定ファイル、または、データファイル用のユーザーバックアップ設定ファイルです。 | -| Debug log file | 12 | `SET DATABASE PARAMETER(Debug log recording)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | -| Diagnostic log file | 11 | `SET DATABASE PARAMETER(Diagnostic log recording)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | -| Directory file | 16 | プロジェクトアプリケーションにおいて、ユーザーとグループ (あれば) の定義が格納された directory.json ファイル。 このファイルは、データベースの user settings フォルダー (デフォルト、プロジェクトに対してグローバル)、または data settings フォルダー (データファイル専用) に保管されます。 | -| HTTP Client log file | 24 | `HTTP SET OPTION(HTTP client log)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | -| HTTP debug log file | 9 | `WEB SET OPTION(Web debug log)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | -| HTTP log file | 8 | `WEB SET OPTION(Web log recording)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | -| IMAP Log file | 23 | `SET DATABASE PARAMETER(IMAP Log)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | -| Last backup file | 2 | 任意の場所に格納されている、最終バックアップファイル (名称は: `[bkpNum].4BK`) | -| Last journal integration log file | 22 | 最後のログ統合ログファイル (あれば) の完全なパス名 (復元されたアプリケーションの Logs フォルダー内に保存されます)。 このファイルは、自動修復モードにおいてログファイル統合が発生した時点で作成されます。 | -| Repair log file | 7 | メンテナンス&セキュリティセンター (MSC) 内からデータベースに対しておこなわれたデータベース修復のログファイル。 Logs フォルダーに保存されています。 | -| Request log file | 10 | `SET DATABASE PARAMETER(4D Server log recording)` あるいは `SET DATABASE PARAMETER(Client log recording)` コマンドによって作成された標準のクライアント/サーバーログファイル (Webリクエストは除外)。 サーバー上で実行された場合には、サーバーログが返されます (ログファイルはサーバー上の Logsフォルダーに保存されています)。 クライアントで実行された場合には、クライアントのログが返されます (ログファイルはクライアントのLogsフォルダーに保存されています)。 | -| SMTP log file | 15 | `SET DATABASE PARAMETER(SMTP Log)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | -| User settings file | 3 | 設定が有効化されている場合、ストラクチャーファイルと同じ階層にある Preferences フォルダーに格納された、全データファイルの settings.4DSettings ファイル。 | -| User settings file for data | 4 | データファイルと同じ階層にある Preferences フォルダーに格納された、カレントデータファイルの settings.4DSettings ファイル。 | -| Verification log file | 5 | `VERIFY CURRENT DATA FILE` および `VERIFY DATA FILE` コマンドによって、あるいはメンテナンス&セキュリティセンター (MSC) によって作成されたログファイル。 Logs フォルダーに保存されています。 | - -*fileConstant* 引数で指定したファイルが存在しない場合、null オブジェクトが返されます。 エラーは生成されません。 +| 定数 | 値 | 説明 | +| --------------------------------- | -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| Backup history file | 19 | バックアップ履歴ファイル。バックアップ保存先フォルダーに保存されています。 | +| Backup log file | 13 | カレントのバックアップのログファイル。アプリケーションの Logs フォルダーに保存されています。 | +| Backup settings file | 1 | プロジェクトの Settings フォルダーにある、デフォルトの backup.4DSettings ファイル (xml 形式) | +| Backup settings file for data | 17 | データフォルダーの Settings フォルダーにある、データファイル用の backup.4DSettings ファイル (xml 形式) | +| Build application log file | 14 | アプリケーションビルダーのカレントログファイル (xml 形式)。 Logs フォルダーに保存されています。 | +| Build application settings file | 20 | アプリケーションビルダーのデフォルト設定ファイル ("buildApp.4DSettings")。プロジェクトの Settings フォルダーに保存されています。 | +| Compacting log file | 6 | Compact data file コマンドによって、あるいはメンテナンス&セキュリティセンター (MSC) によって作成された、直近の圧縮のログファイル。 Logs フォルダーに保存されています。 | +| Current backup settings file | 18 | アプリケーションが現在使用している backup.4DSettings ファイル。使用されるのはデフォルトのバックアップ設定ファイル、または、データファイル用のユーザーバックアップ設定ファイルです。 | +| Debug log file | 12 | `SET DATABASE PARAMETER(Debug log recording)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | +| Diagnostic log file | 11 | `SET DATABASE PARAMETER(Diagnostic log recording)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | +| Directory file | 16 | プロジェクトアプリケーションにおいて、ユーザーとグループ (あれば) の定義が格納された directory.json ファイル。このファイルは、データベースの user settings フォルダー (デフォルト、プロジェクトに対してグローバル)、または data settings フォルダー (データファイル専用) に保管されます。 | +| HTTP Client log file | 24 | `HTTP SET OPTION(HTTP client log)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | +| HTTP debug log file | 9 | `WEB SET OPTION(Web debug log)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | +| HTTP log file | 8 | `WEB SET OPTION(Web log recording)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | +| IMAP Log file | 23 | `SET DATABASE PARAMETER(IMAP Log)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | +| Last backup file | 2 | 任意の場所に格納されている、最終バックアップファイル (名称は: `[bkpNum].4BK`) | +| Last journal integration log file | 22 | 最後のログ統合ログファイル (あれば) の完全なパス名 (復元されたアプリケーションの Logs フォルダー内に保存されます)。このファイルは、自動修復モードにおいてログファイル統合が発生した時点で作成されます。 | +| Repair log file | 7 | メンテナンス&セキュリティセンター (MSC) 内からデータベースに対しておこなわれたデータベース修復のログファイル。 Logs フォルダーに保存されています。 | +| Request log file | 10 | `SET DATABASE PARAMETER(4D Server log recording)` あるいは `SET DATABASE PARAMETER(Client log recording)` コマンドによって作成された標準のクライアント/サーバーログファイル (Webリクエストは除外)。サーバー上で実行された場合には、サーバーログが返されます (ログファイルはサーバー上の Logsフォルダーに保存されています)。クライアントで実行された場合には、クライアントのログが返されます (ログファイルはクライアントのLogsフォルダーに保存されています)。 | +| SMTP log file | 15 | `SET DATABASE PARAMETER(SMTP Log)` コマンドによって作成されたログファイル。 Logs フォルダーに保存されています。 | +| User settings file | 3 | 設定が有効化されている場合、ストラクチャーファイルと同じ階層にある Preferences フォルダーに格納された、全データファイルの settings.4DSettings ファイル。 | +| User settings file for data | 4 | データファイルと同じ階層にある Preferences フォルダーに格納された、カレントデータファイルの settings.4DSettings ファイル。 | +| Verification log file | 5 | `VERIFY CURRENT DATA FILE` および `VERIFY DATA FILE` コマンドによって、あるいはメンテナンス&セキュリティセンター (MSC) によって作成されたログファイル。 Logs フォルダーに保存されています。 | + +*fileConstant* 引数で指定したファイルが存在しない場合、null オブジェクトが返されます。エラーは生成されません。 コマンドがコンポーネントから呼び出されている場合、`*` 引数を渡してホストデータベースのパスを取得するようにします。 `*` 引数を省略すると、常に null オブジェクトが返されます。 @@ -149,7 +149,7 @@ $created:=File("/PACKAGE/SpecialPrefs/"+Current user+".myPrefs").create() #### 説明 -`4D.File.new()` 関数は、 `4D.File` 型の新しいオブジェクトを作成して返します 。。 この関数の機能は、[`File`](#file) コマンドと同一です。 +`4D.File.new()` 関数は、 `4D.File` 型の新しいオブジェクトを作成して返します 。。この関数の機能は、[`File`](#file) コマンドと同一です。 > `4D.File.new()` よりも、短い [`File`](#file) コマンドの使用が推奨されます。 @@ -185,7 +185,7 @@ $created:=File("/PACKAGE/SpecialPrefs/"+Current user+".myPrefs").create() `.create()` 関数は、 `File` オブジェクトのプロパティに基づいてディスク上にファイルを作成します。 -必要であれば、 関数は [platformPath](#platformpath) あるいは [path](#path) プロパティの詳細に基づいてフォルダー階層を作成します。 ファイルがディスク上にすでに存在する場合、関数は何もせず、false を返します (エラーは返されません)。 +必要であれば、 関数は [platformPath](#platformpath) あるいは [path](#path) プロパティの詳細に基づいてフォルダー階層を作成します。ファイルがディスク上にすでに存在する場合、関数は何もせず、false を返します (エラーは返されません)。 **戻り値** @@ -233,7 +233,7 @@ $created:=File("/PACKAGE/SpecialPrefs/"+Current user+".myPrefs").create() *aliasName* には、作成するエイリアスまたはショートカットの名前を渡します。 -macOS 上では、この関数はデフォルトで標準エイリアスを作成します。 *aliasType* 引数を渡すことで、シンボリックリンクを作成することもできます。 以下の定数を使用することができます: +macOS 上では、この関数はデフォルトで標準エイリアスを作成します。 *aliasType* 引数を渡すことで、シンボリックリンクを作成することもできます。以下の定数を使用することができます: | 定数 | 値 | 説明 | | ------------------ | - | ------------------- | @@ -297,7 +297,7 @@ Windows 上では、常にショートカット (.lnk ファイル) が作成さ :::caution -`.delete()` はディスク上の任意のファイルを削除できます。 これには、他のアプリケーションで作成されたドキュメントや、アプリケーションそのものも対象になります。 そのため、`.delete()` は特に十分な注意を払って使用してください。 ファイルの削除は恒久的な操作であり取り消しできません。 +`.delete()` はディスク上の任意のファイルを削除できます。これには、他のアプリケーションで作成されたドキュメントや、アプリケーションそのものも対象になります。そのため、`.delete()` は特に十分な注意を払って使用してください。ファイルの削除は恒久的な操作であり取り消しできません。 ::: @@ -348,9 +348,9 @@ Windows 上では、常にショートカット (.lnk ファイル) が作成さ `.getAppInfo()` 関数は、 **.exe** や **.dll**、**.plist** ファイルの情報をオブジェクトとして返します。 -この関数は、既存の .exe、.dll、あるいは .plist ファイルと使う必要があります。 ファイルがディスク上に存在しない、または、有効な .exe や .dll、.plist ファイルでない場合、この関数は空のオブジェクトを返します (エラーは生成されません)。 +この関数は、既存の .exe、.dll、あるいは .plist ファイルと使う必要があります。ファイルがディスク上に存在しない、または、有効な .exe や .dll、.plist ファイルでない場合、この関数は空のオブジェクトを返します (エラーは生成されません)。 -> この関数は xml形式の .plist ファイル (テキスト) のみをサポートしています。 バイナリー形式の .plist ファイルを対象に使用した場合、エラーが返されます。 +> この関数は xml形式の .plist ファイル (テキスト) のみをサポートしています。バイナリー形式の .plist ファイルを対象に使用した場合、エラーが返されます。 **.exe または .dll ファイルの場合に返されるオブジェクト** @@ -448,7 +448,7 @@ ALERT($info.Copyright) *destinationFolder* 引数が指定するフォルダーはディスク上に存在している必要があり、そうでない場合にはエラーが生成されます。 -デフォルトでは、移動したファイルは元の名前を維持します。 移動の際にファイル名を変更したい場合、新しい完全な名前を *newName* に渡します。 新しい名前は命名規則に則っている必要があります (例: ":", "/", 等の文字を含んでいない、など)。 そうでない場合、エラーが返されます。 +デフォルトでは、移動したファイルは元の名前を維持します。移動の際にファイル名を変更したい場合、新しい完全な名前を *newName* に渡します。新しい名前は命名規則に則っている必要があります (例: ":", "/", 等の文字を含んでいない、など)。 そうでない場合、エラーが返されます。 **返されるオブジェクト** @@ -498,24 +498,24 @@ $myFile.moveTo($DocFolder.folder("Archives");"Infos_old.txt") -| *mode* | 説明 | -| -------- | ------------------------------------------------------------------------------------------------------------------------------------------- | -| "read" | (デフォルト) ファイルから値を読み取るための FileHandle を作成します。 ディスク上にファイルが存在しない場合は、エラーが返されます。 "read" モードの FileHandle は、同じ File オブジェクトに対していくつでも開くことができます。 | -| "write" | ファイルに値を書き込むための FileHandle を作成します (書き込みはファイルの先頭から)。 ディスク上にファイルが存在しない場合は、作成されます。 "write" モードの FileHandle は、同じ File オブジェクトに対して 1つのみ開くことができます。 | -| "append" | ファイルに値を書き込むための FileHandle を作成します (書き込みはファイルの最後から)。 ディスク上にファイルが存在しない場合は、作成されます。 "append" モードの FileHandle は、同じ File オブジェクトに対して 1つのみ開くことができます。 | +| *mode* | 説明 | +| -------- | ------------------------------------------------------------------------------------------------------------------------------------------ | +| "read" | (デフォルト) ファイルから値を読み取るための FileHandle を作成します。ディスク上にファイルが存在しない場合は、エラーが返されます。 "read" モードの FileHandle は、同じ File オブジェクトに対していくつでも開くことができます。 | +| "write" | ファイルに値を書き込むための FileHandle を作成します (書き込みはファイルの先頭から)。ディスク上にファイルが存在しない場合は、作成されます。 "write" モードの FileHandle は、同じ File オブジェクトに対して 1つのみ開くことができます。 | +| "append" | ファイルに値を書き込むための FileHandle を作成します (書き込みはファイルの最後から)。ディスク上にファイルが存在しない場合は、作成されます。 "append" モードの FileHandle は、同じ File オブジェクトに対して 1つのみ開くことができます。 | > *mode* の値は、文字の大小を区別します。 *option* (object) 引数を使って、以下のプロパティを通じて FileHandle にさらなるオプションを渡すことができます (これらのプロパティはその後、開かれた [FileHandle オブジェクト](FileHandleClass) から取得できます)。 -| *options* | 型 | 説明 | デフォルト | -| ----------------- | --------------- | ---------------------------------------------------------------------- | -------------- | -| `.mode` | Text | 開くモード (上記の *mode* 参照) | "read" | -| `.charset` | Text | ファイルの読み取りや書き込みに使用される文字セット。 セットの標準名を使用します (たとえば、"ISO-8859-1" や "UTF-8") | "UTF-8" | -| `.breakModeRead` | Text または Number | ファイルの読み取り時に使用される改行の処理モード (下記参照) | "native" または 1 | -| `.breakModeWrite` | Text または Number | ファイルの書き込み時に使用される改行の処理モード (下記参照) | "native" または 1 | +| *options* | 型 | 説明 | デフォルト | +| ----------------- | --------------- | --------------------------------------------------------------------- | -------------- | +| `.mode` | Text | 開くモード (上記の *mode* 参照) | "read" | +| `.charset` | Text | ファイルの読み取りや書き込みに使用される文字セット。セットの標準名を使用します (たとえば、"ISO-8859-1" や "UTF-8") | "UTF-8" | +| `.breakModeRead` | Text または Number | ファイルの読み取り時に使用される改行の処理モード (下記参照) | "native" または 1 | +| `.breakModeWrite` | Text または Number | ファイルの書き込み時に使用される改行の処理モード (下記参照) | "native" または 1 | -この関数は、元の改行文字をすべて置き換えます。 デフォルトではネイティブの区切り文字が使われますが、別の区切り文字を定義することも可能です。 `.breakModeRead` と `.breakModeWrite` は、改行文字に適用する処理を指定します。 以下のいずれかの値を使用できます (テキストまたは数値): +この関数は、元の改行文字をすべて置き換えます。デフォルトではネイティブの区切り文字が使われますが、別の区切り文字を定義することも可能です。 `.breakModeRead` と `.breakModeWrite` は、改行文字に適用する処理を指定します。以下のいずれかの値を使用できます (テキストまたは数値): | 改行モードの値 (テキスト) | 改行モードの値 (数値/定数) | 説明 | | -------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------- | @@ -575,7 +575,7 @@ $fhandle:=$f.open("read") `.rename()` 関数は、 `.rename()` 関数は、。 -*newName* 引数は命名規則に則っている必要があります (例: ":", "/", 等の文字を含んでいない、など)。 そうでない場合、エラーが返されます。 同じ名前のファイルがすでに存在する場合には、エラーが返されます。 +*newName* 引数は命名規則に則っている必要があります (例: ":", "/", 等の文字を含んでいない、など)。 そうでない場合、エラーが返されます。同じ名前のファイルがすでに存在する場合には、エラーが返されます。 この関数はファイルの完全な名前を編集することに留意が必要です。 つまり、*newName* に拡張子を渡さなかった場合、新しいファイル名には拡張子がありません。 @@ -628,29 +628,29 @@ $fhandle:=$f.open("read") > .exe および .dll ファイル情報の書き込みは Windows上でのみ可能です。 -*info* オブジェクトに設定された各プロパティは .exe または .dll ファイルのバージョンリソースに書き込まれます。 以下のプロパティが使用できます (それ以外のプロパティは無視されます): +*info* オブジェクトに設定された各プロパティは .exe または .dll ファイルのバージョンリソースに書き込まれます。以下のプロパティが使用できます (それ以外のプロパティは無視されます): -| プロパティ | 型 | 説明 | -| ---------------- | ---- | ---------------------------------------------------- | -| InternalName | Text | | -| ProductName | Text | | -| CompanyName | Text | | -| LegalCopyright | Text | | -| ProductVersion | Text | | -| FileDescription | Text | | -| FileVersion | Text | | -| OriginalFilename | Text | | -| WinIcon | Text | .icoファイルの Posixパス。 このプロパティは、4D が生成した実行ファイルにのみ適用されます。 | +| プロパティ | 型 | 説明 | +| ---------------- | ---- | --------------------------------------------------- | +| InternalName | Text | | +| ProductName | Text | | +| CompanyName | Text | | +| LegalCopyright | Text | | +| ProductVersion | Text | | +| FileDescription | Text | | +| FileVersion | Text | | +| OriginalFilename | Text | | +| WinIcon | Text | .icoファイルの Posixパス。このプロパティは、4D が生成した実行ファイルにのみ適用されます。 | -`WinIcon` を除くすべてのプロパティにおいて、値として null または空テキストを渡すと、空の文字列がプロパティに書き込まれます。 テキストでない型の値を渡した場合には、文字列に変換されます。 +`WinIcon` を除くすべてのプロパティにおいて、値として null または空テキストを渡すと、空の文字列がプロパティに書き込まれます。テキストでない型の値を渡した場合には、文字列に変換されます。 `WinIcon` プロパティにおいては、アイコンファイルが存在しないか、フォーマットが正しくない場合、エラーが発生します。 **.plist ファイル用の *info* オブジェクト** -> この関数は xml形式の .plist ファイル (テキスト) のみをサポートしています。 バイナリー形式の .plist ファイルを対象に使用した場合、エラーが返されます。 +> この関数は xml形式の .plist ファイル (テキスト) のみをサポートしています。バイナリー形式の .plist ファイルを対象に使用した場合、エラーが返されます。 -*info* オブジェクトに設定された各プロパティは .plist ファイルにキーとして書き込まれます。 あらゆるキーの名称が受け入れられます。 値の型は可能な限り維持されます。 +*info* オブジェクトに設定された各プロパティは .plist ファイルにキーとして書き込まれます。あらゆるキーの名称が受け入れられます。値の型は可能な限り維持されます。 *info* に設定されたキーが .plist ファイル内ですでに定義されている場合は、その値が更新され、元の型が維持されます。 .plist ファイルに既存のそのほかのキーはそのまま維持されます。 @@ -755,18 +755,18 @@ $infoPlistFile.setAppInfo($info) `.setText()` 関数は、 *text* に渡されたテキストをファイルの新しいコンテンツとして書き込みます。 -`File` オブジェクトで参照されているファイルがディスク上に存在しない場合、このメソッドがそのファイルを作成します。 ディスク上にファイルが存在する場合、ファイルが開かれている場合を除き、以前のコンテンツは消去されます。 ファイルが開かれている場合はコンテンツはロックされ、エラーが生成されます。 +`File` オブジェクトで参照されているファイルがディスク上に存在しない場合、このメソッドがそのファイルを作成します。ディスク上にファイルが存在する場合、ファイルが開かれている場合を除き、以前のコンテンツは消去されます。 ファイルが開かれている場合はコンテンツはロックされ、エラーが生成されます。 -*text* には、ファイルに書き込むテキストを渡します。 テキストリテラル ("my text" など) のほか、4Dテキストフィールドや変数も渡せます。 +*text* には、ファイルに書き込むテキストを渡します。テキストリテラル ("my text" など) のほか、4Dテキストフィールドや変数も渡せます。 -任意で、コンテンツの書き込みに使用する文字セットを渡します。 これには、次の二つの方法があります: +任意で、コンテンツの書き込みに使用する文字セットを渡します。これには、次の二つの方法があります: * *charSetName* に標準の文字セット名を含んだ文字列 ("ISO-8859-1" や "UTF-8" など) を渡します。 * *charSetNum* に標準の文字セット名の MIBEnum ID (倍長整数) を渡します。 > 4D によってサポートされている文字セットの一覧については、`CONVERT FROM TEXT` コマンドを参照ください。 -文字セットにバイトオーダーマーク (BOM) が存在し、かつその文字セットに "-no-bom" 接尾辞 (例: "UTF-8-no-bom") が含まれていない場合、4D は BOM をファイルに挿入します。 文字セットを指定しない場合、 4D はデフォルトで "UTF-8" の文字セットを BOMなしで使用します。 +文字セットにバイトオーダーマーク (BOM) が存在し、かつその文字セットに "-no-bom" 接尾辞 (例: "UTF-8-no-bom") が含まれていない場合、4D は BOM をファイルに挿入します。文字セットを指定しない場合、 4D はデフォルトで "UTF-8" の文字セットを BOMなしで使用します。 *breakMode* には、ファイルを保存する前に改行文字に対しておこなう処理を指定する倍長整数を渡します。 **System Documents** テーマ内にある、以下の定数を使用することができます: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md index d4aac672b68f5c..be3ece7d395a5d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md @@ -7,7 +7,7 @@ title: IMAPTransporter ### IMAP Transporter オブジェクト -IMAP Transporter オブジェクトは [IMP New transporter](#imap-new-transporter) コマンドによってインスタンス化されます。 これらは、次のプロパティや関数を持ちます: +IMAP Transporter オブジェクトは [IMP New transporter](#imap-new-transporter) コマンドによってインスタンス化されます。これらは、次のプロパティや関数を持ちます: | | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -68,7 +68,7 @@ IMAP Transporter オブジェクトは [IMP New transporter](#imap-new-transport #### 説明 -`IMAP New transporter` コマンドは、 新規の IMAP接続を設定します この IMAP接続は、*server* 引数の指定に応じてを設定され、コマンドの戻り値は新しい *IMAP transporter* オブジェクトです。 返される transporter オブジェクトは通常、メールの受信に使用されます。 +`IMAP New transporter` コマンドは、 新規の IMAP接続を設定します この IMAP接続は、*server* 引数の指定に応じてを設定され、コマンドの戻り値は新しい *IMAP transporter* オブジェクトです。返される transporter オブジェクトは通常、メールの受信に使用されます。 *server* 引数として、以下のプロパティを持つオブジェクトを渡します: @@ -88,7 +88,7 @@ IMAP Transporter オブジェクトは [IMP New transporter](#imap-new-transport #### 戻り値 -この関数は、[**IMAP transporter オブジェクト**](#imap-transporter-オブジェクト) を返します。 返されるプロパティはすべて **読み取り専用** です。 +この関数は、[**IMAP transporter オブジェクト**](#imap-transporter-オブジェクト) を返します。返されるプロパティはすべて **読み取り専用** です。 > IMAP接続は、transporter オブジェクトが消去された時点で自動的に閉じられます。 #### 例題 @@ -127,7 +127,7 @@ End if #### 説明 -`4D.IMAPTransporter.new()` 関数は、 `4D.IMAPTransporter` 型の新しいオブジェクトを作成して返します。 この関数の機能は、[`IMAP New transporter`](#imap-new-transporter) コマンドと同一です。 +`4D.IMAPTransporter.new()` 関数は、 `4D.IMAPTransporter` 型の新しいオブジェクトを作成して返します。この関数の機能は、[`IMAP New transporter`](#imap-new-transporter) コマンドと同一です。 @@ -172,7 +172,7 @@ End if | -------- | - | ------------------------- | | IMAP all | 1 | 選択されたメールボックスの全メッセージを選択します | -`keywords` を使って、`msgIDs` 引数で指定したメッセージに対して追加するフラグを定義します。 以下の標準フラグおよびカスタムフラグを使用することができます (カスタムフラグのサポートはサーバーの実装に依存します)。 +`keywords` を使って、`msgIDs` 引数で指定したメッセージに対して追加するフラグを定義します。以下の標準フラグおよびカスタムフラグを使用することができます (カスタムフラグのサポートはサーバーの実装に依存します)。 | プロパティ | 型 | 説明 | | --------------------- | ------- | --------------------------------- | @@ -260,16 +260,16 @@ $status:=$transporter.addFlags(IMAP all;$flags) `.append()` 関数は、 `destinationBox` に指定したメールボックスに、`mailObj` のメールを追加します。 -`mailObj` には、Email オブジェクトを渡します。 メールプロパティに関する包括的な詳細については、[Email オブジェクト](EmailObjectClass.md#email-オブジェクト) を参照ください。 `.append()` 関数は Email オブジェクトの `keywords` 属性内のキーワードタグをサポートします。 +`mailObj` には、Email オブジェクトを渡します。メールプロパティに関する包括的な詳細については、[Email オブジェクト](EmailObjectClass.md#email-オブジェクト) を参照ください。 `.append()` 関数は Email オブジェクトの `keywords` 属性内のキーワードタグをサポートします。 -任意の `destinationBox` には、`mailObj` が追加されるメールボックスの名前を指定することができます。 省略した場合は、カレントメールボックスが使用されます。 +任意の `destinationBox` には、`mailObj` が追加されるメールボックスの名前を指定することができます。省略した場合は、カレントメールボックスが使用されます。 -任意の `options` には、メールの特定部分の文字セットやエンコーディングを定義するオブジェクトを渡すことができます。 次のプロパティを含みます: +任意の `options` には、メールの特定部分の文字セットやエンコーディングを定義するオブジェクトを渡すことができます。次のプロパティを含みます: -| プロパティ | 型 | 説明 | -| ------------- | ---- | --------------------------------------------------------------------------------- | -| headerCharset | Text | メールの以下の部分で使用される文字セットとエンコーディング: 件名、添付ファイル名、メール名の属性。 取り得る値: 以下の可能な文字セットテーブルを参照ください。 | -| bodyCharset | Text | メールの HTML およびテキスト本文コンテンツで使用される文字セットとエンコーディング。 取り得る値: 以下の可能な文字セットテーブルを参照ください。 | +| プロパティ | 型 | 説明 | +| ------------- | ---- | -------------------------------------------------------------------------------- | +| headerCharset | Text | メールの以下の部分で使用される文字セットとエンコーディング: 件名、添付ファイル名、メール名の属性。取り得る値: 以下の可能な文字セットテーブルを参照ください。 | +| bodyCharset | Text | メールの HTML およびテキスト本文コンテンツで使用される文字セットとエンコーディング。取り得る値: 以下の可能な文字セットテーブルを参照ください。 | 使用可能な文字セット: @@ -337,7 +337,7 @@ $status:=$imap.append($msg; "Drafts") #### 説明 -`.checkConnectionDelay` プロパティは、 サーバー接続をチェックするまでの最長時間 (秒単位) を格納します。 関数呼び出しの間隔がこの時間を超過する場合、サーバー接続が確認されます。 プロパティが *server* オブジェクトによって設定されていない場合は、デフォルトで 300 という値が使用されます。 +`.checkConnectionDelay` プロパティは、 サーバー接続をチェックするまでの最長時間 (秒単位) を格納します。関数呼び出しの間隔がこの時間を超過する場合、サーバー接続が確認されます。プロパティが *server* オブジェクトによって設定されていない場合は、デフォルトで 300 という値が使用されます。 > **警告**: 定義されたタイムアウトが、サーバータイムアウトより短いようにしてください。 そうでない場合、クライアントタイムアウトは無意味になります。 @@ -560,7 +560,7 @@ End if * `msgsIDs` には、削除するメッセージの固有ID を格納したコレクション * `allMsgs` には、選択されているメールボックスの全メッセージを削除するための定数 (倍長整数型): -この関数を実行しても、メールが実際に削除される訳ではありません。 "削除済み" フラグがつけられたメッセージも引き続き [.searchMails()](#searchmails) 関数によって検索可能です。 フラグがつけられたメッセージは、[`.expunge()`](#expunge) を実行したときか、別のメールボックスを選択したとき、あるいは([IMAP New transporter](#imap-new-transporter) で作成された) [transporter オブジェクト](#imap-transporter-オブジェクト) が消去されたときにのみ、IMAPサーバーから削除されます。 +この関数を実行しても、メールが実際に削除される訳ではありません。"削除済み" フラグがつけられたメッセージも引き続き [.searchMails()](#searchmails) 関数によって検索可能です。フラグがつけられたメッセージは、[`.expunge()`](#expunge) を実行したときか、別のメールボックスを選択したとき、あるいは([IMAP New transporter](#imap-new-transporter) で作成された) [transporter オブジェクト](#imap-transporter-オブジェクト) が消去されたときにのみ、IMAPサーバーから削除されます。 **返されるオブジェクト** @@ -654,7 +654,7 @@ End if #### 説明 -`.deleteBox()` 関数は、 `name` に指定した名称の新規メールボックスを IMAPサーバーから完全に削除します。 存在しないメールボックス、または INBOX を削除しようとして場合には、エラーが生成されます。 +`.deleteBox()` 関数は、 `name` に指定した名称の新規メールボックスを IMAPサーバーから完全に削除します。存在しないメールボックス、または INBOX を削除しようとして場合には、エラーが生成されます。 `name` には、削除するメールボックスの名前を渡します。 > * 子メールボックスを持つ親メールボックスが "\Noselect" 属性を持っている場合、そのメールボックスは削除できません。 @@ -804,9 +804,9 @@ $status:=$transporter.expunge() #### 説明 -`.getBoxInfo()` 関数は、 カレントメールボックス、または *name* が指定するメールボックスに対応する `boxInfo` オブジェクトを返します。 この関数は、[`.selectBox()`](#selectbox) と同じ情報を返しますが、カレントメールボックスは変えません。 +`.getBoxInfo()` 関数は、 カレントメールボックス、または *name* が指定するメールボックスに対応する `boxInfo` オブジェクトを返します。この関数は、[`.selectBox()`](#selectbox) と同じ情報を返しますが、カレントメールボックスは変えません。 -任意の *name* パラメーターには、アクセスするメールボックスの名称を渡します。 この名称は明確な左から右への階層を表し、特定の区切り文字でレベルを区分けします。 この区切り文字は [`.getDelimiter()`](#getdelimiter) 関数で調べることができます。 +任意の *name* パラメーターには、アクセスするメールボックスの名称を渡します。この名称は明確な左から右への階層を表し、特定の区切り文字でレベルを区分けします。この区切り文字は [`.getDelimiter()`](#getdelimiter) 関数で調べることができます。 *name* のメールボックスが選択不可の場合、または見つからない場合には、関数はエラーを生成し、**null** を返します。 @@ -860,9 +860,9 @@ $status:=$transporter.expunge() #### 説明 -`.getBoxList()` 関数は、 利用可能なメールボックスの情報を mailbox オブジェクトのコレクションとしてを返します。 この関数を使用すると、IMAPメールサーバー上にあるメッセージの一覧をローカルで管理することができるようになります。 +`.getBoxList()` 関数は、 利用可能なメールボックスの情報を mailbox オブジェクトのコレクションとしてを返します。この関数を使用すると、IMAPメールサーバー上にあるメッセージの一覧をローカルで管理することができるようになります。 -任意の `parameters` パラメーターには、返されるメールボックスをフィルターするための値を格納したオブジェクトを渡すことができます。 以下のものを渡すことができます: +任意の `parameters` パラメーターには、返されるメールボックスをフィルターするための値を格納したオブジェクトを渡すことができます。以下のものを渡すことができます: | プロパティ | 型 | 説明 | | ------------ | ------- | ---------------------------------------------------- | @@ -877,7 +877,7 @@ $status:=$transporter.expunge() | \[].name | text | メールボックスの名称 | | \[].selectable | boolean | アクセス権でメールボックスを選択できるかどうかを表します:
    • true - メールボックスは選択可能
    • false - メールボックスは選択不可能
    | | \[].inferior | boolean | アクセス権でメールボックス内に下の階層レベルを作成できるかどうかを表します:
    • true - 下の階層レベルは作成可能
    • false - 下の階層レベルは作成不可能
    | -| \[].interesting | boolean | サーバーがメールボックスに “interesting” のマーク付けをしているかどうかを表します:
    • true - メールボックスはサーバーから "interesting" のマーク付けをされています。 たとえば、メールボックスには新着メッセージが入っている場合が考えられます。
    • false - メールボックスはサーバーから "interesting" のマーク付けをされていません。
    | +| \[].interesting | boolean | サーバーがメールボックスに “interesting” のマーク付けをしているかどうかを表します:
    • true - メールボックスはサーバーから "interesting" のマーク付けをされています。たとえば、メールボックスには新着メッセージが入っている場合が考えられます。
    • false - メールボックスはサーバーから "interesting" のマーク付けをされていません。
    | アカウントにメールボックスが一つもない場合、空のコレクションが返されます。 > * 開いている接続がない場合、`.getBoxList()` は接続を開きます。 @@ -985,19 +985,19 @@ $status:=$transporter.expunge() #### 説明 -`.getMail()` 関数は、 `IMAP_transporter` が指定するメールボックス内の、*msgNumber* または *msgID* に対応するメールを `Email` オブジェクトとして返します。 この関数を使用すると、メールのコンテンツをローカルで管理できるようになります。 +`.getMail()` 関数は、 `IMAP_transporter` が指定するメールボックス内の、*msgNumber* または *msgID* に対応するメールを `Email` オブジェクトとして返します。この関数を使用すると、メールのコンテンツをローカルで管理できるようになります。 最初の引数として、次のいずれかを渡すことができます: * *msgNumber* に、取得するメッセージのシーケンス番号 (*倍長整数*) を渡します。 * *msgID*に、取得するメッセージの固有ID (*テキスト*) を渡します。 -任意の *options* 引数として、メッセージの扱い方を定義する追加のオブジェクトを渡すことができます。 次のプロパティを利用することができます: +任意の *options* 引数として、メッセージの扱い方を定義する追加のオブジェクトを渡すことができます。次のプロパティを利用することができます: -| プロパティ | 型 | 説明 | -| ---------- | ------- | -------------------------------------------------------------------------- | -| updateSeen | boolean | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 デフォルト値: true | -| withBody | boolean | true を渡すとメッセージ本文を返します。 false 時には、メッセージヘッダーのみが返されます。 デフォルト値: true | +| プロパティ | 型 | 説明 | +| ---------- | ------- | ------------------------------------------------------------------------- | +| updateSeen | boolean | true 時には、メールボックス内でメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。デフォルト値: true | +| withBody | boolean | true を渡すとメッセージ本文を返します。 false 時には、メッセージヘッダーのみが返されます。デフォルト値: true | > * *msgID* 引数が存在しないメッセージを指定した場合、関数はエラーを生成し **Null** を返します。 > * [`.selectBox()`](#selectbox) によって選択されたメールボックスがない場合、エラーが生成されます。 > * 開いている接続がない場合、`.getMail()` は [`.selectBox()`](#selectbox) で最後に指定されたメールボックスへの接続を開きます。 @@ -1070,28 +1070,28 @@ ID = 1のメッセージを取得します: 第一シンタックスを使用すると、メッセージID に基づいてメッセージを取得することができます。 -*ids* 引数として、取得するメッセージID のコレクションを渡します。 これらの ID は [`.getMail()`](#getmail) で取得することができます。 +*ids* 引数として、取得するメッセージID のコレクションを渡します。これらの ID は [`.getMail()`](#getmail) で取得することができます。 -任意の *options* 引数を渡すと、返されるメッセージのパートを定義することができます。 利用可能なプロパティについては、以下の **オプション** の表を参照ください。 +任意の *options* 引数を渡すと、返されるメッセージのパートを定義することができます。利用可能なプロパティについては、以下の **オプション** の表を参照ください。 **第二シンタックス:** ***.getMails( startMsg ; endMsg { ; options } ) -> result*** -第二シンタックスを使用すると、連続したレンジに基づいてメッセージを取得することができます。 渡される値はメールボックス内でのメッセージの位置を表します。 +第二シンタックスを使用すると、連続したレンジに基づいてメッセージを取得することができます。渡される値はメールボックス内でのメッセージの位置を表します。 -*startMsg* には、連続したレンジの最初のメッセージの番号に対応する *倍長整数* の値を渡します。 負の値 (*startMsg* <= 0) を渡した場合、メールボックスの最初のメッセージが連続レンジの先頭メッセージとして扱われます。 +*startMsg* には、連続したレンジの最初のメッセージの番号に対応する *倍長整数* の値を渡します。負の値 (*startMsg* <= 0) を渡した場合、メールボックスの最初のメッセージが連続レンジの先頭メッセージとして扱われます。 -*endMsg* には、連続レンジに含める最後のメッセージの番号に対応する *倍長整数* の値を渡します。 負の値 (*endMsg* <= 0) を渡した場合、メールボックスの最後のメッセージが連続レンジの最終メッセージとして扱われます。 +*endMsg* には、連続レンジに含める最後のメッセージの番号に対応する *倍長整数* の値を渡します。負の値 (*endMsg* <= 0) を渡した場合、メールボックスの最後のメッセージが連続レンジの最終メッセージとして扱われます。 任意の *options* 引数を渡すと、返されるメッセージのパートを定義することができます。 **オプション** -| プロパティ | 型 | 説明 | -| ---------- | ------- | ---------------------------------------------------------------------- | -| updateSeen | Boolean | true 時には、指定されたメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。 デフォルト値: true | -| withBody | Boolean | true を渡すと指定されたメッセージの本文を返します。 false 時には、メッセージヘッダーのみが返されます。 デフォルト値: true | +| プロパティ | 型 | 説明 | +| ---------- | ------- | --------------------------------------------------------------------- | +| updateSeen | Boolean | true 時には、指定されたメッセージを "既読" にします。 false 時にはメッセージの状態は変化しません。デフォルト値: true | +| withBody | Boolean | true を渡すと指定されたメッセージの本文を返します。 false 時には、メッセージヘッダーのみが返されます。デフォルト値: true | > * [`.selectBox()`](#selectbox) によって選択されたメールボックスがない場合、エラーが生成されます。 > * 開いている接続がない場合、`.getMails()` は [`.selectBox()`](#selectbox) で最後に指定されたメールボックスへの接続を開きます。 @@ -1171,7 +1171,7 @@ ID = 1のメッセージを取得します: * *msgNumber* に、取得するメッセージのシーケンス番号 (*倍長整数*) を渡します。 * *msgID*に、取得するメッセージの固有ID (*テキスト*) を渡します。 -任意の *updateSeen* 引数を渡すと、メールボックス内でメッセージが "既読" とマークされるかどうかを指定します。 以下のものを渡すことができます: +任意の *updateSeen* 引数を渡すと、メールボックス内でメッセージが "既読" とマークされるかどうかを指定します。以下のものを渡すことができます: * **True** - メッセージは "既読" とマークされます (このメッセージが読まれたことを表します) * **False** - メッセージの "既読" ステータスは変化しません。 @@ -1346,9 +1346,9 @@ ID = 1のメッセージを取得します: `.numToID()` 関数は、 *startMsg* および *endMsg* で指定された連続した範囲のメッセージのシーケンス番号を IMAP固有IDへと変換します 。 。対象となるのは、現在選択されているメールボックスのメッセージです。 -*startMsg* には、連続したレンジの最初のメッセージの番号に対応する *倍長整数* の値を渡します。 負の値 (*startMsg* <= 0) を渡した場合、メールボックスの最初のメッセージが連続レンジの先頭メッセージとして扱われます。 +*startMsg* には、連続したレンジの最初のメッセージの番号に対応する *倍長整数* の値を渡します。負の値 (*startMsg* <= 0) を渡した場合、メールボックスの最初のメッセージが連続レンジの先頭メッセージとして扱われます。 -*endMsg* には、連続レンジに含める最後のメッセージの番号に対応する *倍長整数* の値を渡します。 負の値 (*endMsg* <= 0) を渡した場合、メールボックスの最後のメッセージが連続レンジの最終メッセージとして扱われます。 +*endMsg* には、連続レンジに含める最後のメッセージの番号に対応する *倍長整数* の値を渡します。負の値 (*endMsg* <= 0) を渡した場合、メールボックスの最後のメッセージが連続レンジの最終メッセージとして扱われます。 #### 戻り値 @@ -1422,7 +1422,7 @@ ID = 1のメッセージを取得します: | -------- | - | ------------------------- | | IMAP all | 1 | 選択されたメールボックスの全メッセージを選択します | -`keywords` を使って、`msgIDs` 引数で指定したメッセージから削除するフラグを定義します。 以下の標準フラグおよびカスタムフラグを使用することができます: +`keywords` を使って、`msgIDs` 引数で指定したメッセージから削除するフラグを定義します。以下の標準フラグおよびカスタムフラグを使用することができます: | 引数 | 型 | 説明 | | --------------------- | ------- | --------------------------------- | @@ -1507,7 +1507,7 @@ $status:=$transporter.removeFlags(IMAP all;$flags) #### 説明 -`.renameBox()` 関数は、 IMAPサーバー上でメールボックスの名称を変更します 。。 存在しないメールボックスの名称を変更しようとしたり、すでに使われているメールボックス名に変更しようとしたりすると、エラーが生成されます。 +`.renameBox()` 関数は、 IMAPサーバー上でメールボックスの名称を変更します 。。存在しないメールボックスの名称を変更しようとしたり、すでに使われているメールボックス名に変更しようとしたりすると、エラーが生成されます。 メールボックスの新しい名称は `newName` に渡します。 @@ -1591,7 +1591,7 @@ End if `.searchMails()` 関数は、 カレントメールボックスにおいて *searchCriteria* の検索条件に合致するメッセージを検索します 。。 *searchCriteria* 引数には、一つ以上の検索キーを格納します。 -*searchCriteria* はテキスト型の引数で、一つ以上の検索キー (詳細は後述の [利用可能な検索キー](#利用可能な検索キー) 参照) を格納し、検索する値を渡します (渡さない場合もあります)。 検索キーは単一または複数の項目からなります。 例: +*searchCriteria* はテキスト型の引数で、一つ以上の検索キー (詳細は後述の [利用可能な検索キー](#利用可能な検索キー) 参照) を格納し、検索する値を渡します (渡さない場合もあります)。検索キーは単一または複数の項目からなります。例: ``` SearchKey1 = FLAGGED @@ -1638,7 +1638,7 @@ searchCriteria = HEADER CONTENT-TYPE "E" NOT SUBJECT "o" NOT HEADER CONTENT-TYPE 最後の 2例については、最初の検索キーリストのカッコを取り除いてしまうと検索結果が異なることに注意してください。 -* *searchCriteria* 引数には任意の \[CHARSET] 指定を含めることができます。 これは "CHARSET" という単語の後に実際の文字コード \[CHARSET] (US ASCII, ISO-8859 など) が続きます。 これは *searchCriteria* 文字列の文字コードを指定します。 そのため、\[CHARSET] 指定を使用する場合には *searchCriteria* 文字列を指定された文字コードへと変換する必要があります (詳細については `CONVERT FROM TEXT` または `Convert to text` コマンドを参照ください)。 デフォルトでは、searchCriteria 引数に拡張された文字列が含まれていた場合には4D はそれを Quotable Printable へとエンコードします。 +* *searchCriteria* 引数には任意の \[CHARSET] 指定を含めることができます。これは "CHARSET" という単語の後に実際の文字コード \[CHARSET] (US ASCII, ISO-8859 など) が続きます。これは *searchCriteria* 文字列の文字コードを指定します。そのため、\[CHARSET] 指定を使用する場合には *searchCriteria* 文字列を指定された文字コードへと変換する必要があります (詳細については `CONVERT FROM TEXT` または `Convert to text` コマンドを参照ください)。デフォルトでは、searchCriteria 引数に拡張された文字列が含まれていた場合には4D はそれを Quotable Printable へとエンコードします。 ``` searchCriteria = CHARSET "ISO-8859" BODY "Help" @@ -1650,15 +1650,15 @@ searchCriteria = CHARSET "ISO-8859" BODY "Help" 検索キーによっては、次の型の検索値が必要となる場合があります: -* **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` +* **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` -* **文字列値の検索キー**: string はあらゆる文字列を含みうるため、引用符でくくらなければなりません。 文字列が特殊文字 (スペース文字など) をまったく含まない場合には、引用符で括る必要はありません。 このような文字列を引用符でくくることは、渡した文字列値が正確に解釈されることを保証します。 例: `searchCriteria = FROM "SMITH"`
    文字列を使用するすべての検索キーに対し、フィールドの文字列に検索キーが含まれる場合には検索に合致したとみなされます。 合致は文字の大小を区別しません。 +* **文字列値の検索キー**: string はあらゆる文字列を含みうるため、引用符でくくらなければなりません。文字列が特殊文字 (スペース文字など) をまったく含まない場合には、引用符で括る必要はありません。このような文字列を引用符でくくることは、渡した文字列値が正確に解釈されることを保証します。例: `searchCriteria = FROM "SMITH"`
    文字列を使用するすべての検索キーに対し、フィールドの文字列に検索キーが含まれる場合には検索に合致したとみなされます。合致は文字の大小を区別しません。 -* **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。 例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` +* **field-name 値の検索キー**: field-name はヘッダーフィールドの名称です。例: `searchCriteria = HEADER CONTENT-TYPE "MIXED"` -* **フラグ値の検索キー**: flag は一つ以上のキーワードを (標準のフラグを含めて) 受け入れます。 例: `searchCriteria = KEYWORD \Flagged \Draft` +* **フラグ値の検索キー**: flag は一つ以上のキーワードを (標準のフラグを含めて) 受け入れます。例: `searchCriteria = KEYWORD \Flagged \Draft` -* **メッセージセット値の検索キー**: 複数のメッセージを識別します。 メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。 個別の番号はカンマで区切ります。 コロンは、その前後の番号を含めた連続した番号を指定します。 例:
    `2,4:7,9,12:*` は、15通あるメールボックスの場合に `2,4,5,6,7,9,12,13,14,15` を指定します。 `searchCriteria = 1:5 ANSWERED` は、メッセージシーケンス番号 1 から 5番のメッセージのうち、\Answered フラグが設定されているメッセージを検索します。 `searchCriteria= 2,4 ANSWERED` は、メッセージセレクション (メッセージ番号 2番と4番) のうち、\Answered フラグが設定されているメッセージを検索します。 +* **メッセージセット値の検索キー**: 複数のメッセージを識別します。メッセージシーケンス番号は、1 から始まりメールボックスのメッセージの総数までの連続した番号です。個別の番号はカンマで区切ります。 コロンは、その前後の番号を含めた連続した番号を指定します。例:
    `2,4:7,9,12:*` は、15通あるメールボックスの場合に `2,4,5,6,7,9,12,13,14,15` を指定します。 `searchCriteria = 1:5 ANSWERED` は、メッセージシーケンス番号 1 から 5番のメッセージのうち、\Answered フラグが設定されているメッセージを検索します。 `searchCriteria= 2,4 ANSWERED` は、メッセージセレクション (メッセージ番号 2番と4番) のうち、\Answered フラグが設定されているメッセージを検索します。 #### 利用可能な検索キー @@ -1675,7 +1675,7 @@ searchCriteria = CHARSET "ISO-8859" BODY "Help" **OLD**: \Recent フラグが設定されていないメッセージ **SEEN**: \Seen フラグが設定されているメッセージ **UNSEEN**: \Seen フラグが設定されていないメッセージ -**NEW**: \Recent フラグが設定されているが \Seen フラグが設定されていないメッセージ。 これは機能的には “(RECENT UNSEEN)” と同じです。 これは機能的には “(RECENT UNSEEN)” と同じです。 +**NEW**: \Recent フラグが設定されているが \Seen フラグが設定されていないメッセージ。 これは機能的には “(RECENT UNSEEN)” と同じです。これは機能的には “(RECENT UNSEEN)” と同じです。 ***KEYWORD ***flag******: 指定されたキーワードが設定されているメッセージ ***UNKEYWORD ***flag******: 指定されたキーワードが設定されていないメッセージ ***BEFORE ***date******: 内部の日付が指定日より前のメッセージ @@ -1729,17 +1729,17 @@ searchCriteria = CHARSET "ISO-8859" BODY "Help" #### 説明 -`.selectBox()` 関数は、 *name* に指定したメールボックスをカレントメールボックスとして選択します。 この関数を使用するとメールボックスに関する情報を取得することができます。 +`.selectBox()` 関数は、 *name* に指定したメールボックスをカレントメールボックスとして選択します。この関数を使用するとメールボックスに関する情報を取得することができます。 > カレントメールボックスを変更せずに、メールボックスから情報を取得するには、[`.getBoxInfo()`](#getboxinfo) を使用します。 -*name* には、アクセスするメールボックスの名前を渡します。 この名称は明確な左から右への階層を表し、特定の区切り文字でレベルを区分けします。 この区切り文字は [`.getDelimiter()`](#getdelimiter) 関数で調べることができます。 +*name* には、アクセスするメールボックスの名前を渡します。この名称は明確な左から右への階層を表し、特定の区切り文字でレベルを区分けします。この区切り文字は [`.getDelimiter()`](#getdelimiter) 関数で調べることができます。 -任意の *state* 引数を渡すと、メールボックスへのアクセスタイプを定義できます。 取りうる値は以下の通りです: +任意の *state* 引数を渡すと、メールボックスへのアクセスタイプを定義できます。取りうる値は以下の通りです: -| 定数 | 値 | 説明 | -| --------------------- | - | -------------------------------------------------------------------------- | -| IMAP read only state | 1 | 選択されたメールボックスは読み取り専用権限でアクセスされます。 新しいメッセージを表す "新着" フラグはそのまま変化しません。 | -| IMAP read write state | 0 | 選択されたメールボックスは読み書き可能権限でアクセスされます。 メッセージは "既読" と判断され、"新着" フラグは失われます。 (デフォルト値) | +| 定数 | 値 | 説明 | +| --------------------- | - | ------------------------------------------------------------------------ | +| IMAP read only state | 1 | 選択されたメールボックスは読み取り専用権限でアクセスされます。新しいメッセージを表す "新着" フラグはそのまま変化しません。 | +| IMAP read write state | 0 | 選択されたメールボックスは読み書き可能権限でアクセスされます。メッセージは "既読" と判断され、"新着" フラグは失われます。(デフォルト値) | > * *name* 引数が存在しないメールボックスを指定した場合、関数はエラーを生成し **Null** を返します。 > * 開いている接続がない場合、`.selectBox()` は接続を開きます。 > * 接続が指定された時間 (`IMAP New transporter` 参照) 以上に使用されなかった場合には、[`.checkConnection()`](#checkconnection) 関数が自動的に呼び出されます。 @@ -1805,7 +1805,7 @@ searchCriteria = CHARSET "ISO-8859" BODY "Help" #### 説明 -`.subscribe()` 関数は、 IMAPサーバーの購読メールボックスとして任意のメールボックスを追加・削除します。 利用可能なメールボックスが大量にある場合、すべてを取得するのを避けるため、確認したいメールボックスだけを購読することができます。 +`.subscribe()` 関数は、 IMAPサーバーの購読メールボックスとして任意のメールボックスを追加・削除します。利用可能なメールボックスが大量にある場合、すべてを取得するのを避けるため、確認したいメールボックスだけを購読することができます。 `name` には、購読するメールボックスの名前を渡します。 @@ -1880,7 +1880,7 @@ End if #### 説明 -`.unsubscribe()` 関数は、 指定したメールボックスを購読メールボックスから削除します。 これにより、確認するメールボックスの数を減らせます。 +`.unsubscribe()` 関数は、 指定したメールボックスを購読メールボックスから削除します。これにより、確認するメールボックスの数を減らせます。 `name` には、購読を解除するメールボックスの名前を渡します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md index acd7dec97938a8..627e98641f1d75 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md @@ -4,7 +4,7 @@ title: ZIPArchive --- -4D ZIP アーカイブは、一つ以上のファイルまたはフォルダーを格納している `File` または `Folder` オブジェクトで、元のサイズより小さくなるように圧縮されているものをいいます。 これらのアーカイブは ".zip" 拡張子を持つように作成され、ディスクスペースの確保や、サイズ制限があるメディア (例: メールまたはネットワークなど) 経由のファイル転送を容易にする用途に使用できます。 +4D ZIP アーカイブは、一つ以上のファイルまたはフォルダーを格納している `File` または `Folder` オブジェクトで、元のサイズより小さくなるように圧縮されているものをいいます。これらのアーカイブは ".zip" 拡張子を持つように作成され、ディスクスペースの確保や、サイズ制限があるメディア (例: メールまたはネットワークなど) 経由のファイル転送を容易にする用途に使用できます。 - 4D ZIPアーカイブは [ZIP Create archive](#zip-create-archive) コマンドで作成します。 - 4D [`ZIPFile`](ZipFileClass.md) および [`ZIPFolder`](ZipFolderClass.md) インスタンスは、[ZIP Read archive](#zip-read-archive) コマンドによって返されるオブジェクトの [`root`](#root) プロパティ (`ZIPFolder`) を通して利用可能です。 @@ -71,20 +71,20 @@ End if - *fileToZip*: 圧縮する `4D.File` オブジェクトを引数として渡します。 -- *folderToZip*: 圧縮する `4D.Folder` を渡します。 この場合、任意の *options* 引数を渡して、フォルダーのコンテンツのみを圧縮 (つまり、外側のフォルダーを除外) することができます。 `ZIP Create archive` はデフォルトで、フォルダーとその中身を圧縮するので、展開処理をしたときにはフォルダーを再作成します。 フォルダーの中身のみを解凍処理で復元するには、*options* 引数に `ZIP Without enclosing folder` 定数を渡します。 +- *folderToZip*: 圧縮する `4D.Folder` を渡します。この場合、任意の *options* 引数を渡して、フォルダーのコンテンツのみを圧縮 (つまり、外側のフォルダーを除外) することができます。 `ZIP Create archive` はデフォルトで、フォルダーとその中身を圧縮するので、展開処理をしたときにはフォルダーを再作成します。フォルダーの中身のみを解凍処理で復元するには、*options* 引数に `ZIP Without enclosing folder` 定数を渡します。 -- *zipStructure*: ZIPArchive オブジェクトを表すオブジェクトを引数として渡します。 以下のプロパティを利用して、このオブジェクトを定義することが可能です: +- *zipStructure*: ZIPArchive オブジェクトを表すオブジェクトを引数として渡します。以下のプロパティを利用して、このオブジェクトを定義することが可能です: -| プロパティ | 型 | 説明 | -| ----------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| compression | Integer |
  • `ZIP Compression standard`: Deflate圧縮 (デフォルト)
  • `ZIP Compression LZMA`: LZMA圧縮
  • `ZIP Compression XZ`: XZ圧縮
  • `ZIP Compression none`: 圧縮なし
    • | -| level | Integer | 圧縮レベル。 とりうる値: 1 - 10。 低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。 ただし、圧縮レベルはパフォーマンスに影響します。 デフォルト値 (省略時):
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | パスワードが設定されていた場合に使用する暗号化方法:
  • `ZIP Encryption AES128`: 128-bit キーを使った AES による暗号化
  • `ZIP Encryption AES192`: 192-bit キーを使った AES による暗号化
  • `ZIP Encryption AES256`: 256-bit キーを使った AES による暗号化 (パスワードが設定されている場合のデフォルト)
  • `ZIP Encryption none`: 暗号化なし (パスワードが設定されてない場合のデフォルト)
    • | -| password | Text | 暗号化が必要な場合に使用するパスワード | -| files | Collection |
  • `4D.File` または `4D.Folder` オブジェクトのコレクション
  • 以下のプロパティを持ったオブジェクトのコレクション:
    • プロパティ型説明
    source4D.File または 4D.FolderFile または Folder
    destinationText(任意) - アーカイブのコンテンツ構成を変更するための相対ファイルパス
    optionnumber(任意) - `ZIP Ignore invisible files` で非表示ファイルを無視、0 を渡すと全ファイルを圧縮
    | -| callback | 4D.Function | $1 に圧縮の進捗 (0 - 100) を受け取るコールバックフォーミュラ | +| プロパティ | 型 | 説明 | +| ----------- | ----------- | -------------------------------------------------------------------------------------------------------------------- | +| compression | Integer |
  • `ZIP Compression standard`: Deflate圧縮 (デフォルト)
  • `ZIP Compression LZMA`: LZMA圧縮
  • `ZIP Compression XZ`: XZ圧縮
  • `ZIP Compression none`: 圧縮なし
    • | +| level | Integer | 圧縮レベル。とりうる値: 1 - 10。低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。ただし、圧縮レベルはパフォーマンスに影響します。デフォルト値 (省略時):
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +| encryption | Integer | パスワードが設定されていた場合に使用する暗号化方法:
    • `ZIP Encryption AES128`: 128-bit キーを使った AES による暗号化
    • `ZIP Encryption AES192`: 192-bit キーを使った AES による暗号化
    • `ZIP Encryption AES256`: 256-bit キーを使った AES による暗号化 (パスワードが設定されている場合のデフォルト)
    • `ZIP Encryption none`: 暗号化なし (パスワードが設定されてない場合のデフォルト)
    | +| password | Text | 暗号化が必要な場合に使用するパスワード | +| files | Collection |
  • `4D.File` または `4D.Folder` オブジェクトのコレクション
  • 以下のプロパティを持ったオブジェクトのコレクション:
    • プロパティ型説明
    source4D.File または 4D.FolderFile または Folder
    destinationText(任意) - アーカイブのコンテンツ構成を変更するための相対ファイルパス
    optionnumber(任意) - `ZIP Ignore invisible files` で非表示ファイルを無視、0 を渡すと全ファイルを圧縮
    | +| callback | 4D.Function | $1 に圧縮の進捗 (0 - 100) を受け取るコールバックフォーミュラ | -*destinationFile* には、作成する ZIPアーカイブ (名前や位置など) を記述する `4D.File` オブジェクトを渡します。 作成した ZIPアーカイブがあらゆるソフトウェアで自動的に処理されるようにするため、".zip" 拡張子の使用が推奨されます。 +*destinationFile* には、作成する ZIPアーカイブ (名前や位置など) を記述する `4D.File` オブジェクトを渡します。作成した ZIPアーカイブがあらゆるソフトウェアで自動的に処理されるようにするため、".zip" 拡張子の使用が推奨されます。 アーカイブが作成されると、[ZIP Read archive](#zip-read-archive) を使用してアクセスすることができます。 @@ -220,15 +220,15 @@ $err:=ZIP Create archive($zip; $destination) `ZIP Read archive` コマンドは、 *zipFile* のコンテンツを取得し、`4D.ZipArchive` オブジェクト形式で返します。 -> このコマンドは ZIPアーカイブを展開することはしません。 その中身に関する情報を提供するのみです。 アーカイブのコンテンツを取り出すには、[file.copyTo()](Document.md#copyto) あるいは [folder.copyTo()](Directory.md#copyto) などの関数を使用します。 +> このコマンドは ZIPアーカイブを展開することはしません。 その中身に関する情報を提供するのみです。アーカイブのコンテンツを取り出すには、[file.copyTo()](Document.md#copyto) あるいは [folder.copyTo()](Directory.md#copyto) などの関数を使用します。 -*zipFile* 引数として、圧縮された ZIPアーカイブを参照している `4D.File` オブジェクトを渡します。 ターゲットのアーカイブファイルは `ZIP Read archive` が実行を終えるまで (全コンテンツ/参照が取得/解放されるまで) は開いた状態となり、その後自動的に閉じられます。 +*zipFile* 引数として、圧縮された ZIPアーカイブを参照している `4D.File` オブジェクトを渡します。ターゲットのアーカイブファイルは `ZIP Read archive` が実行を終えるまで (全コンテンツ/参照が取得/解放されるまで) は開いた状態となり、その後自動的に閉じられます。 -*zipFile* 引数で指定した ZIPファイルがパスワードで保護されていた場合、任意の *password* 引数を渡してパスワードを提供する必要があります。 パスワードが必要にも関わらず、コンテンツ読み出し時にパスワードが提示されなかった場合、エラーが生成されます。 +*zipFile* 引数で指定した ZIPファイルがパスワードで保護されていた場合、任意の *password* 引数を渡してパスワードを提供する必要があります。パスワードが必要にも関わらず、コンテンツ読み出し時にパスワードが提示されなかった場合、エラーが生成されます。 **アーカイブオブジェクト** -戻り値の `4D.ZipArchive` オブジェクトは単一の [`root`](#root) プロパティを格納しており、その値は `4D.ZipFolder` オブジェクトです。 このフォルダーは ZIPアーカイブの全コンテンツを表します。 +戻り値の `4D.ZipArchive` オブジェクトは単一の [`root`](#root) プロパティを格納しており、その値は `4D.ZipFolder` オブジェクトです。このフォルダーは ZIPアーカイブの全コンテンツを表します。 #### 例題 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/data-types.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/data-types.md index e54b24d85a73f0..e3cc284782bea5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/data-types.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Concepts/data-types.md @@ -5,7 +5,7 @@ title: データタイプの概要 4D においてデータは、主にデータベースフィールドと 4D ランゲージという2つの場所で、そのタイプに応じて扱われます。 -この2つはおおよそ同じものですが、データベースレベルで提供されているいくつかのデータタイプはランゲージにおいては直接利用可能ではなく、自動的に適宜変換されます。 同様に、いくつかのデータタイプはランゲージでしか利用できません。 各場所で利用可能なデータタイプと、ランゲージでの宣言の仕方の一覧です: +この2つはおおよそ同じものですが、データベースレベルで提供されているいくつかのデータタイプはランゲージにおいては直接利用可能ではなく、自動的に適宜変換されます。同様に、いくつかのデータタイプはランゲージでしか利用できません。各場所で利用可能なデータタイプと、ランゲージでの宣言の仕方の一覧です: | データタイプ | データベース | ランゲージ | [`var` 宣言](variables.md#var-キーワードによる宣言) | [`C_` または `ARRAY` 宣言](variables.md#c_-指示子による宣言) | | ------------------------------------- | ------- | -------- | --------------------------------------- | ----------------------------------------------- | @@ -27,7 +27,7 @@ title: データタイプの概要 | [コレクション](Concepts/dt_collection.md) | - | ◯ | `Collection` | `C_COLLECTION` | | [バリアント](Concepts/dt_variant.md)(2) | - | ◯ | `Variant` | `C_VARIANT` | -(1) ORDA では、オブジェクト (エンティティ) を介してデータベースフィールドを扱うため、オブジェクトにおいて利用可能なデータタイプのみがサポートされます。 詳細については [オブジェクト](Concepts/dt_object.md) のデータタイプの説明を参照ください。 +(1) ORDA では、オブジェクト (エンティティ) を介してデータベースフィールドを扱うため、オブジェクトにおいて利用可能なデータタイプのみがサポートされます。詳細については [オブジェクト](Concepts/dt_object.md) のデータタイプの説明を参照ください。 (2) バリアントは実際のところ *データ* タイプではなく、あらゆるデータタイプの値を格納することのできる *変数* タイプです。 @@ -55,13 +55,13 @@ title: データタイプの概要 ### デフォルト値としての Null -Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的な状態になります。 これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 +Object型、Collection型、Pointer型、Picture型の変数は、デフォルト値として **null** を持ちますが、実際には宣言後で割り当て前の場合には中間的な状態になります。これらは **null** 値の *ように振る舞います* が、コードがそれらにアクセスしようとしたときに発生するエラーが少なくなるなど、多少の違いがあります。 ## データタイプの変換 -4D ランゲージには、データタイプ間の変換をおこなう演算子やコマンドがあります。 4D ランゲージはデータタイプをチェックします。 たとえば、"abc"+0.5+!12/25/96!-?00:30:45?のように記述することはできません。 これは、シンタックス (構文) エラーになります。 +4D ランゲージには、データタイプ間の変換をおこなう演算子やコマンドがあります。 4D ランゲージはデータタイプをチェックします。たとえば、"abc"+0.5+!12/25/96!-?00:30:45?のように記述することはできません。これは、シンタックス (構文) エラーになります。 次の表は、基本のデータタイプ、変換できるデータタイプ、それを実行する際に使用するコマンドを示しています: diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Debugging/debugLogFiles.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Debugging/debugLogFiles.md index 764762e427f485..c641f1b381c3fd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Debugging/debugLogFiles.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Debugging/debugLogFiles.md @@ -3,9 +3,9 @@ id: debugLogFiles title: ログファイルの詳細 --- -4Dアプリケーションは、デバッグや実行の最適化のために有用な複数のログファイルを生成することができます。 ログは通常 [SET DATABASE PARAMETER](https://doc.4d.com/4dv20/help/command/ja/page642.html)、[WEB SET OPTION](https://doc.4d.com/4dv20/help/command/ja/page1210.html)、あるいは [HTTP SET OPTION](https://doc.4d.com/4dv20/help/command/ja/page1160.html) コマンドのセレクターを使用して開始・停止され、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs) 内に保存されます。 +4Dアプリケーションは、デバッグや実行の最適化のために有用な複数のログファイルを生成することができます。ログは通常 [SET DATABASE PARAMETER](https://doc.4d.com/4dv20/help/command/ja/page642.html)、[WEB SET OPTION](https://doc.4d.com/4dv20/help/command/ja/page1210.html)、あるいは [HTTP SET OPTION](https://doc.4d.com/4dv20/help/command/ja/page1160.html) コマンドのセレクターを使用して開始・停止され、プロジェクトの [Logsフォルダー](../Project/architecture.md#logs) 内に保存されます。 -記録された情報は、問題の検知と修正のためには分析する必要があります。 この章では、以下のログファイルの詳細を説明します: +記録された情報は、問題の検知と修正のためには分析する必要があります。この章では、以下のログファイルの詳細を説明します: * [4DRequestsLog.txt](#4drequestslogtxt) * [4DRequestsLog_ProcessInfo.txt](#4drequestslog_processinfotxt) @@ -23,7 +23,7 @@ title: ログファイルの詳細 これらのログファイルは、デバッグ中に時系列を確立しエントリー間のつながりを分かりやすくするために、いくつかのフィールドを共有しています: * `sequence_number`: この番号はすべてのデバッグログ間において固有で重複せず、ログファイルに関わらず新しいエントリーごとに増分されるので、オペレーションの厳密な順番を知ることができます。 -* `connection_uuid`: 4Dクライアントで作成されサーバーに接続する 4Dプロセスについては、この接続UUID がサーバー側とクライアント側とで記録されます。 これにより各プロセスを開始したリモートクライアントを簡単に識別することができます。 +* `connection_uuid`: 4Dクライアントで作成されサーバーに接続する 4Dプロセスについては、この接続UUID がサーバー側とクライアント側とで記録されます。これにより各プロセスを開始したリモートクライアントを簡単に識別することができます。 ## 4DRequestsLog.txt @@ -68,10 +68,10 @@ SET DATABASE PARAMETER(Client Log Recording;1) | request | [C/S または ORDA リクエストID](https://github.com/4d/request-log-definitions/blob/master/RequestIDs.txt)、または SQLリクエストのメッセージ文字列、または `LOG EVENT` メッセージ | | bytes_in | 受信したバイト数 | | bytes_out | 送信したバイト数 | -| server\_duration | exec\_duration | ログが生成された場所によって変わります:
  • *server\_duration* (クライアント上で生成された場合) -- サーバーがリクエストを処理し、レスポンスを返すまでにかかった時間 (マイクロ秒単位)。 以下の画像の B から E までに相当します。
  • クライアントがリクエストを送信してサーバーがそれを受け取るまでにかかる時間の概算 (マイクロ秒単位)。 以下の画像の Aから Dまでと Eから Hまでに相当します。
    • | -| write\_duration | 次のものを送信するのにかかった時間 (μs):
  • リクエスト (クライアント上で実行された場合)。 以下の画像の A から B までに相当します。
  • レスポンス (サーバー上で実行された場合)。 以下の画像の E から F までに相当します。
    • | +| server\_duration | exec\_duration | ログが生成された場所によって変わります:
  • *server\_duration* (クライアント上で生成された場合) -- サーバーがリクエストを処理し、レスポンスを返すまでにかかった時間 (マイクロ秒単位)。以下の画像の B から E までに相当します。
  • クライアントがリクエストを送信してサーバーがそれを受け取るまでにかかる時間の概算 (マイクロ秒単位)。以下の画像の Aから Dまでと Eから Hまでに相当します。
    • | +| write\_duration | 次のものを送信するのにかかった時間 (μs):
  • リクエスト (クライアント上で実行された場合)。以下の画像の A から B までに相当します。
  • レスポンス (サーバー上で実行された場合)。以下の画像の E から F までに相当します。
    • | | task_kind | プリエンプティブかコオペラティブか (それぞれ 'p' と 'c' で表される) | -| rtt | クライアントがリクエストを送信してサーバーがそれを受け取るまでにかかる時間の概算 (マイクロ秒単位)。 以下の画像の Aから Dまでと Eから Hまでに相当します。
  • ServerNet ネットワークレイヤーを使用している場合にのみ計測されます。 旧式ネットワークレイヤを使用していた場合には 0 が返されます。
  • Windows 10、あるいは Windows Server 2016 以前のバージョンの Windows においては、これを呼び出すと 0 が返されます。
    • | +| rtt | クライアントがリクエストを送信してサーバーがそれを受け取るまでにかかる時間の概算 (マイクロ秒単位)。以下の画像の Aから Dまでと Eから Hまでに相当します。
  • ServerNet ネットワークレイヤーを使用している場合にのみ計測されます。 旧式ネットワークレイヤを使用していた場合には 0 が返されます。
  • Windows 10、あるいは Windows Server 2016 以前のバージョンの Windows においては、これを呼び出すと 0 が返されます。
    • | | extra | コンテキストに関連する追加情報 (ORDAリクエストの場合、データクラス名や属性名など) | リクエストフロー: @@ -129,7 +129,7 @@ SET DATABASE PARAMETER(Client Log Recording;1) // リモートサイド ## HTTPDebugLog.txt -このログファイルは、各 HTTPリクエストとそれぞれのレスポンスを rawモードで記録します。 ヘッダーを含むリクエスト全体が記録され、オプションでボディ部分も記録することができます。 +このログファイルは、各 HTTPリクエストとそれぞれのレスポンスを rawモードで記録します。ヘッダーを含むリクエスト全体が記録され、オプションでボディ部分も記録することができます。 このログの開始方法: @@ -153,7 +153,7 @@ WEB SET OPTION(Web debug log;wdl enable without body) // 他の値も使用可 ## 4DHTTPClientLog.txt -このログファイルは、4D HTTPクライアントを通過する HTTPトラフィックを記録します。 ヘッダーを含むリクエストおよびレスポンス全体が記録され、オプションでボディ部分も記録することができます。 +このログファイルは、4D HTTPクライアントを通過する HTTPトラフィックを記録します。ヘッダーを含むリクエストおよびレスポンス全体が記録され、オプションでボディ部分も記録することができます。 このログの開始方法: @@ -182,7 +182,7 @@ HTTP SET OPTION(HTTP client log; HTTP enable log with all body parts) ## 4DDebugLog.txt (標準) -このログファイルは、4Dプログラミングレベルで発生するそれぞれのイベントを記録します。 標準モードではイベントの基本的なビューを提供します。 +このログファイルは、4Dプログラミングレベルで発生するそれぞれのイベントを記録します。標準モードではイベントの基本的なビューを提供します。 このログの開始方法: @@ -221,19 +221,19 @@ SET DATABASE PARAMETER(Current process debug log recording;2+4) それぞれのイベントに対して、以下のフィールドが記録されます: -| カラム番号 | フィールド名 | 説明 | -| ----- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 1 | sequence_number | ログセッション内で固有かつシーケンシャルなオペレーション番号 | -| 2 | time | ISO 8601フォーマットの日付と時間 (YYYY-MM-DDTHH:MM:SS.mmm) | -| 3 | ProcessID | プロセスID | -| 4 | unique_processID | 固有プロセスID | -| 5 | stack_level | スタックレベル | -| 6 | operation_type | ログオペレーションタイプ。 この値は絶対値を取ることがあります:

    1. コマンド
    2. メソッド (プロジェクトメソッド、データベースメソッド、等)
    3. メッセージ ([LOG EVENT](https://doc.4d.com/4dv20/help/command/ja/page667.html) コマンドによって送信されたもののみ)
    4. プラグインメッセージ
    5. プラグインイベント
    6. プラグインコマンド
    7. プラグインコールバック
    8. タスク
    9. メンバーメソッド (コレクションまたはオブジェクトに割り当てられているメソッド)

    スタックレベルを閉じる時には、`operation_type`、`operation` および `operation_parameters` カラムには `stack_opening_sequence_number` カラムに記録された開始スタックレベルと同じ値が記録されます。 例:

    1. 121 15:16:50:777 5 8 1 2 CallMethod Parameters 0
    2. 122 15:16:50:777 5 8 2 1 283 0
    3. 123 15:16:50:777 5 8 2 1 283 0 122 3
    4. 124 15:16:50:777 5 8 1 2 CallMethod Parameters 0 121 61

    1行目と 2行目はスタックレベルを開き、3行目と 4行目はスタックレベルを閉じます。 6、7、8カラム目の値は、終了スタックレベル行において繰り返されます。 10カラム目にはスタックレベル開始番号、つまり 3行目の 122 と 4行目の 121 が格納されます。 | -| 7 | operation | 以下のいずれかを表す可能性があります (オペレーションタイプによる):
  • ランゲージコマンドID (type=1 の場合)
  • メソッド名 (type=2 の場合)
  • pluginIndex;pluginCommand の組み合わせ (type=4、5、6 または 7 の場合)。 '3;2' のような形式で格納されます。
  • タスク接続UUID (type=8 の場合)
    • | -| 8 | operation_parameters | コマンド、メソッド、プラグインに渡された引数 | -| 9 | form_event | フォームイベント (あれば)。 その他の場合には空になります (フォームメソッドまたはオブジェクトメソッド内でコードが実行された場合に使用されると考えて下さい) | -| 10 | stack_opening_sequence_number | スタックレベルを閉じる時のみ: 開始スタックレベルに対応するシーケンス番号 | -| 11 | stack_level_execution_time | スタックレベルを閉じる時のみ: 現在記録されているアクションの経過時間をマイクロ秒単位で表します (上記ログの123 行目と124 行目の 10番目のカラムを参照ください) | +| カラム番号 | フィールド名 | 説明 | +| ----- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 1 | sequence_number | ログセッション内で固有かつシーケンシャルなオペレーション番号 | +| 2 | time | ISO 8601フォーマットの日付と時間 (YYYY-MM-DDTHH:MM:SS.mmm) | +| 3 | ProcessID | プロセスID | +| 4 | unique_processID | 固有プロセスID | +| 5 | stack_level | スタックレベル | +| 6 | operation_type | ログオペレーションタイプ。この値は絶対値を取ることがあります:

    1. コマンド
    2. メソッド (プロジェクトメソッド、データベースメソッド、等)
    3. メッセージ ([LOG EVENT](https://doc.4d.com/4dv20/help/command/ja/page667.html) コマンドによって送信されたもののみ)
    4. プラグインメッセージ
    5. プラグインイベント
    6. プラグインコマンド
    7. プラグインコールバック
    8. タスク
    9. メンバーメソッド (コレクションまたはオブジェクトに割り当てられているメソッド)

    スタックレベルを閉じる時には、`operation_type`、`operation` および `operation_parameters` カラムには `stack_opening_sequence_number` カラムに記録された開始スタックレベルと同じ値が記録されます。例:

    1. 121 15:16:50:777 5 8 1 2 CallMethod Parameters 0
    2. 122 15:16:50:777 5 8 2 1 283 0
    3. 123 15:16:50:777 5 8 2 1 283 0 122 3
    4. 124 15:16:50:777 5 8 1 2 CallMethod Parameters 0 121 61

    1行目と 2行目はスタックレベルを開き、3行目と 4行目はスタックレベルを閉じます。 6、7、8カラム目の値は、終了スタックレベル行において繰り返されます。 10カラム目にはスタックレベル開始番号、つまり 3行目の 122 と 4行目の 121 が格納されます。 | +| 7 | operation | 以下のいずれかを表す可能性があります (オペレーションタイプによる):
  • ランゲージコマンドID (type=1 の場合)
  • メソッド名 (type=2 の場合)
  • pluginIndex;pluginCommand の組み合わせ (type=4、5、6 または 7 の場合)。 '3;2' のような形式で格納されます。
  • タスク接続UUID (type=8 の場合)
    • | +| 8 | operation_parameters | コマンド、メソッド、プラグインに渡された引数 | +| 9 | form_event | フォームイベント (あれば)。 その他の場合には空になります (フォームメソッドまたはオブジェクトメソッド内でコードが実行された場合に使用されると考えて下さい) | +| 10 | stack_opening_sequence_number | スタックレベルを閉じる時のみ: 開始スタックレベルに対応するシーケンス番号 | +| 11 | stack_level_execution_time | スタックレベルを閉じる時のみ: 現在記録されているアクションの経過時間をマイクロ秒単位で表します (上記ログの123 行目と124 行目の 10番目のカラムを参照ください) | ## 4DDiagnosticLog.txt @@ -260,9 +260,9 @@ SET DATABASE PARAMETER(Current process debug log recording;2+4) ### 診断ログレベル -*4DDiagnosticLog.txt* ファイルは、`ERROR` (最も重要) から `TRACE` (あまり重要でない) まで、異なるレベルのメッセージをログに記録することができます。 デフォルトでは、`INFO` レベルが設定されており、エラーや予期せぬ結果などの重要なイベントのみを記録します (後述参照)。 +*4DDiagnosticLog.txt* ファイルは、`ERROR` (最も重要) から `TRACE` (あまり重要でない) まで、異なるレベルのメッセージをログに記録することができます。デフォルトでは、`INFO` レベルが設定されており、エラーや予期せぬ結果などの重要なイベントのみを記録します (後述参照)。 -[SET DATABASE PARAMETER](https://doc.4d.com/4dv20/help/command/ja/page642.html) コマンドの `Diagnostic log level` セレクターを使用して、必要に応じてメッセージのレベルを選択することができます。 あるレベルを選択すると、その上のレベル (より重要なもの) も暗黙のうちに選択されます。 次のレベルが利用可能です: +[SET DATABASE PARAMETER](https://doc.4d.com/4dv20/help/command/ja/page642.html) コマンドの `Diagnostic log level` セレクターを使用して、必要に応じてメッセージのレベルを選択することができます。あるレベルを選択すると、その上のレベル (より重要なもの) も暗黙のうちに選択されます。次のレベルが利用可能です: | 定数 | 説明 | 選択時に次を含みます | | ----------- | ------------------------------------- | ------------------------------------------------------------- | @@ -352,7 +352,7 @@ ORDAリクエストログは、ORDAリクエストとサーバーのレスポン ### クライアント側 -クライアント側の ORDAログファイルには、リモートマシンが送信する ORDAリクエストが記録されます。 ログ情報はメモリか、リモートマシンディスク上の .txtファイルに書くことができます。 このログファイルの名称や保管場所は任意に決めることができます。 +クライアント側の ORDAログファイルには、リモートマシンが送信する ORDAリクエストが記録されます。ログ情報はメモリか、リモートマシンディスク上の .txtファイルに書くことができます。このログファイルの名称や保管場所は任意に決めることができます。 このログの開始方法: @@ -366,7 +366,7 @@ SET DATABASE PARAMETER(Client Log Recording;0) :::note -`SET DATABASE PARAMETER` を用いてクライアント側の [4DRequestsLog.txt](#4drequestslogtxt) をトリガーすることは必須ではありません。 ただし、一意の `sequenceNumber` フィールドを記録したい場合には必須です。 +`SET DATABASE PARAMETER` を用いてクライアント側の [4DRequestsLog.txt](#4drequestslogtxt) をトリガーすることは必須ではありません。ただし、一意の `sequenceNumber` フィールドを記録したい場合には必須です。 ::: @@ -402,7 +402,7 @@ SET DATABASE PARAMETER(Client Log Recording;0) ### サーバー側 -サーバー側の ORDAログファイルには、サーバーが処理した ORDAリクエストと、サーバーのレスポンス (任意) が記録されます。 ログ情報は、サーバーマシンのディスク上にある .jsonlファイル (デフォルトでは、*ordaRequests.jsonl*) に保存されます。 +サーバー側の ORDAログファイルには、サーバーが処理した ORDAリクエストと、サーバーのレスポンス (任意) が記録されます。ログ情報は、サーバーマシンのディスク上にある .jsonlファイル (デフォルトでは、*ordaRequests.jsonl*) に保存されます。 このログの開始方法: @@ -416,7 +416,7 @@ SET DATABASE PARAMETER(4D Server log recording;0) :::note -`SET DATABASE PARAMETER` を用いてサーバー側の [4DRequestsLog.txt](#4drequestslogtxt) をトリガーすることは必須ではありません。 ただし、一意の `sequenceNumber` および `duration` フィールドを記録したい場合には必須です。 +`SET DATABASE PARAMETER` を用いてサーバー側の [4DRequestsLog.txt](#4drequestslogtxt) をトリガーすることは必須ではありません。ただし、一意の `sequenceNumber` および `duration` フィールドを記録したい場合には必須です。 ::: @@ -460,14 +460,14 @@ SET DATABASE PARAMETER(4D Server log recording;0) ## ログ設定ファイルを使用する -運用環境におけるログ記録を簡単に管理するため、**ログ設定ファイル** を使用することができます。 このファイルは、デベロッパーによってあらかじめ設定されています。 一般的には、エンドユーザーに送って、選択してもらうか、ローカルフォルダーにコピーしてもらいます。 一旦有効化されると、ログ設定ファイルは専用仕様のログ記録を開始します。 +運用環境におけるログ記録を簡単に管理するため、**ログ設定ファイル** を使用することができます。このファイルは、デベロッパーによってあらかじめ設定されています。一般的には、エンドユーザーに送って、選択してもらうか、ローカルフォルダーにコピーしてもらいます。一旦有効化されると、ログ設定ファイルは専用仕様のログ記録を開始します。 ### ファイルを有効化する方法 環境に応じて、ログ設定ファイルを有効化する方法はいくつかあります: -- **インターフェース付きの 4D Server**: メンテナンスページを開き、[ログ設定ファイルを読み込む](ServerWindow/maintenance.md#ログ設定ファイルを読み込む) ボタンをクリックしてファイルを選択します。 この場合、設定ファイルには任意の名前を使用することができます。 ファイルは、サーバー上で即座に有効化されます。 -- **インタープリターまたはコンパイル済のプロジェクト**: `logConfig.json` ファイルをプロジェクトの [Settings フォルダー](../Project/architecture.md#settings-ユーザー) ([`Project` フォルダー](../Project/architecture.md#project-フォルダー)と同じ階層)に配置します。 このファイルは、プロジェクトの起動時に有効化されます (クライアント/サーバーのサーバーのみ)。 +- **インターフェース付きの 4D Server**: メンテナンスページを開き、[ログ設定ファイルを読み込む](ServerWindow/maintenance.md#ログ設定ファイルを読み込む) ボタンをクリックしてファイルを選択します。この場合、設定ファイルには任意の名前を使用することができます。ファイルは、サーバー上で即座に有効化されます。 +- **インタープリターまたはコンパイル済のプロジェクト**: `logConfig.json` ファイルをプロジェクトの [Settings フォルダー](../Project/architecture.md#settings-ユーザー) ([`Project` フォルダー](../Project/architecture.md#project-フォルダー)と同じ階層)に配置します。このファイルは、プロジェクトの起動時に有効化されます (クライアント/サーバーのサーバーのみ)。 - **ビルドしたアプリケーション**: ファイルは `logConfig.json` という名称で次のフォルダーに置く必要があります: * Windows: `Users\[userName]\AppData\Roaming\[application]` * macOS: `/Users/[userName]/Library/ApplicationSupport/[application]` diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onActivate.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onActivate.md index 7c102c34ad7038..886041071d9f7d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onActivate.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onActivate.md @@ -12,6 +12,6 @@ title: On Activate フォームのウィンドウが背面に送られていた場合、そのウィンドウが最前面になったときにこのイベントが呼ばれます。 -このイベントは個々のオブジェクトには適用されず、フォーム全体に適用されます。 ゆえに `On Activate` フォームイベントプロパティが選択されていれば、そのフォームのメソッドのみが呼び出されます。 +このイベントは個々のオブジェクトには適用されず、フォーム全体に適用されます。ゆえに `On Activate` フォームイベントプロパティが選択されていれば、そのフォームのメソッドのみが呼び出されます。 サブフォームの場合には、コンテナーがフォーカスを得たとき ([フォーカス可](FormObjects/properties_Entry.md#フォーカス可) プロパティが設定されている場合) に、このイベントがサブフォームに渡されます。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAfterKeystroke.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAfterKeystroke.md index fb17defe199171..290e417bcd32b8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAfterKeystroke.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAfterKeystroke.md @@ -25,11 +25,11 @@ title: On After Keystroke `On After Keystroke` イベントは次の場合には生成されません: - [リストボックス列](FormObjects/listbox-column.md) メソッドの場合、ただし、セルを編集している場合を除きます ([リストボックス](FormObjects/listbox_overview.md) メソッドではどのような場合でも生成されます)。 -- キーボードを使用せずに (ペーストやドラッグ＆ドロップ、チェックボックス、ドロップダウンリスト、コンボボックス) おこなわれた変更の場合。 これらのイベントを処理するには [`On After Edit`](onAfterEdit.md) を使用します。 +- キーボードを使用せずに (ペーストやドラッグ＆ドロップ、チェックボックス、ドロップダウンリスト、コンボボックス) おこなわれた変更の場合。これらのイベントを処理するには [`On After Edit`](onAfterEdit.md) を使用します。 ### キーストロークシーケンス -入力に一連のキーストロークが必要な場合、[`On Before Keystroke`](onBeforeKeystroke.md) と `On After Keystroke` イベントは、入力がユーザーによって完全に確定されたときにのみ生成されます。 `Keystroke` コマンドは、確定済みの文字を返します。 このケースは主に以下のように発生します: +入力に一連のキーストロークが必要な場合、[`On Before Keystroke`](onBeforeKeystroke.md) と `On After Keystroke` イベントは、入力がユーザーによって完全に確定されたときにのみ生成されます。 `Keystroke` コマンドは、確定済みの文字を返します。このケースは主に以下のように発生します: - ^ や ~ のような特殊キーが使用された場合: その後に拡張された文字が入力された場合にのみ生成されます (例: "ê" や "ñ")。 - IME (Input Method Editor) が、文字の組み合わせを入力するための中間的なダイアログボックスを表示している場合: IME のダイアログが確定されたときにのみイベントが発生します。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAlternativeClick.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAlternativeClick.md index f4dc848da18687..aafc75aad3f3bd 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAlternativeClick.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onAlternativeClick.md @@ -11,12 +11,12 @@ title: On Alternative Click ### ボタン -いくつかのボタンスタイルには、[ポップアップメニュー](FormObjects/properties_TextAndPicture.md#ポップアップメニューあり) をリンクし、矢印を表示させることができます。 この矢印をクリックすると、ボタンの主たるアクションの代わりのアクションを提供するポップアップを表示します。 +いくつかのボタンスタイルには、[ポップアップメニュー](FormObjects/properties_TextAndPicture.md#ポップアップメニューあり) をリンクし、矢印を表示させることができます。この矢印をクリックすると、ボタンの主たるアクションの代わりのアクションを提供するポップアップを表示します。 -4D では `On Alternative Click` イベントを使用してこの動作を管理できます。 このイベントは、ユーザーが矢印をクリックすると、マウスボタンが押されてすぐに生成されます: +4D では `On Alternative Click` イベントを使用してこの動作を管理できます。このイベントは、ユーザーが矢印をクリックすると、マウスボタンが押されてすぐに生成されます: -- ポップアップメニューが **分離** されている場合、このイベントはボタン中で矢印のあるエリアがクリックされた場合のみ生成されます。 ボタンに適用されている [標準アクション](https://doc.4d.com/4Dv19R7/4D/19-R7/Standard-actions.300-6013479.ja.html) があったとしても、この場合には実行されないことに留意してください。 -- ポップアップメニューが **リンク** されている場合、このイベントはボタン上どこをクリックしても生成されます。 このタイプのボタンでは [`On Long Click`](onLongClick.md) イベントが生成されないことに注意してください。 +- ポップアップメニューが **分離** されている場合、このイベントはボタン中で矢印のあるエリアがクリックされた場合のみ生成されます。ボタンに適用されている [標準アクション](https://doc.4d.com/4Dv19R7/4D/19-R7/Standard-actions.300-6013479.ja.html) があったとしても、この場合には実行されないことに留意してください。 +- ポップアップメニューが **リンク** されている場合、このイベントはボタン上どこをクリックしても生成されます。このタイプのボタンでは [`On Long Click`](onLongClick.md) イベントが生成されないことに注意してください。 ![](../assets/en/Events/clickevents.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onBeforeDataEntry.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onBeforeDataEntry.md index 93d071fceabd86..c4b4b499faf970 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onBeforeDataEntry.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onBeforeDataEntry.md @@ -10,7 +10,7 @@ title: On Before Data Entry ## 説明 -このイベントは、リストボックス中のセルが編集される直前に生成されます (入力カーソルが表示される前)。 このイベントを使用して、たとえば表示中と編集中で異なるテキストを表示させることができます。 +このイベントは、リストボックス中のセルが編集される直前に生成されます (入力カーソルが表示される前)。このイベントを使用して、たとえば表示中と編集中で異なるテキストを表示させることができます。 カーソルがセルに入ると、そのリストボックスまたは列のメソッドで `On Before Data Entry` イベントが生成されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onCloseDetail.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onCloseDetail.md index e7a95d02761edf..920633a2012eb4 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onCloseDetail.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onCloseDetail.md @@ -12,6 +12,6 @@ title: On Close Detail `On Close Detail` イベントは次のコンテキストで利用できます: -- **出力フォーム**: このイベントは、詳細フォームが閉じられ、ユーザーがリストフォームに戻るときに生成されます。 このイベントは、プロジェクトフォームでは選択できず、**テーブルフォーム** でのみ利用できます。 +- **出力フォーム**: このイベントは、詳細フォームが閉じられ、ユーザーがリストフォームに戻るときに生成されます。このイベントは、プロジェクトフォームでは選択できず、**テーブルフォーム** でのみ利用できます。 - [**セレクション型**](FormObjects/listbox_overview.md#セレクションリストボックス) のリストボックス: このイベントはセレクション型リストボックスに関連付けられた [詳細フォーム](FormObjects/properties_ListBox.md#詳細フォーム名) に表示されたレコードが閉じられるときに生成されます (レコードが変更されたかどうかは関係しません)。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onColumnResize.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onColumnResize.md index 99e859dcf5df11..a410c57793abbf 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onColumnResize.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onColumnResize.md @@ -12,13 +12,13 @@ title: On Column Resize ### リストボックス -このイベントは、ユーザーによってリストボックスの列幅が変更されたときに生成されます。 このイベントは "ライブ" にトリガーされます。つまり、対象となるリストボックスあるいはカラムがリサイズされている間はずっと継続して送信されつづけます。 リサイズはユーザーによって手動でおこなわれるか、あるいはフォームウィンドウ自身のリサイズの結果リストボックスとそのカラムがリサイズされる場合も含みます (手動によるフォームのリサイズおよび `RESIZE FORM WINDOW` コマンドを使用したリサイズ)。 +このイベントは、ユーザーによってリストボックスの列幅が変更されたときに生成されます。このイベントは "ライブ" にトリガーされます。つまり、対象となるリストボックスあるいはカラムがリサイズされている間はずっと継続して送信されつづけます。リサイズはユーザーによって手動でおこなわれるか、あるいはフォームウィンドウ自身のリサイズの結果リストボックスとそのカラムがリサイズされる場合も含みます (手動によるフォームのリサイズおよび `RESIZE FORM WINDOW` コマンドを使用したリサイズ)。 > [余白カラム](../FormObjects/propertiesResizingOptions.html#余白カラムについて) がリサイズされた場合には、`On Column Resize` イベントはトリガーされません ### 4D View Pro -このイベントはカラムの幅がユーザーによって変更されたときに生成されます。 このコンテキストにおいて、`FORM Event` コマンドによって返される [イベントオブジェクト](overview.md#イベントオブジェクト) には以下のプロパティが含まれています: +このイベントはカラムの幅がユーザーによって変更されたときに生成されます。このコンテキストにおいて、`FORM Event` コマンドによって返される [イベントオブジェクト](overview.md#イベントオブジェクト) には以下のプロパティが含まれています: | プロパティ | 型 | 説明 | | ----------- | ------- | --------------------------------------------------- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onDeleteAction.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onDeleteAction.md index bac67e4236e2a3..28e8b5380e9d7e 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onDeleteAction.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onDeleteAction.md @@ -12,4 +12,4 @@ title: On Delete Action このイベントは、ユーザーが削除キー (**Delete** や **Backspace** キー) を押して、またはクリア標準アクションが割り当てられたメニュー項目 (**編集** メニューの **クリア** 等) を選択して、選択された項目の削除を指示したときに生成されます。 -4D はイベントの生成だけをおこなうことに留意してください。 4D は項目を消去しません。 実際の削除処理や事前警告の表示などは開発者の責任です。 +4D はイベントの生成だけをおこなうことに留意してください。 4D は項目を消去しません。実際の削除処理や事前警告の表示などは開発者の責任です。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onDragOver.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onDragOver.md index 6eb0f4644810d9..49d7ab7f6065ac 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onDragOver.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onDragOver.md @@ -10,18 +10,18 @@ title: On Drag Over ## 説明 -`On Drag Over` イベントは、マウスポインターがオブジェクトの上を移動する時に、繰り返しドロップ先オブジェクトに送られます。 このイベントの応答として、開発者は通常、以下のことをおこないます: +`On Drag Over` イベントは、マウスポインターがオブジェクトの上を移動する時に、繰り返しドロップ先オブジェクトに送られます。このイベントの応答として、開発者は通常、以下のことをおこないます: - ペーストボード内にあるデータや署名を (`GET PASTEBOARD DATA` コマンドを使用して) 取得する。 - ペーストボードのデータの状態や型に基づき、ドラッグ＆ドロップの **受け付け** または **拒否** をおこないます。 -ドラッグを **受け付ける** には、ドロップ先のオブジェクトメソッドが (`$0:=0` を実行して) 0 (ゼロ) を返さなければなりません。 ドラッグを **拒否** するには、オブジェクトメソッドが (`$0:=-1` を実行して) -1 (マイナス1) を返さなければなりません。 `On Drag Over` イベント中、4D はこのオブジェクトメソッドを関数として扱います。 結果が返されない場合には、4D はドラッグが受け付けられたものと認識します。 +ドラッグを **受け付ける** には、ドロップ先のオブジェクトメソッドが (`$0:=0` を実行して) 0 (ゼロ) を返さなければなりません。ドラッグを **拒否** するには、オブジェクトメソッドが (`$0:=-1` を実行して) -1 (マイナス1) を返さなければなりません。 `On Drag Over` イベント中、4D はこのオブジェクトメソッドを関数として扱います。結果が返されない場合には、4D はドラッグが受け付けられたものと認識します。 -ドラッグを受け入れると、ドロップ先オブジェクトがハイライトされます。 ドラッグを拒否した場合、ドロップ先オブジェクトはハイライトされません。 ドラッグを受け付けることは、ドラッグされたデータがドロップ先オブジェクトに挿入されるという意味ではありません。 これは、単にマウスボタンをこの場所で離したときに、ドラッグされたデータがドロップ先オブジェクトによって受け付けられ、[`On Drop`](onDrop.md) イベントが動くということを意味するだけです。 +ドラッグを受け入れると、ドロップ先オブジェクトがハイライトされます。ドラッグを拒否した場合、ドロップ先オブジェクトはハイライトされません。ドラッグを受け付けることは、ドラッグされたデータがドロップ先オブジェクトに挿入されるという意味ではありません。これは、単にマウスボタンをこの場所で離したときに、ドラッグされたデータがドロップ先オブジェクトによって受け付けられ、[`On Drop`](onDrop.md) イベントが動くということを意味するだけです。 ドロップ可能なオブジェクトに対して開発者が `On Drag Over` イベントを処理しない場合には、そのオブジェクトは、ドラッグされたデータの性質やタイプに関係なく、すべてのドラッグ処理に対してハイライトされます。 -`On Drag Over` イベントは、ドラッグ＆ドロップ処理の最初の段階を制御する手段です。 ドラッグされたデータがドロップ先オブジェクトと互換性のあるタイプかどうかをテストでき、またドラッグの受け付けや拒否をできるだけでなく、4D があなたの判断に基づいてドロップ先オブジェクトをハイライト (または無反応) されるため、この操作が有効であることを操作者にフィードバックすることができます。 +`On Drag Over` イベントは、ドラッグ＆ドロップ処理の最初の段階を制御する手段です。ドラッグされたデータがドロップ先オブジェクトと互換性のあるタイプかどうかをテストでき、またドラッグの受け付けや拒否をできるだけでなく、4D があなたの判断に基づいてドロップ先オブジェクトをハイライト (または無反応) されるため、この操作が有効であることを操作者にフィードバックすることができます。 `On Drag Over` イベントはマウスの移動に従って、現在のドロップ先オブジェクトに対して繰り返し送られるため、このイベントのコード処理は短く、短時間で実行されるようにしてください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onFooterClick.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onFooterClick.md index 8100c2588a42ef..f7a95faa1d6364 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onFooterClick.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onFooterClick.md @@ -10,6 +10,6 @@ title: On Footer Click ## 説明 -このイベントはリストボックスやリストボックス列で利用できます。 このイベントは、リストボックスやリストボックス列のフッターエリアがクリックされたときに生成されます。 この場合、`OBJECT Get pointer` コマンドはクリックされたフッター変数へのポインターを返します。 イベントは左および右クリックどちらでも生成されます。 +このイベントはリストボックスやリストボックス列で利用できます。このイベントは、リストボックスやリストボックス列のフッターエリアがクリックされたときに生成されます。この場合、`OBJECT Get pointer` コマンドはクリックされたフッター変数へのポインターを返します。イベントは左および右クリックどちらでも生成されます。 `Clickcount` コマンドを使うことによってユーザーがおこなったクリック数をテストすることができます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onHeaderClick.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onHeaderClick.md index d5f2c795bd9a20..b5cfadb3436608 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onHeaderClick.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onHeaderClick.md @@ -12,18 +12,18 @@ title: On Header Click ### リストボックス -このイベントは、リストボックスの列ヘッダーでクリックがおこなわれると生成されます。 この場合 `Self` コマンドを使用すればクリックされた列ヘッダーを知ることができます。 +このイベントは、リストボックスの列ヘッダーでクリックがおこなわれると生成されます。この場合 `Self` コマンドを使用すればクリックされた列ヘッダーを知ることができます。 リストボックスで [ソート可](FormObjects/properties_Action.md#ソート可) プロパティが選択されている場合、`$0` に 0 または -1 を渡して標準の並べ替えをおこなうかどうか指定できます: - `$0 = 0` の場合、標準の並べ替えがおこなわれます。 -- `$0 = -1` の場合、標準の並べ替えはおこなわれず、ヘッダーには並べ替え矢印は表示されません。 開発者は 4Dランゲージを使用して、カスタマイズされた条件に基づく並べ替えを実行できます。 +- `$0 = -1` の場合、標準の並べ替えはおこなわれず、ヘッダーには並べ替え矢印は表示されません。開発者は 4Dランゲージを使用して、カスタマイズされた条件に基づく並べ替えを実行できます。 リストボックスで [ソート可](FormObjects/properties_Action.md#ソート可) プロパティが選択されていない場合、`$0` は使用されません。 ### 4D View Pro -このイベントは、4D View Pro ドキュメント内のカラムヘッダーまたは行ヘッダーでクリックが発生したときに生成されます。 このコンテキストにおいて、`FORM Event` コマンドによって返される [イベントオブジェクト](overview.md#イベントオブジェクト) には以下のプロパティが含まれています: +このイベントは、4D View Pro ドキュメント内のカラムヘッダーまたは行ヘッダーでクリックが発生したときに生成されます。このコンテキストにおいて、`FORM Event` コマンドによって返される [イベントオブジェクト](overview.md#イベントオブジェクト) には以下のプロパティが含まれています: | プロパティ | 型 | 説明 | | ----------- | ------- | ------------------------------------------------------------------------------------------------------ | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onLoadRecord.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onLoadRecord.md index aa271739dbc690..26059a98a4b03b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onLoadRecord.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onLoadRecord.md @@ -10,7 +10,7 @@ title: On Load Record ## 説明 -`On Load Record` イベントは、**出力フォーム** のコンテキストでのみ使用できます。 このイベントはリスト更新中に、レコードがハイライトされ、フィールドが編集モードになったときに生成されます。 +`On Load Record` イベントは、**出力フォーム** のコンテキストでのみ使用できます。このイベントはリスト更新中に、レコードがハイライトされ、フィールドが編集モードになったときに生成されます。 > このイベントは、プロジェクトフォームでは選択できず、**テーブルフォーム** でのみ利用できます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onLongClick.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onLongClick.md index 779f60336a7bd8..185c70f7b52ea8 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onLongClick.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onLongClick.md @@ -10,7 +10,7 @@ title: On Long Click ## 説明 -このイベントはボタンがクリックされ、一定時間以上マウスボタンが押され続けていると生成されます。 理論上、このイベントが生成されるためのクリック保持時間は、システムの環境設定に設定されたダブルクリックの間隔最大時間に等しくなります。 +このイベントはボタンがクリックされ、一定時間以上マウスボタンが押され続けていると生成されます。理論上、このイベントが生成されるためのクリック保持時間は、システムの環境設定に設定されたダブルクリックの間隔最大時間に等しくなります。 このイベントは、次のボタンスタイルで生成することができます: @@ -24,7 +24,7 @@ title: On Long Click - [サークル](FormObjects/button_overview.md#サークル) - [カスタム](FormObjects/button_overview.md#カスタム) -このイベントは一般的に、ロングクリック時にポップアップメニューを表示するために使用します。 ユーザーがロングクリックが有効になる時間前にマウスボタンを離すと、[`On Clicked`](onClicked.md) イベントが (有効であれば) 生成されます。 +このイベントは一般的に、ロングクリック時にポップアップメニューを表示するために使用します。ユーザーがロングクリックが有効になる時間前にマウスボタンを離すと、[`On Clicked`](onClicked.md) イベントが (有効であれば) 生成されます。 ### 参照 [`On Alternative Click`](onAlternativeClick.md) \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseEnter.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseEnter.md index 580d2b235722bc..bff02496a511b1 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseEnter.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseEnter.md @@ -19,7 +19,7 @@ title: On Mouse Enter ### コールスタック -`On Mouse Enter` イベントがフォームにおいてチェックされている場合、各フォームオブジェクトに対してイベントが生成されます。 あるオブジェクトにおいてチェックされている場合は、そのオブジェクトに対してのみ生成されます。 重なったオブジェクトがある場合はトップレベルから順に、イベントを処理することができる最初のオブジェクトによって生成されます。 +`On Mouse Enter` イベントがフォームにおいてチェックされている場合、各フォームオブジェクトに対してイベントが生成されます。あるオブジェクトにおいてチェックされている場合は、そのオブジェクトに対してのみ生成されます。重なったオブジェクトがある場合はトップレベルから順に、イベントを処理することができる最初のオブジェクトによって生成されます。 ### 参照 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseLeave.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseLeave.md index 0d22dd1ad1efdc..4b3f94e0995074 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseLeave.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseLeave.md @@ -19,7 +19,7 @@ title: On Mouse Leave ### コールスタック -`On Mouse Leave` イベントがフォームにおいてチェックされている場合、各フォームオブジェクトに対してイベントが生成されます。 あるオブジェクトにおいてチェックされている場合は、そのオブジェクトに対してのみ生成されます。 重なったオブジェクトがある場合はトップレベルから順に、イベントを処理することができる最初のオブジェクトによって生成されます。 +`On Mouse Leave` イベントがフォームにおいてチェックされている場合、各フォームオブジェクトに対してイベントが生成されます。あるオブジェクトにおいてチェックされている場合は、そのオブジェクトに対してのみ生成されます。重なったオブジェクトがある場合はトップレベルから順に、イベントを処理することができる最初のオブジェクトによって生成されます。 ### 参照 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseMove.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseMove.md index 94b131b1243593..4cdb0b384c8425 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseMove.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onMouseMove.md @@ -13,7 +13,7 @@ title: On Mouse Move このイベントは次の場合に生成されます: - マウスカーソルが 1ピクセル以上動いた -- または、変更キー (**Shift**, **Alt/Option**, **Shift Lock**) が押された。 これにより、ドラッグ＆ドロップによるコピーや移動も管理できるようになります +- または、変更キー (**Shift**, **Alt/Option**, **Shift Lock**) が押された。これにより、ドラッグ＆ドロップによるコピーや移動も管理できるようになります イベントがオブジェクトに対してのみチェックされていた場合は、マウスカーソルがオブジェクトの描画エリア内にあった場合にのみイベントが生成されます。 @@ -24,7 +24,7 @@ title: On Mouse Move ### コールスタック -`On Mouse Move` イベントがフォームにおいてチェックされている場合、各フォームオブジェクトに対してイベントが生成されます。 あるオブジェクトにおいてチェックされている場合は、そのオブジェクトに対してのみ生成されます。 重なったオブジェクトがある場合はトップレベルから順に、イベントを処理することができる最初のオブジェクトによって生成されます。 +`On Mouse Move` イベントがフォームにおいてチェックされている場合、各フォームオブジェクトに対してイベントが生成されます。あるオブジェクトにおいてチェックされている場合は、そのオブジェクトに対してのみ生成されます。重なったオブジェクトがある場合はトップレベルから順に、イベントを処理することができる最初のオブジェクトによって生成されます。 ### 参照 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onPageChange.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onPageChange.md index b56a47ba1838d1..652608afac15aa 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onPageChange.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onPageChange.md @@ -10,10 +10,10 @@ title: On Page Change ## 説明 -このイベントは、フォームレベルでのみ利用できます (フォームメソッド内でのみ使用します)。 このイベントは、(`FORM GOTO PAGE` コマンドの呼び出しや標準ナビゲーションアクションに伴い) フォームのカレントページが変更されるたびに生成されます。 +このイベントは、フォームレベルでのみ利用できます (フォームメソッド内でのみ使用します)。このイベントは、(`FORM GOTO PAGE` コマンドの呼び出しや標準ナビゲーションアクションに伴い) フォームのカレントページが変更されるたびに生成されます。 ページが完全にロードされた後 (つまり、([Webエリア](FormObjects/webArea_overview.md) を含む) すべてのオブジェクトが初期化された後) に呼び出されることに留意してください。 > 唯一の例外は 4D View Proエリアで、その場合は専用の [On VP Ready](onVpReady.md) イベントを呼び出す必要があります。 -`On Page Change` イベントは、すべてのオブジェクトが初期化済みの状態で実行する必要のあるコードがあるときに有用です。 また、フォームのページ1 がロードされたときにすべてのコードを実行するのではなく、特定のページが開かれたときにのみ (検索などの) コードを実行するようにして、アプリケーションを最適化できます。 ユーザーがそのページを開かなければ、コードは実行されません。 \ No newline at end of file +`On Page Change` イベントは、すべてのオブジェクトが初期化済みの状態で実行する必要のあるコードがあるときに有用です。また、フォームのページ1 がロードされたときにすべてのコードを実行するのではなく、特定のページが開かれたときにのみ (検索などの) コードを実行するようにして、アプリケーションを最適化できます。ユーザーがそのページを開かなければ、コードは実行されません。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onResize.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onResize.md index 8b66bb86551818..520f7f22c2a2ac 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onResize.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onResize.md @@ -13,4 +13,4 @@ title: On Resize このイベントは次の場合に生成されます: - フォームのウィンドウがリサイズされた -- サブフォームのコンテキストでは、親フォームにおいてサブフォームオブジェクトのサイズが変更された場合。 この場合、イベントはサブフォームのフォームメソッドが受け取ります。 +- サブフォームのコンテキストでは、親フォームにおいてサブフォームオブジェクトのサイズが変更された場合。この場合、イベントはサブフォームのフォームメソッドが受け取ります。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onRowMoved.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onRowMoved.md index d538d3234085cf..bd580c04e97771 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onRowMoved.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onRowMoved.md @@ -10,6 +10,6 @@ title: On Row Moved ## 説明 -このイベントは、ユーザーのドラッグ＆ドロップ ([許可されていれば](FormObjects/properties_Action.md#行の移動可)) で、リストボックス ([配列型のみ](FormObjects/listbox_overview.md#配列リストボックス)) の行が移動されたときに生成されます。 ただし、元の場所にドロップされた場合には生成されません。 +このイベントは、ユーザーのドラッグ＆ドロップ ([許可されていれば](FormObjects/properties_Action.md#行の移動可)) で、リストボックス ([配列型のみ](FormObjects/listbox_overview.md#配列リストボックス)) の行が移動されたときに生成されます。ただし、元の場所にドロップされた場合には生成されません。 `LISTBOX MOVED ROW NUMBER` コマンドは行の新しい位置を返します。 \ No newline at end of file diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onRowResize.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onRowResize.md index 76872396adf7be..498e8e40cc2c42 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onRowResize.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onRowResize.md @@ -10,7 +10,7 @@ title: On Row Resize ## 説明 -このイベントは、4D View Pro ドキュメント内で行の高さがユーザーによって変更されたときに生成されます。 このコンテキストにおいて、`FORM Event` コマンドによって返される [イベントオブジェクト](overview.md#イベントオブジェクト) には以下のプロパティが含まれています: +このイベントは、4D View Pro ドキュメント内で行の高さがユーザーによって変更されたときに生成されます。このコンテキストにおいて、`FORM Event` コマンドによって返される [イベントオブジェクト](overview.md#イベントオブジェクト) には以下のプロパティが含まれています: | プロパティ | 型 | 説明 | | ----------- | ------- | ------------------------------------------------- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onScroll.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onScroll.md index 19655b53d2d56e..0b9688c65addf7 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onScroll.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onScroll.md @@ -12,14 +12,14 @@ title: On Scroll このイベントは、ピクチャー入力またはリストボックスのコンテキストで生成されます。 -このイベントは、スクロールアクションに関連した他のすべてのユーザーイベント ([On Clicked](onClicked.md)、[On After Keystroke](onAfterKeystroke.md)、等) の後にトリガーされます。 このイベントは、オブジェクトメソッドの中でのみ生成されます (フォームメソッドでは生成されません)。 +このイベントは、スクロールアクションに関連した他のすべてのユーザーイベント ([On Clicked](onClicked.md)、[On After Keystroke](onAfterKeystroke.md)、等) の後にトリガーされます。このイベントは、オブジェクトメソッドの中でのみ生成されます (フォームメソッドでは生成されません)。 このイベントは、ユーザーのアクションの結果としてスクロールが発生した場合にのみ生成されます: スクロールバー/カーソルの使用、マウスホイールまたは [キーボード](FormObjects/properties_Appearance.md#縦スクロールバー) の使用、等です。 [`OBJECT SET SCROLL POSITION`](../commands/object-set-scroll-position) コマンド使用の結果スクロールした場合には生成されません。 ### ピクチャー入力 -このイベントは、ユーザーがピクチャー入力 (フィールドや変数) 内のピクチャーをスクロールすると生成されます。 ピクチャーエリアのサイズがピクチャーよりも小さく、かつ表示テーマの [ピクチャーフォーマット](FormObjects/properties_Display.md#ピクチャーフォーマット) プロパティが "トランケート (中央合わせなし)" に設定されている場合のみスクロールが可能です。 +このイベントは、ユーザーがピクチャー入力 (フィールドや変数) 内のピクチャーをスクロールすると生成されます。ピクチャーエリアのサイズがピクチャーよりも小さく、かつ表示テーマの [ピクチャーフォーマット](FormObjects/properties_Display.md#ピクチャーフォーマット) プロパティが "トランケート (中央合わせなし)" に設定されている場合のみスクロールが可能です。 ### リストボックス diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onSelectionChange.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onSelectionChange.md index c7d27624c81eb8..d82446c35bd797 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onSelectionChange.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onSelectionChange.md @@ -14,7 +14,7 @@ title: On Selection Change ### 4D View Pro -現在の行や列の選択が変更された。 このコンテキストにおいて、`FORM Event` コマンドによって返される [イベントオブジェクト](overview.md#イベントオブジェクト) には以下のプロパティが含まれています: +現在の行や列の選択が変更された。このコンテキストにおいて、`FORM Event` コマンドによって返される [イベントオブジェクト](overview.md#イベントオブジェクト) には以下のプロパティが含まれています: | プロパティ | 型 | 説明 | | ------------- | ------- | --------------------- | diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onUnload.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onUnload.md index 96c0249de2b274..4243a76ea5dd65 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onUnload.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onUnload.md @@ -12,15 +12,15 @@ title: On Unload このイベントは、フォームを閉じて解放しようとしているときに生成されます。 -`On Unload` オブジェクトイベントプロパティが選択されている、フォームの全ページの全オブジェクトのオブジェクトメソッドが呼び出されます。 その後、`On Unload` フォームイベントプロパティが選択されていれば、フォームメソッドが呼び出されます。 +`On Unload` オブジェクトイベントプロパティが選択されている、フォームの全ページの全オブジェクトのオブジェクトメソッドが呼び出されます。その後、`On Unload` フォームイベントプロパティが選択されていれば、フォームメソッドが呼び出されます。 -> オブジェクトの [`On Load`](onLoad.md) と `On Unload` イベントが生成されるには、オブジェクトとオブジェクトが属するフォームの両方で有効にされていなければなりません。 オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 +> オブジェクトの [`On Load`](onLoad.md) と `On Unload` イベントが生成されるには、オブジェクトとオブジェクトが属するフォームの両方で有効にされていなければなりません。オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 ### サブフォーム -`On Unload` イベントは、サブフォームを閉じる際に生成されます。 これらのイベントは親フォームレベルでも有効にされていなければなりません。 このイベントは、親フォームのイベントよりも前に生成される点に留意してください。 また、フォームイベント動作の原則に従い、サブフォームが 0 もしくは 1 以外のページに配置されている場合、このイベントはページが閉じられるときに生成され、フォームが閉じられるときではないことに留意してください。 +`On Unload` イベントは、サブフォームを閉じる際に生成されます。 これらのイベントは親フォームレベルでも有効にされていなければなりません。このイベントは、親フォームのイベントよりも前に生成される点に留意してください。また、フォームイベント動作の原則に従い、サブフォームが 0 もしくは 1 以外のページに配置されている場合、このイベントはページが閉じられるときに生成され、フォームが閉じられるときではないことに留意してください。 ### 参照 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onVpRangeChanged.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onVpRangeChanged.md index 72da85e52563a2..41d010ed913561 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onVpRangeChanged.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onVpRangeChanged.md @@ -22,6 +22,6 @@ FORM Event によって返されるオブジェクトには以下のプロパテ | description | text | "On VP Range Changed" | | sheetName | text | イベントが発生したシート名 | | range | object | 変化したセルレンジ | -| changedCells | object | 変化したセルのみを格納したレンジ。 レンジが組み合わされたものである可能性もあります。 | +| changedCells | object | 変化したセルのみを格納したレンジ。レンジが組み合わされたものである可能性もあります。 | | action | text | イベント生成した操作のタイプ:
  • "clear" - レンジの値をクリア操作
  • "dragDrop" - ドラッグドロップ操作
  • "dragFill" - ドラッグによるフィル操作
  • "evaluateFormula" - 特定のセルレンジにフォーミュラを設定した
  • "paste" - ペースト操作
  • "setArrayFormula" - 特定のセルレンジにフォーミュラを設定した
  • "sort" - セルのレンジを並べ替えた
    • | > [On After Edit](onAfterEdit.md) も参照ください。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onWindowOpeningDenied.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onWindowOpeningDenied.md index f964ef3e33f397..a3b8e6e7a7a72b 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onWindowOpeningDenied.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/onWindowOpeningDenied.md @@ -20,7 +20,7 @@ title: On Window Opening Denied `WA Get last filtered URL` コマンドコマンドを使用してブロックされた URL を知ることができます。 -このイベントは、[ドラッグ＆ドロップ](../FormObjects/webArea_overview.md#ユーザーインターフェース) オプションが有効にされていれば、Webエリア（埋め込みWebエリアまたは Windows システム[レンダリングエンジン](../FormObjects/properties_WebArea.md#propertiesWebArea#埋め込みwebレンダリングエンジンを使用)）に対してドロップ操作がなされたときにも発生します。 次を呼び出すことで、ドロップを受け入れることができます: +このイベントは、[ドラッグ＆ドロップ](../FormObjects/webArea_overview.md#ユーザーインターフェース) オプションが有効にされていれば、Webエリア（埋め込みWebエリアまたは Windows システム[レンダリングエンジン](../FormObjects/properties_WebArea.md#propertiesWebArea#埋め込みwebレンダリングエンジンを使用)）に対してドロップ操作がなされたときにも発生します。次を呼び出すことで、ドロップを受け入れることができます: ```4d // Webエリアオブジェクトメソッド diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/overview.md index c33d13131f6816..1f451c00276471 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Events/overview.md @@ -3,9 +3,9 @@ id: overview title: フォームイベント --- -フォームイベントとは、フォームメソッドやフォームオブジェクトメソッドの実行につながるイベントのことです。 フォームイベントにより、アプリケーションの流れをコントロールしたり、特定のイベントが発生したときにのみ実行されるコードを書くことができます。 +フォームイベントとは、フォームメソッドやフォームオブジェクトメソッドの実行につながるイベントのことです。フォームイベントにより、アプリケーションの流れをコントロールしたり、特定のイベントが発生したときにのみ実行されるコードを書くことができます。 -コードの中では、トリガーされたイベントを返す `FORM Event` コマンドを使ってイベントを制御します。 例: +コードの中では、トリガーされたイベントを返す `FORM Event` コマンドを使ってイベントを制御します。例: ```4d // ボタンのコード @@ -19,7 +19,7 @@ End if ## イベントオブジェクト -各イベントは、`FORM Event` コマンドによってオブジェクトとして返されます。 デフォルトで、以下のプロパティが含まれています: +各イベントは、`FORM Event` コマンドによってオブジェクトとして返されます。デフォルトで、以下のプロパティが含まれています: | プロパティ | 型 | 説明 | | ----- | - | -- | @@ -28,7 +28,7 @@ End if `Form event code` によっても返されます。| |description|text|フォームイベント名 (例: "On After Edit")| -イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。 特に: +イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。特に: - [リストボックス](FormObjects/listbox-object.md#supported-form-events) and [リストボックスカラム](FormObjects/listbox-column.md#supported-form-events) は`columnName` あるいは `isRowSelected` という[追加のプロパティ](FormObjects/listbox-object.md#supported-form-events) を返します。 - [4D View Pro エリア](FormObjects/viewProArea_overview.md) は、`sheetName` や `action` といったプロパティを [On After Edit](onAfterEdit.md) イベントオブジェクトに返します。 @@ -41,9 +41,9 @@ End if - まず 4D は、フォーム中のオブジェクトをブラウズし、発生したオブジェクトイベントがプロパティで選択されているすべてのオブジェクトのオブジェクトメソッドを呼び出します。 - 次に、発生したイベントに対応するフォームイベントがフォームのプロパティで選択されていれば、フォームメソッドを呼び出します。 -オブジェクトメソッドが特定の順序で呼び出されることを期待することはできません。 おおまかに言って、オブジェクトメソッドは常にフォームメソッドよりも前に呼び出されます。 オブジェクトがサブフォームの場合、サブフォームのリストフォームのオブジェクトメソッドが呼び出され、次にリストフォームのフォームメソッドが呼び出されます。 そして 4D は引き続き、親フォームのオブジェクトメソッドを呼び出します。 つまり、オブジェクトがサブフォームの時、 4D はサブフォームオブジェクト内で、オブジェクトとフォームメソッドと同じルールを適用します。 +オブジェクトメソッドが特定の順序で呼び出されることを期待することはできません。おおまかに言って、オブジェクトメソッドは常にフォームメソッドよりも前に呼び出されます。オブジェクトがサブフォームの場合、サブフォームのリストフォームのオブジェクトメソッドが呼び出され、次にリストフォームのフォームメソッドが呼び出されます。そして 4D は引き続き、親フォームのオブジェクトメソッドを呼び出します。つまり、オブジェクトがサブフォームの時、 4D はサブフォームオブジェクト内で、オブジェクトとフォームメソッドと同じルールを適用します。 -[On Load](onLoad.md) と [On Unload](onUnload.md) イベントを除き (後述参照)、発生したイベントがフォームイベントプロパティで選択されていなかったとしても、オブジェクトプロパティで選択されていれば、そのオブジェクトメソッドの呼び出しが妨げられることはありません。 言い換えれば、フォームレベルでイベントを有効あるいは無効にしても、オブジェクトイベントプロパティには影響ありません。 +[On Load](onLoad.md) と [On Unload](onUnload.md) イベントを除き (後述参照)、発生したイベントがフォームイベントプロパティで選択されていなかったとしても、オブジェクトプロパティで選択されていれば、そのオブジェクトメソッドの呼び出しが妨げられることはありません。言い換えれば、フォームレベルでイベントを有効あるいは無効にしても、オブジェクトイベントプロパティには影響ありません。 特定のイベントに関連するオブジェクトの数は、イベントの性質により異なります。 @@ -51,70 +51,71 @@ End if 以下の表は、それぞれのイベントごとにどのようにオブジェクトメソッドとフォームメソッドが呼ばれるかを概説します: -| イベント | オブジェクトメソッド | フォームメソッド | 対象オブジェクト | -| ------------------------ | ---------------------------- | -------- | ------------ | -| On Load | ◯ | ◯ | すべてのオブジェクト | -| On Unload | ◯ | ◯ | すべてのオブジェクト | -| On Validate | ◯ | ◯ | すべてのオブジェクト | -| On Clicked | ◯ | ◯ | 関係するオブジェクトのみ | -| On Double Clicked | ◯ | ◯ | 関係するオブジェクトのみ | -| On Before Keystroke | ◯ | ◯ | 関係するオブジェクトのみ | -| On After Keystroke | ◯ | ◯ | 関係するオブジェクトのみ | -| On After Edit | ◯ | ◯ | 関係するオブジェクトのみ | -| On Getting Focus | ◯ | ◯ | 関係するオブジェクトのみ | -| On Losing Focus | ◯ | ◯ | 関係するオブジェクトのみ | -| On Activate | X | ◯ | なし | -| On Deactivate | X | ◯ | なし | -| On Outside Call | X | ◯ | なし | -| On Page Change | X | ◯ | なし | -| On Begin Drag Over | ◯ | ◯ | 関係するオブジェクトのみ | -| On Drop | ◯ | ◯ | 関係するオブジェクトのみ | -| On Drag Over | ◯ | X | 関係するオブジェクトのみ | -| On Mouse Enter | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Move | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Leave | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Up | ◯ | X | 関係するオブジェクトのみ | -| On Menu Selected | X | ◯ | なし | -| On Bound variable change | X | ◯ | なし | -| On Data Change | ◯ | ◯ | 関係するオブジェクトのみ | -| On Plug in Area | ◯ | ◯ | 関係するオブジェクトのみ | -| On Header | ◯ | ◯ | すべてのオブジェクト | -| On Printing Detail | ◯ | ◯ | すべてのオブジェクト | -| On Printing Break | ◯ | ◯ | すべてのオブジェクト | -| On Printing Footer | ◯ | ◯ | すべてのオブジェクト | -| On Close Box | X | ◯ | なし | -| On Display Detail | ◯ | ◯ | すべてのオブジェクト | -| On Open Detail | ◯ (リストボックス) | ◯ | リストボックスのみ | -| On Close Detail | ◯ (リストボックス) | ◯ | リストボックスのみ | -| On Resize | X | ◯ | なし | -| On Selection Change | ◯ | ◯ | 関係するオブジェクトのみ | -| On Load Record | X | ◯ | なし | -| On Timer | X | ◯ | なし | -| On Scroll | ◯ | X | 関係するオブジェクトのみ | -| On Before Data Entry | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Column Moved | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Row Moved | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Column Resize | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Header Click | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Footer Click | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On After Sort | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Long Click | ◯ (ボタン) | ◯ | 関係するオブジェクトのみ | -| On Alternative Click | ◯ (ボタンとリストボックス) | X | 関係するオブジェクトのみ | -| On Expand | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On Collapse | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On Delete Action | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On URL Resource Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Begin URL Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On URL Loading Error | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On URL Filtering | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On End URL Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Open External Link | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Window Opening Denied | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On VP Range Changed | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On VP Ready | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Row Resize | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | - -イベントに対応するプロパティが選択されている場合にのみ、フォームやオブジェクトのメソッドが呼び出されることに留意してください。 デザインモードのフォームエディターのプロパティリストでイベントを無効にすると、メソッドが呼び出される回数を減らすことができ、フォームの実行速度を最適化できます。 - -> 警告: オブジェクトの [On Load](onLoad.md) と [On Unload](onUnload.md) イベントが生成されるには、オブジェクトとオブジェクトが属するフォームの両方で有効にされていなければなりません。 オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 +| イベント | コード | オブジェクトメソッド | フォームメソッド | 対象オブジェクト | +| ------------------------ | --- | ---------------------------- | -------- | ------------ | +| On Activate | 11 | X | ◯ | なし | +| On After Edit | 45 | ◯ | ◯ | 関係するオブジェクトのみ | +| On After Keystroke | 28 | ◯ | ◯ | 関係するオブジェクトのみ | +| On After Sort | 30 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Alternative Click | 38 | ◯ (ボタンとリストボックス) | X | 関係するオブジェクトのみ | +| On Before Data Entry | 41 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Before Keystroke | 17 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Begin Drag Over | 46 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Begin URL Loading | 47 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Bound variable change | 54 | X | ◯ | なし | +| On Clicked | 4 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Close Box | 22 | X | ◯ | なし | +| On Close Detail | 26 | ◯ (リストボックス) | ◯ | リストボックスのみ | +| On Collapse | 44 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Column Moved | 32 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Column Resize | 33 | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Data Change | 20 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Deactivate | 12 | X | ◯ | なし | +| On Delete Action | 58 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Display Detail | 8 | ◯ | ◯ | すべてのオブジェクト | +| On Double Clicked | 13 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Drag Over | 21 | ◯ | X | 関係するオブジェクトのみ | +| On Drop | 16 | ◯ | ◯ | 関係するオブジェクトのみ | +| On End URL Loading | 49 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Expand | 43 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Footer Click | 57 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Getting Focus | 15 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Header | 5 | ◯ | ◯ | すべてのオブジェクト | +| On Header Click | 42 | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Load | 1 | ◯ | ◯ | すべてのオブジェクト | +| On Load Record | 40 | X | ◯ | なし | +| On Long Click | 39 | ◯ (ボタン) | ◯ | 関係するオブジェクトのみ | +| On Losing Focus | 14 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Menu Selected | 18 | X | ◯ | なし | +| On Mouse Enter | 35 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Leave | 36 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Move | 37 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Up | 2 | ◯ | X | 関係するオブジェクトのみ | +| On Open Detail | 25 | ◯ (リストボックス) | ◯ | リストボックスのみ | +| On Open External Link | 52 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Outside Call | 10 | X | ◯ | なし | +| On Page Change | 56 | X | ◯ | なし | +| On Plug in Area | 19 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Printing Break | 6 | ◯ | ◯ | すべてのオブジェクト | +| On Printing Detail | 23 | ◯ | ◯ | すべてのオブジェクト | +| On Printing Footer | 7 | ◯ | ◯ | すべてのオブジェクト | +| On Resize | 29 | X | ◯ | なし | +| On Row Moved | 34 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Row Resize | 60 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Scroll | 59 | ◯ | X | 関係するオブジェクトのみ | +| On Selection Change | 31 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Timer | 27 | X | ◯ | なし | +| On Unload | 24 | ◯ | ◯ | すべてのオブジェクト | +| On URL Filtering | 51 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On URL Loading Error | 50 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On URL Resource Loading | 48 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Validate | 3 | ◯ | ◯ | すべてのオブジェクト | +| On VP Range Changed | 61 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On VP Ready | 9 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Window Opening Denied | 53 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | + +イベントに対応するプロパティが選択されている場合にのみ、フォームやオブジェクトのメソッドが呼び出されることに留意してください。デザインモードのフォームエディターのプロパティリストでイベントを無効にすると、メソッドが呼び出される回数を減らすことができ、フォームの実行速度を最適化できます。 + +> 警告: オブジェクトの [On Load](onLoad.md) と [On Unload](onUnload.md) イベントが生成されるには、オブジェクトとオブジェクトが属するフォームの両方で有効にされていなければなりません。オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-20/Notes/updates.md b/i18n/ja/docusaurus-plugin-content-docs/version-20/Notes/updates.md index 81425a586bb38c..a3ae6eaebad31f 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-20/Notes/updates.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-20/Notes/updates.md @@ -35,7 +35,7 @@ title: リリースノート #### 動作の変更 -- 4D **20.7 HF2** 以降、[`Time`](https://doc.4d.com/4dv20/help/command/ja/page179.html) コマンドは、*timeValue* 引数が負の値の場合には負の時間式を返すようになりました。 例えば、`Time("-01:02:03")` は、 -01:02:03 を返すようになりました。 過去のリリースにおいては、負の符号は無視されていました。 +- 4D **20.7 HF2** 以降、[`Time`](https://doc.4d.com/4dv20/help/command/ja/page179.html) コマンドは、*timeValue* 引数が負の値の場合には負の時間式を返すようになりました。例えば、`Time("-01:02:03")` は、 -01:02:03 を返すようになりました。過去のリリースにおいては、負の符号は無視されていました。 ## 4D 20.6 LTS @@ -44,7 +44,7 @@ title: リリースノート :::info 評価版アプリケーション -ナイトリービルド**101734**以降、アプリケーションビルド画面には評価版アプリケーションをビルドするための新しいオプションが表示されるようになりました。 詳細は[4D Rx ドキュメンテーションの説明](../../../docs/Desktop/building#evaluation-application)を参照してください。 +ナイトリービルド**101734**以降、アプリケーションビルド画面には評価版アプリケーションをビルドするための新しいオプションが表示されるようになりました。詳細は[4D Rx ドキュメンテーションの説明](../../../docs/Desktop/building#evaluation-application)を参照してください。 ::: @@ -52,7 +52,7 @@ title: リリースノート :::警告 WINDOWS SERVER 2025 での既知の問題 -Windows Server 2025 では、新しいWindows 印刷ダイアログボックス内での一部のカスタムのオプションは利用不可となっており、現在調査中です。 この問題はHotfixで修正される予定です。 +Windows Server 2025 では、新しいWindows 印刷ダイアログボックス内での一部のカスタムのオプションは利用不可となっており、現在調査中です。この問題はHotfixで修正される予定です。 ::: @@ -93,7 +93,7 @@ Windows 11 24H2 では、Microsoft Print to PDFドライバーを使用して PD #### 動作の変更 -- 4D 20.3では、[4Dユーザーディレクトリが bcryptアルゴリズムを使用している](https://blog.4d.com/ja/bcrypt-support-for-passwords/)場合にパスワード認証を可能にするため、[`Open datastore`](../API/DataStoreClass.md#open-datastore)コマンドの *connectionInfo* パラメーターに設定する "password" 値は、デフォルトでクリアテキストで送信されるようになりました。 "On REST authentication" データベースメソッドが、パスワードを平文の状態で扱えるようにし (3番目のパラメーターは **False**)、`Open datastore` に渡す *connectionInfo* で "tls" オプションを **True** にすることで、接続が暗号化されるようにする必要があります。 特定の場合には、新しい "passwordAlgorithm" オプションも互換性のために使用できます ([`Open datastore`](../API/DataStoreClass.md#open-datastore) コマンド参照)。 +- 4D 20.3では、[4Dユーザーディレクトリが bcryptアルゴリズムを使用している](https://blog.4d.com/ja/bcrypt-support-for-passwords/)場合にパスワード認証を可能にするため、[`Open datastore`](../API/DataStoreClass.md#open-datastore)コマンドの *connectionInfo* パラメーターに設定する "password" 値は、デフォルトでクリアテキストで送信されるようになりました。 "On REST authentication" データベースメソッドが、パスワードを平文の状態で扱えるようにし (3番目のパラメーターは **False**)、`Open datastore` に渡す *connectionInfo* で "tls" オプションを **True** にすることで、接続が暗号化されるようにする必要があります。特定の場合には、新しい "passwordAlgorithm" オプションも互換性のために使用できます ([`Open datastore`](../API/DataStoreClass.md#open-datastore) コマンド参照)。 ## 4D 20.2 LTS @@ -104,7 +104,7 @@ Windows 11 24H2 では、Microsoft Print to PDFドライバーを使用して PD :::warning セキュリティに関する注記 -4Dアプリケーションが TLS接続を使用する場合は、4D 20.2 LTS build 100956以上へのアップグレードが推奨されます。 詳細は [セキュリティ情報](https://blog.4d.com/ja/security-bulletin-two-cves-and-how-to-stay-secure/) を参照ください。 +4Dアプリケーションが TLS接続を使用する場合は、4D 20.2 LTS build 100956以上へのアップグレードが推奨されます。詳細は [セキュリティ情報](https://blog.4d.com/ja/security-bulletin-two-cves-and-how-to-stay-secure/) を参照ください。 ::: @@ -144,7 +144,7 @@ Windows 11 24H2 では、Microsoft Print to PDFドライバーを使用して PD :::caution インデックス再構築 -4D 20 では、ICUライブラリのアップデート (後述参照) により、文字列型、テキスト型、オブジェクト型のインデックスの再構築が強制されます。 データファイルのサイズに応じて、この処理には時間がかかることがあるため、計画的なアップグレードが推奨されます。 +4D 20 では、ICUライブラリのアップデート (後述参照) により、文字列型、テキスト型、オブジェクト型のインデックスの再構築が強制されます。データファイルのサイズに応じて、この処理には時間がかかることがあるため、計画的なアップグレードが推奨されます。 ::: @@ -176,11 +176,11 @@ Windows 11 24H2 では、Microsoft Print to PDFドライバーを使用して PD #### 動作の変更 -- HTTP RFC に準拠するため、[`HTTPRequestClass.response.headers`](../API/HTTPRequestClass.md#response) プロパティは、すべてのヘッダー名を **小文字で** 返すようになりました。 以前と同じふるまいが必要な場合には、新しい [`HTTPRequestClass.response.rawHeaders`](../API/HTTPRequestClass.md#response) プロパティを使用します。 -- [`4D.HTTPRequest.new()`](../API/HTTPRequestClass.md#4dhttprequestnew) で HTTPリクエストを送信する際、TLS証明書が 4Dによって自動的に検証され、無効な場合はエラーで拒否されるようになりました。 新しい *option* プロパティで、この検証を管理することができます。 +- HTTP RFC に準拠するため、[`HTTPRequestClass.response.headers`](../API/HTTPRequestClass.md#response) プロパティは、すべてのヘッダー名を **小文字で** 返すようになりました。以前と同じふるまいが必要な場合には、新しい [`HTTPRequestClass.response.rawHeaders`](../API/HTTPRequestClass.md#response) プロパティを使用します。 +- [`4D.HTTPRequest.new()`](../API/HTTPRequestClass.md#4dhttprequestnew) で HTTPリクエストを送信する際、TLS証明書が 4Dによって自動的に検証され、無効な場合はエラーで拒否されるようになりました。新しい *option* プロパティで、この検証を管理することができます。 - TLS v1.0 および TLS v1.1 は廃止され、4D Server において `Min TLS version` としてサポートされなくなりました。 `_o_TLSv1_0` または `_o_TLSv1_1` 定数が [`SET DATABASE PARAMETER`](https://doc.4d.com/4dv20/help/command/ja/page642.html) で設定されている場合には、バージョン 1.3 が自動的に使用されます。 - 一貫性のため、ボタン・チェックボックス・ラジオボタンはすべて、実行時に "3D" タイプでレンダリングされるようになりました。 これらのオブジェクトに対し [`OBJECT Get type`](https://doc.4d.com/4dv20/help/command/ja/page1300.html) を呼び出した場合、返されるのはそれぞれ、`Object type 3D button`、`Object type 3D checkbox`、`Object type 3D radio button` の値です。 -- 4D for Mobile の開発機能を 4D で利用するには、プロジェクトの ["Components"](../Project/architecture.md#components) フォルダーに [4D Mobile App コンポーネントをインストール](https://developer.4d.com/go-mobile/docs/getting-started/installation) する必要があります。 プロジェクトが [4D Mobile App Server コンポーネント](https://github.com/4d/4D-Mobile-App-Server#4d-mobile-app-server) の機能を使用している場合、こちらも同じ場所にインストールする必要があります。 4D 20 より、[4D for Mobile](https://developer.4d.com/go-mobile/) は 4D環境にデフォルトでインストールされなくなりました。 +- 4D for Mobile の開発機能を 4D で利用するには、プロジェクトの ["Components"](../Project/architecture.md#components) フォルダーに [4D Mobile App コンポーネントをインストール](https://developer.4d.com/go-mobile/docs/getting-started/installation) する必要があります。プロジェクトが [4D Mobile App Server コンポーネント](https://github.com/4d/4D-Mobile-App-Server#4d-mobile-app-server) の機能を使用している場合、こちらも同じ場所にインストールする必要があります。 4D 20 より、[4D for Mobile](https://developer.4d.com/go-mobile/) は 4D環境にデフォルトでインストールされなくなりました。 ### 4D 19 R8 @@ -204,9 +204,9 @@ Windows 11 24H2 では、Microsoft Print to PDFドライバーを使用して PD #### 動作の変更 -- HTTP RFC に準拠するため、[`HTTPRequestClass.response.headers`](../API/HTTPRequestClass.md#response) プロパティは、すべてのヘッダー名を **小文字で** 返すようになりました。 以前と同じふるまいが必要な場合には、新しい [`HTTPRequestClass.response.rawHeaders`](../API/HTTPRequestClass.md#response) プロパティを使用します。 +- HTTP RFC に準拠するため、[`HTTPRequestClass.response.headers`](../API/HTTPRequestClass.md#response) プロパティは、すべてのヘッダー名を **小文字で** 返すようになりました。以前と同じふるまいが必要な場合には、新しい [`HTTPRequestClass.response.rawHeaders`](../API/HTTPRequestClass.md#response) プロパティを使用します。 - [ポップアップメニューがリンクされたベベルボタン](../FormObjects/properties_TextAndPicture.md#with-pop-up-menu)に標準アクションが設定されている場合、ポップアップメニューの項目が選択されたときには標準アクションが実行されないようになりました。 -- Blink (CEF) を使用する Webエリアにおいて、外部スクリプトによって表示されるダイアログは、 `setTimeout()` JS 関数から呼び出されていないとブロックされるようになりました。 これは、現在のCEFのアップデートにより、`alert()` や `print()` などの関数によって表示されるダイアログが、OS ではなく Web エリアで処理されるようになったためです。 [`WA Evaluate JavaScript`](https://doc.4d.com/4dv19/help/command/ja/page1029.html) および [`WA EXECUTE JAVASCRIPT`](https://doc.4d.com/4dv19/help/command/ja/page1043.html) 参照。 +- Blink (CEF) を使用する Webエリアにおいて、外部スクリプトによって表示されるダイアログは、 `setTimeout()` JS 関数から呼び出されていないとブロックされるようになりました。これは、現在のCEFのアップデートにより、`alert()` や `print()` などの関数によって表示されるダイアログが、OS ではなく Web エリアで処理されるようになったためです。 [`WA Evaluate JavaScript`](https://doc.4d.com/4dv19/help/command/ja/page1029.html) および [`WA EXECUTE JAVASCRIPT`](https://doc.4d.com/4dv19/help/command/ja/page1043.html) 参照。 @@ -232,11 +232,11 @@ Windows 11 24H2 では、Microsoft Print to PDFドライバーを使用して PD #### 動作の変更 -- 標準的なインターフェース (OS のファイルエクスプローラなど) との一貫性を保つため、行の選択/ドラッグ＆ドロップに関するリストボックスのルールが変更されました。 連続または不連続の選択行をクリックして移動するだけで、ドラッグできるようになり、**Alt** キーは不要になりました (ひきつづき以前のように使用することはできます)。 **Shift** または **Ctrl/Command** キーが押されている場合、マウスのクリックは押されたとき (マウスダウン) に考慮されます。 リストボックスでのドラッグ＆ドロップの詳細については、[このブログ記事](https:/blog.4d.com/list-boxes-say-goodbye-to-alt-key/) を参照し、[このHDI 4Dプロジェクト](https://github.com/4D-JP/HDI/releases/download/19r7/HDI_LB_DragAndDrop.zip) をダウンロードしてください。 +- 標準的なインターフェース (OS のファイルエクスプローラなど) との一貫性を保つため、行の選択/ドラッグ＆ドロップに関するリストボックスのルールが変更されました。連続または不連続の選択行をクリックして移動するだけで、ドラッグできるようになり、**Alt** キーは不要になりました (ひきつづき以前のように使用することはできます)。 **Shift** または **Ctrl/Command** キーが押されている場合、マウスのクリックは押されたとき (マウスダウン) に考慮されます。リストボックスでのドラッグ＆ドロップの詳細については、[このブログ記事](https:/blog.4d.com/list-boxes-say-goodbye-to-alt-key/) を参照し、[このHDI 4Dプロジェクト](https://github.com/4D-JP/HDI/releases/download/19r7/HDI_LB_DragAndDrop.zip) をダウンロードしてください。 - 4D 19 R7 から 4D の内部ビルド番号が変更されました: - 4D 19 R6 (含む) までのリリースは 282xxx の番号です。 - 4D 19 R7 以降のリリースは 100xxx という番号になります。 - なお、特定の 4Dバージョンは、ブランチ名とビルド番号により一意に識別されます。 ビルド番号は時系列に増加します。 + なお、特定の 4Dバージョンは、ブランチ名とビルド番号により一意に識別されます。ビルド番号は時系列に増加します。 - Wakanda/4D Mobile REST プロトコルを使用してプロジェクトメソッドを呼び出す機能が削除されました。 [ORDAデータモデルクラス関数](../REST/ClassFunctions.md) または [/4DACTION URL](../WebServer/httpRequests.md#4daction) を代わりに使用することができます。 @@ -247,7 +247,7 @@ Windows 11 24H2 では、Microsoft Print to PDFドライバーを使用して PD - リストボックスのセルは、[横方向](../FormObjects/properties_CoordinatesAndSizing.md#横方向パディング) および [縦方向](../FormObjects/properties_CoordinatesAndSizing.md#縦方向パディング) のパディングをサポートするようになりました。 - 4D View Pro: 新しい [VP CREATE TABLE](../ViewPro/method-list.md#vp-create-table) と [VP REMOVE TABLE](../ViewPro/method-list.md#vp-remove-table) コマンドを使用して、シート内のテーブルを操作します。 - [Webデータエクスプローラー](../Admin/dataExplorer.md#基本) でリレート属性、計算属性、およびエイリアス属性を表示することができます。 -- 4D製品を改善し続けるために、実行中の 4D Server アプリケーションの使用状況データを自動的に収集します。 この処理はパフォーマンスに影響を与えません。 [4D がデータを収集する理由と方法](../Admin/data-collect.md) について詳細を説明する新しいページを参照ください。 +- 4D製品を改善し続けるために、実行中の 4D Server アプリケーションの使用状況データを自動的に収集します。この処理はパフォーマンスに影響を与えません。 [4D がデータを収集する理由と方法](../Admin/data-collect.md) について詳細を説明する新しいページを参照ください。 - Silicon用にコンパイルされたコンポーネント: macOS Siliconプラットフォーム (Apple ARM CPU) では、このリリースで使用するためには、コンポーネントを 4D 19 R6 以降で再コンパイルする必要があります。 @@ -257,28 +257,28 @@ Windows 11 24H2 では、Microsoft Print to PDFドライバーを使用して PD - ビルド時に、プロジェクトの [directory.json ファイル](../Users/handling_users_groups.md#directoryjson-file) を [サーバーに埋め込む](../Desktop/building.md#ビルドしたサーバーアプリケーションにプロジェクトのユーザーとグループを埋め込む) ことができるようになりました。 これにより、基本的なセキュリティのユーザーとグループ構成でクライアント/サーバーアプリケーションを運用することができます。 - ビルドするアプリケーションで、[使用しないモジュールの選択を解除](../Desktop/building.md#モジュールの選択解除) できるようになりました。 -- *MeCab* ライブラリが、すべての macOS 4Dアプリケーションにデフォルトで含まれるようになりました。 日本語テキストの管理に特化したこのライブラリは、以前のリリースでは日本語版の macOS 4D でのみ利用可能でした。 最終的なアプリケーションでこのライブラリが必要ない場合は、[選択を解除](../Desktop/building.md#モジュールの選択解除) することができます。 -- [クライアント/サーバーの最適化](../ORDA/remoteDatastores.md#クライアントサーバーの最適化): 新しいクラス関数により、ORDAキャッシュと最適化コンテキストの内容を操作することができます。 詳細は、[コンテキストの事前設定](../ORDA/remoteDatastores.md#コンテキストの事前設定) および [ORDAキャッシュ](../ORDA/remoteDatastores.md#ordaキャッシュ) を参照ください。 +- *MeCab* ライブラリが、すべての macOS 4Dアプリケーションにデフォルトで含まれるようになりました。日本語テキストの管理に特化したこのライブラリは、以前のリリースでは日本語版の macOS 4D でのみ利用可能でした。最終的なアプリケーションでこのライブラリが必要ない場合は、[選択を解除](../Desktop/building.md#モジュールの選択解除) することができます。 +- [クライアント/サーバーの最適化](../ORDA/remoteDatastores.md#クライアントサーバーの最適化): 新しいクラス関数により、ORDAキャッシュと最適化コンテキストの内容を操作することができます。詳細は、[コンテキストの事前設定](../ORDA/remoteDatastores.md#コンテキストの事前設定) および [ORDAキャッシュ](../ORDA/remoteDatastores.md#ordaキャッシュ) を参照ください。 - > これらの関数は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。 ほとんどの場合、使用する必要はないでしょう。 + > これらの関数は、特定の構成のため、ORDAのデフォルト機能をカスタマイズする必要がある開発者向けです。ほとんどの場合、使用する必要はないでしょう。 - [DataClass クラス](../API/DataClassClass.md): 新しい [.getCount()](../API/DataClassClass.md#getcount) 関数は、データクラスの総エンティティ数を返します。 - *4DDiagnosticLog.txt* ファイルは、デフォルトでは高レベルの情報のみを記録します ([INFOレベル](../Debugging/debugLogFiles.md#4ddiagnosticlogtxt))。 `SET DATABASE PARAMETER` コマンドまたはログ設定ファイルの `Diagnostic log level` セレクターを使用して、記録する情報レベル (たとえばDEBUGレベル) を選択できるようになりました。 -- 非共有オブジェクトや非共有コレクションに対して `Use()` を呼び出しても何も起こりません (エラーが発生しなくなりました)。 したがって、Use() に渡されたオブジェクトやコレクションが実際に共有されているかどうかをチェックする意味はなくなりました。 +- 非共有オブジェクトや非共有コレクションに対して `Use()` を呼び出しても何も起こりません (エラーが発生しなくなりました)。したがって、Use() に渡されたオブジェクトやコレクションが実際に共有されているかどうかをチェックする意味はなくなりました。 - 分かりやすさのため、2つの SQLコマンドにプレフィックスが付けられました: `GET DATA SOURCE LIST` は `SQL GET DATA SOURCE LIST`、`Get current data source` は `SQL Get current data source` に名称変更されました。 - **4D View Pro**: - 新しい [VP SET DATA CONTEXT](../ViewPro/method-list.md#vp-set-data-context)、[VP Get data context](../ViewPro/method-list.md#vp-get-data-context)、[VP SET BINDING PATH](../ViewPro/method-list.md#vp-set-binding-path)、および [VP Get binding path](../ViewPro/method-list.md#vp-get-binding-path) コマンドを使って、データコンテキストを作成し、その内容をシートのセルにバインドすることができます。 - [VP EXPORT DOCUMENT](../ViewPro/method-list.md#vp-get-binding-path) と [VP Export to object](../ViewPro/method-list.md#vp-get-binding-path) は、データコンテキストの内容をセルの値としてエクスポートするための新しい `includeBindingSource` オプションを受け付けます。 - (Windowsのみ) 4D View Pro エリアの印刷設定ウィンドウが新しくなりました。 - **Webエリア**: - + 新しい Windowsシステムのレンダリングエンジン: [Windowsシステムのレンダリングエンジン](../FormObjects/webArea_overview.md#webレンダリングエンジン) を使用している Webエリアは、**Microsoft Edge WebView2** をベースとするようになりました。 これにより、以下のような機能に影響があります: + + 新しい Windowsシステムのレンダリングエンジン: [Windowsシステムのレンダリングエンジン](../FormObjects/webArea_overview.md#webレンダリングエンジン) を使用している Webエリアは、**Microsoft Edge WebView2** をベースとするようになりました。これにより、以下のような機能に影響があります: * `WA Create URL history menu` および `WA GET URL HISTORY` のコマンドは、カレントURL のみを返すようになりました。 - [進捗状況変数](../FormObjects/properties_WebArea.md#進捗状況変数) は更新されなくなりました。 - - ドラッグ＆ドロップ機能は、マイクロソフトが "experimental" とタグ付けしている Windows API で処理されます。 そのため、この API がインストールされていない場合、Webエリアが期待どおりに振る舞わないかもしれません: `WA enable URL drop` 設定が false に設定されていても、ドラッグ＆ドロップ機能が許可されているように見えるかもしれません。 しかし、ドロップアクションはデフォルトでブロックされており、許可する URL は [`On Window Opening Denied` イベント](../Events/onWindowOpeningDenied.md) で管理することができます (後述参照)。 + - ドラッグ＆ドロップ機能は、マイクロソフトが "experimental" とタグ付けしている Windows API で処理されます。そのため、この API がインストールされていない場合、Webエリアが期待どおりに振る舞わないかもしれません: `WA enable URL drop` 設定が false に設定されていても、ドラッグ＆ドロップ機能が許可されているように見えるかもしれません。しかし、ドロップアクションはデフォルトでブロックされており、許可する URL は [`On Window Opening Denied` イベント](../Events/onWindowOpeningDenied.md) で管理することができます (後述参照)。 - (Windows のみ) ユーザーが、埋め込みWebレンダリングエンジンを使用している Webエリアから **印刷...** メニューを選択した場合に表示される印刷設定ウィンドウが新しくなりました。 - Webエリアにおけるコマンドの実際の効果 (ページズームレベルの増加/減少) を反映させるため、2つのコマンドの名前が変更されました: `WA SET PAGE TEXT LARGER` は `WA ZOOM IN` に、`WA SET PAGE TEXT SMALLER` は `WA ZOOM OUT` に名称変更されました。 - [埋め込みWebレンダリングエンジン](../FormObjects/properties_WebArea.md#埋め込みwebレンダリングエンジンを使用) または (Microsoft Edge WebView2 に基づく) [Windowsシステムのレンダリングエンジン](../FormObjects/webArea_overview.md#webレンダリングエンジン) を使用する Webエリアでのセキュリティを強化しました: - - Webエリアにおいてディスク上のファイルにアクセスする場合にも、CORSポリシーが適用されるようになりました。 たとえば、`WA OPEN URL` を使用して .html ファイルを開こうとした場合、その .html ファイルには、フォルダー外のファイルへのリンクを含めることはできません。 - - Webエリアへの外部コンテンツのドロップは常にブロックされ、`WA enable URL drop` 設定が true に設定されている場合には、[`On Window Opening Denied` イベント](../Events/onWindowOpeningDenied.md) をトリガーします。 `WA enable URL drop` 設定が false に設定されている場合、マウスカーソルのアイコンのみが変更され、`On Window Opening Denied` イベントはフィルターされます。 ドロップアクションを許可するには、Webエリアのオブジェクトメソッドにおいて以下のような追加のコードを実行する必要があります: + - Webエリアにおいてディスク上のファイルにアクセスする場合にも、CORSポリシーが適用されるようになりました。たとえば、`WA OPEN URL` を使用して .html ファイルを開こうとした場合、その .html ファイルには、フォルダー外のファイルへのリンクを含めることはできません。 + - Webエリアへの外部コンテンツのドロップは常にブロックされ、`WA enable URL drop` 設定が true に設定されている場合には、[`On Window Opening Denied` イベント](../Events/onWindowOpeningDenied.md) をトリガーします。 `WA enable URL drop` 設定が false に設定されている場合、マウスカーソルのアイコンのみが変更され、`On Window Opening Denied` イベントはフィルターされます。ドロップアクションを許可するには、Webエリアのオブジェクトメソッドにおいて以下のような追加のコードを実行する必要があります: ```4d WA OPEN URL(*;"WebArea";WA Get last filtered URL(*;"WebArea")) @@ -298,8 +298,8 @@ WA OPEN URL(*;"WebArea";WA Get last filtered URL(*;"WebArea")) - [4D View Pro](../ViewPro/getting-started.md) の章が次の新コマンドとともに追加されました: [VP Copy to object](../ViewPro/method-list.md#vp-copy-to-object), [VP MOVE CELLS](../ViewPro/method-list.md#vp-move-cells), [VP PASTE FROM OBJECT](../ViewPro/method-list.md#vp-paste-from-object). - 新しい [SystemWorker クラス](../API/SystemWorkerClass.md)。 - ORDA でエイリアス属性をサポートしたことに起因する競合を解決するため、`Alias selection` 定数の名称を `Allow alias files` に変更しました。 -- ORDA の仕様により適合するため、*ヌル値に空値をマップ* フィールドプロパティは、4D 19 R4以降で作成されたデータベースにおいてはデフォルトでチェックされないようになります。 以前のバージョンの 4D から変換されたデータベースにおいては、データベース設定の "フィールド作成時にヌル値を空値にマップをデフォルトでチェックを外す" オプションを選択することで、この新しいデフォルトの振る舞いを有効化することができます。 ORDA では NULL が完全にサポートされるようになったため、今後は使用することが推奨されます。 -- [三項演算子](../Concepts/operators.md#三項演算子) のサポートに伴い、コロン ":" は今後、変数名、フィールド名、定数名、関数名、プラグイン名、プロジェクトメソッド名に使用できなくなります。 データベース/プロジェクトにおいてコロンを含む識別子が使用されている場合には、v19 R4 以降への変換前にそれらを置換する必要があります。 置換しない場合、コード内でエラーが起きる可能性があります。 たとえば、*a:b* という名前の変数があった場合、これが三項演算子シンタックスとして誤解されてしまう可能性があります: +- ORDA の仕様により適合するため、*ヌル値に空値をマップ* フィールドプロパティは、4D 19 R4以降で作成されたデータベースにおいてはデフォルトでチェックされないようになります。以前のバージョンの 4D から変換されたデータベースにおいては、データベース設定の "フィールド作成時にヌル値を空値にマップをデフォルトでチェックを外す" オプションを選択することで、この新しいデフォルトの振る舞いを有効化することができます。 ORDA では NULL が完全にサポートされるようになったため、今後は使用することが推奨されます。 +- [三項演算子](../Concepts/operators.md#三項演算子) のサポートに伴い、コロン ":" は今後、変数名、フィールド名、定数名、関数名、プラグイン名、プロジェクトメソッド名に使用できなくなります。データベース/プロジェクトにおいてコロンを含む識別子が使用されている場合には、v19 R4 以降への変換前にそれらを置換する必要があります。 置換しない場合、コード内でエラーが起きる可能性があります。たとえば、*a:b* という名前の変数があった場合、これが三項演算子シンタックスとして誤解されてしまう可能性があります: ```4d $value:=($size>1000)? a:b // この場合 'a:b' は三項演算子として解釈されます @@ -310,14 +310,14 @@ $value:=($size>1000)? a:b // この場合 'a:b' は三項演算子として解 ### 4D 19 R3 - クラス: [計算プロパティ](../Concepts/classes.md#function-get-と-function-set) が利用可能に。 -- ORDAクラス: [計算属性](../ORDA/ordaClasses.md#計算属性) が利用可能に。 計算プロパティと似ていますが、[クエリ](../ORDA/ordaClasses.md#function-query-attributename) や [orderBy](../ORDA/ordaClasses.md#function-orderby-attributename) 関数もサポートしています。 +- ORDAクラス: [計算属性](../ORDA/ordaClasses.md#計算属性) が利用可能に。計算プロパティと似ていますが、[クエリ](../ORDA/ordaClasses.md#function-query-attributename) や [orderBy](../ORDA/ordaClasses.md#function-orderby-attributename) 関数もサポートしています。 - 新しい ORDAデータクラス [属性](../API/DataClassClass.md#attributename): `exposed` および `readOnly`。 - [ZIPアーカイブ](../API/ZipArchiveClass.md#zip-create-archive): *LZMA* および *xz* 圧縮アルゴリズムをサポート。 - [新しいビルドオプション](../Desktop/building.md#silicon-macos-クライアントからの接続を許可) により、Windows上で Serverアプリケーションに Silicon Macクライアントを組み込むのが簡単になりました。 - macOS で [ダークモードをサポート](../Preferences/general.md#アピアランス-macosのみ)。 - [`IMAP New transporter`](../API/IMAPTransporterClass.md#imap-new-transporter), [`POP3 New transporter`](../API/POP3TransporterClass.md#pop3-new-transporter), および [`SMTP New transporter`](../API/SMTPTransporterClass.md#smtp-new-transporter) で **OAuth2 トークンオブジェクト** をサポート。 - [サーバー管理ウィンドウ](../ServerWindow/maintenance.md#ログ設定ファイルを読み込む) のボタンを使って、[ログ設定ファイル](../Debugging/debugLogFiles.md#ログ設定ファイルを使用する) を読み込めるようになりました。 -- 宣言されたが渡されなかった引数にアクセスする場合の、4Dランゲージの [任意パラメーター](../Concepts/parameters.md#任意パラメーター) の扱いがより柔軟になりました。 たとえば、以下のコードは今後、エラーを生成しません: +- 宣言されたが渡されなかった引数にアクセスする場合の、4Dランゲージの [任意パラメーター](../Concepts/parameters.md#任意パラメーター) の扱いがより柔軟になりました。たとえば、以下のコードは今後、エラーを生成しません: ```4d // myClass クラスの "concate" 関数 @@ -329,18 +329,18 @@ ALERT($param1+" "+$param2) $class.concate("Hello") // "Hello " と表示 $class.concate() // " " と表示 ``` -詳細については、こちらの [ブログ記事](https://blog.4d.com/ja/stop-press-accessing-parameters-not-being-passed-is-possible) を参照ください。 この全体的な変更を利点を活かすため、呼び出し先メソッドと呼び出し元メソッドの両方を再コンパイルする必要があります。 そのため、コンポーネントの再コンパイルが必要になります。 +詳細については、こちらの [ブログ記事](https://blog.4d.com/ja/stop-press-accessing-parameters-not-being-passed-is-possible) を参照ください。この全体的な変更を利点を活かすため、呼び出し先メソッドと呼び出し元メソッドの両方を再コンパイルする必要があります。 そのため、コンポーネントの再コンパイルが必要になります。 - Webサーバーセッションを[4D Serverで容易にデバッグ](../WebServer/sessions.md)できるようになりました。 - 新しい [4D NetKit](https://github.com/4d/4D-NetKit/tree/20.x) コンポーネントを使って、Microsoft Graph などのサードパーティAPI に接続することができます。 -- ツールボックス、`CHANGE PASSWORD` コマンド、または `Set user properties` コマンドを使用してパスワードを変更した際に、この新しいアルゴリズムが自動的に使用されます。 4D 19 R3 では、4Dユーザーパスワードに対して、bcrypt というより強力なハッシュ化アルゴリズムを使用しています。 パスワードが一度変更されると、4D 19 R3 より前のバージョンで同じデータベースを開いた際には、そのアカウントの認証が拒否されます (ログインできません)。 そのため、4Dパスワードを使用している場合には、4D 19 R3 以降のバージョンにアップグレードする前に .4db ファイル (バイナリデータベース) または directory.json ファイル (プロジェクトデータベース) をバックアップしておくことが強く推奨されます。 +- ツールボックス、`CHANGE PASSWORD` コマンド、または `Set user properties` コマンドを使用してパスワードを変更した際に、この新しいアルゴリズムが自動的に使用されます。 4D 19 R3 では、4Dユーザーパスワードに対して、bcrypt というより強力なハッシュ化アルゴリズムを使用しています。パスワードが一度変更されると、4D 19 R3 より前のバージョンで同じデータベースを開いた際には、そのアカウントの認証が拒否されます (ログインできません)。そのため、4Dパスワードを使用している場合には、4D 19 R3 以降のバージョンにアップグレードする前に .4db ファイル (バイナリデータベース) または directory.json ファイル (プロジェクトデータベース) をバックアップしておくことが強く推奨されます。 - 正確性のため、`4D digest` 定数は、`4D REST digest` へと名称が改められました。 -- XML コマンドにおける改行文字と BOM 管理: 以前のバージョンで作成されたプロジェクトまたはデータベースが 4D 19 R3 で開かれた場合、XMLドキュメントにおける改行文字と BOM 管理に関わる振る舞いが異なります: macOS において CR の代わりにラインフィード(LF) が使用されるほか、バイトオーダーマーク (BOM) が含まれなくなります。 これにより、VCS ツールとの互換性が改善されます。 必要であれば、`XML SET OPTIONS` コマンドを使用することで、v19 R2 以前の振る舞いに戻すことができます。 v19 R2 以前のバージョンから変換されたプロジェクトまたはデータベースにおいては、これらのオプションは 2つの互換性設定によって管理されます。 -- ビルドされたプロジェクトで、ランタイムエクスプローラーへのショートカットが削除: シングルユーザー版の組み込みプロジェクトアプリケーションにおいて、**Cmd/Ctrl+Shift+F9** ショートカットは、ランタイムエクスプローラーを表示しないようになりました。 このショートカットは、ユーザーアプリケーション用のショートカットとして使用できるようになりました。 ランタイムエクスプローラーウィンドウは、新しい `OPEN RUNTIME EXPLORER` コマンドを使用することで呼び出し可能です。 -- 4D Server のデバッグ機能の拡張: 4D Server はインタープリターモードにおいて、スケーラブルWeb セッションを含め、全種類のプロセスをデバッグできるようになりました。 これには、デバッガーをサーバーまたはリモートクライアントで有効化するだけです。 - *警告: インタープリターモードにおいて、サーバーでデバッガーが有効化された場合 (デフォルト) には、サーバーマシン上でのデバッグを可能にするため、すべてのサーバープロセスが自動でコオペラティブ実行されます。 これは、4D Server v19 R3 以降に変換されたアプリケーションにおいては、パフォーマンスに重大な影響を生ずる可能性があります。 サーバーをプリエンプティブ実行に戻すには、サーバーのデバッガーを無効化します (そして必要な場合にはリモートクライアント側でデバッガーを有効化します)。 * -- Windows で、4D 19 R3 以降に作成された 4Dプロジェクトおよびデータベースは、フォームにおいて [DirectWrite API](https://learn.microsoft.com/ja-jp/windows/win32/DirectWrite/direct-write-portal) を使用します。 この API はテキストレンダリングを、特に高DPI 環境において改善させます。 スタティックテキスト、入力テキスト、チェックボックス、ボタン、ラジオボタンのテキストレンダリングに対して DirectWrite が使用されます。 リストボックスは、既に DirectWrite を使用しています。 以前の 4D のバージョンで作成されたプロジェクトやデータベースにおいても、互換性オプションを使用することで DirectWrite を有効化することができます。 -- Silicon (Apple ARM CPU) をターゲットに 4D 19.0 でコンパイルされたコンポーネントを使用しており、そのコンポーネント内で `Count parameters` コマンドを呼んでいる場合、4D 19 R3 以降のリリースとの互換性のために、4D 19 R3 でコンポーネントを再コンパイルすることが推奨されます。 コンポーネントが Silicon 向けにコンパイルされていない場合、再コンパイルの必要はありません。 +- XML コマンドにおける改行文字と BOM 管理: 以前のバージョンで作成されたプロジェクトまたはデータベースが 4D 19 R3 で開かれた場合、XMLドキュメントにおける改行文字と BOM 管理に関わる振る舞いが異なります: macOS において CR の代わりにラインフィード(LF) が使用されるほか、バイトオーダーマーク (BOM) が含まれなくなります。これにより、VCS ツールとの互換性が改善されます。必要であれば、`XML SET OPTIONS` コマンドを使用することで、v19 R2 以前の振る舞いに戻すことができます。 v19 R2 以前のバージョンから変換されたプロジェクトまたはデータベースにおいては、これらのオプションは 2つの互換性設定によって管理されます。 +- ビルドされたプロジェクトで、ランタイムエクスプローラーへのショートカットが削除: シングルユーザー版の組み込みプロジェクトアプリケーションにおいて、**Cmd/Ctrl+Shift+F9** ショートカットは、ランタイムエクスプローラーを表示しないようになりました。このショートカットは、ユーザーアプリケーション用のショートカットとして使用できるようになりました。ランタイムエクスプローラーウィンドウは、新しい `OPEN RUNTIME EXPLORER` コマンドを使用することで呼び出し可能です。 +- 4D Server のデバッグ機能の拡張: 4D Server はインタープリターモードにおいて、スケーラブルWeb セッションを含め、全種類のプロセスをデバッグできるようになりました。これには、デバッガーをサーバーまたはリモートクライアントで有効化するだけです。 + *警告: インタープリターモードにおいて、サーバーでデバッガーが有効化された場合 (デフォルト) には、サーバーマシン上でのデバッグを可能にするため、すべてのサーバープロセスが自動でコオペラティブ実行されます。これは、4D Server v19 R3 以降に変換されたアプリケーションにおいては、パフォーマンスに重大な影響を生ずる可能性があります。サーバーをプリエンプティブ実行に戻すには、サーバーのデバッガーを無効化します (そして必要な場合にはリモートクライアント側でデバッガーを有効化します)。 * +- Windows で、4D 19 R3 以降に作成された 4Dプロジェクトおよびデータベースは、フォームにおいて [DirectWrite API](https://learn.microsoft.com/ja-jp/windows/win32/DirectWrite/direct-write-portal) を使用します。この API はテキストレンダリングを、特に高DPI 環境において改善させます。スタティックテキスト、入力テキスト、チェックボックス、ボタン、ラジオボタンのテキストレンダリングに対して DirectWrite が使用されます。リストボックスは、既に DirectWrite を使用しています。以前の 4D のバージョンで作成されたプロジェクトやデータベースにおいても、互換性オプションを使用することで DirectWrite を有効化することができます。 +- Silicon (Apple ARM CPU) をターゲットに 4D 19.0 でコンパイルされたコンポーネントを使用しており、そのコンポーネント内で `Count parameters` コマンドを呼んでいる場合、4D 19 R3 以降のリリースとの互換性のために、4D 19 R3 でコンポーネントを再コンパイルすることが推奨されます。コンポーネントが Silicon 向けにコンパイルされていない場合、再コンパイルの必要はありません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md index deaf17bc306ed8..b2f2cc3162d960 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md @@ -3,9 +3,9 @@ id: overview title: フォームイベント --- -フォームイベントとは、フォームメソッドやフォームオブジェクトメソッドの実行につながるイベントのことです。 フォームイベントにより、アプリケーションの流れをコントロールしたり、特定のイベントが発生したときにのみ実行されるコードを書くことができます。 +フォームイベントとは、フォームメソッドやフォームオブジェクトメソッドの実行につながるイベントのことです。フォームイベントにより、アプリケーションの流れをコントロールしたり、特定のイベントが発生したときにのみ実行されるコードを書くことができます。 -コードの中では、トリガーされたイベントを返す [`FORM Event`](../commands/form-event) コマンドを使ってイベントを制御します。 例: +コードの中では、トリガーされたイベントを返す [`FORM Event`](../commands/form-event) コマンドを使ってイベントを制御します。例: ```4d // ボタンのコード @@ -18,15 +18,15 @@ End if ## イベントオブジェクト -それぞれのイベントは、[`FORM Event`](../commands/form-event) コマンドによってオブジェクトとして返されます。 デフォルトで、以下のプロパティが含まれています: +それぞれのイベントは、[`FORM Event`](../commands/form-event) コマンドによってオブジェクトとして返されます。デフォルトで、以下のプロパティが含まれています: | プロパティ | 型 | 説明 | | ----------- | ------- | ----------------------------------------------------------------- | | objectName | text | イベントをトリガーしているオブジェクト名。フォームによってトリガーされている場合には含まれていません。 | -| code | longint | フォームイベントの数値。 フォームイベントの数値。 `Form event code` によっても返されます。 | +| code | longint | フォームイベントの数値。フォームイベントの数値。 `Form event code` によっても返されます。 | | description | text | フォームイベント名 (例: "On After Edit") | -イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。 特に: +イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。特に: - [リストボックス](FormObjects/listbox-object.md#supported-form-events) および [リストボックス列](FormObjects/listbox-column.md#supported-form-events) は、`columnName` や `isRowSelected` といった、[追加のプロパティ](FormObjects/listbox-object.md#supported-form-events) を返します。 - [4D View Pro エリア](FormObjects/viewProArea_overview.md) は、`sheetName` や `action` といったプロパティを [On After Edit](onAfterEdit.md) イベントオブジェクトに返します。 @@ -38,9 +38,9 @@ End if - まず 4D は、フォーム中のオブジェクトをブラウズし、発生したオブジェクトイベントがプロパティで選択されているすべてのオブジェクトのオブジェクトメソッドを呼び出します。 - 次に、発生したイベントに対応するフォームイベントがフォームのプロパティで選択されていれば、フォームメソッドを呼び出します。 -オブジェクトメソッドが特定の順序で呼び出されることを期待することはできません。 おおまかに言って、オブジェクトメソッドは常にフォームメソッドよりも前に呼び出されます。 オブジェクトがサブフォームの場合、サブフォームのリストフォームのオブジェクトメソッドが呼び出され、次にリストフォームのフォームメソッドが呼び出されます。 そして 4D は引き続き、親フォームのオブジェクトメソッドを呼び出します。 つまり、オブジェクトがサブフォームの時、 4D はサブフォームオブジェクト内で、オブジェクトとフォームメソッドと同じルールを適用します。 +オブジェクトメソッドが特定の順序で呼び出されることを期待することはできません。おおまかに言って、オブジェクトメソッドは常にフォームメソッドよりも前に呼び出されます。オブジェクトがサブフォームの場合、サブフォームのリストフォームのオブジェクトメソッドが呼び出され、次にリストフォームのフォームメソッドが呼び出されます。そして 4D は引き続き、親フォームのオブジェクトメソッドを呼び出します。つまり、オブジェクトがサブフォームの時、 4D はサブフォームオブジェクト内で、オブジェクトとフォームメソッドと同じルールを適用します。 -[On Load](onLoad.md) と [On Unload](onUnload.md) イベントを除き(後述参照)、発生したイベントがフォームイベントプロパティで選択されていなかったとしても、オブジェクトプロパティで選択されていれば、そのオブジェクトメソッドの呼び出しが妨げられることはありません。 言い換えれば、フォームレベルでイベントを有効あるいは無効にしても、オブジェクトイベントプロパティには影響ありません。 +[On Load](onLoad.md) と [On Unload](onUnload.md) イベントを除き(後述参照)、発生したイベントがフォームイベントプロパティで選択されていなかったとしても、オブジェクトプロパティで選択されていれば、そのオブジェクトメソッドの呼び出しが妨げられることはありません。言い換えれば、フォームレベルでイベントを有効あるいは無効にしても、オブジェクトイベントプロパティには影響ありません。 特定のイベントに関連するオブジェクトの数は、イベントの性質により異なります。 @@ -48,71 +48,71 @@ End if 以下の表は、それぞれのイベントごとにどのようにオブジェクトメソッドとフォームメソッドが呼ばれるかを概説します: -| イベント | オブジェクトメソッド | フォームメソッド | 対象オブジェクト | -| ------------------------ | ----------------------------------------------- | -------- | ------------ | -| On Load | ◯ | ◯ | すべてのオブジェクト | -| On Unload | ◯ | ◯ | すべてのオブジェクト | -| On Validate | ◯ | ◯ | すべてのオブジェクト | -| On Clicked | ◯ | ◯ | 関係するオブジェクトのみ | -| On Double Clicked | ◯ | ◯ | 関係するオブジェクトのみ | -| On Before Keystroke | ◯ | ◯ | 関係するオブジェクトのみ | -| On After Keystroke | ◯ | ◯ | 関係するオブジェクトのみ | -| On After Edit | ◯ | ◯ | 関係するオブジェクトのみ | -| On Getting Focus | ◯ | ◯ | 関係するオブジェクトのみ | -| On Losing Focus | ◯ | ◯ | 関係するオブジェクトのみ | -| On Activate | X | ◯ | なし | -| On Deactivate | X | ◯ | なし | -| On Outside Call | X | ◯ | なし | -| On Page Change | X | ◯ | なし | -| On Begin Drag Over | ◯ | ◯ | 関係するオブジェクトのみ | -| On Drop | ◯ | ◯ | 関係するオブジェクトのみ | -| On Drag Over | ◯ | X | 関係するオブジェクトのみ | -| On Mouse Enter | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Move | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Leave | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Up | ◯ | X | 関係するオブジェクトのみ | -| On Menu Selected | X | ◯ | なし | -| On Bound variable change | X | ◯ | なし | -| On Data Change | ◯ | ◯ | 関係するオブジェクトのみ | -| On Plug in Area | ◯ | ◯ | 関係するオブジェクトのみ | -| On Header | ◯ | ◯ | すべてのオブジェクト | -| On Printing Detail | ◯ | ◯ | すべてのオブジェクト | -| On Printing Break | ◯ | ◯ | すべてのオブジェクト | -| On Printing Footer | ◯ | ◯ | すべてのオブジェクト | -| On Close Box | X | ◯ | なし | -| On Display Detail | ◯ | ◯ | すべてのオブジェクト | -| On Open Detail | ◯ (リストボックス) | ◯ | リストボックスのみ | -| On Close Detail | ◯ (リストボックス) | ◯ | リストボックスのみ | -| On Resize | X | ◯ | なし | -| On Selection Change | ◯ | ◯ | 関係するオブジェクトのみ | -| On Load Record | X | ◯ | なし | -| On Timer | X | ◯ | なし | -| On Scroll | ◯ | X | 関係するオブジェクトのみ | -| On Before Data Entry | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Column Moved | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Row Moved | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Column Resize | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Header Click | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Footer Click | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On After Sort | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Long Click | ◯ (ボタン) | ◯ | 関係するオブジェクトのみ | -| On Alternative Click | ◯ (ボタンとリストボックス) | X | 関係するオブジェクトのみ | -| On Expand | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On Collapse | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On Delete Action | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On URL Resource Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Begin URL Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On URL Loading Error | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On URL Filtering | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On End URL Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Open External Link | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Window Opening Denied | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On VP Range Changed | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On VP Ready | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Row Resize | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | - -イベントに対応するプロパティが選択されている場合にのみ、フォームやオブジェクトのメソッドが呼び出されることに留意してください。 デザインモードのフォームエディターのプロパティリストでイベントを無効にすると、メソッドが呼び出される回数を減らすことができ、フォームの実行速度を最適化できます。 - -> 警告: オブジェクトの [On Load](onLoad.md) と [On Unload](onUnload.md) イベントが生成されるには、オブジェクトとオブジェクトが属するフォーム の両方で有効にされていなければなりません。 オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 +| イベント | コード | オブジェクトメソッド | フォームメソッド | 対象オブジェクト | +| ------------------------ | --- | ----------------------------------------------- | -------- | ------------ | +| On Activate | 11 | X | ◯ | なし | +| On After Edit | 45 | ◯ | ◯ | 関係するオブジェクトのみ | +| On After Keystroke | 28 | ◯ | ◯ | 関係するオブジェクトのみ | +| On After Sort | 30 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Alternative Click | 38 | ◯ (ボタンとリストボックス) | X | 関係するオブジェクトのみ | +| On Before Data Entry | 41 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Before Keystroke | 17 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Begin Drag Over | 46 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Begin URL Loading | 47 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Bound variable change | 54 | X | ◯ | なし | +| On Clicked | 4 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Close Box | 22 | X | ◯ | なし | +| On Close Detail | 26 | ◯ (リストボックス) | ◯ | リストボックスのみ | +| On Collapse | 44 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Column Moved | 32 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Column Resize | 33 | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Data Change | 20 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Deactivate | 12 | X | ◯ | なし | +| On Delete Action | 58 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Display Detail | 8 | ◯ | ◯ | すべてのオブジェクト | +| On Double Clicked | 13 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Drag Over | 21 | ◯ | X | 関係するオブジェクトのみ | +| On Drop | 16 | ◯ | ◯ | 関係するオブジェクトのみ | +| On End URL Loading | 49 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Expand | 43 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Footer Click | 57 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Getting Focus | 15 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Header | 5 | ◯ | ◯ | すべてのオブジェクト | +| On Header Click | 42 | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Load | 1 | ◯ | ◯ | すべてのオブジェクト | +| On Load Record | 40 | X | ◯ | なし | +| On Long Click | 39 | ◯ (ボタン) | ◯ | 関係するオブジェクトのみ | +| On Losing Focus | 14 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Menu Selected | 18 | X | ◯ | なし | +| On Mouse Enter | 35 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Leave | 36 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Move | 37 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Up | 2 | ◯ | X | 関係するオブジェクトのみ | +| On Open Detail | 25 | ◯ (リストボックス) | ◯ | リストボックスのみ | +| On Open External Link | 52 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Outside Call | 10 | X | ◯ | なし | +| On Page Change | 56 | X | ◯ | なし | +| On Plug in Area | 19 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Printing Break | 6 | ◯ | ◯ | すべてのオブジェクト | +| On Printing Detail | 23 | ◯ | ◯ | すべてのオブジェクト | +| On Printing Footer | 7 | ◯ | ◯ | すべてのオブジェクト | +| On Resize | 29 | X | ◯ | なし | +| On Row Moved | 34 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Row Resize | 60 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Scroll | 59 | ◯ | X | 関係するオブジェクトのみ | +| On Selection Change | 31 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Timer | 27 | X | ◯ | なし | +| On Unload | 24 | ◯ | ◯ | すべてのオブジェクト | +| On URL Filtering | 51 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On URL Loading Error | 50 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On URL Resource Loading | 48 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Validate | 3 | ◯ | ◯ | すべてのオブジェクト | +| On VP Range Changed | 61 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On VP Ready | 9 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Window Opening Denied | 53 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | + +イベントに対応するプロパティが選択されている場合にのみ、フォームやオブジェクトのメソッドが呼び出されることに留意してください。デザインモードのフォームエディターのプロパティリストでイベントを無効にすると、メソッドが呼び出される回数を減らすことができ、フォームの実行速度を最適化できます。 + +> 警告: オブジェクトの [On Load](onLoad.md) と [On Unload](onUnload.md) イベントが生成されるには、オブジェクトとオブジェクトが属するフォーム の両方で有効にされていなければなりません。オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md index 0ccfde243239af..49155d8c3d0a14 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md @@ -49,7 +49,7 @@ displayed_sidebar: docs | プロパティ | 型 | 説明 | | ----------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Deflate圧縮 (デフォルト)
  • `ZIP Compression LZMA`: LZMA圧縮
  • `ZIP Compression XZ`: XZ圧縮
  • `ZIP Compression none`: 圧縮なし
    • | -| level | Integer | 圧縮レベル。 とりうる値: 1 - 10。 低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。 ただし、圧縮レベルはパフォーマンスに影響します。 デフォルト値 (省略時):
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | +| level | Integer | 圧縮レベル。 とりうる値: 1 - 10。 低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。 ただし、圧縮レベルはパフォーマンスに影響します。 デフォルト値 (省略時):
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | | encryption | Integer | パスワードが設定されていた場合に使用する暗号化方法:
  • `ZIP Encryption AES128`: 128-bit キーを使った AES による暗号化
  • `ZIP Encryption AES192`: 192-bit キーを使った AES による暗号化
  • `ZIP Encryption AES256`: 256-bit キーを使った AES による暗号化 (パスワードが設定されている場合のデフォルト)
  • `ZIP Encryption none`: 暗号化なし (パスワードが設定されてない場合のデフォルト)
    • | | password | Text | 暗号化が必要な場合に使用するパスワード | | files | Collection |
  • `4D.File` または` 4D.Folder` オブジェクトのコレクション
  • 以下のプロパティを持ったオブジェクトのコレクション:
    • プロパティタイプ説明
    source4D.File または 4D.FolderFile または Folder
    destinationText(任意) - アーカイブのコンテンツ構成を変更するための相対ファイルパス
    optionnumber(任意) - `ZIP Ignore invisible files` で非表示ファイルを無視、0 を渡すと全ファイルを圧縮
    | @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## 参照 -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## プロパティ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md index c6d2ea5562f2b0..33d4b26916d8d2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ root フォルダーから取り出します: ## 参照 -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## プロパティ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md index deaf17bc306ed8..b2f2cc3162d960 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md @@ -3,9 +3,9 @@ id: overview title: フォームイベント --- -フォームイベントとは、フォームメソッドやフォームオブジェクトメソッドの実行につながるイベントのことです。 フォームイベントにより、アプリケーションの流れをコントロールしたり、特定のイベントが発生したときにのみ実行されるコードを書くことができます。 +フォームイベントとは、フォームメソッドやフォームオブジェクトメソッドの実行につながるイベントのことです。フォームイベントにより、アプリケーションの流れをコントロールしたり、特定のイベントが発生したときにのみ実行されるコードを書くことができます。 -コードの中では、トリガーされたイベントを返す [`FORM Event`](../commands/form-event) コマンドを使ってイベントを制御します。 例: +コードの中では、トリガーされたイベントを返す [`FORM Event`](../commands/form-event) コマンドを使ってイベントを制御します。例: ```4d // ボタンのコード @@ -18,15 +18,15 @@ End if ## イベントオブジェクト -それぞれのイベントは、[`FORM Event`](../commands/form-event) コマンドによってオブジェクトとして返されます。 デフォルトで、以下のプロパティが含まれています: +それぞれのイベントは、[`FORM Event`](../commands/form-event) コマンドによってオブジェクトとして返されます。デフォルトで、以下のプロパティが含まれています: | プロパティ | 型 | 説明 | | ----------- | ------- | ----------------------------------------------------------------- | | objectName | text | イベントをトリガーしているオブジェクト名。フォームによってトリガーされている場合には含まれていません。 | -| code | longint | フォームイベントの数値。 フォームイベントの数値。 `Form event code` によっても返されます。 | +| code | longint | フォームイベントの数値。フォームイベントの数値。 `Form event code` によっても返されます。 | | description | text | フォームイベント名 (例: "On After Edit") | -イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。 特に: +イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。特に: - [リストボックス](FormObjects/listbox-object.md#supported-form-events) および [リストボックス列](FormObjects/listbox-column.md#supported-form-events) は、`columnName` や `isRowSelected` といった、[追加のプロパティ](FormObjects/listbox-object.md#supported-form-events) を返します。 - [4D View Pro エリア](FormObjects/viewProArea_overview.md) は、`sheetName` や `action` といったプロパティを [On After Edit](onAfterEdit.md) イベントオブジェクトに返します。 @@ -38,9 +38,9 @@ End if - まず 4D は、フォーム中のオブジェクトをブラウズし、発生したオブジェクトイベントがプロパティで選択されているすべてのオブジェクトのオブジェクトメソッドを呼び出します。 - 次に、発生したイベントに対応するフォームイベントがフォームのプロパティで選択されていれば、フォームメソッドを呼び出します。 -オブジェクトメソッドが特定の順序で呼び出されることを期待することはできません。 おおまかに言って、オブジェクトメソッドは常にフォームメソッドよりも前に呼び出されます。 オブジェクトがサブフォームの場合、サブフォームのリストフォームのオブジェクトメソッドが呼び出され、次にリストフォームのフォームメソッドが呼び出されます。 そして 4D は引き続き、親フォームのオブジェクトメソッドを呼び出します。 つまり、オブジェクトがサブフォームの時、 4D はサブフォームオブジェクト内で、オブジェクトとフォームメソッドと同じルールを適用します。 +オブジェクトメソッドが特定の順序で呼び出されることを期待することはできません。おおまかに言って、オブジェクトメソッドは常にフォームメソッドよりも前に呼び出されます。オブジェクトがサブフォームの場合、サブフォームのリストフォームのオブジェクトメソッドが呼び出され、次にリストフォームのフォームメソッドが呼び出されます。そして 4D は引き続き、親フォームのオブジェクトメソッドを呼び出します。つまり、オブジェクトがサブフォームの時、 4D はサブフォームオブジェクト内で、オブジェクトとフォームメソッドと同じルールを適用します。 -[On Load](onLoad.md) と [On Unload](onUnload.md) イベントを除き(後述参照)、発生したイベントがフォームイベントプロパティで選択されていなかったとしても、オブジェクトプロパティで選択されていれば、そのオブジェクトメソッドの呼び出しが妨げられることはありません。 言い換えれば、フォームレベルでイベントを有効あるいは無効にしても、オブジェクトイベントプロパティには影響ありません。 +[On Load](onLoad.md) と [On Unload](onUnload.md) イベントを除き(後述参照)、発生したイベントがフォームイベントプロパティで選択されていなかったとしても、オブジェクトプロパティで選択されていれば、そのオブジェクトメソッドの呼び出しが妨げられることはありません。言い換えれば、フォームレベルでイベントを有効あるいは無効にしても、オブジェクトイベントプロパティには影響ありません。 特定のイベントに関連するオブジェクトの数は、イベントの性質により異なります。 @@ -48,71 +48,71 @@ End if 以下の表は、それぞれのイベントごとにどのようにオブジェクトメソッドとフォームメソッドが呼ばれるかを概説します: -| イベント | オブジェクトメソッド | フォームメソッド | 対象オブジェクト | -| ------------------------ | ----------------------------------------------- | -------- | ------------ | -| On Load | ◯ | ◯ | すべてのオブジェクト | -| On Unload | ◯ | ◯ | すべてのオブジェクト | -| On Validate | ◯ | ◯ | すべてのオブジェクト | -| On Clicked | ◯ | ◯ | 関係するオブジェクトのみ | -| On Double Clicked | ◯ | ◯ | 関係するオブジェクトのみ | -| On Before Keystroke | ◯ | ◯ | 関係するオブジェクトのみ | -| On After Keystroke | ◯ | ◯ | 関係するオブジェクトのみ | -| On After Edit | ◯ | ◯ | 関係するオブジェクトのみ | -| On Getting Focus | ◯ | ◯ | 関係するオブジェクトのみ | -| On Losing Focus | ◯ | ◯ | 関係するオブジェクトのみ | -| On Activate | X | ◯ | なし | -| On Deactivate | X | ◯ | なし | -| On Outside Call | X | ◯ | なし | -| On Page Change | X | ◯ | なし | -| On Begin Drag Over | ◯ | ◯ | 関係するオブジェクトのみ | -| On Drop | ◯ | ◯ | 関係するオブジェクトのみ | -| On Drag Over | ◯ | X | 関係するオブジェクトのみ | -| On Mouse Enter | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Move | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Leave | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Up | ◯ | X | 関係するオブジェクトのみ | -| On Menu Selected | X | ◯ | なし | -| On Bound variable change | X | ◯ | なし | -| On Data Change | ◯ | ◯ | 関係するオブジェクトのみ | -| On Plug in Area | ◯ | ◯ | 関係するオブジェクトのみ | -| On Header | ◯ | ◯ | すべてのオブジェクト | -| On Printing Detail | ◯ | ◯ | すべてのオブジェクト | -| On Printing Break | ◯ | ◯ | すべてのオブジェクト | -| On Printing Footer | ◯ | ◯ | すべてのオブジェクト | -| On Close Box | X | ◯ | なし | -| On Display Detail | ◯ | ◯ | すべてのオブジェクト | -| On Open Detail | ◯ (リストボックス) | ◯ | リストボックスのみ | -| On Close Detail | ◯ (リストボックス) | ◯ | リストボックスのみ | -| On Resize | X | ◯ | なし | -| On Selection Change | ◯ | ◯ | 関係するオブジェクトのみ | -| On Load Record | X | ◯ | なし | -| On Timer | X | ◯ | なし | -| On Scroll | ◯ | X | 関係するオブジェクトのみ | -| On Before Data Entry | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Column Moved | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Row Moved | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Column Resize | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Header Click | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Footer Click | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On After Sort | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Long Click | ◯ (ボタン) | ◯ | 関係するオブジェクトのみ | -| On Alternative Click | ◯ (ボタンとリストボックス) | X | 関係するオブジェクトのみ | -| On Expand | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On Collapse | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On Delete Action | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On URL Resource Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Begin URL Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On URL Loading Error | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On URL Filtering | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On End URL Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Open External Link | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Window Opening Denied | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On VP Range Changed | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On VP Ready | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Row Resize | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | - -イベントに対応するプロパティが選択されている場合にのみ、フォームやオブジェクトのメソッドが呼び出されることに留意してください。 デザインモードのフォームエディターのプロパティリストでイベントを無効にすると、メソッドが呼び出される回数を減らすことができ、フォームの実行速度を最適化できます。 - -> 警告: オブジェクトの [On Load](onLoad.md) と [On Unload](onUnload.md) イベントが生成されるには、オブジェクトとオブジェクトが属するフォーム の両方で有効にされていなければなりません。 オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 +| イベント | コード | オブジェクトメソッド | フォームメソッド | 対象オブジェクト | +| ------------------------ | --- | ----------------------------------------------- | -------- | ------------ | +| On Activate | 11 | X | ◯ | なし | +| On After Edit | 45 | ◯ | ◯ | 関係するオブジェクトのみ | +| On After Keystroke | 28 | ◯ | ◯ | 関係するオブジェクトのみ | +| On After Sort | 30 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Alternative Click | 38 | ◯ (ボタンとリストボックス) | X | 関係するオブジェクトのみ | +| On Before Data Entry | 41 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Before Keystroke | 17 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Begin Drag Over | 46 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Begin URL Loading | 47 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Bound variable change | 54 | X | ◯ | なし | +| On Clicked | 4 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Close Box | 22 | X | ◯ | なし | +| On Close Detail | 26 | ◯ (リストボックス) | ◯ | リストボックスのみ | +| On Collapse | 44 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Column Moved | 32 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Column Resize | 33 | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Data Change | 20 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Deactivate | 12 | X | ◯ | なし | +| On Delete Action | 58 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Display Detail | 8 | ◯ | ◯ | すべてのオブジェクト | +| On Double Clicked | 13 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Drag Over | 21 | ◯ | X | 関係するオブジェクトのみ | +| On Drop | 16 | ◯ | ◯ | 関係するオブジェクトのみ | +| On End URL Loading | 49 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Expand | 43 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Footer Click | 57 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Getting Focus | 15 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Header | 5 | ◯ | ◯ | すべてのオブジェクト | +| On Header Click | 42 | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Load | 1 | ◯ | ◯ | すべてのオブジェクト | +| On Load Record | 40 | X | ◯ | なし | +| On Long Click | 39 | ◯ (ボタン) | ◯ | 関係するオブジェクトのみ | +| On Losing Focus | 14 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Menu Selected | 18 | X | ◯ | なし | +| On Mouse Enter | 35 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Leave | 36 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Move | 37 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Up | 2 | ◯ | X | 関係するオブジェクトのみ | +| On Open Detail | 25 | ◯ (リストボックス) | ◯ | リストボックスのみ | +| On Open External Link | 52 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Outside Call | 10 | X | ◯ | なし | +| On Page Change | 56 | X | ◯ | なし | +| On Plug in Area | 19 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Printing Break | 6 | ◯ | ◯ | すべてのオブジェクト | +| On Printing Detail | 23 | ◯ | ◯ | すべてのオブジェクト | +| On Printing Footer | 7 | ◯ | ◯ | すべてのオブジェクト | +| On Resize | 29 | X | ◯ | なし | +| On Row Moved | 34 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Row Resize | 60 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Scroll | 59 | ◯ | X | 関係するオブジェクトのみ | +| On Selection Change | 31 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Timer | 27 | X | ◯ | なし | +| On Unload | 24 | ◯ | ◯ | すべてのオブジェクト | +| On URL Filtering | 51 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On URL Loading Error | 50 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On URL Resource Loading | 48 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Validate | 3 | ◯ | ◯ | すべてのオブジェクト | +| On VP Range Changed | 61 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On VP Ready | 9 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Window Opening Denied | 53 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | + +イベントに対応するプロパティが選択されている場合にのみ、フォームやオブジェクトのメソッドが呼び出されることに留意してください。デザインモードのフォームエディターのプロパティリストでイベントを無効にすると、メソッドが呼び出される回数を減らすことができ、フォームの実行速度を最適化できます。 + +> 警告: オブジェクトの [On Load](onLoad.md) と [On Unload](onUnload.md) イベントが生成されるには、オブジェクトとオブジェクトが属するフォーム の両方で有効にされていなければなりません。オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md index 0ccfde243239af..49155d8c3d0a14 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md @@ -49,7 +49,7 @@ displayed_sidebar: docs | プロパティ | 型 | 説明 | | ----------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Deflate圧縮 (デフォルト)
  • `ZIP Compression LZMA`: LZMA圧縮
  • `ZIP Compression XZ`: XZ圧縮
  • `ZIP Compression none`: 圧縮なし
    • | -| level | Integer | 圧縮レベル。 とりうる値: 1 - 10。 低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。 ただし、圧縮レベルはパフォーマンスに影響します。 デフォルト値 (省略時):
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | +| level | Integer | 圧縮レベル。 とりうる値: 1 - 10。 低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。 ただし、圧縮レベルはパフォーマンスに影響します。 デフォルト値 (省略時):
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | | encryption | Integer | パスワードが設定されていた場合に使用する暗号化方法:
  • `ZIP Encryption AES128`: 128-bit キーを使った AES による暗号化
  • `ZIP Encryption AES192`: 192-bit キーを使った AES による暗号化
  • `ZIP Encryption AES256`: 256-bit キーを使った AES による暗号化 (パスワードが設定されている場合のデフォルト)
  • `ZIP Encryption none`: 暗号化なし (パスワードが設定されてない場合のデフォルト)
    • | | password | Text | 暗号化が必要な場合に使用するパスワード | | files | Collection |
  • `4D.File` または` 4D.Folder` オブジェクトのコレクション
  • 以下のプロパティを持ったオブジェクトのコレクション:
    • プロパティタイプ説明
    source4D.File または 4D.FolderFile または Folder
    destinationText(任意) - アーカイブのコンテンツ構成を変更するための相対ファイルパス
    optionnumber(任意) - `ZIP Ignore invisible files` で非表示ファイルを無視、0 を渡すと全ファイルを圧縮
    | @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## 参照 -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## プロパティ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md index c6d2ea5562f2b0..33d4b26916d8d2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ root フォルダーから取り出します: ## 参照 -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## プロパティ diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/Events/overview.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/Events/overview.md index e2201a6cc321c6..b2f2cc3162d960 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/Events/overview.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/Events/overview.md @@ -3,9 +3,9 @@ id: overview title: フォームイベント --- -フォームイベントとは、フォームメソッドやフォームオブジェクトメソッドの実行につながるイベントのことです。 フォームイベントにより、アプリケーションの流れをコントロールしたり、特定のイベントが発生したときにのみ実行されるコードを書くことができます。 +フォームイベントとは、フォームメソッドやフォームオブジェクトメソッドの実行につながるイベントのことです。フォームイベントにより、アプリケーションの流れをコントロールしたり、特定のイベントが発生したときにのみ実行されるコードを書くことができます。 -コードの中では、トリガーされたイベントを返す [`FORM Event`](../commands/form-event.md) コマンドを使ってイベントを制御します。 例: 例: +コードの中では、トリガーされたイベントを返す [`FORM Event`](../commands/form-event) コマンドを使ってイベントを制御します。例: ```4d // ボタンのコード @@ -18,15 +18,15 @@ End if ## イベントオブジェクト -それぞれのイベントは、[`FORM Event`](../commands/form-event.md) コマンドによってオブジェクトとして返されます。 デフォルトで、以下のプロパティが含まれています: デフォルトで、以下のプロパティが含まれています: +それぞれのイベントは、[`FORM Event`](../commands/form-event) コマンドによってオブジェクトとして返されます。デフォルトで、以下のプロパティが含まれています: | プロパティ | 型 | 説明 | | ----------- | ------- | ----------------------------------------------------------------- | | objectName | text | イベントをトリガーしているオブジェクト名。フォームによってトリガーされている場合には含まれていません。 | -| code | longint | フォームイベントの数値。 フォームイベントの数値。 `Form event code` によっても返されます。 | +| code | longint | フォームイベントの数値。フォームイベントの数値。 `Form event code` によっても返されます。 | | description | text | フォームイベント名 (例: "On After Edit") | -イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。 特に: +イベントが発生したオブジェクトによっては追加のプロパティが含まれていることがあります。特に: - [リストボックス](FormObjects/listbox-object.md#supported-form-events) および [リストボックス列](FormObjects/listbox-column.md#supported-form-events) は、`columnName` や `isRowSelected` といった、[追加のプロパティ](FormObjects/listbox-object.md#supported-form-events) を返します。 - [4D View Pro エリア](FormObjects/viewProArea_overview.md) は、`sheetName` や `action` といったプロパティを [On After Edit](onAfterEdit.md) イベントオブジェクトに返します。 @@ -38,9 +38,9 @@ End if - まず 4D は、フォーム中のオブジェクトをブラウズし、発生したオブジェクトイベントがプロパティで選択されているすべてのオブジェクトのオブジェクトメソッドを呼び出します。 - 次に、発生したイベントに対応するフォームイベントがフォームのプロパティで選択されていれば、フォームメソッドを呼び出します。 -オブジェクトメソッドが特定の順序で呼び出されることを期待することはできません。 おおまかに言って、オブジェクトメソッドは常にフォームメソッドよりも前に呼び出されます。 オブジェクトがサブフォームの場合、サブフォームのリストフォームのオブジェクトメソッドが呼び出され、次にリストフォームのフォームメソッドが呼び出されます。 そして 4D は引き続き、親フォームのオブジェクトメソッドを呼び出します。 つまり、オブジェクトがサブフォームの時、 4D はサブフォームオブジェクト内で、オブジェクトとフォームメソッドと同じルールを適用します。 +オブジェクトメソッドが特定の順序で呼び出されることを期待することはできません。おおまかに言って、オブジェクトメソッドは常にフォームメソッドよりも前に呼び出されます。オブジェクトがサブフォームの場合、サブフォームのリストフォームのオブジェクトメソッドが呼び出され、次にリストフォームのフォームメソッドが呼び出されます。そして 4D は引き続き、親フォームのオブジェクトメソッドを呼び出します。つまり、オブジェクトがサブフォームの時、 4D はサブフォームオブジェクト内で、オブジェクトとフォームメソッドと同じルールを適用します。 -[On Load](onLoad.md) と [On Unload](onUnload.md) イベントを除き(後述参照)、発生したイベントがフォームイベントプロパティで選択されていなかったとしても、オブジェクトプロパティで選択されていれば、そのオブジェクトメソッドの呼び出しが妨げられることはありません。 言い換えれば、フォームレベルでイベントを有効あるいは無効にしても、オブジェクトイベントプロパティには影響ありません。 +[On Load](onLoad.md) と [On Unload](onUnload.md) イベントを除き(後述参照)、発生したイベントがフォームイベントプロパティで選択されていなかったとしても、オブジェクトプロパティで選択されていれば、そのオブジェクトメソッドの呼び出しが妨げられることはありません。言い換えれば、フォームレベルでイベントを有効あるいは無効にしても、オブジェクトイベントプロパティには影響ありません。 特定のイベントに関連するオブジェクトの数は、イベントの性質により異なります。 @@ -48,70 +48,71 @@ End if 以下の表は、それぞれのイベントごとにどのようにオブジェクトメソッドとフォームメソッドが呼ばれるかを概説します: -| イベント | オブジェクトメソッド | フォームメソッド | 対象オブジェクト | -| ------------------------ | ----------------------------------------------- | -------- | ------------ | -| On Load | ◯ | ◯ | すべてのオブジェクト | -| On Unload | ◯ | ◯ | すべてのオブジェクト | -| On Validate | ◯ | ◯ | すべてのオブジェクト | -| On Clicked | ◯ | ◯ | 関係するオブジェクトのみ | -| On Double Clicked | ◯ | ◯ | 関係するオブジェクトのみ | -| On Before Keystroke | ◯ | ◯ | 関係するオブジェクトのみ | -| On After Keystroke | ◯ | ◯ | 関係するオブジェクトのみ | -| On After Edit | ◯ | ◯ | 関係するオブジェクトのみ | -| On Getting Focus | ◯ | ◯ | 関係するオブジェクトのみ | -| On Losing Focus | ◯ | ◯ | 関係するオブジェクトのみ | -| On Activate | X | ◯ | なし | -| On Deactivate | X | ◯ | なし | -| On Outside Call | X | ◯ | なし | -| On Page Change | X | ◯ | なし | -| On Begin Drag Over | ◯ | ◯ | 関係するオブジェクトのみ | -| On Drop | ◯ | ◯ | 関係するオブジェクトのみ | -| On Drag Over | ◯ | X | 関係するオブジェクトのみ | -| On Mouse Enter | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Move | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Leave | ◯ | ◯ | すべてのオブジェクト | -| On Mouse Up | ◯ | X | 関係するオブジェクトのみ | -| On Menu Selected | X | ◯ | なし | -| On Bound variable change | X | ◯ | なし | -| On Data Change | ◯ | ◯ | 関係するオブジェクトのみ | -| On Plug in Area | ◯ | ◯ | 関係するオブジェクトのみ | -| On Header | ◯ | ◯ | すべてのオブジェクト | -| On Printing Detail | ◯ | ◯ | すべてのオブジェクト | -| On Printing Break | ◯ | ◯ | すべてのオブジェクト | -| On Printing Footer | ◯ | ◯ | すべてのオブジェクト | -| On Close Box | X | ◯ | なし | -| On Display Detail | ◯ | ◯ | すべてのオブジェクト | -| On Open Detail | ◯ (リストボックス) | ◯ | リストボックスのみ | -| On Close Detail | ◯ (リストボックス) | ◯ | リストボックスのみ | -| On Resize | X | ◯ | なし | -| On Selection Change | ◯ | ◯ | 関係するオブジェクトのみ | -| On Load Record | X | ◯ | なし | -| On Timer | X | ◯ | なし | -| On Scroll | ◯ | X | 関係するオブジェクトのみ | -| On Before Data Entry | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Column Moved | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Row Moved | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Column Resize | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Header Click | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Footer Click | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On After Sort | ◯ (リストボックス) | X | 関係するオブジェクトのみ | -| On Long Click | ◯ (ボタン) | ◯ | 関係するオブジェクトのみ | -| On Alternative Click | ◯ (ボタンとリストボックス) | X | 関係するオブジェクトのみ | -| On Expand | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On Collapse | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On Delete Action | ◯ (階層 リストとリストボックス) | X | 関係するオブジェクトのみ | -| On URL Resource Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Begin URL Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On URL Loading Error | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On URL Filtering | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On End URL Loading | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Open External Link | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On Window Opening Denied | ◯ (Webエリア) | X | 関係するオブジェクトのみ | -| On VP Range Changed | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On VP Ready | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | -| On Row Resize | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | - -イベントに対応するプロパティが選択されている場合にのみ、フォームやオブジェクトのメソッドが呼び出されることに留意してください。 デザインモードのフォームエディターのプロパティリストでイベントを無効にすると、メソッドが呼び出される回数を減らすことができ、フォームの実行速度を最適化できます。 - -> 警告: オブジェクトの [On Load](onLoad.md) と [On Unload](onUnload.md) イベントが生成されるには、オブジェクトとオブジェクトが属するフォーム の両方で有効にされていなければなりません。 オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 +| イベント | コード | オブジェクトメソッド | フォームメソッド | 対象オブジェクト | +| ------------------------ | --- | ----------------------------------------------- | -------- | ------------ | +| On Activate | 11 | X | ◯ | なし | +| On After Edit | 45 | ◯ | ◯ | 関係するオブジェクトのみ | +| On After Keystroke | 28 | ◯ | ◯ | 関係するオブジェクトのみ | +| On After Sort | 30 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Alternative Click | 38 | ◯ (ボタンとリストボックス) | X | 関係するオブジェクトのみ | +| On Before Data Entry | 41 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Before Keystroke | 17 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Begin Drag Over | 46 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Begin URL Loading | 47 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Bound variable change | 54 | X | ◯ | なし | +| On Clicked | 4 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Close Box | 22 | X | ◯ | なし | +| On Close Detail | 26 | ◯ (リストボックス) | ◯ | リストボックスのみ | +| On Collapse | 44 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Column Moved | 32 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Column Resize | 33 | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Data Change | 20 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Deactivate | 12 | X | ◯ | なし | +| On Delete Action | 58 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Display Detail | 8 | ◯ | ◯ | すべてのオブジェクト | +| On Double Clicked | 13 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Drag Over | 21 | ◯ | X | 関係するオブジェクトのみ | +| On Drop | 16 | ◯ | ◯ | 関係するオブジェクトのみ | +| On End URL Loading | 49 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Expand | 43 | ◯ (階層リストとリストボックス) | X | 関係するオブジェクトのみ | +| On Footer Click | 57 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Getting Focus | 15 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Header | 5 | ◯ | ◯ | すべてのオブジェクト | +| On Header Click | 42 | ◯ (リストボックスと 4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Load | 1 | ◯ | ◯ | すべてのオブジェクト | +| On Load Record | 40 | X | ◯ | なし | +| On Long Click | 39 | ◯ (ボタン) | ◯ | 関係するオブジェクトのみ | +| On Losing Focus | 14 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Menu Selected | 18 | X | ◯ | なし | +| On Mouse Enter | 35 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Leave | 36 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Move | 37 | ◯ | ◯ | すべてのオブジェクト | +| On Mouse Up | 2 | ◯ | X | 関係するオブジェクトのみ | +| On Open Detail | 25 | ◯ (リストボックス) | ◯ | リストボックスのみ | +| On Open External Link | 52 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Outside Call | 10 | X | ◯ | なし | +| On Page Change | 56 | X | ◯ | なし | +| On Plug in Area | 19 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Printing Break | 6 | ◯ | ◯ | すべてのオブジェクト | +| On Printing Detail | 23 | ◯ | ◯ | すべてのオブジェクト | +| On Printing Footer | 7 | ◯ | ◯ | すべてのオブジェクト | +| On Resize | 29 | X | ◯ | なし | +| On Row Moved | 34 | ◯ (リストボックス) | X | 関係するオブジェクトのみ | +| On Row Resize | 60 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Scroll | 59 | ◯ | X | 関係するオブジェクトのみ | +| On Selection Change | 31 | ◯ | ◯ | 関係するオブジェクトのみ | +| On Timer | 27 | X | ◯ | なし | +| On Unload | 24 | ◯ | ◯ | すべてのオブジェクト | +| On URL Filtering | 51 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On URL Loading Error | 50 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On URL Resource Loading | 48 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | +| On Validate | 3 | ◯ | ◯ | すべてのオブジェクト | +| On VP Range Changed | 61 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On VP Ready | 9 | ◯ (4D View Pro エリア) | X | 関係するオブジェクトのみ | +| On Window Opening Denied | 53 | ◯ (Webエリア) | X | 関係するオブジェクトのみ | + +イベントに対応するプロパティが選択されている場合にのみ、フォームやオブジェクトのメソッドが呼び出されることに留意してください。デザインモードのフォームエディターのプロパティリストでイベントを無効にすると、メソッドが呼び出される回数を減らすことができ、フォームの実行速度を最適化できます。 + +> 警告: オブジェクトの [On Load](onLoad.md) と [On Unload](onUnload.md) イベントが生成されるには、オブジェクトとオブジェクトが属するフォーム の両方で有効にされていなければなりません。オブジェクトのみでイベントが有効になっている場合、イベントは生成されません。 これら 2つのイベントはフォームレベルでも有効にされていなければなりません。 + diff --git a/i18n/ja/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md b/i18n/ja/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md index 937a4d82169bbc..036df3f08e0ba0 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md +++ b/i18n/ja/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md @@ -41,20 +41,20 @@ displayed_sidebar: docs - *fileToZip*: 圧縮する `4D.File` オブジェクトを引数として渡します。 -- *folderToZip*: 圧縮する `4D.Folder` を渡します。 この場合、任意の *options* 引数を渡して、フォルダーのコンテンツのみを圧縮 (つまり、外側のフォルダーを除外) することができます。 `ZIP Create archive` はデフォルトで、フォルダーとその中身を圧縮するので、展開処理をしたときにはフォルダーを再作成します。 フォルダーの中身のみを解凍処理で復元するには、*options* 引数に `ZIP Without enclosing folder` 定数を渡します。 この場合、任意の *options* 引数を渡して、フォルダーのコンテンツのみを圧縮 (つまり、外側のフォルダーを除外) することができます。 `ZIP Create archive` はデフォルトで、フォルダーとその中身を圧縮するので、展開処理をしたときにはフォルダーを再作成します。 フォルダーの中身のみを解凍処理で復元するには、*options* 引数に `ZIP Without enclosing folder` 定数を渡します。 +- *folderToZip*: 圧縮する `4D.Folder` を渡します。 この場合、任意の *options* 引数を渡して、フォルダーのコンテンツのみを圧縮 (つまり、外側のフォルダを除外) することができます。 `ZIP Create archive` はデフォルトで、フォルダーとその中身を圧縮するので、展開処理をしたときにはフォルダーを再作成します。 フォルダーの中身のみを解凍処理で復元するには、*options* 引数に `ZIP Without enclosing folder` 定数を渡します。この場合、任意の *options* 引数を渡して、フォルダーのコンテンツのみを圧縮 (つまり、外側のフォルダを除外) することができます。 `ZIP Create archive` はデフォルトで、フォルダーとその中身を圧縮するので、展開処理をしたときにはフォルダーを再作成します。フォルダーの中身のみを解凍処理で復元するには、*options* 引数に `ZIP Without enclosing folder` 定数を渡します。 - *zipStructure*: ZIPArchive オブジェクトを表すオブジェクトを引数として渡します。 以下のプロパティを利用して、このオブジェクトを定義することが可能です: 以下のプロパティを利用して、このオブジェクトを定義することが可能です: -| プロパティ | 型 | 説明 | -| ----------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| compression | Integer |
  • `ZIP Compression standard`: Deflate圧縮 (デフォルト)
  • `ZIP Compression LZMA`: LZMA圧縮
  • `ZIP Compression XZ`: XZ圧縮
  • `ZIP Compression none`: 圧縮なし
    • | -| level | Integer | 圧縮レベル。 とりうる値: 1 - 10。 低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。 ただし、圧縮レベルはパフォーマンスに影響します。 デフォルト値 (省略時):
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | パスワードが設定されていた場合に使用する暗号化方法:
  • `ZIP Encryption AES128`: 128-bit キーを使用したAES 暗号化。
  • `ZIP Encryption AES192`: 192-bit キーを使った AES による暗号化。
  • `ZIP Encryption AES256`: AES encryption using 256-bit キーを使用したAES 暗号化 (パスワードが設定されていた場合のデフォルト)。
  • `ZIP Encryption none`: 暗号化なし(パスワードが設定されていない場合のデフォルト)
  • `ZIP Encryption AES192`: 192-bit キーを使った AES による暗号化。
  • `ZIP Encryption AES256`: AES encryption using 256-bit キーを使用したAES 暗号化 (パスワードが設定されていた場合のデフォルト)。
  • `ZIP Encryption none`: 暗号化なし(パスワードが設定されていない場合のデフォルト)
    • | -| password | Text | 暗号化が必要な場合に使用するパスワード | -| files | Collection |
  • `4D.File` または` 4D.Folder` オブジェクトのコレクション
  • 以下のプロパティを持ったオブジェクトのコレクション:
    • プロパティタイプ説明
    source4D.File または 4D.FolderFile または Folder
    destinationText(任意) - アーカイブのコンテンツ構成を変更するための相対ファイルパス
    optionnumber(任意) - `ZIP Ignore invisible files` で非表示ファイルを無視、0 を渡すと全ファイルを圧縮
    | -| callback | 4D.Function | $1 に圧縮の進捗 (0 - 100) を受け取るコールバックフォーミュラ | +| プロパティ | 型 | 説明 | +| ----------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| compression | Integer |
  • `ZIP Compression standard`: Deflate圧縮 (デフォルト)
  • `ZIP Compression LZMA`: LZMA圧縮
  • `ZIP Compression XZ`: XZ圧縮
  • `ZIP Compression none`: 圧縮なし
    • | +| level | Integer | 圧縮レベル。とりうる値: 1 - 10。低い値ではファイルが大きくなり、高い値ではファイルが小さくなります。ただし、圧縮レベルはパフォーマンスに影響します。 Default values if omitted:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +| encryption | Integer | The encryption to use if a password is set:
    • `ZIP Encryption AES128`: AES encryption using 128-bit key.
    • `ZIP Encryption AES192`: 192-bit キーを使った AES による暗号化。
    • `ZIP Encryption AES256`: AES encryption using 256-bit キーを使用したAES 暗号化 (パスワードが設定されていた場合のデフォルト)。
    • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    | +| password | Text | 暗号化が必要な場合に使用するパスワード | +| files | Collection |
  • `4D.File` または` 4D.Folder` オブジェクトのコレクション
  • 以下のプロパティを持ったオブジェクトのコレクション:
    • プロパティタイプ説明
    source4D.File または 4D.FolderFile または Folder
    destinationText(任意) - アーカイブのコンテンツ構成を変更するための相対ファイルパス
    optionnumber(任意) - `ZIP Ignore invisible files` で非表示ファイルを無視、0 を渡すと全ファイルを圧縮
    | +| callback | 4D.Function | $1 に圧縮の進捗 (0 - 100) を受け取るコールバックフォーミュラ | -*destinationFile* には、作成する ZIPアーカイブ (名前や位置など) を記述する `4D.File` オブジェクトを渡します。 作成した ZIPアーカイブがあらゆるソフトウェアで自動的に処理されるようにするため、".zip" 拡張子の使用が推奨されます。 作成した ZIPアーカイブがあらゆるソフトウェアで自動的に処理されるようにするため、".zip" 拡張子の使用が推奨されます。 +*destinationFile* には、作成する ZIPアーカイブ (名前や位置など) を記述する `4D.File` オブジェクトを渡します。 作成した ZIPアーカイブがあらゆるソフトウェアで自動的に処理されるようにするため、".zip" 拡張子の使用が推奨されます。作成した ZIPアーカイブがあらゆるソフトウェアで自動的に処理されるようにするため、".zip" 拡張子の使用が推奨されます。 アーカイブが作成されると、[ZIP Read archive](zip-read-archive.md) を使用してアクセスすることができます。 diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Admin/data-collect.md b/i18n/pt/docusaurus-plugin-content-docs/current/Admin/data-collect.md index c8102a29d60c1d..697b41ebe723f4 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Admin/data-collect.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Admin/data-collect.md @@ -37,10 +37,12 @@ Alguns dados são também recolhidos a intervalos regulares. | cacheReadCount | Object | Número de leituras na cache | | classUsage | Object | Number of instances of certain language classes | | connectionSystems | Collection | SO do cliente sem o número de compilação (entre parêntesis) e número de clientes que o utilizam | +| databases[].backupSettings | Object | Current backup settings values | | databases[].cacheSize | Number | Tamanho da cache em bytes | | databases[].compatibilitySettings | Object | Enabled Compatibility settings | | databases[].externalDatastoreOpened | Number | Número de chamadas para 'Open datastore' | | databases[].fluentUI | Parâmetros | True if Use Fluent UI on Windows setting is checked | +| databases[].flushCacheInterval | Number | Defined time period between each automatic saving of the data cache | | databases[].id | Number | Database ID | | databases[].internalDatastoreOpened | Number | Número de vezes que o armazenamento de dados é aberto por um servidor externo | | databases[].maxConcurrent4DClients | Number | Maximum number of simultaneous 4D Client sessions (using a 4D Client license) over the collection interval | @@ -52,6 +54,7 @@ Alguns dados são também recolhidos a intervalos regulares. | databases[].numberOfKeepRecordSyncInfo | Number | Number of tables with the "Enable Replication" option checked | | databases[].numberOfRecordsMax | Number | Total number of records | | databases[].numberOfTables | Number | Number of tables | +| databases[].numberOfUncaughtExecutionErrors | Number | Number of times an execution error is displayed as an alert | | databases[].qodly.webforms | Number | Número de formulários web Qodly | | databases[].remoteDebugger4DRemoteAttachments | Number | Número de anexos ao depurador remoto de um 4D remoto | | databases[].remoteDebuggerQodlyAttachments | Number | Número de anexos ao depurador remoto da Qodly | @@ -92,6 +95,7 @@ Alguns dados são também recolhidos a intervalos regulares. | isEncrypted | Parâmetros | True se o arquivo de dados estiver criptografado | | isEngined | Parâmetros | Verdadeiro se a aplicação for fundida com o Volume Desktop 4D | | isProjectMode | Parâmetros | Verdadeiro se a aplicação for compilada | +| isShadowCopyActivated | Parâmetros | True if the Volume Shadow Copy feature is enabled (Windows only | | LDAPLogin | Number | Number of calls to `LDAP LOGIN` | | license.sffPrimaryKey | Number | Server master product number | | machine.CPU | Text | Nome, tipo, e velocidade do processador | @@ -102,6 +106,7 @@ Alguns dados são também recolhidos a intervalos regulares. | maximumUsedPhysicalMemory | Number | Utilização máxima da memória física | | maximumUsedVirtualMemory | Number | Utilização máxima da memória virtual | | mobile | Collection | Informação sobre sessões móveis | +| numberOfCrashes | Number | Number of times 4D has crashed | | numberOfWebServices | Number | Number of methods published as Web Services | | ODBCLogin | Number | Number of calls to `SQL LOGIN` using ODBC | | phpCall | Number | Número de chamadas para 'PHP execute' | diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/Events/overview.md b/i18n/pt/docusaurus-plugin-content-docs/current/Events/overview.md index 68b21918066c1b..e8b05062d823bd 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/Events/overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/Events/overview.md @@ -46,68 +46,68 @@ O número de objetos envolvidos em um evento depende da natureza do evento. A tabela seguinte resume a forma como os métodos objeto e formulário são chamados para cada tipo de evento: -| Evento | Métodos objecto | Método formulário | Que objectos | -| ------------------------ | --------------------------------------------------------------- | ----------------- | -------------------------- | -| On Load | Sim | Sim | Todos os objectos | -| On Unload | Sim | Sim | Todos os objectos | -| On Validate | Sim | Sim | Todos os objectos | -| On Clicked | Sim | Sim | Apenas objecto envolvido | -| On Double Clicked | Sim | Sim | Apenas objecto envolvido | -| On Before Keystroke | Sim | Sim | Apenas objecto envolvido | -| On After Keystroke | Sim | Sim | Apenas objecto envolvido | -| On After Edit | Sim | Sim | Apenas objecto envolvido | -| On Getting Focus | Sim | Sim | Apenas objecto envolvido | -| On Losing Focus | Sim | Sim | Apenas objecto envolvido | -| On Activate | Nunca | Sim | Nenhum | -| On Deactivate | Nunca | Sim | Nenhum | -| On Outside Call | Nunca | Sim | Nenhum | -| On Page Change | Nunca | Sim | Nenhum | -| On Begin Drag Over | Sim | Sim | Apenas objecto envolvido | -| On Drop | Sim | Sim | Apenas objecto envolvido | -| On Drag Over | Sim | Nunca | Apenas objecto envolvido | -| On Mouse Enter | Sim | Sim | Todos os objectos | -| On Mouse Move | Sim | Sim | Todos os objectos | -| On Mouse Leave | Sim | Sim | Todos os objectos | -| On Mouse Up | Sim | Nunca | Apenas objecto envolvido | -| On Menu Selected | Nunca | Sim | Nenhum | -| On Bound variable change | Nunca | Sim | Nenhum | -| On Data Change | Sim | Sim | Apenas objecto envolvido | -| On Plug in Area | Sim | Sim | Apenas objecto envolvido | -| On Header | Sim | Sim | Todos os objectos | -| On Printing Detail | Sim | Sim | Todos os objectos | -| On Printing Break | Sim | Sim | Todos os objectos | -| On Printing Footer | Sim | Sim | Todos os objectos | -| On Close Box | Nunca | Sim | Nenhum | -| On Display Detail | Sim | Sim | Todos os objectos | -| On Open Detail | Sim (List box) | Sim | Nenhum, excepto List boxes | -| On Close Detail | Sim (List box) | Sim | Nenhum, excepto List boxes | -| On Resize | Nunca | Sim | Nenhum | -| On Selection Change | Sim | Sim | Apenas objecto envolvido | -| On Load Record | Nunca | Sim | Nenhum | -| On Timer | Nunca | Sim | Nenhum | -| On Scroll | Sim | Nunca | Apenas objecto envolvido | -| On Before Data Entry | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Column Moved | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Row Moved | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Column Resize | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Header Click | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Footer Click | Sim (List box) | Nunca | Apenas objecto envolvido | -| On After Sort | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Long Click | Sim (Botão) | Sim | Apenas objecto envolvido | -| On Alternative Click | Sim (botão e List box) | Nunca | Apenas objecto envolvido | -| On Expand | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On Collapse | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On Delete Action | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On URL Resource Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Begin URL Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On URL Loading Error | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On URL Filtering | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On End URL Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Open External Link | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Window Opening Denied | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On VP Range Changed | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | -| On VP Ready | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Row Resize | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| Evento | Code | Métodos objecto | Método formulário | Que objectos | +| ------------------------ | ---- | --------------------------------------------------------------- | ----------------- | -------------------------- | +| On Activate | 11 | Nunca | Sim | Nenhum | +| On After Edit | 45 | Sim | Sim | Apenas objecto envolvido | +| On After Keystroke | 28 | Sim | Sim | Apenas objecto envolvido | +| On After Sort | 30 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Alternative Click | 38 | Sim (botão e List box) | Nunca | Apenas objecto envolvido | +| On Before Data Entry | 41 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Before Keystroke | 17 | Sim | Sim | Apenas objecto envolvido | +| On Begin Drag Over | 46 | Sim | Sim | Apenas objecto envolvido | +| On Begin URL Loading | 47 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Bound variable change | 54 | Nunca | Sim | Nenhum | +| On Clicked | 4 | Sim | Sim | Apenas objecto envolvido | +| On Close Box | 22 | Nunca | Sim | Nenhum | +| On Close Detail | 26 | Sim (List box) | Sim | Nenhum, excepto List boxes | +| On Collapse | 44 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Column Moved | 32 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Column Resize | 33 | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Data Change | 20 | Sim | Sim | Apenas objecto envolvido | +| On Deactivate | 12 | Nunca | Sim | Nenhum | +| On Delete Action | 58 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Display Detail | 8 | Sim | Sim | Todos os objectos | +| On Double Clicked | 13 | Sim | Sim | Apenas objecto envolvido | +| On Drag Over | 21 | Sim | Nunca | Apenas objecto envolvido | +| On Drop | 16 | Sim | Sim | Apenas objecto envolvido | +| On End URL Loading | 49 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Expand | 43 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Footer Click | 57 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Getting Focus | 15 | Sim | Sim | Apenas objecto envolvido | +| On Header | 5 | Sim | Sim | Todos os objectos | +| On Header Click | 42 | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Load | 1 | Sim | Sim | Todos os objectos | +| On Load Record | 40 | Nunca | Sim | Nenhum | +| On Long Click | 39 | Sim (Botão) | Sim | Apenas objecto envolvido | +| On Losing Focus | 14 | Sim | Sim | Apenas objecto envolvido | +| On Menu Selected | 18 | Nunca | Sim | Nenhum | +| On Mouse Enter | 35 | Sim | Sim | Todos os objectos | +| On Mouse Leave | 36 | Sim | Sim | Todos os objectos | +| On Mouse Move | 37 | Sim | Sim | Todos os objectos | +| On Mouse Up | 2 | Sim | Nunca | Apenas objecto envolvido | +| On Open Detail | 25 | Sim (List box) | Sim | Nenhum, excepto List boxes | +| On Open External Link | 52 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Outside Call | 10 | Nunca | Sim | Nenhum | +| On Page Change | 56 | Nunca | Sim | Nenhum | +| On Plug in Area | 19 | Sim | Sim | Apenas objecto envolvido | +| On Printing Break | 6 | Sim | Sim | Todos os objectos | +| On Printing Detail | 23 | Sim | Sim | Todos os objectos | +| On Printing Footer | 7 | Sim | Sim | Todos os objectos | +| On Resize | 29 | Nunca | Sim | Nenhum | +| On Row Moved | 34 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Row Resize | 60 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Scroll | 59 | Sim | Nunca | Apenas objecto envolvido | +| On Selection Change | 31 | Sim | Sim | Apenas objecto envolvido | +| On Timer | 27 | Nunca | Sim | Nenhum | +| On Unload | 24 | Sim | Sim | Todos os objectos | +| On URL Filtering | 51 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On URL Loading Error | 50 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On URL Resource Loading | 48 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Validate | 3 | Sim | Sim | Todos os objectos | +| On VP Range Changed | 61 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On VP Ready | 9 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Window Opening Denied | 53 | Sim (Área Web) | Nunca | Apenas objecto envolvido | Lembre-se sempre de que, para qualquer evento, o método de um formulário ou de um objeto é chamado se a propriedade de evento correspondente estiver selecionada para o formulário ou para os objetos. A vantagem de desativar os eventos no ambiente Design (usando a Lista de propriedades do editor de formulários) é que você pode reduzir o número de chamadas para métodos e, portanto, otimizar significativamente a velocidade de execução dos formulários. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md b/i18n/pt/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md index 0d37c67e7b742b..3258d198e4e451 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-create-archive.md @@ -49,8 +49,8 @@ You can pass a 4D. File, a 4D. Folder, or a zip structure object as first parame | Propriedade | Tipo | Descrição | | ----------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Deflate compression (default)
  • `ZIP Compression LZMA`: LZMA compression
  • `ZIP Compression XZ`: XZ compression
  • `ZIP Compression none`: No compression
    • | -| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Default values if omitted:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Default values if omitted:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +| encryption | Integer | The encryption to use if a password is set:
    • `ZIP Encryption AES128`: AES encryption using 128-bit key.
    • `ZIP Encryption AES192`: AES encryption using 192-bit key.
    • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
    • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    | | senha | Text | Uma senha a usar se a criptografia for necessária. | | files | Collection |
  • a collection of `4D.File` or `4D.Folder` objects or
  • a collection of objects with the following properties:
    • PropertyTypeDescription
    source4D.File or 4D.FolderFile or Folder
    destinationText(optional) - Specify a relative filepath to change the organization of the contents of the archive
    optionnumber(optional) - `ZIP Ignore invisible files` or 0 to compress all of the file
    | | callback | 4D. Function | Uma fórmula de callback (retrochamada) que recebe o progresso da compactação (0-100) em $1. | @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## Veja também -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## Propriedades diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md b/i18n/pt/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md index 9a49a2556ca025..6f2091cb3ec3ad 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ Para ler todos os conteúdos de um arquivo sem extraí-lo da pasta root: ## Veja também -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## Propriedades diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md index a7fbb1201b2fc5..df153b238d27a9 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-19/API/ZipArchiveClass.md @@ -75,7 +75,7 @@ You can pass a 4D. File, a 4D. Folder, or a zip structure object as first parame | Propriedade | Tipo | Descrição | | ----------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Reduz a compactação (padrão)
  • `ZIP Compression LZMA`: compactação LZMA
  • `ZIP Compression XZ`: compactação XZ
  • `ZIP Compression none`: Sem compactação
    • | -| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Valores padrão se omitidos:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | +| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Valores padrão se omitidos:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | | encryption | Integer | A criptografia a usar se uma senha for estabelecida:
  • `ZIP Encryption AES128`: criptografia AES com uma chave de 128-bits.
  • `ZIP Encryption AES192`: criptografia AES com uma chave de 192-bits.
  • `ZIP Encryption AES256`: criptografia AES com chave de 256-bits (padrão se uma senha for estabelecida).
  • `ZIP Encryption none`: os dados não são criptografados (padrão se não estabelecer uma senha)
    • | | senha | Text | Uma senha a usar se a criptografia for necessária. | | files | Collection |
  • a collection of `4D. File` or `4D. Folder` objects or
  • uma coleção de objetos com as propriedades abaixo:
    • PropriedadeTipoDescrição
    source4D. File or 4D. FolderFile ou Folder
    destinationText(opcional) especifique uma rota de arquivo relativa para mudar a organização dos conteúdos do arquivo
    optionnumber(opcional) - 'ZIP ignore invisible files' ou 0 para compactar o arquivo inteiro
    | diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md b/i18n/pt/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md index 62f397d77c8772..45e2d318141e58 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20/API/ZipArchiveClass.md @@ -73,14 +73,14 @@ You can pass a 4D. File, a 4D. Folder, or a zip structure object as first parame - *zipStructure*: pode passar um objeto descrevendo o objeto ZIP archive. As propriedades abaixo estão disponíveis para definir a estrutura: -| Propriedade | Tipo | Descrição | -| ----------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| compression | Integer |
  • `ZIP Compression standard`: Reduz a compactação (padrão)
  • `ZIP Compression LZMA`: compactação LZMA
  • `ZIP Compression XZ`: compactação XZ
  • `ZIP Compression none`: Sem compactação
    • | -| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Valores padrão se omitidos:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | A criptografia a usar se uma senha for estabelecida:
  • `ZIP Encryption AES128`: criptografia AES com uma chave de 128-bits.
  • `ZIP Encryption AES192`: criptografia AES com uma chave de 192-bits.
  • `ZIP Encryption AES256`: criptografia AES com chave de 256-bits (padrão se uma senha for estabelecida).
  • `ZIP Encryption none`: os dados não são criptografados (padrão se não estabelecer uma senha)
    • | -| senha | Text | Uma senha a usar se a criptografia for necessária. | -| files | Collection |
  • a collection of `4D. File` or `4D. Folder` objects or
  • uma coleção de objetos com as propriedades abaixo:
    • PropriedadeTipoDescrição
    source4D. File or 4D. FolderFile ou Folder
    destinationText(opcional) especifique uma rota de arquivo relativa para mudar a organização dos conteúdos do arquivo
    optionnumber(opcional) - 'ZIP ignore invisible files' ou 0 para compactar o arquivo inteiro
    | -| callback | 4D. Function | Uma fórmula de callback (retrochamada) que recebe o progresso da compactação (0-100) em $1. | +| Propriedade | Tipo | Descrição | +| ----------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| compression | Integer |
  • `ZIP Compression standard`: Reduz a compactação (padrão)
  • `ZIP Compression LZMA`: compactação LZMA
  • `ZIP Compression XZ`: compactação XZ
  • `ZIP Compression none`: Sem compactação
    • | +| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Valores padrão se omitidos:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +| encryption | Integer | A criptografia a usar se uma senha for estabelecida:
    • `ZIP Encryption AES128`: criptografia AES com uma chave de 128-bits.
    • `ZIP Encryption AES192`: criptografia AES com uma chave de 192-bits.
    • `ZIP Encryption AES256`: criptografia AES com chave de 256-bits (padrão se uma senha for estabelecida).
    • `ZIP Encryption none`: os dados não são criptografados (padrão se não estabelecer uma senha)
    | +| senha | Text | Uma senha a usar se a criptografia for necessária. | +| files | Collection |
  • a collection of `4D. File` or `4D. Folder` objects or
  • uma coleção de objetos com as propriedades abaixo:
    • PropriedadeTipoDescrição
    source4D. File or 4D. FolderFile ou Folder
    destinationText(opcional) especifique uma rota de arquivo relativa para mudar a organização dos conteúdos do arquivo
    optionnumber(opcional) - 'ZIP ignore invisible files' ou 0 para compactar o arquivo inteiro
    | +| callback | 4D. Function | Uma fórmula de callback (retrochamada) que recebe o progresso da compactação (0-100) em $1. | In the *destinationFile* parameter, pass a `4D. File` object describing the ZIP archive to create (name, location, etc.). É recomendado usar a extensão ".zip" se quiser que o arquivo ZIP seja processado automaticamente por um software. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-20/Events/overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-20/Events/overview.md index 2a6be7d6a02772..e83c94df54bf0f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-20/Events/overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-20/Events/overview.md @@ -47,70 +47,71 @@ O número de objetos envolvidos em um evento depende da natureza do evento. A tabela seguinte resume a forma como os métodos objeto e formulário são chamados para cada tipo de evento: -| Evento | Métodos objecto | Método formulário | Que objectos | -| ------------------------ | --------------------------------- | ----------------- | -------------------------- | -| On Load | Sim | Sim | Todos os objectos | -| On Unload | Sim | Sim | Todos os objectos | -| On Validate | Sim | Sim | Todos os objectos | -| On Clicked | Sim | Sim | Apenas objecto envolvido | -| On Double Clicked | Sim | Sim | Apenas objecto envolvido | -| On Before Keystroke | Sim | Sim | Apenas objecto envolvido | -| On After Keystroke | Sim | Sim | Apenas objecto envolvido | -| On After Edit | Sim | Sim | Apenas objecto envolvido | -| On Getting Focus | Sim | Sim | Apenas objecto envolvido | -| On Losing Focus | Sim | Sim | Apenas objecto envolvido | -| On Activate | Nunca | Sim | Nenhum | -| On Deactivate | Nunca | Sim | Nenhum | -| On Outside Call | Nunca | Sim | Nenhum | -| On Page Change | Nunca | Sim | Nenhum | -| On Begin Drag Over | Sim | Sim | Apenas objecto envolvido | -| On Drop | Sim | Sim | Apenas objecto envolvido | -| On Drag Over | Sim | Nunca | Apenas objecto envolvido | -| On Mouse Enter | Sim | Sim | Todos os objectos | -| On Mouse Move | Sim | Sim | Todos os objectos | -| On Mouse Leave | Sim | Sim | Todos os objectos | -| On Mouse Up | Sim | Nunca | Apenas objecto envolvido | -| On Menu Selected | Nunca | Sim | Nenhum | -| On Bound variable change | Nunca | Sim | Nenhum | -| On Data Change | Sim | Sim | Apenas objecto envolvido | -| On Plug in Area | Sim | Sim | Apenas objecto envolvido | -| On Header | Sim | Sim | Todos os objectos | -| On Printing Detail | Sim | Sim | Todos os objectos | -| On Printing Break | Sim | Sim | Todos os objectos | -| On Printing Footer | Sim | Sim | Todos os objectos | -| On Close Box | Nunca | Sim | Nenhum | -| On Display Detail | Sim | Sim | Todos os objectos | -| On Open Detail | Sim (List box) | Sim | Nenhum, excepto List boxes | -| On Close Detail | Sim (List box) | Sim | Nenhum, excepto List boxes | -| On Resize | Nunca | Sim | Nenhum | -| On Selection Change | Sim | Sim | Apenas objecto envolvido | -| On Load Record | Nunca | Sim | Nenhum | -| On Timer | Nunca | Sim | Nenhum | -| On Scroll | Sim | Nunca | Apenas objecto envolvido | -| On Before Data Entry | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Column Moved | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Row Moved | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Column Resize | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Header Click | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Footer Click | Sim (List box) | Nunca | Apenas objecto envolvido | -| On After Sort | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Long Click | Sim (Botão) | Sim | Apenas objecto envolvido | -| On Alternative Click | Sim (botão e List box) | Nunca | Apenas objecto envolvido | -| On Expand | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On Collapse | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On Delete Action | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On URL Resource Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Begin URL Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On URL Loading Error | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On URL Filtering | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On End URL Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Open External Link | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Window Opening Denied | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On VP Range Changed | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | -| On VP Ready | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Row Resize | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| Evento | Code | Métodos objecto | Método formulário | Que objectos | +| ------------------------ | ---- | --------------------------------- | ----------------- | -------------------------- | +| On Activate | 11 | Nunca | Sim | Nenhum | +| On After Edit | 45 | Sim | Sim | Apenas objecto envolvido | +| On After Keystroke | 28 | Sim | Sim | Apenas objecto envolvido | +| On After Sort | 30 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Alternative Click | 38 | Sim (botão e List box) | Nunca | Apenas objecto envolvido | +| On Before Data Entry | 41 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Before Keystroke | 17 | Sim | Sim | Apenas objecto envolvido | +| On Begin Drag Over | 46 | Sim | Sim | Apenas objecto envolvido | +| On Begin URL Loading | 47 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Bound variable change | 54 | Nunca | Sim | Nenhum | +| On Clicked | 4 | Sim | Sim | Apenas objecto envolvido | +| On Close Box | 22 | Nunca | Sim | Nenhum | +| On Close Detail | 26 | Sim (List box) | Sim | Nenhum, excepto List boxes | +| On Collapse | 44 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Column Moved | 32 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Column Resize | 33 | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Data Change | 20 | Sim | Sim | Apenas objecto envolvido | +| On Deactivate | 12 | Nunca | Sim | Nenhum | +| On Delete Action | 58 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Display Detail | 8 | Sim | Sim | Todos os objectos | +| On Double Clicked | 13 | Sim | Sim | Apenas objecto envolvido | +| On Drag Over | 21 | Sim | Nunca | Apenas objecto envolvido | +| On Drop | 16 | Sim | Sim | Apenas objecto envolvido | +| On End URL Loading | 49 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Expand | 43 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Footer Click | 57 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Getting Focus | 15 | Sim | Sim | Apenas objecto envolvido | +| On Header | 5 | Sim | Sim | Todos os objectos | +| On Header Click | 42 | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Load | 1 | Sim | Sim | Todos os objectos | +| On Load Record | 40 | Nunca | Sim | Nenhum | +| On Long Click | 39 | Sim (Botão) | Sim | Apenas objecto envolvido | +| On Losing Focus | 14 | Sim | Sim | Apenas objecto envolvido | +| On Menu Selected | 18 | Nunca | Sim | Nenhum | +| On Mouse Enter | 35 | Sim | Sim | Todos os objectos | +| On Mouse Leave | 36 | Sim | Sim | Todos os objectos | +| On Mouse Move | 37 | Sim | Sim | Todos os objectos | +| On Mouse Up | 2 | Sim | Nunca | Apenas objecto envolvido | +| On Open Detail | 25 | Sim (List box) | Sim | Nenhum, excepto List boxes | +| On Open External Link | 52 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Outside Call | 10 | Nunca | Sim | Nenhum | +| On Page Change | 56 | Nunca | Sim | Nenhum | +| On Plug in Area | 19 | Sim | Sim | Apenas objecto envolvido | +| On Printing Break | 6 | Sim | Sim | Todos os objectos | +| On Printing Detail | 23 | Sim | Sim | Todos os objectos | +| On Printing Footer | 7 | Sim | Sim | Todos os objectos | +| On Resize | 29 | Nunca | Sim | Nenhum | +| On Row Moved | 34 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Row Resize | 60 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Scroll | 59 | Sim | Nunca | Apenas objecto envolvido | +| On Selection Change | 31 | Sim | Sim | Apenas objecto envolvido | +| On Timer | 27 | Nunca | Sim | Nenhum | +| On Unload | 24 | Sim | Sim | Todos os objectos | +| On URL Filtering | 51 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On URL Loading Error | 50 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On URL Resource Loading | 48 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Validate | 3 | Sim | Sim | Todos os objectos | +| On VP Range Changed | 61 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On VP Ready | 9 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Window Opening Denied | 53 | Sim (Área Web) | Nunca | Apenas objecto envolvido | Lembre-se sempre de que, para qualquer evento, o método de um formulário ou de um objeto é chamado se a propriedade de evento correspondente estiver selecionada para o formulário ou para os objetos. A vantagem de desativar os eventos no ambiente Design (usando a Lista de propriedades do editor de formulários) é que você pode reduzir o número de chamadas para métodos e, portanto, otimizar significativamente a velocidade de execução dos formulários. > AVISO: Os eventos [On Load](onLoad.md) e [On Unload](onUnload.md) são gerados para objetos se estiverem ativados tanto para os objetos quanto para o formulário ao qual os objetos pertencem. Se os eventos estiverem ativados somente para objetos, eles não ocorrerão; esses dois eventos também devem ser ativados no nível do formulário. + diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md index 68b21918066c1b..e8b05062d823bd 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/Events/overview.md @@ -46,68 +46,68 @@ O número de objetos envolvidos em um evento depende da natureza do evento. A tabela seguinte resume a forma como os métodos objeto e formulário são chamados para cada tipo de evento: -| Evento | Métodos objecto | Método formulário | Que objectos | -| ------------------------ | --------------------------------------------------------------- | ----------------- | -------------------------- | -| On Load | Sim | Sim | Todos os objectos | -| On Unload | Sim | Sim | Todos os objectos | -| On Validate | Sim | Sim | Todos os objectos | -| On Clicked | Sim | Sim | Apenas objecto envolvido | -| On Double Clicked | Sim | Sim | Apenas objecto envolvido | -| On Before Keystroke | Sim | Sim | Apenas objecto envolvido | -| On After Keystroke | Sim | Sim | Apenas objecto envolvido | -| On After Edit | Sim | Sim | Apenas objecto envolvido | -| On Getting Focus | Sim | Sim | Apenas objecto envolvido | -| On Losing Focus | Sim | Sim | Apenas objecto envolvido | -| On Activate | Nunca | Sim | Nenhum | -| On Deactivate | Nunca | Sim | Nenhum | -| On Outside Call | Nunca | Sim | Nenhum | -| On Page Change | Nunca | Sim | Nenhum | -| On Begin Drag Over | Sim | Sim | Apenas objecto envolvido | -| On Drop | Sim | Sim | Apenas objecto envolvido | -| On Drag Over | Sim | Nunca | Apenas objecto envolvido | -| On Mouse Enter | Sim | Sim | Todos os objectos | -| On Mouse Move | Sim | Sim | Todos os objectos | -| On Mouse Leave | Sim | Sim | Todos os objectos | -| On Mouse Up | Sim | Nunca | Apenas objecto envolvido | -| On Menu Selected | Nunca | Sim | Nenhum | -| On Bound variable change | Nunca | Sim | Nenhum | -| On Data Change | Sim | Sim | Apenas objecto envolvido | -| On Plug in Area | Sim | Sim | Apenas objecto envolvido | -| On Header | Sim | Sim | Todos os objectos | -| On Printing Detail | Sim | Sim | Todos os objectos | -| On Printing Break | Sim | Sim | Todos os objectos | -| On Printing Footer | Sim | Sim | Todos os objectos | -| On Close Box | Nunca | Sim | Nenhum | -| On Display Detail | Sim | Sim | Todos os objectos | -| On Open Detail | Sim (List box) | Sim | Nenhum, excepto List boxes | -| On Close Detail | Sim (List box) | Sim | Nenhum, excepto List boxes | -| On Resize | Nunca | Sim | Nenhum | -| On Selection Change | Sim | Sim | Apenas objecto envolvido | -| On Load Record | Nunca | Sim | Nenhum | -| On Timer | Nunca | Sim | Nenhum | -| On Scroll | Sim | Nunca | Apenas objecto envolvido | -| On Before Data Entry | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Column Moved | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Row Moved | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Column Resize | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Header Click | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Footer Click | Sim (List box) | Nunca | Apenas objecto envolvido | -| On After Sort | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Long Click | Sim (Botão) | Sim | Apenas objecto envolvido | -| On Alternative Click | Sim (botão e List box) | Nunca | Apenas objecto envolvido | -| On Expand | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On Collapse | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On Delete Action | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On URL Resource Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Begin URL Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On URL Loading Error | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On URL Filtering | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On End URL Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Open External Link | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Window Opening Denied | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On VP Range Changed | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | -| On VP Ready | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Row Resize | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| Evento | Code | Métodos objecto | Método formulário | Que objectos | +| ------------------------ | ---- | --------------------------------------------------------------- | ----------------- | -------------------------- | +| On Activate | 11 | Nunca | Sim | Nenhum | +| On After Edit | 45 | Sim | Sim | Apenas objecto envolvido | +| On After Keystroke | 28 | Sim | Sim | Apenas objecto envolvido | +| On After Sort | 30 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Alternative Click | 38 | Sim (botão e List box) | Nunca | Apenas objecto envolvido | +| On Before Data Entry | 41 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Before Keystroke | 17 | Sim | Sim | Apenas objecto envolvido | +| On Begin Drag Over | 46 | Sim | Sim | Apenas objecto envolvido | +| On Begin URL Loading | 47 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Bound variable change | 54 | Nunca | Sim | Nenhum | +| On Clicked | 4 | Sim | Sim | Apenas objecto envolvido | +| On Close Box | 22 | Nunca | Sim | Nenhum | +| On Close Detail | 26 | Sim (List box) | Sim | Nenhum, excepto List boxes | +| On Collapse | 44 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Column Moved | 32 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Column Resize | 33 | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Data Change | 20 | Sim | Sim | Apenas objecto envolvido | +| On Deactivate | 12 | Nunca | Sim | Nenhum | +| On Delete Action | 58 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Display Detail | 8 | Sim | Sim | Todos os objectos | +| On Double Clicked | 13 | Sim | Sim | Apenas objecto envolvido | +| On Drag Over | 21 | Sim | Nunca | Apenas objecto envolvido | +| On Drop | 16 | Sim | Sim | Apenas objecto envolvido | +| On End URL Loading | 49 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Expand | 43 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Footer Click | 57 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Getting Focus | 15 | Sim | Sim | Apenas objecto envolvido | +| On Header | 5 | Sim | Sim | Todos os objectos | +| On Header Click | 42 | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Load | 1 | Sim | Sim | Todos os objectos | +| On Load Record | 40 | Nunca | Sim | Nenhum | +| On Long Click | 39 | Sim (Botão) | Sim | Apenas objecto envolvido | +| On Losing Focus | 14 | Sim | Sim | Apenas objecto envolvido | +| On Menu Selected | 18 | Nunca | Sim | Nenhum | +| On Mouse Enter | 35 | Sim | Sim | Todos os objectos | +| On Mouse Leave | 36 | Sim | Sim | Todos os objectos | +| On Mouse Move | 37 | Sim | Sim | Todos os objectos | +| On Mouse Up | 2 | Sim | Nunca | Apenas objecto envolvido | +| On Open Detail | 25 | Sim (List box) | Sim | Nenhum, excepto List boxes | +| On Open External Link | 52 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Outside Call | 10 | Nunca | Sim | Nenhum | +| On Page Change | 56 | Nunca | Sim | Nenhum | +| On Plug in Area | 19 | Sim | Sim | Apenas objecto envolvido | +| On Printing Break | 6 | Sim | Sim | Todos os objectos | +| On Printing Detail | 23 | Sim | Sim | Todos os objectos | +| On Printing Footer | 7 | Sim | Sim | Todos os objectos | +| On Resize | 29 | Nunca | Sim | Nenhum | +| On Row Moved | 34 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Row Resize | 60 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Scroll | 59 | Sim | Nunca | Apenas objecto envolvido | +| On Selection Change | 31 | Sim | Sim | Apenas objecto envolvido | +| On Timer | 27 | Nunca | Sim | Nenhum | +| On Unload | 24 | Sim | Sim | Todos os objectos | +| On URL Filtering | 51 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On URL Loading Error | 50 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On URL Resource Loading | 48 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Validate | 3 | Sim | Sim | Todos os objectos | +| On VP Range Changed | 61 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On VP Ready | 9 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Window Opening Denied | 53 | Sim (Área Web) | Nunca | Apenas objecto envolvido | Lembre-se sempre de que, para qualquer evento, o método de um formulário ou de um objeto é chamado se a propriedade de evento correspondente estiver selecionada para o formulário ou para os objetos. A vantagem de desativar os eventos no ambiente Design (usando a Lista de propriedades do editor de formulários) é que você pode reduzir o número de chamadas para métodos e, portanto, otimizar significativamente a velocidade de execução dos formulários. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md index 0d37c67e7b742b..3258d198e4e451 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md @@ -49,8 +49,8 @@ You can pass a 4D. File, a 4D. Folder, or a zip structure object as first parame | Propriedade | Tipo | Descrição | | ----------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Deflate compression (default)
  • `ZIP Compression LZMA`: LZMA compression
  • `ZIP Compression XZ`: XZ compression
  • `ZIP Compression none`: No compression
    • | -| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Default values if omitted:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Default values if omitted:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +| encryption | Integer | The encryption to use if a password is set:
    • `ZIP Encryption AES128`: AES encryption using 128-bit key.
    • `ZIP Encryption AES192`: AES encryption using 192-bit key.
    • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
    • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    | | senha | Text | Uma senha a usar se a criptografia for necessária. | | files | Collection |
  • a collection of `4D.File` or `4D.Folder` objects or
  • a collection of objects with the following properties:
    • PropertyTypeDescription
    source4D.File or 4D.FolderFile or Folder
    destinationText(optional) - Specify a relative filepath to change the organization of the contents of the archive
    optionnumber(optional) - `ZIP Ignore invisible files` or 0 to compress all of the file
    | | callback | 4D. Function | Uma fórmula de callback (retrochamada) que recebe o progresso da compactação (0-100) em $1. | @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## Veja também -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## Propriedades diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md index 9a49a2556ca025..6f2091cb3ec3ad 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21-R3/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ Para ler todos os conteúdos de um arquivo sem extraí-lo da pasta root: ## Veja também -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## Propriedades diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md index 68b21918066c1b..e8b05062d823bd 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/Events/overview.md @@ -46,68 +46,68 @@ O número de objetos envolvidos em um evento depende da natureza do evento. A tabela seguinte resume a forma como os métodos objeto e formulário são chamados para cada tipo de evento: -| Evento | Métodos objecto | Método formulário | Que objectos | -| ------------------------ | --------------------------------------------------------------- | ----------------- | -------------------------- | -| On Load | Sim | Sim | Todos os objectos | -| On Unload | Sim | Sim | Todos os objectos | -| On Validate | Sim | Sim | Todos os objectos | -| On Clicked | Sim | Sim | Apenas objecto envolvido | -| On Double Clicked | Sim | Sim | Apenas objecto envolvido | -| On Before Keystroke | Sim | Sim | Apenas objecto envolvido | -| On After Keystroke | Sim | Sim | Apenas objecto envolvido | -| On After Edit | Sim | Sim | Apenas objecto envolvido | -| On Getting Focus | Sim | Sim | Apenas objecto envolvido | -| On Losing Focus | Sim | Sim | Apenas objecto envolvido | -| On Activate | Nunca | Sim | Nenhum | -| On Deactivate | Nunca | Sim | Nenhum | -| On Outside Call | Nunca | Sim | Nenhum | -| On Page Change | Nunca | Sim | Nenhum | -| On Begin Drag Over | Sim | Sim | Apenas objecto envolvido | -| On Drop | Sim | Sim | Apenas objecto envolvido | -| On Drag Over | Sim | Nunca | Apenas objecto envolvido | -| On Mouse Enter | Sim | Sim | Todos os objectos | -| On Mouse Move | Sim | Sim | Todos os objectos | -| On Mouse Leave | Sim | Sim | Todos os objectos | -| On Mouse Up | Sim | Nunca | Apenas objecto envolvido | -| On Menu Selected | Nunca | Sim | Nenhum | -| On Bound variable change | Nunca | Sim | Nenhum | -| On Data Change | Sim | Sim | Apenas objecto envolvido | -| On Plug in Area | Sim | Sim | Apenas objecto envolvido | -| On Header | Sim | Sim | Todos os objectos | -| On Printing Detail | Sim | Sim | Todos os objectos | -| On Printing Break | Sim | Sim | Todos os objectos | -| On Printing Footer | Sim | Sim | Todos os objectos | -| On Close Box | Nunca | Sim | Nenhum | -| On Display Detail | Sim | Sim | Todos os objectos | -| On Open Detail | Sim (List box) | Sim | Nenhum, excepto List boxes | -| On Close Detail | Sim (List box) | Sim | Nenhum, excepto List boxes | -| On Resize | Nunca | Sim | Nenhum | -| On Selection Change | Sim | Sim | Apenas objecto envolvido | -| On Load Record | Nunca | Sim | Nenhum | -| On Timer | Nunca | Sim | Nenhum | -| On Scroll | Sim | Nunca | Apenas objecto envolvido | -| On Before Data Entry | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Column Moved | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Row Moved | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Column Resize | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Header Click | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Footer Click | Sim (List box) | Nunca | Apenas objecto envolvido | -| On After Sort | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Long Click | Sim (Botão) | Sim | Apenas objecto envolvido | -| On Alternative Click | Sim (botão e List box) | Nunca | Apenas objecto envolvido | -| On Expand | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On Collapse | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On Delete Action | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On URL Resource Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Begin URL Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On URL Loading Error | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On URL Filtering | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On End URL Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Open External Link | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Window Opening Denied | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On VP Range Changed | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | -| On VP Ready | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Row Resize | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| Evento | Code | Métodos objecto | Método formulário | Que objectos | +| ------------------------ | ---- | --------------------------------------------------------------- | ----------------- | -------------------------- | +| On Activate | 11 | Nunca | Sim | Nenhum | +| On After Edit | 45 | Sim | Sim | Apenas objecto envolvido | +| On After Keystroke | 28 | Sim | Sim | Apenas objecto envolvido | +| On After Sort | 30 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Alternative Click | 38 | Sim (botão e List box) | Nunca | Apenas objecto envolvido | +| On Before Data Entry | 41 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Before Keystroke | 17 | Sim | Sim | Apenas objecto envolvido | +| On Begin Drag Over | 46 | Sim | Sim | Apenas objecto envolvido | +| On Begin URL Loading | 47 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Bound variable change | 54 | Nunca | Sim | Nenhum | +| On Clicked | 4 | Sim | Sim | Apenas objecto envolvido | +| On Close Box | 22 | Nunca | Sim | Nenhum | +| On Close Detail | 26 | Sim (List box) | Sim | Nenhum, excepto List boxes | +| On Collapse | 44 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Column Moved | 32 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Column Resize | 33 | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Data Change | 20 | Sim | Sim | Apenas objecto envolvido | +| On Deactivate | 12 | Nunca | Sim | Nenhum | +| On Delete Action | 58 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Display Detail | 8 | Sim | Sim | Todos os objectos | +| On Double Clicked | 13 | Sim | Sim | Apenas objecto envolvido | +| On Drag Over | 21 | Sim | Nunca | Apenas objecto envolvido | +| On Drop | 16 | Sim | Sim | Apenas objecto envolvido | +| On End URL Loading | 49 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Expand | 43 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Footer Click | 57 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Getting Focus | 15 | Sim | Sim | Apenas objecto envolvido | +| On Header | 5 | Sim | Sim | Todos os objectos | +| On Header Click | 42 | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Load | 1 | Sim | Sim | Todos os objectos | +| On Load Record | 40 | Nunca | Sim | Nenhum | +| On Long Click | 39 | Sim (Botão) | Sim | Apenas objecto envolvido | +| On Losing Focus | 14 | Sim | Sim | Apenas objecto envolvido | +| On Menu Selected | 18 | Nunca | Sim | Nenhum | +| On Mouse Enter | 35 | Sim | Sim | Todos os objectos | +| On Mouse Leave | 36 | Sim | Sim | Todos os objectos | +| On Mouse Move | 37 | Sim | Sim | Todos os objectos | +| On Mouse Up | 2 | Sim | Nunca | Apenas objecto envolvido | +| On Open Detail | 25 | Sim (List box) | Sim | Nenhum, excepto List boxes | +| On Open External Link | 52 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Outside Call | 10 | Nunca | Sim | Nenhum | +| On Page Change | 56 | Nunca | Sim | Nenhum | +| On Plug in Area | 19 | Sim | Sim | Apenas objecto envolvido | +| On Printing Break | 6 | Sim | Sim | Todos os objectos | +| On Printing Detail | 23 | Sim | Sim | Todos os objectos | +| On Printing Footer | 7 | Sim | Sim | Todos os objectos | +| On Resize | 29 | Nunca | Sim | Nenhum | +| On Row Moved | 34 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Row Resize | 60 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Scroll | 59 | Sim | Nunca | Apenas objecto envolvido | +| On Selection Change | 31 | Sim | Sim | Apenas objecto envolvido | +| On Timer | 27 | Nunca | Sim | Nenhum | +| On Unload | 24 | Sim | Sim | Todos os objectos | +| On URL Filtering | 51 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On URL Loading Error | 50 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On URL Resource Loading | 48 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Validate | 3 | Sim | Sim | Todos os objectos | +| On VP Range Changed | 61 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On VP Ready | 9 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Window Opening Denied | 53 | Sim (Área Web) | Nunca | Apenas objecto envolvido | Lembre-se sempre de que, para qualquer evento, o método de um formulário ou de um objeto é chamado se a propriedade de evento correspondente estiver selecionada para o formulário ou para os objetos. A vantagem de desativar os eventos no ambiente Design (usando a Lista de propriedades do editor de formulários) é que você pode reduzir o número de chamadas para métodos e, portanto, otimizar significativamente a velocidade de execução dos formulários. diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md b/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md index 0d37c67e7b742b..3258d198e4e451 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md @@ -49,8 +49,8 @@ You can pass a 4D. File, a 4D. Folder, or a zip structure object as first parame | Propriedade | Tipo | Descrição | | ----------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Deflate compression (default)
  • `ZIP Compression LZMA`: LZMA compression
  • `ZIP Compression XZ`: XZ compression
  • `ZIP Compression none`: No compression
    • | -| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Default values if omitted:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Default values if omitted:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +| encryption | Integer | The encryption to use if a password is set:
    • `ZIP Encryption AES128`: AES encryption using 128-bit key.
    • `ZIP Encryption AES192`: AES encryption using 192-bit key.
    • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
    • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    | | senha | Text | Uma senha a usar se a criptografia for necessária. | | files | Collection |
  • a collection of `4D.File` or `4D.Folder` objects or
  • a collection of objects with the following properties:
    • PropertyTypeDescription
    source4D.File or 4D.FolderFile or Folder
    destinationText(optional) - Specify a relative filepath to change the organization of the contents of the archive
    optionnumber(optional) - `ZIP Ignore invisible files` or 0 to compress all of the file
    | | callback | 4D. Function | Uma fórmula de callback (retrochamada) que recebe o progresso da compactação (0-100) em $1. | @@ -165,10 +165,10 @@ $err:=ZIP Create archive($zip; $destination) ## Veja também -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Read archive`](../commands/zip-read-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Read archive`](../commands/zip-read-archive) ## Propriedades diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md b/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md index 9a49a2556ca025..6f2091cb3ec3ad 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21-R4/language-legacy/File and Folder/zip-read-archive.md @@ -86,10 +86,10 @@ Para ler todos os conteúdos de um arquivo sem extraí-lo da pasta root: ## Veja também -[ZipArchive Class](../../API/ZipArchiveClass.md) -[ZipFile Class](../../API/ZipFileClass.md) -[ZipFolder Class](../../API/ZipFolderClass.md) -[`ZIP Create archive`](../commands/zip-create-archive) +[ZipArchive Class](../../API/ZipArchiveClass.md) +[ZipFile Class](../../API/ZipFileClass.md) +[ZipFolder Class](../../API/ZipFolderClass.md) +[`ZIP Create archive`](../commands/zip-create-archive) ## Propriedades diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/Events/overview.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/Events/overview.md index 46be1873d6b75a..e8b05062d823bd 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/Events/overview.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/Events/overview.md @@ -5,7 +5,7 @@ title: Eventos formulário Eventos de formulário são eventos que podem levar à execução do método de formulário e/ou método(s) de objeto de formulário. Os eventos de formulário permitem que você controle o fluxo do aplicativo e escreva códigos que são executados somente quando ocorre um evento específico. -Em seu código, você controla os eventos usando o comando [`FORM Event`](../commands/form-event.md), que retorna o evento acionado. Por exemplo: +Em seu código, você controla os eventos usando o comando [`FORM Event`](../commands/form-event), que retorna o evento acionado. Por exemplo: ```4d //código de um botão If(FORM Event.code=On Clicked) @@ -16,7 +16,7 @@ Em seu código, você controla os eventos usando o comando [`FORM Event`](../com ## Objecto evento -Cada evento é retornado como um objeto pelo comando [`FORM Event`](../commands/form-event.md). Por padrão, ele contém as seguintes propriedades: +Cada evento é retornado como um objeto pelo comando [`FORM Event`](../commands/form-event). Por padrão, ele contém as seguintes propriedades: | Propriedade | Tipo | Descrição | | ----------- | ------------- | ------------------------------------------------------------------------------------------------------- | @@ -46,70 +46,71 @@ O número de objetos envolvidos em um evento depende da natureza do evento. A tabela seguinte resume a forma como os métodos objeto e formulário são chamados para cada tipo de evento: -| Evento | Métodos objecto | Método formulário | Que objectos | -| ------------------------ | --------------------------------------------------------------- | ----------------- | -------------------------- | -| On Load | Sim | Sim | Todos os objectos | -| On Unload | Sim | Sim | Todos os objectos | -| On Validate | Sim | Sim | Todos os objectos | -| On Clicked | Sim | Sim | Apenas objecto envolvido | -| On Double Clicked | Sim | Sim | Apenas objecto envolvido | -| On Before Keystroke | Sim | Sim | Apenas objecto envolvido | -| On After Keystroke | Sim | Sim | Apenas objecto envolvido | -| On After Edit | Sim | Sim | Apenas objecto envolvido | -| On Getting Focus | Sim | Sim | Apenas objecto envolvido | -| On Losing Focus | Sim | Sim | Apenas objecto envolvido | -| On Activate | Nunca | Sim | Nenhum | -| On Deactivate | Nunca | Sim | Nenhum | -| On Outside Call | Nunca | Sim | Nenhum | -| On Page Change | Nunca | Sim | Nenhum | -| On Begin Drag Over | Sim | Sim | Apenas objecto envolvido | -| On Drop | Sim | Sim | Apenas objecto envolvido | -| On Drag Over | Sim | Nunca | Apenas objecto envolvido | -| On Mouse Enter | Sim | Sim | Todos os objectos | -| On Mouse Move | Sim | Sim | Todos os objectos | -| On Mouse Leave | Sim | Sim | Todos os objectos | -| On Mouse Up | Sim | Nunca | Apenas objecto envolvido | -| On Menu Selected | Nunca | Sim | Nenhum | -| On Bound variable change | Nunca | Sim | Nenhum | -| On Data Change | Sim | Sim | Apenas objecto envolvido | -| On Plug in Area | Sim | Sim | Apenas objecto envolvido | -| On Header | Sim | Sim | Todos os objectos | -| On Printing Detail | Sim | Sim | Todos os objectos | -| On Printing Break | Sim | Sim | Todos os objectos | -| On Printing Footer | Sim | Sim | Todos os objectos | -| On Close Box | Nunca | Sim | Nenhum | -| On Display Detail | Sim | Sim | Todos os objectos | -| On Open Detail | Sim (List box) | Sim | Nenhum, excepto List boxes | -| On Close Detail | Sim (List box) | Sim | Nenhum, excepto List boxes | -| On Resize | Nunca | Sim | Nenhum | -| On Selection Change | Sim | Sim | Apenas objecto envolvido | -| On Load Record | Nunca | Sim | Nenhum | -| On Timer | Nunca | Sim | Nenhum | -| On Scroll | Sim | Nunca | Apenas objecto envolvido | -| On Before Data Entry | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Column Moved | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Row Moved | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Column Resize | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Header Click | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Footer Click | Sim (List box) | Nunca | Apenas objecto envolvido | -| On After Sort | Sim (List box) | Nunca | Apenas objecto envolvido | -| On Long Click | Sim (Botão) | Sim | Apenas objecto envolvido | -| On Alternative Click | Sim (botão e List box) | Nunca | Apenas objecto envolvido | -| On Expand | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On Collapse | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On Delete Action | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | -| On URL Resource Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Begin URL Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On URL Loading Error | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On URL Filtering | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On End URL Loading | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Open External Link | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On Window Opening Denied | Sim (Área Web) | Nunca | Apenas objecto envolvido | -| On VP Range Changed | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | -| On VP Ready | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | -| On Row Resize | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| Evento | Code | Métodos objecto | Método formulário | Que objectos | +| ------------------------ | ---- | --------------------------------------------------------------- | ----------------- | -------------------------- | +| On Activate | 11 | Nunca | Sim | Nenhum | +| On After Edit | 45 | Sim | Sim | Apenas objecto envolvido | +| On After Keystroke | 28 | Sim | Sim | Apenas objecto envolvido | +| On After Sort | 30 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Alternative Click | 38 | Sim (botão e List box) | Nunca | Apenas objecto envolvido | +| On Before Data Entry | 41 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Before Keystroke | 17 | Sim | Sim | Apenas objecto envolvido | +| On Begin Drag Over | 46 | Sim | Sim | Apenas objecto envolvido | +| On Begin URL Loading | 47 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Bound variable change | 54 | Nunca | Sim | Nenhum | +| On Clicked | 4 | Sim | Sim | Apenas objecto envolvido | +| On Close Box | 22 | Nunca | Sim | Nenhum | +| On Close Detail | 26 | Sim (List box) | Sim | Nenhum, excepto List boxes | +| On Collapse | 44 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Column Moved | 32 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Column Resize | 33 | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Data Change | 20 | Sim | Sim | Apenas objecto envolvido | +| On Deactivate | 12 | Nunca | Sim | Nenhum | +| On Delete Action | 58 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Display Detail | 8 | Sim | Sim | Todos os objectos | +| On Double Clicked | 13 | Sim | Sim | Apenas objecto envolvido | +| On Drag Over | 21 | Sim | Nunca | Apenas objecto envolvido | +| On Drop | 16 | Sim | Sim | Apenas objecto envolvido | +| On End URL Loading | 49 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Expand | 43 | Sim (Hier. lista e list box) | Nunca | Apenas objecto envolvido | +| On Footer Click | 57 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Getting Focus | 15 | Sim | Sim | Apenas objecto envolvido | +| On Header | 5 | Sim | Sim | Todos os objectos | +| On Header Click | 42 | Sim (List box e Area 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Load | 1 | Sim | Sim | Todos os objectos | +| On Load Record | 40 | Nunca | Sim | Nenhum | +| On Long Click | 39 | Sim (Botão) | Sim | Apenas objecto envolvido | +| On Losing Focus | 14 | Sim | Sim | Apenas objecto envolvido | +| On Menu Selected | 18 | Nunca | Sim | Nenhum | +| On Mouse Enter | 35 | Sim | Sim | Todos os objectos | +| On Mouse Leave | 36 | Sim | Sim | Todos os objectos | +| On Mouse Move | 37 | Sim | Sim | Todos os objectos | +| On Mouse Up | 2 | Sim | Nunca | Apenas objecto envolvido | +| On Open Detail | 25 | Sim (List box) | Sim | Nenhum, excepto List boxes | +| On Open External Link | 52 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Outside Call | 10 | Nunca | Sim | Nenhum | +| On Page Change | 56 | Nunca | Sim | Nenhum | +| On Plug in Area | 19 | Sim | Sim | Apenas objecto envolvido | +| On Printing Break | 6 | Sim | Sim | Todos os objectos | +| On Printing Detail | 23 | Sim | Sim | Todos os objectos | +| On Printing Footer | 7 | Sim | Sim | Todos os objectos | +| On Resize | 29 | Nunca | Sim | Nenhum | +| On Row Moved | 34 | Sim (List box) | Nunca | Apenas objecto envolvido | +| On Row Resize | 60 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Scroll | 59 | Sim | Nunca | Apenas objecto envolvido | +| On Selection Change | 31 | Sim | Sim | Apenas objecto envolvido | +| On Timer | 27 | Nunca | Sim | Nenhum | +| On Unload | 24 | Sim | Sim | Todos os objectos | +| On URL Filtering | 51 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On URL Loading Error | 50 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On URL Resource Loading | 48 | Sim (Área Web) | Nunca | Apenas objecto envolvido | +| On Validate | 3 | Sim | Sim | Todos os objectos | +| On VP Range Changed | 61 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On VP Ready | 9 | Sim (Área 4D View Pro) | Nunca | Apenas objecto envolvido | +| On Window Opening Denied | 53 | Sim (Área Web) | Nunca | Apenas objecto envolvido | Lembre-se sempre de que, para qualquer evento, o método de um formulário ou de um objeto é chamado se a propriedade de evento correspondente estiver selecionada para o formulário ou para os objetos. A vantagem de desativar os eventos no ambiente Design (usando a Lista de propriedades do editor de formulários) é que você pode reduzir o número de chamadas para métodos e, portanto, otimizar significativamente a velocidade de execução dos formulários. > Excepto en los eventos [En carga](onLoad.md) y [En descarga](onUnload.md) (ver más abajo), si la propiedad del evento formulario no está seleccionada para un evento determinado, esto no impide las llamadas a los métodos objetos cuya misma propiedad de eve Em outras palavras, ativar ou desativar um evento no nível do formulário não tem efeito sobre as propriedades do evento do objeto. Se os eventos estiverem ativados somente para objetos, eles não ocorrerão; esses dois eventos também devem ser ativados no nível do formulário. + diff --git a/i18n/pt/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md b/i18n/pt/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md index b4f29d21eec33d..32654e8606beb3 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md +++ b/i18n/pt/docusaurus-plugin-content-docs/version-21/commands/zip-create-archive.md @@ -48,8 +48,8 @@ You can pass a 4D. File, a 4D. Folder, or a zip structure object as first parame | Propriedade | Tipo | Descrição | | ----------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | compression | Integer |
  • `ZIP Compression standard`: Deflate compression (default)
  • `ZIP Compression LZMA`: LZMA compression
  • `ZIP Compression XZ`: XZ compression
  • `ZIP Compression none`: No compression
    • | -| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Default values if omitted:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -| encryption | Integer | The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +| level | Integer | Nível de compressão. Valores possíveis: de 1 a 10. Um valor pequeno produz um arquivo de maior tamanho, enquanto um valor grande produz um arquivo de tamanho menor. O nível de compactação tem um impacto na performance. Default values if omitted:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +| encryption | Integer | The encryption to use if a password is set:
    • `ZIP Encryption AES128`: AES encryption using 128-bit key.
    • `ZIP Encryption AES192`: AES encryption using 192-bit key.
    • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
    • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    | | senha | Text | Uma senha a usar se a criptografia for necessária. | | files | Collection |
  • a collection of `4D.File` or `4D.Folder` objects or
  • a collection of objects with the following properties:
    • PropertyTypeDescription
    source4D.File or 4D.FolderFile or Folder
    destinationText(optional) - Specify a relative filepath to change the organization of the contents of the archive
    optionnumber(optional) - `ZIP Ignore invisible files` or 0 to compress all of the file
    | | callback | 4D. Function | Uma fórmula de callback (retrochamada) que recebe o progresso da compactação (0-100) em $1. | diff --git a/versioned_docs/version-19/API/ZipArchiveClass.md b/versioned_docs/version-19/API/ZipArchiveClass.md index e2f7a2a0711210..a5e75fa6d8d9f8 100644 --- a/versioned_docs/version-19/API/ZipArchiveClass.md +++ b/versioned_docs/version-19/API/ZipArchiveClass.md @@ -77,8 +77,8 @@ You can pass a 4D.File, a 4D.Folder, or a zip structure object as first paramete |Property|Type|Description| |---|---|---| |compression|Integer|
  • `ZIP Compression standard`: Deflate compression (default)
  • `ZIP Compression LZMA`: LZMA compression
  • `ZIP Compression XZ`: XZ compression
  • `ZIP Compression none`: No compression
    • | -|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -|encryption|Integer|The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +|encryption|Integer|The encryption to use if a password is set:
    • `ZIP Encryption AES128`: AES encryption using 128-bit key.
    • `ZIP Encryption AES192`: AES encryption using 192-bit key.
    • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
    • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    | |password|Text|A password to use if encryption is required.| |files|Collection|
  • a collection of `4D.File` or `4D.Folder` objects or
  • a collection of objects with the following properties:
    • PropertyTypeDescription
    source4D.File or 4D.FolderFile or Folder
    destinationText(optional) - Specify a relative filepath to change the organization of the contents of the archive
    optionnumber(optional) - `ZIP Ignore invisible files` or 0 to compress all of the file
    | |callback|4D.Function|A callback formula that will receive the compression progress (0 - 100) in $1.| diff --git a/versioned_docs/version-20/API/ZipArchiveClass.md b/versioned_docs/version-20/API/ZipArchiveClass.md index 49d84609f57548..828bde27c28658 100644 --- a/versioned_docs/version-20/API/ZipArchiveClass.md +++ b/versioned_docs/version-20/API/ZipArchiveClass.md @@ -78,8 +78,8 @@ You can pass a 4D.File, a 4D.Folder, or a zip structure object as first paramete |Property|Type|Description| |---|---|---| |compression|Integer|
  • `ZIP Compression standard`: Deflate compression (default)
  • `ZIP Compression LZMA`: LZMA compression
  • `ZIP Compression XZ`: XZ compression
  • `ZIP Compression none`: No compression
    • | -|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -|encryption|Integer|The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +|encryption|Integer|The encryption to use if a password is set:
    • `ZIP Encryption AES128`: AES encryption using 128-bit key.
    • `ZIP Encryption AES192`: AES encryption using 192-bit key.
    • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
    • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    | |password|Text|A password to use if encryption is required.| |files|Collection|
  • a collection of `4D.File` or `4D.Folder` objects or
  • a collection of objects with the following properties:
    • PropertyTypeDescription
    source4D.File or 4D.FolderFile or Folder
    destinationText(optional) - Specify a relative filepath to change the organization of the contents of the archive
    optionnumber(optional) - `ZIP Ignore invisible files` or 0 to compress all of the file
    | |callback|4D.Function|A callback formula that will receive the compression progress (0 - 100) in $1.| diff --git a/versioned_docs/version-20/Events/overview.md b/versioned_docs/version-20/Events/overview.md index 8dbd1b97ec34ff..ff0cc1a3f54c8d 100644 --- a/versioned_docs/version-20/Events/overview.md +++ b/versioned_docs/version-20/Events/overview.md @@ -50,70 +50,71 @@ The number of objects involved in an event depends on the nature of the event. The following table summarizes how object and form methods are called for each event type: -|Event|Object Methods|Form Method|Which Objects| -|---|---|----|---| -|On Load|Yes|Yes|All objects| -|On Unload|Yes|Yes|All objects| -|On Validate|Yes|Yes|All objects| -|On Clicked|Yes |Yes|Involved object only| -|On Double Clicked|Yes|Yes|Involved object only| -|On Before Keystroke|Yes|Yes|Involved object only| -|On After Keystroke|Yes|Yes|Involved object only| -|On After Edit|Yes|Yes|Involved object only| -|On Getting Focus|Yes|Yes|Involved object only| -|On Losing Focus|Yes|Yes|Involved object only| -|On Activate|Never|Yes|None| -|On Deactivate|Never|Yes|None| -|On Outside Call|Never|Yes|None| -|On Page Change|Never|Yes|None| -|On Begin Drag Over|Yes|Yes|Involved object only| -|On Drop|Yes|Yes|Involved object only| -|On Drag Over|Yes|Never |Involved object only| -|On Mouse Enter|Yes|Yes|All objects| -|On Mouse Move|Yes|Yes|All objects| -|On Mouse Leave|Yes|Yes|All objects| -|On Mouse Up|Yes|Never|Involved object only| -|On Menu Selected|Never|Yes|None| -|On Bound variable change|Never|Yes|None| -|On Data Change|Yes|Yes|Involved object only| -|On Plug in Area|Yes|Yes|Involved object only| -|On Header|Yes|Yes|All objects| -|On Printing Detail|Yes|Yes |All objects| -|On Printing Break|Yes |Yes|All objects| -|On Printing Footer|Yes |Yes|All objects| -|On Close Box|Never|Yes |None| -|On Display Detail|Yes|Yes|All objects| -|On Open Detail|Yes (List box)|Yes|None except List boxes| -|On Close Detail|Yes (List box)|Yes|None except List boxes| -|On Resize|Never|Yes|None| -|On Selection Change|Yes|Yes|Involved object only| -|On Load Record|Never|Yes|None| -|On Timer|Never|Yes|None| -|On Scroll|Yes|Never|Involved object only| -|On Before Data Entry|Yes (List box)|Never|Involved object only| -|On Column Moved|Yes (List box)|Never|Involved object only| -|On Row Moved|Yes (List box)|Never|Involved object only| -|On Column Resize|Yes (List box and 4D View Pro Area)| Never|Involved object only| -|On Header Click|Yes (List box and 4D View Pro Area)|Never|Involved object only| -|On Footer Click|Yes (List box)|Never|Involved object only| -|On After Sort|Yes (List box)|Never|Involved object only| -|On Long Click|Yes (Button)|Yes|Involved object only| -|On Alternative Click|Yes (Button and List box)|Never| Involved object only| -|On Expand|Yes (Hier. list and list box)|Never|Involved object only| -|On Collapse|Yes (Hier. list and list box)|Never|Involved object only| -|On Delete Action|Yes (Hier. list and list box)|Never|Involved object only| -|On URL Resource Loading|Yes (Web Area)|Never|Involved object only| -|On Begin URL Loading|Yes (Web Area)|Never|Involved object only| -|On URL Loading Error|Yes (Web Area)|Never|Involved object only| -|On URL Filtering|Yes (Web Area)|Never|Involved object only| -|On End URL Loading|Yes (Web Area)|Never|Involved object only| -|On Open External Link|Yes (Web Area)|Never|Involved object only| -|On Window Opening Denied|Yes (Web Area)|Never|Involved object only| -|On VP Range Changed|Yes (4D View Pro Area)|Never|Involved object only| -|On VP Ready|Yes (4D View Pro Area)|Never|Involved object only| -|On Row Resize|Yes (4D View Pro Area)|Never|Involved object only| +|Event|Code|Object Methods|Form Method|Which Objects| +|---|---|---|----|---| +|On Activate|11|Never|Yes|None| +|On After Edit|45|Yes|Yes|Involved object only| +|On After Keystroke|28|Yes|Yes|Involved object only| +|On After Sort|30|Yes (List box)|Never|Involved object only| +|On Alternative Click|38|Yes (Button and List box)|Never| Involved object only| +|On Before Data Entry|41|Yes (List box)|Never|Involved object only| +|On Before Keystroke|17|Yes|Yes|Involved object only| +|On Begin Drag Over|46|Yes|Yes|Involved object only| +|On Begin URL Loading|47|Yes (Web Area)|Never|Involved object only| +|On Bound variable change|54|Never|Yes|None| +|On Clicked|4|Yes |Yes|Involved object only| +|On Close Box|22|Never|Yes |None| +|On Close Detail|26|Yes (List box)|Yes|None except List boxes| +|On Collapse|44|Yes (Hier. list and list box)|Never|Involved object only| +|On Column Moved|32|Yes (List box)|Never|Involved object only| +|On Column Resize|33|Yes (List box and 4D View Pro Area)| Never|Involved object only| +|On Data Change|20|Yes|Yes|Involved object only| +|On Deactivate|12|Never|Yes|None| +|On Delete Action|58|Yes (Hier. list and list box)|Never|Involved object only| +|On Display Detail|8|Yes|Yes|All objects| +|On Double Clicked|13|Yes|Yes|Involved object only| +|On Drag Over|21|Yes|Never |Involved object only| +|On Drop|16|Yes|Yes|Involved object only| +|On End URL Loading|49|Yes (Web Area)|Never|Involved object only| +|On Expand|43|Yes (Hier. list and list box)|Never|Involved object only| +|On Footer Click|57|Yes (List box)|Never|Involved object only| +|On Getting Focus|15|Yes|Yes|Involved object only| +|On Header|5|Yes|Yes|All objects| +|On Header Click|42|Yes (List box and 4D View Pro Area)|Never|Involved object only| +|On Load|1|Yes|Yes|All objects| +|On Load Record|40|Never|Yes|None| +|On Long Click|39|Yes (Button)|Yes|Involved object only| +|On Losing Focus|14|Yes|Yes|Involved object only| +|On Menu Selected|18|Never|Yes|None| +|On Mouse Enter|35|Yes|Yes|All objects| +|On Mouse Leave|36|Yes|Yes|All objects| +|On Mouse Move|37|Yes|Yes|All objects| +|On Mouse Up|2|Yes|Never|Involved object only| +|On Open Detail|25|Yes (List box)|Yes|None except List boxes| +|On Open External Link|52|Yes (Web Area)|Never|Involved object only| +|On Outside Call|10|Never|Yes|None| +|On Page Change|56|Never|Yes|None| +|On Plug in Area|19|Yes|Yes|Involved object only| +|On Printing Break|6|Yes |Yes|All objects| +|On Printing Detail|23|Yes|Yes |All objects| +|On Printing Footer|7|Yes |Yes|All objects| +|On Resize|29|Never|Yes|None| +|On Row Moved|34|Yes (List box)|Never|Involved object only| +|On Row Resize|60|Yes (4D View Pro Area)|Never|Involved object only| +|On Scroll|59|Yes|Never|Involved object only| +|On Selection Change|31|Yes|Yes|Involved object only| +|On Timer|27|Never|Yes|None| +|On Unload|24|Yes|Yes|All objects| +|On URL Filtering|51|Yes (Web Area)|Never|Involved object only| +|On URL Loading Error|50|Yes (Web Area)|Never|Involved object only| +|On URL Resource Loading|48|Yes (Web Area)|Never|Involved object only| +|On Validate|3|Yes|Yes|All objects| +|On VP Range Changed|61|Yes (4D View Pro Area)|Never|Involved object only| +|On VP Ready|9|Yes (4D View Pro Area)|Never|Involved object only| +|On Window Opening Denied|53|Yes (Web Area)|Never|Involved object only| Always keep in mind that, for any event, the method of a form or an object is called if the corresponding event property is selected for the form or objects. The benefit of disabling events in the Design environment (using the Property List of the Form editor) is that you can reduce the number of calls to methods and therefore significantly optimize the execution speed of your forms. > WARNING: The [On Load](onLoad.md) and [On Unload](onUnload.md) events are generated for objects if they are enabled for both the objects and the form to which the objects belong. If the events are enabled for objects only, they will not occur; these two events must also be enabled at the form level. + diff --git a/versioned_docs/version-21-R3/Events/overview.md b/versioned_docs/version-21-R3/Events/overview.md index 462bf67efa6a2d..3dedf933bc4874 100644 --- a/versioned_docs/version-21-R3/Events/overview.md +++ b/versioned_docs/version-21-R3/Events/overview.md @@ -50,68 +50,68 @@ The number of objects involved in an event depends on the nature of the event. The following table summarizes how object and form methods are called for each event type: -|Event|Object Methods|Form Method|Which Objects| -|---|---|----|---| -|On Load|Yes|Yes|All objects| -|On Unload|Yes|Yes|All objects| -|On Validate|Yes|Yes|All objects| -|On Clicked|Yes |Yes|Involved object only| -|On Double Clicked|Yes|Yes|Involved object only| -|On Before Keystroke|Yes|Yes|Involved object only| -|On After Keystroke|Yes|Yes|Involved object only| -|On After Edit|Yes|Yes|Involved object only| -|On Getting Focus|Yes|Yes|Involved object only| -|On Losing Focus|Yes|Yes|Involved object only| -|On Activate|Never|Yes|None| -|On Deactivate|Never|Yes|None| -|On Outside Call|Never|Yes|None| -|On Page Change|Never|Yes|None| -|On Begin Drag Over|Yes|Yes|Involved object only| -|On Drop|Yes|Yes|Involved object only| -|On Drag Over|Yes|Never |Involved object only| -|On Mouse Enter|Yes|Yes|All objects| -|On Mouse Move|Yes|Yes|All objects| -|On Mouse Leave|Yes|Yes|All objects| -|On Mouse Up|Yes|Never|Involved object only| -|On Menu Selected|Never|Yes|None| -|On Bound variable change|Never|Yes|None| -|On Data Change|Yes|Yes|Involved object only| -|On Plug in Area|Yes|Yes|Involved object only| -|On Header|Yes|Yes|All objects| -|On Printing Detail|Yes|Yes |All objects| -|On Printing Break|Yes |Yes|All objects| -|On Printing Footer|Yes |Yes|All objects| -|On Close Box|Never|Yes |None| -|On Display Detail|Yes|Yes|All objects| -|On Open Detail|Yes (List box)|Yes|None except List boxes| -|On Close Detail|Yes (List box)|Yes|None except List boxes| -|On Resize|Never|Yes|None| -|On Selection Change|Yes|Yes|Involved object only| -|On Load Record|Never|Yes|None| -|On Timer|Never|Yes|None| -|On Scroll|Yes|Never|Involved object only| -|On Before Data Entry|Yes (List box)|Never|Involved object only| -|On Column Moved|Yes (List box)|Never|Involved object only| -|On Row Moved|Yes (List box)|Never|Involved object only| -|On Column Resize|Yes (List box and 4D View Pro Area)| Never|Involved object only| -|On Header Click|Yes (List box and 4D View Pro Area)|Never|Involved object only| -|On Footer Click|Yes (List box)|Never|Involved object only| -|On After Sort|Yes (List box)|Never|Involved object only| -|On Long Click|Yes (Button)|Yes|Involved object only| -|On Alternative Click|Yes (Button and List box)|Never| Involved object only| -|On Expand|Yes (Hier. list and list box)|Never|Involved object only| -|On Collapse|Yes (Hier. list and list box)|Never|Involved object only| -|On Delete Action|Yes (Hier. list and list box)|Never|Involved object only| -|On URL Resource Loading|Yes (Web Area)|Never|Involved object only| -|On Begin URL Loading|Yes (Web Area)|Never|Involved object only| -|On URL Loading Error|Yes (Web Area)|Never|Involved object only| -|On URL Filtering|Yes (Web Area)|Never|Involved object only| -|On End URL Loading|Yes (Web Area)|Never|Involved object only| -|On Open External Link|Yes (Web Area)|Never|Involved object only| -|On Window Opening Denied|Yes (Web Area)|Never|Involved object only| -|On VP Range Changed|Yes (4D View Pro Area)|Never|Involved object only| -|On VP Ready|Yes (4D View Pro Area)|Never|Involved object only| -|On Row Resize|Yes (4D View Pro Area)|Never|Involved object only| +|Event|Code|Object Methods|Form Method|Which Objects| +|---|---|---|----|---| +|On Activate|11|Never|Yes|None| +|On After Edit|45|Yes|Yes|Involved object only| +|On After Keystroke|28|Yes|Yes|Involved object only| +|On After Sort|30|Yes (List box)|Never|Involved object only| +|On Alternative Click|38|Yes (Button and List box)|Never| Involved object only| +|On Before Data Entry|41|Yes (List box)|Never|Involved object only| +|On Before Keystroke|17|Yes|Yes|Involved object only| +|On Begin Drag Over|46|Yes|Yes|Involved object only| +|On Begin URL Loading|47|Yes (Web Area)|Never|Involved object only| +|On Bound variable change|54|Never|Yes|None| +|On Clicked|4|Yes |Yes|Involved object only| +|On Close Box|22|Never|Yes |None| +|On Close Detail|26|Yes (List box)|Yes|None except List boxes| +|On Collapse|44|Yes (Hier. list and list box)|Never|Involved object only| +|On Column Moved|32|Yes (List box)|Never|Involved object only| +|On Column Resize|33|Yes (List box and 4D View Pro Area)| Never|Involved object only| +|On Data Change|20|Yes|Yes|Involved object only| +|On Deactivate|12|Never|Yes|None| +|On Delete Action|58|Yes (Hier. list and list box)|Never|Involved object only| +|On Display Detail|8|Yes|Yes|All objects| +|On Double Clicked|13|Yes|Yes|Involved object only| +|On Drag Over|21|Yes|Never |Involved object only| +|On Drop|16|Yes|Yes|Involved object only| +|On End URL Loading|49|Yes (Web Area)|Never|Involved object only| +|On Expand|43|Yes (Hier. list and list box)|Never|Involved object only| +|On Footer Click|57|Yes (List box)|Never|Involved object only| +|On Getting Focus|15|Yes|Yes|Involved object only| +|On Header|5|Yes|Yes|All objects| +|On Header Click|42|Yes (List box and 4D View Pro Area)|Never|Involved object only| +|On Load|1|Yes|Yes|All objects| +|On Load Record|40|Never|Yes|None| +|On Long Click|39|Yes (Button)|Yes|Involved object only| +|On Losing Focus|14|Yes|Yes|Involved object only| +|On Menu Selected|18|Never|Yes|None| +|On Mouse Enter|35|Yes|Yes|All objects| +|On Mouse Leave|36|Yes|Yes|All objects| +|On Mouse Move|37|Yes|Yes|All objects| +|On Mouse Up|2|Yes|Never|Involved object only| +|On Open Detail|25|Yes (List box)|Yes|None except List boxes| +|On Open External Link|52|Yes (Web Area)|Never|Involved object only| +|On Outside Call|10|Never|Yes|None| +|On Page Change|56|Never|Yes|None| +|On Plug in Area|19|Yes|Yes|Involved object only| +|On Printing Break|6|Yes |Yes|All objects| +|On Printing Detail|23|Yes|Yes |All objects| +|On Printing Footer|7|Yes |Yes|All objects| +|On Resize|29|Never|Yes|None| +|On Row Moved|34|Yes (List box)|Never|Involved object only| +|On Row Resize|60|Yes (4D View Pro Area)|Never|Involved object only| +|On Scroll|59|Yes|Never|Involved object only| +|On Selection Change|31|Yes|Yes|Involved object only| +|On Timer|27|Never|Yes|None| +|On Unload|24|Yes|Yes|All objects| +|On URL Filtering|51|Yes (Web Area)|Never|Involved object only| +|On URL Loading Error|50|Yes (Web Area)|Never|Involved object only| +|On URL Resource Loading|48|Yes (Web Area)|Never|Involved object only| +|On Validate|3|Yes|Yes|All objects| +|On VP Range Changed|61|Yes (4D View Pro Area)|Never|Involved object only| +|On VP Ready|9|Yes (4D View Pro Area)|Never|Involved object only| +|On Window Opening Denied|53|Yes (Web Area)|Never|Involved object only| Always keep in mind that, for any event, the method of a form or an object is called if the corresponding event property is selected for the form or objects. The benefit of disabling events in the Design environment (using the Property List of the Form editor) is that you can reduce the number of calls to methods and therefore significantly optimize the execution speed of your forms. diff --git a/versioned_docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md b/versioned_docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md index fa69aacdaf91ca..b9825ffdb16267 100644 --- a/versioned_docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md +++ b/versioned_docs/version-21-R3/language-legacy/File and Folder/zip-create-archive.md @@ -50,8 +50,8 @@ You can pass a 4D.File, a 4D.Folder, or a zip structure object as first paramete |Property|Type|Description| |---|---|---| |compression|Integer|
  • `ZIP Compression standard`: Deflate compression (default)
  • `ZIP Compression LZMA`: LZMA compression
  • `ZIP Compression XZ`: XZ compression
  • `ZIP Compression none`: No compression
    • | -|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -|encryption|Integer|The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +|encryption|Integer|The encryption to use if a password is set:
    • `ZIP Encryption AES128`: AES encryption using 128-bit key.
    • `ZIP Encryption AES192`: AES encryption using 192-bit key.
    • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
    • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    | |password|Text|A password to use if encryption is required.| |files|Collection|
  • a collection of `4D.File` or `4D.Folder` objects or
  • a collection of objects with the following properties:
    • PropertyTypeDescription
    source4D.File or 4D.FolderFile or Folder
    destinationText(optional) - Specify a relative filepath to change the organization of the contents of the archive
    optionnumber(optional) - `ZIP Ignore invisible files` or 0 to compress all of the file
    | |callback|4D.Function|A callback formula that will receive the compression progress (0 - 100) in $1.| diff --git a/versioned_docs/version-21-R4/Events/overview.md b/versioned_docs/version-21-R4/Events/overview.md index 462bf67efa6a2d..3dedf933bc4874 100644 --- a/versioned_docs/version-21-R4/Events/overview.md +++ b/versioned_docs/version-21-R4/Events/overview.md @@ -50,68 +50,68 @@ The number of objects involved in an event depends on the nature of the event. The following table summarizes how object and form methods are called for each event type: -|Event|Object Methods|Form Method|Which Objects| -|---|---|----|---| -|On Load|Yes|Yes|All objects| -|On Unload|Yes|Yes|All objects| -|On Validate|Yes|Yes|All objects| -|On Clicked|Yes |Yes|Involved object only| -|On Double Clicked|Yes|Yes|Involved object only| -|On Before Keystroke|Yes|Yes|Involved object only| -|On After Keystroke|Yes|Yes|Involved object only| -|On After Edit|Yes|Yes|Involved object only| -|On Getting Focus|Yes|Yes|Involved object only| -|On Losing Focus|Yes|Yes|Involved object only| -|On Activate|Never|Yes|None| -|On Deactivate|Never|Yes|None| -|On Outside Call|Never|Yes|None| -|On Page Change|Never|Yes|None| -|On Begin Drag Over|Yes|Yes|Involved object only| -|On Drop|Yes|Yes|Involved object only| -|On Drag Over|Yes|Never |Involved object only| -|On Mouse Enter|Yes|Yes|All objects| -|On Mouse Move|Yes|Yes|All objects| -|On Mouse Leave|Yes|Yes|All objects| -|On Mouse Up|Yes|Never|Involved object only| -|On Menu Selected|Never|Yes|None| -|On Bound variable change|Never|Yes|None| -|On Data Change|Yes|Yes|Involved object only| -|On Plug in Area|Yes|Yes|Involved object only| -|On Header|Yes|Yes|All objects| -|On Printing Detail|Yes|Yes |All objects| -|On Printing Break|Yes |Yes|All objects| -|On Printing Footer|Yes |Yes|All objects| -|On Close Box|Never|Yes |None| -|On Display Detail|Yes|Yes|All objects| -|On Open Detail|Yes (List box)|Yes|None except List boxes| -|On Close Detail|Yes (List box)|Yes|None except List boxes| -|On Resize|Never|Yes|None| -|On Selection Change|Yes|Yes|Involved object only| -|On Load Record|Never|Yes|None| -|On Timer|Never|Yes|None| -|On Scroll|Yes|Never|Involved object only| -|On Before Data Entry|Yes (List box)|Never|Involved object only| -|On Column Moved|Yes (List box)|Never|Involved object only| -|On Row Moved|Yes (List box)|Never|Involved object only| -|On Column Resize|Yes (List box and 4D View Pro Area)| Never|Involved object only| -|On Header Click|Yes (List box and 4D View Pro Area)|Never|Involved object only| -|On Footer Click|Yes (List box)|Never|Involved object only| -|On After Sort|Yes (List box)|Never|Involved object only| -|On Long Click|Yes (Button)|Yes|Involved object only| -|On Alternative Click|Yes (Button and List box)|Never| Involved object only| -|On Expand|Yes (Hier. list and list box)|Never|Involved object only| -|On Collapse|Yes (Hier. list and list box)|Never|Involved object only| -|On Delete Action|Yes (Hier. list and list box)|Never|Involved object only| -|On URL Resource Loading|Yes (Web Area)|Never|Involved object only| -|On Begin URL Loading|Yes (Web Area)|Never|Involved object only| -|On URL Loading Error|Yes (Web Area)|Never|Involved object only| -|On URL Filtering|Yes (Web Area)|Never|Involved object only| -|On End URL Loading|Yes (Web Area)|Never|Involved object only| -|On Open External Link|Yes (Web Area)|Never|Involved object only| -|On Window Opening Denied|Yes (Web Area)|Never|Involved object only| -|On VP Range Changed|Yes (4D View Pro Area)|Never|Involved object only| -|On VP Ready|Yes (4D View Pro Area)|Never|Involved object only| -|On Row Resize|Yes (4D View Pro Area)|Never|Involved object only| +|Event|Code|Object Methods|Form Method|Which Objects| +|---|---|---|----|---| +|On Activate|11|Never|Yes|None| +|On After Edit|45|Yes|Yes|Involved object only| +|On After Keystroke|28|Yes|Yes|Involved object only| +|On After Sort|30|Yes (List box)|Never|Involved object only| +|On Alternative Click|38|Yes (Button and List box)|Never| Involved object only| +|On Before Data Entry|41|Yes (List box)|Never|Involved object only| +|On Before Keystroke|17|Yes|Yes|Involved object only| +|On Begin Drag Over|46|Yes|Yes|Involved object only| +|On Begin URL Loading|47|Yes (Web Area)|Never|Involved object only| +|On Bound variable change|54|Never|Yes|None| +|On Clicked|4|Yes |Yes|Involved object only| +|On Close Box|22|Never|Yes |None| +|On Close Detail|26|Yes (List box)|Yes|None except List boxes| +|On Collapse|44|Yes (Hier. list and list box)|Never|Involved object only| +|On Column Moved|32|Yes (List box)|Never|Involved object only| +|On Column Resize|33|Yes (List box and 4D View Pro Area)| Never|Involved object only| +|On Data Change|20|Yes|Yes|Involved object only| +|On Deactivate|12|Never|Yes|None| +|On Delete Action|58|Yes (Hier. list and list box)|Never|Involved object only| +|On Display Detail|8|Yes|Yes|All objects| +|On Double Clicked|13|Yes|Yes|Involved object only| +|On Drag Over|21|Yes|Never |Involved object only| +|On Drop|16|Yes|Yes|Involved object only| +|On End URL Loading|49|Yes (Web Area)|Never|Involved object only| +|On Expand|43|Yes (Hier. list and list box)|Never|Involved object only| +|On Footer Click|57|Yes (List box)|Never|Involved object only| +|On Getting Focus|15|Yes|Yes|Involved object only| +|On Header|5|Yes|Yes|All objects| +|On Header Click|42|Yes (List box and 4D View Pro Area)|Never|Involved object only| +|On Load|1|Yes|Yes|All objects| +|On Load Record|40|Never|Yes|None| +|On Long Click|39|Yes (Button)|Yes|Involved object only| +|On Losing Focus|14|Yes|Yes|Involved object only| +|On Menu Selected|18|Never|Yes|None| +|On Mouse Enter|35|Yes|Yes|All objects| +|On Mouse Leave|36|Yes|Yes|All objects| +|On Mouse Move|37|Yes|Yes|All objects| +|On Mouse Up|2|Yes|Never|Involved object only| +|On Open Detail|25|Yes (List box)|Yes|None except List boxes| +|On Open External Link|52|Yes (Web Area)|Never|Involved object only| +|On Outside Call|10|Never|Yes|None| +|On Page Change|56|Never|Yes|None| +|On Plug in Area|19|Yes|Yes|Involved object only| +|On Printing Break|6|Yes |Yes|All objects| +|On Printing Detail|23|Yes|Yes |All objects| +|On Printing Footer|7|Yes |Yes|All objects| +|On Resize|29|Never|Yes|None| +|On Row Moved|34|Yes (List box)|Never|Involved object only| +|On Row Resize|60|Yes (4D View Pro Area)|Never|Involved object only| +|On Scroll|59|Yes|Never|Involved object only| +|On Selection Change|31|Yes|Yes|Involved object only| +|On Timer|27|Never|Yes|None| +|On Unload|24|Yes|Yes|All objects| +|On URL Filtering|51|Yes (Web Area)|Never|Involved object only| +|On URL Loading Error|50|Yes (Web Area)|Never|Involved object only| +|On URL Resource Loading|48|Yes (Web Area)|Never|Involved object only| +|On Validate|3|Yes|Yes|All objects| +|On VP Range Changed|61|Yes (4D View Pro Area)|Never|Involved object only| +|On VP Ready|9|Yes (4D View Pro Area)|Never|Involved object only| +|On Window Opening Denied|53|Yes (Web Area)|Never|Involved object only| Always keep in mind that, for any event, the method of a form or an object is called if the corresponding event property is selected for the form or objects. The benefit of disabling events in the Design environment (using the Property List of the Form editor) is that you can reduce the number of calls to methods and therefore significantly optimize the execution speed of your forms. diff --git a/versioned_docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md b/versioned_docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md index fa69aacdaf91ca..b9825ffdb16267 100644 --- a/versioned_docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md +++ b/versioned_docs/version-21-R4/language-legacy/File and Folder/zip-create-archive.md @@ -50,8 +50,8 @@ You can pass a 4D.File, a 4D.Folder, or a zip structure object as first paramete |Property|Type|Description| |---|---|---| |compression|Integer|
  • `ZIP Compression standard`: Deflate compression (default)
  • `ZIP Compression LZMA`: LZMA compression
  • `ZIP Compression XZ`: XZ compression
  • `ZIP Compression none`: No compression
    • | -|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -|encryption|Integer|The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +|encryption|Integer|The encryption to use if a password is set:
    • `ZIP Encryption AES128`: AES encryption using 128-bit key.
    • `ZIP Encryption AES192`: AES encryption using 192-bit key.
    • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
    • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    | |password|Text|A password to use if encryption is required.| |files|Collection|
  • a collection of `4D.File` or `4D.Folder` objects or
  • a collection of objects with the following properties:
    • PropertyTypeDescription
    source4D.File or 4D.FolderFile or Folder
    destinationText(optional) - Specify a relative filepath to change the organization of the contents of the archive
    optionnumber(optional) - `ZIP Ignore invisible files` or 0 to compress all of the file
    | |callback|4D.Function|A callback formula that will receive the compression progress (0 - 100) in $1.| diff --git a/versioned_docs/version-21/Events/overview.md b/versioned_docs/version-21/Events/overview.md index 00a2ab310ca2b5..3dedf933bc4874 100644 --- a/versioned_docs/version-21/Events/overview.md +++ b/versioned_docs/version-21/Events/overview.md @@ -5,7 +5,7 @@ title: Form Events Form events are events that can lead to the execution of the form method and/or form object method(s). Form events allow you to control the flow of your application and to write code that is executed only when a specific event occurs. -In your code, you control the events using the [`FORM Event`](../commands/form-event.md) command, that returns the triggered event. For example: +In your code, you control the events using the [`FORM Event`](../commands/form-event) command, that returns the triggered event. For example: ```4d //code of a button @@ -19,7 +19,7 @@ End if ## Event object -Each event is returned as an object by the [`FORM Event`](../commands/form-event.md) command. By default, it contains the following properties: +Each event is returned as an object by the [`FORM Event`](../commands/form-event) command. By default, it contains the following properties: |Property|Type|Description| |---|---|---| @@ -50,70 +50,71 @@ The number of objects involved in an event depends on the nature of the event. The following table summarizes how object and form methods are called for each event type: -|Event|Object Methods|Form Method|Which Objects| -|---|---|----|---| -|On Load|Yes|Yes|All objects| -|On Unload|Yes|Yes|All objects| -|On Validate|Yes|Yes|All objects| -|On Clicked|Yes |Yes|Involved object only| -|On Double Clicked|Yes|Yes|Involved object only| -|On Before Keystroke|Yes|Yes|Involved object only| -|On After Keystroke|Yes|Yes|Involved object only| -|On After Edit|Yes|Yes|Involved object only| -|On Getting Focus|Yes|Yes|Involved object only| -|On Losing Focus|Yes|Yes|Involved object only| -|On Activate|Never|Yes|None| -|On Deactivate|Never|Yes|None| -|On Outside Call|Never|Yes|None| -|On Page Change|Never|Yes|None| -|On Begin Drag Over|Yes|Yes|Involved object only| -|On Drop|Yes|Yes|Involved object only| -|On Drag Over|Yes|Never |Involved object only| -|On Mouse Enter|Yes|Yes|All objects| -|On Mouse Move|Yes|Yes|All objects| -|On Mouse Leave|Yes|Yes|All objects| -|On Mouse Up|Yes|Never|Involved object only| -|On Menu Selected|Never|Yes|None| -|On Bound variable change|Never|Yes|None| -|On Data Change|Yes|Yes|Involved object only| -|On Plug in Area|Yes|Yes|Involved object only| -|On Header|Yes|Yes|All objects| -|On Printing Detail|Yes|Yes |All objects| -|On Printing Break|Yes |Yes|All objects| -|On Printing Footer|Yes |Yes|All objects| -|On Close Box|Never|Yes |None| -|On Display Detail|Yes|Yes|All objects| -|On Open Detail|Yes (List box)|Yes|None except List boxes| -|On Close Detail|Yes (List box)|Yes|None except List boxes| -|On Resize|Never|Yes|None| -|On Selection Change|Yes|Yes|Involved object only| -|On Load Record|Never|Yes|None| -|On Timer|Never|Yes|None| -|On Scroll|Yes|Never|Involved object only| -|On Before Data Entry|Yes (List box)|Never|Involved object only| -|On Column Moved|Yes (List box)|Never|Involved object only| -|On Row Moved|Yes (List box)|Never|Involved object only| -|On Column Resize|Yes (List box and 4D View Pro Area)| Never|Involved object only| -|On Header Click|Yes (List box and 4D View Pro Area)|Never|Involved object only| -|On Footer Click|Yes (List box)|Never|Involved object only| -|On After Sort|Yes (List box)|Never|Involved object only| -|On Long Click|Yes (Button)|Yes|Involved object only| -|On Alternative Click|Yes (Button and List box)|Never| Involved object only| -|On Expand|Yes (Hier. list and list box)|Never|Involved object only| -|On Collapse|Yes (Hier. list and list box)|Never|Involved object only| -|On Delete Action|Yes (Hier. list and list box)|Never|Involved object only| -|On URL Resource Loading|Yes (Web Area)|Never|Involved object only| -|On Begin URL Loading|Yes (Web Area)|Never|Involved object only| -|On URL Loading Error|Yes (Web Area)|Never|Involved object only| -|On URL Filtering|Yes (Web Area)|Never|Involved object only| -|On End URL Loading|Yes (Web Area)|Never|Involved object only| -|On Open External Link|Yes (Web Area)|Never|Involved object only| -|On Window Opening Denied|Yes (Web Area)|Never|Involved object only| -|On VP Range Changed|Yes (4D View Pro Area)|Never|Involved object only| -|On VP Ready|Yes (4D View Pro Area)|Never|Involved object only| -|On Row Resize|Yes (4D View Pro Area)|Never|Involved object only| +|Event|Code|Object Methods|Form Method|Which Objects| +|---|---|---|----|---| +|On Activate|11|Never|Yes|None| +|On After Edit|45|Yes|Yes|Involved object only| +|On After Keystroke|28|Yes|Yes|Involved object only| +|On After Sort|30|Yes (List box)|Never|Involved object only| +|On Alternative Click|38|Yes (Button and List box)|Never| Involved object only| +|On Before Data Entry|41|Yes (List box)|Never|Involved object only| +|On Before Keystroke|17|Yes|Yes|Involved object only| +|On Begin Drag Over|46|Yes|Yes|Involved object only| +|On Begin URL Loading|47|Yes (Web Area)|Never|Involved object only| +|On Bound variable change|54|Never|Yes|None| +|On Clicked|4|Yes |Yes|Involved object only| +|On Close Box|22|Never|Yes |None| +|On Close Detail|26|Yes (List box)|Yes|None except List boxes| +|On Collapse|44|Yes (Hier. list and list box)|Never|Involved object only| +|On Column Moved|32|Yes (List box)|Never|Involved object only| +|On Column Resize|33|Yes (List box and 4D View Pro Area)| Never|Involved object only| +|On Data Change|20|Yes|Yes|Involved object only| +|On Deactivate|12|Never|Yes|None| +|On Delete Action|58|Yes (Hier. list and list box)|Never|Involved object only| +|On Display Detail|8|Yes|Yes|All objects| +|On Double Clicked|13|Yes|Yes|Involved object only| +|On Drag Over|21|Yes|Never |Involved object only| +|On Drop|16|Yes|Yes|Involved object only| +|On End URL Loading|49|Yes (Web Area)|Never|Involved object only| +|On Expand|43|Yes (Hier. list and list box)|Never|Involved object only| +|On Footer Click|57|Yes (List box)|Never|Involved object only| +|On Getting Focus|15|Yes|Yes|Involved object only| +|On Header|5|Yes|Yes|All objects| +|On Header Click|42|Yes (List box and 4D View Pro Area)|Never|Involved object only| +|On Load|1|Yes|Yes|All objects| +|On Load Record|40|Never|Yes|None| +|On Long Click|39|Yes (Button)|Yes|Involved object only| +|On Losing Focus|14|Yes|Yes|Involved object only| +|On Menu Selected|18|Never|Yes|None| +|On Mouse Enter|35|Yes|Yes|All objects| +|On Mouse Leave|36|Yes|Yes|All objects| +|On Mouse Move|37|Yes|Yes|All objects| +|On Mouse Up|2|Yes|Never|Involved object only| +|On Open Detail|25|Yes (List box)|Yes|None except List boxes| +|On Open External Link|52|Yes (Web Area)|Never|Involved object only| +|On Outside Call|10|Never|Yes|None| +|On Page Change|56|Never|Yes|None| +|On Plug in Area|19|Yes|Yes|Involved object only| +|On Printing Break|6|Yes |Yes|All objects| +|On Printing Detail|23|Yes|Yes |All objects| +|On Printing Footer|7|Yes |Yes|All objects| +|On Resize|29|Never|Yes|None| +|On Row Moved|34|Yes (List box)|Never|Involved object only| +|On Row Resize|60|Yes (4D View Pro Area)|Never|Involved object only| +|On Scroll|59|Yes|Never|Involved object only| +|On Selection Change|31|Yes|Yes|Involved object only| +|On Timer|27|Never|Yes|None| +|On Unload|24|Yes|Yes|All objects| +|On URL Filtering|51|Yes (Web Area)|Never|Involved object only| +|On URL Loading Error|50|Yes (Web Area)|Never|Involved object only| +|On URL Resource Loading|48|Yes (Web Area)|Never|Involved object only| +|On Validate|3|Yes|Yes|All objects| +|On VP Range Changed|61|Yes (4D View Pro Area)|Never|Involved object only| +|On VP Ready|9|Yes (4D View Pro Area)|Never|Involved object only| +|On Window Opening Denied|53|Yes (Web Area)|Never|Involved object only| Always keep in mind that, for any event, the method of a form or an object is called if the corresponding event property is selected for the form or objects. The benefit of disabling events in the Design environment (using the Property List of the Form editor) is that you can reduce the number of calls to methods and therefore significantly optimize the execution speed of your forms. > WARNING: The [On Load](onLoad.md) and [On Unload](onUnload.md) events are generated for objects if they are enabled for both the objects and the form to which the objects belong. If the events are enabled for objects only, they will not occur; these two events must also be enabled at the form level. + diff --git a/versioned_docs/version-21/commands/zip-create-archive.md b/versioned_docs/version-21/commands/zip-create-archive.md index e7dd59a187ded3..b6768856a4d823 100644 --- a/versioned_docs/version-21/commands/zip-create-archive.md +++ b/versioned_docs/version-21/commands/zip-create-archive.md @@ -49,8 +49,8 @@ You can pass a 4D.File, a 4D.Folder, or a zip structure object as first paramete |Property|Type|Description| |---|---|---| |compression|Integer|
  • `ZIP Compression standard`: Deflate compression (default)
  • `ZIP Compression LZMA`: LZMA compression
  • `ZIP Compression XZ`: XZ compression
  • `ZIP Compression none`: No compression
    • | -|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted:
  • `ZIP Compression standard`: 6
  • `ZIP Compression LZMA`: 4
  • `ZIP Compression XZ`: 4
    • | -|encryption|Integer|The encryption to use if a password is set:
  • `ZIP Encryption AES128`: AES encryption using 128-bit key.
  • `ZIP Encryption AES192`: AES encryption using 192-bit key.
  • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
  • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    • | +|level|Integer|Compression level. Possible values: 1 to 10. A lower value will produce a larger file, while a higher value will produce a smaller file. Compression level has however an impact on performance. Default values if omitted:
    • `ZIP Compression standard`: 6
    • `ZIP Compression LZMA`: 4
    • `ZIP Compression XZ`: 4
    | +|encryption|Integer|The encryption to use if a password is set:
    • `ZIP Encryption AES128`: AES encryption using 128-bit key.
    • `ZIP Encryption AES192`: AES encryption using 192-bit key.
    • `ZIP Encryption AES256`: AES encryption using 256-bit key (default if password is set).
    • `ZIP Encryption none`: Data is not encrypted (default if no password is set)
    | |password|Text|A password to use if encryption is required.| |files|Collection|
  • a collection of `4D.File` or `4D.Folder` objects or
  • a collection of objects with the following properties:
    • PropertyTypeDescription
    source4D.File or 4D.FolderFile or Folder
    destinationText(optional) - Specify a relative filepath to change the organization of the contents of the archive
    optionnumber(optional) - `ZIP Ignore invisible files` or 0 to compress all of the file
    | |callback|4D.Function|A callback formula that will receive the compression progress (0 - 100) in $1.|