diff --git a/i18n/es/code.json b/i18n/es/code.json index d7fd93b090ac10..903807b9b373f6 100644 --- a/i18n/es/code.json +++ b/i18n/es/code.json @@ -880,6 +880,6 @@ "message": "4D Analyzer" }, "theme.docs.versionDropdown.notAvailable": { - "message": "Page not available in this version\nOpening the default page instead" + "message": "La página no está disponible en esta versión\nEn su lugar, se abrirá la página predeterminada." } } diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/DataClassClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/DataClassClass.md index 6b89b12ce60412..975414df3d05f5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/DataClassClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/DataClassClass.md @@ -276,7 +276,7 @@ Para cada objeto de *objectCol*: - Si no se da la llave primaria, se crea la entidad y se asigna el valor de la llave primaria con respecto a las reglas estándar de la base de datos. - Si el objeto contiene una propiedad booleana "\_\_NEW" definida como **true**, la entidad se crea con los valores correspondientes de los atributos del objeto. Se realiza una verificación con respecto a la llave primaria: - Si se da la llave primaria (tal cual) y existe, se envía un error - - If the primary key is given (as is) and does not exist, the entity is created + - Si se da la llave primaria (tal cual) y no existe, se crea la entidad - Si no se da la primaria, se crea la entidad y se asigna el valor de la llave primaria con respecto a las reglas estándar de la base de datos. > La propiedad "\__KEY" que contiene un valor sólo se tiene en cuenta cuando la propiedad "\__NEW" tiene el valor **false** (o se omite) y existe una entidad correspondiente. The use of a \_\_KEY property allows independence from the primary key attribute name. @@ -1257,7 +1257,7 @@ var $results := ds.MyClass.query("myVectorField > :1 order by myVectorField desc You will generally want vector similarity query results to be sorted from "most similar" to "least similar." Por defecto, los resultados devueltos con una cláusula **order by** se ordenan en orden ascendente. Depending on the similarity metric used, you may need to adjust the sorting direction to obtain the correct ranking: -- for [**cosine**](./VectorClass.md#cosinesimilarity) and [**dot**](./VectorClass.md#dotsimilarity) similarity, higher values indicate greater similarity. Therefore, you will typically need to include the `desc` keyword in the query string. +- for [**cosine**](./VectorClass.md#cosinesimilarity) and [**dot**](./VectorClass.md#dotsimilarity) similarity, higher values indicate greater similarity. Por lo tanto, normalmente deberá incluir la palabra clave `desc` en la cadena de consulta. - for [**euclidean distance**](./VectorClass.md#euclideandistance) similarity, lower values indicate greater similarity. In this case, the default ascending order (or explicitly using the `asc` keyword) is appropriate. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/Directory.md b/i18n/es/docusaurus-plugin-content-docs/current/API/Directory.md index 7cb86982579008..2f940b4cc1b3c1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/Directory.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/Directory.md @@ -556,7 +556,7 @@ La función `.files()` devuelve una colec > Los alias o enlaces simbólicos no se resuelven. -Por defecto, si se omite el parámetro *options*, sólo se devuelven en la colección los archivos del primer nivel de la carpeta, así como los archivos o carpetas invisibles. Puede modificar esto pasando, en el parámetro *options*, una o varias de las siguientes constantes: +By default, if you omit the *options* parameter, only the files at the first level of the folder are returned in the collection, including invisible files. Puede modificar esto pasando, en el parámetro *options*, una o varias de las siguientes constantes: | Constante | Valor | Comentario | | --------------------- | ----- | ------------------------------------------------------------------------------- | diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/QuotaManagerClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/QuotaManagerClass.md index ea688996e61c5f..add929483a698b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/QuotaManagerClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/QuotaManagerClass.md @@ -54,11 +54,11 @@ You can change this value dynamically using the [`quotas.defaultEntitySetTimeout :::note -If you define a value higher than the `maxEntitySetTimeout` property value, it will be aligned with the `maxEntitySetTimeout` value. +Si se define un valor superior al de la propiedad `maxEntitySetTimeout`, dicho valor se ajustará al de `maxEntitySetTimeout`. ::: -You cannot pass a value <=0 (an error is generated in this case). To reset the property value for the session, pass *undefined*. +No se puede pasar un valor <=0 (en ese caso se produce un error). Para restablecer el valor de la propiedad para la sesión, pase *undefined*. #### Ejemplo @@ -92,7 +92,7 @@ http://127.0.0.1/rest/People?$filter=ID>=4&$method=entityset&$timeout=3000 ... then the timeout defined in the request is ignored and the entity set will be released after 40 minutes if not used during this period of time. -You cannot pass a value <=0 (an error is generated in this case). To reset the property value for the session, pass *undefined*. +No se puede pasar un valor <=0 (en ese caso se produce un error). Para restablecer el valor de la propiedad para la sesión, pase *undefined*. #### Ejemplo @@ -114,11 +114,11 @@ Session.quotas.maxEntitySetTimeout:=2400 The `.nbEntitySets` property contains the maximum number of REST entity sets allowed in memory for the current session (in seconds). -By default, there is no limit for entity sets [stored in memory by REST requests](../REST/$info.md) (the value is 0). You can set a limit to control the server payload for a specific session. +By default, there is no limit for entity sets [stored in memory by REST requests](../REST/$info.md) (the value is 0). Puede definir un límite para controlar la carga útil del servidor para una sesión específica. When the maximum number of allowed entity sets is reached, a REST request that need to create an entity set will get a [**429** HTTP status code and an error response](../REST/REST_requests.md#rest-status-and-response), until at least one entity set is released. You can release an entity set from the cache using the [`$release` REST command](../REST/$entityset.md#entitysetrelease). -You cannot pass a value <=0 (an error is generated in this case). To reset the property value for the session, pass *undefined*. +No se puede pasar un valor <=0 (en ese caso se produce un error). Para restablecer el valor de la propiedad para la sesión, pase *undefined*. #### Ejemplo diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md index ccef3a7828ea80..d25dbe84499aa9 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/SessionClass.md @@ -694,11 +694,11 @@ End if #### Descripción -La propiedad `.quotas` contiene un objeto `4D.QuotaManager` con los valores actuales y los valores establecidos para los umbrales del servidor en la sesión actual. Los límites del servidor se utilizan para controlar las solicitudes dirigidas al servidor y ayudan a evitar un uso excesivo de los recursos (ver la clase [`4D.QuotaManager`](./QuotaManagerClass.md)). +The `.quotas` property contains a `4D.QuotaManager` object with current values and set values for server thresholds regarding REST requests in the current session. Los límites del servidor se utilizan para controlar las solicitudes dirigidas al servidor y ayudan a evitar un uso excesivo de los recursos (ver la clase [`4D.QuotaManager`](./QuotaManagerClass.md)). Esta propiedad es **solo lectura**. -The following properties of the `4D.QuotaManager` object are available for the session: +Las siguientes propiedades del objeto `4D.QuotaManager` están disponibles para la sesión: | Propiedad | | Tipo | Writable | Descripción | | ------------------------------------------------------------------------- | ------------ | ------- | -------- | -------------------------------------------------------------------------------------------------------------- | diff --git a/i18n/es/docusaurus-plugin-content-docs/current/API/SignalClass.md b/i18n/es/docusaurus-plugin-content-docs/current/API/SignalClass.md index 5e283cc0939498..e95133505eb660 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/API/SignalClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/API/SignalClass.md @@ -5,18 +5,15 @@ title: Signal Las señales son herramientas que ofrece el lenguaje 4D para gestionar las interacciones y evitar conflictos entre procesos en una aplicación multiproceso. Las señales le permiten asegurarse de que uno o más procesos esperarán a que se complete una tarea específica antes de continuar la ejecución. Todo proceso puede esperar y/o liberar una señal. -> Los semáforos también pueden utilizarse para gestionar las interacciones. Los semáforos permiten asegurarse de que dos o más procesos no modifican el mismo recurso (archivo, registro...) al mismo tiempo. Sólo el proceso que define el semáforo puede eliminarlo. +:::note -### Objeto signal +[Semaphores](../Develop/processes.md#semaphores) can also be used to manage interactions. Los semáforos permiten asegurarse de que dos o más procesos no modifican el mismo recurso (archivo, registro...) al mismo tiempo. Sólo el proceso que define el semáforo puede eliminarlo. -Una señal es un objeto compartido que debe ser pasado como parámetro a los comandos que llaman o crean trabajadores o procesos. +::: -Un objeto `4D.Signal` contiene los siguientes métodos y propiedades integrados: +### Objeto signal -- [`.wait()`](#wait) -- [`.trigger()`](#trigger) -- [`.signaled`](#signaled) -- [`.description`](#description). +Una señal es un objeto compartido que debe ser pasado como parámetro a los comandos que llaman o crean trabajadores o procesos. Lanzamiento Mientras espera una señal, el proceso que llama no utiliza ninguna CPU. Esto puede ser muy interesante para el rendimiento en aplicaciones multiproceso. Lanzamiento diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_string.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_string.md index c6a7164bc9e8fc..bbc85b947eee03 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_string.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/dt_string.md @@ -34,6 +34,12 @@ Las siguientes secuencias de escape pueden utilizarse dentro de las cadenas: **Nota:** el carácter \ (barra invertida) se utiliza como separador en las rutas de acceso en Windows. Por lo tanto, debe utilizar una doble barra invertida \\\ en las rutas cuando quiera tener una barra invertida delante de un caracter utilizado en una de las secuencias de escape reconocidas por 4D (por ejemplo, "C:\\MisDocumentos\\\Nuevos.txt"). +### Normalización automática de los finales de línea + +Para garantizar la compatibilidad multiplataforma de los textos gestionados en la base de datos, 4D normaliza automáticamente los finales de línea de modo que ocupen un solo carácter: `\r` (retorno de carro). Esta normalización se lleva a cabo a nivel de los objetos del formulario (variables o campos) que contienen texto sin formato o de varios estilos. Los finales de línea que no sean nativos, o que utilicen una combinación de varios caracteres (por ejemplo, `\r\n`), se consideran como un único `\r`. Note that in compliance with the XML standard (multi-style text format), the [multi-style text commands](../commands/theme/Styled_Text.md) also normalize line endings for text variables that are not associated with objects. + +Este principio facilita el uso de comandos de texto con múltiples estilos o de comandos como [`HIGHLIGHT TEXT`](../commands/highlight-text) en un contexto multiplataforma. Sin embargo, debe tenerlo en cuenta en su procesamiento cuando trabaje con textos de fuentes heterogénicas. + ## Operadores de cadenas | Operación | Sintaxis | Devuelve | Expression | Valor | diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/flow-control.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/flow-control.md index 9c4c601201410a..4e920bec4cee14 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/flow-control.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/flow-control.md @@ -832,9 +832,9 @@ El comando [`defer`](../commands/defer) permite encadenar una o varias expresion Whether you are managing document closings, resetting interprocess flags, or freeing up resources, ensuring that your housekeeping tasks execute flawlessly no matter how or where your function terminates can be handled by `defer` keywords. ```4d - //make sure some code is executed at exit + //Asegurarse de que se ejecute cierto código al salir defer(myCleaningMethod) - //Do something... + //Hacer algo... ``` Vea la descripción del comando [`defer`](../commands/defer) para más información. \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/methods.md b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/methods.md index ccc1b3f4d6ac4d..06ac5ec70a0633 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Concepts/methods.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Concepts/methods.md @@ -22,4 +22,57 @@ En el lenguaje 4D, hay varias categorías de métodos. La categoría depende de | **Método base** | Automático, cuando se produce un evento de la sesión de trabajo | Sí (predefinido) | Hay 16 métodos base en 4D. | | **Class** | Se llama automáticamente cuando un objeto de la clase es instanciado o cuando una función de la clase es ejecutada en una instancia de un objeto en cualquier otro método o en un [campo de base de datos](../Develop/field-properties.md#class). | sí (funciones de clase) | Una **Clase** se utiliza para declarar y configurar la clase [constructor](./classes.md#class-constructor), [propiedades](./classes.md#property) y [funciones](./classes.md#function) de objetos. Ver [**Clases**](classes.md) y [clase **Función**](../API/FunctionClass.md). | +## Language tokens +4D's language includes a unique tokenization system for constants, commands, tables, fields and keywords names that are used in the code. Tokenizing these names means that as you type in the code editor they are stored internally as absolute references (numbers) and then restored as text during execution or display depending on the context. This allows you to guarantee that the code will always be interpreted correctly, even if you rename your tables or fields, or when 4D language commands are renamed over the course of different application versions. + +**Note:** This also ensures automatic translation of the code when you have enabled the ["Use regional system settings" preference](../Preferences/methods.md#4d-programming-language-use-regional-system-settings) and open your databases with 4D versions in different languages. + +Tokenisation is completely transparent for 4D developers when working in the [4D code editor](../code-editor/write-class-method.md), and you generally won't need to worry about it. However, there are two cases where you might need to take action regarding tokenization: if you want to disable it, and if you want to use tokenization in your formulas. + +### Disabling tokenization + +When your project is stored on a version control system (VCS) such as GitHub or GitLab, you may want to disable tokenization to make the code more readable on the external platform. To do this, you can deselect the [**Include tokens in project source files**](../Preferences/general.md#include-tokens-in-project-source-files) preference to prevent tokens from being stored in your **new projects**. + +You can configure your **existing projects** to save code without tokens by inserting the following key in the `.4DProject` file using a text editor: + +```json +"tokenizedText": false +``` + +Este parámetro sólo se tiene en cuenta cuando se guardan los métodos. Los métodos existentes en sus proyectos no se modifican, a menos que los vuelva a guardar. + +### Using tokens in formulas + +A text-based 4D [formula](../commands/theme/Formulas.md) is a text that is interpreted at runtime, and not as it is typed. In fact, this is the case as soon as 4D code is expressed as raw text, more specifically when code is exported and then imported using the [`METHOD GET CODE`](../commands/method-get-code) and [`METHOD SET CODE`](../commands/method-set-code) commands, copied/pasted or [interpreted from 4D HTML tags](../Tags/transformation-tags.md). +To benefit from tokenization mechanisms in these contexts, you just need to use an explicit syntax which consists in preceding object names in the language by their token. + +### Token syntax + +For tokenizable named elements contained in expressions, 4D offers a special syntax you can use to reference the tokens directly: you just need to add a specific suffix after the element name to indicate its type (command, field, etc.), followed by its reference. The token syntax is detailed in this table: + +| Elemento | Example (standard syntax) | Suffix | Example (token syntax) | Comentarios | +| ----------- | ------------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | +| 4D Command | String(a) | :Cxx | String:C10(a) | xx is the command number | +| 4D Constant | Pi | :Kxx:yy | Pi:K30:1 | xx is the ID of the constant group and yy is its index (position) within this group | +| Tabla | [Employees] | :xx | [Employees:1] | xx is the table number | +| Campo | [Employees]Name | :xx | [Employees:1]Name:2 | xx is the field number | +| 4D Plugin | PV PRINT(area) | :Pxx:yy | PV PRINT:P13000:229(area) | xx is the plug-in ID and yy is the index of the command | + +**Note:** Uppercase letters (C, P) must be used in the suffixes; otherwise, they will not be interpreted correctly. + +When you use this syntax, you guarantee that your formulas will be interpreted correctly even in the case of renaming or when the database is executed in a different language. + +This syntax is accepted in all 4D formulas (or 4D expressions) regardless of the calling context: + +- 4D formulas executed using the Formula editor or using commands such as [`EXECUTE FORMULA`](../commands/execute-formula), [`APPLY TO SELECTION`](../commands/apply-to-selection), [`QUERY BY FORMULA`](../commands/query-by-formula), [`LISTBOX INSERT COLUMN FORMULA`](../commands/listbox-insert-column-formula), etc. +- expressions inserted in [multi-style text areas](../FormObjects/properties_Text.md#supported-tags) (see ST INSERT EXPRESSION), +- expressions calculated in [transformation tags](../Tags/transformation-tags.md), +- expressions inserted in external areas such as [4D Write Pro areas](../WritePro/managing-formulas.md). + +#### Where to find the element numbers? + +The token syntax requires the addition of the reference numbers of various elements. The location of these references depends on the type of element. + +- **4D commands:** Command numbers can be found in the documentation ("Properties" area) as well as on the Commands page of the Explorer. +- **Tables and fields**: Table and field numbers can be obtained using the [`Table`](../commands/table) and [`Field`](../commands/field) commands. They are also displayed in the Inspector palette of the Structure editor. \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Desktop/clientServer.md b/i18n/es/docusaurus-plugin-content-docs/current/Desktop/clientServer.md index 8e6a1b996af40d..606c70e3e77300 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Desktop/clientServer.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Desktop/clientServer.md @@ -184,11 +184,11 @@ If 4D Server unexpectedly stops responding, a reconnection dialog box is display #### Objeto Session actualizado -When the "Unreachable" event is received on either side, an [`info.unreachableSince`](../API/SessionClass.md#info) property is created in the session on the machine receiving the event (on the server, it is readable through the [`Process activity.sessions`](../commands/process-activity) property), and it starts counting seconds since the last communication. You can use this property to implement your own disconnection interface. +When the "Unreachable" event is received on either side, an [`info.unreachableSince`](../API/SessionClass.md#info) property is created in the session on the machine receiving the event (on the server, it is readable through the [`Process activity.sessions`](../commands/process-activity) property), and it starts counting seconds since the last communication. Puede utilizar esta propiedad para implementar su propia interfaz de desconexión. ### Restablecer o cerrar la conexión -The QUIC session timeout is automatically used to monitor disconnections: +El tiempo de espera de la sesión QUIC se utiliza automáticamente para supervisar las desconexiones: - If the connection is restored before the QUIC session timeout is reached, the [`info.unreachableSince`](../API/SessionClass.md#info) property is automatically removed from the session object. - If the connection is not restored before the QUIC session timeout is reached, the session is closed. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Desktop/drag-and-drop.md b/i18n/es/docusaurus-plugin-content-docs/current/Desktop/drag-and-drop.md new file mode 100644 index 00000000000000..a865de9ceca70d --- /dev/null +++ b/i18n/es/docusaurus-plugin-content-docs/current/Desktop/drag-and-drop.md @@ -0,0 +1,260 @@ +--- +id: arrastrar y soltar +title: Drag and drop +--- + +## Generalidades + +4D allows built-in drag and drop capability between objects in your forms and applications. You can drag and drop one object to another, in the same window or in another window. In other words, drag and drop can be performed within a process or from one process to another. + +You can also drag and drop objects between 4D forms and other applications, and vice versa. For example, it is possible to drag and drop a .png picture file onto a 4D picture field. It is also possible to select text in a word processing application and drop it onto a 4D text variable or a list box. + +Finally, it is possible to drop objects directly onto the application without necessarily having a form in the foreground. The [`On Drop` Database Method](../commands-legacy/on-drop-database-method.md) can be used to manage the drag and drop action in this case. This means, for example, that you can open a 4D Write Pro document by dropping it onto the 4D application icon. + +4D provides two drag-and-drop modes: + +- a **custom mode**, where the whole drag-and-drop operation is handled by the programmer. Este modo le permite implementar cualquier interfaz basada en la función de arrastrar y soltar, incluidas las interfaces que no necesariamente transportan datos, sino que pueden realizar cualquier acción como abrir archivos o activar un cálculo. +- an **automatic mode**, where a drag-and-drop operation automatically copies or moves data from an object to another. This mode is available to text-based objects and (partially) pictures, and can be enabled by simply selecting a property. + +## Draggable and Droppable Objects + +Several form objects can be draggable and/or droppable, in custom and/or automatic mode (see below). By default, newly created form objects can be neither dragged nor dropped ("none" value). It is up to you to set these properties. + +To drag and drop an object to another object, you must set its [**Draggable** property](../FormObjects/properties_Action.md#draggable) to "Automatic" or "Custom". In a drag-and-drop operation, the object that you drag is the source object. + +To make an object the destination of a drag and drop operation, you must set its [**Droppable** property](../FormObjects/properties_Action.md#droppable) to "Automatic" or "Custom". In a drag-and-drop operation, the object that receives data is the destination object. + +The following table lists the available properties for draggable and/or droppable objects: + +| Objetos de formulario | Draggable "Custom" | Droppable "Custom" | Draggable "Auto" | Droppable "Auto" | +| ---------------------------------------------- | ------------------ | ------------------ | ---------------- | ---------------- | +| [4D Write Pro areas](writeProArea_overview.md) | x | x | x | x | +| [Combo Box](comboBox_overview.md) | | x | x | x | +| [Entrada](input_overview.md) | x | x | x | x | +| [Lista jerárquica](list_overview.md) | x | x | | | +| [List Box](listbox_overview.md) | x | x | | | +| [Área de plugin](pluginArea_overview.md) | | | x | x | +| [Botón](button_overview.md) | | x | | | +| [Picture button](pictureButton_overview.md) | | x | | | + +Items of a hierarchical list or rows in a list box can be dragged and dropped. Conversely, you can drag and drop an object onto an item of a hierarchical list or a list box row. However, you cannot drag and drop objects from the detail area of an output form. You can also manage dragging and dropping onto the application, outside of any form, using the [`On Drop` database method](../commands-legacy/on-drop-database-method.md). + +:::note Notas + +- By default, in the case of picture fields and variables, the picture and its reference are both dragged. If you only want to drag the reference, first hold down the **Alt** (Windows) or **Option** (macOS) key. +- When the "Custom" Draggable and ["Movable Rows"](../FormObjects/properties_Action.md#movable-rows) properties are both set for an array list box object, the "Movable Rows" property takes priority when a row is moved. Dragging is not possible in this case. +- An object that is capable of being both dragged and dropped can also be dropped onto itself, unless you reject the operation. + +::: + +## Custom Drag and Drop + +Implementing a custom drag-and-drop interface means combining properties, events, and commands from the [*Pasteboard* theme](../commands/theme/Pasteboard.md). The following diagram illustrates the key points of a custom drag-and-drop sequence: + +![](../assets/en/Desktop/dragdrop1.png) + +Your implementation will be based upon the following scenario: + +1. In the [`On Begin Drag Over`](../Events/onBeginDragOver.md) event of the source object (with ["Custom" **Draggable** property](../FormObjects/properties_Action.md#draggable)), put appropriate data in the pasteboard using [`APPEND DATA TO PASTEBOARD`](../commands/append-data-to-pasteboard), [`SET FILE TO PASTEBOARD`](../commands/set-file-to-pasteboard) or other commands from the [Pasteboard theme](../commands/theme/Pasteboard.md). You can also define a specific cursor icon using [`SET DRAG ICON`](../commands/set-drag-icon) command. +2. In the [`On Drag Over`](../Events/onDragOver.md) event of the destination object (with ["Custom" **Droppable** property](../FormObjects/properties_Action.md#droppable)), get the data types or data signatures found in the pasteboard using [`GET PASTEBOARD DATA TYPE`](../commands/get-pasteboard-data-type) or [`GET PASTEBOARD DATA`](../commands/get-pasteboard-data) and check if they are compatible with the destination object. + The [`Drop position`](../commands/drop-position) command returns the element number or the item position of the target element or list item, if the destination object is an array (i.e., scrollable area), a hierarchical list, a text or a combo box, as well as the column number if the object is a list box. +3. The [object method](../Concepts/methods.md#method-types) of the destination object or element must return 0 or -1 to accept or reject the action: + - If it is compatible, return **0** to accept the drop and execute the [`On Drop`](../Events/onDrop.md) event when the mouse button is released. + - Otherwise, return **-1** to reject the drop. + 4D automatically handles the interface aspect of this interaction by displaying a cursor depending on whether the drop is accepted or rejected. +4. In the [`On Drop`](../Events/onDrop.md) event of the destination object (with ["Custom" **Droppable** property](../FormObjects/properties_Action.md#droppable)), execute any action in response to the drop. If the drag-and-drop operation is intended to copy the dragged data, you simply assign the data to destination object. If the drag and drop is not intended to move data, but is instead a user interface metaphor for a particular operation, you can perform whatever you want, for example getting file paths using [`Get file from pasteboard`](../commands/get-file-from-pasteboard) command. + +Note that the [`On Begin Drag Over`](../Events/onBeginDragOver.md) event is generated **in the context of the source object of the drag** while [`On Drag Over`](../Events/onDragOver.md) and [`On Drop`](../Events/onDrop.md) events are only sent to the destination object. + +In order for the application to process these events, they must be selected in an appropriate manner in the Property List for both the source and destination objects: + +![](../assets/en/Desktop/dragdrop2.png) + +## Automatic Drag and Drop + +Automatic drag and drop is the movement or copy of a text or picture selection from one area to another by a single click. It can be used in the same 4D area, between two 4D areas, or between 4D and another application. + +:::note + +In the case of automatic drag and drop between two 4D areas, the data are moved, in other words, they are removed from the source area. If you want to copy the data, hold down the **Ctrl** (Windows) or **Option** (macOS) key during the action (under macOS, you need to hit the **Option** key *after* you start to drag the item(s)). + +::: + +[Automatic Draggable](../FormObjects/properties_Action.md#draggable) property and [Automatic Droppable](../FormObjects/properties_Action.md#droppable) property can be configured separately for each form object. + +- **Draggable: Automatic**: When this option is selected, the automatic drag mode is activated for the object. In this mode, the [`On Begin Drag`](../Events/onBeginDragOver.md) form event is NOT generated. + If you want to "force" the use of the custom drag while automatic drag is enabled, hold down the **Alt** (Windows) or **Option** (macOS) key during the action (under macOS, you need to hit the **Option** key *before* you start to drag the item(s)). Esta opción no está disponible para las imágenes. +- **Droppable: Automatic**: In this mode, 4D automatically manages — if possible — the insertion of dragged data of the text or picture type that is dropped onto the object (the data are pasted into the object). The [`On Drag Over`](../Events/onDragOver.md) and [`On Drop`](../Events/onDrop.md) form events are not generated in this case. On the other hand, the [`On After Edit`](../Events/onAfterEdit.md) (during a drop) and [`On Data Change`](../Events/onDataChange.md) (when the object loses the focus) events are generated. + +In the case of data other than text or pictures (another 4D object, file, etc.) or complex data being dropped, the application refers to the value of the "Droppable" option: if it is not "none", the [`On Drag Over`](../Events/onDragOver.md) and [`On Drop`](../Events/onDrop.md) form events are generated; otherwise, the drop is refused. + +## Ejemplos + +### Array based list box to input text area + +In this simple example, we want to fill an input text area with data dragged from an array-based list box: + +![](../assets/en/Desktop/dragdrop3.png) + +The list box object method: + +```4d + //Object Method: ListBox + If(Form event code=On Begin Drag Over) + SET TEXT TO PASTEBOARD(arrFirstname{arrFirstname}+" "+arrLastname{arrFirstname}) + End if +``` + +The input text area object method contains: + +```4d + + // Object Method: label1 +If(Form event code=On Drop) //Requires Droppable Action enabled from Property List + ARRAY TEXT($signatures_at;0) + ARRAY TEXT($nativeTypes_at;0) + ARRAY TEXT($formatNames_at;0) + GET PASTEBOARD DATA TYPE($signatures_at;$nativeTypes_at;$formatNames_at) + If(Find in array($signatures_at;"com.4d.private.text.native")#-1) // there is 4D text in pasteboard + OBJECT Get pointer(Object current)->:=Get text from pasteboard + End if + End if +``` + +### Selection based list box to input text area + +Combining custom and automatic drag and drop features allows simple and powerful interfaces. In this example, we want to fill an input text area with data dragged from a list box: + +![](../assets/en/Desktop/dragdrop4.png) + +- List box: "Custom" Draggable property and "On Begin Drag Over" event +- Input text area: "Automatic" Droppable property. + +```4d + //list box object method + Case of + :(Form event code=On Begin Drag Over) + LOAD RECORD([Clients]) + $label:=[Clients]Name+Char(CR ASCII code)+[Clients]Contact+Char(CR ASCII code)+\ + [Clients]Address1+Char(CR ASCII code)+[Clients]City+", "+[Clients]State+" "+[Clients]ZipCode) + SET TEXT TO PASTEBOARD($label) + End case +``` + +Moving and formatting data is done through drag and drop: + +![](../assets/en/Desktop/dragdrop5.png) + +### File path to text area + +You want the user to select a file on the disk, then drag and drop it on an enterable variable (of type object) so that it displays a json description of the file. + +![](../assets/en/Desktop/dragdrop6.png) + +In the object method of the variable, you just write: + +```4d + #DECLARE -> $result : Integer + Case of + + :(Form event code=On Drag Over) + // Accept On Drop event only if the pasteboard contains files, reject otherwise. + If(Get file from pasteboard(1)="") //no file in pasteboard + $result:=-1 //reject drop + End if + + :(Form event code=On Drop) //Requires Droppable action enabled from Property List + var $path_t : Text + var path_o : Object + $path_t:=Get file from pasteboard(1) + If($path_t#"") + path_o:=Path to object($path_t) + End if + + End case +``` + +### File paths to list box + +You want the user to select files on the disk, then drag and drop them on a list box so that it displays file paths. + +![](../assets/en/Desktop/dragdrop7.png) + +In the list box object method, you just write: + +```4d + #DECLARE -> $result : Integer + Case of + + :(Form event code=On Drag Over) + // Accept On Drop event only if the pasteboard contains files, reject otherwise. + If(Get file from pasteboard(1)#"") //at least one file dropped + $result:=0 //accept drop + Else //no file in pasteboard + $result:=-1 //reject drop + End if + + :(Form event code=On Drop) //Requires Droppable action enabled from Property List + ARRAY TEXT(importedPath_at;0) + var $path_t :Text + var $index_l:=1 + Repeat + $path_t:=Get file from pasteboard($index_l) + If($path_t#"") + APPEND TO ARRAY(importedPath_at;$path_t) + End if + $index_l:=$index_l+1 + Until($path_t="") + End case +``` + +## Pasteboard commands + +The [commands of the "Pasteboard" theme](../commands/theme/Pasteboard.md) can be used both for managing copy/paste actions (**Clipboard management**), as well as inter-application drag and drop actions. + +4D uses two data pasteboards: one for copied (or cut) data, which is the clipboard, and the other for data being dragged and dropped. +These two pasteboards are managed using the same commands. You access one or the other depending on the context: + +- The drag and drop pasteboard can only be accessed within the [`On Begin Drag Over`](../Events/onBeginDragOver.md), [`On Drag over`](../Events/onDragOver.md) or [`On Drop`](../Events/onDrop.md) form events and in the [**On Drop** database method](../commands-legacy/on-drop-database-method.md). Outside of these contexts, the drag and drop pasteboard is not available. +- The copy/paste pasteboard can be accessed in all other cases. Unlike the drag and drop pasteboard, it keeps the data that are placed in it during the entire session, so long as they are not cleared or reused. + +### Types of Data + +During drag and drop actions, different types of data can be placed on and read from the pasteboard. You can access a data type in several ways: + +- Via its 4D signature: The 4D signature is a character string indicating a data type referenced by the 4D application. The use of 4D signatures facilitates the development of multi-platform applications since these signatures are identical under Mac OS and Windows. You will find the list of 4D signatures below. +- Via a UTI (Uniform Type Identifier, macos only): The UTI standard, specified by Apple, associates a character string with each type of native object. For example, GIF pictures have the UTI type "com.apple.gif". UTI types are published in Apple documentations as well as by the editors concerned. +- Via its number or its format name (Windows only): Under Windows, each native data type is referenced by its number ("3", "12", and so on) and a name ("Rich Text Edit"). By default, Microsoft specifies several native types called standard data formats. In addition, third-party editors can "save" format names in the system, which then attributes them a number in return. For more information about this and about native types, please refer to the Microsoft developer documentation (more particularly at http://msdn2.microsoft.com/en-us/library/ms649013.aspx). + +:::note + +In 4D commands, the Windows format numbers are handled as text. + +::: + +All the [commands of the "Pasteboard" theme](../commands/theme/Pasteboard.md) can work with each one of these data types. You can find out which data types are present in the pasteboard in each of these formats using the [`GET PASTEBOARD DATA TYPE`](../commands/get-pasteboard-data-type) command. + +:::note + +4-character types (TEXT, PICT or custom types) are supported for compatibility with prior versions of 4D. + +::: + +### 4D Signatures + +Here is the list of standard 4D signatures as well as their description: + +| Firma | Descripción | +| ----------------------------------------------------------------------------------------------- | ----------------------------- | +| "com.4d.private.text.native" | Text in native character set | +| "com.4d.private.text.utf16" | Text in Unicode character set | +| "com.4d.private.text.rtf" | Enriched text | +| "com.4d.private.picture.pict" | PICT picture format | +| "com.4d.private.picture.png" | PNG picture format | +| "com.4d.private.picture.gif" | GIF picture format | +| "com.4d.private.picture.jfif" | JPEG picture format | +| "com.4d.private.picture.emf" | EMF picture format | +| "com.4d.private.picture.bitmap" | BITMAP picture format | +| "com.4d.private.picture.tiff" | TIFF picture format | +| "com.4d.private.picture.pdf" | PDF document | +| "com.4d.private.file.url" | File pathname | \ No newline at end of file diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/buttonGrid_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/buttonGrid_overview.md index 6528c5ba02802b..9dc6b75e2543fc 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/buttonGrid_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/buttonGrid_overview.md @@ -24,7 +24,7 @@ Si no se selecciona ningún elemento, el valor es 0 ### Ir a la página -You can assign the `gotoPage` [standard action](/Desktop/standard-actions) to a button grid. Cuando se selecciona esta acción, 4D mostrará automáticamente la página del formulario que corresponde al número del botón que está seleccionado en la rejilla de botones. Por ejemplo, si el usuario selecciona el décimo botón de la rejilla, 4D mostrará la décima página del formulario actual (si existe). +Puede asignar la [acción estándar](/Desktop/standard-actions) `gotoPage` a una rejilla de botones. Cuando se selecciona esta acción, 4D mostrará automáticamente la página del formulario que corresponde al número del botón que está seleccionado en la rejilla de botones. Por ejemplo, si el usuario selecciona el décimo botón de la rejilla, 4D mostrará la décima página del formulario actual (si existe). ## Propiedades soportadas diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md index a3df34c2470951..4d4d43f156ee08 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/formObjects_overview.md @@ -35,3 +35,35 @@ Puede añadir o modificar objetos formulario 4D de las siguientes maneras: "height": 20 } ``` + +### Accessing form objects using their name or their data source in the 4D language + +Many commands handling form objects such as commands from [Objects (Forms)](../commands/theme/Objects_Forms.md), [List Box](../commands/theme/List_Box.md), or [Styled Text](../commands/theme/Styled_Text.md) themes share the same generic syntaxes described here: + +```4d +COMMAND NAME( * ; *object* : Text { ; *additional parameters* } ) +//or +COMMAND NAME( *object* : Variable, Field { ; *additional parameters* }) +``` + +If you specify the \* parameter, you indicate that *object* is the [name of the object](./properties_Object.md#object-name) (a string). If you don't pass the \*, you indicate that *object* is a field or a variable, i.e. its [data source](./properties_Object.md#variable-or-expression). + +When using the [object name](./properties_Object.md#object-name), you can rely on the @ character within that name if you want to address several objects of the form in one call. The following table shows examples of object names you can specify to this command. + +| Object Names | Objects affected by the call | +| ----------------------------------- | ------------------------------------------------------------------------------ | +| mainGroupBox | Only the object mainGroupBox. | +| main@ | The objects whose name starts with “main”. | +| @GroupBox | The objects whose name ends with “GroupBox”. | +| @Agrupar@ | The objects whose name contains “Group”. | +| main@Btn | The objects whose name starts with “main” and ends with “Btn”. | +| @ | All the objects present in the form. | + +Form object names can contain up 255 bytes, allowing you to define and apply custom naming rules, such as "xxxx_Button" or "xxx_Mac". + +:::warning + +You can [configure the way the @ character is interpreted](../settings/database.md#text-comparison) when it is included in a character string. This option affects the functioning of the form object commands. + +::: + diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md index 7a0d14ed1d7fed..2256c573408160 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/input_overview.md @@ -43,7 +43,7 @@ Por razones de seguridad, en las áreas de entrada [multiestilo](./properties_Te -[Allow font/color picker](properties_Text.md#allow-fontcolor-picker) - [Alpha Format](properties_Display.md#alpha-format) - [Auto Spellcheck](properties_Entry.md#auto-spellcheck) - [Background Color](properties_BackgroundAndBorder.md#background-color--fill-color) - [Bold](properties_Text.md#bold) - [Boolean format](properties_Display.md#text-when-falsetext-when-true) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Choice List](properties_DataSource.md#choice-list) - [Class](properties_Object.md#css-class) - [Context Menu](properties_Entry.md#context-menu) - [Corner radius](properties_CoordinatesAndSizing.md#corner-radius) - [Date Format](properties_Display.md#date-format) - [Default value](properties_RangeOfValues.md#default-value) - [Draggable](properties_Action.md#draggable) - [Droppable](properties_Action.md#droppable) - [Enterable](properties_Entry.md#enterable) - [Entry Filter](properties_Entry.md#entry-filter) - [Excluded List](properties_RangeOfValues.md#excluded-list) - [Expression type](properties_Object.md#expression-type) - [Fill Color](properties_BackgroundAndBorder.md#background-color--fill-color) - [Font](properties_Text.md#font) - [Font Color](properties_Text.md#font-color) - [Font Size](properties_Text.md#font-size) - [Height](properties_CoordinatesAndSizing.md#height) - [Hide focus rectangle](properties_Appearance.md#hide-focus-rectangle) - [Horizontal Alignment](properties_Text.md#horizontal-alignment) - [Horizontal Scroll Bar](properties_Appearance.md#horizontal-scroll-bar) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Italic](properties_Text.md#italic) - [Left](properties_CoordinatesAndSizing.md#left) - [Multiline](properties_Entry.md#multiline) - [Multi-style](properties_Text.md#multi-style) - [Number Format](properties_Display.md#number-format) - [Object Name](properties_Object.md#object-name) - [Orientation](properties_Text.md#orientation) - [Picture Format](properties_Display.md#picture-format) - [Placeholder](properties_Entry.md#placeholder) - [Print Frame](properties_Print.md#print-frame) - [Required List](properties_RangeOfValues.md#required-list) - [Right](properties_CoordinatesAndSizing.md#right) - [Selection always visible](properties_Entry.md#selection-always-visible) - [Store with default style tags](properties_Text.md#store-with-default-style-tags) - [Text when False/Text when True](properties_Display.md#text-when-falsetext-when-true) - [Time Format](properties_Display.md#time-format) - [Top](properties_CoordinatesAndSizing.md#top) - [Type](properties_Object.md#type) - [Underline](properties_Text.md#underline) - [Variable or Expression](properties_Object.md#variable-or-expression) - [Vertical Scroll Bar](properties_Appearance.md#vertical-scroll-bar) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) - [Wordwrap](properties_Display.md#wordwrap) - [Writing Tools](properties_Entry.md#writing-tools) +[Permitir selector de fuente/color](properties_Text.md#allow-fontcolor-picker) - [Formato alfa](properties_Display.md#alpha-format) - [Corrección ortográfica automática](properties_Entry.md#auto-spellcheck) - [Color de fondo](properties_BackgroundAndBorder.md#background-color--fill-color) - [Negrita](properties_Text.md#bold) - [Formato booleano](properties_Display.md#text-when-falsetext-when-true) - [Estilo de línea de borde](properties_BackgroundAndBorder.md#border-line-style) - [Parte inferior](properties_CoordinatesAndSizing.md#bottom) - [Lista de opciones](properties_DataSource.md#choice-list) - [Clase](properties_Object.md#css-class) - [Menú contextual](properties_Entry.md#context-menu) - [Radio de las esquinas](properties_CoordinatesAndSizing.md#corner-radius) - [Formato de fecha](properties_Display.md#date-format) - [Valor por defecto](properties_RangeOfValues.md#default-value) - [Arrastrable](properties_Action.md#draggable) - [Soltable](properties_Action.md#droppable) - [Editable](properties_Entry.md#enterable) - [Filtro de entrada](properties_Entry.md#entry-filter) - [Lista de exclusiones](properties_RangeOfValues.md#excluded-list) - [Tipo de expresión](properties_Object.md#expression-type) - [Color de relleno](properties_BackgroundAndBorder.md#background-color--fill-color) - [Fuente](properties_Text.md#font) - [Color de fuente](properties_Text.md#font-color) - [Tamaño de fuente](properties_Text.md#font-size) - [Altura](properties_CoordinatesAndSizing.md#height) - [Ocultar rectángulo de foco](properties_Appearance.md#hide-focus-rectangle) - [Alineación horizontal](properties_Text.md#horizontal-alignment) - [Barra de desplazamiento horizontal](properties_Appearance.md#horizontal-scroll-bar) - [Ajuste horizontal](properties_ResizingOptions.md#horizontal-sizing) - [Cursiva](properties_Text.md#italic) - [Izquierda](properties_CoordinatesAndSizing.md#left) - [Multilínea](properties_Entry.md#multiline) - [Estilo múltiple](properties_Text.md#multi-style) - [Formato de números](properties_Display.md#number-format) - [Nombre del objeto](properties_Object.md#object-name) - [Orientación](properties_Text.md#orientation) - [Formato de imagen](properties_Display.md#picture-format) - [Marcador de posición](properties_Entry.md#placeholder) - [Marco de impresión](properties_Print.md#print-frame) - [Lista obligatoria](properties_RangeOfValues.md#required-list) - [Derecha](properties_CoordinatesAndSizing.md#right) - [Selección siempre visible](properties_Entry.md#selection-always-visible) - [Guardar con etiquetas de estilo predeterminadas](properties_Text.md#store-with-default-style-tags) - [Texto cuando es False/Texto cuando es True](properties_Display.md#text-when-falsetext-when-true) - [Formato de hora](properties_Display.md#time-format) - [Arriba](properties_CoordinatesAndSizing.md#top) - [Tipo](properties_Object.md#type) - [Subrayado](properties_Text.md#underline) - [Variable o expresión](properties_Object.md#variable-or-expression) - [Barra de desplazamiento vertical](properties_Appearance.md#vertical-scroll-bar) - [Tamaño vertical](properties_ResizingOptions.md#vertical-sizing) - [Visibilidad](properties_Display.md#visibility) - [Ancho](properties_CoordinatesAndSizing.md#width) - [Ajustar al ancho](properties_Display.md#wordwrap) - [Herramientas de escritura](properties_Entry.md#writing-tools) ## Eventos soportados diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md index af715bc42d5b1b..ac0890b6c357f3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/list_overview.md @@ -22,7 +22,7 @@ En ambos casos, se gestiona una lista jerárquica en tiempo de ejecución a trav Una lista jerárquica es a la vez un **objeto de lenguaje** existente en memoria y un **objeto de formulario**. -El **objeto de lenguaje** está referenciado por un ID interno único de tipo Entero largo, designado por *ListRef* en el manual de Lenguaje 4D. Este ID es devuelto por los comandos que se pueden usar para crear listas: `New list`, `Copy list`, `Load list`, `BLOB to list`. Sólo hay una instancia del objeto lenguaje en la memoria y cualquier modificación realizada en este objeto se traslada inmediatamente a todos los lugares donde se utiliza. +El **objeto de lenguaje** está referenciado por un ID interno único de tipo Entero largo, designado por *ListRef* en el manual de Lenguaje 4D. This ID is returned by the commands that can be used to create lists: [`New list`](../commands/new-list), [`Copy list`](../commands/copy-list), [`Load list`](../commands/load-list), [`BLOB to list`](../commands/blob-to-list). Sólo hay una instancia del objeto lenguaje en la memoria y cualquier modificación realizada en este objeto se traslada inmediatamente a todos los lugares donde se utiliza. El **objeto de formulario** no es necesariamente único: puede haber varias representaciones de la misma lista jerárquica en el mismo formulario o en otros diferentes. Al igual que con otros objetos formulario, se especifica el objeto en el lenguaje utilizando la sintaxis (\*; "NomLista", etc.). @@ -39,7 +39,7 @@ Cada representación de la lista tiene sus propias características específicas - La posición del cursor de desplazamiento. Las otras características (fuente, tamaño de fuente, estilo, control de entrada, color, contenido de la lista, iconos, etc.) son comunes a todas las representaciones y no se pueden modificar por separado. -Por consiguiente, cuando se utilizan comandos basados en la configuración expandida/colapsada o en el elemento actual, por ejemplo `Count list items` (cuando no se pasa el parámetro final `*`), es importante poder especificar la representación que se utilizará sin ninguna ambigüedad. +Consequently, when you use commands based on the expanded/collapsed configuration or the current item, for example [`Count list items`](../commands/count-list-items) (when the final `*` parameter is not passed), it is important to be able to specify the representation to be used without any ambiguity. Debe utilizar el identificador `RefLista` con los comandos del lenguaje cuando quiera especificar la lista jerárquica que se encuentra en la memoria. En cambio, si desea especificar la representación al nivel del formulario de un objeto Lista jerárquica, debe utilizar el nombre del objeto (tipo cadena) en el comando, mediante la sintaxis estándar (\*; "NomLista", etc.). @@ -54,44 +54,44 @@ SET LIST ITEM FONT(*;"mylist1";*;thefont) ### Soporte de @ -Al igual que con otros comandos de gestión de propiedades de objetos, es posible utilizar el carácter "@" en el parámetro `NomLista`. Por regla general, esta sintaxis se utiliza para designar un conjunto de objetos del formulario. Sin embargo, en el contexto de los comandos de listas jerárquicas, esto no se aplica en todos los casos. Esta sintaxis tendrá dos efectos diferentes según el tipo de comando: +As with [other object property management commands](../FormObjects/formObjects_overview.md#accessing-form-objects-using-their-name-or-their-data-source-in-the-4d-language), it is possible to use the “@” character in the `ListName` parameter. Por regla general, esta sintaxis se utiliza para designar un conjunto de objetos del formulario. Sin embargo, en el contexto de los comandos de listas jerárquicas, esto no se aplica en todos los casos. Esta sintaxis tendrá dos efectos diferentes según el tipo de comando: - Para los comandos que fijan propiedades, esta sintaxis designa todos los objetos cuyo nombre corresponde (comportamiento estándar). Por ejemplo, el parámetro "LH@" designa todos los objetos del tipo lista jerárquica cuyo nombre empieza por "LH." - - `DELETE FROM LIST` - - `INSERT IN LIST` - - `SELECT LIST ITEMS BY POSITION` - - `SET LIST ITEM` - - `SET LIST ITEM FONT` - - `SET LIST ITEM ICON` - - `SET LIST ITEM PARAMETER` - - `SET LIST ITEM PROPERTIES` + - [`DELETE FROM LIST`](../commands/delete-from-list) + - [`INSERT IN LIST`](../commands/insert-in-list) + - [`SELECT LIST ITEMS BY POSITION`](../commands/select-list-items-by-position) + - [`SET LIST ITEM`](../commands/set-list-item) + - [`SET LIST ITEM FONT`](../commands/set-list-item-font) + - [`SET LIST ITEM ICON`](../commands/set-list-item-icon) + - [`SET LIST ITEM PARAMETER`](../commands/set-list-item-parameter) + - [`SET LIST ITEM PROPERTIES`](../commands/set-list-item-properties) - Para los comandos que recuperan propiedades, esta sintaxis designa el primer objeto cuyo nombre corresponde: - - `Count list items` - - `Find in list` - - `GET LIST ITEM` - - `Get list item font` - - `GET LIST ITEM ICON` - - `GET LIST ITEM PARAMETER` - - `GET LIST ITEM PROPERTIES` - - `List item parent` - - `List item position` - - `Selected list items` + - [`Count list items`](../commands/count-list-items) + - [`Find in list`](../commands/find-in-list) + - [`GET LIST ITEM`](../commands/get-list-item) + - [`Get list item font`](../commands/get-list-item-font) + - [`GET LIST ITEM ICON`](../commands/get-list-item-icon) + - [`GET LIST ITEM PARAMETER`](../commands/get-list-item-parameter) + - [`GET LIST ITEM PROPERTIES`](../commands/get-list-item-properties) + - [`List item parent`](../commands/list-item-parent) + - [`List item position`](../commands/list-item-position) + - [`Selected list items`](../commands/selected-list-items) ## Comandos genéricos utilizables con listas jerárquicas Es posible modificar la apariencia de una lista jerárquica en un formulario utilizando varios comandos 4D genéricos. Puede pasar a estos comandos el nombre del objeto de la lista jerárquica (utilizando el parámetro \*), o su nombre de variable (que contiene el valor ListRef): -- `OBJECT SET FONT` -- `OBJECT SET FONT STYLE` -- `OBJECT SET FONT SIZE` -- `OBJECT SET FILTER` -- `OBJECT SET ENTERABLE` -- `OBJECT SET SCROLLBAR` -- `OBJECT SET SCROLL POSITION` -- `OBJECT SET RGB COLORS` +- [`OBJECT SET FONT`](../commands/object-set-font) +- [`OBJECT SET FONT STYLE`](../commands/object-set-font-style) +- [`OBJECT SET FONT SIZE`](../commands/object-set-font-size) +- [`OBJECT SET FILTER`](../commands/object-set-filter) +- [`OBJECT SET ENTERABLE`](../commands/object-set-enterable) +- [`OBJECT SET SCROLLBAR`](../commands/object-set-scrollbar) +- [`OBJECT SET SCROLL POSITION`](../commands/object-set-scroll-position) +- [`OBJECT SET RGB COLORS`](../commands/object-set-rgb-colors) -> Recordatorio: excepto `OBJECT SET SCROLL POSITION`, estos comandos modifican todas las representaciones de una misma lista, aunque sólo se especifique una lista a través de su nombre de objeto. +> Reminder: Except [`OBJECT SET SCROLL POSITION`](../commands/object-set-scroll-position), these commands modify all the representations of the same list, even if you only specify a list via its object name. ## Prioridad de los comandos de propiedad @@ -101,7 +101,7 @@ Ciertas propiedades de las listas jerárquicas (por ejemplo, el atributo **edita 2. Comandos genéricos de propiedad de objeto 3. Propiedad formulario -Este principio se aplica independientemente del orden de llamada de los comandos. Si una propiedad de un elemento se modifica individualmente a través de un comando de lista jerárquica, el comando de propiedad de objeto equivalente no tendrá ningún efecto sobre este elemento, incluso si se llama posteriormente. Por ejemplo, si el color de un elemento se modifica a través del comando `SET LIST ITEM PROPERTIES`, el comando `OBJECT SET COLOR` no tendrá ningún efecto sobre este elemento. +Este principio se aplica independientemente del orden de llamada de los comandos. Si una propiedad de un elemento se modifica individualmente a través de un comando de lista jerárquica, el comando de propiedad de objeto equivalente no tendrá ningún efecto sobre este elemento, incluso si se llama posteriormente. For example, if the color of an item is modified via the [`SET LIST ITEM PROPERTIES`](../commands/set-list-item-properties) command, the `OBJECT SET COLOR` command will have no effect on this item. ## Gestión de los elementos por posición o por referencia @@ -121,19 +121,19 @@ He aquí algunos consejos para utilizar los números de referencia: 1. No es necesario identificar cada elemento con un número único (nivel principiante). - Primer ejemplo: se construye por programación un sistema de pestañas, por ejemplo, una libreta de direcciones. Como el sistema devuelve el número de la pestaña seleccionada, probablemente no necesitará más información que ésta. En este caso, no se preocupe por los números de referencia de los elementos: pase un valor cualquiera (excepto 0) en el parámetro *itemRef*. Tenga en cuenta que para un sistema de libreta de direcciones, puede predefinir una lista A, B, ..., Z en el modo Diseño. También se puede crear por programación para eliminar las letras para las que no hay registros. - - Segundo ejemplo: al trabajar con una base, se construye progresivamente una lista de palabras clave. Puede guardar esta lista al final de cada sesión utilizando los comandos `SAVE LIST` o `LIST TO BLOB` y volver a cargarla al comienzo de cada nueva sesión utilizando el `Load list` o `BLOB to list`. Puede mostrar esta lista en una paleta flotante; cuando cada usuario hace clic en una palabra clave de la lista, el elemento elegido se inserta en el área introducible que está seleccionada en el proceso en primer plano. Lo importante es que sólo procese el elemento seleccionado, porque el comando `Select list items` devuelve la posición del elemento que debe procesar. Cuando se utiliza este valor de posición, se obtiene el título del elemento mediante el comando `GET LIST ITEM`. También en este caso, no es necesario identificar cada elemento individualmente; puede pasar cualquier valor (excepto 0) en el parámetro *itemRef*. + - Segundo ejemplo: al trabajar con una base, se construye progresivamente una lista de palabras clave. You can save this list at the end of each session by using the [`SAVE LIST`](../commands/save-list) or [`LIST TO BLOB`](../commands/list-to-blob) commands and reload it at the beginning of each new session using the [`Load list`](../commands/load-list) or [`BLOB to list`](../commands/blob-to-list) commands. Puede mostrar esta lista en una paleta flotante; cuando cada usuario hace clic en una palabra clave de la lista, el elemento elegido se inserta en el área introducible que está seleccionada en el proceso en primer plano. The important thing is that you only process the item selected, because the [`Selected list items`](../commands/selected-list-items) command returns the position of the item that you must process. When using this position value, you obtain the title of the item by means of the [`GET LIST ITEM`](../commands/get-list-item) command. También en este caso, no es necesario identificar cada elemento individualmente; puede pasar cualquier valor (excepto 0) en el parámetro *itemRef*. 2. Necesita identificar parcialmente los elementos de la lista (nivel intermediario). - Se utiliza el número de referencia del elemento para almacenar la información necesaria cuando debe trabajar con el elemento; este punto se detalla en el ejemplo del comando `APPEND TO LIST`. En este ejemplo, utilizamos los números de referencia de los artículos para almacenar los números de registro. Sin embargo, debemos ser capaces de establecer una distinción entre los elementos que corresponden a los registros [Department] y los que corresponden a los registros [Employees]. + You use the item reference number to store information needed when you must work with the item; this point is detailed in the example of the [`APPEND TO LIST`](../commands/append-to-list) command. En este ejemplo, utilizamos los números de referencia de los artículos para almacenar los números de registro. Sin embargo, debemos ser capaces de establecer una distinción entre los elementos que corresponden a los registros [Department] y los que corresponden a los registros [Employees]. 3. Debe identificar cada los elementos de la lista individualmente (nivel avanzado). - Programe una gestión elaborada de listas jerárquicas en la que es absolutamente necesario poder identificar cada elemento individualmente en cada nivel de la lista. Una forma sencilla de ponerlo en práctica es mantener un contador personal. Suponga que crea una lista *hlList* utilizando el comando `APPEND TO LIST`. En esta etapa, se inicializa un contador *vhlCounter* en 1. Cada vez que se llama a `APPEND TO LIST` o `INSERT IN LIST`, se incrementa este contador `(vhlCounter:=vhlCounter+1)`, y se pasa el número del contador como número de referencia del elemento. El truco consiste en no disminuir nunca el contador cuando se eliminan elementos: el contador sólo puede aumentar. De este modo, se garantiza la unicidad de los números de referencia de los elementos. Como estos números son de tipo Entero largo, puede añadir o insertar más de dos mil millones de elementos en una lista que ha sido reiniciada... (sin embargo, si está trabajando con un número tan grande de elementos, esto suele significar que debe utilizar una tabla en lugar de una lista.) + Programe una gestión elaborada de listas jerárquicas en la que es absolutamente necesario poder identificar cada elemento individualmente en cada nivel de la lista. Una forma sencilla de ponerlo en práctica es mantener un contador personal. Suppose that you create a *hlList* list using the [`APPEND TO LIST`](../commands/append-to-list) command. En esta etapa, se inicializa un contador *vhlCounter* en 1. Each time you call [`APPEND TO LIST`](../commands/append-to-list) or [`INSERT IN LIST`](../commands/insert-in-list), you increment this counter `(vhlCounter:=vhlCounter+1)`, and you pass the counter number as the item reference number. El truco consiste en no disminuir nunca el contador cuando se eliminan elementos: el contador sólo puede aumentar. De este modo, se garantiza la unicidad de los números de referencia de los elementos. Como estos números son de tipo Entero largo, puede añadir o insertar más de dos mil millones de elementos en una lista que ha sido reiniciada... (sin embargo, si está trabajando con un número tan grande de elementos, esto suele significar que debe utilizar una tabla en lugar de una lista.) > Si se utilizan operadores Bitwise, también se pueden utilizar los números de referencia de los elementos para almacenar información que se puede poner en un Entero largo, es decir, 2 enteros, valores de 4 bytes o de nuevo 32 booleanos. ### ¿Cuándo necesita números de referencia únicos? -En la mayoría de los casos, cuando se utilizan listas jerárquicas con fines de interfaz de usuario y cuando sólo se trata del elemento seleccionado (por un clic o arrastrado), no será necesario utilizar los números de referencia de los elementos en absoluto. Con `Selected list items` y `GET LIST ITEM`, tiene todo lo que necesita para tratar con el elemento seleccionado actualmente. Además, comandos como `INSERT IN LIST` y `DELETE FROM LIST` permiten manipular la lista "relativamente" con respecto al elemento seleccionado. +En la mayoría de los casos, cuando se utilizan listas jerárquicas con fines de interfaz de usuario y cuando sólo se trata del elemento seleccionado (por un clic o arrastrado), no será necesario utilizar los números de referencia de los elementos en absoluto. Using [`Selected list items`](../commands/selected-list-items) and [`GET LIST ITEM`](../commands/get-list-item) you have all you need to deal with the currently selected item. In addition, commands such as [`INSERT IN LIST`](../commands/insert-in-list) and [`DELETE FROM LIST`](../commands/delete-from-list) allow you to manipulate the list “relatively” with respect to the selected item. Básicamente, es necesario tratar con los números de referencia de los elementos cuando se quiere acceder directamente a cualquier elemento de la lista de forma programada y no necesariamente al actualmente seleccionado en la lista. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/listbox_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/listbox_overview.md index 07b2036bf02873..5af2d3147eb548 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/listbox_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/listbox_overview.md @@ -244,14 +244,14 @@ Puede activar o desactivar la ordenación usuario estándar desactivando la prop El soporte de ordenación estándar depende del tipo de list box: -| Tipo de list box | Soporte de ordenación estándar | Comentarios | -| ------------------------------ | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Colección de objetos | Sí | | -| Colección de valores escalares | No | Utilice la ordenación personalizada con la función [`orderBy()`](../API/CollectionClass.md#orderby) | -| Entity selection | Sí | | -| Selección actual | Sí | Sólo se pueden ordenar las expresiones simples (por ejemplo, `[Table_1]Campo_2`) | -| Selección temporal | No | | -| Arrays | Sí | Las columnas vinculadas a arrays de imágenes y punteros no se pueden ordenar | +| Tipo de list box | Soporte de ordenación estándar | Comentarios | +| ------------------------------ | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Colección de objetos | Sí | | +| Colección de valores escalares | No | Utilice la ordenación personalizada con la función [`orderBy()`](../API/CollectionClass.md#orderby) | +| Entity selection | Sí | | +| Selección actual | Sí | Sólo se pueden ordenar las expresiones simples (por ejemplo, `[Table_1]Campo_2`) | +| Selección temporal | No | | +| Arrays | Sí | Las columnas vinculadas a arrays de imágenes y punteros no se pueden ordenar | ### Ordenación personalizada @@ -579,6 +579,182 @@ En este caso, debe llenar y vaciar los arrays por código. Los principios que de - Cuando un usuario hace clic en un botón de contracción, puede procesar el evento `On Collapse`. El comando [`LISTBOX GET CELL POSITION`](../commands/listbox-get-cell-position) devuelve la celda en cuestión: se eliminan tantas líneas como sean necesarias del list box mediante el comando [`LISTBOX DELETE ROWS`](../commands/listbox-delete-rows). +## List boxes and the 4D language + +Many commands of the 4D language can be used with list boxes, from the [List box theme](../commands/theme/List_Box.md) but also from [Objects (Forms)](../commands/theme/Objects_Forms.md) and other themes. They can be used with list boxes, or [parts of list boxes](#list-box-parts) such as headers, footers, rows, or columns. Some of them can only be used with specific [list box types](#list-box-types). + +### List Box commands + +| Comando | List Box Type | Supported Parts | +| -------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------------- | +| [`LISTBOX COLLAPSE`](../commands/listbox-collapse) | Hierarchical | List box, headers, footers, rows, columns | +| [`LISTBOX DELETE COLUMN`](../commands/listbox-delete-column) | Todos | Columnas | +| [`LISTBOX DELETE ROWS`](../commands/listbox-delete-rows) | Array | List box, headers, footers, rows, columns | +| [`LISTBOX DUPLICATE COLUMN`](../commands/listbox-duplicate-column) | Array, Selection, Collection | Columnas | +| [`LISTBOX EXPAND`](../commands/listbox-expand) | Hierarchical | List box, headers, footers, rows, columns | +| [`LISTBOX Get array`](../commands/listbox-get-array) | Array | List box, headers, footers, rows, columns | +| [`LISTBOX GET ARRAYS`](../commands/listbox-get-arrays) | Todos | List box, headers, footers, rows, columns | +| [`LISTBOX Get auto row height`](../commands/listbox-get-auto-row-height) | Array | List box, headers, footers, rows, columns | +| [`LISTBOX GET CELL COORDINATES`](../commands/listbox-get-cell-coordinates) | Todos | List box, headers, footers, rows, columns | +| [`LISTBOX GET CELL POSITION`](../commands/listbox-get-cell-position) | Todos | List box, headers, footers, rows, columns | +| [`LISTBOX Get column formula`](../commands/listbox-get-column-formula) | Selection, Collection | Columnas | +| [`LISTBOX Get column width`](../commands/listbox-get-column-width) | Todos | Columnas | +| [`LISTBOX Get footer calculation`](../commands/listbox-get-footer-calculation) | Array, Selection | Pies | +| [`LISTBOX Get footers height`](../commands/listbox-get-footers-height) | Todos | Pies | +| [`LISTBOX GET GRID`](../commands/listbox-get-grid) | Todos | List box, headers, footers, rows, columns | +| [`LISTBOX GET GRID COLORS`](../commands/listbox-get-grid-colors) | Todos | List box, headers, footers, rows, columns | +| [`LISTBOX Get headers height`](../commands/listbox-get-headers-height) | Todos | Encabezados | +| [`LISTBOX GET HIERARCHY`](../commands/listbox-get-hierarchy) | Array | List box, headers, footers, rows, columns | +| [`LISTBOX Get locked columns`](../commands/listbox-get-locked-columns) | Todos | List box | +| [`LISTBOX Get number of columns`](../commands/listbox-get-number-of-columns) | Todos | List box | +| [`LISTBOX GET OBJECTS`](../commands/listbox-get-objects) | Todos | List box | +| [`LISTBOX GET PRINT INFORMATION`](../commands/listbox-get-print-information) | Todos | List box, headers, footers, rows, columns | +| [`LISTBOX Get property`](../commands/listbox-get-property) | Todos | List box, columns | +| [`LISTBOX Get row color as number`](../commands/listbox-get-row-color-as-number) | Array | Rows | +| [`LISTBOX Get row font style`](../commands/listbox-get-row-font-style) | Array | Rows | +| [`LISTBOX Get row height`](../commands/listbox-get-row-height) | Array | Rows | +| [`LISTBOX Get rows height`](../commands/listbox-get-rows-height) | Todos | List box | +| [`LISTBOX Get static columns`](../commands/listbox-get-static-columns) | Todos | List box | +| [`LISTBOX GET TABLE SOURCE`](../commands/listbox-get-table-source) | Todos | List box | +| [`LISTBOX INSERT COLUMN`](../commands/listbox-insert-column) | Todos | List box | +| [`LISTBOX INSERT COLUMN FORMULA`](../commands/listbox-insert-column-formula) | Todos | List box | +| [`LISTBOX INSERT ROWS`](../commands/listbox-insert-rows) | Array | List box | +| [`LISTBOX MOVE COLUMN`](../commands/listbox-move-column) | Todos | Columnas | +| [`LISTBOX MOVED COLUMN NUMBER`](../commands/listbox-moved-column-number) | Todos | Columnas | +| [`LISTBOX MOVED ROW NUMBER`](../commands/listbox-moved-row-number) | Array | Rows | +| [`LISTBOX SELECT BREAK`](../commands/listbox-select-break) | Hierarchical | List box | +| [`LISTBOX SELECT ROW`](../commands/listbox-select-row) | Todos | Rows | +| [`LISTBOX SET ARRAY`](../commands/listbox-set-array) | Array | List box, columns | +| [`LISTBOX SET AUTO ROW HEIGHT`](../commands/listbox-set-auto-row-height) | Array | Rows | +| [`LISTBOX SET COLUMN FORMULA`](../commands/listbox-set-column-formula) | Selection, Collection | Columnas | +| [`LISTBOX SET COLUMN WIDTH`](../commands/listbox-set-column-width) | Todos | Columnas | +| [`LISTBOX SET FOOTER CALCULATION`](../commands/listbox-set-footer-calculation) | Array, Selection | Pies | +| [`LISTBOX SET FOOTERS HEIGHT`](../commands/listbox-set-footers-height) | Todos | Pies | +| [`LISTBOX SET GRID`](../commands/listbox-set-grid) | Todos | List box | +| [`LISTBOX SET GRID COLOR`](../commands/listbox-set-grid-color) | Todos | List box | +| [`LISTBOX SET HEADERS HEIGHT`](../commands/listbox-set-headers-height) | Todos | Encabezados | +| [`LISTBOX SET HIERARCHY`](../commands/listbox-set-hierarchy) | Array | List box | +| [`LISTBOX SET LOCKED COLUMNS`](../commands/listbox-set-locked-columns) | Todos | List box | +| [`LISTBOX SET PROPERTY`](../commands/listbox-set-property) | Todos | List box, columns | +| [`LISTBOX SET ROW COLOR`](../commands/listbox-set-row-color) | Array | Rows | +| [`LISTBOX SET ROW FONT STYLE`](../commands/listbox-set-row-font-style) | Array | Rows | +| [`LISTBOX SET ROW HEIGHT`](../commands/listbox-set-row-height) | Array | Rows | +| [`LISTBOX SET ROWS HEIGHT`](../commands/listbox-set-rows-height) | Todos | List box | +| [`LISTBOX SET STATIC COLUMNS`](../commands/listbox-set-static-columns) | Todos | List box | +| [`LISTBOX SET TABLE SOURCE`](../commands/listbox-set-table-source) | Selección | List box | +| [`LISTBOX SORT COLUMNS`](../commands/listbox-sort-columns) | Todos | Columnas | + +### Miscellaneous commands + +| Comando | List Box Type | Supported Parts | Comentarios | +| ------------------------------------------------------------ | ---------------- | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [`EDIT ITEM`](../commands/edit-item) | Todos | Columnas | Allows you to pass a cell of a list box object into edit mode | +| [`Get edited text`](../commands/get-edited-text) | Todos | List box, headers, footers, rows, columns | | +| [`REDRAW`](../commands/redraw) | Array, Selection | List box | When applied to a selection list box, triggers an update of the data displayed in the list box. Not supported with list box of the entity selection type. | +| [`Displayed line number`](../commands/displayed-line-number) | Todos | List box, headers, footers, rows, columns | Works in the context of the [`On Display Detail`](../Events/onDisplayDetail.md) form event for a list box object | +| [`Drop position`](../commands/drop-position) | Todos | List box, headers, footers, rows, columns | | +| [`Count in array`](../commands/count-in-array) | Todos | List box, headers, footers, rows, columns | | +| [`Print object`](../commands/print-object) | Todos | List box, headers, footers, rows, columns | | + +### Object (forms) commands + +| Comando | List Box Type | Supported Parts | +| ------------------------------------------------------------------------------------------ | ------------- | ------------------------------------------------------------------------------------------------------------------ | +| [`OBJECT DUPLICATE`](../commands/object-duplicate) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT GET BEST SIZE`](../commands/object-get-best-size) | Todos | Columnas | +| [`OBJECT Get border style`](../commands/object-get-border-style) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT GET COORDINATES`](../commands/object-get-coordinates) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT Get data source`](../commands/object-get-data-source) | Array | List box | +| [`OBJECT GET DRAG AND DROP OPTIONS`](../commands/object-get-drag-and-drop-options) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT Get enterable`](../commands/object-get-enterable) | Todos | Columnas | +| [`OBJECT Get filter`](../commands/object-get-filter) | Todos | Columnas | +| [`OBJECT Get focus rectangle invisible`](../commands/object-get-focus-rectangle-invisible) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT Get font`](../commands/object-get-font) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT Get font size`](../commands/object-get-font-size) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT Get font style`](../commands/object-get-font-style) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT Get format`](../commands/object-get-format) | Todos | Encabezados | +| [`OBJECT Get help tip`](../commands/object-get-help-tip) | Todos | Headers, footers | +| [`OBJECT Get horizontal alignment`](../commands/object-get-horizontal-alignment) | Todos | List box, headers, footers, columns | +| [`OBJECT Get list reference`](../commands/object-get-list-reference) | Todos | Columnas | +| [`OBJECT Get name`](../commands/object-get-name) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT Get pointer`](../commands/object-get-pointer) | Todos | List box, headers, footers, rows, columns (see below) | +| [`OBJECT GET RESIZING OPTIONS`](../commands/object-get-resizing-options) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT GET RGB COLORS`](../commands/object-get-rgb-colors) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT GET SCROLL POSITION`](../commands/object-get-scroll-position) | Todos | List box | +| [`OBJECT GET SCROLLBAR`](../commands/object-get-scrollbar) | Todos | List box | +| [`OBJECT Get type`](../commands/object-get-type) | Todos | List box, headers, footers, columns | +| [`OBJECT Get vertical alignment`](../commands/object-get-vertical-alignment) | Todos | List box, headers, footers, columns | +| [`OBJECT MOVE`](../commands/object-move) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT SET COLOR`](../commands/object-set-color) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT SET COORDINATES`](../commands/object-set-coordinates) | Todos | List box | +| [`OBJECT SET DATA SOURCE`](../commands/object-set-data-source) | Todos | List box | +| [`OBJECT SET ENTERABLE`](../commands/object-set-enterable) | Todos | Columnas | +| [`OBJECT SET EVENTS`](../commands/object-set-events) | Todos | List box | +| [`OBJECT SET FOCUS RECTANGLE INVISIBLE`](../commands/object-set-focus-rectangle-invisible) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT SET FONT`](../commands/object-set-font) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT SET FONT SIZE`](../commands/object-set-font-size) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT SET FONT STYLE`](../commands/object-set-font-style) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT SET FORMAT`](../commands/object-set-format) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT SET HELP TIP`](../commands/object-set-help-tip) | Todos | Headers, footers | +| [`OBJECT SET HORIZONTAL ALIGNMENT`](../commands/object-set-horizontal-alignment) | Todos | List box, headers, footers, columns | +| [`OBJECT SET RESIZING OPTIONS`](../commands/object-set-resizing-options) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT SET RGB COLORS`](../commands/object-set-rgb-colors) | Todos | List box, headers, footers, rows, columns | +| [`OBJECT SET SCROLL POSITION`](../commands/object-set-scroll-position) | Todos | List box | +| [`OBJECT SET SCROLLBAR`](../commands/object-set-scrollbar) | Todos | List box. Scrolls the list box rows so that the first selected row or a specified row is displayed | +| [`OBJECT SET TITLE`](../commands/object-set-title) | Todos | Encabezados | +| [`OBJECT SET VERTICAL ALIGNMENT`](../commands/object-set-vertical-alignment) | Todos | List box, headers, footers, columns | +| [`OBJECT SET VISIBLE`](../commands/object-set-visible) | Todos | List box, headers, footers | + +When [`OBJECT SET VISIBLE`](../commands/object-set-visible) is used with a header or footer, it is applied on all List box object headers or footers, regardless of the individual element set by the command. For example, the `OBJECT SET VISIBLE(*;"header3";False)` statement will hide all headers in the List box object to which *header3* belongs and not simply this header. Note that in order for you to be able to manage the visibility of these objects using the [`OBJECT SET VISIBLE`](../commands/object-set-visible) command, they must have been displayed in the list box properties. + +### OBJECT Get pointer + +The [`OBJECT Get pointer`](../commands/object-get-pointer) command used with the `Object with focus` or `Object current` constant can be used in the object method of a list box or a list box column. They return a pointer to the list box, the list box column (see note below) or the header variable depending on the type of [form event](../Events/overview.md). The following table details this functioning: + +| Evento | Object with focus | Object current | +| -------------------------------------------------------- | ------------------------------------------ | ------------------------------------------ | +| [`On Clicked`](../Events/onClicked.md) | list box | column | +| [`On Double Clicked`](../Events/onDoubleClicked.md) | list box | column | +| [`On Before Keystroke`](../Events/onBeforeKeystroke.md) | column | column | +| [`On After Keystroke`](../Events/onAfterKeystroke.md) | column | column | +| [`On After Edit`](../Events/onAfterEdit.md) | column | column | +| [`On Getting Focus`](../Events/onGettingFocus.md) | column or list box (\*) | column or list box (\*) | +| [`On Losing Focus`](../Events/onLosingFocus.md) | column or list box (\*) | column or list box (\*) | +| [`On Drop`](../Events/onDrop.md) | list box (source) | list box (\*) | +| [`On Drag Over`](../Events/onDragOver.md) | list box (source) | list box (\*) | +| [`On Begin Drag Over`](../Events/onBeginDragOver.md) | list box | list box (\*) | +| [`On Mouse Enter`](../Events/onMouseEnter.md) | list box (\*\*) | list box (\*\*) | +| [`On Mouse Move`](../Events/onMouseMove.md) | list box (\*\*) | list box (\*\*) | +| [`On Mouse Leave`](../Events/onMouseLeave.md) | list box (\*\*) | list box (\*\*) | +| [`On Data Change`](../Events/onDataChange.md) | column | column | +| [`On Selection Change`](../Events/onSelectionChange.md) | list box (\*\*) | list box (\*\*) | +| [`On Before Data Entry`](../Events/onBeforeDataEntry.md) | column | column | +| [`On Column Moved`](../Events/onColumnMoved.md) | list box | column | +| [`On Row Moved`](../Events/onRowMoved.md) | list box | list box | +| [`On Column Resize`](../Events/onColumnResize.md) | list box | column | +| [`On Open Detail`](../Events/onOpenDetail.md) | Nil | list box (\*\*) | +| [`On Close Detail`](../Events/onCloseDetail.md) | Nil | list box (\*\*) | +| [`On Header Click`](../Events/onHeaderClick.md) | list box | header | +| [`On Footer Click`](../Events/onFooterClick.md) | list box | footer | +| [`On After Sort`](../Events/onAfterSort.md) | list box | header | + +(\*) When the focus is modified within a list box, a pointer to the column is returned. When the focus is modified at the overall form level, a pointer to the list box is returned. In the context of a column object method, a pointer to the column is returned. +(\*\*) Not executed in the context of a column object method. + +:::note + +When a pointer to a column is returned, the object pointed to depends on the type of list box. With an array type list box, the `OBJECT Get pointer` command returns a pointer to the column of the list box with the focus (i.e. to an array). The 4D pointer mechanism allows you to see the item number of the modified array. For example, supposing a user modified the 5th line of the column col2: +```4d + $Column:=OBJECT Get pointer(Object with focus) + //$Column contains a pointer to col2 + $Row:=$Column-> //$Row equals 5 +``` + +::: +For a selection type list box, the `OBJECT Get pointer` command returns: +- For a column associated with a field, a pointer to the associated field, +- For a column associated with a variable, a pointer to the variable, +- For a column associated with an expression, the `Is nil pointer` pointer. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/picturePopupMenu_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/picturePopupMenu_overview.md index e91847907a4c6e..7cbfd790806046 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/picturePopupMenu_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/picturePopupMenu_overview.md @@ -17,7 +17,7 @@ Puede gestionar los menús emergentes de imágenes utilizando métodos. Puede ge ### Ir a la página -You can assign the `gotoPage` [standard action](/Desktop/standard-actions) to a picture pop-up menu. Cuando se selecciona esa acción, 4D mostrará automáticamente la página del formulario que corresponde a la posición de la imagen seleccionada en el array de imágenes. Los elementos se numeran de izquierda a derecha y de arriba a abajo, empezando por la esquina superior izquierda. +Puede asignar la [acción estándar](/Desktop/standard-actions) `gotoPage` a un menú emergente de imagen. Cuando se selecciona esa acción, 4D mostrará automáticamente la página del formulario que corresponde a la posición de la imagen seleccionada en el array de imágenes. Los elementos se numeran de izquierda a derecha y de arriba a abajo, empezando por la esquina superior izquierda. Por ejemplo, si el usuario selecciona el tercer elemento, 4D mostrará la página 3 del formulario actual (si existe). Si desea gestionar usted mismo el efecto de un clic, seleccione `Sin acción`. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Entry.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Entry.md index 85ba3cdc6f413f..e205cf13a61c3d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Entry.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Entry.md @@ -7,11 +7,11 @@ title: Entrada 4D incluye funcionalidades de corrección ortográfica integradas y personalizables. Se pueden verificar las [entradas](input_overview.md) de tipo texto, así como también los documentos [4D Write Pro](writeProArea_overview.md). -La propiedad de corrección ortográfica automática activa la corrección ortográfica de cada objeto. Cuando se utiliza, se realiza automáticamente una corrección ortográfica durante la entrada de datos. You can also execute the [`SPELL CHECKING`](../commands/spell-checking) 4D language command for each object to be checked. +La propiedad de corrección ortográfica automática activa la corrección ortográfica de cada objeto. Cuando se utiliza, se realiza automáticamente una corrección ortográfica durante la entrada de datos. También puede ejecutar el comando del lenguaje 4D [`SPELL CHECKING`](../commands/spell-checking) para cada objeto que desee revisar. :::note Herramientas de escritura (macOS) -On macOS, if you want to provide your users with Apple Intelligence Writing Tools so that they can spellcheck their documents using IA, you might consider using the [Writing Tools](#writing-tools) property. +En macOS, si quiere ofrecer a sus usuarios las herramientas de escritura de Apple Intelligence para que puedan revisar la ortografía de sus documentos mediante IA, podría considerar utilizar la propiedad [Herramientas de escritura](#writing-tools). ::: @@ -257,7 +257,7 @@ Puede utilizar una referencia XLIFF en la forma ":xliff:resname" como marcador d Sólo se pasa la referencia en el campo "Marcador de posición"; no es posible combinar una referencia con texto estático. -> También puedes definir y obtener el texto del marcador de posición por programación utilizando los comandos [`OBJECT SET PLACEHOLDER`](../commands/object-set-placeholder) y [`OBJECT Get placeholder`](../commands/object-get-placeholder). +> También puede definir y obtener el texto del marcador de posición por programación utilizando los comandos [`OBJECT SET PLACEHOLDER`](../commands/object-set-placeholder) y [`OBJECT Get placeholder`](../commands/object-get-placeholder). #### Gramática JSON @@ -352,9 +352,9 @@ Cuando esta opción no está activa, los usuarios deben seleccionar primero la l --- -## Writing Tools +## Herramientas de escritura -On macOS, this property lets end users apply [Apple Intelligence **Writing Tools**](https://support.apple.com/guide/mac-help/find-the-right-words-with-writing-tools-mchldcd6c260/mac) to the text of [4D Write Pro](writeProArea_overview.md) and [input](input_overview.md) (with [multiline](#multiline) support) form objects. Writing Tools use AI to proofread, rewrite, summarize, or change the tone of text directly within your 4D application. +En macOS, esta propiedad permite a los usuarios finales aplicar las [**Herramientas de escritura** de Apple Intelligence](https://support.apple.com/guide/mac-help/find-the-right-words-with-writing-tools-mchldcd6c260/mac) al texto de los objetos de formulario [4D Write Pro](writeProArea_overview.md) y [entrada](input_overview.md) (con soporte para [varias líneas](#multiline)). Writing Tools use AI to proofread, rewrite, summarize, or change the tone of text directly within your 4D application. ![](../assets/en/FormObjects/writing-tools.png) @@ -383,12 +383,12 @@ The Writing Tools feature relies on **Apple Intelligence** and is only available ::: -The availability and default value of the property depend on the object type: +La disponibilidad y el valor por defecto de la propiedad dependen del tipo de objeto: -| Object | Disponibilidad en la lista de propiedades | Valor por defecto | -| --------------------------------------------- | ----------------------------------------------------------------------------- | ----------------- | -| [Entrada](input_overview.md) | Only when the [Multiline](#multiline) property is set to "Yes" or "Automatic" | False | -| [Área 4D Write Pro](writeProArea_overview.md) | Always displayed | True | +| Object | Disponibilidad en la lista de propiedades | Valor por defecto | +| --------------------------------------------- | ---------------------------------------------------------------------------------------- | ----------------- | +| [Entrada](input_overview.md) | Sólo cuando la propiedad [Multiline](#multiline) está establecida en "Sí" o "Automático" | False | +| [Área 4D Write Pro](writeProArea_overview.md) | Always displayed | True | #### Gramática JSON diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Text.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Text.md index c3fa3bd41b4980..ea5fc50f82a51a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Text.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/properties_Text.md @@ -434,7 +434,7 @@ Por defecto, esta opción no está activa. #### Comandos -[LISTBOX Get property](../commands/listbox-get-property) - [LISTBOX SET PROPERTY](../commands/listbox-set-property) - [OBJECT Is styled text](../commands/object-is-styled-text) +[LISTBOX Get property](../commands/listbox-get-property) - [LISTBOX SET PROPERTY](../commands/listbox-set-property) - [OBJECT Is styled text](../commands/object-is-styled-text) - ["Styled Text" theme](../ommands/theme/Styled_Text.md) ### Etiquetas soportadas @@ -513,6 +513,89 @@ En el caso de los atributos de color de fuente y de fondo, el valor del color pu ![](../assets/en/FormObjects/colors1.png) ![](../assets/en/FormObjects/colors2.png) +### Trabajando con comandos de manejo de texto + +#### Interfaz de usuario + +Los comandos que pueden utilizarse para manipular objetos de texto por programación no tienen en cuenta ninguna etiqueta de estilo integrada en el texto. Sólo actúan sobre el texto visualizado. Esto afecta a los siguientes comandos: + +- comandos del tema [Interfaz de usuario](../commands/theme/User_Interface.md) +- [`HIGHLIGHT TEXT`](../commands/highlight-text) +- [`GET HIGHLIGHT`](../commands/get-highlight) + +Cuando se utilizan estos comandos con comandos que manipulan cadenas de caracteres, es necesario filtrar los caracteres de formato utilizando el comando [`ST Get plain text`](../commands/st-get-plain-text): + +```4d + HIGHLIGHT TEXT([Products]Notes;1;Length(ST Get plain text([Products]Notes))+1) +``` + +#### Objetos (formularios) + +Los comandos que se pueden utilizar para modificar el estilo de los objetos (por ejemplo, [`OBJECT SET FONT`](../commands/object-set-font)) se aplican a todo el objeto y no a la selección. + +Si el objeto no tiene el foco cuando se ejecuta el comando, la modificación se aplica simultáneamente al objeto (el área de texto) y a su variable asociada. Si el objeto tiene el foco, la modificación se aplica al objeto, pero no a la variable asociada. La modificación solo se aplica a la variable cuando el objeto pierde el foco. Tenga presente este principio a la hora de programar áreas de texto. + +:::note + +Si la opción [**Guardar con etiquetas de estilo predeterminadas**](#store-with-default-style-tags) está marcada para el objeto, el uso de estos comandos provocará una modificación de las etiquetas guardadas con cada objeto. + +::: + +Tenga en cuenta también que sólo las propiedades por defecto son afectadas por estos comandos (así como las propiedades guardadas por medio de las etiquetas predeterminadas). Las etiquetas de estilo personalizadas se mantienen tal y como están. Por ejemplo, se da un área de estilo múltiple donde se guardaron las etiquetas predeterminadas: + +![](../assets/en/FormObjects/multistyle-ex1.png) + +El texto sin formato del área es el siguiente: + +```html +This is the word red +``` + +Si ejecuta el siguiente código: + +```4d +OBJECT SET COLOR(*;"myArea";-(Blue+(256*Yellow))) +``` + +El color rojo permanece: + +![](../assets/en/FormObjects/multistyle-ex2.png) + +y el código es: + +```html +This is the word red +``` + +Se trata de los siguientes comandos: + +- [`OBJECT SET RGB COLORS`](../commands/object-set-rgb-colors) +- [`OBJECT SET FONT`](../commands/object-set-font) +- [`OBJECT SET FONT STYLE`](../commands/object-set-font-style) +- [`OBJECT SET FONT SIZE`](../commands/object-set-font-size) + +En el contexto de las áreas multiestilo, estos comandos sólo deben utilizarse para definir estilos por defecto. To manage styles during database execution, we recommend using the [commands of the "Styled Text" theme](../commands/theme/Styled_Text.md). + +#### Get edited text + +Cuando se utiliza con un área de texto enriquecido, el comando [`Get edited text`](../commands/get-edited-text) devuelve el texto del área actual, incluidas las etiquetas de estilo. + +Para recuperar el texto "sin formato" (texto sin etiquetas) que se está editando, debe utilizar el comando [`ST Get plain text`](../commands/st-get-plain-text): + +```4d +ST Get plain text(Get edited text) +``` + +#### Consulta y orden por comandos + +Las consultas y ordenaciones realizadas entre objetos con varios estilos tienen en cuenta las etiquetas de estilo guardadas en el objeto. Si se ha modificado el estilo de una palabra, la búsqueda de esa palabra no dará resultado. + +Para poder realizar búsquedas y ordenaciones válidas, debe utilizar el comando [`ST Get plain text`](../commands/st-get-plain-text). Por ejemplo: + +```4d +QUERY BY FORMULA([MyTable];ST Get plain text([MyTable]MyFieldStyle)="very well") +``` + --- ## Orientación diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/webArea_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/webArea_overview.md index f7f32e61f7edc6..8b06681530b5c8 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/webArea_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/webArea_overview.md @@ -165,7 +165,7 @@ $4d.calcSum(33, 45, 75, 102.5, 7, function(theSum) ## Acciones estándar -Existen cuatro acciones estándar específicas para gestionar automáticamente las áreas web: `Open Back URL`, `Open Forward URL`, `Refresh Current URL` y `Stop Loading URL`. Estas acciones pueden asociarse a botones o comandos de menú y permiten una rápida implementación de interfaces web básicas. These actions are described in [Standard actions](/Desktop/standard-actions). +Existen cuatro acciones estándar específicas para gestionar automáticamente las áreas web: `Open Back URL`, `Open Forward URL`, `Refresh Current URL` y `Stop Loading URL`. Estas acciones pueden asociarse a botones o comandos de menú y permiten una rápida implementación de interfaces web básicas. Estas acciones se describen en [Acciones estándar](/Desktop/standard-actions). ## Eventos formulario diff --git a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/writeProArea_overview.md b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/writeProArea_overview.md index 51a73ba3f8f039..e7b61408f8927b 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/writeProArea_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/FormObjects/writeProArea_overview.md @@ -13,7 +13,7 @@ Las áreas 4D Write Pro están documentadas en el manual [4D Write Pro](https:// ## Propiedades soportadas -[Auto Spellcheck](properties_Entry.md#auto-spellcheck) - [Border Line Style](properties_BackgroundAndBorder.md#border-line-style) - [Bottom](properties_CoordinatesAndSizing.md#bottom) - [Class](properties_Object.md#css-class) - [Context Menu](properties_Entry.md#context-menu) - [Draggable](properties_Action.md#draggable) - [Droppable](properties_Action.md#droppable) - [Enterable](properties_Entry.md#enterable) - [Focusable](properties_Entry.md#focusable) - [Height](properties_CoordinatesAndSizing.md#height) - [Hide focus rectangle](properties_Appearance.md#hide-focus-rectangle) - [Horizontal Scroll Bar](properties_Appearance.md#horizontal-scroll-bar) - [Horizontal Sizing](properties_ResizingOptions.md#horizontal-sizing) - [Keyboard Layout](properties_Entry.md#keyboard-layout) - [Left](properties_CoordinatesAndSizing.md#left) - [Method](properties_Action.md#method) - [Object Name](properties_Object.md#object-name) - [Print Variable Frame](properties_Print.md#print-frame) - [Resolution](properties_Appearance.md#resolution) - [Right](properties_CoordinatesAndSizing.md#right) - [Selection always visible](properties_Entry.md#selection-always-visible) - [Show background](properties_Appearance.md#show-background) - [Show footers](properties_Appearance.md#show-footers) - [Show headers](properties_Appearance.md#show-headers) - [Show hidden characters](properties_Appearance.md#show-hidden-characters) - [Show horizontal ruler](properties_Appearance.md#show-horizontal-ruler) - [Show HTML WYSIWYG](properties_Appearance.md#show-html-wysiwyg) - [Show page frame](properties_Appearance.md#show-page-frame) - [Show references](properties_Appearance.md#show-references) - [Show vertical ruler](properties_Appearance.md#show-vertical-ruler) - [Type](properties_Object.md#type) - [Vertical Sizing](properties_ResizingOptions.md#vertical-sizing) - [Vertical Scroll Bar](properties_Appearance.md#vertical-scroll-bar) - [View mode](properties_Appearance.md#view-mode) - [Visibility](properties_Display.md#visibility) - [Width](properties_CoordinatesAndSizing.md#width) - [Writing Tools](properties_Entry.md#writing-tools) - [Zoom](properties_Appearance.md#zoom) +[Corrector ortográfico automático](properties_Entry.md#auto-spellcheck) - [Estilo de línea de borde](properties_BackgroundAndBorder.md#border-line-style) - [Inferior](properties_CoordinatesAndSizing.md#bottom) - [Clase](properties_Object.md#css-class) - [Menú contextual](properties_Entry.md#context-menu) - [Arrastrable](properties_Action.md#draggable) - [Soltable](properties_Action.md#droppable) - [Editable](properties_Entry.md#enterable) - [Enfocable](properties_Entry.md#focusable) - [Alto](properties_CoordinatesAndSizing.md#height) - [Ocultar rectángulo de enfoque](properties_Appearance.md#hide-focus-rectangle) - [Barra de desplazamiento horizontal](properties_Appearance.md#horizontal-scroll-bar) - [Dimensionamiento horizontal](properties_ResizingOptions.md#horizontal-sizing) - [Disposición del teclado](properties_Entry.md#keyboard-layout) - [Izquierda](properties_CoordinatesAndSizing.md#left) - [Método](properties_Action.md#method) - [Nombre del objeto](properties_Object.md#object-name) - [Imprimir marco variable](properties_Print.md#print-frame) - [Resolución](properties_Appearance.md#resolution) - [Derecha](properties_CoordinatesAndSizing.md#right) - [Selección siempre visible](properties_Entry.md#selection-always-visible) - [Mostrar fondo](properties_Appearance.md#show-background) - [Mostrar pies de página](properties_Appearance.md#show-footers) - [Mostrar encabezados](properties_Appearance.md#show-headers) - [Mostrar caracteres ocultos](properties_Appearance.md#show-hidden-characters) - [Mostrar regla horizontal](properties_Appearance.md#show-horizontal-ruler) - [Mostrar HTML WYSIWYG](properties_Appearance.md#show-html-wysiwyg) - [Mostrar marco de página](properties_Appearance.md#show-page-frame) - [Mostrar referencias](properties_Appearance.md#show-references) - [Mostrar regla vertical](properties_Appearance.md#show-vertical-ruler) - [Tipo](properties_Object.md#type) - [Dimensionamiento vertical](properties_ResizingOptions.md#vertical-sizing) - [Barra de desplazamiento vertical](properties_Appearance.md#vertical-scroll-bar) - [Ver modo](properties_Appearance.md#view-mode) - [Visibilidad](properties_Display.md#visibility) - [Ancho](properties_CoordinatesAndSizing.md#width) - - [Herramientas de escritura](properties_Entry.md#writing-tools) - [Zoom](properties_Appearance.md#zoom) ## Eventos soportados diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md b/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md index 78dad656fbdbf5..3452247eb9e8b3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Notes/updates.md @@ -9,7 +9,7 @@ Lea [**Novedades en 4D 21 R4**](https://blog.4d.com/whats-new-in-4d-21-r4/), la #### Lo más destacado -- IA: On macOS, end users can enhance or summarize texts thanks to the Apple Intelligence **Writing Tools**, available as a [property](../FormObjects/properties_Entry.md#writing-tools) and a [standard action](../Desktop/standard-actions) for [4D Write Pro](../FormObjects/writeProArea_overview.md) and [input](../FormObjects/input_overview.md) form objects. +- AI: On macOS, end users can enhance or summarize texts thanks to the Apple Intelligence **Writing Tools**, available as a [property](../FormObjects/properties_Entry.md#writing-tools) and a [standard action](../Desktop/standard-actions) for [4D Write Pro](../FormObjects/writeProArea_overview.md) and [input](../FormObjects/input_overview.md) form objects. - Enhanced [support of client/server disconnections](../Desktop/clientServer.md#management-of-unreachable-peer) with QUIC network layer: new [`QUIC session timeout`](../commands/set-database-parameter#quick-session-timeout-135) database parameter, new [`unreachableSince` session.info](../API/SessionClass.md#info) property. - Las hojas de estilo para listas de varios niveles ya son [compatibles con 4D Write Pro Interface](../WritePro/writeprointerface#multi-level-list-style-sheets), lo que permite a los usuarios crear y gestionar listas estructuradas de varios niveles directamente desde la barra de herramientas y la barra lateral. - Nuevo comando [`defer`](../commands/defer) para declarar que un fragmento de código se ejecute siempre al salir de un método o una función; nuevo comando [`Deferred formulas`](../commands/deferred-formulas) para obtener la lista de fórmulas diferidas. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/Preferences/general.md b/i18n/es/docusaurus-plugin-content-docs/current/Preferences/general.md index 1473ea47e3c826..b9c32f48b9fe8a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/Preferences/general.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/Preferences/general.md @@ -94,7 +94,7 @@ Gracias a este principio, en macOS las carpetas de las bases aparecen como paque ### Incluir los tokens en los archivos fuente del proyecto -Cuando esta opción está marcada, los [archivos fuente de los métodos](../Project/architecture.md#sources) guardados en los nuevos proyectos 4D contendrán los **tokens** para los objetos clásicos del lenguaje y de la base (constantes, comandos, tablas y ca Los tokens son caracteres adicionales tales como `:C10` o `:5` insertados en los archivos de código fuente, que permiten renombrar las tablas y los campos e identificar elementos sea cual sea la versión 4D (ver [Utilización de tokens en las fórmulas](https://doc.4d.com/4Dv20/4D/20.6/Using-tokens-in-formulas.300-7487422.en.html)). Los tokens son caracteres adicionales tales como `:C10` o `:5` insertados en los archivos de código fuente, que permiten renombrar las tablas y los campos e identificar elementos sea cual sea la versión 4D (ver [Utilización de tokens en las fórmulas](https://doc.4d.com/4Dv20/4D/20.6/Using-tokens-in-formulas.300-7487422.en.html)). +When this option is checked, saved [method source files](../Project/architecture.md#sources) in new 4D projects will contain [**tokens** for classic language and database objects (constants, commands, tables and fields)](../Concepts/methods.md#language-tokens). Tokens are additional characters such as `:C10` or `:5` inserted in the source code files, that allow renaming tables and fields and identifying elements whatever the 4D version. Si tiene intención de utilizar VCS o los editores de código externos con sus nuevos proyectos, es posible que desee desmarcar esta opción para una mejor legibilidad del código con estas herramientas. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/monitor.md b/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/monitor.md index 1b6a08da6f3a39..8be406541374e1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/monitor.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/monitor.md @@ -34,7 +34,7 @@ El área "Visión general" ofrece diferente información sobre el sistema, la ap ![](../assets/en/Admin/server-licence-failed.png) -Usually, you will need to check the [**Licenses Manager**](Admin/licenses.md). +Generalmente, tendrá que verificar el [**Administrador de licencias**](Admin/licenses.md). ## Área Detalles diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/users.md b/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/users.md index afaf9b48530d9d..23425b10b3709f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/users.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ServerWindow/users.md @@ -27,7 +27,7 @@ Para cada usuario conectado al servidor, la lista ofrece la siguiente informaci - **Actividad**: ratio de tiempo que 4D Server dedica a este usuario (visualización dinámica). - **Status**: The following values can be displayed: - "Online" - the session is active - - "Sleeping" - the desktop client has switched to sleep mode (see below), + - "Suspensión" - el cliente de escritorio ha cambiado al modo suspensión (ver abajo), - "Unreachable" (with [QUIC network layer](../settings/client-server.md#network-layer) only) - the desktop client is unresponsive and 4D Server will [attempt to reconnect](../Desktop/clientServer.md#management-of-unreachable-peer) during the QUIC session timeout period. ### Gestión de usuarios dormidos diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-allowed-methods.md b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-allowed-methods.md index 1ae08353d64c4c..c2ea44298aaa03 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-allowed-methods.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-allowed-methods.md @@ -47,13 +47,13 @@ Usted quiere autorizar dos métodos en sus áreas 4D View Pro: ```4d var $allowed : Object -$allowed:=New object //parameter for the command +$allowed:=New object //parámetro para el comando -$allowed.Hello:=New object //create a first simple function named "Hello" -$allowed.Hello.method:="My_Hello_Method" //sets the 4D method +$allowed.Hello:=New object //crea una primera función simple llamada "Hello" +$allowed.Hello.method:="My_Hello_Method" //define el método 4D $allowed.Hello.summary:="Hello prints hello world" - -$allowed.Byebye:=New object //create a second function with parameters named "Byebye" + +$allowed.Byebye:=New object //crea una segunda función con parámetros llamada "Byebye" $allowed.Byebye.method:="My_ByeBye_Method" $allowed.Byebye.parameters:=New collection $allowed.Byebye.parameters.push(New object("name";"Message";"type";Is text)) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-column-attributes.md b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-column-attributes.md index dc20ea621ad904..37a00544cc6b13 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-column-attributes.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/ViewPro/commands/vp-set-column-attributes.md @@ -42,7 +42,7 @@ Para cambiar el tamaño de la segunda columna y definir el encabezado, se escrib ```4d var $column; $properties : Object -$column:=VP Column("ViewProArea";1) //column B +$column:=VP Column("ViewProArea";1) //columna B $properties:=New object("width";100;"header";"Hello World") VP SET COLUMN ATTRIBUTES($column;$properties) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md index be7509653e3c69..38d32df6267f3f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WebServer/http-request-handler.md @@ -28,7 +28,7 @@ Since HTTP Request handler functions are called from standard web requests (they Sin embargo, estas funciones necesitan tener **permisos** apropiados, como todas las peticiones ejecutadas desde procesos web. When the handler function is called, the **privileges** of its web session must allow the code to run properly. Cualquier otro recurso al que se acceda dentro del código (datos, otras funciones...) también deben estar permitidos por los permisos. -In [*restricted mode by default*](../ORDA/privileges.md#restriction-modes), if a HTTP Request handler can open a new, unauthenticated session (which is the case for example when your application provides **deep linking** feature), you need to make sure that the *guest* privilege is allowed to execute the handler function and access all subsequent resources. +En [*modo restringido por defecto*](../ORDA/privileges.md#restriction-modes), si un controlador de peticiones HTTP puede abrir una nueva sesión sin autenticar (lo cual ocurre, por ejemplo, cuando su aplicación ofrece la función de **enlaces profundos**), debe asegurarse de que se conceda el privilegio *invitado* para ejecutar la función del controlador y acceder a todos los recursos posteriores. Si una función HTTP Request handler puede ejecutarse dentro de una sesión ya autenticada, debe asegurarse de que la sesión de usuario está autorizada para ejecutar la función handler y acceder a todos los recursos posteriores. Note that this can also happen with deep linking if you copy/paste the link into a browser where you are already authenticated for the application and the session is still active. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-picture.md b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-picture.md index 0156053ff1d2a2..d7247e67a75038 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-picture.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/commands/wp-insert-picture.md @@ -38,6 +38,7 @@ Para el segundo parámetro, puede pasar cualquiera de los dos: - Campo o variable de imagen - Cadena que contiene una ruta a un archivo de imagen almacenado en disco, en la sintaxis del sistema. Si utiliza una cadena, puede pasar un nombre de ruta completo o un nombre de ruta relativo al archivo de estructura de la base de datos. También puede pasar un nombre de archivo, en cuyo caso el archivo debe estar situado junto al archivo de estructura de la base de datos. También puede pasar un nombre de archivo, en cuyo caso el archivo debe estar situado junto al archivo de estructura de la base de datos. + - En *pictureFile* : un objeto `File` que representa un archivo imagen o una ruta. Todo formato imagen [soportado por 4D](../../FormEditor/pictures.md#native-formats-supported) puede ser usado. Puede obtener la lista de formatos de imagen disponibles usando el comando [PICTURE CODEC LIST](../../commands/picture-codec-list). Si la imagen encapsula varios formatos (codecs), 4D Write Pro solo mantiene un formato para la visualización y otro para la impresión (si son diferentes) en el documento; los "mejores" formatos se seleccionan automáticamente. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/user/user-new.md b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/user/user-new.md index 66848fb81202ff..7c02c4a8486a01 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/WritePro/user/user-new.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/WritePro/user/user-new.md @@ -65,9 +65,9 @@ Listas de varios niveles pueden ser gestionadas usando: ## Hojas de estilo para listas de varios niveles -Multi-level list style sheets are used to create [multi-level lists](../user-legacy/using-a-4d-write-pro-area.md#multi-level-lists). +Las hojas de estilo para listas de varios niveles se utilizan para crear [listas de varios niveles](../user-legacy/using-a-4d-write-pro-area.md#multi-level-lists). -To create a multi-level list style sheet, use [WP New style sheet](../commands/wp-new-style-sheet.md) and pass in *listLevelCount* the desired number of levels. You then define a hierarchy of related paragraph style sheets: one **root-level** style sheet and one or more **sub-level** style sheets linked to it. Cada nivel representa una profundidad en la lista (nivel 1, nivel 2, nivel 3, etc.) and is automatically named "root-level name + lvl + index", for example "Mylist lvl 2". +To create a multi-level list style sheet, use [WP New style sheet](../commands/wp-new-style-sheet.md) and pass in *listLevelCount* the desired number of levels. You then define a hierarchy of related paragraph style sheets: one **root-level** style sheet and one or more **sub-level** style sheets linked to it. Cada nivel representa una profundidad en la lista (nivel 1, nivel 2, nivel 3, etc.) y se llama automáticamente "Nombre de nivel raíz + nvl + índice", por ejemplo "Mylist lvl 2". To customize multi-level list styles, the paragraph style sheet object can be customized using [style sheet attributes](../commands-legacy/4d-write-pro-attributes.md#style-sheets). @@ -117,7 +117,7 @@ resultado: ### Valores de atributos predefinidos -When created, multi-level list style sheets use predefined values: +Al crearse, las hojas de estilo de listas de varios niveles utilizan valores predefinidos: - `wk margin left` = 0,75 cm \* (número de niveles anteriores) o 0,25 pulgadas \* (número de niveles anteriores), dependiendo de la unidad de diseño actual - `wk list type` = `wk decimal` diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop1.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop1.png new file mode 100644 index 00000000000000..69d86f478af2c8 Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop1.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop2.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop2.png new file mode 100644 index 00000000000000..669e20441b7e5f Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop2.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop3.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop3.png new file mode 100644 index 00000000000000..e3b622f42e4b17 Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop3.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop4.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop4.png new file mode 100644 index 00000000000000..b398386d8f07bc Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop4.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop5.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop5.png new file mode 100644 index 00000000000000..5dd212126556ee Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop5.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop6.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop6.png new file mode 100644 index 00000000000000..4380a47cefc426 Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop6.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop7.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop7.png new file mode 100644 index 00000000000000..7bed26ebeb1859 Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Desktop/dragdrop7.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Develop/relations.png b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Develop/relations.png new file mode 100644 index 00000000000000..cba02ce581035d Binary files /dev/null and b/i18n/es/docusaurus-plugin-content-docs/current/assets/en/Develop/relations.png differ diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML.md index 318c66648aa12f..137d961f3023a5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML.md @@ -12,60 +12,4 @@ slug: /commands/theme/XML | [](../../commands/xml-get-options)
| | [](../../commands/xml-set-options)
| -## Visión general de los comandos XML - -:::note - -Para soporte XML, 4D utiliza la [librería Xerces.dll](../../Notes/updates.md#library-table) desarrollada por la empresa Fundación Apache. - -::: - -### XML, DOM y SAX - -El tema **XML** agrupa los comandos "utilities" XML genéricos de 4D. Estos son comandos relacionados con la gestión de opciones y de errores. - -4D también ofrece dos conjuntos distintos de comandos XML: [**DOM**](../theme/XML_DOM.md) (Modelo de objetos de documento) y [**SAX**](../theme/XML_SAX.md) (API XML simple) son dos modos diferentes de análisis de documentos XML. - -- El modo DOM analiza una fuente XML y construye su estructura (su "árbol") en la memoria. Por este motivo, el acceso a cada elemento del código fuente es extremadamente rápido. Sin embargo, dado que toda la estructura de árbol se almacena en memoria, el procesamiento de documentos XML de gran tamaño puede provocar que se supere la capacidad de memoria y, por lo tanto, dar lugar a errores. -- El modo SAX no crea una estructura de árbol en la memoria. En este modo, se generan "eventos" (como el inicio y el final de un elemento) al analizar el código fuente. Este modo le permite analizar documentos XML de cualquier tamaño, independientemente de la cantidad de memoria disponible. - -#### Ver también - -http://www.saxproject.org/?selected=event
-http://www.w3schools.com/xml/ - -### Modo apropiativo - -Las referencias XML creadas por un [proceso preventivo](../../Develop/preemptive.md) solo pueden utilizarse en ese proceso concreto. Por el contrario, las referencias XML creadas por un proceso cooperativo pueden ser utilizadas por cualquier otro proceso cooperativo, pero no pueden ser utilizadas por ningún proceso preemptivo. - -### Conjuntos de caracteres - -Los siguientes conjuntos de caracteres son soportados por los comandos XML DOM y XML SAX de 4D: - -- ASCII -- UTF-8 -- UTF-16 (Big/Small Endian) -- UCS4 (Big/Small Endian) -- Las codificaciones de las páginas de códigos EBCDIC IBM037, IBM1047 e IBM1140, -- ISO-8859-1 (o Latin1) -- Windows-1252. - -### Glosario - -Esta lista no exhaustiva detalla los principales conceptos XML utilizados por los comandos y funciones de 4D. - -- **Atributo**: subetiqueta XML asociada a un elemento. Un atributo siempre contiene un nombre y un valor. -- **Child**: en una estructura XML, un elemento en un nivel directamente por debajo de otro. -- **DTD**: *Document Type Declaration*. El DTD recoge el conjunto de reglas y propiedades específicas que debe cumplir el XML. Estas reglas definen, más concretamente, el nombre y el contenido de cada etiqueta así como su contexto. Esta formalización de los elementos puede utilizarse para comprobar si un documento XML es conforme (en cuyo caso, se declara "válido"). El DTD puede ser incluido en el documento XML (DTD interno) o en un documento separado (DTD externo). Tenga en cuenta que la DTD no es obligatoria. -- **Elemento**: una etiqueta XML. Un elemento siempre contiene un nombre y un valor. Opcionalmente, un elemento puede contener atributos. -- **ElementRef**: referencia XML usada por los comandos 4D XML para especificar una estructura XML. Esta referencia está compuesta por 8 caracteres codificados en formato hexadecimal, lo que significa que su longitud es de 32 caracteres en un sistema de 64 bits. Se recomienda declarar las referencias XML como Texto. -- **Padre**: en una estructura XML, elemento situado en un nivel directamente superior a otro. -- **Análisis sintáctico, analizador sintáctico**: el proceso de analizar el contenido de un objeto estructurado con el fin de extraer información útil. -- **Raíz**: un elemento ubicado en el primer nivel de una estructura XML. -- **Elemento hermano**: un elemento que se encuentra al mismo nivel que otro. -- **Estructura**: objeto XML estructurado. Este objeto puede ser un documento, una variable o un elemento. -- **Validación**: un documento XML es "validado" por el analizador sintáctico cuando está "bien formado" y cumple las especificaciones DTD. -- **Bien formado**: un documento XML es declarado “bienformado” por el analizador cuando cumple con las especificaciones genéricas XML. -- **XML**: eXtensible Markup Language. Un estándar informatizado de intercambio de datos que permite la transferencia de datos, así como de su estructura. El lenguaje XML se basa en el uso de etiquetas y una sintaxis específica, en consonancia con el lenguaje HTML. Sin embargo, a diferencia de este último, el lenguaje XML permite definir etiquetas personalizadas. -- **XSL**: eXtensible Stylesheet Language. Un lenguaje que permite la definición de hojas de estilo utilizadas para procesar y mostrar los contenidos de un documento XSL. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML_DOM.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML_DOM.md index 905ab05b5e8e6c..ecc761f7022a24 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML_DOM.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML_DOM.md @@ -43,63 +43,4 @@ slug: /commands/theme/XML-DOM | [](../../commands/dom-set-xml-element-name)
| | [](../../commands/dom-set-xml-element-value)
| -## Visión general de los comandos XML DOM - -Consulte la sección [XML, DOM y SAX](../theme/XML.md#xml-dom-and-sax) para obtener una definición de XML DOM. - -### Creación, apertura y cierre de documentos XML mediante DOM - -Los objetos creados, modificados o analizados por los comandos DOM de 4D pueden ser texto, URLs, documentos o BLOBs. Los comandos DOM utilizados para abrir objetos XML en 4D son [`DOM Parse XML source`](../../commands/dom-parse-xml-source) y [`DOM Parse XML variable`](../../commands/dom-parse-xml-variable). - -Muchos comandos permiten leer, analizar y escribir los elementos y atributos. Los errores se recuperan utilizando el comando [`XML GET ERROR`](../../commands/xml-get-error). No olvide llamar al comando [`DOM CLOSE XML`](../../commands/dom-close-xml) para cerrar la fuente al final. - -Nota sobre el uso de parámetros BLOB XML: por razones históricas, los comandos XML como [`DOM Parse XML variable`](../../commands/dom-parse-xml-variable) aceptan parámetros de tipo BLOB. Sin embargo, se recomienda encarecidamente almacenar las estructuras XML como texto. El uso de BLOBs está reservado al tratamiento de datos binarios. Conforme con las especificaciones XML, los datos binarios se codifican automáticamente en Base64, incluso cuando el BLOB contiene texto. - -### Soporte de la notación XPath - -Varios comandos XML DOM ([`DOM Create XML element`](../../commands/dom-create-xml-element), [`DOM Find XML element`](../../commands/dom-find-xml-element), [`DOM Create XML element arrays`](../../commands/dom-create-xml-element-arrays) y [`DOM SET XML ELEMENT VALUE`](../../commands/dom-set-xml-element-value)) soportan algunas expresiones XPath para acceder a elementos XML. - -La notación XPath procede del lenguaje XPath, diseñado para navegar dentro de estructuras XML. Permite fijar elementos directamente dentro de una estructura XML mediante una sintaxis de tipo "pathname", sin tener que indicar necesariamente la ruta completa para llegar a ella. - -Por ejemplo, dada la siguiente estructura: - -```xml - - - - - - - -``` - -La notación XPath permite acceder al elemento 3 utilizando la sintaxis */RootElement/Elem1/Elem2/Elem3*. - -4D también acepta elementos XPath indexados utilizando la sintaxis *Element[ElementNum]*. Por ejemplo, dada la siguiente estructura: - -```xml - - - aaa - bbb - ccc - - -``` - -La notación XPath permite acceder al valor "ccc" utilizando la sintaxis */RootElement/Elem1/Elem2[3]*. - -Para una lista completa de expresiones XPath soportadas, consulte la descripción del comando [`DOM Find XML`](../../commands/dom-find-xml-element). - -:::note Compatibilidad - -A partir de 4D 18 R3, la implementación de XPath ha sido modificada para ser más compatible y soportar un conjunto más amplio de expresiones. Si desea beneficiarse de las funciones extendidas en sus bases de datos convertidas, deberá seleccionar la opción **Utilizar XPath estándar** de la [Página de compatibilidad](../../settings/compatibility.md). - -::: - -### Gestión de errores - -Muchas funciones de este tema devuelven una referencia a un elemento XML. Si se produce un error durante la ejecución de la función (por ejemplo, si la referencia al elemento raíz no es válida), la variable *OK* se pone en 0 y se genera un error. - -Además, la referencia devuelta en este caso es una secuencia de 32 caracteres cero "0". diff --git a/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML_SAX.md b/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML_SAX.md index acedc2b8a9e937..7a8fa02cfa15a0 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML_SAX.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/commands/theme/XML_SAX.md @@ -25,33 +25,4 @@ slug: /commands/theme/XML-SAX | [](../../commands/sax-open-xml-element-arrays)
| | [](../../commands/sax-set-xml-declaration)
| -## Visión general de los comandos XML SAX -Consulte la sección [XML, DOM y SAX](../theme/XML.md#xml-dom-and-sax) para obtener una definición de XML SAX. - -### Creación, apertura y cierre de documentos XML mediante SAX - -Los comandos SAX funcionan con las referencias de documento estándar de 4D (**DocRef**, una referencia de tipo Time). Por tanto, es posible utilizar estos comandos conjuntamente con los comandos 4D utilizados para gestionar documentos, como [`SEND PACKET`](../../commands/send-packet) o [`Append document`](../../commands/append-document). - -La creación y apertura de documentos XML por programación se lleva a cabo utilizando los comandos [`Create document`](../../commands/create-document) y [`Open document`](../../commands/open-document). Posteriormente, el uso de un comando XML con estos documentos provocará la activación automática de mecanismos XML como la codificación. Por ejemplo, la codificación `` el encabezado se escribirá automáticamente en el documento. - -:::note - -Los documentos que leen los comandos SAX deben abrirse en modo de solo lectura mediante el comando [`Open document`](../../commands/open-document). Esto evita cualquier conflicto entre 4D y la biblioteca Xerces cuando se abren documentos "normales" y XML simultáneamente. Si ejecuta un comando de análisis SAX con un documento abierto en modo de lectura-escritura, se muestra un mensaje de alerta y el análisis es imposible. - -::: - -El cierre de un documento XML debe realizarse mediante el comando [`CLOSE DOCUMENT`](../../commands/close-document). Si se abrieran algunos elementos XML, se cerrarán automáticamente. - -### Acerca de caracteres finales de línea y gestión de BOM - -Al generar documentos SAX, 4D utiliza los siguientes ajustes predeterminados para los caracteres de fin de línea y el uso de la máscara de orden de bytes (BOM): - -- Caracteres CRLF en Windows y LF en macOS para los caracteres de fin de línea -- archivos escritos sin BOM. - -:::note Compatibilidad - -En proyectos creados con versiones 4D hasta 19.x, por defecto 4D usa CRLF como caracteres finales de línea en macOS para SAX y un BOM. Puede controlar la administración `XML line ending` y `XML BOM` utilizando el comando [`XML SET OPTIONS`](../../commands/xml-set-options) y una [configuración de compatibilidad](../../settings/compatibility.md). Importante: dado que las líneas del archivo SAX se escriben directamente con cada instrucción, si necesita configurar las opciones BOM y/o de fin de línea, debe ejecutar el comando [`XML SET OPTIONS`](../../commands/xml-set-options) antes del primer comando de escritura SAX. - -::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/settings/database.md b/i18n/es/docusaurus-plugin-content-docs/current/settings/database.md index af09e61cc1c5ce..67e42d8d6ceaab 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/settings/database.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/settings/database.md @@ -114,20 +114,19 @@ Utilice los parámetros de esta pestaña para configurar la memoria caché de la - **Cálculo de caché adaptativa no marcado**: en este modo, usted mismo define el tamaño de la memoria caché para la base. 4D muestra entonces un área de entrada que permite configurar la memoria caché a utilizar, así como información relacionada con la memoria física (RAM disponible en la máquina), la caché actual y la caché tras el reinicio (teniendo en cuenta sus cambios). - El tamaño de la memoria caché que introduzca se reservará para la base 4D, independientemente del estado de los recursos de la máquina. Esta configuración puede utilizarse en determinadas configuraciones específicas, o cuando la base está diseñada para utilizarse en sistemas disímiles en cuanto a memoria. En la mayoría de los casos, la caché adaptativa ofrece un mejor rendimiento. +El tamaño de la memoria caché que introduzca se reservará para la base 4D, independientemente del estado de los recursos de la máquina. Esta configuración puede utilizarse en determinadas configuraciones específicas, o cuando la base está diseñada para utilizarse en sistemas disímiles en cuanto a memoria. En la mayoría de los casos, la caché adaptativa ofrece un mejor rendimiento. - **Escritura caché cada... Segundos/Minutos**: especifica el periodo de tiempo entre cada guardado automático de la caché de datos, es decir, su escritura en el disco. - 4D guarda los datos colocados en la caché a intervalos regulares. Puede especificar todo intervalo de tiempo entre 1 segundo y 500 minutos. Por defecto, 4D guarda sus datos cada 20 segundos. La aplicación también guarda sus datos en el disco cada vez que cambia a otro entorno o sale de la aplicación. También puede llamar al comando [FLUSH CACHE](../commands/flush-cache) para activar la escritura en cualquier momento. + 4D guarda los datos colocados en la caché a intervalos regulares. Puede especificar todo intervalo de tiempo entre 1 segundo y 500 minutos. Por defecto, 4D guarda sus datos cada 20 segundos. La aplicación también guarda sus datos en el disco cada vez que cambia a otro entorno o sale de la aplicación. You can also call the [`FLUSH CACHE`](../commands/flush-cache) command to trigger the flush at any moment. - Cuando prevea una entrada de muchos datos, considere la posibilidad de establecer un intervalo de tiempo breve entre guardados. En caso de corte del suministro eléctrico, sólo perderá los datos introducidos desde el último almacenamiento (si la base de datos funciona sin archivo de historial). +Cuando prevea una entrada de muchos datos, considere la posibilidad de establecer un intervalo de tiempo breve entre guardados. En caso de corte del suministro eléctrico, sólo perderá los datos introducidos desde el último almacenamiento (si la base de datos funciona sin archivo de historial). - Si la base de datos se ralentiza notablemente cada vez que se vacía la caché, deberá ajustar la frecuencia. Esta lentitud significa que se está guardando una gran cantidad de registros. Por lo tanto, un periodo más corto entre guardados sería más eficaz, ya que cada guardado implicaría menos registros y, por lo tanto, sería más rápido. +Si la base de datos se ralentiza notablemente cada vez que se vacía la caché, deberá ajustar la frecuencia. Esta lentitud significa que se está guardando una gran cantidad de registros. Por lo tanto, un periodo más corto entre guardados sería más eficaz, ya que cada guardado implicaría menos registros y, por lo tanto, sería más rápido. - Por defecto, 4D muestra una pequeña ventana cuando se vacía la caché. Si no desea este recordatorio visual, puede deseleccionar la opción **Escritura de caché** en la [página Interfaz](./interface.md). +Por defecto, 4D muestra una pequeña ventana cuando se vacía la caché. Si no desea este recordatorio visual, puede deseleccionar la opción **Escritura de caché** en la [página Interfaz](./interface.md). :::note Puede modificar temporalmente la frecuencia de escritura de la caché utilizando el [selector `Cache flush periodicity` del comando `SET DATABASE PARAMETER`](../commands/set-database-parameter#cache-flush-periodicity-95). ::: - diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md index 42c2faed6bd0fd..cb5fe9010ea5f9 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/API/DataClassClass.md @@ -267,11 +267,11 @@ Para cada objeto de *objectCol*: * Si el objeto contiene una propiedad booleana "\__NEW" establecida en false (o no contiene una propiedad booleana "\__NEW"), la entidad se actualiza o se crea con los valores correspondientes de las propiedades del objeto. No se realiza ninguna comprobación con respecto a la llave primaria: * Si la llave primaria se da y existe, la entidad se actualiza. En este caso, la llave primaria puede darse tal cual o con una propiedad "\_\_KEY" (llenada con el valor de la llave primaria). - * If the primary key is given (as is) and does not exist, the entity is created + * Si se da la llave primaria (tal cual) y no existe, se crea la entidad * Si no se da la llave primaria, se crea la entidad y se asigna el valor de la llave primaria con respecto a las reglas estándar de la base de datos. * Si el objeto contiene una propiedad booleana "\_\_NEW" establecida como **true**, la entidad se crea con los valores correspondientes de los atributos del objeto. Se realiza una verificación con respecto a la llave primaria: * Si se da la llave primaria (tal cual) y existe, se envía un error - * If the primary key is given (as is) and does not exist, the entity is created + * Si se da la llave primaria (tal cual) y no existe, se crea la entidad * Si no se da la primaria, se crea la entidad y se asigna el valor de la llave primaria con respecto a las reglas estándar de la base de datos. > The nested objects featuring related entities must contain a "\_\_KEY" property (filled with the primary key value of the related entity) or the primary key attribute of the related entity itself. The use of a \_\_KEY property allows independence from the primary key attribute name. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/API/Directory.md b/i18n/es/docusaurus-plugin-content-docs/version-20/API/Directory.md index 9c6488caca9910..93aef2e263f21a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/API/Directory.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/API/Directory.md @@ -514,7 +514,7 @@ $myPDF:=Folder(fk documents folder).file("Pictures/info.pdf") La función `.files()` devuelve una colección de objetos `File` contenidos en la carpeta. > Los alias o enlaces simbólicos no se resuelven. -Por defecto, si se omite el parámetro *options*, sólo se devuelven en la colección los archivos del primer nivel de la carpeta, así como los archivos o carpetas invisibles. Puede modificar esto pasando, en el parámetro *options*, una o varias de las siguientes constantes: +By default, if you omit the *options* parameter, only the files at the first level of the folder are returned in the collection, including invisible files. Puede modificar esto pasando, en el parámetro *options*, una o varias de las siguientes constantes: | Constante | Valor | Comentario | | --------------------- | ----- | ------------------------------------------------------------------------------- | diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md index bc0a8c27444292..cd40d04c758c53 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/API/IMAPTransporterClass.md @@ -72,18 +72,18 @@ El comando `IMAP New transporter` ](#acceptunsecureconnection)    | False | -| .**accessTokenOAuth2**: Text
.**accessTokenOAuth2**: Object
Cadena de texto u objeto token que representa las credenciales de autorización OAuth2. Sólo se utiliza con OAUTH2 `authenticationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). No se devuelve en el objeto *[IMAP transporter](#imap-transporter-object)*. | ninguno | -| [](#authenticationmode)    | the most secure authentication mode supported by the server is used | -| [](#checkconnectiondelay)    | 300 | -| [](#connectiontimeout)    | 30 | -| [](#host)    | *mandatory* | -| [](#logfile)    | ninguno | -| .**password**: Text
Contraseña de usuario para la autenticación en el servidor. No se devuelve en el objeto *[IMAP transporter](#imap-transporter-object)*. | ninguno | -| [](#port)    | 993 | -| [](#user)    | ninguno | +| *server* | Valor por defecto (si se omite) | +| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | +| [](#acceptunsecureconnection)    | False | +| .**accessTokenOAuth2**: Text
.**accessTokenOAuth2**: Object
Cadena de texto u objeto token que representa las credenciales de autorización OAuth2. Sólo se utiliza con OAUTH2 `authenticationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). No se devuelve en el objeto *[IMAP transporter](#imap-transporter-object)*. | ninguno | +| [](#authenticationmode)    | se utiliza el modo de autenticación más seguro soportado por el servidor | +| [](#checkconnectiondelay)    | 300 | +| [](#connectiontimeout)    | 30 | +| [](#host)    | *mandatory* | +| [](#logfile)    | ninguno | +| .**password**: Text
Contraseña de usuario para la autenticación en el servidor. No se devuelve en el objeto *[IMAP transporter](#imap-transporter-object)*. | ninguno | +| [](#port)    | 993 | +| [](#user)    | ninguno | > **Atención**: asegúrese de que el tiempo de espera definido sea menor que el tiempo de espera del servidor, de lo contrario el tiempo de espera del cliente será inútil. #### Resultado diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/API/SMTPTransporterClass.md b/i18n/es/docusaurus-plugin-content-docs/version-20/API/SMTPTransporterClass.md index 5ac28ef10c3dca..0ee8d324502894 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/API/SMTPTransporterClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/API/SMTPTransporterClass.md @@ -64,21 +64,21 @@ El comando `SMTP New transporter` ](#acceptunsecureconnection)    | False | -| .**accessTokenOAuth2**: Text
.**accessTokenOAuth2**: Object
Cadena de texto u objeto token que representa las credenciales de autorización OAuth2. Sólo se utiliza con OAUTH2 `authenticationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). Cadena de texto u objeto token que representan las credenciales de autorización OAuth 2. | ninguno | -| [](#authenticationmode)    | the most secure authentication mode supported by the server is used | -| [](#bodycharset)    | `mail mode UTF8` (US-ASCII_UTF8_QP) | -| [](#connectiontimeout)    | 30 | -| [](#headercharset)    | `mail mode UTF8` (US-ASCII_UTF8_QP) | -| [](#host)    | *mandatory* | -| [](#keepalive)    | True | -| [](#logfile)    | ninguno | -| **password**: Text
Contraseña usuario para la autenticación en el servidor. Cadena de texto u objeto token que representan las credenciales de autorización OAuth 2. | ninguno | -| [](#port)    | 587 | -| [](#sendtimeout)    | 100 | -| [](#user)    | ninguno | +| *server* | Valor por defecto (si se omite) | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | +| [](#acceptunsecureconnection)    | False | +| .**accessTokenOAuth2**: Text
.**accessTokenOAuth2**: Object
Cadena de texto u objeto token que representa las credenciales de autorización OAuth2. Sólo se utiliza con OAUTH2 `authenticationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). Cadena de texto u objeto token que representan las credenciales de autorización OAuth 2. | ninguno | +| [](#authenticationmode)    | se utiliza el modo de autenticación más seguro soportado por el servidor | +| [](#bodycharset)    | `mail mode UTF8` (US-ASCII_UTF8_QP) | +| [](#connectiontimeout)    | 30 | +| [](#headercharset)    | `mail mode UTF8` (US-ASCII_UTF8_QP) | +| [](#host)    | *mandatory* | +| [](#keepalive)    | True | +| [](#logfile)    | ninguno | +| **password**: Text
Contraseña usuario para la autenticación en el servidor. Cadena de texto u objeto token que representan las credenciales de autorización OAuth 2. | ninguno | +| [](#port)    | 587 | +| [](#sendtimeout)    | 100 | +| [](#user)    | ninguno | #### Resultado diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/Concepts/classes.md b/i18n/es/docusaurus-plugin-content-docs/version-20/Concepts/classes.md index 48a5b2995f5529..4629c0c113e4ca 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/Concepts/classes.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/Concepts/classes.md @@ -543,10 +543,10 @@ Class constructor ($side : Integer)
-|Parameter|Type||Description| +|Parámetro|Tipo||Descripción| |---|---|---|---| -|param|any|->|Parameter(s) to pass to the parent constructor| -|Result|Object|<-|Object's parent| +|param|cualquiera|->|Parámetro(s) que se deben pasar al constructor padre| +|Resultado|Object|<-|Object's parent|
diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/Desktop/building.md b/i18n/es/docusaurus-plugin-content-docs/version-20/Desktop/building.md index fa25abab7752e0..57ec5c29d9e419 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/Desktop/building.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/Desktop/building.md @@ -332,10 +332,10 @@ Puede marcar la opción **Permitir la actualización automática...** para las a Esta funcionalidad requiere que haga clic en el botón **[...]** y designe la ubicación en su disco del archivo que se utilizará para la actualización. El archivo a seleccionar depende de la plataforma actual del servidor: -| Plataforma del servidor actual | Archivo requerido | Detalles | -| ------------------------------ | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| macOS | Windows 4D Volume Desktop *o* Windows client update archive | By default, you can select the `4D Volume Desktop` application for Windows. However, **it is recommended** to select a `.4darchive` file previously built on Windows for proper icon management and to preserve a signed .exe after updates. To do so, press **Shift** while clicking on [...] | -| Windows | macOS client update archive | Seleccione un archivo `.4darchive` firmado previamente creado en macOS | +| Plataforma del servidor actual | Archivo requerido | Detalles | +| ------------------------------ | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| macOS | Windows 4D Volume Desktop *o* Windows client update archive | Por defecto, puede seleccionar la aplicación `Volumen 4D` para Windows. However, **it is recommended** to select a `.4darchive` file previously built on Windows for proper icon management and to preserve a signed .exe after updates. Para ello, presione **Mayús** mientras haces clic en [...] | +| Windows | macOS client update archive | Seleccione un archivo `.4darchive` firmado previamente creado en macOS | You can build a specific `.4darchive` file on the concurrent platform by selecting only the [**Build client application**](#build-client-application) and the appropriate [**Allow automatic update...**](#copy-of-client-applications-inside-the-server-application) option. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/listbox_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/listbox_overview.md index b141a423dc7a7b..716eb093219d5a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/listbox_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-20/FormObjects/listbox_overview.md @@ -389,7 +389,7 @@ Para definir un list box jerárquico, existen varias posibilidades: * Configurar manualmente los elementos jerárquicos utilizando la lista de propiedades del editor de formularios (o editar el formulario JSON). * Generar visualmente la jerarquía utilizando el menú emergente de gestión de list box, en el editor de formularios. -* Use the [LISTBOX SET HIERARCHY](https://doc.4d.com/4Dv20/4D/20.6/LISTBOX-SET-HIERARCHY.301-7487634.en.html) and [LISTBOX GET HIERARCHY](https://doc.4d.com/4Dv20/4D/20.6/LISTBOX-GET-HIERARCHY.301-7487597.en.html) commands, described in the *4D Language Reference* manual. +* Utilice los comandos [LISTBOX SET HIERARCHY](https://doc.4d.com/4Dv20/4D/20.6/LISTBOX-SET-HIERARCHY.301-7487634.en.html) y [LISTBOX GET HIERARCHY](https://doc.4d.com/4Dv20/4D/20.6/LISTBOX-GET-HIERARCHY.301-7487597.en.html) descritos en el manual *Referencia del lenguaje 4D*. #### Propiedades del List Box jerárquico diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/DataClassClass.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/DataClassClass.md index fb6f6fd366c607..65fa7bcf747f6d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/DataClassClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/DataClassClass.md @@ -272,11 +272,11 @@ Para cada objeto de *objectCol*: - Si el objeto contiene una propiedad booleana "\__NEW" establecida en false (o no contiene una propiedad booleana "\__NEW"), la entidad se actualiza o se crea con los valores correspondientes de las propiedades del objeto. No se realiza ninguna comprobación con respecto a la llave primaria: - Si la llave primaria se da y existe, la entidad se actualiza. En este caso, la llave primaria puede darse tal cual o con una propiedad "\_\_KEY" (llenada con el valor de la llave primaria). - - If the primary key is given (as is) and does not exist, the entity is created + - Si se da la llave primaria (tal cual) y no existe, se crea la entidad - Si no se da la llave primaria, se crea la entidad y se asigna el valor de la llave primaria con respecto a las reglas estándar de la base de datos. - Si el objeto contiene una propiedad booleana "\_\_NEW" definida como **true**, la entidad se crea con los valores correspondientes de los atributos del objeto. Se realiza una verificación con respecto a la llave primaria: - Si se da la llave primaria (tal cual) y existe, se envía un error - - If the primary key is given (as is) and does not exist, the entity is created + - Si se da la llave primaria (tal cual) y no existe, se crea la entidad - Si no se da la primaria, se crea la entidad y se asigna el valor de la llave primaria con respecto a las reglas estándar de la base de datos. > La propiedad "\__KEY" que contiene un valor sólo se tiene en cuenta cuando la propiedad "\__NEW" tiene el valor **false** (o se omite) y existe una entidad correspondiente. The use of a \_\_KEY property allows independence from the primary key attribute name. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/Directory.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/Directory.md index 7cb86982579008..2f940b4cc1b3c1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/Directory.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/Directory.md @@ -556,7 +556,7 @@ La función `.files()` devuelve una colec > Los alias o enlaces simbólicos no se resuelven. -Por defecto, si se omite el parámetro *options*, sólo se devuelven en la colección los archivos del primer nivel de la carpeta, así como los archivos o carpetas invisibles. Puede modificar esto pasando, en el parámetro *options*, una o varias de las siguientes constantes: +By default, if you omit the *options* parameter, only the files at the first level of the folder are returned in the collection, including invisible files. Puede modificar esto pasando, en el parámetro *options*, una o varias de las siguientes constantes: | Constante | Valor | Comentario | | --------------------- | ----- | ------------------------------------------------------------------------------- | diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/EntityClass.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/EntityClass.md index a15492bb8bbcfb..efd68a6c964da2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/EntityClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/API/EntityClass.md @@ -409,7 +409,7 @@ El objeto devuelto por `.drop()` contiene las siguientes propiedades: | `dk status validation failed` | 7 | Error no crítico enviado por el desarrollador para un [evento de validación](../ORDA/orda-events.md). **statusText asociado**: "Mild Validation Error" | | `dk status serious error` | 4 | Un error crítico es un error de bajo nivel de la base de datos (por ejemplo, una llave duplicada), un error de hardware, etc.
***statusText asociado***: "Other error" | | `dk status serious validation error` | 8 | Error crítico enviado por el desarrollador para un [evento de validación](../ORDA/orda-events.md). **statusText asociado**: "Serious Validation Error" | -| `dk status stamp has changed` | 2 | El valor del marcador interno (stamp) de la entidad no coincide con el de la entidad almacenada en los datos (bloqueo optimista).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used
  • **Associated statusText**: "Stamp has changed"
    • | +| `dk status stamp has changed` | 2 | El valor del marcador interno (stamp) de la entidad no coincide con el de la entidad almacenada en los datos (bloqueo optimista).
  • con `.save()`: error sólo si no se utiliza la opción `dk auto merge`.
  • con `.drop()`: error sólo si no se usa la opción `dk force drop if stamp changed`
  • con `.lock()`: error sólo si no se utiliza la opción `dk reload if stamp changed`.
  • **statusText asociado**: "Stamp has changed"
    • | | `dk status wrong permission` | 1 | Los privilegios actuales no permiten suprimir la entidad. **StatusText asociado**: "Permission Error" | #### Ejemplo 1 diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ServerWindow/monitor.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ServerWindow/monitor.md index 1b6a08da6f3a39..8be406541374e1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ServerWindow/monitor.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ServerWindow/monitor.md @@ -34,7 +34,7 @@ El área "Visión general" ofrece diferente información sobre el sistema, la ap ![](../assets/en/Admin/server-licence-failed.png) -Usually, you will need to check the [**Licenses Manager**](Admin/licenses.md). +Generalmente, tendrá que verificar el [**Administrador de licencias**](Admin/licenses.md). ## Área Detalles diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ViewPro/commands/vp-set-allowed-methods.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ViewPro/commands/vp-set-allowed-methods.md index 1ae08353d64c4c..c2ea44298aaa03 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ViewPro/commands/vp-set-allowed-methods.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ViewPro/commands/vp-set-allowed-methods.md @@ -47,13 +47,13 @@ Usted quiere autorizar dos métodos en sus áreas 4D View Pro: ```4d var $allowed : Object -$allowed:=New object //parameter for the command +$allowed:=New object //parámetro para el comando -$allowed.Hello:=New object //create a first simple function named "Hello" -$allowed.Hello.method:="My_Hello_Method" //sets the 4D method +$allowed.Hello:=New object //crea una primera función simple llamada "Hello" +$allowed.Hello.method:="My_Hello_Method" //define el método 4D $allowed.Hello.summary:="Hello prints hello world" - -$allowed.Byebye:=New object //create a second function with parameters named "Byebye" + +$allowed.Byebye:=New object //crea una segunda función con parámetros llamada "Byebye" $allowed.Byebye.method:="My_ByeBye_Method" $allowed.Byebye.parameters:=New collection $allowed.Byebye.parameters.push(New object("name";"Message";"type";Is text)) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ViewPro/commands/vp-set-column-attributes.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ViewPro/commands/vp-set-column-attributes.md index dc20ea621ad904..37a00544cc6b13 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ViewPro/commands/vp-set-column-attributes.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/ViewPro/commands/vp-set-column-attributes.md @@ -42,7 +42,7 @@ Para cambiar el tamaño de la segunda columna y definir el encabezado, se escrib ```4d var $column; $properties : Object -$column:=VP Column("ViewProArea";1) //column B +$column:=VP Column("ViewProArea";1) //columna B $properties:=New object("width";100;"header";"Hello World") VP SET COLUMN ATTRIBUTES($column;$properties) diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/WebServer/http-request-handler.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/WebServer/http-request-handler.md index 13425026621091..de90a7e8407115 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/WebServer/http-request-handler.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/WebServer/http-request-handler.md @@ -28,7 +28,7 @@ Since HTTP Request handler functions are called from standard web requests (they Sin embargo, estas funciones necesitan tener **permisos** apropiados, como todas las peticiones ejecutadas desde procesos web. When the handler function is called, the **privileges** of its web session must allow the code to run properly. Cualquier otro recurso al que se acceda dentro del código (datos, otras funciones...) también deben estar permitidos por los permisos. -In [*restricted mode by default*](../ORDA/privileges.md#restriction-modes), if a HTTP Request handler can open a new, unauthenticated session (which is the case for example when your application provides **deep linking** feature), you need to make sure that the *guest* privilege is allowed to execute the handler function and access all subsequent resources. +En [*modo restringido por defecto*](../ORDA/privileges.md#restriction-modes), si un controlador de peticiones HTTP puede abrir una nueva sesión sin autenticar (lo cual ocurre, por ejemplo, cuando su aplicación ofrece la función de **enlaces profundos**), debe asegurarse de que se conceda el privilegio *invitado* para ejecutar la función del controlador y acceder a todos los recursos posteriores. Si una función HTTP Request handler puede ejecutarse dentro de una sesión ya autenticada, debe asegurarse de que la sesión de usuario está autorizada para ejecutar la función handler y acceder a todos los recursos posteriores. Note that this can also happen with deep linking if you copy/paste the link into a browser where you are already authenticated for the application and the session is still active. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/imap-new-transporter.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/imap-new-transporter.md index aee7b4629d592d..dce455319860cf 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/imap-new-transporter.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/imap-new-transporter.md @@ -34,18 +34,18 @@ El comando `IMAP New transporter` ](../API/IMAPTransporterClass.md#acceptunsecureconnection)
    | False | -| .**accessTokenOAuth2**: Text
    .**accessTokenOAuth2**: Object
    Cadena u objeto token que representa las credenciales de autorización OAuth2. Utilizado sólo con OAUTH2 `authationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). No se devuelve en el objeto *[IMAP transporter](../API/IMAPTransporterClass.md#imap-transporter-object)*. | ninguno | -| [](../API/IMAPTransporterClass.md#authenticationmode)
    | the most secure authentication mode supported by the server is used | -| [](../API/IMAPTransporterClass.md#checkconnectiondelay)
    | 300 | -| [](../API/IMAPTransporterClass.md#connectiontimeout)
    | 30 | -| [](../API/IMAPTransporterClass.md#host)
    | *obligatorio* | -| [](../API/IMAPTransporterClass.md#logfile)
    | ninguno | -| .**password** : Text
    contraseña de usuario para la autenticación en el servidor. No se devuelve en el objeto *[IMAP transporter](../API/IMAPTransporterClass.md#imap-transporter-object)*. | ninguno | -| [](../API/IMAPTransporterClass.md#port)
    | 993 | -| [](../API/IMAPTransporterClass.md#user)
    | ninguno | +| *server* | Valor por defecto (si se omite) | +| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | +| [](../API/IMAPTransporterClass.md#acceptunsecureconnection)
    | False | +| .**accessTokenOAuth2**: Text
    .**accessTokenOAuth2**: Object
    Cadena u objeto token que representa las credenciales de autorización OAuth2. Utilizado sólo con OAUTH2 `authationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). No se devuelve en el objeto *[IMAP transporter](../API/IMAPTransporterClass.md#imap-transporter-object)*. | ninguno | +| [](../API/IMAPTransporterClass.md#authenticationmode)
    | se utiliza el modo de autenticación más seguro soportado por el servidor | +| [](../API/IMAPTransporterClass.md#checkconnectiondelay)
    | 300 | +| [](../API/IMAPTransporterClass.md#connectiontimeout)
    | 30 | +| [](../API/IMAPTransporterClass.md#host)
    | *obligatorio* | +| [](../API/IMAPTransporterClass.md#logfile)
    | ninguno | +| .**password** : Text
    contraseña de usuario para la autenticación en el servidor. No se devuelve en el objeto *[IMAP transporter](../API/IMAPTransporterClass.md#imap-transporter-object)*. | ninguno | +| [](../API/IMAPTransporterClass.md#port)
    | 993 | +| [](../API/IMAPTransporterClass.md#user)
    | ninguno | > **Atención**: asegúrese de que el tiempo de espera definido sea menor que el tiempo de espera del servidor, de lo contrario el tiempo de espera del cliente será inútil. diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/open-datastore.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/open-datastore.md index f119e717f889fe..285f98120a889d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/open-datastore.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/open-datastore.md @@ -39,7 +39,7 @@ El comando `Open datastore` conect Los intercambios con el almacén de datos remoto se gestionan automáticamente mediante solicitudes REST. La datastore 4D *connectionInfo* debe estar disponible como 4D remoto, es decir: - su servidor web debe ser lanzado con http y/o https activado, -- its datastore is exposed to REST ([**Expose as REST server**](REST/configuration.md#starting-the-rest-server) option checked), +- su datastore debe estar expuesto en REST ([opción **Activar el servicio REST**](REST/configuration.md#starting-the-rest-server)), - una licencia de cliente debe estar disponible si es necesario (ver nota). :::note diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/pop3-new-transporter.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/pop3-new-transporter.md index e11511d22fd9bb..08e00c57313831 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/pop3-new-transporter.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/pop3-new-transporter.md @@ -34,17 +34,17 @@ El comando `POP3 New transporter` ](../API/POP3TransporterClass.md#acceptunsecureconnection)
    | False | -| .**accessTokenOAuth2**: Text
    .**accessTokenOAuth2**: Object
    Cadena u objeto token que representa las credenciales de autorización OAuth2. Utilizado sólo con OAUTH2 `authationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). No se devuelve en el objeto *[POP3 transporter](../API/POP3TransporterClass.md#pop3-transporter-object)*. | ninguno | -| [](../API/POP3TransporterClass.md#authenticationmode)
    | the most secure authentication mode supported by the server is used | -| [](../API/POP3TransporterClass.md#connectiontimeout)
    | 30 | -| [](../API/POP3TransporterClass.md#host)
    | *obligatorio* | -| [](../API/POP3TransporterClass.md#logfile)
    | ninguno | -| **.password** : Text
    contraseña de usuario para la autenticación en el servidor. No se devuelve en el objeto *[POP3 transporter](../API/POP3TransporterClass.md#pop3-transporter-object)*. | ninguno | -| [](../API/POP3TransporterClass.md#port)
    | 995 | -| [](../API/POP3TransporterClass.md#user)
    | ninguno | +| *server* | Valor por defecto (si se omite) | +| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | +| [](../API/POP3TransporterClass.md#acceptunsecureconnection)
    | False | +| .**accessTokenOAuth2**: Text
    .**accessTokenOAuth2**: Object
    Cadena u objeto token que representa las credenciales de autorización OAuth2. Utilizado sólo con OAUTH2 `authationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). No se devuelve en el objeto *[POP3 transporter](../API/POP3TransporterClass.md#pop3-transporter-object)*. | ninguno | +| [](../API/POP3TransporterClass.md#authenticationmode)
    | se utiliza el modo de autenticación más seguro soportado por el servidor | +| [](../API/POP3TransporterClass.md#connectiontimeout)
    | 30 | +| [](../API/POP3TransporterClass.md#host)
    | *obligatorio* | +| [](../API/POP3TransporterClass.md#logfile)
    | ninguno | +| **.password** : Text
    contraseña de usuario para la autenticación en el servidor. No se devuelve en el objeto *[POP3 transporter](../API/POP3TransporterClass.md#pop3-transporter-object)*. | ninguno | +| [](../API/POP3TransporterClass.md#port)
    | 995 | +| [](../API/POP3TransporterClass.md#user)
    | ninguno | ## Resultado diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/smtp-new-transporter.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/smtp-new-transporter.md index d7f9ab0bc5a3d4..530879550701cd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/smtp-new-transporter.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R2/commands/smtp-new-transporter.md @@ -47,7 +47,7 @@ En el parámetro *server*, pase un objeto que contenga las siguientes propiedade | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | [](../API/SMTPTransporterClass.md#acceptunsecureconnection)
    | False | | .**accessTokenOAuth2**: Text
    .**accessTokenOAuth2**: Object
    Cadena u objeto token que representa las credenciales de autorización OAuth2. Utilizado sólo con OAUTH2 `authationMode`. Si se utiliza `accessTokenOAuth2` pero se omite `authenticationMode`, se utiliza el protocolo OAuth 2 (si el servidor lo permite). No se devuelve en el objeto *[SMTP transporter](../API/SMTPTransporterClass.md#smtp-transporter-object)*. | ninguno | -| [](../API/SMTPTransporterClass.md#authenticationmode)
    | the most secure authentication mode supported by the server is used | +| [](../API/SMTPTransporterClass.md#authenticationmode)
    | se utiliza el modo de autenticación más seguro soportado por el servidor | | [](../API/SMTPTransporterClass.md#bodycharset)
    | `mail mode UTF8` (US-ASCII_UTF8_QP) | | [](../API/SMTPTransporterClass.md#connectiontimeout)
    | 30 | | [](../API/SMTPTransporterClass.md#headercharset)
    | `mail mode UTF8` (US-ASCII_UTF8_QP) | diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/DataClassClass.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/DataClassClass.md index d3a094cd1c2f0d..fe1bafc9a7b8dd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/DataClassClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/DataClassClass.md @@ -272,11 +272,11 @@ Para cada objeto de *objectCol*: - Si el objeto contiene una propiedad booleana "\__NEW" establecida en false (o no contiene una propiedad booleana "\__NEW"), la entidad se actualiza o se crea con los valores correspondientes de las propiedades del objeto. No se realiza ninguna comprobación con respecto a la llave primaria: - Si la llave primaria se da y existe, la entidad se actualiza. En este caso, la llave primaria puede darse tal cual o con una propiedad "\_\_KEY" (llenada con el valor de la llave primaria). - - If the primary key is given (as is) and does not exist, the entity is created + - Si se da la llave primaria (tal cual) y no existe, se crea la entidad - Si no se da la llave primaria, se crea la entidad y se asigna el valor de la llave primaria con respecto a las reglas estándar de la base de datos. - Si el objeto contiene una propiedad booleana "\_\_NEW" definida como **true**, la entidad se crea con los valores correspondientes de los atributos del objeto. Se realiza una verificación con respecto a la llave primaria: - Si se da la llave primaria (tal cual) y existe, se envía un error - - If the primary key is given (as is) and does not exist, the entity is created + - Si se da la llave primaria (tal cual) y no existe, se crea la entidad - Si no se da la primaria, se crea la entidad y se asigna el valor de la llave primaria con respecto a las reglas estándar de la base de datos. > La propiedad "\__KEY" que contiene un valor sólo se tiene en cuenta cuando la propiedad "\__NEW" tiene el valor **false** (o se omite) y existe una entidad correspondiente. The use of a \_\_KEY property allows independence from the primary key attribute name. @@ -1257,7 +1257,7 @@ var $results := ds.MyClass.query("myVectorField > :1 order by myVectorField desc You will generally want vector similarity query results to be sorted from "most similar" to "least similar." Por defecto, los resultados devueltos con una cláusula **order by** se ordenan en orden ascendente. Depending on the similarity metric used, you may need to adjust the sorting direction to obtain the correct ranking: -- for [**cosine**](./VectorClass.md#cosinesimilarity) and [**dot**](./VectorClass.md#dotsimilarity) similarity, higher values indicate greater similarity. Therefore, you will typically need to include the `desc` keyword in the query string. +- for [**cosine**](./VectorClass.md#cosinesimilarity) and [**dot**](./VectorClass.md#dotsimilarity) similarity, higher values indicate greater similarity. Por lo tanto, normalmente deberá incluir la palabra clave `desc` en la cadena de consulta. - for [**euclidean distance**](./VectorClass.md#euclideandistance) similarity, lower values indicate greater similarity. In this case, the default ascending order (or explicitly using the `asc` keyword) is appropriate. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/Directory.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/Directory.md index 7cb86982579008..2f940b4cc1b3c1 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/Directory.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/Directory.md @@ -556,7 +556,7 @@ La función `.files()` devuelve una colec > Los alias o enlaces simbólicos no se resuelven. -Por defecto, si se omite el parámetro *options*, sólo se devuelven en la colección los archivos del primer nivel de la carpeta, así como los archivos o carpetas invisibles. Puede modificar esto pasando, en el parámetro *options*, una o varias de las siguientes constantes: +By default, if you omit the *options* parameter, only the files at the first level of the folder are returned in the collection, including invisible files. Puede modificar esto pasando, en el parámetro *options*, una o varias de las siguientes constantes: | Constante | Valor | Comentario | | --------------------- | ----- | ------------------------------------------------------------------------------- | diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/EntityClass.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/EntityClass.md index a15492bb8bbcfb..efd68a6c964da2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/EntityClass.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/API/EntityClass.md @@ -409,7 +409,7 @@ El objeto devuelto por `.drop()` contiene las siguientes propiedades: | `dk status validation failed` | 7 | Error no crítico enviado por el desarrollador para un [evento de validación](../ORDA/orda-events.md). **statusText asociado**: "Mild Validation Error" | | `dk status serious error` | 4 | Un error crítico es un error de bajo nivel de la base de datos (por ejemplo, una llave duplicada), un error de hardware, etc.
    ***statusText asociado***: "Other error" | | `dk status serious validation error` | 8 | Error crítico enviado por el desarrollador para un [evento de validación](../ORDA/orda-events.md). **statusText asociado**: "Serious Validation Error" | -| `dk status stamp has changed` | 2 | El valor del marcador interno (stamp) de la entidad no coincide con el de la entidad almacenada en los datos (bloqueo optimista).
  • with `.save()`: error only if the `dk auto merge` option is not used
  • with `.drop()`: error only if the `dk force drop if stamp changed` option is not used
  • with `.lock()`: error only if the `dk reload if stamp changed` option is not used
  • **Associated statusText**: "Stamp has changed"
    • | +| `dk status stamp has changed` | 2 | El valor del marcador interno (stamp) de la entidad no coincide con el de la entidad almacenada en los datos (bloqueo optimista).
  • con `.save()`: error sólo si no se utiliza la opción `dk auto merge`.
  • con `.drop()`: error sólo si no se usa la opción `dk force drop if stamp changed`
  • con `.lock()`: error sólo si no se utiliza la opción `dk reload if stamp changed`.
  • **statusText asociado**: "Stamp has changed"
    • | | `dk status wrong permission` | 1 | Los privilegios actuales no permiten suprimir la entidad. **StatusText asociado**: "Permission Error" | #### Ejemplo 1 diff --git a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/FormObjects/listbox_overview.md b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/FormObjects/listbox_overview.md index 4e94bbdd6c1a63..43d33db933e34e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/version-21-R3/FormObjects/listbox_overview.md +++ b/i18n/es/docusaurus-plugin-content-docs/version-21-R3/FormObjects/listbox_overview.md @@ -244,14 +244,14 @@ Puede activar o desactivar la ordenación usuario estándar desactivando la prop El soporte de ordenación estándar depende del tipo de list box: -| Tipo de list box | Soporte de ordenación estándar | Comentarios | -| ------------------------------ | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Colección de objetos | Sí | | -| Colección de valores escalares | No | Utilice la ordenación personalizada con la función [`orderBy()`](../API/CollectionClass.md#orderby) | -| Entity selection | Sí |