diff --git a/website/i18n/ja.json b/website/i18n/ja.json index 0a98118dc5cbd3..26b65384317030 100644 --- a/website/i18n/ja.json +++ b/website/i18n/ja.json @@ -24,7 +24,7 @@ "title": "DataClassAttribute" }, "API/dataclassClass": { - "title": "DataClass" + "title": "データクラス" }, "API/datastoreClass": { "title": "DataStore" diff --git a/website/translated_docs/de/API/classClass.md b/website/translated_docs/de/API/classClass.md index 395506625fef16..f6675f2542c9df 100644 --- a/website/translated_docs/de/API/classClass.md +++ b/website/translated_docs/de/API/classClass.md @@ -52,12 +52,13 @@ This property is **read-only**. -**.new()** : 4D.Class +**.new**( *param* : any { *;...paramN* } ) : 4D.Class -| Parameter | Typ | | Beschreibung | -| --------- | -------- |:--:| ----------------------- | -| Ergebnis | 4D.Class | <- | New object of the class | +| Parameter | Typ | | Beschreibung | +| --------- | -------- |:--:| ------------------------------------------------ | +| param | any | -> | Parameter(s) to pass to the constructor function | +| Ergebnis | 4D.Class | <- | New object of the class | @@ -65,19 +66,40 @@ This property is **read-only**. The `.new()` function creates and returns a `cs.className` object which is a new instance of the class on which it is called. This function is automatically available on all classes from the [`cs` class store](Concepts/classes.md#cs). -Wird sie in einer nicht-vorhandenen Klasse aufgerufen, wird ein Fehler zurückgegeben. +You can pass one or more optional *param* parameters, which will be passed to the [class constructor](Concepts/classes.md#class-constructor) function (if any) in the className class definition. Within the constructor function, the [`This`](Concepts/classes.md#this) is bound to the new object being constructed. +If `.new()` is called on a non-existing class, an error is returned. -#### Beispiel +#### Beispiele Eine neue Instanz der Klasse Person anlegen: ```4d var $person : cs.Person $person:=cs.Person.new() //create the new instance -//$Person contains functions of the class +//$person contains functions of the class +``` + +To create a new instance of the Person class with parameters: + +```4d +//Class: Person.4dm +Class constructor($firstname : Text; $lastname : Text; $age : Integer) + This.firstName:=$firstname + This.lastName:=$lastname + This.age:=$age ``` +```4d +//In a method +var $person : cs.Person +$person:=cs.Person.new("John";"Doe";40) +//$person.firstName = "John" +//$person.lastName = "Doe" +//$person.age = 40 +``` + + diff --git a/website/translated_docs/de/Concepts/classes.md b/website/translated_docs/de/Concepts/classes.md index 74ccdd693da973..26409261bf05a0 100644 --- a/website/translated_docs/de/Concepts/classes.md +++ b/website/translated_docs/de/Concepts/classes.md @@ -19,14 +19,19 @@ Sie können z. B. eine Klasse `Person` mit folgender Definition erstellen: Class constructor($firstname : Text; $lastname : Text) This.firstName:=$firstname This.lastName:=$lastname + +Function sayHello()->$welcome : Text + $welcome:="Hello "+This.firstName+" "+This.lastName ``` In einer Methode erstellen Sie eine "Person": ``` -var $o : cs.Person //object of Person class -$o:=cs.Person.new("John";"Doe") -// $o:{firstName: "John"; lastName: "Doe" } +var $person : cs.Person //object of Person class +var $hello : Text +$person:=cs.Person.new("John";"Doe") +// $person:{firstName: "John"; lastName: "Doe" } +$hello:=$person.sayHello() //"Hello John Doe" ``` @@ -39,7 +44,7 @@ Eine Benutzerklasse in 4D wird über eine spezifische Datei Methode (.4dm) defin Beim Benennen von Klassen müssen Sie folgende Regeln beachten: -- Ein Klassenname muss mit den [ Schreibregeln für Eigenschaftsnamen](Concepts/dt_object.md#identifier-für-objekteigenschaft) konform sein. +- A [class name](identifiers.md#classes) must be compliant with [property naming rules](identifiers.md#object-properties). - Es wird zwischen Groß- und Kleinschreibung unterschieden. - Um Konflikte zu vermeiden, sollten Sie für eine Klasse und eine Tabelle in derselben Anwendung unterschiedliche Namen verwenden. @@ -81,7 +86,7 @@ Um eine neue Klasse zu erstellen: #### Unterstützung von Code für Klassen -In verschiedenen 4D Entwicklerfenstern (Code-Editor, Compiler, Debugger, Runtime-Explorer) wird Code für Klassen im allgemeinen wie eine Projektmethode mit einigen spezifischen Merkmalen verwaltet: +In the various 4D windows (code editor, compiler, debugger, runtime explorer), class code is basically handled like a project method with some specificities: - Im Code-Editor gilt folgendes: - Klassen können nicht direkt ausgeführt werden @@ -136,10 +141,8 @@ $key:=4D.CryptoKey.new(New object("type";"ECDSA";"curve";"prime256v1")) -## Klassen in Ihrem Code verwenden - -### Objekt class +## Objekt Class Ist in einem Projekt eine Klasse [definiert](#eine-klasse-definieren), wird sie in die 4D Programmiersprache Umgebung geladen. Eine Klasse ist selbst ein Objekt der Klasse ["class"](API/classClass.md). Ein Objekt class hat folgende Eigenschaften und Funktionen: @@ -147,46 +150,23 @@ Ist in einem Projekt eine Klasse [definiert](#eine-klasse-definieren), wird sie - Objekt [`superclass`](API/classClass.md#superclass) (optional, null, wenn nicht vorhanden) - Funktion [`new()`](API/classClass.md#new), um Instanzen der Objekte einer Klasse zu setzen. -Zusätzlich kann ein Objekt class verweisen auf: - -- Ein Objekt [`constructor`](#class-constructor) (optional), -- Ein Objekt `prototype` mit Objektnamen [function](#function) (optional). +In addition, a class object can reference a [`constructor`](#class-constructor) object (optional). Ein Objekt class ist ein [shared object](shared.md), d. h. es lässt sich aus verschiedenen 4D Prozessen gleichzeitig darauf zugreifen. +### Inheritance +If a class inherits from another class (i.e. the [Class extends](classes.md#class-extends-classname) keyword is used in its definition), the parent class is its [`superclass`](API/classClass.md#superclass). -### Nach Eigenschaft suchen und Prototyp - -Alle Objekte in 4D sind intern an ein Objekt class gebunden. Findet 4D eine Eigenschaft nicht in einem Objekt, sucht es im Objekt Prototyp seiner Klasse; wird sie hier nicht gefunden, sucht 4D weiter im Objekt prototype seiner Superklasse, usw. bis es keine Superklasse mehr gibt. - -Alle Objekte erben vom Objekt class als ihrer obersten Klasse im Vererbungsbaum. - -```4d -//Class: Polygon -Class constructor($width : Integer; $height : Integer) - This.area:=$width*$height - - //var $poly : Object - var $instance : Boolean - $poly:=cs.Polygon.new(4;3) - - $instance:=OB Instance of($poly;cs.Polygon) - // true - $instance:=OB Instance of($poly;4D.Object) - // true -``` - -Beim Aufzählen der Eigenschaften eines Objekts wird der Prototyp seiner Klasse nicht mitgezählt. Demzufolge geben die Anweisung `For each` und der Befehl `JSON Stringify` nicht Eigenschaften des Objekts prototype der Klasse zurück. Die Eigenschaft des Objekts prototype einer Klasse ist eine interne ausgeblendete Eigenschaft. - +When 4D does not find a function or a property in a class, it searches it in its [`superclass`](API/classClass.md#superclass); if not found, 4D continues searching in the superclass of the superclass, and so on until there is no more superclass (all objects inherit from the "Object" superclass). ## Schlüsselwörter für Klassen In der Definition von Klassen lassen sich spezifische 4D Schlüsselwörter verwenden: -- `Function ` zum Definieren von Member Methods der Objekte. -- `Class constructor` zum Definieren der Eigenschaften der Objekte (z.B. Prototype). +- `Function ` to define class functions of the objects. +- `Class constructor` to define the properties of the objects. - `Class extends ` zum Definieren der Vererbung. @@ -199,13 +179,13 @@ Function ({$parameterName : type; ...}){->$parameterName : type} // code ``` -Class Functions sind Eigenschaften des Objekts Prototype der Klasse des Eigentümers. Das sind Objekte der Klasse "Function". +Class functions are specific properties of the class. They are objects of the [4D.Function](API/formulaClass.md#about-4dfunction-objects) class. -In der Datei mit der Definition der Klasse verwenden Function Deklarationen das Schlüsselwort `Function` und den Namen von Function. Ein Klassenname muss mit den [ Schreibregeln für Eigenschaftsnamen](Concepts/dt_object.md#identifier-für-objekteigenschaft) konform sein. +In der Datei mit der Definition der Klasse verwenden Function Deklarationen das Schlüsselwort `Function` und den Namen von Function. The function name must be compliant with [property naming rules](Concepts/identifiers.md#object-properties). > **Tipp:** Namen, die mit einem Unterstrich (_) beginnen, werden beim automatischen Vervollständigen (autocompletion) im 4D Code-Editor unterdrückt und nicht vorgeschlagen. Schreiben Sie z.B. `Function _myPrivateFunction` in `MyClass`, wird das nicht im Code-Editor vorgeschlagen, wenn Sie `"cs.MyClass` eingeben. -Direkt nach dem Namen von Function lassen sich passende [Parameter](#parameter) angeben mit zugewiesenem Namen und Datentyp, inkl. Rückgabeparameter (optional). Beispiel: +Direkt nach dem Namen von Function lassen sich passende [Parameter](#parameters) angeben mit zugewiesenem Namen und Datentyp, inkl. Rückgabeparameter (optional). Beispiel: ```4d Function computeArea($width : Integer; $height : Integer)->$area : Integer @@ -226,19 +206,19 @@ Der Befehl `Current method name` gibt für eine Class Function zurück: "*\ **Thread-Safety Warnung:** Ist eine Class Function nicht thread-safe und wird mit einer Methode mit der Option "In preemptive Prozess starten" aufgerufen:
- generiert der Compiler keinen Fehler (im Unterschied zu regulären Methoden),
- Gibt 4D nur im laufenden Betrieb einen Fehler aus. +> **Thread-safety warning:** If a class function is not thread-safe and called by a method with the "Can be run in preemptive process" attribute: - the compiler does not generate any error (which is different compared to regular methods), - an error is thrown by 4D only at runtime. -#### Parameter +#### Parameters -Function Parameter werden mit Name und Typ des Parameters, getrennt durch Strichpunkt, deklariert. Der Parametername muss mit den [Schreibregeln für Eigenschaftsnamen](Concepts/dt_object.md#identifier-f%C3%BCr-objekteigenschaft) konform sein. Mehrere Parameter (und Typen) werden durch Strichpunkte (;) voneinander getrennt. +Function parameters are declared using the parameter name and the parameter type, separated by a colon. The parameter name must be compliant with [property naming rules](Concepts/identifiers.md#object-properties). Mehrere Parameter (und Typen) werden durch Strichpunkte (;) voneinander getrennt. ```4d Function add($x; $y : Variant; $z : Integer; $xy : Object) @@ -306,13 +286,13 @@ Class Constructor({$parameterName : type; ...}) Eine Function Class Constructor, die [Parameter](#parameters) zulässt, lässt sich zum Definieren einer Benutzerklasse verwenden. -In diesem Fall wird der Class Constructur beim Aufrufen der Class Member Method `new()` mit den Parametern aufgerufen, die optional in der Function `new()` übergeben wurden. +In that case, when you call the [`new()`](API/classClass.md#new) function, the class constructor is called with the parameters optionally passed to the `new()` function. -Für eine Class Constructor Function gibt der Befehl `Current method name` zurück: "*\.constructor*", z.B. "MyClass.constructor". +For a class constructor function, the `Current method name` command returns: "*\.constructor*", for example "MyClass.constructor". -#### Beispiel: +#### Example: ```4d // Class: MyClass @@ -341,7 +321,7 @@ $o:=cs.MyClass.new("HelloWorld") Class extends ``` -Das Schlüsselwort `Class extends` dient in der Deklaration der Klasse zum Erstellen einer Benutzerklasse, die eine Unterklasse einer anderen Benutzerklasse ist. Die Unterklasse erbt alle Functions der übergeordneten Klasse. +The `Class extends` keyword is used in class declaration to create a user class which is a child of another user class. Die Unterklasse erbt alle Functions der übergeordneten Klasse. Für Class Extension gelten folgende Regeln: @@ -497,34 +477,35 @@ Das Schlüsselwort `This` gibt eine Referenz auf das gerade bearbeitete Objekt z In den meisten Fällen bestimmt der Wert von `This`, wie eine Function aufgerufen wird. Es lässt sich während der Ausführung nicht per Zuweisung setzen und kann bei jedem Aufrufen der Funktion anders sein. -Wird eine Formel als Member Method eines Objekts aufgerufen, wird das dazugehörige `This` auf das Objekt gesetzt, wo die Methode aufgerufen wird. Zum Beispiel: +Wird eine Formel als Member Method eines Objekts aufgerufen, wird das dazugehörige `This` auf das Objekt gesetzt, wo die Methode aufgerufen wird. For example: ```4d $o:=New object("prop";42;"f";Formula(This.prop)) $val:=$o.f() //42 ``` -Mit der Function [Class Constructor](#class-constructor) (mit der Methode `new()`) wird das dazugehörige `This` an das neue Objekt in Konstruktion gebunden. +When a [class constructor](#class-constructor) function is used (with the [`new()`](API/classClass.md#new) function), its `This` is bound to the new object being constructed. ```4d - //Class: ob +//Class: ob Class Constructor + // Create properties on This as // desired by assigning to them - This.a:=42 + This.a:=42 ``` ```4d - // in a 4D method +// in a 4D method $o:=cs.ob.new() $val:=$o.a //42 ``` -> Wird der Superclass Constructor in einem Constructor über das Schlüsselwort [Super](#super) aufgerufen, müssen Sie darauf achten, dass `This` nicht vor dem Superclass Constructor aufgerufen wird, sonst wird ein Fehler generiert. Siehe [dieses Beispiel](#beispiel-1-1). +> When calling the superclass constructor in a constructor using the [Super](#super) keyword, keep in mind that `This` must not be called before the superclass constructor, otherwise an error is generated. See [this example](#example-1). -In jedem Fall bezieht sich `This` auf das Objekt, in dem die Methode aufgerufen wurde, als ob die Methode im Objekt wäre. +In any cases, `This` refers to the object the method was called on, as if the method were on the object. ```4d //Class: ob @@ -533,7 +514,7 @@ Function f() $0:=This.a+This.b ``` -Dann können Sie in einer Projektmethode schreiben: +Then you can write in a project method: ```4d $o:=cs.ob.new() @@ -541,7 +522,7 @@ $o.a:=5 $o.b:=3 $val:=$o.f() //8 ``` -In diesem Beispiel hat das der Variablen $o zugewiesene Objekt keine eigene Eigenschaft *f*, sondern erbt sie von der dazugehörigen Klasse. Da *f* als eine Methode von $o, aufgerufen wird, bezieht sich das dazugehörige `This` auf $o. +In this example, the object assigned to the variable $o doesn't have its own *f* property, it inherits it from its class. Da *f* als eine Methode von $o, aufgerufen wird, bezieht sich das dazugehörige `This` auf $o. ## Befehle für Klassen diff --git a/website/translated_docs/es/API/classClass.md b/website/translated_docs/es/API/classClass.md index 1af48114579a7c..6a926f60614e49 100644 --- a/website/translated_docs/es/API/classClass.md +++ b/website/translated_docs/es/API/classClass.md @@ -52,12 +52,13 @@ This property is **read-only**. -**.new()** : 4D.Class +**.new**( *param* : any { *;...paramN* } ) : 4D.Class -| Parameter | Type | | Description | -| --------- | -------- |:--:| ----------------------- | -| Result | 4D.Class | <- | New object of the class | +| Parameter | Type | | Description | +| --------- | -------- |:--:| ------------------------------------------------ | +| param | any | -> | Parameter(s) to pass to the constructor function | +| Result | 4D.Class | <- | New object of the class | @@ -65,19 +66,40 @@ This property is **read-only**. The `.new()` function creates and returns a `cs.className` object which is a new instance of the class on which it is called. This function is automatically available on all classes from the [`cs` class store](Concepts/classes.md#cs). -If it is called on a non-existing class, an error is returned. +You can pass one or more optional *param* parameters, which will be passed to the [class constructor](Concepts/classes.md#class-constructor) function (if any) in the className class definition. Within the constructor function, the [`This`](Concepts/classes.md#this) is bound to the new object being constructed. +If `.new()` is called on a non-existing class, an error is returned. -#### Example +#### Examples To create a new instance of the Person class: ```4d var $person : cs.Person $person:=cs.Person.new() //create the new instance -//$Person contains functions of the class +//$person contains functions of the class +``` + +To create a new instance of the Person class with parameters: + +```4d +//Class: Person.4dm +Class constructor($firstname : Text; $lastname : Text; $age : Integer) + This.firstName:=$firstname + This.lastName:=$lastname + This.age:=$age ``` +```4d +//In a method +var $person : cs.Person +$person:=cs.Person.new("John";"Doe";40) +//$person.firstName = "John" +//$person.lastName = "Doe" +//$person.age = 40 +``` + + diff --git a/website/translated_docs/es/Concepts/classes.md b/website/translated_docs/es/Concepts/classes.md index 7b53201ec7e112..112cc172a612bb 100644 --- a/website/translated_docs/es/Concepts/classes.md +++ b/website/translated_docs/es/Concepts/classes.md @@ -19,14 +19,19 @@ For example, you could create a `Person` class with the following definition: Class constructor($firstname : Text; $lastname : Text) This.firstName:=$firstname This.lastName:=$lastname + +Function sayHello()->$welcome : Text + $welcome:="Hello "+This.firstName+" "+This.lastName ``` In a method, creating a "Person": ``` -var $o : cs.Person //object of Person class -$o:=cs.Person.new("John";"Doe") -// $o:{firstName: "John"; lastName: "Doe" } +var $person : cs.Person //object of Person class +var $hello : Text +$person:=cs.Person.new("John";"Doe") +// $person:{firstName: "John"; lastName: "Doe" } +$hello:=$person.sayHello() //"Hello John Doe" ``` @@ -39,7 +44,7 @@ A user class in 4D is defined by a specific method file (.4dm), stored in the `/ When naming classes, you should keep in mind the following rules: -- A class name must be compliant with [property naming rules](Concepts/dt_object.md#object-property-identifiers). +- A [class name](identifiers.md#classes) must be compliant with [property naming rules](identifiers.md#object-properties). - Class names are case sensitive. - Giving the same name to a class and a database table is not recommended, in order to prevent any conflict. @@ -81,7 +86,7 @@ To create a new class, you can: #### Class code support -In the various 4D Developer windows (code editor, compiler, debugger, runtime explorer), class code is basically handled like a project method with some specificities: +In the various 4D windows (code editor, compiler, debugger, runtime explorer), class code is basically handled like a project method with some specificities: - In the code editor: - a class cannot be run @@ -136,10 +141,8 @@ $key:=4D.CryptoKey.new(New object("type";"ECDSA";"curve";"prime256v1")) -## Using classes in your code - -### Class object +## Class object When a class is [defined](#class-definition) in the project, it is loaded in the 4D language environment. A class is an object itself, of ["Class" class](API/classClass.md). A class object has the following properties and function: @@ -147,46 +150,23 @@ When a class is [defined](#class-definition) in the project, it is loaded in the - [`superclass`](API/classClass.md#superclass) object (null if none) - [`new()`](API/classClass.md#new) function, allowing to instantiate class objects. -In addition, a class object can reference: - -- a [`constructor`](#class-constructor) object (optional), -- a `prototype` object, containing named [function](#function) objects (optional). +In addition, a class object can reference a [`constructor`](#class-constructor) object (optional). A class object is a [shared object](shared.md) and can therefore be accessed from different 4D processes simultaneously. +### Inheritance +If a class inherits from another class (i.e. the [Class extends](classes.md#class-extends-classname) keyword is used in its definition), the parent class is its [`superclass`](API/classClass.md#superclass). -### Property lookup and prototype - -All objects in 4D are internally linked to a class object. When 4D does not find a property in an object, it searches in the prototype object of its class; if not found, 4D continues searching in the prototype object of its superclass, and so on until there is no more superclass. - -All objects inherit from the class "Object" as their inheritance tree top class. - -```4d -//Class: Polygon -Class constructor($width : Integer; $height : Integer) - This.area:=$width*$height - - //var $poly : Object - var $instance : Boolean - $poly:=cs.Polygon.new(4;3) - - $instance:=OB Instance of($poly;cs.Polygon) - // true - $instance:=OB Instance of($poly;4D.Object) - // true -``` - -When enumerating properties of an object, its class prototype is not enumerated. As a consequence, `For each` statement and `JSON Stringify` command do not return properties of the class prototype object. The prototype object property of a class is an internal hidden property. - +When 4D does not find a function or a property in a class, it searches it in its [`superclass`](API/classClass.md#superclass); if not found, 4D continues searching in the superclass of the superclass, and so on until there is no more superclass (all objects inherit from the "Object" superclass). ## Class keywords Specific 4D keywords can be used in class definitions: -- `Function ` to define member methods of the objects. -- `Class constructor` to define the properties of the objects (i.e. the prototype). +- `Function ` to define class functions of the objects. +- `Class constructor` to define the properties of the objects. - `Class extends ` to define inheritance. @@ -199,9 +179,9 @@ Function ({$parameterName : type; ...}){->$parameterName : type} // code ``` -Class functions are properties of the prototype object of the owner class. They are objects of the "Function" class. +Class functions are specific properties of the class. They are objects of the [4D.Function](API/formulaClass.md#about-4dfunction-objects) class. -In the class definition file, function declarations use the `Function` keyword, and the name of the function. The function name must be compliant with [property naming rules](Concepts/dt_object.md#object-property-identifiers). +In the class definition file, function declarations use the `Function` keyword, and the name of the function. The function name must be compliant with [property naming rules](Concepts/identifiers.md#object-properties). > **Tip:** Starting the function name with an underscore character ("_") will exclude the function from the autocompletion features in the 4D code editor. For example, if you declare `Function _myPrivateFunction` in `MyClass`, it will not be proposed in the code editor when you type in `"cs.MyClass. "`. @@ -227,9 +207,9 @@ For a class function, the `Current method name` command returns: "*\. In the application code, class functions are called as member methods of the object instance and can receive [parameters](#class-function-parameters) if any. The following syntaxes are supported: - use of the `()` operator. For example, `myObject.methodName("hello")` -- use of a "Function" class member method: - - `apply()` - - `call()` +- use of a "4D.Function" class member method: + - [`apply()`](API/formulaClass.md#apply) + - [`call()`](API/formulaClass.md#call) > **Thread-safety warning:** If a class function is not thread-safe and called by a method with the "Can be run in preemptive process" attribute: - the compiler does not generate any error (which is different compared to regular methods), - an error is thrown by 4D only at runtime. @@ -238,7 +218,7 @@ In the application code, class functions are called as member methods of the obj #### Parameters -Function parameters are declared using the parameter name and the parameter type, separated by a colon. The parameter name must be compliant with [property naming rules](Concepts/dt_object.md#object-property-identifiers). Multiple parameters (and types) are separated by semicolons (;). +Function parameters are declared using the parameter name and the parameter type, separated by a colon. The parameter name must be compliant with [property naming rules](Concepts/identifiers.md#object-properties). Multiple parameters (and types) are separated by semicolons (;). ```4d Function add($x; $y : Variant; $z : Integer; $xy : Object) @@ -306,7 +286,7 @@ Class Constructor({$parameterName : type; ...}) A class constructor function, which can accept [parameters](#parameters), can be used to define a user class. -In that case, when you call the `new()` class member method, the class constructor is called with the parameters optionally passed to the `new()` function. +In that case, when you call the [`new()`](API/classClass.md#new) function, the class constructor is called with the parameters optionally passed to the `new()` function. For a class constructor function, the `Current method name` command returns: "*\.constructor*", for example "MyClass.constructor". @@ -504,7 +484,7 @@ $o:=New object("prop";42;"f";Formula(This.prop)) $val:=$o.f() //42 ``` -When a [class constructor](#class-constructor) function is used (with the `new()` keyword), its `This` is bound to the new object being constructed. +When a [class constructor](#class-constructor) function is used (with the [`new()`](API/classClass.md#new) function), its `This` is bound to the new object being constructed. ```4d //Class: ob diff --git a/website/translated_docs/fr/API/classClass.md b/website/translated_docs/fr/API/classClass.md index 73d873ae3736e8..d8fc20743d59f4 100644 --- a/website/translated_docs/fr/API/classClass.md +++ b/website/translated_docs/fr/API/classClass.md @@ -52,12 +52,13 @@ Cette propriété est en **lecture seule**. -**.new()** : 4D.Class +**.new**( *param* : any { *;...paramN* } ) : 4D.Class -| Paramètres | Type | | Description | -| ---------- | -------- |:--:| ------------------------- | -| Résultat | 4D.Class | <- | Nouvel objet de la classe | +| Paramètres | Type | | Description | +| ---------- | -------- |:--:| ------------------------------------------------ | +| param | any | -> | Parameter(s) to pass to the constructor function | +| Résultat | 4D.Class | <- | Nouvel objet de la classe | @@ -65,17 +66,37 @@ Cette propriété est en **lecture seule**. La `.new()` function crée et returne un objet `cs.className` qui est une nouvelle instance de la classe sur laquelle il est appelé. Cette fonction est automatiquement disponible sur toutes les classes à partir du class store [`cs`](Concepts/classes.md#cs). -S'il est appelé sur une classe inexistante, une erreur est retournée. +You can pass one or more optional *param* parameters, which will be passed to the [class constructor](Concepts/classes.md#class-constructor) function (if any) in the className class definition. Within the constructor function, the [`This`](Concepts/classes.md#this) is bound to the new object being constructed. +If `.new()` is called on a non-existing class, an error is returned. -#### Exemple +#### Exemples Pour créer une nouvelle instance de la classe Person : ```4d var $person : cs.Person -$person:=cs.Person.new() //créer la nouvelle instance -//$Person contient les fonctions de la classe +$person:=cs.Person.new() //create the new instance +//$person contains functions of the class +``` + +To create a new instance of the Person class with parameters: + +```4d +//Class: Person.4dm +Class constructor($firstname : Text; $lastname : Text; $age : Integer) + This.firstName:=$firstname + This.lastName:=$lastname + This.age:=$age +``` + +```4d +//In a method +var $person : cs.Person +$person:=cs.Person.new("John";"Doe";40) +//$person.firstName = "John" +//$person.lastName = "Doe" +//$person.age = 40 ```## .superclass
Historique diff --git a/website/translated_docs/fr/Concepts/classes.md b/website/translated_docs/fr/Concepts/classes.md index f18184247e33f5..69ca0705250119 100644 --- a/website/translated_docs/fr/Concepts/classes.md +++ b/website/translated_docs/fr/Concepts/classes.md @@ -19,14 +19,19 @@ Par exemple, vous pouvez créer une classe `Person` avec la définition suivante Class constructor($firstname : Text; $lastname : Text) This.firstName:=$firstname This.lastName:=$lastname + +Function sayHello()->$welcome : Text + $welcome:="Hello "+This.firstName+" "+This.lastName ``` Dans une méthode, créons une "Personne" : ``` -var $o : cs.Person //object of Person class -$o:=cs.Person.new("John";"Doe") -// $o:{firstName: "John"; lastName: "Doe" } +var $person : cs.Person //object of Person class +var $hello : Text +$person:=cs.Person.new("John";"Doe") +// $person:{firstName: "John"; lastName: "Doe" } +$hello:=$person.sayHello() //"Hello John Doe" ``` @@ -39,7 +44,7 @@ Une classe utilisateur dans 4D est définie par un fichier de méthode spécifiq Lorsque vous nommez des classes, gardez à l'esprit les règles suivantes : -- Le nom d'une classe doit être conforme aux [règles de nommage des propriétés](Concepts/dt_object.md#object-property-identifiers). +- A [class name](identifiers.md#classes) must be compliant with [property naming rules](identifiers.md#object-properties). - Les noms de classe sont sensibles à la casse. - Il n'est pas recommandé de donner le même nom à une classe et à une table de base de données, afin d'éviter tout conflit. @@ -81,7 +86,7 @@ Pour créer une nouvelle classe, vous pouvez : #### Prise en charge du code de classe -Dans les différentes fenêtres de 4D Developer (éditeur de code, compilateur, débogueur, explorateur d'exécution), le code de classe est essentiellement géré comme une méthode projet avec quelques spécificités : +In the various 4D windows (code editor, compiler, debugger, runtime explorer), class code is basically handled like a project method with some specificities: - Dans l'éditeur de code : - une classe ne peut pas être exécutée @@ -136,10 +141,8 @@ $key:=4D.CryptoKey.new(New object("type";"ECDSA";"curve";"prime256v1")) -## Utiliser des classes dans votre code - -### L'objet classe +## L'objet classe Lorsqu'une classe est [définie](#class-definition) dans le projet, elle est chargée dans l'environnement de langage 4D. Une classe est un objet lui-même de la [classe "Class"](API/classClass.md). Un objet class possède les propriétés et fonctions suivantes : @@ -147,46 +150,23 @@ Lorsqu'une classe est [définie](#class-definition) dans le projet, elle est cha - objet [`superclass`](API/classClass.md#superclass) (nul si aucun) - fonction [`new()`](API/classClass.md#new), permettant d'instancier des objets de classe. -De plus, un objet de classe peut référencer : - -- un objet [`constructor`](#class-constructor) (facultatif), -- un objet `prototype`, contenant des objets de [fonction](#function) nommés (facultatif). +In addition, a class object can reference a [`constructor`](#class-constructor) object (optional). Un objet de classe est un [objet partagé](shared.md) et est donc accessible simultanément à partir de différents processus 4D. +### Inheritance +If a class inherits from another class (i.e. the [Class extends](classes.md#class-extends-classname) keyword is used in its definition), the parent class is its [`superclass`](API/classClass.md#superclass). -### Recherche et prototype des propriétés - -Tous les objets de 4D sont liés en interne à un objet de classe. Lorsque 4D ne trouve pas de propriété dans un objet, il effectue un recherche dans l'objet prototype de sa classe; s'il ne la trouve pas, 4D poursuit sa recherche dans l'objet prototype de sa classe mère (superclass), et ainsi de suite jusqu'à ce qu'il n'y ait plus de superclass. - -Tous les objets héritent de la classe "Object" comme classe supérieure d'arbre d'héritage. - -```4d -//Class: Polygon -Class constructor($width : Integer; $height : Integer) - This.area:=$width*$height - - //var $poly : Object - var $instance : Boolean - $poly:=cs.Polygon.new(4;3) - - $instance:=OB Instance of($poly;cs.Polygon) - // vrai - $instance:=OB Instance of($poly;4D.Object) - // vrai -``` - -Lors de l'énumération des propriétés d'un objet, son prototype de classe n'est pas énuméré. Par conséquent, l'instruction `For each` et la commande `JSON Stringify` ne retournent pas les propriétés de l'objet du prototype de classe. La propriété d'objet prototype d'une classe est une propriété cachée interne. - +When 4D does not find a function or a property in a class, it searches it in its [`superclass`](API/classClass.md#superclass); if not found, 4D continues searching in the superclass of the superclass, and so on until there is no more superclass (all objects inherit from the "Object" superclass). ## Mots-clés de classe Des mots-clés 4D spécifiques peuvent être utilisés dans les définitions de classe : -- `Fonction ` pour définir les méthodes membres des objets. -- `Class constructor` (constructeur de classe) pour définir les propriétés des objets (c'est-à-dire le prototype). +- `Function ` to define class functions of the objects. +- `Class constructor` to define the properties of the objects. - `Class extends ` pour définir l'héritage. @@ -199,9 +179,9 @@ Function ({$parameterName : type; ...}){->$parameterName : type} // code ``` -Les fonctions de classe sont des propriétés de l'objet prototype de la classe propriétaire. Ce sont des objets de la classe "Function". +Class functions are specific properties of the class. They are objects of the [4D.Function](API/formulaClass.md#about-4dfunction-objects) class. -Dans le fichier de définition de classe, les déclarations de fonction utilisent le mot-clé `Function`, et le nom de la fonction. Le nom de la fonction doit être conforme aux [règles de nommage des propriétés](Concepts/dt_object.md#object-property-identifiers). +Dans le fichier de définition de classe, les déclarations de fonction utilisent le mot-clé `Function`, et le nom de la fonction. The function name must be compliant with [property naming rules](Concepts/identifiers.md#object-properties). > **Astuce :** préfixer le nom de la fonction par un trait de soulignement ("_") exclura la fonction des fonctionnalités d'auto-complétion dans l'éditeur de code 4D. Par exemple, si vous déclarez `Function _myPrivateFunction` dans `MyClass`, elle ne sera pas proposée dans l'éditeur de code lorsque vous tapez `"cs.MyClass. "`. @@ -226,26 +206,26 @@ Pour une fonction de classe, la commande `Current method name` retourne: "*\ **Avertissement de sécurité des threads :** Si une fonction de classe n'est pas thread-safe et est appelée par une méthode avec l'attribut "Peut être exécuté en processus préemptif" : - le compilateur ne génère aucune erreur (ce qui est différent des méthodes classiques), - une erreur n'est générée par 4D qu'au moment de l'exécution. +> **Thread-safety warning:** If a class function is not thread-safe and called by a method with the "Can be run in preemptive process" attribute: - the compiler does not generate any error (which is different compared to regular methods), - an error is thrown by 4D only at runtime. -#### Paramètres +#### Parameters -Les paramètres de fonction sont déclarés à l'aide du nom et du type de paramètre, séparés par deux points. Le nom du paramètre doit être conforme aux [règles de nommage des propriétés](Concepts/dt_object.md#object-property-identifiers). Plusieurs paramètres (et types) sont séparés par des points-virgules (;). +Function parameters are declared using the parameter name and the parameter type, separated by a colon. The parameter name must be compliant with [property naming rules](Concepts/identifiers.md#object-properties). Plusieurs paramètres (et types) sont séparés par des points-virgules (;). ```4d Function add($x; $y : Variant; $z : Integer; $xy : Object) ``` > Si le type n'est pas indiqué, le paramètre sera défini comme `Variant`. -Déclarez le paramètre de retour (optionnel) en ajoutant une flèche (->) et la définition du paramètre de retour après la liste de paramètre(s) d'entrée. Par exemple : +Déclarez le paramètre de retour (facultatif) en ajoutant une flèche (->) et la définition du paramètre de retour après la liste des paramètres d'entrée. Par exemple : ```4d Function add ($x : Variant; $y : Integer)->$result : Integer @@ -278,7 +258,7 @@ Class constructor($width : Integer; $height : Integer) This.height:=$height This.width:=$width -// Function definition +// Définition de la classe Function getArea()->$result : Integer $result:=(This.height)*(This.width) ``` @@ -306,13 +286,9 @@ Class Constructor({$parameterName : type; ...}) A class constructor function, which can accept [parameters](#parameters), can be used to define a user class. -Dans ce cas, lorsque vous appelez la méthode membre `new()` de la classe, le "class constructor" est appelé avec les paramètres éventuellement passés à la fonction `new()`. - -Pour une fonction "class constructor", la commande `Current method name` retourne : "*\.constructor*", par exemple "MyClass.constructor". +In that case, when you call the [`new()`](API/classClass.md#new) function, the class constructor is called with the parameters optionally passed to the `new()` function. - - -#### Exemple : +For a class constructor function, the `Current method name` command returns: "*\.constructor*", for example "MyClass.constructor". @@ -320,14 +296,14 @@ Pour une fonction "class constructor", la commande `Current method name` retourn ```4d // Class: MyClass -// Class constructor de MyClass +// Class constructor of MyClass Class Constructor ($name : Text) This.name:=$name ``` ```4d -// Dans une méthode projet -// Vous pouvez instancier un objet +// In a project method +// You can instantiate an object var $o : cs.MyClass $o:=cs.MyClass.new("HelloWorld") // $o = {"name":"HelloWorld"} @@ -338,14 +314,14 @@ $o:=cs.MyClass.new("HelloWorld") ### Class extends \ -#### Syntaxe +#### Syntax ```4d -// Class : ChildClass +// Class: ChildClass Class extends ``` -Le mot-clé `Class extends` est utilisé dans une déclaration de classe pour créer une classe utilisateur qui est elle-même enfant d'une autre classe utilisateur. The child class inherits all functions of the parent class. +The `Class extends` keyword is used in class declaration to create a user class which is a child of another user class. The child class inherits all functions of the parent class. Class extension must respect the following rules: @@ -538,32 +514,32 @@ Then you can write in a project method: The `This` keyword returns a reference to the currently processed object. In 4D, it can be used in [different contexts](https://doc.4d.com/4Dv18/4D/18/This.301-4504875.en.html). -In most cases, the value of `This` is determined by how a function is called. It can't be set by assignment during execution, and it may be different each time the function is called. Par exemple : +In most cases, the value of `This` is determined by how a function is called. It can't be set by assignment during execution, and it may be different each time the function is called. For example: ```4d $o:=New object("prop";42;"f";Formula(This.prop)) $val:=$o.f() //42 ``` -Lorsqu'une fonction de [class constructor](#class-constructor) est utilisée (avec le mot clé `new()`), son `This` est lié au nouvel objet en cours de construction. +When a [class constructor](#class-constructor) function is used (with the [`new()`](API/classClass.md#new) function), its `This` is bound to the new object being constructed. ```4d //Class: ob Class Constructor - // Créer des propriétés sur This, tel que - // souhaité en leur affectant + // Create properties on This as + // desired by assigning to them This.a:=42 ``` ```4d -// dans une méthode 4D +// in a 4D method $o:=cs.ob.new() $val:=$o.a //42 ``` -> Lorsque vous appelez le constructeur de superclasse dans un constructeur à l'aide du mot clé [Super](#super), gardez à l'esprit que `This` ne doit pas être appelé avant le constructeur de superclasse, sinon une erreur est générée. Prenons [cet exemple](#example-1). +> When calling the superclass constructor in a constructor using the [Super](#super) keyword, keep in mind that `This` must not be called before the superclass constructor, otherwise an error is generated. Prenons [cet exemple](#example-1). Dans tous les cas, `This` fait référence à l'objet sur lequel la méthode a été appelée, comme si la méthode était sur l'objet. diff --git a/website/translated_docs/fr/Events/onAfterSort.md b/website/translated_docs/fr/Events/onAfterSort.md index 42960efc05a02a..3d4eb0cb3e41c5 100644 --- a/website/translated_docs/fr/Events/onAfterSort.md +++ b/website/translated_docs/fr/Events/onAfterSort.md @@ -3,11 +3,11 @@ id: onAfterSort title: Sur après tri --- -| Code | Peut être appelé par | Définition | -| ---- | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | -| 30 | [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) | A standard sort has just been carried out in a list box column. | +| Code | Peut être appelé par | Définition | +| ---- | --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | +| 30 | [List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) | Un tri standard vient d'être effectué dans une colonne de list box. | ## Description -This event is generated just after a standard sort is performed (*i.e.* it is NOT generated if $0 returns -1 in the [`On Header Click`](onHeaderClick.md) event). This mechanism is useful for storing the directions of the last sort performed by the user. In this event, the `Self` command returns a pointer to the variable of the sorted column header. +Cet événement est généré juste après un tri standard (c'est-à-dire qu'il n'est PAS généré si $0 retourne -1 dans l'événement [`On Header Click`](onHeaderClick.md)). Ce mécanisme est utile pour stocker les directions du dernier tri effectué par l'utilisateur. Dans ce cas, la commande `Self` retourne un pointeur vers la variable de l'en-tête de colonne triée. diff --git a/website/translated_docs/fr/Events/onAlternativeClick.md b/website/translated_docs/fr/Events/onAlternativeClick.md index 45374c0278ed20..b1aa8ef1985474 100644 --- a/website/translated_docs/fr/Events/onAlternativeClick.md +++ b/website/translated_docs/fr/Events/onAlternativeClick.md @@ -3,28 +3,28 @@ id: onAlternativeClick title: Sur clic alternatif --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 38 | [Button](FormObjects/button_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) |
  • Buttons: The "arrow" area of a button is clicked
  • List boxes: In a column of an object array, an ellipsis button ("alternateButton" attribute) is clicked | +| Code | Peut être appelé par | Définition | +| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| 38 | [Bouton](FormObjects/button_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) |
  • Boutons : la zone "flèche" d'un bouton est cliquée
  • List box : dans une colonne d'un tableau, un bouton de sélection (attribut "alternateButton") est cliqué | ## Description -### Buttons +### Boutons -Some button styles can be [linked to a pop-up menu](FormObjects/properties_TextAndPicture.md#with-pop-up-menu) and display an triangle. Clicking on this triangle causes a selection pop-up to appear that provides a set of alternative actions in relation to the primary button action. +Certains styles de boutons peuvent être [liés à un menu contextuel](FormObjects/properties_TextAndPicture.md#with-pop-up-menu) et afficher un triangle. En cliquant sur ce triangle, une fenêtre contextuelle de sélection apparait et fournit un ensemble d'actions alternatives en relation avec l'action du bouton principal. -4D allows you to manage this type of button using the `On Alternative Click` event. This event is generated when the user clicks on the triangle (as soon as the mouse button is held down): +4D vous permet de gérer ce type de bouton à l'aide de l'événement `On Alternative Click`. Cet événement est généré lorsque l'utilisateur clique sur le triangle (dès que le bouton de la souris est maintenu enfoncé) : -- If the pop-up menu is **separated**,the event is only generated when a click occurs on the portion of the button with the arrow. -- If the pop-up menu is **linked**, the event is generated when a click occurs on any part of the button. Note that the [`On Long Click`](onLongClick.md) event cannot be generated with this type of button. +- Si le menu pop-up est **séparé**, l'événement n'est généré que lorsqu'un clic se produit sur la partie du bouton avec la flèche. +- Si le pop-up menu est **lié**, l'événement est généré lorsqu'un clic se produit sur n'importe quelle partie du bouton. A noter que l'événement [`On Long Click`](onLongClick.md) ne peut pas être généré avec ce type de bouton. ![](assets/en/Events/clickevents.png) ### List box -This event is generated in columns of [object array type list boxes](FormObjects/listbox_overview.md#object-arrays-in-columns-4d-view-pro), when the user clicks on a widget ellipsis button ("alternateButton" attribute). +Cet événement est généré dans des colonnes de [list box de type tableau objets](FormObjects/listbox_overview.md#object-arrays-in-columns-4d-view-pro), lorsque l'utilisateur clique sur un bouton de sélection de widget (attribut "AlternateButton"). ![](assets/en/FormObjects/listbox_column_objectArray_alternateButton.png) -See the [description of the "alternateButton" attribute](FormObjects/listbox_overview.md#alternatebutton). +Voir la [description de l'attribut "alternateButton"](FormObjects/listbox_overview.md#alternatebutton). diff --git a/website/translated_docs/fr/Events/onBeforeDataEntry.md b/website/translated_docs/fr/Events/onBeforeDataEntry.md index d39909a97c18c3..2fd4117a14eaf5 100644 --- a/website/translated_docs/fr/Events/onBeforeDataEntry.md +++ b/website/translated_docs/fr/Events/onBeforeDataEntry.md @@ -3,18 +3,18 @@ id: onBeforeDataEntry title: Sur avant saisie --- -| Code | Peut être appelé par | Définition | -| ---- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | -| 41 | [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) | A list box cell is about to change to editing mode | +| Code | Peut être appelé par | Définition | +| ---- | --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | +| 41 | [List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) | Une cellule de list box est sur le point de passer en mode d'édition | ## Description -This event is generated just before a cell in the list box is edited (before the entry cursor is displayed). This event allows the developer, for example, to display a different text depending on whether the user is in the display or edit mode. +Cet événement est généré juste avant la modification d'une cellule de list box (avant l'affichage du curseur d'entrée). Cet événement permet par exemple au développeur d'afficher un texte différent selon le mode de l'utilisateur (mode affichage ou mode édition). -When the cursor arrives in the cell, the `On Before Data Entry` event is generated in the list box or column method. +Lorsque le curseur arrive dans la cellule, l'événement `On Before Data Entry` est généré dans la list box ou la méthode de la colonne. -- If, in the context of this event, $0 is set to -1, the cell is considered as not enterable. If the event was generated after **Tab** or **Shift+Tab** was pressed, the focus goes to either the next cell or the previous one, respectively. -- If $0 is not -1 (by default $0 is 0), the cell is enterable and switches to editing mode. +- Si, dans le contexte de cet événement, $0 est défini sur -1, la cellule est considérée comme non saisissable. Si l'événement a été généré après avoir appuyé sur **Tab** ou **Maj+Tab**, le focus va respectivement à la cellule suivante ou à la précédente. +- Si la valeur de $0 n'est pas -1 (par défaut $0 est 0), la cellule est saisissable et passe en mode d'édition. -See also [Managing entry](FormObjects/listbox_overview.md#managing-entry) section. \ No newline at end of file +Voir également la section [Gestion des entrées](FormObjects/listbox_overview.md#managing-entry). \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onBeginDragOver.md b/website/translated_docs/fr/Events/onBeginDragOver.md index 05e3dc802a5f0f..75fae33441b12e 100644 --- a/website/translated_docs/fr/Events/onBeginDragOver.md +++ b/website/translated_docs/fr/Events/onBeginDragOver.md @@ -3,24 +3,24 @@ id: onBeginDragOver title: Sur début survol --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- | -| 17 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | An object is being dragged | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | +| 17 | [Zone 4D WritePro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) - Formulaire - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Colonne List Box](FormObjects/listbox_overview.md#list-box-columns) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Onglet](FormObjects/tabControl.md) | Un objet est en cours de déplacement | ## Description -The `On Begin Drag Over` form event can be selected for any form objects that can be dragged. It is generated in every case where the object has the [Draggable](FormObjects/properties_Action.md#draggable) property. It can be called from the method of the source object or the form method of the source object. +L'événement de formulaire `On Begin Drag Over` peut être sélectionné pour tous les objets formulaire pouvant être déplacés. Il est généré dans tous les cas où l'objet a la propriété [Draggable](FormObjects/properties_Action.md#draggable). Il peut être appelé à partir de la méthode de l'objet source ou de la méthode formulaire de l'objet source. -> Unlike the [`On Drag Over`](onDragOver.md) form event, `On Begin Drag Over` is called within the context of the **source object** of the drag action. +> Contrairement à l'événement de formulaire [`On Drag Over`](onDragOver.md), `On Begin Drag Over` est appelé dans le contexte de l'**objet source** de l'action de glisser. -The `On Begin Drag Over` event is useful for preparing of the drag action. It can be used to: +L'événement `On Begin Drag Over` est utile pour préparer l'action de glisser. Il peut être utilisé pour : -- Add data and signatures to the pasteboard (via the `APPEND DATA TO PASTEBOARD` command). -- Use a custom icon during the drag action (via the `SET DRAG ICON` command). -- Accept or refuse dragging via $0 in the method of the dragged object. - - To indicate that drag actions are accepted, the method of the source object must return 0 (zero); you must therefore execute `$0:=0`. - - To indicate that drag actions are refused, the method of the source object must return -1 (minus one); you must therefore execute `$0:=-1`. - - If no result is returned, 4D considers that drag actions are accepted. +- Ajouter des données et des signatures au conteneur (via la commande `APPEND DATA TO PASTEBOARD`). +- Utiliser une icône personnalisée pendant l'action de glissement (via la commande `SET DRAG ICON`). +- Accepter ou refuser le glissement via $0 dans la méthode de l'objet glissé. + - Pour indiquer que les actions de glissement sont acceptées, la méthode de l'objet source doit retourner 0 (zéro); vous devez donc exécuter `$0:=0`. + - Pour indiquer que les actions de glissement sont refusées, la méthode de l'objet source doit retourner -1 (moins un); vous devez donc exécuter `$0:=-1`. + - Si aucun résultat n'est retourné, 4D considère que les actions de glissement sont acceptées. -4D data are put in the pasteboard before calling the event. For example, in the case of dragging without the **Automatic Drag** action, the dragged text is already in the pasteboard when the event is called. \ No newline at end of file +Les données 4D sont placées dans le presse-papiers avant d'appeler l'événement. Par exemple, dans le cas d'un glissement sans l'action de **glissement automatique**, le texte glissé se trouve déjà dans le conteneur lorsque l'événement est appelé. \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onBeginUrlLoading.md b/website/translated_docs/fr/Events/onBeginUrlLoading.md index 330a1a09e1fffb..f088f9602e1dc7 100644 --- a/website/translated_docs/fr/Events/onBeginUrlLoading.md +++ b/website/translated_docs/fr/Events/onBeginUrlLoading.md @@ -3,13 +3,13 @@ id: onBeginUrlLoading title: On Begin URL Loading --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------- | ----------------------------------- | -| 47 | [Zone Web](FormObjects/webArea_overview.md) | A new URL is loaded in the Web area | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------- | --------------------------------------------- | +| 47 | [Zone Web](FormObjects/webArea_overview.md) | Une nouvelle URL est chargée dans la zone Web | ## Description -This event is generated at the start of loading a new URL in the Web area. The `URL` variable associated with the Web area can be used to find out the URL being loaded. +Cet événement est généré au début du chargement d'une nouvelle URL dans la zone Web. La variable `URL` associée à la zone Web peut être utilisée pour connaître l'URL en cours de chargement. -> The URL being loaded is different from the [current URL](FormObjects/properties_WebArea.md#url-variable-and-wa-open-url-command) (refer to the description of the `WA Get current URL` command). \ No newline at end of file +> L'URL en cours de chargement est différente de [l'URL courante](FormObjects/properties_WebArea.md#url-variable-and-wa-open-url-command) (reportez-vous à la description de la commande `WA Get current URL`). \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onBoundVariableChange.md b/website/translated_docs/fr/Events/onBoundVariableChange.md index 7d4928731a877c..6caced030c1a72 100644 --- a/website/translated_docs/fr/Events/onBoundVariableChange.md +++ b/website/translated_docs/fr/Events/onBoundVariableChange.md @@ -3,13 +3,13 @@ id: onBoundVariableChange title: On Bound Variable Change --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------- | ------------------------------------------- | -| 54 | Formulaire | The variable bound to a subform is modified | +| Code | Peut être appelé par | Définition | +| ---- | -------------------- | -------------------------------------------------- | +| 54 | Formulaire | La variable liée à un sous-formulaire est modifiée | ## Description -This event is generated in the context of the form method of a [subform](FormObjects/subform_overview.md) as soon as a value is assigned to the variable bound with the subform in the parent form (even if the same value is reassigned) and if the subform belongs to the current form page or to page 0. +Cet événement est généré dans le contexte de la méthode formulaire d'un [sous-formulaire](FormObjects/subform_overview.md) dès qu'une valeur est affectée à la variable liée au sous-formulaire du formulaire parent (même si la même valeur est réaffectée) et si le sous-formulaire appartient à la page formulaire courante ou à la page 0. -Form more information, refer to the [Managing the bound variable](FormObjects/subform_overview.md#managing-the-bound-variable) section. \ No newline at end of file +Pour plus d'informations, reportez-vous à la section [Gérer la variable liée](FormObjects/subform_overview.md#managing-the-bound-variable). \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onClicked.md b/website/translated_docs/fr/Events/onClicked.md index 6512d8a9f6267c..41dfa2135794f6 100644 --- a/website/translated_docs/fr/Events/onClicked.md +++ b/website/translated_docs/fr/Events/onClicked.md @@ -3,36 +3,36 @@ id: onClicked title: Sur clic --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- | -| 4 | [4D View Pro Area](FormObjects/viewProArea_overview.md) - [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | A click occurred on an object | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------- | +| 4 | [4D View Pro Area](FormObjects/viewProArea_overview.md) - [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | Un clic a été effectué sur un objet | ## Description -The `On Clicked` event is generated when the user clicks on an object. +L'événement `On Clicked` est généré lorsque l'utilisateur clique sur un objet. -> Some form objects can be activated with the keyboard. For example, once a check box gets the focus, it can be entered using the space bar. In such a case, the `On Clicked` event is still generated. +> Certains objets de formulaire peuvent être activés avec le clavier. Par exemple, une fois qu'une case à cocher obtient le focus, elle peut être saisie à l'aide de la barre d'espace. Dans ce cas, l'événement `On Clicked` est toujours généré. -The `On Clicked` event usually occurs once the mouse button is released. However, there are several exceptions: +L'événement `On Clicked` se produit généralement une fois que le bouton de la souris est relâché. Cependant, il existe plusieurs exceptions : -- [Invisible buttons](FormObjects/properties_Display.md#not-rendered): The `On Clicked` event occurs as soon as the click is made and does not wait for the mouse button to be released. -- [Rulers](FormObjects/ruler.md): If the [Execute object method](FormObjects/properties_Action.md#execute-object-method) option is set to **true**, the `On Clicked` event occurs as soon as the click is made. -- [Combo boxes](FormObjects/comboBox_overview.md): The `On Clicked` event occurs only if the user selects another value in the associated menu. A [combo box](FormObjects/comboBox_overview.md) must be treated as an enterable text area whose associated drop-down list provides default values. Consequently, you handle data entry within a combo box through the `On Before Keystroke`, `On After Keystroke` and `On Data Change` events. -- [Drop-down lists](FormObjects/dropdownList_Overview.md): The `On Clicked` event occurs only if the user selects another value in the menu. The `On Data Change` event allows you to detect the activation of the object when a value different from the current value is selected +- [Boutons invisibles](FormObjects/properties_Display.md#not-rendered): l'événement `On Clicked` se produit dès que le clic est effectué et n'attend pas que le bouton de la souris soit relâché. +- [Règles](FormObjects/ruler.md) : si l'option de [méthode d'exécution d'objet](FormObjects/properties_Action.md#execute-object-method) est définie sur **true**, l'événement `On Clicked` se produit dès que le clic est effectué. +- [Combo box](FormObjects/comboBox_overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu associé. Une [combo box](FormObjects/comboBox_overview.md) doit être traitée comme une zone de texte saisissable dont la liste déroulante associée fournit des valeurs par défaut. Par conséquent, vous gérez la saisie de données dans une combo box via les événements `On Before Keystroke`, `On After Keystroke` et `On Data Change`. +- [Listes déroulantes](FormObjects/dropdownList_Overview.md) : l'événement `On Clicked` se produit uniquement si l'utilisateur sélectionne une autre valeur dans le menu. L'événement `On Data Change` vous permet de détecter l'activation de l'objet lorsqu'une valeur différente de la valeur courante est sélectionnée - Lorsqu'une cellule d'entrée de list box est [en cours d'édition](FormObjects/listbox_overview.md#managing-entry), l'événement `On Clicked` est généré lorsque le bouton de la souris est enfoncé, permettant d'utiliser la commande `Contextual click` par exemple. -In the context of an `On Clicked` event, you can test the number of clicks made by the user by means of the `Clickcount` command. +Dans le cas d'un événement `On Clicked`, vous pouvez tester le nombre de clics effectués par l'utilisateur à l'aide de la commande `Clickcount`. -### On Clicked and On Double Clicked +### On Clicked et On Double Clicked -After the `On Clicked` or [`On Double Clicked`](onDoubleClicked.md) object event property is selected for an object, you can detect and handle the clicks within or on the object, using the `FORM event` command that returns `On Clicked` or [`On Double Clicked`](onDoubleClicked.md), depending on the case. +Une fois que la propriété d'événement d'objet `On Clicked` ou [`On Double Clicked`](onDoubleClicked.md) est sélectionnée pour un objet, vous pouvez détecter et gérer les clics dans ou sur l'objet, à l'aide de la commande `FORM event` qui retourne `On Clicked` ou [`On Double Clicked`](onDoubleClicked.md), selon le cas. -If both events are selected for an object, the `On Clicked` and then the `On Double Clicked` events will be generated when the user double-clicks the object. +Si les deux événements sont sélectionnés pour un objet, les événements `On Clicked` puis `On Double Clicked` seront générés lorsque l'utilisateur double-clique sur l'objet. ### 4D View Pro -This event is generated when the user clicks anywhere on a 4D View Pro document. On this context, the [event object](overview.md#event-object) returned by the `FORM Event` command contains: +Cet événement est généré lorsque l'utilisateur clique n'importe où dans un document 4D View Pro. Dans ce contexte, l'[objet événement](overview.md#event-object) retourné par la commande `FORM Event` contient : | Propriété | Type | Description | | ----------- | ----------- | ------------------------------ | diff --git a/website/translated_docs/fr/Events/onCloseBox.md b/website/translated_docs/fr/Events/onCloseBox.md index 0bfb4f742c3daf..db5106294e8e3c 100644 --- a/website/translated_docs/fr/Events/onCloseBox.md +++ b/website/translated_docs/fr/Events/onCloseBox.md @@ -3,21 +3,21 @@ id: onCloseBox title: On Close Box --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------- | --------------------------------------- | -| 22 | Formulaire | The window’s close box has been clicked | +| Code | Peut être appelé par | Définition | +| ---- | -------------------- | ------------------------------------------------ | +| 22 | Formulaire | La case de fermeture de la fenêtre a été cliquée | ## Description -The `On Close Box` event is generated when the user clicks on the clos box of the window. +L'événement `On Close Box` est généré lorsque l'utilisateur clique sur la case fermeture de la fenêtre. ### Exemple -This example shows how to respond to a close window event with a form used for record data entry: +Cet exemple illustre comment vous pouvez répondre à un événement de fermeture de fenêtre à l'aide d'un formulaire utilisé pour la saisie de données d'enregistrement : ```4d - //Method for an input form + //Méthode pour un formulaire d'entrée $vpFormTable:=Current form table Case of //... diff --git a/website/translated_docs/fr/Events/onCloseDetail.md b/website/translated_docs/fr/Events/onCloseDetail.md index a0e9f5526674a0..9549faab7cdab2 100644 --- a/website/translated_docs/fr/Events/onCloseDetail.md +++ b/website/translated_docs/fr/Events/onCloseDetail.md @@ -3,15 +3,15 @@ id: onCloseDetail title: Sur fermeture corps --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------------------------------------- | -------------------------------------------------------------- | -| 26 | Form - [List Box](FormObjects/listbox_overview.md) | You left the detail form and are going back to the output form | +| Code | Peut être appelé par | Définition | +| ---- | -------------------------------------------------------- | --------------------------------------------------------------------------------- | +| 26 | Formulaire - [List Box](FormObjects/listbox_overview.md) | Vous avez quitté le formulaire détaillé et vous retournez au formulaire de sortie | ## Description -The `On Close Detail` event can be used in the following contexts: +L'événement `On Close Detail` peut être utilisé dans les contextes suivants : -- **Output forms**: the detail form is closed and the user goes back to the list form. This event cannot be selected for project forms, it is only available with **table forms**. -- List box of the [**selection type**](FormObjects/listbox_overview.md#selection-list-boxes): This event is generated when a record displayed in the [detail form](FormObjects/properties_ListBox.md#detail-form-name) associated with a selection type list box is about to be closed (regardless of whether or not the record was modified). +- **Formulaires de sortie** : le formulaire détaillé est fermé et l'utilisateur retourne au formulaire liste. Cet événement ne peut pas être sélectionné pour les formulaires projet, il est uniquement disponible avec les **formulaires table**. +- List box [**de type sélection**](FormObjects/listbox_overview.md#selection-list-boxes) : Cet événement est généré lorsqu'un enregistrement affiché dans le [formulaire détaillé](FormObjects/properties_ListBox.md#detail-form-name) associé à une list box de type sélection est sur le point d'être fermé (que l'enregistrement ait été modifié ou non). diff --git a/website/translated_docs/fr/Events/onCollapse.md b/website/translated_docs/fr/Events/onCollapse.md index bcaf2c2adb740e..38425294a64a06 100644 --- a/website/translated_docs/fr/Events/onCollapse.md +++ b/website/translated_docs/fr/Events/onCollapse.md @@ -3,15 +3,15 @@ id: onCollapse title: Sur contracter --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -| 44 | [Hierarchical List](FormObjects/list_overview.md#overview) - [List Box](FormObjects/listbox_overview.md) | An element of the hierarchical list or hierarchical list box has been collapsed using a click or a keystroke | +| Code | Peut être appelé par | Définition | +| ---- | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | +| 44 | [Liste hiérarchique](FormObjects/list_overview.md#overview) - [List Box](FormObjects/listbox_overview.md) | Un élément de la liste hiérarchique ou de la list box hiérarchique a été réduit à l'aide d'un clic ou d'une touche du clavier | ## Description -- [Hierarchical list](FormObjects/list_overview.md): This event is generated every time an element of the hierarchical list is collapsed with a mouse click or keystroke. -- [Hierarchical list boxes](FormObjects/listbox_overview.md#hierarchical-list-boxes): This event is generated when a row of the hierarchical list box is collapsed. +- [Liste hiérarchique](FormObjects/list_overview.md) : Cet événement est généré chaque fois qu'un élément de la liste hiérarchique est réduit via un clic de souris ou une touche du clavier. +- [List box hiérarchiques](FormObjects/listbox_overview.md#hierarchical-list-boxes) : Cet événement est généré lorsqu'une ligne de la list box hiérarchique est réduite. ### Voir également diff --git a/website/translated_docs/fr/Events/onColumnMoved.md b/website/translated_docs/fr/Events/onColumnMoved.md index 77fbb35304d3d4..6b72ccc42c496a 100644 --- a/website/translated_docs/fr/Events/onColumnMoved.md +++ b/website/translated_docs/fr/Events/onColumnMoved.md @@ -3,13 +3,13 @@ id: onColumnMoved title: Sur déplacement colonne --- -| Code | Peut être appelé par | Définition | -| ---- | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | -| 32 | [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) | A list box column is moved by the user via drag and drop | +| Code | Peut être appelé par | Définition | +| ---- | --------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | +| 32 | [List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) | Une colonne de list box est déplacée par l'utilisateur par glisser-déposer | ## Description -This event is generated when a column of the list box is moved by the user using drag and drop ([if allowed](FormObjects/propertiesListBox.html#locked-columns-and-static-columns)). It is not generated if the column is dragged and then dropped in its initial location. +Cet événement est généré lorsqu'une colonne de list box est déplacée par l'utilisateur à l'aide du glisser-déposer ([s'il est autorisé](FormObjects/propertiesListBox.html#locked-columns-and-static-columns)). Il n'est pas généré si la colonne est glissée puis déposée à son emplacement initial. -The `LISTBOX MOVED COLUMN NUMBER` command returns the new position of the column. \ No newline at end of file +La commande `LISTBOX MOVED COLUMN NUMBER` retourne la nouvelle position de la colonne. \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onColumnResize.md b/website/translated_docs/fr/Events/onColumnResize.md index fd419fabd42059..dcf7e507a4a668 100644 --- a/website/translated_docs/fr/Events/onColumnResize.md +++ b/website/translated_docs/fr/Events/onColumnResize.md @@ -3,31 +3,31 @@ id: onColumnResize title: Sur redimensionnement colonne --- -| Code | Peut être appelé par | Définition | -| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | -| 33 | [4D View Pro Area](FormObjects/viewProArea_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) | The width of a column is modified directly by the user or consequently to a form window resize | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | +| 33 | [Zone 4D View Pro](FormObjects/viewProArea_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) | La largeur d'une colonne est modifiée directement par l'utilisateur ou à la suite d'un redimensionnement de la fenêtre de formulaire | ## Description ### List Box -This event is generated when the width of a column in the list box is modified by a user. The event is triggered "live", *i.e.*, sent continuously during the event, for as long as the list box or column concerned is being resized. This resizing is performed manually by a user, or may occur as a result of the list box and its column(s) being resized along with the form window itself (whether the form is resized manually or using the `RESIZE FORM WINDOW` command). +Cet événement est généré lorsque la largeur d'une colonne dans la list box est modifiée par un utilisateur. L'événement est déclenché "en direct", c'est-à-dire envoyé en continu pendant l'événement, tant que la list box ou la colonne concernée est redimensionnée. Ce redimensionnement s'effectue manuellement par un utilisateur, ou peut se produire suite au redimensionnement de la list box et de ses colonnes avec la fenêtre de formulaire elle-même (que le formulaire soit redimensionné manuellement ou à l'aide de la commande `RESIZE FORM WINDOW`). -> The `On Column Resize` event is not triggered when a [fake column](FormObjects/propertiesResizingOptions.html#about-the-fake-blank-column) is resized. +> L'événement `On Column Resize` n'est pas déclenché lorsqu'une [fausse colonne](FormObjects/propertiesResizingOptions.html#about-the-fake-blank-column) est redimensionnée. ### 4D View Pro -This event is generated when the width of a column is modified by a user. On this context, the [event object](overview.md#event-object) returned by the `FORM Event` command contains: +Cet événement est généré lorsque la largeur d'une colonne est modifiée par un utilisateur. Dans ce contexte, l'[objet événement](overview.md#event-object) retourné par la commande `FORM Event` contient : -| Propriété | Type | Description | -| ----------- | ----------- | ------------------------------------------------------------------- | -| code | entier long | Sur redimensionnement colonne | -| description | Texte | "On Column Resize" | -| objectName | Texte | 4D View Pro area name | -| sheetName | Texte | Name of the sheet of the event | -| range | object | Cell range of the columns whose widths have changed | -| header | boolean | True if the row header column (first column) is resized, else false | +| Propriété | Type | Description | +| ----------- | ----------- | ------------------------------------------------------------------------------------------ | +| code | entier long | Sur redimensionnement colonne | +| description | Texte | "On Column Resize" | +| objectName | Texte | 4D View Pro area name | +| sheetName | Texte | Name of the sheet of the event | +| range | object | Plage de cellules des colonnes dont les largeurs ont changé | +| header | boolean | "True" si la colonne d'en-tête de ligne (première colonne) est redimensionnée, sinon false | #### Exemple diff --git a/website/translated_docs/fr/Events/onDataChange.md b/website/translated_docs/fr/Events/onDataChange.md index 0e62a62846fc98..66cf6f3f4cbe3c 100644 --- a/website/translated_docs/fr/Events/onDataChange.md +++ b/website/translated_docs/fr/Events/onDataChange.md @@ -3,16 +3,16 @@ id: onDataChange title: Sur données modifiées --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | -| 20 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Stepper](FormObjects/stepper.md) - [Subform](FormObjects/subform_overview.md) | An object data has been modified | +| Code | Peut être appelé par | Définition | +| ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | +| 20 | [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Liste déroulante](FormObjects/dropdownList_Overview.md) - Formulaire - [Liste hiérarchique](FormObjects/list_overview.md) - [Zone de saisie](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) - [Zone de Plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Règle](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Stepper](FormObjects/stepper.md) - [Sous-formulaire](FormObjects/subform_overview.md) | Une donnée a été modifiée | ## Description -When the `On Data Change` event property is selected for an object, you can detect and handle the change of the data source value, using the `FORM Event` command. +Lorsque la propriété d'événement `On Data Change` est sélectionnée pour un objet, vous pouvez détecter et gérer la modification de la valeur de la source de données à l'aide de la commande `FORM Event`. -The event is generated as soon as the variable associated with the object is updated internally by 4D (i.e., in general, when the entry area of the object loses the focus). +L'événement est généré dès que la variable associée à l'objet est mise à jour en interne par 4D (c'est-à-dire, en général, lorsque la zone de saisie de l'objet perd le focus). -> With [subforms](FormObjects/subform_overview.md), the `On Data Change` event is triggered when the value of the variable of the subform object has been modified. +> Avec les [sous-formulaires](FormObjects/subform_overview.md), l'événement `On Data Change` est déclenché lorsque la valeur de la variable de l'objet sous-formulaire a été modifiée. diff --git a/website/translated_docs/fr/Events/onDeactivate.md b/website/translated_docs/fr/Events/onDeactivate.md index 06babd10114d8f..65e184cfca04a9 100644 --- a/website/translated_docs/fr/Events/onDeactivate.md +++ b/website/translated_docs/fr/Events/onDeactivate.md @@ -3,16 +3,16 @@ id: onDeactivate title: On Deactivate --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------- | --------------------------------------------------- | -| 12 | Formulaire | The form’s window ceases to be the frontmost window | +| Code | Peut être appelé par | Définition | +| ---- | -------------------- | ------------------------------------------------------- | +| 12 | Formulaire | La fenêtre du formulaire cesse d'être la fenêtre active | ## Description -If the window of a form was the frontmost window, this event is called when the window is sent to the background. +Si la fenêtre d'un formulaire était la fenêtre de premier plan, cet événement est appelé lorsque la fenêtre est envoyée en arrière-plan. -Cet événement s'applique au formulaire dans son ensemble et non à un objet particulier. Consequently, if the `On Deactivate` form event property is selected, only the form will have its form method called. +Cet événement s'applique au formulaire dans son ensemble et non à un objet particulier. Par conséquent, si la propriété de l'événement formulaire `On Deactivate` est sélectionnée, seul le formulaire verra sa méthode formulaire appelée. ### Voir également [Sur activation](onActivate.md) \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onDeleteAction.md b/website/translated_docs/fr/Events/onDeleteAction.md index ae16c780ff3d45..98c84530381b8d 100644 --- a/website/translated_docs/fr/Events/onDeleteAction.md +++ b/website/translated_docs/fr/Events/onDeleteAction.md @@ -3,13 +3,13 @@ id: onDeleteAction title: Sur action suppression --- -| Code | Peut être appelé par | Définition | -| ---- | ----------------------------------------------------------------------------------------------- | ----------------------------------- | -| 58 | [Hierarchical List](FormObjects/list_overview.md) - [List Box](FormObjects/listbox_overview.md) | The user attempts to delete an item | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------ | ------------------------------------------- | +| 58 | [Liste hiérarchique](FormObjects/list_overview.md) - [List Box](FormObjects/listbox_overview.md) | L'utilisateur tente de supprimer un élément | ## Description -This event is generated each time a user attempts to delete the selected item(s) by pressing a deletion key (**Delete** or **Backspace**) or selecting a menu item whose associated standard action is 'Clear' (such as the **Clear** command in the **Edit** menu). +Cet événement est généré chaque fois qu'un utilisateur tente de supprimer le ou les éléments sélectionnés en appuyant sur une touche de suppression (**Supprimer** ou **Retour en arrière**) ou en sélectionnant un élément de menu dont l'action standard associée est 'Effacer' (telle que la commande **Effacer** dans le menu **Edition**). -Note that generating the event is the only action carried out by 4D: the program does not delete any items. It is up to the developer to handle the deletion and any prior warning messages that are displayed. +A noter que la génération de l'événement est la seule action réalisée par 4D : le programme ne supprime aucun élément. Il appartient au développeur de gérer la suppression et tous les messages d'avertissement précédents qui sont affichés. diff --git a/website/translated_docs/fr/Events/onDisplayDetail.md b/website/translated_docs/fr/Events/onDisplayDetail.md index 732fcabae0fe4b..898a318b116063 100644 --- a/website/translated_docs/fr/Events/onDisplayDetail.md +++ b/website/translated_docs/fr/Events/onDisplayDetail.md @@ -3,38 +3,38 @@ id: onDisplayDetail title: Sur affichage corps --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------- | -| 8 | Form - [List Box](FormObjects/listbox_overview.md) | A record is about to be displayed in a list form or a row is about to be displayed in a list box. | +| Code | Peut être appelé par | Définition | +| ---- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | +| 8 | Formulaire - [List Box](FormObjects/listbox_overview.md) | Un enregistrement est sur le point d'être affiché dans un formulaire liste ou bien une ligne est sur le point d'être affichée dans une list box. | ## Description -The `On Display Detail` event can be used in the following contexts: +L'événement `On Display Detail` peut être utilisé dans les contextes suivants : -### Output form +### Formulaire de sortie -A record is about to be displayed in a list form displayed via `DISPLAY SELECTION` and `MODIFY SELECTION`. +Un enregistrement est sur le point d'être affiché sous forme de liste affichée via `DISPLAY SELECTION` et `MODIFY SELECTION`. -> This event cannot be selected for project forms, it is only available with **table forms**. +> Cet événement ne peut pas être sélectionné pour les formulaires projet, il est uniquement disponible avec les **formulaires table**. -In this context, the following sequence of calls to methods and form events is triggered: +Dans ce contexte, la séquence d'appels de méthodes et d'événements de formulaire suivante est déclenchée : -- For each record: - - For each object in the detail area: - - Object method with `On Display Detail` event - - Form method with `On Display Detail` event +- Pour chaque enregistrement : + - Pour chaque objet de la zone détaillée : + - Méthode objet avec l'événement `On Display Detail` + - Méthode formulaire avec l'événement `On Display Detail` -> The header area is handled using the [`On Header`](onHeader.md) event. +> La zone d'en-tête est gérée à l'aide de l'événement [`On Header`](onHeader.md). -Calling a 4D command that displays a dialog box from the `On Display Detail` event is not allowed and will cause a syntax error to occur. More particularly, the commands concerned are: `ALERT`, `DIALOG`, `CONFIRM`, `Request`, `ADD RECORD`, `MODIFY RECORD`, `DISPLAY SELECTION`, and `MODIFY SELECTION`. +L'appel d'une commande 4D qui affiche une boîte de dialogue à partir de l'événement `On Display Detail` n'est pas autorisé et générera une erreur de syntaxe. Plus particulièrement, les commandes concernées sont : `ALERT`, `DIALOG`, `CONFIRM`, `Request`, `ADD RECORD`, `MODIFY RECORD`, `DISPLAY SELECTION`, et `MODIFY SELECTION`. ### Liste box sélection -This event is generated when a row of a [**selection type**](FormObjects/listbox_overview.md#selection-list-boxes) list box is displayed. +Cet événement est généré lorsqu'une ligne de list box [**de type sélection**](FormObjects/listbox_overview.md#selection-list-boxes) est affichée. -### Displayed line number +### Numéro de ligne affiché -The `Displayed line number` 4D command works with the `On Display Detail` form event. It returns the number of the row being processed while a list of records or list box rows is displayed on screen. +La commande 4D `Displayed line number` fonctionne avec l'événement formulaire `On Display Detail`. Elle retourne le numéro de la ligne en cours de traitement tandis qu'une liste d'enregistrements ou de lignes de list box s'affiche à l'écran. diff --git a/website/translated_docs/fr/Events/onDoubleClicked.md b/website/translated_docs/fr/Events/onDoubleClicked.md index 37321a524ac976..f41f30b5f10494 100644 --- a/website/translated_docs/fr/Events/onDoubleClicked.md +++ b/website/translated_docs/fr/Events/onDoubleClicked.md @@ -3,22 +3,22 @@ id: onDoubleClicked title: Sur double clic --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------ | -| 13 | [4D View Pro Area](FormObjects/viewProArea_overview.md) - [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | A double click occurred on an object | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------ | +| 13 | [4D View Pro Area](FormObjects/viewProArea_overview.md) - [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | Un double-clic a été effectué sur un objet | ## Description -The `On Double Clicked` event is generated when the user double-clicks on an object. The maximum length of time separating a double-click is defined in the system preferences. +L'événement `On Double Clicked` est généré lorsque l'utilisateur double-clique sur un objet. La durée maximale séparant un double-clic est définie dans les préférences système. -If the [`On Clicked`](onClicked.md) or `On Double Clicked` onDoubleClicked.md object event property is selected for an object, you can detect and handle the clicks within or on the object, using the `FORM event` command that returns [`On Clicked`](onClicked.md) or `On Double Clicked`, depending on the case. +Si la propriété [`On Clicked`](onClicked.md) ou `On Double Clicked` d'événement d'objet de onDoubleClicked.md est sélectionnée pour un objet, vous pouvez détecter et gérer les clics dans ou sur l'objet, à l'aide de la commande `FORM event` qui retoure [`On Clicked`](onClicked.md) ou `On Double Clicked`, selon le cas. -If both events are selected for an object, the `On Clicked` and then the `On Double Clicked` events will be generated when the user double-clicks the object. +Si les deux événements sont sélectionnés pour un objet, les événements `On Clicked` puis `On Double Clicked` seront générés lorsque l'utilisateur double-clique sur l'objet. ### 4D View Pro -This event is generated when the user doubl-clicks anywhere on a 4D View Pro document. On this context, the [event object](overview.md#event-object) returned by the `FORM Event` command contains: +Cet événement est généré lorsque l'utilisateur double-clique n'importe où dans un document 4D View Pro. Dans ce contexte, l'[objet événement](overview.md#event-object) retourné par la commande `FORM Event` contient : | Propriété | Type | Description | | ----------- | ----------- | ------------------------------ | diff --git a/website/translated_docs/fr/Events/onDragOver.md b/website/translated_docs/fr/Events/onDragOver.md index 1df5eb3b8ddf1a..25c3cab8926a6f 100644 --- a/website/translated_docs/fr/Events/onDragOver.md +++ b/website/translated_docs/fr/Events/onDragOver.md @@ -3,27 +3,27 @@ id: onDragOver title: Sur glisser --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | -| 21 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | Data could be dropped onto an object | +| Code | Peut être appelé par | Définition | +| ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | +| 21 | [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) -[List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) -[Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Onglet](FormObjects/tabControl.md) | Les données peuvent être déposées sur un objet | ## Description -The `On Drag Over` event is repeatedly sent to the destination object when the mouse pointer is moved over the object. In response to this event, you usually: +L'événement `On Drag Over` est envoyé à plusieurs reprises à l'objet de destination lorsque le pointeur de la souris est déplacé sur l'objet. Généralement, en réponse à cet événement : -- Get the data and signatures found in the pasteboard (via the `GET PASTEBOARD DATA` command). -- Depending on the nature and type of data in the pasteboard, you **accept** or **reject** the drag and drop. +- Vous récupérez les données et les signatures présentes dans le conteneur (via la commande `GET PASTEBOARD DATA`). +- En fonction de la nature et du type de données dans le conteneur, vous acceptez ou refusez le glisser-déposer. -To **accept** the drag, the destination object method must return 0 (zero), so you write `$0:=0`. To **reject** the drag, the object method must return -1 (minus one), so you write `$0:=-1`. During an `On Drag Over` event, 4D treats the object method as a function. If no result is returned, 4D assumes that the drag is accepted. +Pour **accepter** le glissement, la méthode de l'objet de destination doit retourner 0 (zéro), vous devez donc écrire `$0:=0`. Pour **rejeter** le glissement, la méthode de l'objet de destination doit retourner 0 (zéro), vous devez donc écrire `$0:=-1`. Lors d'un événement `On Drag Over`, 4D traite la méthode objet comme une fonction. Si aucun résultat n'est retourné, 4D suppose que le glissement est accepté. -If you accept the drag, the destination object is highlighted. If you reject the drag, the destination is not highlighted. Accepting the drag does not mean that the dragged data is going to be inserted into the destination object. It only means that if the mouse button was released at this point, the destination object would accept the dragged data and the [`On Drop`](onDrop.md) event would be fired. +Si vous acceptez le glissement, l'objet de destination est mis en surbrillance. Si vous refusez le glissement, la destination n'est pas mise en surbrillance. Accepter le glissement ne signifie pas que les données déplacées vont être insérées dans l'objet de destination. Cela signifie seulement que si le bouton de la souris était relâché à ce stade, l'objet de destination accepterait les données glissées et l'événement [`On Drop`](onDrop.md) serait déclenché. -If you do not process the `On Drag Over` event for a droppable object, that object will be highlighted for all drag over operations, no matter what the nature and type of the dragged data. +Si vous ne traitez pas l'événement `On Drag Over` pour un objet déposable, cet objet sera mis en surbrillance pour toutes les opérations de glissement, quels que soient la nature et le type des données déplacées. -The `On Drag Over` event is the means by which you control the first phase of a drag-and-drop operation. Not only can you test whether the dragged data is of a type compatible with the destination object, and then accept or reject the drag; you can simultaneously notify the user of this fact, because 4D highlights (or not) the destination object, based on your decision. +L'événement `On Drag Over` est le moyen par lequel vous contrôlez la première phase d'une opération de glisser-déposer. Vous pouvez non seulement tester si les données déplacées sont d'un type compatible avec l'objet de destination, puis accepter ou rejeter le glissement; vous pouvez simultanément avertir l'utilisateur de ce fait, car 4D met en évidence (ou non) l'objet de destination, en fonction de votre décision. -The code handling an `On Drag Over` event should be short and execute quickly, because that event is sent repeatedly to the current destination object, due to the movements of the mouse. +Le code gérant un événement `On Drag Over` doit être court et s'exécuter rapidement, car cet événement est envoyé à plusieurs reprises à l'objet de destination courant, en raison des mouvements de la souris. #### Voir également diff --git a/website/translated_docs/fr/Events/onDrop.md b/website/translated_docs/fr/Events/onDrop.md index a98c854be5b24e..ca213dfd8e2d93 100644 --- a/website/translated_docs/fr/Events/onDrop.md +++ b/website/translated_docs/fr/Events/onDrop.md @@ -3,16 +3,16 @@ id: onDrop title: Sur déposer --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ | -| 16 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | Data has been dropped onto an object | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | +| 16 | [Zone 4D WritePro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) - Formulaire - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Colonne List Box](FormObjects/listbox_overview.md#list-box-columns) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Onglet](FormObjects/tabControl.md) | Les données ont été déposées sur un objet | ## Description -The `On Drop` event is sent once to the destination object when the mouse pointer is released over the object. This event is the second phase of the drag-and-drop operation, in which you perform an operation in response to the user action. +L'événement `On Drop` est envoyé une fois à l'objet de destination lorsque le pointeur de la souris est relâché sur l'objet. Cet événement est la deuxième phase de l'opération de glisser-déposer, où l'opération que vous réalisez est en réponse à l'action de l'utilisateur. -This event is not sent to the object if the drag was not accepted during the [`On Drag Over`](onDragOver.md) events. If you process the `On Drag Over` event for an object and reject a drag, the `On Drop` event does not occur. Thus, if during the `On Drag Over` event you have tested the data type compatibility between the source and destination objects and have accepted a possible drop, you do not need to re-test the data during the `On Drop`. You already know that the data is suitable for the destination object. +Cet événement n'est pas envoyé à l'objet si le glissement n'a pas été accepté lors des événements [`On Drag Over`](onDragOver.md). Si vous traitez l'événement `On Drag Over` pour un objet et rejetez un glissement, l'événement `On Drop` ne se produit pas. Ainsi, si lors de l'événement `On Drag Over` vous avez testé la compatibilité des types de données entre les objets source et destination, et si vous avez accepté un éventuel dépôt, vous n'avez pas besoin de re-tester les données pendant l'événement `On Drop`. Vous savez déjà que les données sont adaptées à l'objet de destination. diff --git a/website/translated_docs/fr/Events/onEndUrlLoading.md b/website/translated_docs/fr/Events/onEndUrlLoading.md index c81f3db1961f5b..8a649d489de79c 100644 --- a/website/translated_docs/fr/Events/onEndUrlLoading.md +++ b/website/translated_docs/fr/Events/onEndUrlLoading.md @@ -3,11 +3,11 @@ id: onEndUrlLoading title: On End URL Loading --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------- | --------------------------------------------- | -| 49 | [Zone Web](FormObjects/webArea_overview.md) | All the resources of the URL have been loaded | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------- | ----------------------------------------------- | +| 49 | [Zone Web](FormObjects/webArea_overview.md) | Toutes les ressources de l'URL ont été chargées | ## Description -This event is generated once the loading of all resources of the URL is complete. You can call the `WA Get current URL` command in order to find out the URL that was loaded. +Cet événement est généré une fois que le chargement de toutes les ressources de l'URL est terminé. Vous pouvez appeler la commande `WA Get current URL` afin d'obtenir l'URL chargée. diff --git a/website/translated_docs/fr/Events/onExpand.md b/website/translated_docs/fr/Events/onExpand.md index 4316ad953c2406..841681f3dcae11 100644 --- a/website/translated_docs/fr/Events/onExpand.md +++ b/website/translated_docs/fr/Events/onExpand.md @@ -3,15 +3,15 @@ id: onExpand title: Sur déployer --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | -| 44 | [Hierarchical List](FormObjects/list_overview.md#overview) - [List Box](FormObjects/listbox_overview.md) | An element of the hierarchical list or hierarchical list box has been expanded using a click or a keystroke | +| Code | Peut être appelé par | Définition | +| ---- | --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | +| 44 | [Liste hiérarchique](FormObjects/list_overview.md#overview) - [List Box](FormObjects/listbox_overview.md) | Un élément de la liste hiérarchique ou de la list box hiérarchique a été développé à l'aide d'un clic ou d'une touche | ## Description -- [Hierarchical list](FormObjects/list_overview.md): This event is generated every time an element of the hierarchical list is expanded with a mouse click or keystroke. -- [Hierarchical list boxes](FormObjects/listbox_overview.md#hierarchical-list-boxes): This event is generated when a row of the hierarchical list box is expanded. +- [Liste hiérarchique](FormObjects/list_overview.md) : Cet événement est généré chaque fois qu'un élément de la liste hiérarchique est étendu via un clic de souris ou une touche du clavier. +- [List box hiérarchiques](FormObjects/listbox_overview.md#hierarchical-list-boxes) : Cet événement est généré lorsqu'une ligne de la list box hiérarchique est étendue. ### Voir également diff --git a/website/translated_docs/fr/Events/onFooterClick.md b/website/translated_docs/fr/Events/onFooterClick.md index a863e202ae7644..0b6e213d40d4c6 100644 --- a/website/translated_docs/fr/Events/onFooterClick.md +++ b/website/translated_docs/fr/Events/onFooterClick.md @@ -3,13 +3,13 @@ id: onFooterClick title: Sur clic pied --- -| Code | Peut être appelé par | Définition | -| ---- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | -| 57 | [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) | A click occurs in the footer of a list box column | +| Code | Peut être appelé par | Définition | +| ---- | --------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | +| 57 | [List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) | Un clic se produit dans le pied de page d'une colonne de list box | ## Description -This event is available for a list box or list box column object. It is generated when a click occurs in the footer of a list box column. In this context, the `OBJECT Get pointer` command returns a pointer to the variable of the footer that is clicked. The event is generated for both left and right clicks. +Cet événement est disponible pour un objet list box ou colonne de list box. Il est généré lorsqu'un clic se produit dans le pied de page d'une colonne de list box. Dans ce contexte, la commande `OBJECT Get pointer` retourne un pointeur vers la variable du pied de page sur lequel l'utilisateur a cliqué. L'événement est généré pour les clics gauche et droit. -You can test the number of clicks made by the user by means of the `Clickcount` command. +Vous pouvez tester le nombre de clics effectués par l'utilisateur à l'aide de la commande `Clickcount`. diff --git a/website/translated_docs/fr/Events/onGettingFocus.md b/website/translated_docs/fr/Events/onGettingFocus.md index e49076ae6335cc..ed4c6ebc019146 100644 --- a/website/translated_docs/fr/Events/onGettingFocus.md +++ b/website/translated_docs/fr/Events/onGettingFocus.md @@ -3,13 +3,13 @@ id: onGettingFocus title: On getting focus --- -| Code | Peut être appelé par | Définition | -| ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | -| 15 | [4D View Pro Area](FormObjects/viewProArea_overview.md) - [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Stepper](FormObjects/stepper.md) - [Subform](FormObjects/subform_overview.md) - [Web area](FormObjects/webArea_overview.md) | A form object is getting the focus | +| Code | Peut être appelé par | Définition | +| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- | +| 15 | [Zone 4D View Pro](FormObjects/viewProArea_overview.md) - [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - Formulaire - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) - [Zone de Plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton Radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Stepper](FormObjects/stepper.md) - [Sous-formulaire](FormObjects/subform_overview.md) - [Zone Web](FormObjects/webArea_overview.md) | Un objet formulaire reçoit le focus | ## Description -The `On Getting Focus` event, along with the [`On losing Focus`](onLosingFocus.md) event, are used to detect and handle the change of focus for [focusable](FormObjects/properties_Entry.md#focusable) objects. +Les événements `On Getting Focus` et [`On loss Focus`](onLosingFocus.md) permettent de détecter et de gérer le changement de focus pour les objets [focalisables](FormObjects/properties_Entry.md#focusable). -With [subform objects](FormObjects/subform_overview.md), this event is generated in the method of the subform object when they it is checked. It is sent to the form method of the subform, which means, for example, that you can manage the display of navigation buttons in the subform according to the focus. Note that subform objects can themselves have the focus. +Avec les [objets sous-formulaire](FormObjects/subform_overview.md), cet événement est généré dans la méthode de l'objet sous-formulaire lorsqu'il est vérifié. Il est envoyé à la méthode formulaire du sous-formulaire, ce qui signifie, par exemple, que vous pouvez gérer l'affichage des boutons de navigation dans le sous-formulaire en fonction du focus. A noter que les objets de sous-formulaire peuvent eux-mêmes avoir le focus. diff --git a/website/translated_docs/fr/Events/onHeader.md b/website/translated_docs/fr/Events/onHeader.md index 3ad80eaab9ce72..ea51720d5605af 100644 --- a/website/translated_docs/fr/Events/onHeader.md +++ b/website/translated_docs/fr/Events/onHeader.md @@ -3,23 +3,23 @@ id: onHeader title: Sur entête --- -| Code | Peut être appelé par | Définition | -| ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | -| 5 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form (list form only) - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | The form's header area is about to be printed or displayed. | +| Code | Peut être appelé par | Définition | +| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | +| 5 | [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) -Formulaire (formulaire liste uniquement) - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) -[Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Onglet](FormObjects/tabControl.md) | La zone d'en-tête du formulaire est sur le point d'être imprimée ou affichée. | ## Description -The `On Header` event is called when a record is about to be displayed in a list form displayed via `DISPLAY SELECTION` and `MODIFY SELECTION`. +L'événement `On Header` est appelé lorsqu'un enregistrement est sur le point d'être affiché dans un formulaire liste affiché via `DISPLAY SELECTION` et `MODIFY SELECTION`. -> This event cannot be selected for project forms, it is only available with **table forms**. +> Cet événement ne peut pas être sélectionné pour les formulaires projet, il est uniquement disponible avec les **formulaires table**. -In this context, the following sequence of calls to methods and form events is triggered: +Dans ce contexte, la séquence d'appels de méthodes et d'événements de formulaire suivante est déclenchée : -- For each object in the header area: - - Object method with `On Header` event - - Form method with `On Header` event +- Pour chaque objet de la zone d'en-tête : + - Méthode objet avec l'événement `On Header` + - Méthode formulaire avec l'événement `On Header` -> Printed records are handled using the [`On Display Detail`](onDisplayDetail.md) event. +> Les enregistrements imprimés sont gérés à l'aide de l'événement [`On Display Detail`](onDisplayDetail.md). -Calling a 4D command that displays a dialog box from the `On Header` event is not allowed and will cause a syntax error to occur. More particularly, the commands concerned are: `ALERT`, `DIALOG`, `CONFIRM`, `Request`, `ADD RECORD`, `MODIFY RECORD`, `DISPLAY SELECTION`, and `MODIFY SELECTION`. \ No newline at end of file +L'appel d'une commande 4D qui affiche une boîte de dialogue à partir de l'événement `On Header` n'est pas autorisé et générera une erreur de syntaxe. Plus particulièrement, les commandes concernées sont : `ALERT`, `DIALOG`, `CONFIRM`, `Request`, `ADD RECORD`, `MODIFY RECORD`, `DISPLAY SELECTION`, et `MODIFY SELECTION`. \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onHeaderClick.md b/website/translated_docs/fr/Events/onHeaderClick.md index e0b5002b0e9af5..c35c60052a50de 100644 --- a/website/translated_docs/fr/Events/onHeaderClick.md +++ b/website/translated_docs/fr/Events/onHeaderClick.md @@ -3,36 +3,36 @@ id: onHeaderClick title: Sur clic entête --- -| Code | Peut être appelé par | Définition | -| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -| 42 | [4D View Pro Area](FormObjects/viewProArea_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) | A click occurs in a column header | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | +| 42 | [Zone 4D View Pro](FormObjects/viewProArea_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) | Un clic se produit dans un en-tête de colonne | ## Description ### List Box -This event is generated when a click occurs on the header of a column in the list box. In this case, the `Self` command lets you find out the header of the column that was clicked. +Cet événement est généré lorsqu'un clic se produit sur l'en-tête d'une colonne de list box. Dans ce cas, la commande `Self` vous permet d'identifier l'en-tête de la colonne sur laquelle vous avez cliqué. -If the [Sortable](FormObjects/properties_Action.md#sortable) property was selected for the list box, you can decide whether or not to authorize a standard sort of the column by passing the value 0 or -1 in the `$0` variable: +Si la propriété [Sortable](FormObjects/properties_Action.md#sortable) a été sélectionnée pour la list box, vous pouvez décider d'autoriser ou non un tri standard de la colonne en passant la valeur 0 ou -1 dans la variable `$0` : -- If `$0` equals 0, a standard sort is performed. -- If `$0` equals -1, a standard sort is not performed and the header does not display the sort arrow. The developer can still generate a column sort based on customized sort criteria using the 4D language. +- Si `$0` est égal à 0, un tri standard est effectué. +- Si `$0` est égal à -1, un tri standard n'est pas effectué et l'en-tête n'affiche pas la flèche de tri. Le développeur peut toujours générer un tri de colonne basé sur des critères de tri personnalisés à l'aide du langage 4D. -If the [Sortable](FormObjects/properties_Action.md#sortable) property is not selected for the list box, the `$0` variable is not used. +Si la propriété [Sortable](FormObjects/properties_Action.md#sortable) n'est pas sélectionnée pour la list box, la variable `$0` n'est pas utilisée. ### 4D View Pro -This event is generated when the user clicks on a column or row header in a 4D View Pro document. In this context, the [event object](overview.md#event-object) returned by the `FORM Event` command contains: +Cet événement est généré lorsque l'utilisateur clique sur un en-tête de colonne ou de ligne dans un document 4D View Pro. Dans ce contexte, l'[objet événement](overview.md#event-object) retourné par la commande `FORM Event` contient : -| Propriété | Type | Description | -| ----------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------- | -| code | entier long | 42 | -| description | Texte | "On Header Click" | -| objectName | Texte | 4D View Pro area name | -| sheetName | Texte | Name of the sheet of the event | -| range | object | Cell range | -| sheetArea | entier long | The sheet location where the event took place:
  • 0: The crossing area between column number/letter headers (top left of the sheet)
  • 1: The column headers (area indicating the column numbers/letters)
  • 2: The row headers (area indicating the row numbers)
    • | +| Propriété | Type | Description | +| ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------- | +| code | entier long | 42 | +| description | Texte | "On Header Click" | +| objectName | Texte | 4D View Pro area name | +| sheetName | Texte | Name of the sheet of the event | +| range | object | Cell range | +| sheetArea | entier long | L'emplacement de la feuille où l'événement a eu lieu :
  • 0 : la zone de croisement entre le numéro de colonne/les en-têtes de lettre (en haut à gauche de la feuille)
  • 1 : les en-têtes de colonne (zone indiquant les numéros/lettres de colonnes)
  • 2 : les en-têtes de ligne (zone indiquant les numéros de ligne)
    • | #### Exemple diff --git a/website/translated_docs/fr/Events/onLoad.md b/website/translated_docs/fr/Events/onLoad.md index c9fe3362c0522f..27cd62cb9f05bc 100644 --- a/website/translated_docs/fr/Events/onLoad.md +++ b/website/translated_docs/fr/Events/onLoad.md @@ -3,23 +3,23 @@ id: onLoad title: On Load --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | -| 1 | [4D View Pro Area](FormObjects/viewProArea_overview.md) - [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Subform](FormObjects/subform_overview.md) - [Tab control](FormObjects/tabControl.md) - [Web Area](FormObjects/webArea_overview.md) | The form is about to be displayed or printed | +| Code | Peut être appelé par | Définition | +| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | +| 1 | [Zone 4D View Pro](FormObjects/viewProArea_overview.md) - [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) - Formulaire - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) -[List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) -[Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Sous-formulaire](FormObjects/subform_overview.md) - [Onglet](FormObjects/tabControl.md) - [Zone Web](FormObjects/webArea_overview.md) | Le formulaire est sur le point d'être affiché ou imprimé | ## Description -This event is triggered when the form is being loaded or printed. +Cet événement est déclenché lorsque le formulaire est en cours de chargement ou d'impression. -All the objects of the form (from any page) whose `On Load` object event property is selected will have their object method called. Then, if the `On Load` form event property is selected, the form will have its form method called. +Tous les objets du formulaire (de n'importe quelle page) dont la propriété d'événement `On Load` est sélectionnée verront leur méthode objet appelée. Ensuite, si la propriété d'événement formulaire `On Load` est sélectionnée, la méthode formulaire sera appelée. -> The `On Load` and [`On Unload`](onUnload.md) events are generated for objects if they are enabled for both the objects and the form to which the objects belong. If the events are enabled for objects only, they will not occur; these two events must also be enabled at the form level. +> Les événements `On Load` et [`On Unload`](onUnload.md) sont générés pour les objets s'ils sont activés à la fois pour les objets et pour le formulaire auquel appartiennent les objets. Si les événements sont activés pour les objets uniquement, ils ne se produiront pas; ces deux événements doivent également être activés au niveau du formulaire. ### Sous-formulaire -The `On Load` event is generated when opening the subform (this event must also have been activated at the parent form level in order to be taken into account). The event is generated before those of the parent form. Also note that, in accordance with the operating principles of form events, if the subform is placed on a page other than page 0 or 1, this event will only be generated when that page is displayed (and not when the form is displayed). +L'événement `On Load` est généré à l'ouverture du sous-formulaire (cet événement doit également avoir été activé au niveau du formulaire parent pour être pris en compte). L'événement est généré avant ceux du formulaire parent. A noter également que, conformément aux principes de fonctionnement des événements de formulaire, si le sous-formulaire est placé sur une page autre que la page 0 ou 1, cet événement ne sera généré que lorsque cette page sera affichée (et non lorsque le formulaire sera affiché). ### Voir également diff --git a/website/translated_docs/fr/Events/onLoadRecord.md b/website/translated_docs/fr/Events/onLoadRecord.md index d3ecfc68df0f86..a954b0768751a0 100644 --- a/website/translated_docs/fr/Events/onLoadRecord.md +++ b/website/translated_docs/fr/Events/onLoadRecord.md @@ -3,16 +3,16 @@ id: onLoadRecord title: Sur chargement ligne --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------- | ------------------------------------------------------------------- | -| 40 | Formulaire | During user entry in list, a record is loaded and a field is edited | +| Code | Peut être appelé par | Définition | +| ---- | -------------------- | ---------------------------------------------------------------------------------------------------- | +| 40 | Formulaire | Lors de la saisie de l'utilisateur dans la liste, un enregistrement est chargé et un champ est édité | ## Description -The `On Load Record` event can only be used in the context of an **output form**. It is triggered during data entry in list, after a record is highlighted and a field changes to editing mode. +L'événement `On Load Record` ne peut être utilisé que dans le contexte d'un **formulaire de sortie**. Il est déclenché lors de la saisie des données dans la liste, après la mise en surbrillance d'un enregistrement et le passage d'un champ en mode d'édition. -> This event cannot be selected for project forms, it is only available with **table forms**. +> Cet événement ne peut pas être sélectionné pour les formulaires projet, il est uniquement disponible avec les **formulaires table**. diff --git a/website/translated_docs/fr/Events/onLongClick.md b/website/translated_docs/fr/Events/onLongClick.md index 24fa5a4818db50..d9d226c552b4cc 100644 --- a/website/translated_docs/fr/Events/onLongClick.md +++ b/website/translated_docs/fr/Events/onLongClick.md @@ -3,16 +3,16 @@ id: onLongClick title: Sur clic long --- -| Code | Peut être appelé par | Définition | -| ---- | ---------------------------------------- | ------------------------------------------------------------------------------------ | -| 39 | [Bouton](FormObjects/button_overview.md) | A button is clicked and the mouse button remains pushed for a certain length of time | +| Code | Peut être appelé par | Définition | +| ---- | ---------------------------------------- | ------------------------------------------------------------------------------------- | +| 39 | [Bouton](FormObjects/button_overview.md) | Un bouton est cliqué et le bouton de la souris reste enfoncé pendant un certain temps | ## Description -This event is generated when a button receives a click and the mouse button is held for a certain length of time. In theory, the length of time for which this event is generated is equal to the maximum length of time separating a double-click, as defined in the system preferences. +Cet événement est généré lorsqu'un bouton reçoit un clic et que le bouton de la souris est maintenu pendant un certain temps. En théorie, la durée de génération de cet événement est égale à la durée maximale séparant un double-clic, telle que définie dans les préférences système. -This event can be generated for the following button styles: +Cet événement peut être généré pour les styles de boutons suivants : - [Barre d’outils](FormObjects/button_overview.md#toolbar) - [Bevel](FormObjects/button_overview.md#bevel) @@ -24,7 +24,7 @@ This event can be generated for the following button styles: - [Rond](FormObjects/button_overview.md#circle) - [Personnalisé](FormObjects/button_overview.md#custom) -This event is generally used to display pop-up menus in case of long button clicks. The [`On Clicked`](onClicked.md) event, if enabled, is generated if the user releases the mouse button before the "long click" time limit. +Cet événement est généralement utilisé pour afficher des pop-up menus en cas de longs clics sur les boutons. Si l'événement [`On Clicked`](onClicked.md) est activé, il est généré si l'utilisateur relâche le bouton de la souris avant la limite de temps du "long clic". ### Voir également [`Sur clic alternatif`](onAlternativeClick.md) \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onLosingFocus.md b/website/translated_docs/fr/Events/onLosingFocus.md index 9d94b10ab7f84d..15e9b2c01577cf 100644 --- a/website/translated_docs/fr/Events/onLosingFocus.md +++ b/website/translated_docs/fr/Events/onLosingFocus.md @@ -3,13 +3,13 @@ id: onLosingFocus title: Sur perte focus --- -| Code | Peut être appelé par | Définition | -| ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -| 14 | [4D View Pro Area](FormObjects/viewProArea_overview.md) - [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Stepper](FormObjects/stepper.md) - [Subform](FormObjects/subform_overview.md) - [Web area](FormObjects/webArea_overview.md) | A form object is losing the focus | +| Code | Peut être appelé par | Définition | +| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | +| 14 | [Zone 4D View Pro](FormObjects/viewProArea_overview.md) - [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - Formulaire - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) - [Zone de Plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton Radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Stepper](FormObjects/stepper.md) - [Sous-formulaire](FormObjects/subform_overview.md) - [Zone Web](FormObjects/webArea_overview.md) | Un objet formulaire perd le focus | ## Description -The `On Losing Focus` event, along with the [`On Getting Focus`](onGettingFocus.md) event, are used to detect and handle the change of focus for [focusable](FormObjects/properties_Entry.md#focusable) objects. +Les événements `On Losing Focus` et [`On Getting Focus`](onGettingFocus.md) permettent de détecter et de gérer le changement de focus pour les objets [focalisables](FormObjects/properties_Entry.md#focusable). -With [subform objects](FormObjects/subform_overview.md), this event is generated in the method of the subform object when they it is checked. It is sent to the form method of the subform, which means, for example, that you can manage the display of navigation buttons in the subform according to the focus. Note that subform objects can themselves have the focus. +Avec les [objets sous-formulaire](FormObjects/subform_overview.md), cet événement est généré dans la méthode de l'objet sous-formulaire lorsqu'il est vérifié. Il est envoyé à la méthode formulaire du sous-formulaire, ce qui signifie, par exemple, que vous pouvez gérer l'affichage des boutons de navigation dans le sous-formulaire en fonction du focus. A noter que les objets de sous-formulaire peuvent eux-mêmes avoir le focus. diff --git a/website/translated_docs/fr/Events/onMenuSelected.md b/website/translated_docs/fr/Events/onMenuSelected.md index 608e0183031cf5..5ef19858af1390 100644 --- a/website/translated_docs/fr/Events/onMenuSelected.md +++ b/website/translated_docs/fr/Events/onMenuSelected.md @@ -3,13 +3,13 @@ id: onMenuSelected title: Sur menu sélectionné --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------- | ------------------------------------------------------ | -| 18 | Formulaire | A menu item has been chosen in the associated menu bar | +| Code | Peut être appelé par | Définition | +| ---- | -------------------- | -------------------------------------------------------------- | +| 18 | Formulaire | Un élément de menu a été choisi dans la barre de menu associée | ## Description -The `On Menu Selected` event is sent to the form method when a command of a menu bar associated to the form is selected. You can then call the `Menu selected` language command to test the selected menu. +L'événement `On Menu Selected` est envoyé à la méthode formulaire lorsqu'une commande d'une barre de menus associée au formulaire est sélectionnée. Vous pouvez ensuite appeler la commande `Menu selected` pour tester le menu sélectionné. -> You can associate a menu bar with a form in the Form properties. The menus on a form menu bar are appended to the current menu bar when the form is displayed as an output form in the Application environment. +> Vous pouvez associer une barre de menus à un formulaire dans les propriétés du formulaire. Les menus d'une barre de menus formulaire sont ajoutés à la barre de menus courante lorsque le formulaire est affiché en tant que formulaire de sortie dans l'environnement Application. diff --git a/website/translated_docs/fr/Events/onMouseEnter.md b/website/translated_docs/fr/Events/onMouseEnter.md index db70c0143d1251..9cf23bf12f3df5 100644 --- a/website/translated_docs/fr/Events/onMouseEnter.md +++ b/website/translated_docs/fr/Events/onMouseEnter.md @@ -3,23 +3,23 @@ id: onMouseEnter title: Sur début survol --- -| Code | Peut être appelé par | Définition | -| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | -| 35 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | The mouse cursor enters the graphic area of an object | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | +| 35 | [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) -Formulaire - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) -[Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Onglet](FormObjects/tabControl.md) | Le curseur de la souris entre dans la zone graphique d'un objet | ## Description -This event is generated once, when the mouse cursor enters the graphic area of a form object. +Cet événement est généré une fois, lorsque le curseur de la souris entre dans la zone graphique d'un objet du formulaire. -The `On Mouse Enter` event updates the *MouseX* and *MouseY* system variables. +L'événement `On Mouse Enter` met à jour les variables système *MouseX* et *MouseY*. -Objects that are made invisible using the `OBJECT SET VISIBLE` command or the [Visibility](FormObjects/properties_Display.md#visibility) property do not generate this event. +Les objets rendus invisibles à l'aide de la commande `OBJECT SET VISIBLE` ou de la propriété [Visibility](FormObjects/properties_Display.md#visibility) ne génèrent pas cet événement. -### Calling stack +### Appeler la pile -If the `On Mouse Enter` event has been checked for the form, it is generated for each form object. If it is checked for an object, it is generated only for that object. When there are superimposed objects, the event is generated by the first object capable of managing it that is found going in order from top level to bottom. +Si l'événement `On Mouse Enter` a été coché pour le formulaire, il est généré pour chaque objet de formulaire. S'il est vérifié pour un objet, il n'est généré que pour cet objet. Lorsqu'il existe des objets superposés, l'événement est généré par le premier objet capable de le gérer qui se trouve en allant de haut en bas. ### Voir également diff --git a/website/translated_docs/fr/Events/onMouseLeave.md b/website/translated_docs/fr/Events/onMouseLeave.md index da9471aae28032..e17ae116485795 100644 --- a/website/translated_docs/fr/Events/onMouseLeave.md +++ b/website/translated_docs/fr/Events/onMouseLeave.md @@ -3,23 +3,23 @@ id: onMouseLeave title: Sur fin survol --- -| Code | Peut être appelé par | Définition | -| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | -| 36 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | The mouse cursor leaves the graphic area of an object | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | +| 36 | [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) -Formulaire - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) -[Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Onglet](FormObjects/tabControl.md) | Le curseur de la souris quitte la zone graphique d'un objet | ## Description -This event is generated once when the mouse cursor leaves the graphic area of an object. +Cet événement est généré une fois, lorsque le curseur de la souris quitte la zone graphique d'un objet. -The `On Mouse Leave` event updates the *MouseX* and *MouseY* system variables. +L'événement `On Mouse Leave` met à jour les variables système *MouseX* et *MouseY*. -Objects that are made invisible using the `OBJECT SET VISIBLE` command or the [Visibility](FormObjects/properties_Display.md#visibility) property do not generate this event. +Les objets rendus invisibles à l'aide de la commande `OBJECT SET VISIBLE` ou de la propriété [Visibility](FormObjects/properties_Display.md#visibility) ne génèrent pas cet événement. -### Calling stack +### Appeler la pile -If the `On Mouse Leave` event has been checked for the form, it is generated for each form object. If it is checked for an object, it is generated only for that object. When there are superimposed objects, the event is generated by the first object capable of managing it that is found going in order from top level to bottom. +Si l'événement `On Mouse Leave` a été coché pour le formulaire, il est généré pour chaque objet de formulaire. S'il est vérifié pour un objet, il n'est généré que pour cet objet. Lorsqu'il existe des objets superposés, l'événement est généré par le premier objet capable de le gérer qui se trouve en allant de haut en bas. ### Voir également diff --git a/website/translated_docs/fr/Events/onMouseMove.md b/website/translated_docs/fr/Events/onMouseMove.md index 6a59622485b6b4..76055faebd5725 100644 --- a/website/translated_docs/fr/Events/onMouseMove.md +++ b/website/translated_docs/fr/Events/onMouseMove.md @@ -3,28 +3,28 @@ id: onMouseMove title: Sur survol --- -| Code | Peut être appelé par | Définition | -| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -| 37 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | The mouse cursor moves at least one pixel OR a modifier key (Shift, Alt/Option, Shift Lock) was pressed | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | +| 37 | [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) -Formulaire - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) -[Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Onglet](FormObjects/tabControl.md) | Le curseur de la souris se déplace d'au moins un pixel OU une touche de modification (Shift, Alt/Option, Shift Lock) a été pressée | ## Description -This event is generated: +Cet événement est généré : -- when the mouse cursor moves at least one pixel -- OR when a modifier key (**Shift**, **Alt/Option**, **Shift Lock**) was pressed. This makes it possible to manage copy- or move-type drag-and-drop operations. +- lorsque le curseur de la souris se déplace d'au moins un pixel +- OU lorsque l'on presse sur une touche de modification (**Ctrl**, **Alt/Option**, **Verr Maj**). Cela permet de gérer les opérations de glisser-déposer de type copier ou déplacer. -If the event is checked for an object only, it is generated only when the cursor is within the graphic area of the object. +Si l'événement est coché pour un objet uniquement, il est généré uniquement lorsque le curseur se trouve dans la zone graphique de l'objet. -The `On Mouse Move` event updates the *MouseX* and *MouseY* system variables. +L'événement `On Mouse Move` met à jour les variables système *MouseX* et *MouseY*. -Objects that are made invisible using the `OBJECT SET VISIBLE` command or the [Visibility](FormObjects/properties_Display.md#visibility) property do not generate this event. +Les objets rendus invisibles à l'aide de la commande `OBJECT SET VISIBLE` ou de la propriété [Visibility](FormObjects/properties_Display.md#visibility) ne génèrent pas cet événement. -### Calling stack +### Appeler la pile -If the `On Mouse Move` event has been checked for the form, it is generated for each form object. If it is checked for an object, it is generated only for that object. When there are superimposed objects, the event is generated by the first object capable of managing it that is found going in order from top level to bottom. +Si l'événement `On Mouse Move` a été coché pour le formulaire, il est généré pour chaque objet de formulaire. S'il est vérifié pour un objet, il n'est généré que pour cet objet. Lorsqu'il existe des objets superposés, l'événement est généré par le premier objet capable de le gérer qui se trouve en allant de haut en bas. ### Voir également diff --git a/website/translated_docs/fr/Events/onMouseUp.md b/website/translated_docs/fr/Events/onMouseUp.md index 76761dd253b56b..f536c3cbbe265e 100644 --- a/website/translated_docs/fr/Events/onMouseUp.md +++ b/website/translated_docs/fr/Events/onMouseUp.md @@ -3,17 +3,17 @@ id: onMouseUp title: On Mouse Up --- -| Code | Peut être appelé par | Définition | -| ---- | ----------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | -| 2 | [Input](FormObjects/input_overview.md) of the `picture` [Type](FormObjects/properties_Object.md#type) | The user has just released the left mouse button in a Picture object | +| Code | Peut être appelé par | Définition | +| ---- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | +| 2 | [Zone de saisie](FormObjects/input_overview.md) de [type](FormObjects/properties_Object.md#type) `image` | L'utilisateur vient de relâcher le bouton gauche de la souris dans un objet Image | ## Description -The `On Mouse Up` event is generated when the user has just released the left mouse button while dragging in a picture input. This event is useful, for example, when you want the user to be able to move, resize or draw objects in a SVG area. +L'événement `On Mouse Up` est généré lorsque l'utilisateur vient de relâcher le bouton gauche de la souris tout en faisant glisser une image. Cet événement est utile, par exemple, lorsque vous souhaitez que l'utilisateur puisse déplacer, redimensionner ou dessiner des objets dans une zone SVG. -When the `On Mouse Up` event is generated, you can get the local coordinates where the mouse button was released. These coordinates are returned in the `MouseX` and `MouseY` System variables. Les coordonnées sont exprimées en pixels par rapport à l'angle supérieur gauche de l'image (0,0). +Lorsque l'événement `On Mouse Up` est généré, vous pouvez obtenir les coordonnées locales où le bouton de la souris a été relâché. Ces coordonnées sont retournées dans les variables système `MouseX` et `MouseY`. Les coordonnées sont exprimées en pixels par rapport à l'angle supérieur gauche de l'image (0,0). -When using this event, you must also use the `Is waiting mouse up` command to handle cases where the "state manager" of the form is desynchronized, i.e. when the `On Mouse Up` event is not received after a click. This is the case for example when an alert dialog box is displayed above the form while the mouse button has not been released. For more information and an example of use of the `On Mouse Up` event, please refer to the description of the `Is waiting mouse up` command. +Lorsque vous utilisez cet événement, vous devez également utiliser la commande `Is waiting mouse up` pour gérer les cas où le "gestionnaire d'état" du formulaire est désynchronisé, c'est-à-dire lorsque l'événement `On Mouse Up` n'est pas reçu après un clic. C'est le cas par exemple lorsqu'une boîte de dialogue d'alerte s'affiche au-dessus du formulaire alors que le bouton de la souris n'a pas été relâché. Pour plus d'informations et pour voir un exemple d'utilisation de l'événement `On Mouse Up`, veuillez vous référer à la description de la commande `Is waiting mouse up`. -> If the [Draggable](FormObjects/properties_Action.md#draggable) option is enabled for the picture object, the `On Mouse Up` event is never generated. +> Si l'option [Draggable](FormObjects/properties_Action.md#draggable) est activée pour l'objet image, l'événement `On Mouse Up` n'est jamais généré. diff --git a/website/translated_docs/fr/Events/onOpenDetail.md b/website/translated_docs/fr/Events/onOpenDetail.md index d45cab7ac8dfad..6b330a6fa74671 100644 --- a/website/translated_docs/fr/Events/onOpenDetail.md +++ b/website/translated_docs/fr/Events/onOpenDetail.md @@ -3,19 +3,19 @@ id: onOpenDetail title: Sur ouverture corps --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------------------------------------- | ------------------------------------------------------------------------------------------- | -| 25 | Form - [List Box](FormObjects/listbox_overview.md) | The detail form associated with the output form or with the list box is about to be opened. | +| Code | Peut être appelé par | Définition | +| ---- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | +| 25 | Formulaire - [List Box](FormObjects/listbox_overview.md) | Le formulaire détaillé associé au formulaire de sortie ou à la list box est sur le point d'être ouvert. | ## Description -The `On Open Detail` event can be used in the following contexts: +L'événement `On Open Detail` peut être utilisé dans les contextes suivants : -- **Output forms**: A record is about to be displayed in the detail form associated with the output form. This event cannot be selected for project forms, it is only available with **table forms**. -- List box of the [**selection type**](FormObjects/listbox_overview.md#selection-list-boxes): This event is generated when a record is about to be displayed in the detail form associated with a list box of the selection type (and before this form is opened). +- **Formulaires de sortie** : un enregistrement est sur le point d'être affiché dans le formulaire détaillé associé au formulaire de sortie. Cet événement ne peut pas être sélectionné pour les formulaires projet, il est uniquement disponible avec les **formulaires table**. +- List box [**de type sélection**](FormObjects/listbox_overview.md#selection-list-boxes) : Cet événement est généré lorsqu'un enregistrement est sur le point d'être affiché dans le formulaire détaillé associé à une list box de type sélection (et avant l'ouverture de ce formulaire). -### Displayed line number +### Numéro de ligne affiché -The `Displayed line number` 4D command works with the `On Open Detail` form event. It returns the number of the row being processed while a list of records or list box rows is displayed on screen. +La commande 4D `Displayed line number` fonctionne avec l'événement formulaire `On Open Detail`. Elle retourne le numéro de la ligne en cours de traitement tandis qu'une liste d'enregistrements ou de lignes de list box s'affiche à l'écran. diff --git a/website/translated_docs/fr/Events/onOpenExternalLink.md b/website/translated_docs/fr/Events/onOpenExternalLink.md index 474e997aab0c4b..51038d05d820be 100644 --- a/website/translated_docs/fr/Events/onOpenExternalLink.md +++ b/website/translated_docs/fr/Events/onOpenExternalLink.md @@ -3,16 +3,16 @@ id: onOpenExternalLink title: On Open External Link --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------- | ---------------------------------------------- | -| 52 | [Zone Web](FormObjects/webArea_overview.md) | An external URL has been opened in the browser | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------- | ------------------------------------------------ | +| 52 | [Zone Web](FormObjects/webArea_overview.md) | Une URL externe a été ouverte dans le navigateur | ## Description -This event is generated when the loading of a URL was blocked by the Web area and the URL was opened with the current system browser, because of a filter set up via the `WA SET EXTERNAL LINKS FILTERS` command. +Cet événement est généré lorsque le chargement d'une URL a été bloqué par la zone Web et que l'URL a été ouverte avec le navigateur système actuel, en raison d'un filtre mis en place via la commande `WA SET EXTERNAL LINKS FILTERS`. -You can find out the blocked URL using the `WA Get last filtered URL` command. +Vous pouvez identifier l'URL bloquée à l'aide de la commande `WA Get last filtered URL`. ### Voir également diff --git a/website/translated_docs/fr/Events/onOutsideCall.md b/website/translated_docs/fr/Events/onOutsideCall.md index f759867393d437..6db93be5657597 100644 --- a/website/translated_docs/fr/Events/onOutsideCall.md +++ b/website/translated_docs/fr/Events/onOutsideCall.md @@ -3,14 +3,14 @@ id: onOutsideCall title: Sur appel extérieur --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------- | -------------------------------------------- | -| 10 | Formulaire | The form received a `POST OUTSIDE CALL` call | +| Code | Peut être appelé par | Définition | +| ---- | -------------------- | ------------------------------------------------- | +| 10 | Formulaire | Le formulaire a reçu un appel `POST OUTSIDE CALL` | ## Description -This event is called when the form is called from another process through the `POST OUTSIDE CALL` command. +Cet événement est appelé lorsque le formulaire est appelé à partir d'un autre processus via la commande `POST OUTSIDE CALL`. -> The `On Outside Call` event modifies the entry context of the receiving input form. In particular, if a field was being edited, the [`On Data Change`](onDataChange.md) event is generated. +> L'événement `On Outside Call` modifie le contexte de saisie du formulaire. En particulier si un champ était en cours de modification, l'événement [`On Data Change`](onDataChange.md) est généré. diff --git a/website/translated_docs/fr/Events/onPageChange.md b/website/translated_docs/fr/Events/onPageChange.md index bd7d72a9d83349..ba60fe506c405e 100644 --- a/website/translated_docs/fr/Events/onPageChange.md +++ b/website/translated_docs/fr/Events/onPageChange.md @@ -3,17 +3,17 @@ id: onPageChange title: Sur changement page --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------- | --------------------------------------- | -| 56 | Formulaire | The current page of the form is changed | +| Code | Peut être appelé par | Définition | +| ---- | -------------------- | ------------------------------------------- | +| 56 | Formulaire | La page courante du formulaire est modifiée | ## Description -This event is only available at the form level (it is called in the form method). It is generated each time the current page of the form changes (following a call to the `FORM GOTO PAGE` command or a standard navigation action). +Cet événement n'est disponible qu'au niveau du formulaire (il est appelé dans la méthode formulaire). Il est généré à chaque fois que la page courante du formulaire change (suite à un appel à la commande `FORM GOTO PAGE` ou à une action de navigation standard). -Note that it is generated after the page is fully loaded, i.e. once all the objects it contains are initialized, including [Web areas](FormObjects/webArea_overview.md). +A noter qu'il est généré après le chargement complet de la page, c'est-à-dire une fois tous les objets qu'elle contient sont initialisés, y compris les [zones Web](FormObjects/webArea_overview.md). -> The only exception is 4D View Pro areas, for which you need to call the [On VP Ready](onVpReady.md) specific event. +> La seule exception concerne les zones 4D View Pro, pour lesquelles vous devez appeler l'événement spécifique [On VP Ready](onVpReady.md). -The `On Page Change` event is useful for executing code that requires all objects to be initialized beforehand. You can also use it to optimize the application by executing code (for example, a search) only after a specific page of the form is displayed and not just as soon as page 1 is loaded. If the user does not go to this page, the code is not executed. \ No newline at end of file +L'événement `On Page Change` est utile pour exécuter du code qui nécessite que tous les objets soient préalablement initialisés. Vous pouvez également l'utiliser pour optimiser l'application en exécutant du code (par exemple, une recherche) uniquement après l'affichage d'une page spécifique du formulaire et pas seulement dès que la page 1 est chargée. Si l'utilisateur ne va pas sur cette page, le code n'est pas exécuté. \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onPlugInArea.md b/website/translated_docs/fr/Events/onPlugInArea.md index 202d90d00e27b5..fa7b2fa72d45d3 100644 --- a/website/translated_docs/fr/Events/onPlugInArea.md +++ b/website/translated_docs/fr/Events/onPlugInArea.md @@ -3,11 +3,11 @@ id: onPlugInArea title: Sur appel zone du plug in --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------------------------------ | ------------------------------------------------------------- | -| 19 | Form - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) | An external object requested its object method to be executed | +| Code | Peut être appelé par | Définition | +| ---- | --------------------------------------------------------------------------- | ------------------------------------------------------------- | +| 19 | Formulaire - [Zone de Plug-in](FormObjects/pluginArea_overview.md#overview) | Un objet externe a demandé que sa méthode objet soit exécutée | ## Description -The event is generated when a plug-in requested its form area to execute the associated object method. \ No newline at end of file +L'événement est généré lorsqu'un plug-in a demandé à sa zone de formulaire d'exécuter la méthode objet associée. \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onPrintingBreak.md b/website/translated_docs/fr/Events/onPrintingBreak.md index 879ba3117ec355..0c7f8dfca8afed 100644 --- a/website/translated_docs/fr/Events/onPrintingBreak.md +++ b/website/translated_docs/fr/Events/onPrintingBreak.md @@ -3,18 +3,18 @@ id: onPrintingBreak title: On Printing Break --- -| Code | Peut être appelé par | Définition | -| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | -| 6 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md) - [Input](FormObjects/input_overview.md) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | One of the form’s break areas is about to be printed | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- | +| 6 | [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) -Formulaire - [Liste hiérarchique](FormObjects/list_overview.md) - [Zone de saisie](FormObjects/input_overview.md) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) -[Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Onglet](FormObjects/tabControl.md) | L’une des zones de rupture du formulaire est sur le point d’être imprimée | ## Description -The `On Printing Break` event can only be used in the context of an **output form**. It is triggered each time a break area in the output form is about to be printed, so that you can evaluate the break values, for example. +L'événement `On Printing Break` ne peut être utilisé que dans le contexte d'un **formulaire de sortie**. Il est déclenché chaque fois qu'une zone de rupture du formulaire de sortie est sur le point d'être imprimée, afin que vous puissiez évaluer les valeurs de rupture, par exemple. -This event usually follows a call to the `Subtotal` command. +Cet événement fait généralement suite à un appel à la commande `Subtotal`. -> This event cannot be selected for project forms, it is only available with **table forms**. +> Cet événement ne peut pas être sélectionné pour les formulaires projet, il est uniquement disponible avec les **formulaires table**. diff --git a/website/translated_docs/fr/Events/onPrintingDetail.md b/website/translated_docs/fr/Events/onPrintingDetail.md index e04039919ee5bf..f6c7cb040a3947 100644 --- a/website/translated_docs/fr/Events/onPrintingDetail.md +++ b/website/translated_docs/fr/Events/onPrintingDetail.md @@ -3,16 +3,16 @@ id: onPrintingDetail title: On Printing Detail --- -| Code | Peut être appelé par | Définition | -| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | -| 23 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md) - [Input](FormObjects/input_overview.md) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | The form’s detail area is about to be printed | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- | +| 23 | [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) -Formulaire - [Liste hiérarchique](FormObjects/list_overview.md) - [Zone de saisie](FormObjects/input_overview.md) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) -[Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Onglet](FormObjects/tabControl.md) | La zone détaillée du formulaire est sur le point d’être imprimée | ## Description -The `On Printing Detail` event can only be used in the context of an **output form**. It is triggered when the detail area the output form is about to be printed, for example following a call to the `Print form` command. +L'événement `On Printing Detail` ne peut être utilisé que dans le contexte d'un **formulaire de sortie**. Il est déclenché lorsque la zone de détail du formulaire de sortie est sur le point d'être imprimée, par exemple suite à un appel à la commande `Print form`. -The `Print form` command generates only one `On Printing Detail` event for the form method. +La commande `Print form` génère un seul événement `On Printing Detail` pour la méthode formulaire. -> This event cannot be selected for project forms, it is only available with **table forms**. +> Cet événement ne peut pas être sélectionné pour les formulaires projet, il est uniquement disponible avec les **formulaires table**. diff --git a/website/translated_docs/fr/Events/onPrintingFooter.md b/website/translated_docs/fr/Events/onPrintingFooter.md index ed66a547593634..f4612539011510 100644 --- a/website/translated_docs/fr/Events/onPrintingFooter.md +++ b/website/translated_docs/fr/Events/onPrintingFooter.md @@ -3,16 +3,16 @@ id: onPrintingFooter title: On Printing Footer --- -| Code | Peut être appelé par | Définition | -| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | -| 7 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md) - [Input](FormObjects/input_overview.md) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Tab control](FormObjects/tabControl.md) | The form’s footer area is about to be printed | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------- | +| 7 | [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) -Formulaire - [Liste hiérarchique](FormObjects/list_overview.md) - [Zone de saisie](FormObjects/input_overview.md) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) -[Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Onglet](FormObjects/tabControl.md) | La zone de pied du formulaire est sur le point d’être imprimée | ## Description -The `On Printing Footer` event can only be used in the context of an **output form**. It is triggered when the footer area the output form is about to be printed, so that you can evaluate the footer values. +L'événement `On Printing Footer` ne peut être utilisé que dans le contexte d'un **formulaire de sortie**. Il est déclenché lorsqu'une zone de pied du formulaire de sortie est sur le point d'être imprimée, afin que vous puissiez évaluer les valeurs du pied. -This event can be triggered in the context of a `PRINT SELECTION` command. +Cet événement peut être déclenché dans le cadre d'une commande `PRINT SELECTION`. -> This event cannot be selected for project forms, it is only available with **table forms**. +> Cet événement ne peut pas être sélectionné pour les formulaires projet, il est uniquement disponible avec les **formulaires table**. diff --git a/website/translated_docs/fr/Events/onResize.md b/website/translated_docs/fr/Events/onResize.md index 9258900815af35..7067007086fb19 100644 --- a/website/translated_docs/fr/Events/onResize.md +++ b/website/translated_docs/fr/Events/onResize.md @@ -3,14 +3,14 @@ id: onResize title: Sur redimensionnement --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | -| 29 | Formulaire | The form's window is resized or the subform object is resized (in this case the event is generated in the form method of the subform) | +| Code | Peut être appelé par | Définition | +| ---- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 29 | Formulaire | La fenêtre du formulaire est redimensionnée ou l'objet sous-formulaire est redimensionné (dans ce cas, l'événement est généré dans la méthode formulaire du sous-formulaire) | ## Description -This event is called: +Cet événement est appelé : -- when the window of the form is resized, -- in the context of subforms, when the size of the subform object in the parent form has changed. In this this case, this event is sent to the subform form method. +- lorsque la fenêtre du formulaire est redimensionnée, +- dans le contexte de sous-formulaires, lorsque la taille de l'objet de sous-formulaire du formulaire parent a changé. Dans ce cas, cet événement est envoyé à la méthode formulaire du sous-formulaire. diff --git a/website/translated_docs/fr/Events/onRowMoved.md b/website/translated_docs/fr/Events/onRowMoved.md index b73bc7248df3bd..67c98a11397959 100644 --- a/website/translated_docs/fr/Events/onRowMoved.md +++ b/website/translated_docs/fr/Events/onRowMoved.md @@ -3,13 +3,13 @@ id: onRowMoved title: Sur déplacement ligne --- -| Code | Peut être appelé par | Définition | -| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | -| 34 | [List Box of the array type](FormObjects/listbox_overview.md#array-list-boxes) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) | A list box row is moved by the user via drag and drop | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ | +| 34 | [List Box de type tableau](FormObjects/listbox_overview.md#array-list-boxes) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) | Une ligne de list box est déplacée par l'utilisateur par glisser-déposer | ## Description -This event is generated when a row of the list box ([array type only](FormObjects/listbox_overview.md#array-list-boxes)) is moved by the user using drag and drop ([if allowed](FormObjects/properties_Action.md#movable-rows). It is not generated if the row is dragged and then dropped in its initial location. +Cet événement est généré lorsqu'une ligne de list box (de [type tableau uniquement](FormObjects/listbox_overview.md#array-list-boxes)) est déplacée par l'utilisateur à l'aide du glisser-déposer ([si autorisé](FormObjects/properties_Action.md#movable-rows)). Il n'est pas généré si la ligne est glissée puis déposée à son emplacement initial. -The `LISTBOX MOVED ROW NUMBER` command returns the new position of the row. \ No newline at end of file +La commande `LISTBOX MOVED ROW NUMBER` retourne la nouvelle position de la ligne. \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onRowResize.md b/website/translated_docs/fr/Events/onRowResize.md index 197fb0abdd6bab..8e999f874395ef 100644 --- a/website/translated_docs/fr/Events/onRowResize.md +++ b/website/translated_docs/fr/Events/onRowResize.md @@ -3,23 +3,23 @@ id: onRowResize title: On Row Resize --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------------------- | -------------------------------------------------------- | -| 60 | [4D View Pro Area](FormObjects/viewProArea_overview.md) | The height of a row is modified by a user with the mouse | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------- | --------------------------------------------------------------------- | +| 60 | [Zone 4D View Pro](FormObjects/viewProArea_overview.md) | La hauteur d'une ligne est modifiée par un utilisateur avec la souris | ## Description -This event is generated when the height of a row is modified by a user in a 4D View Pro document. In this context, the [event object](overview.md#event-object) returned by the `FORM Event` command contains: +Cet événement est généré lorsque la hauteur d'une ligne est modifiée par un utilisateur dans un document 4D View Pro. Dans ce contexte, l'[objet événement](overview.md#event-object) retourné par la commande `FORM Event` contient : -| Propriété | Type | Description | -| ----------- | ----------- | ---------------------------------------------------------------- | -| code | entier long | 60 | -| description | Texte | "On Row Resize" | -| objectName | Texte | 4D View Pro area name | -| sheetName | Texte | Name of the sheet of the event | -| range | object | Cell range of the rows whose heights have changed | -| header | boolean | True if the column header row (first row) is resized, else false | +| Propriété | Type | Description | +| ----------- | ----------- | ------------------------------------------------------------------------------------------- | +| code | entier long | 60 | +| description | Texte | "On Row Resize" | +| objectName | Texte | 4D View Pro area name | +| sheetName | Texte | Name of the sheet of the event | +| range | object | Plage de cellules des lignes dont les hauteurs ont changé | +| header | boolean | "True" si la ligne de la colonne d'en-tête (première ligne) est redimensionnée, sinon false | #### Exemple diff --git a/website/translated_docs/fr/Events/onScroll.md b/website/translated_docs/fr/Events/onScroll.md index 368213959a1f69..504bc2f59ebbbc 100644 --- a/website/translated_docs/fr/Events/onScroll.md +++ b/website/translated_docs/fr/Events/onScroll.md @@ -3,25 +3,25 @@ id: onScroll title: Sur défilement --- -| Code | Peut être appelé par | Définition | -| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | -| 59 | [Input](FormObjects/input_overview.md) of the `picture` [Type](FormObjects/properties_Object.md#type) - [List Box](FormObjects/listbox_overview.md) | The user scrolls the contents of a picture object or list box using the mouse or keyboard. | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- | +| 59 | [Zone de saisie](FormObjects/input_overview.md) de [type](FormObjects/properties_Object.md#type) `image` - [List Box](FormObjects/listbox_overview.md) | L'utilisateur fait défiler le contenu d'un objet image ou d'une list box à l'aide de la souris ou du clavier. | ## Description -This event can be generated in the context of a picture input or a list box. +Cet événement peut être généré dans le contexte d'une entrée d'image ou d'une list box. -This event is triggered after any other user event related to the scrolling action ([On Clicked](onClicked.md), [On After Keystroke](onAfterKeystroke.md), etc.). The event is only generated in the object method (not in the form method). +Il est déclenché après tout autre événement utilisateur lié à l'action de défilement ([On Clicked](onClicked.md), [On After Keystroke](onAfterKeystroke.md), etc.). L'événement est uniquement généré dans la méthode objet (pas dans la méthode formulaire). -The event is triggered when the scroll is the result of a user action: using the scroll bars and/or cursors, using the mouse wheel or [the keyboard](FormObjects/properties_Appearance.md#vertical-scroll-bar). It is not generated when the object is scrolled due to the execution of the `OBJECT SET SCROLL POSITION` command. +L'événement est déclenché lorsque le défilement est le résultat d'une action de l'utilisateur : à l'aide des barres de défilement et/ou des curseurs, à l'aide de la molette de la souris ou du [clavier](FormObjects/properties_Appearance.md#vertical-scroll-bar). Il n'est pas généré lors du défilement de l'objet en raison de l'exécution de la commande `OBJECT SET SCROLL POSITION`. -### Picture input +### Entrée d'image -The event is generated as soon as a user scrolls a picture within the picture input (field or variable) that contains it. You can scroll the contents of a picture area when the size of the area is smaller than its contents and the [display format](FormObjects/properties_Display.md#picture-format) is "Truncated (non Centered)". +L'événement est généré dès qu'un utilisateur fait défiler une image dans l'entrée d'image (champ ou variable) qui la contient. Vous pouvez faire défiler le contenu d'une zone d'image lorsque la taille de la zone est plus petite que son contenu et que le [format d'affichage](FormObjects/properties_Display.md#picture-format) est "Tronqué (non centré)". ### List box -The event is generated as soon as a user scrolls the rows or columns of the list box. +L'événement est généré dès qu'un utilisateur fait défiler les lignes ou les colonnes de la list box. diff --git a/website/translated_docs/fr/Events/onSelectionChange.md b/website/translated_docs/fr/Events/onSelectionChange.md index d44004a6b1f106..5ae52efab003f2 100644 --- a/website/translated_docs/fr/Events/onSelectionChange.md +++ b/website/translated_docs/fr/Events/onSelectionChange.md @@ -3,27 +3,27 @@ id: onSelectionChange title: Sur nouvelle sélection --- -| Code | Peut être appelé par | Définition | -| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | -| 31 | [4D View Pro area](FormObjects/viewProArea_overview.md) - [4D Write Pro area](FormObjects/writeProArea_overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) | The selection in the object is modified | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | +| 31 | [Zone 4D View Pro](FormObjects/viewProArea_overview.md) - [Zone 4D Write Pro](FormObjects/writeProArea_overview.md) - Formulaire - [Liste hiérarchique](FormObjects/list_overview.md) - [Zone de saisie](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) | La sélection faite dans l'objet est modifiée | ## Description -This event can be generated in different contexts. +Cet événement peut être généré dans différents contextes. ### 4D View Pro -The current selection of rows or columns is modified. In this context, the [event object](overview.md#event-object) returned by the `FORM Event` command contains: +La sélection courante de lignes ou de colonnes est modifiée. Dans ce contexte, l'[objet événement](overview.md#event-object) retourné par la commande `FORM Event` contient : -| Propriété | Type | Description | -| ------------- | ----------- | ------------------------------ | -| code | entier long | 31 | -| description | Texte | "On Selection Change" | -| objectName | Texte | 4D View Pro area name | -| sheetName | Texte | Name of the sheet of the event | -| oldSelections | object | Cell range before change | -| newSelections | object | Cell range after change | +| Propriété | Type | Description | +| ------------- | ----------- | ---------------------------------- | +| code | entier long | 31 | +| description | Texte | "On Selection Change" | +| objectName | Texte | 4D View Pro area name | +| sheetName | Texte | Name of the sheet of the event | +| oldSelections | object | Plage de cellules avant changement | +| newSelections | object | Plage de cellules après changement | #### Exemple @@ -34,21 +34,21 @@ The current selection of rows or columns is modified. In this context, the [even End if ``` -### List form +### Formulaire liste -The current record or the current selection of rows is modified in a list form. +L'enregistrement courant ou la sélection courante de lignes est modifié(e) sous dans un formulaire liste. -### Hierarchical list +### Liste hiérarchique -This event is generated every time the selection in the hierarchical list is modified after a mouse click or keystroke. +Cet événement est généré à chaque fois que la sélection faite dans la liste hiérarchique est modifiée après un clic de souris ou une frappe. -### Input & 4D Write Pro +### Zone de saisie et 4D Write Pro -The text selection or the position of the cursor in the area is modified following a click or a keystroke. +La sélection de texte ou la position du curseur dans la zone est modifiée suite à un clic ou une frappe. ### List box -This event is generated each time the current selection of rows or columns of the list box is modified. +Cet événement est généré chaque fois que la sélection courante de lignes ou de colonnes de la list box est modifiée. diff --git a/website/translated_docs/fr/Events/onTimer.md b/website/translated_docs/fr/Events/onTimer.md index 8f35ec82fc92ef..045f25fee54e5d 100644 --- a/website/translated_docs/fr/Events/onTimer.md +++ b/website/translated_docs/fr/Events/onTimer.md @@ -3,13 +3,13 @@ id: onTimer title: Sur minuteur --- -| Code | Peut être appelé par | Définition | -| ---- | -------------------- | ----------------------------------------------------------------- | -| 27 | Formulaire | The number of ticks defined by the `SET TIMER` command has passed | +| Code | Peut être appelé par | Définition | +| ---- | -------------------- | --------------------------------------------------------------------- | +| 27 | Formulaire | Le nombre de graduations défini par la commande `SET TIMER` est passé | ## Description -This event is generated only if the form method contains a previous call to the `SET TIMER` command. +Cet événement est généré uniquement si la méthode formulaire contient un appel à la commande `SET TIMER` réalisé antérieurement. -When the `On Timer` form event property is selected, only the form method will receive the event, no object method will be called. \ No newline at end of file +Lorsque la propriété d'événement formulaire `On Timer` est sélectionnée, seule la méthode formulaire recevra l'événement, aucune méthode objet ne sera appelée. \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onUnload.md b/website/translated_docs/fr/Events/onUnload.md index 1dfcf112e86609..2cbc764f8d81e5 100644 --- a/website/translated_docs/fr/Events/onUnload.md +++ b/website/translated_docs/fr/Events/onUnload.md @@ -3,24 +3,24 @@ id: onUnload title: On Unload --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- | -| 24 | [4D View Pro Area](FormObjects/viewProArea_overview.md) - [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Subform](FormObjects/subform_overview.md) - [Tab control](FormObjects/tabControl.md) - [Web Area](FormObjects/webArea_overview.md) | The form is about to be exited and released | +| Code | Peut être appelé par | Définition | +| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | +| 24 | [Zone 4D View Pro](FormObjects/viewProArea_overview.md) - [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) - Formulaire - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) -[List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) -[Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Sous-formulaire](FormObjects/subform_overview.md) - [Onglet](FormObjects/tabControl.md) - [Zone Web](FormObjects/webArea_overview.md) | Le formulaire est sur le point d'être quitté et généré | ## Description -This event is triggered when the form is being exited released. +Cet événement est déclenché lorsque le formulaire est généré. -All the objects of the form (from any page) whose `On Unload` object event property is selected will have their object method called. Then, if the `On Unload` form event property is selected, the form will have its form method called. +Tous les objets du formulaire (de n'importe quelle page) dont la propriété d'événement `On Unload` est sélectionnée verront leur méthode objet appelée. Ensuite, si la propriété d'événement formulaire `On Unload` est sélectionnée, la méthode formulaire sera appelée. -> The [`On Load`](onLoad.md) and [`On Unload`] events are generated for objects if they are enabled for both the objects and the form to which the objects belong. If the events are enabled for objects only, they will not occur; these two events must also be enabled at the form level. +> Les événements [`On Load`](onLoad.md) et [`On Unload`] sont générés pour les objets s'ils sont activés à la fois pour les objets et pour le formulaire auquel appartiennent les objets. Si les événements sont activés pour les objets uniquement, ils ne se produiront pas; ces deux événements doivent également être activés au niveau du formulaire. ### Sous-formulaire -The `On Unload` event is generated when the subform is closing (this event must also have been activated at the parent form level in order to be taken into account). The event is generated before those of the parent form. The event is generated before those of the parent form. +L'événement `On Unload` est généré à la fermeture du sous-formulaire (cet événement doit également avoir été activé au niveau du formulaire parent pour être pris en compte). L'événement est généré avant ceux du formulaire parent. The event is generated before those of the parent form. ### Voir également diff --git a/website/translated_docs/fr/Events/onUrlFiltering.md b/website/translated_docs/fr/Events/onUrlFiltering.md index dde9d375bed51d..711b892ff6f838 100644 --- a/website/translated_docs/fr/Events/onUrlFiltering.md +++ b/website/translated_docs/fr/Events/onUrlFiltering.md @@ -3,16 +3,16 @@ id: onUrlFiltering title: On URL Filtering --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------- | --------------------------------- | -| 51 | [Zone Web](FormObjects/webArea_overview.md) | A URL was blocked by the Web area | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------- | ------------------------------------- | +| 51 | [Zone Web](FormObjects/webArea_overview.md) | Une URL a été bloquée par la zone Web | ## Description -This event is generated when the loading of a URL is blocked by the Web area because of a filter set up using the `WA SET URL FILTERS` command. +Cet événement est généré lorsque le chargement d'une URL est bloqué par la zone Web en raison d'un filtre configuré à l'aide de la commande `WA SET URL FILTERS`. -You can find out the blocked URL using the `WA Get last filtered URL` command. +Vous pouvez identifier l'URL bloquée à l'aide de la commande `WA Get last filtered URL`. ### Voir également [`On Open External Link`](onOpenExternalLink.md) \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onUrlLoadingError.md b/website/translated_docs/fr/Events/onUrlLoadingError.md index 73f78df966eeef..2cf1a5f53dc5b9 100644 --- a/website/translated_docs/fr/Events/onUrlLoadingError.md +++ b/website/translated_docs/fr/Events/onUrlLoadingError.md @@ -3,16 +3,16 @@ id: onUrlLoadingError title: On URL Loading Error --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------- | ------------------------------------------ | -| 50 | [Zone Web](FormObjects/webArea_overview.md) | An error occurred when the URL was loading | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------- | ----------------------------------------------------- | +| 50 | [Zone Web](FormObjects/webArea_overview.md) | Une erreur s'est produite lors du chargement de l'URL | ## Description -This event is generated when an error is detected during the loading of a URL. +Cet événement est généré lorsqu'une erreur est détectée lors du chargement d'une URL. -You can call the `WA GET LAST URL ERROR` command in order to get information about the error. +Vous pouvez appeler la commande `WA GET LAST URL ERROR` afin d'obtenir des informations sur l'erreur. ### Voir également diff --git a/website/translated_docs/fr/Events/onUrlResourceLoading.md b/website/translated_docs/fr/Events/onUrlResourceLoading.md index 9724229d7f807c..6eb59c5d1d4bb4 100644 --- a/website/translated_docs/fr/Events/onUrlResourceLoading.md +++ b/website/translated_docs/fr/Events/onUrlResourceLoading.md @@ -3,16 +3,16 @@ id: onUrlResourceLoading title: On URL Resource Loading --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------- | ---------------------------------------- | -| 48 | [Zone Web](FormObjects/webArea_overview.md) | A new resource is loaded in the Web area | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------- | --------------------------------------------------- | +| 48 | [Zone Web](FormObjects/webArea_overview.md) | Une nouvelle ressource est chargée dans la zone Web | ## Description -This event is generated each time a new resource (picture, frame, etc.) is loaded on the current Web page. +Cet événement est généré chaque fois qu'une nouvelle ressource (image, cadre, etc.) est chargée sur la page Web courante. -The [Progression](FormObjects/properties_WebArea.md#progression) variable associated with the area lets you find out the current state of the loading. +La variable [Progression](FormObjects/properties_WebArea.md#progression) associée à la zone vous permet de connaître l'état du chargement. ### Voir également diff --git a/website/translated_docs/fr/Events/onValidate.md b/website/translated_docs/fr/Events/onValidate.md index 29bf3e88ad4ac8..a5183d5da01c22 100644 --- a/website/translated_docs/fr/Events/onValidate.md +++ b/website/translated_docs/fr/Events/onValidate.md @@ -3,16 +3,16 @@ id: onValidate title: Sur validation --- -| Code | Peut être appelé par | Définition | -| ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | -| 3 | [4D Write Pro area](FormObjects/writeProArea_overview) - [Button](FormObjects/button_overview.md) - [Button Grid](FormObjects/buttonGrid_overview.md) - [Check Box](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Dropdown list](FormObjects/dropdownList_Overview.md) - Form - [Hierarchical List](FormObjects/list_overview.md#overview) - [Input](FormObjects/input_overview.md) - [List Box](FormObjects/listbox_overview.md) - [List Box Column](FormObjects/listbox_overview.md#list-box-columns) - [Picture Button](FormObjects/pictureButton_overview.md) - [Picture Pop up menu](FormObjects/picturePopupMenu_overview.md) - [Plug-in Area](FormObjects/pluginArea_overview.md#overview) - [Progress Indicators](FormObjects/progressIndicator.md) - [Radio Button](FormObjects/radio_overview.md) - [Ruler](FormObjects/ruler.md) - [Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Subform](FormObjects/subform_overview.md) - [Tab control](FormObjects/tabControl.md) | The record data entry has been validated | +| Code | Peut être appelé par | Définition | +| ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | +| 3 | [Zone 4D Write Pro](FormObjects/writeProArea_overview) - [Bouton](FormObjects/button_overview.md) - [Grille de boutons](FormObjects/buttonGrid_overview.md) - [Case à cocher](FormObjects/checkbox_overview.md) - [Combo Box](FormObjects/comboBox_overview.md) - [Liste déroulante](FormObjects/dropdownList_Overview.md) - Formulaire - [Liste hiérarchique](FormObjects/list_overview.md#overview) - [Zone de saisie](FormObjects/input_overview.md) -[List Box](FormObjects/listbox_overview.md) - [Colonne de List Box](FormObjects/listbox_overview.md#list-box-columns) - [Bouton image](FormObjects/pictureButton_overview.md) - [Pop up menu image](FormObjects/picturePopupMenu_overview.md) - [Zone de plug-in](FormObjects/pluginArea_overview.md#overview) - [Indicateur de progression](FormObjects/progressIndicator.md) - [Bouton radio](FormObjects/radio_overview.md) - [Règle](FormObjects/ruler.md) -[Spinner](FormObjects/spinner.md) - [Splitter](FormObjects/splitters.md) - [Stepper](FormObjects/stepper.md) - [Sous-formulaire](FormObjects/subform_overview.md) - [Onglet](FormObjects/tabControl.md) | La saisie des données d'enregistrement a été validée | ## Description -This event is triggered when the record data entry has been validated, for example after a `SAVE RECORD` command call or an `accept` [standard action](FormObjects/properties_Action.md#standard-action). +Cet événement est déclenché lorsque la saisie des données d'enregistrement a été validée, par exemple après un appel de la commande `SAVE RECORD` ou après une [action standard](FormObjects/properties_Action.md#standard-action) `accept`. ### Sous-formulaire -The `On Validate` event is triggered when data entry is validated in the subform. \ No newline at end of file +L'événement `On Validate` est déclenché lorsque la saisie de données est validée dans le sous-formulaire. \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onVpRangeChanged.md b/website/translated_docs/fr/Events/onVpRangeChanged.md index ec2bb0d8ce7309..b1db79e400d532 100644 --- a/website/translated_docs/fr/Events/onVpRangeChanged.md +++ b/website/translated_docs/fr/Events/onVpRangeChanged.md @@ -5,7 +5,7 @@ title: On VP Range Changed | Code | Peut être appelé par | Définition | | ---- | ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | -| 61 | [4D View Pro Area](FormObjects/viewProArea_overview.md) | La plage de cellules 4D View Pro a changé (ex : un calcul de formule, une valeur supprimée d'une cellule, etc.) | +| 61 | [Zone 4D View Pro](FormObjects/viewProArea_overview.md) | La plage de cellules 4D View Pro a changé (ex : un calcul de formule, une valeur supprimée d'une cellule, etc.) | ## Description diff --git a/website/translated_docs/fr/Events/onVpReady.md b/website/translated_docs/fr/Events/onVpReady.md index 853f1b1aade52d..4a796bed6f5ed5 100644 --- a/website/translated_docs/fr/Events/onVpReady.md +++ b/website/translated_docs/fr/Events/onVpReady.md @@ -3,15 +3,15 @@ id: onVpReady title: On VP Ready --- -| Code | Peut être appelé par | Définition | -| ---- | ------------------------------------------------------- | ----------------------------------------------- | -| 9 | [4D View Pro Area](FormObjects/viewProArea_overview.md) | The loading of the 4D View Pro area is complete | +| Code | Peut être appelé par | Définition | +| ---- | ------------------------------------------------------- | ------------------------------------------------ | +| 9 | [Zone 4D View Pro](FormObjects/viewProArea_overview.md) | Le chargement de la zone 4D View Pro est terminé | ## Description -This event is generated when the 4D View Pro area loading is complete. +Cet événement est généré lorsque le chargement de la zone 4D View Pro est terminé. -You need to use this event to write initialization code for the area. Any 4D View Pro area initialization code, for loading or reading values from or in the area, must be located in the `On VP Ready` form event of the area. This form event is triggered once the area loading is complete. Testing this event makes you sure that the code will be executed in a valid context. An error is returned if a 4D View Pro command is called before the `On VP Ready` form event is generated. +Vous devez utiliser cet événement pour écrire le code d'initialisation de la zone. Tout code d'initialisation de zone 4D View Pro, pour le chargement ou la lecture de valeurs issues de la zone ou contenues dans la zone, doit se trouver dans l'événement formulaire `On VP Ready` de la zone. Cet événement formulaire est déclenché une fois le chargement de la zone terminé. Tester cet événement vous garantit que le code sera exécuté dans un contexte valide. Une erreur est retournée si une commande 4D View Pro est appelée avant la génération de l'événement formulaire `On VP Ready`. -> 4D View Pro areas are loaded asynchronously in 4D forms. It means that the standard [On load](onLoad.md) form event cannot be used for 4D View Pro initialization code, since it could be executed before the loading of the area is complete. `On VP Ready` is always generated after [On load](onLoad.md). \ No newline at end of file +> Les zones 4D View Pro sont chargées de manière asynchrone dans les formulaires 4D. Cela signifie que l'événement standard [On load](onLoad.md) form ne peut pas être utilisé pour le code d'initialisation de 4D View Pro, car il pourrait être exécuté avant la fin du chargement de la zone. `On VP Ready` est toujours généré après [On load](onLoad.md). \ No newline at end of file diff --git a/website/translated_docs/fr/Events/onWindowOpeningDenied.md b/website/translated_docs/fr/Events/onWindowOpeningDenied.md index 5ec79b5c22d122..a04a22bc98c31b 100644 --- a/website/translated_docs/fr/Events/onWindowOpeningDenied.md +++ b/website/translated_docs/fr/Events/onWindowOpeningDenied.md @@ -5,14 +5,14 @@ title: On Window Opening Denied | Code | Peut être appelé par | Définition | | ---- | ------------------------------------------- | -------------------------------- | -| 53 | [Zone Web](FormObjects/webArea_overview.md) | A pop-up window has been blocked | +| 53 | [Zone Web](FormObjects/webArea_overview.md) | Une fenêtre pop-up a été bloquée | ## Description -This event is generated when the opening of a pop-up window is blocked by the Web area. 4D Web areas do not allow the opening of pop-up windows. +Cet événement est généré lorsque l'ouverture d'une fenêtre pop-up est bloquée par la zone Web. Les zones Web de 4D ne permettent pas l'ouverture de fenêtres contextuelles. -You can find out the blocked URL using the `WA Get last filtered URL` command. +Vous pouvez identifier l'URL bloquée à l'aide de la commande `WA Get last filtered URL`. ### Voir également diff --git a/website/translated_docs/fr/Events/overview.md b/website/translated_docs/fr/Events/overview.md index b9c8515e00ef46..111ebe77c52b49 100644 --- a/website/translated_docs/fr/Events/overview.md +++ b/website/translated_docs/fr/Events/overview.md @@ -3,51 +3,51 @@ id: overview title: Aperçu --- -Form events are events that can lead to the execution of the form method and/or form object method(s). Form events allow you to control the flow of your application and to write code that is executed only when a specific event occurs. +Les événements formulaire sont des événements qui peuvent conduire à l'exécution de la méthode de formulaire et/ou de la ou des méthodes objet de formulaire. Les événements de formulaire vous permettent de contrôler le flux de votre application et d'écrire du code qui n'est exécuté que lorsqu'un événement spécifique se produit. -In your code, you control the events using the `FORM Event` command, that returns the triggered event. Par exemple: +Dans votre code, vous contrôlez les événements à l'aide de la commande `FORM Event`, qui retourne l'événement déclenché. Par exemple: ```4d -//code of a button +//code d'un bouton If(FORM Event.code=On Clicked) -// do something when the button is clicked +// faire quelque chose quand on clique sur le bouton End if ``` -> Every form and every active object on the form can listen to a predefined set of events, but only the events that you enabled at the form level and/or at every object level will actually occur. +> Chaque formulaire et chaque objet actif du formulaire peut lire un ensemble prédéfini d'événements, mais seuls les événements que vous avez activés au niveau du formulaire et/ou à chaque niveau d'objet se produiront réellement. -## Event object +## Objet événement -Each event is returned as an object by the `FORM Event` command. By default, it contains the following properties: +Chaque événement est retourné sous forme d'objet par la commande `FORM Event`. Par défaut, il contient les propriétés suivantes : | Propriété | Type | Description | | --------- | ---- | ----------- | | | | | objectName|text|Name of the object triggering the event - Not included if the event is triggered by the form| |code|longint|Numeric value of the form event. Also returned by the -Additional properties are returned when the event occurs on specific objects. En particulier : +Des propriétés supplémentaires sont retournées lorsque l'événement se produit sur des objets spécifiques. En particulier : - Les [list box](FormObjects/listbox_overview.md#supported-form-events) et les [colonnes de list box](FormObjects/listbox_overview.md#supported-form-events-1) retournent des [propriétés supplémentaires](FormObjects/listbox_overview.md#additional-properties) telles que `columnName` ou `isRowSelected`. - Les [zones 4D View Pro](FormObjects/viewProArea_overview.md) retournent par exemple des propriétés `sheetName` ou `action` dans l'objet événement [On After Edit](onAfterEdit.md). -## Events and Methods +## Événements et méthodes -When a form event occurs, 4D performs the following actions: +Lorsqu'un événement formulaire se produit, 4D effectue les actions suivantes : -- First, it browses the objects of the form and calls the object method for any object (involved in the event) whose corresponding object event property has been selected. -- Second, it calls the form method if the corresponding form event property has been selected. +- Tout d'abord, il parcourt les objets du formulaire et appelle la méthode objet pour tout objet (associé à l'événement) dont la propriété d'événement d'objet correspondante a été sélectionnée. +- Deuxièmement, il appelle la méthode formulaire si la propriété d'événement formulaire correspondante a été sélectionnée. -Do not assume that the object methods, if any, will be called in a particular order. The rule of thumb is that the object methods are always called before the form method. If an object is a subform, the object methods of the subform’s list form are called, then the form method of the list form is called. 4D then continues to call the object methods of the parent form. In other words, when an object is a subform, 4D uses the same rule of thumb for the object and form methods within the subform object. +Ne supposez pas que les méthodes objet, le cas échéant, seront appelées dans un ordre particulier. La règle d'or est que les méthodes objet sont toujours appelées avant la méthode formulaire. Si un objet est un sous-formulaire, les méthodes objet du formulaire liste du sous-formulaire sont appelées, suivie de la méthode formulaire du formulaire liste. 4D continue alors d'appeler les méthodes objet du formulaire parent. En d'autres termes, lorsqu'un objet est un sous-formulaire, 4D utilise la même règle pour les méthodes objet et formulaire au sein de l'objet sous-formulaire. -Except for the [On Load](onLoad.md) and [On Unload](onUnload.md) events (see below), if the form event property is not selected for a given event, this does not prevent calls to object methods for the objects whose same event property is selected. In other words, enabling or disabling an event at the form level has no effect on the object event properties. +À l'exception des événements [On Load](onLoad.md) et [On Unload](onUnload.md) (voir ci-dessous), si la propriété d'événement formulaire n'est pas sélectionnée pour un événement donné, cela n'empêche pas les appels vers les méthodes objet pour les objets dont la même propriété d'événement est sélectionnée. En d'autres termes, l'activation ou la désactivation d'un événement au niveau du formulaire n'a aucun effet sur les propriétés d'événement de l'objet. -The number of objects involved in an event depends on the nature of the event. +Le nombre d'objets associés à un événement dépend de la nature de l'événement. -## Call Table +## Tableau des appels -The following table summarizes how object and form methods are called for each event type: +Le tableau suivant résume la manière dont les méthodes objet et formulaire sont appelées pour chaque type d'événement : | Evénement | Méthode objet | Méthode formulaire | Objets | | ----------------------------- | ---------------------------------- | ------------------ | --------------------------- | @@ -98,9 +98,9 @@ The following table summarizes how object and form methods are called for each e | Sur après tri | Oui (List box) | Jamais | Objets concernés uniquement | | Sur clic long | Oui (Bouton) | Oui | Objets concernés uniquement | | Sur clic alternatif | Oui (Bouton et List box) | Jamais | Objets concernés uniquement | -| Sur déployer | Yes (Hier. list and list box) | Jamais | Objets concernés uniquement | -| Sur contracter | Yes (Hier. list and list box) | Jamais | Objets concernés uniquement | -| Sur action suppression | Yes (Hier. list and list box) | Jamais | Objets concernés uniquement | +| Sur déployer | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| Sur contracter | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | +| Sur action suppression | Oui (Liste hiérar. et list box) | Jamais | Objets concernés uniquement | | On URL Resource Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | | On Begin URL Loading | Oui (Zone Web) | Jamais | Objets concernés uniquement | | On URL Loading Error | Oui (Zone Web) | Jamais | Objets concernés uniquement | @@ -112,7 +112,7 @@ The following table summarizes how object and form methods are called for each e | On VP Ready | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | | On Row Resize | Oui (4D View Pro Area) | Jamais | Objets concernés uniquement | -Always keep in mind that, for any event, the method of a form or an object is called if the corresponding event property is selected for the form or objects. The benefit of disabling events in the Design environment (using the Property List of the Form editor) is that you can reduce the number of calls to methods and therefore significantly optimize the execution speed of your forms. +Gardez toujours à l'esprit que, pour tout événement, la méthode d'un formulaire ou d'un objet est appelée si la propriété d'événement correspondante est sélectionnée pour le formulaire ou les objets. L'avantage de la désactivation des événements dans l'environnement de développement (à l'aide de la liste des propriétés de l'éditeur de formulaires) est la réduction du nombre d'appels vers des méthodes et par conséquent l'optimisation de la vitesse d'exécution de vos formulaires. -> WARNING: The [On Load](onLoad) and [On Unload](onUnloas) events are generated for objects if they are enabled for both the objects and the form to which the objects belong. If the events are enabled for objects only, they will not occur; these two events must also be enabled at the form level. +> ATTENTION : Les événements [On Load et [](onUnloas)On Unload](onLoad) sont générés pour les objets s'ils sont activés à la fois pour les objets et pour le formulaire auquel appartiennent les objets. Si les événements sont activés pour les objets uniquement, ils ne se produiront pas; ces deux événements doivent également être activés au niveau du formulaire. diff --git a/website/translated_docs/fr/FormEditor/forms.md b/website/translated_docs/fr/FormEditor/forms.md index e6ec8bf5d610ea..ecda28118ae575 100644 --- a/website/translated_docs/fr/FormEditor/forms.md +++ b/website/translated_docs/fr/FormEditor/forms.md @@ -4,23 +4,23 @@ title: A propos des formulaires 4D --- -Forms provide the interface through which information is entered, modified, and printed in a desktop application. Users interact with the data in a database using forms and print reports using forms. Forms can be used to create custom dialog boxes, palettes, or any featured custom window. +Les formulaires fournissent l'interface par laquelle les informations sont saisies, modifiées et imprimées dans une application de bureau. A l'aide des formulaires, les utilisateurs peuvent interagir avec les données d'une base de données et imprimer des rapports. Les formulaires permettent de créer des boîtes de dialogue personnalisées, des palettes ou toute fenêtre personnalisée. ![](assets/en/FormObjects/form1.png) -Forms can also contain other forms through the following features: +Les formulaires peuvent également contenir d'autres formulaires grâce aux fonctionnalités suivantes : -- [subform objects](FormObjects/subform_overview.md) -- [inherited forms](properties_FormProperties.md#inherited-forms) +- [les objets sous-formulaires](FormObjects/subform_overview.md) +- [les formulaires hérités](properties_FormProperties.md#inherited-forms) -## Creating forms +## Création de formulaires -You can add or modify 4D forms using the following elements: +Vous pouvez ajouter ou modifier des formulaires 4D à l'aide des éléments suivants : -- **4D Developer interface:** Create new forms from the **File** menu or the **Explorer** window. -- **Form Editor**: Modify your forms using the **[Form Editor](FormEditor/formEditor.md)**. -- **JSON code:** Create and design your forms using JSON and save the form files at the [appropriate location](Project/architecture.md#sources-folder). Exemple : +- **L'interface 4D Developer :** Créez de nouveaux formulaires à partir du menu **Fichier** ou de la fenêtre de l' **Explorateur**. +- **L'éditeur de formulaires **: Modifiez vos formulaires à l'aide de l'**[éditeur de formulaires](FormEditor/formEditor.md)**. +- **Le code JSON :** Créez et concevez vos formulaires à l'aide de JSON et enregistrez les fichiers de formulaire à [l'emplacement approprié](Project/architecture.md#sources-folder). Exemple : ``` { @@ -70,16 +70,16 @@ You can add or modify 4D forms using the following elements: -## Project form and Table form +## Formulaire projet et formulaire table -There are two categories of forms: +Il existe deux catégories de formulaires : -* **Project forms** - Independent forms that are not attached to any table. They are intended more particularly for creating interface dialog boxes as well as components. Project forms can be used to create interfaces that easily comply with OS standards. +* **Les formulaires projet** - Formulaires indépendants qui ne sont rattachés à aucune table. Ils sont destinés plus particulièrement à la création de boîtes de dialogue d'interface et de composants. Les formulaires projet peuvent être utilisés pour créer des interfaces facilement conformes aux normes du système d'exploitation. -* **Table forms** - Attached to specific tables and thus benefit from automatic functions useful for developing applications based on databases. Typically, a table has separate input and output forms. +* **Les formulaires table** - Rattachés à des tables spécifiques et bénéficient ainsi de fonctions automatiques utiles pour développer des applications basées sur des bases de données. En règle générale, une table possède des formulaires d'entrée et de sortie séparés. -Typically, you select the form category when you create the form, but you can change it afterwards. +En règle générale, vous sélectionnez la catégorie de formulaire lorsque vous créez le formulaire, mais vous pouvez la modifier par la suite. ## Pages formulaire @@ -89,18 +89,18 @@ Chaque formulaire est composé d'au moins deux pages : - une page 1 : une page principale, affichée par défaut - une page 0 : une page de fond, dont le contenu est affiché sur une page sur deux. -Vous pouvez créer plusieurs pages pour un formulaire d'entrée. If you have more fields or variables than will fit on one screen, you may want to create additional pages to display them. Multiple pages allow you to do the following: +Vous pouvez créer plusieurs pages pour un formulaire d'entrée. Si le nombre de champs ou de variables est supérieur au nombre maximal supporté sur un écran, vous pouvez créer des pages supplémentaires pour les afficher. Plusieurs pages vous permettent d'effectuer les opérations suivantes : -- Place the most important information on the first page and less important information on other pages. -- Organize each topic on its own page. +- Placez les informations les plus importantes sur la première page et les informations les moins importantes sur les autres pages. +- Organisez chaque sujet sur sa propre page. - Réduir ou éliminer le défilement pendant la saisie des données en définissant [l'ordre de saisie](../FormEditor/formEditor.html#data-entry-order). -- Provide space around the form elements for an attractive screen design. +- Prévoyez de l'espace autour des éléments du formulaire pour un design d'écran attrayant. -Multiple pages are a convenience used for input forms only. They are not for printed output. When a multi-page form is printed, only the first page is printed. +Les pages multiples sont utiles uniquement pour les formulaires d'entrée. Elles ne sont pas destinées à être imprimées. Lorsqu'un formulaire de plusieurs pages est imprimé, seule la première page est imprimée. -There are no restrictions on the number of pages a form can have. The same field can appear any number of times in a form and on as many pages as you want. However, the more pages you have in a form, the longer it will take to display it. +Il n'y a aucune restriction sur le nombre de pages qu'un formulaire peut contenir. Le même champ peut apparaître en un nombre de fois illimité dans un formulaire et sur autant de pages que vous le souhaitez. Toutefois, plus vous aurez de pages dans un formulaire, plus il sera long à afficher. -A multi-page form has both a background page and several display pages. Objects that are placed on the background page may be visible on all display pages, but can be selected and edited only on the background page. In multi-page forms, you should put your button palette on the background page. You also need to include one or more objects on the background page that provide page navigation tools for the user. +Un formulaire multi-pages contient à la fois une page d'arrière-plan et plusieurs pages d'affichage. Les objets placés sur la page d'arrière-plan peuvent être visibles sur toutes les pages d'affichage, mais il ne peuvent être sélectionnés et modifiés que sur la page d'arrière-plan. Dans les formulaires multi-pages, vous devez placer votre palette de boutons sur la page d'arrière-plan. Vous devez également inclure un ou plusieurs objets sur la page d'arrière-plan qui fournissent à l'utilisateur des outils de navigation de page. ## Formulaires hérités diff --git a/website/translated_docs/fr/FormObjects/listbox_overview.md b/website/translated_docs/fr/FormObjects/listbox_overview.md index 7e4772229ac92b..59c448d00638b6 100644 --- a/website/translated_docs/fr/FormObjects/listbox_overview.md +++ b/website/translated_docs/fr/FormObjects/listbox_overview.md @@ -360,7 +360,7 @@ When the `OBJECT SET VISIBLE` command is used with a footer, it is applied to al For a list box cell to be enterable, both of the following conditions must be met: - The cell’s column must have been set as [Enterable](properties_Entry.md#enterable) (otherwise, the cells of the column can never be enterable). -- In the `On Before Data Entry` event, $0 does not return -1. When the cursor arrives in the cell, the `On Before Data Entry` event is generated in the column method. If, in the context of this event, $0 is set to -1, the cell is considered as not enterable. If the event was generated after **Tab** or **Shift+Tab** was pressed, the focus goes to either the next cell or the previous one, respectively. If $0 is not -1 (by default $0 is 0), the cell is enterable and switches to editing mode. +- In the `On Before Data Entry` event, $0 does not return -1. When the cursor arrives in the cell, the `On Before Data Entry` event is generated in the column method. Si, dans le contexte de cet événement, $0 est défini sur -1, la cellule est considérée comme non saisissable. Si l'événement a été généré après avoir appuyé sur **Tab** ou **Maj+Tab**, le focus va respectivement à la cellule suivante ou à la précédente. Si la valeur de $0 n'est pas -1 (par défaut $0 est 0), la cellule est saisissable et passe en mode d'édition. Let’s consider the example of a list box containing two arrays, one date and one text. The date array is not enterable but the text array is enterable if the date has not already past. diff --git a/website/translated_docs/ja/API/classClass.md b/website/translated_docs/ja/API/classClass.md index bf9136d2df527f..027b583ddb5644 100644 --- a/website/translated_docs/ja/API/classClass.md +++ b/website/translated_docs/ja/API/classClass.md @@ -52,12 +52,13 @@ This property is **read-only**.
    -**.new()** : 4D.Class +**.new**( *param* : any { *;...paramN* } ) : 4D.Class -| 参照 | タイプ | | 説明 | -| --- | -------- |:--:| ----------------------- | -| 戻り値 | 4D.Class | <- | New object of the class | +| 参照 | タイプ | | 説明 | +| ----- | -------- |:--:| ------------------------------------------------ | +| param | any | -> | Parameter(s) to pass to the constructor function | +| 戻り値 | 4D.Class | <- | New object of the class | @@ -65,8 +66,9 @@ This property is **read-only**. The `.new()` function creates and returns a `cs.className` object which is a new instance of the class on which it is called. This function is automatically available on all classes from the [`cs` class store](Concepts/classes.md#cs). -存在しないクラスを対象に呼び出された場合、エラーが返されます。 +You can pass one or more optional *param* parameters, which will be passed to the [class constructor](Concepts/classes.md#class-constructor) function (if any) in the className class definition. Within the constructor function, the [`This`](Concepts/classes.md#this) is bound to the new object being constructed. +If `.new()` is called on a non-existing class, an error is returned. #### 例題 @@ -75,9 +77,29 @@ Person クラスの新規インスタンスを作成するには、次のよう ```4d var $person : cs.Person $person:=cs.Person.new() //create the new instance -//$Person contains functions of the class +//$person contains functions of the class ``` +To create a new instance of the Person class with parameters: + +```4d +//Class: Person.4dm +Class constructor($firstname : Text; $lastname : Text; $age : Integer) + This.firstName:=$firstname + This.lastName:=$lastname + This.age:=$age +``` + +```4d +//In a method +var $person : cs.Person +$person:=cs.Person.new("John";"Doe";40) +//$person.firstName = "John" +//$person.lastName = "Doe" +//$person.age = 40 +``` + + diff --git a/website/translated_docs/ja/API/dataclassClass.md b/website/translated_docs/ja/API/dataclassClass.md index 6be871914dc385..7c6e0c5fbdae49 100644 --- a/website/translated_docs/ja/API/dataclassClass.md +++ b/website/translated_docs/ja/API/dataclassClass.md @@ -1,6 +1,6 @@ --- id: dataclassClass -title: DataClass +title: データクラス --- @@ -503,7 +503,7 @@ The `.getInfo( )` function returns | プロパティ | タイプ | 説明 | | ----------- | ---- | ---------------------------------------- | -| name | テキスト | Name of the dataclass | +| name | テキスト | データクラスの名称 | | primaryKey | テキスト | Name of the primary key of the dataclass | | tableNumber | 整数 | Internal 4D table number | diff --git a/website/translated_docs/ja/Concepts/classes.md b/website/translated_docs/ja/Concepts/classes.md index b59ac8bddf2579..b9bcd299602c70 100644 --- a/website/translated_docs/ja/Concepts/classes.md +++ b/website/translated_docs/ja/Concepts/classes.md @@ -15,18 +15,23 @@ title: クラス たとえば、次のように `Person` クラスを定義した場合: ```4d -// クラス: Person.4dm +//Class: Person.4dm Class constructor($firstname : Text; $lastname : Text) This.firstName:=$firstname This.lastName:=$lastname + +Function sayHello()->$welcome : Text + $welcome:="Hello "+This.firstName+" "+This.lastName ``` この "Person" のインスタンスをメソッド内で作成するには、以下のように書けます: ``` -var $o : cs.Person // Person クラスのオブジェクト -$o:=cs.Person.new("John";"Doe") -// $o:{firstName: "John"; lastName: "Doe" } +var $person : cs.Person //object of Person class +var $hello : Text +$person:=cs.Person.new("John";"Doe") +// $person:{firstName: "John"; lastName: "Doe" } +$hello:=$person.sayHello() //"Hello John Doe" ``` @@ -39,7 +44,7 @@ $o:=cs.Person.new("John";"Doe") クラスを命名する際には、次のルールに留意してください: -- クラス名は [プロパティ名の命名規則](Concepts/dt_object.md#オブジェクトプロパティ識別子) に準拠している必要があります。 +- A [class name](identifiers.md#classes) must be compliant with [property naming rules](identifiers.md#object-properties). - 大文字と小文字が区別されること - 競合防止のため、データベースのテーブルと同じ名前のクラスを作成するのは推奨されないこと @@ -81,7 +86,7 @@ $o:=cs.Person.new("John";"Doe") #### クラスのコードサポート -各種 4D 開発ウィンドウ (コードエディター、コンパイラー、デバッガー、ランタイムエクスプローラー) において、クラスコードは "特殊なプロジェクトメソッド" のように扱われます: +In the various 4D windows (code editor, compiler, debugger, runtime explorer), class code is basically handled like a project method with some specificities: - コードエディター: - クラスは実行できません @@ -136,10 +141,8 @@ $key:=4D.CryptoKey.new(New object("type";"ECDSA";"curve";"prime256v1")) -## コード内のクラスの使用 - -### Class オブジェクト +## Class オブジェクト プロジェクトにおいてクラスが [定義](#クラス定義) されていれば、それは 4Dランゲージ環境に読み込まれます。 クラスとは、それ自身が ["Class" クラス](API/classClass.md) のオブジェクトです。 Class オブジェクトは次のプロパティや関数を持ちます: @@ -147,46 +150,23 @@ $key:=4D.CryptoKey.new(New object("type";"ECDSA";"curve";"prime256v1")) - [`superclass`](API/classClass.md#superclass) オブジェクト (無い場合は null) - [`new()`](API/classClass.md#new) 関数 (クラスオブジェクトをインスタンス化します) -さらに、Class オブジェクトは次を参照できます: - -- [`constructor`](#class-constructor) オブジェクト (任意), -- `prototype` オブジェクト: 名前付きの [関数](#function) オブジェクトを格納します (任意) +In addition, a class object can reference a [`constructor`](#class-constructor) object (optional). Class オブジェクトは [共有オブジェクト](shared.md) です。したがって、異なる 4Dプロセスから同時にアクセスすることができます。 +### Inheritance +If a class inherits from another class (i.e. the [Class extends](classes.md#class-extends-classname) keyword is used in its definition), the parent class is its [`superclass`](API/classClass.md#superclass). -### プロパティ検索とプロトタイプ - -4D のすべてのオブジェクトは、なんらかの Class オブジェクトに内部的にリンクしています。 あるプロパティがオブジェクト内で見つからない場合、4D はそのクラスのプロトタイプオブジェクト内を検索します。見つからない場合、4D はそのクラスのスーパークラスのプロトタイプオブジェクト内を探します。これは、スーパークラスが存在しなくなるまで続きます。 - -すべてのオブジェクトは、継承ツリーの頂点である "Object" クラスを継承します。 - -```4d -// クラス: Polygon -Class constructor($width : Integer; $height : Integer) - This.area:=$width*$height - - //var $poly : Object - var $instance : Boolean - $poly:=cs.Polygon.new(4;3) - - $instance:=OB Instance of($poly;cs.Polygon) - // true - $instance:=OB Instance of($poly;4D.Object) - // true -``` - -オブジェクトのプロパティを列挙する際には、当該クラスのプロトタイプは列挙されません。 したがって、`For each` ステートメントや `JSON Stringify` コマンドは、クラスプロトタイプオブジェクトのプロパティを返しません。 クラスのプロトタイプオブジェクトプロパティは、内部的な隠れプロパティです。 - +When 4D does not find a function or a property in a class, it searches it in its [`superclass`](API/classClass.md#superclass); if not found, 4D continues searching in the superclass of the superclass, and so on until there is no more superclass (all objects inherit from the "Object" superclass). ## クラスキーワード クラス定義内では、専用の 4Dキーワードが使用できます: -- `Function `: オブジェクトのメンバーメソッドを定義します。 -- `Class constructor`: オブジェクトのプロパティを定義します (プロトタイプ定義)。 +- `Function ` to define class functions of the objects. +- `Class constructor` to define the properties of the objects. - `Class extends `: 継承を定義します。 @@ -199,9 +179,9 @@ Function ({$parameterName : type; ...}){->$parameterName : type} // コード ``` -クラス関数とは、当該クラスのプロトタイプオブジェクトのプロパティです。 また、クラス関数は "Function" クラスのオブジェクトでもあります。 +Class functions are specific properties of the class. They are objects of the [4D.Function](API/formulaClass.md#about-4dfunction-objects) class. -クラス定義ファイルでは、`Function` キーワードと関数名を使用して宣言をおこないます。 関数名は [プロパティ名の命名規則](Concepts/dt_object.md#オブジェクトプロパティ識別子) に準拠している必要があります。 +クラス定義ファイルでは、`Function` キーワードと関数名を使用して宣言をおこないます。 The function name must be compliant with [property naming rules](Concepts/identifiers.md#object-properties). > **Tip:** アンダースコア ("_") 文字で関数名を開始すると、その関数は 4Dコードエディターの自動補完機能から除外されます。 たとえば、`MyClass` に `Function _myPrivateFunction` を宣言した場合、コードエディターにおいて `"cs.MyClass "` とタイプしても、この関数は候補として提示されません。 @@ -226,19 +206,19 @@ Function getFullname()->$fullname : Text アプリケーションのコード内では、クラス関数はオブジェクトインスタンスのメンバーメソッドとして呼び出され、 **スレッドセーフに関する警告:** クラス関数がスレッドセーフではないのに、"プリエンプティブプロセスで実行可能" なメソッドから呼び出された場合: - 普通のメソッドの場合とは異なり、コンパイラーはエラーを生成しません。 - ランタイムにおいてのみ、4D はエラーを生成します。 +> **Thread-safety warning:** If a class function is not thread-safe and called by a method with the "Can be run in preemptive process" attribute: - the compiler does not generate any error (which is different compared to regular methods), - an error is thrown by 4D only at runtime. -#### 引数 +#### Parameters -関数の引数は、引数の名称とデータ型をコロンで区切って宣言します。 引数名は [プロパティ名の命名規則](Concepts/dt_object.md#オブジェクトプロパティ識別子) に準拠している必要があります。 複数のパラメーター (およびその型) を宣言する場合は、それらをセミコロン (;) で区切ります。 +Function parameters are declared using the parameter name and the parameter type, separated by a colon. The parameter name must be compliant with [property naming rules](Concepts/identifiers.md#object-properties). 複数のパラメーター (およびその型) を宣言する場合は、それらをセミコロン (;) で区切ります。 ```4d Function add($x; $y : Variant; $z : Integer; $xy : Object) @@ -306,24 +286,24 @@ Class Constructor({$parameterName : type; ...}) クラスコンストラクター関数を使って、ユーザークラスを定義することができます。このコンストラクターは [引数](#引数) を受け取ることができます。 -クラスコンストラクターが定義されていると、`new()` クラスメンバーメソッドを呼び出したときに、当該コンストラクターが呼び出されます (引数を指定している場合は `new()` 関数に渡します)。 +In that case, when you call the [`new()`](API/classClass.md#new) function, the class constructor is called with the parameters optionally passed to the `new()` function. -クラスコンストラクターメソッドの場合には、`Current method name` コマンドは次を返します: "*\.constructor*" (例: "MyClass.constructor")。 +For a class constructor function, the `Current method name` command returns: "*\.constructor*", for example "MyClass.constructor". -#### 例題: +#### Example: ```4d -// クラス: MyClass -// MyClass のクラスコンストラクター +// Class: MyClass +// Class constructor of MyClass Class Constructor ($name : Text) This.name:=$name ``` ```4d -// プロジェクトメソッドにて -// オブジェクトをインスタンス化します +// In a project method +// You can instantiate an object var $o : cs.MyClass $o:=cs.MyClass.new("HelloWorld") // $o = {"name":"HelloWorld"} @@ -334,14 +314,14 @@ $o:=cs.MyClass.new("HelloWorld") ### Class extends \ -#### シンタックス +#### Syntax ```4d -// クラス: ChildClass +// Class: ChildClass Class extends ``` -クラス宣言において `Class extends` キーワードを使うと、別のユーザークラスの子ユーザークラスを作成することができます。 この子クラスは、親クラスのすべての機能を継承します。 +The `Class extends` keyword is used in class declaration to create a user class which is a child of another user class. この子クラスは、親クラスのすべての機能を継承します。 クラス継承は次のルールに沿っている必要があります: @@ -497,32 +477,32 @@ $message:=$square.description() // "I have 4 sides which are all equal" `This` の値は、呼ばれ方によって決まります。 `This` の値は実行時に代入により設定することはできません。また、呼び出されるたびに違う値となりえます。 -オブジェクトのメンバーメソッドとしてフォーミュラが呼び出された場合、`This` はメソッドの呼び出し元であるオブジェクトを指します。 たとえば: +オブジェクトのメンバーメソッドとしてフォーミュラが呼び出された場合、`This` はメソッドの呼び出し元であるオブジェクトを指します。 For example: ```4d $o:=New object("prop";42;"f";Formula(This.prop)) $val:=$o.f() //42 ``` -[クラスコンストラクター](#class-constructor) 関数が `new()` キーワードにより使用された場合、その内部の `This` はインスタンス化される新規オブジェクトを指します。 +When a [class constructor](#class-constructor) function is used (with the [`new()`](API/classClass.md#new) function), its `This` is bound to the new object being constructed. ```4d -// クラス: ob +//Class: ob Class Constructor - // This のプロパティを - // 代入によって作成します + // Create properties on This as + // desired by assigning to them This.a:=42 ``` ```4d -// 4Dメソッドにて +// in a 4D method $o:=cs.ob.new() $val:=$o.a //42 ``` -> コンストラクター内で [Super](#super) キーワードを使ってスーパークラスのコンストラクターを呼び出す場合、必ず `This` よりも先にスーパークラスのコンストラクターを呼ぶ必要があることに留意してください。順番を違えるとエラーが生成されます。 こちらの [例題](#例題-1) を参照ください。 +> When calling the superclass constructor in a constructor using the [Super](#super) keyword, keep in mind that `This` must not be called before the superclass constructor, otherwise an error is generated. こちらの [例題](#例題-1) を参照ください。 基本的に、`This` はメソッドの呼び出し元のオブジェクトを指します。 diff --git a/website/translated_docs/ja/REST/$catalog.md b/website/translated_docs/ja/REST/$catalog.md index 5935fc44501d95..5a502b5fefc6cd 100644 --- a/website/translated_docs/ja/REST/$catalog.md +++ b/website/translated_docs/ja/REST/$catalog.md @@ -4,36 +4,38 @@ title: '$catalog' --- -The catalog describes all the dataclasses and attributes available in the datastore. +カタログには、データストアを構成するすべてのデータクラスおよび属性の詳細な情報が含まれます。 -## Available syntaxes +## 使用可能なシンタックス -| シンタックス | 例題 | 説明 | -| --------------------------------------------- | -------------------- | -------------------------------------------------------------------------------- | -| [**$catalog**](#catalog) | `/$catalog` | Returns a list of the dataclasses in your project along with two URIs | -| [**$catalog/$all**](#catalogall) | `/$catalog/$all` | Returns information about all of your project's dataclasses and their attributes | -| [**$catalog/{dataClass}**](#catalogdataclass) | `/$catalog/Employee` | Returns information about a dataclass and its attributes | +| シンタックス | 例題 | 説明 | +| --------------------------------------------- | -------------------- | ------------------------------------- | +| [**$catalog**](#catalog) | `/$catalog` | プロジェクト内のデータクラスのリストを、2つの URI とともに返します。 | +| [**$catalog/$all**](#catalogall) | `/$catalog/$all` | プロジェクト内のすべてのデータクラスとそれらの属性の情報を返します。 | +| [**$catalog/{dataClass}**](#catalogdataclass) | `/$catalog/Employee` | 特定のデータクラスとその属性の情報を返します。 | ## $catalog -Returns a list of the dataclasses in your project along with two URIs: one to access the information about its structure and one to retrieve the data in the dataclass +プロジェクト内のデータクラスのリストを、2つの URI とともに返します。1つはデータクラスのストラクチャー情報にアクセスするためのもので、もう1つはデータクラスのデータを取得するためのものです。 ### 説明 -When you call `$catalog`, a list of the dataclasses is returned along with two URIs for each dataclass in your project's datastore. +`$catalog` を呼び出すと、プロジェクトのデータストア内のデータクラスのリストを、データクラス毎に 2つの URI とともに返します。 -Only the exposed dataclasses are shown in this list for your project's datastore. For more information, please refer to [**Exposing tables and fields**](configuration.md#exposing-tables-and-fields) section. +プロジェクトのデータストア内の、公開されているデータクラスのみがリストされます。 詳細については、テーブルやフィールドの公開** を参照してください。

    + +データクラス毎に返されるプロパティの説明です: + +| プロパティ | タイプ | 説明 | +| ------- | --- | --------------------------------- | +| name | 文字列 | データクラスの名称。 | +| uri | 文字列 | データクラスとその属性に関する情報を取得するための URI です。 | +| dataURI | 文字列 | データクラスのデータを取得するための URI です。 | -Here is a description of the properties returned for each dataclass in your project's datastore: -| プロパティ | タイプ | 説明 | -| ------- | --- | --------------------------------------------------------------------------------- | -| name | 文字列 | Name of the dataclass. | -| uri | 文字列 | A URI allowing you to obtain information about the |dataclass and its attributes. | -| dataURI | 文字列 | A URI that allows you to view the data in the dataclass. | ### 例題 @@ -42,6 +44,8 @@ Here is a description of the properties returned for each dataclass in your proj **結果**: + + ```` { dataClasses: [ @@ -60,23 +64,32 @@ Here is a description of the properties returned for each dataclass in your proj ```` + + + ## $catalog/$all -Returns information about all of your project's dataclasses and their attributes +プロジェクト内のすべてのデータクラスとそれらの属性の情報を返します。 + + ### 説明 -Calling `$catalog/$all` allows you to receive detailed information about the attributes in each of the dataclasses in your project's active model. +`$catalog/$all` を呼び出すと、プロジェクトのデータストア内の各データクラスについて属性の情報を取得します。 + +各データクラスと属性について取得される情報についての詳細は [`$catalog/{dataClass}`](#catalogdataClass) を参照ください。 + -For more information about what is returned for each dataclass and its attributes, use [`$catalog/{dataClass}`](#catalogdataClass). ### 例題 -`GET /rest/$catalog/$all` +`GET /rest/$catalog/$all` **結果**: + + ```` { @@ -181,65 +194,82 @@ For more information about what is returned for each dataclass and its attribute ```` + + + ## $catalog/{dataClass} -Returns information about a dataclass and its attributes +特定のデータクラスとその属性の情報を返します。 + + ### 説明 -Calling `$catalog/{dataClass}` for a specific dataclass will return the following information about the dataclass and the attributes it contains. If you want to retrieve this information for all the dataclasses in your project's datastore, use [`$catalog/$all`](#catalogall). +`$catalog/{dataClass}` を呼び出すと、指定したデータクラスとその属性について詳細な情報が返されます。 プロジェクトのデータストア内のすべてのデータクラスに関して同様の情報を得るには [`$catalog/$all`](#catalogall) を使います。 -The information you retrieve concerns the following: +返される情報は次の通りです: * データクラス -* Attribute(s) -* Method(s) if any -* Primary key +* 属性 +* メソッド (あれば) +* プライマリーキー + + + +### データクラス + +公開されているデータクラスについて、次のプロパティが返されます: + +| プロパティ | タイプ | 説明 | +| -------------- | --- | --------------------------------------------------- | +| name | 文字列 | データクラスの名称 | +| collectionName | 文字列 | データクラスにおいて作成されるエンティティセレクションの名称 | +| tableNumber | 数値 | 4Dデータベース内のテーブル番号 | +| scope | 文字列 | データクラスのスコープ (**公開 (public)** に設定されているデータクラスのみ返されます) | +| dataURI | 文字列 | データクラスのデータを取得するための URI | -### DataClass -The following properties are returned for an exposed dataclass: -| プロパティ | タイプ | 説明 | -| -------------- | --- | -------------------------------------------------------------------------------------------- | -| name | 文字列 | Name of the dataclass | -| collectionName | 文字列 | Name of an entity selection on the dataclass | -| tableNumber | 数値 | Table number in the 4D database | -| scope | 文字列 | Scope for the dataclass (note that only dataclasses whose **Scope** is public are displayed) | -| dataURI | 文字列 | A URI to the data in the dataclass | +### 属性 -### Attribute(s) +公開されている各属性について、次のプロパティが返されます: -Here are the properties for each exposed attribute that are returned: +| プロパティ | タイプ | 説明 | +| ----------- | --- | ----------------------------------------------------------------------------------------------------------------------------- | +| name | 文字列 | 属性の名称 | +| kind | 文字列 | 属性タイプ (ストレージ (storage) またはリレートエンティティ (relatedEntity)) | +| fieldPos | 数値 | データベーステーブルのフィールド番号 | +| scope | 文字列 | 属性のスコープ (公開 (public) に設定されている属性のみ返されます) | +| indexed | 文字列 | 属性に **インデックス** が設定されていれば、このプロパティは true を返します。 それ以外の場合には、このプロパティは表示されません。 | +| type | 文字列 | 属性タイプ (bool, blob, byte, date, duration, image, long, long64, number, string, uuid, word)、または、N->1 リレーション属性の場合はリレーション先のデータクラス | +| identifying | ブール | 属性がプライマリーキーの場合、プロパティは true を返します。 それ以外の場合には、このプロパティは表示されません。 | +| path | 文字列 | relatedEntity または relatedEntities 属性のリレーションパス | +| foreignKey | 文字列 | relatedEntity 属性の場合、リレート先の属性名 | +| inverseName | 文字列 | relatedEntity または relatedEntities 属性の逆方向リレーション名 | -| プロパティ | タイプ | 説明 | -| ----------- | --- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -| name | 文字列 | Attribute name. | -| kind | 文字列 | Attribute type (storage or relatedEntity). | -| fieldPos | 数値 | Position of the field in the database table). | -| scope | 文字列 | Scope of the attribute (only those attributes whose scope is Public will appear). | -| indexed | 文字列 | If any **Index Kind** was selected, this property will return true. Otherwise, this property does not appear. | -| type | 文字列 | Attribute type (bool, blob, byte, date, duration, image, long, long64, number, string, uuid, or word) or the dataclass for a N->1 relation attribute. | -| identifying | ブール | This property returns True if the attribute is the primary key. Otherwise, this property does not appear. | -| path | 文字列 | Name of the relation for a relatedEntity or relateEntities attribute. | -| foreignKey | 文字列 | For a relatedEntity attribute, name of the related attribute. | -| inverseName | 文字列 | Name of the opposite relation for a relatedEntity or relateEntities attribute. | -### Primary Key -The key object returns the **name** of the attribute defined as the **Primary Key** for the dataclass. + +### プライマリーキー + +key オブジェクトには、データクラスの **プライマリーキー** として定義された属性の **名称 (name プロパティ)** が返されます。 + + ### 例題 -You can retrieve the information regarding a specific dataclass. + +特定のデータクラスに関する情報を取得します。 `GET /rest/$catalog/Employee` **結果**: + + ```` { name: "Employee", diff --git a/website/translated_docs/ja/REST/$entityset.md b/website/translated_docs/ja/REST/$entityset.md index 7fb8d2e797e485..0e9528ff65d3bf 100644 --- a/website/translated_docs/ja/REST/$entityset.md +++ b/website/translated_docs/ja/REST/$entityset.md @@ -6,7 +6,7 @@ title: '$entityset' After [creating an entity set]($method.md#methodentityset) by using `$method=entityset`, you can then use it subsequently. -## Available syntaxes +## 使用可能なシンタックス | シンタックス | 例題 | 説明 | | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------ | diff --git a/website/translated_docs/ja/REST/$info.md b/website/translated_docs/ja/REST/$info.md index 28b48f481527c0..b23faac6d80675 100644 --- a/website/translated_docs/ja/REST/$info.md +++ b/website/translated_docs/ja/REST/$info.md @@ -24,7 +24,7 @@ For each entity selection currently stored in 4D Server's cache, the following i | プロパティ | タイプ | 説明 | | ------------- | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | 文字列 | A UUID that references the entity set. | -| dataClass | 文字列 | Name of the dataclass. | +| dataClass | 文字列 | データクラスの名称。 | | selectionSize | 数値 | Number of entities in the entity selection. | | sorted | ブール | Returns true if the set was sorted (using `$orderby`) or false if it's not sorted. | | refreshed | 日付 | When the entity set was created or the last time it was used. | diff --git a/website/translated_docs/ja/REST/$method.md b/website/translated_docs/ja/REST/$method.md index 9bc782d93ecbfa..7ecaad389f7917 100644 --- a/website/translated_docs/ja/REST/$method.md +++ b/website/translated_docs/ja/REST/$method.md @@ -5,7 +5,7 @@ title: '$method' This parameter allows you to define the operation to execute with the returned entity or entity selection. -## Available syntaxes +## 使用可能なシンタックス | シンタックス | 例題 | 説明 | | ----------------------------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | diff --git a/website/translated_docs/ja/REST/REST_requests.md b/website/translated_docs/ja/REST/REST_requests.md index 7789d76fccf1e9..ae906c708d2f7d 100644 --- a/website/translated_docs/ja/REST/REST_requests.md +++ b/website/translated_docs/ja/REST/REST_requests.md @@ -20,7 +20,7 @@ RESTリクエストには、URI とリソースが必ず含まれていなけれ `GET /rest/Person/?$filter="lastName!=Jones"&$method=entityset&$timeout=600` > 曖昧さ回避のため、値は引用符内に書くことができます。 たとえば、上の例では名字 (lastName) の値を単一引用符内に書けます: "lastName!='Jones'"。 -パラメーターを利用することで、4Dプロジェクトのデータクラスのデータを操作できます。 Besides retrieving data using `GET` HTTP methods, you can also add, update, and delete entities in a dataclass using `POST` HTTP methods. +パラメーターを利用することで、4Dプロジェクトのデータクラスのデータを操作できます。 `GET` HTTPメソッドを使ってデータを取得する以外にも、`POST` HTTPメソッドを使ってデータクラスのエンティティを追加・更新・削除することが可能です。 JSON の代わりに配列形式でデータを取得するには [`$asArray`]($asArray.md) パラメーターを使います。 diff --git a/website/translated_docs/ja/REST/genInfo.md b/website/translated_docs/ja/REST/genInfo.md index 64a35ca091f965..e7f64268abc5aa 100644 --- a/website/translated_docs/ja/REST/genInfo.md +++ b/website/translated_docs/ja/REST/genInfo.md @@ -10,7 +10,7 @@ RESTサーバーの次の情報を取得することができます: ## カタログ -Use the [`$catalog`]($catalog.md), [`$catalog/{dataClass}`]($catalog.md#catalogdataclass), or [`$catalog/$all`]($catalog.md#catalogall) parameters to get the list of [exposed dataclasses and their attributes](configuration.md#exposing-tables-and-fields). +[公開されているデータクラスとデータクラス属性](configuration.md#テーブルやフィールドの公開) のリストを取得するには [`$catalog`]($catalog.md)、[`$catalog/{dataClass}`]($catalog.md#catalogdataclass)、または [`$catalog/$all`]($catalog.md#catalogall) パラメーターを使います。 公開されている全データクラスとデータクラス属性のコレクションを取得するには: diff --git a/website/translated_docs/ja/REST/manData.md b/website/translated_docs/ja/REST/manData.md index e15c848c8d440a..d590dba48c706b 100644 --- a/website/translated_docs/ja/REST/manData.md +++ b/website/translated_docs/ja/REST/manData.md @@ -109,7 +109,7 @@ RESTレスポンスにどの属性を含めて返してもらうかを指定す #### データクラスの例 -The following requests returns only the first name and last name from the People dataclass (either the entire dataclass or a selection of entities based on the search defined in `$filter`). +次のリクエストは、People データクラス (データクラス全体または `$filter` の定義に応じたエンティティセレクション) から名字 (firstName) と名前 (lastName) 属性のみを取得します。 `GET /rest/People/firstName,lastName/` diff --git a/website/translated_docs/ja/REST/{dataClass}.md b/website/translated_docs/ja/REST/{dataClass}.md index cc3398d081c13d..6f7e35d9e43751 100644 --- a/website/translated_docs/ja/REST/{dataClass}.md +++ b/website/translated_docs/ja/REST/{dataClass}.md @@ -9,7 +9,7 @@ title: エンティティやセンティティセレクション、またはクラス関数を利用するにあたって、RESTリクエスト内にデータクラス名を直接使用することができます。 -## Available syntaxes +## 使用可能なシンタックス | シンタックス | 例題 | 説明 | | ---------------------------------------------------------------------------------- | ---------------------------------------- | ---------------------------------------- | @@ -38,8 +38,8 @@ RESTリクエストにこのパラメーターのみを渡すと、( | プロパティ | タイプ | 説明 | | ------------- | ------ | ------------------------------------------------------------------------------------------ | -| __entityModel | 文字列 | Name of the dataclass. | -| __COUNT | 数値 | Number of entities in the dataclass. | +| __entityModel | 文字列 | データクラスの名称。 | +| __COUNT | 数値 | データクラスに含まれる全エンティティ数 | | __SENT | 数値 | RESTリクエストが返すエンティティの数。 総エンティティ数が `$top/$limit` で指定された数より少なければ、総エンティティの数になります。 | | __FIRST | 数値 | セレクションの先頭エンティティの番号。 デフォルトでは 0; または `$skip` で指定された値。 | | __ENTITIES | コレクション | エンティティ毎にその属性をすべて格納したオブジェクトのコレクションです。 リレーション属性は、リレーション先の情報を取得するための URI を格納したオブジェクトとして返されます。 | @@ -47,11 +47,11 @@ RESTリクエストにこのパラメーターのみを渡すと、( 各エンティティには次のプロパティが含まれます: -| プロパティ | タイプ | 説明 | -| ----------- | --- | --------------------------------------------------- | -| __KEY | 文字列 | Value of the primary key defined for the dataclass. | -| __TIMESTAMP | 日付 | エンティティが最後に編集された日時を記録するタイムスタンプ | -| __STAMP | 数値 | `$method=update` を使ってエンティティの属性値を更新するときに必要となる内部スタンプ | +| プロパティ | タイプ | 説明 | +| ----------- | --- | -------------------------------------------------- | +| __KEY | 文字列 | データクラスにおいて定義されているプライマリーキーの値 | +| __TIMESTAMP | 日付 | エンティティが最後に編集された日時を記録するタイムスタンプ | +| __STAMP | 数値 | `$method=update` を使ってエンティティの属性値を更新するときに必要となる内部スタンプ | 取得する属性を指定するには、次のシンタックスを使っておこないます: [{attribute1, attribute2, ...}](manData.md#取得する属性の選択)。 たとえば: @@ -64,7 +64,7 @@ RESTリクエストにこのパラメーターのみを渡すと、( ### 例題 -Return all the data for a specific dataclass. +特定のデータクラスの全データを取得します。 `GET /rest/Company` @@ -161,7 +161,7 @@ Return all the data for a specific dataclass. ### 説明 -データクラスとキーを渡すことで、公開されているエンティティの情報を取得することができます。 The key is the value in the attribute defined as the Primary Key for your dataclass. プライマリーキーの定義についての詳細は、デザインリファレンスマニュアルの **[主キーを設定、削除する](https://doc.4d.com/4Dv18/4D/18/Table-properties.300-4575566.ja.html#1282230)** を参照ください。 +データクラスとキーを渡すことで、公開されているエンティティの情報を取得することができます。 キー (key) は、データクラスに定義されているプライマリーキーの値です。 プライマリーキーの定義についての詳細は、デザインリファレンスマニュアルの **[主キーを設定、削除する](https://doc.4d.com/4Dv18/4D/18/Table-properties.300-4575566.ja.html#1282230)** を参照ください。 返されるデータについての詳細は [{dataClass}](#dataclass) を参照ください。 @@ -169,7 +169,7 @@ Return all the data for a specific dataclass. `GET /rest/Company(1)/name,address` -If you want to expand a relation attribute using `$expand`, you do so by specifying it as shown below: +`$expand` を使ってリレーション属性を展開するには、次のように指示します: `GET /rest/Company(1)/name,address,staff?$expand=staff` @@ -177,7 +177,7 @@ If you want to expand a relation attribute using `$expand`, you do so by specify ### 例題 -The following request returns all the public data in the Company dataclass whose key is 1. +次のリクエストは、Company データクラスで主キーが 1 であるエンティティの公開データをすべて返します。 `GET /rest/Company(1)` @@ -219,7 +219,7 @@ The following request returns all the public data in the Company dataclass whose ### 説明 -By passing the *dataClass* and an *attribute* along with a value, you can retrieve all the public information for that entity. The value is a unique value for attribute, but is not the primary key. +*dataClass* に加えて *attribute (属性)* および *value (値)*を渡すことで、当該エンティティの公開データをすべて取得できます。 指定する値は、その属性において一意のものですが、主キーではありません。 `GET /rest/Company:companyCode(Acme001)` @@ -227,7 +227,7 @@ By passing the *dataClass* and an *attribute* along with a value, you can retrie `GET /rest/Company:companyCode(Acme001)/name,address` -If you want to use a relation attribute using [$attributes]($attributes.md), you do so by specifying it as shown below: +[$attributes]($attributes.md) を使ってリレーション属性を使用するには、次のように指示します: `GET /rest/Company:companyCode(Acme001)?$attributes=name,address,staff.name` @@ -235,7 +235,7 @@ If you want to use a relation attribute using [$attributes]($attributes.md), you ### 例題 -The following request returns all the public data of the employee named "Jones". +次のリクエストは、名前が "Jones" である社員 (Employee) の公開データをすべて返します。 `GET /rest/Employee:lastname(Jones)` diff --git a/website/translated_docs/pt/API/classClass.md b/website/translated_docs/pt/API/classClass.md index 1af48114579a7c..6a926f60614e49 100644 --- a/website/translated_docs/pt/API/classClass.md +++ b/website/translated_docs/pt/API/classClass.md @@ -52,12 +52,13 @@ This property is **read-only**. -**.new()** : 4D.Class +**.new**( *param* : any { *;...paramN* } ) : 4D.Class -| Parameter | Type | | Description | -| --------- | -------- |:--:| ----------------------- | -| Result | 4D.Class | <- | New object of the class | +| Parameter | Type | | Description | +| --------- | -------- |:--:| ------------------------------------------------ | +| param | any | -> | Parameter(s) to pass to the constructor function | +| Result | 4D.Class | <- | New object of the class | @@ -65,19 +66,40 @@ This property is **read-only**. The `.new()` function creates and returns a `cs.className` object which is a new instance of the class on which it is called. This function is automatically available on all classes from the [`cs` class store](Concepts/classes.md#cs). -If it is called on a non-existing class, an error is returned. +You can pass one or more optional *param* parameters, which will be passed to the [class constructor](Concepts/classes.md#class-constructor) function (if any) in the className class definition. Within the constructor function, the [`This`](Concepts/classes.md#this) is bound to the new object being constructed. +If `.new()` is called on a non-existing class, an error is returned. -#### Example +#### Examples To create a new instance of the Person class: ```4d var $person : cs.Person $person:=cs.Person.new() //create the new instance -//$Person contains functions of the class +//$person contains functions of the class +``` + +To create a new instance of the Person class with parameters: + +```4d +//Class: Person.4dm +Class constructor($firstname : Text; $lastname : Text; $age : Integer) + This.firstName:=$firstname + This.lastName:=$lastname + This.age:=$age ``` +```4d +//In a method +var $person : cs.Person +$person:=cs.Person.new("John";"Doe";40) +//$person.firstName = "John" +//$person.lastName = "Doe" +//$person.age = 40 +``` + + diff --git a/website/translated_docs/pt/Concepts/classes.md b/website/translated_docs/pt/Concepts/classes.md index 2bba6eff1a6482..270f142b940af7 100644 --- a/website/translated_docs/pt/Concepts/classes.md +++ b/website/translated_docs/pt/Concepts/classes.md @@ -19,14 +19,19 @@ For example, you could create a `Person` class with the following definition: Class constructor($firstname : Text; $lastname : Text) This.firstName:=$firstname This.lastName:=$lastname + +Function sayHello()->$welcome : Text + $welcome:="Hello "+This.firstName+" "+This.lastName ``` In a method, creating a "Person": ``` -var $o : cs.Person //object of Person class -$o:=cs.Person.new("John";"Doe") -// $o:{firstName: "John"; lastName: "Doe" } +var $person : cs.Person //object of Person class +var $hello : Text +$person:=cs.Person.new("John";"Doe") +// $person:{firstName: "John"; lastName: "Doe" } +$hello:=$person.sayHello() //"Hello John Doe" ``` @@ -39,7 +44,7 @@ A user class in 4D is defined by a specific method file (.4dm), stored in the `/ When naming classes, you should keep in mind the following rules: -- A class name must be compliant with [property naming rules](Concepts/dt_object.md#object-property-identifiers). +- A [class name](identifiers.md#classes) must be compliant with [property naming rules](identifiers.md#object-properties). - Class names are case sensitive. - Giving the same name to a class and a database table is not recommended, in order to prevent any conflict. @@ -81,7 +86,7 @@ To create a new class, you can: #### Class code support -In the various 4D Developer windows (code editor, compiler, debugger, runtime explorer), class code is basically handled like a project method with some specificities: +In the various 4D windows (code editor, compiler, debugger, runtime explorer), class code is basically handled like a project method with some specificities: - In the code editor: - a class cannot be run @@ -136,10 +141,8 @@ $key:=4D.CryptoKey.new(New object("type";"ECDSA";"curve";"prime256v1")) -## Using classes in your code - -### Class object +## Class object When a class is [defined](#class-definition) in the project, it is loaded in the 4D language environment. A class is an object itself, of ["Class" class](API/classClass.md). A class object has the following properties and function: @@ -147,46 +150,23 @@ When a class is [defined](#class-definition) in the project, it is loaded in the - [`superclass`](API/classClass.md#superclass) object (null if none) - [`new()`](API/classClass.md#new) function, allowing to instantiate class objects. -In addition, a class object can reference: - -- a [`constructor`](#class-constructor) object (optional), -- a `prototype` object, containing named [function](#function) objects (optional). +In addition, a class object can reference a [`constructor`](#class-constructor) object (optional). A class object is a [shared object](shared.md) and can therefore be accessed from different 4D processes simultaneously. +### Inheritance +If a class inherits from another class (i.e. the [Class extends](classes.md#class-extends-classname) keyword is used in its definition), the parent class is its [`superclass`](API/classClass.md#superclass). -### Property lookup and prototype - -All objects in 4D are internally linked to a class object. When 4D does not find a property in an object, it searches in the prototype object of its class; if not found, 4D continues searching in the prototype object of its superclass, and so on until there is no more superclass. - -All objects inherit from the class "Object" as their inheritance tree top class. - -```4d -//Class: Polygon -Class constructor($width : Integer; $height : Integer) - This.area:=$width*$height - - //var $poly : Object - var $instance : Boolean - $poly:=cs.Polygon.new(4;3) - - $instance:=OB Instance of($poly;cs.Polygon) - // true - $instance:=OB Instance of($poly;4D.Object) - // true -``` - -When enumerating properties of an object, its class prototype is not enumerated. As a consequence, `For each` statement and `JSON Stringify` command do not return properties of the class prototype object. The prototype object property of a class is an internal hidden property. - +When 4D does not find a function or a property in a class, it searches it in its [`superclass`](API/classClass.md#superclass); if not found, 4D continues searching in the superclass of the superclass, and so on until there is no more superclass (all objects inherit from the "Object" superclass). ## Class keywords Specific 4D keywords can be used in class definitions: -- `Function ` to define member methods of the objects. -- `Class constructor` to define the properties of the objects (i.e. the prototype). +- `Function ` to define class functions of the objects. +- `Class constructor` to define the properties of the objects. - `Class extends ` to define inheritance. @@ -199,9 +179,9 @@ Function ({$parameterName : type; ...}){->$parameterName : type} // code ``` -Class functions are properties of the prototype object of the owner class. They are objects of the "Function" class. +Class functions are specific properties of the class. They are objects of the [4D.Function](API/formulaClass.md#about-4dfunction-objects) class. -In the class definition file, function declarations use the `Function` keyword, and the name of the function. The function name must be compliant with [property naming rules](Concepts/dt_object.md#object-property-identifiers). +In the class definition file, function declarations use the `Function` keyword, and the name of the function. The function name must be compliant with [property naming rules](Concepts/identifiers.md#object-properties). > **Tip:** Starting the function name with an underscore character ("_") will exclude the function from the autocompletion features in the 4D code editor. For example, if you declare `Function _myPrivateFunction` in `MyClass`, it will not be proposed in the code editor when you type in `"cs.MyClass. "`. @@ -227,9 +207,9 @@ For a class function, the `Current method name` command returns: "*\. In the application code, class functions are called as member methods of the object instance and can receive [parameters](#class-function-parameters) if any. The following syntaxes are supported: - use of the `()` operator. For example, `myObject.methodName("hello")` -- use of a "Function" class member method: - - `apply()` - - `call()` +- use of a "4D.Function" class member method: + - [`apply()`](API/formulaClass.md#apply) + - [`call()`](API/formulaClass.md#call) > **Thread-safety warning:** If a class function is not thread-safe and called by a method with the "Can be run in preemptive process" attribute: - the compiler does not generate any error (which is different compared to regular methods), - an error is thrown by 4D only at runtime. @@ -238,7 +218,7 @@ In the application code, class functions are called as member methods of the obj #### Parameters -Function parameters are declared using the parameter name and the parameter type, separated by a colon. The parameter name must be compliant with [property naming rules](Concepts/dt_object.md#object-property-identifiers). Multiple parameters (and types) are separated by semicolons (;). +Function parameters are declared using the parameter name and the parameter type, separated by a colon. The parameter name must be compliant with [property naming rules](Concepts/identifiers.md#object-properties). Multiple parameters (and types) are separated by semicolons (;). ```4d Function add($x; $y : Variant; $z : Integer; $xy : Object) @@ -306,7 +286,7 @@ Class Constructor({$parameterName : type; ...}) A class constructor function, which can accept [parameters](#parameters), can be used to define a user class. -In that case, when you call the `new()` class member method, the class constructor is called with the parameters optionally passed to the `new()` function. +In that case, when you call the [`new()`](API/classClass.md#new) function, the class constructor is called with the parameters optionally passed to the `new()` function. For a class constructor function, the `Current method name` command returns: "*\.constructor*", for example "MyClass.constructor". @@ -504,7 +484,7 @@ $o:=New object("prop";42;"f";Formula(This.prop)) $val:=$o.f() //42 ``` -When a [class constructor](#class-constructor) function is used (with the `new()` keyword), its `This` is bound to the new object being constructed. +When a [class constructor](#class-constructor) function is used (with the [`new()`](API/classClass.md#new) function), its `This` is bound to the new object being constructed. ```4d //Class: ob