Spécifie ce qui est collé. Spécifie ce qui est collé.Valeurs possibles :
| Valeur | Description |
|---|
vk clipboard options all (par défaut) | Colle tous les objets de données, y compris les valeurs, la mise en forme et les formules. | vk clipboard options formatting | Ne colle que la mise en forme.. | vk clipboard options formulas | Ne colle que les formules. | vk clipboard options formulas and formatting | Colle les formules et la mise en forme. | vk clipboard options values | Ne colle que les valeurs. | vk clipboard options value and formatting | Copie les valeurs et la mise en forme. |
Les options de collage définies dans workbook options sont prises en compte.
Pour copier le contenu, les valeurs, le formatage et les formules d'une plage d'origine :
var $originRange; $targetRange; $options : Object
$originRange:=VP Cells("ViewProArea"; 0; 0; 2; 5)
$targetRange:=VP Cells("ViewProArea"; 4; 0; 2; 5)
$options:=New object
$options.copy:=True
$options.pasteOptions:=vk clipboard options all
VP MOVE CELLS($originRange; $targetRange; $options)
VP Copy to object
VP PASTE FROM OBJECT
VP SET WORKBOOK OPTIONS
VP Name ( vpAreaName : Text ; rangeName : Text { ; sheet : Integer } ) : Object
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | rangeName | Text | -> | Cet exemple de code copie d'abord le contenu, valeurs, formats et formules d'une plage dans un objet puis les colle dans une autre plage : | | sheet | Integer | -> | Résultat: | | Résultat | Object | <- | Plage nommée |
La commande VP Name retourne un nouvel objet plage faisant référence à une plage nommée.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Le paramètre rangeName spécifie une plage de cellules nommée existante.
Dans le paramètre optionnel sheet, vous pouvez désigner une feuille de calcul spécifique où rangeName est défini. Si le paramètre est omis, la feuille courante est utilisée par défaut. Vous pouvez sélectionner explicitement la feuille courante ou l'intégralité du classeur (workbook) à l'aide des constantes suivantes :
vk current sheetvk workbook
Vous souhaitez assigner une valeur à une plage nommée "Total".
// nommer la cellule B5 Total
VP ADD RANGE NAME(VP Cell("ViewProArea";1;4);"Total")
$name:=VP Name("ViewProArea";" Total")
VP SET NUM VALUE($name;285;"$#,###.00")
VP ADD RANGE NAME
VP ALL
VP Cell
VP Cells
VP Column
VP Combine ranges
VP Get names
VP REMOVE NAME
VP Row
VP NEW DOCUMENT ( vpAreaName : Text )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro |
La commande VP NEW DOCUMENT charge et affiche un nouveau document par défaut dans l'objet zone de formulaire 4D View Pro vpAreaName. Le nouveau document vide remplace toutes les données auparavant insérées dans la zone.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Vous souhaitez afficher un document vide dans l'objet formulaire "myVPArea" :
VP NEW DOCUMENT("myVPArea")
VP IMPORT DOCUMENT
VP Object to font ( fontObj : Object ) : Text
| Paramètres | Type | | Description |
|---|
| fontObj | Object | -> | Notes sur le format de fichier SpreadJS: | | Résultat | Text | <- | Police raccourcie (shorthand) |
La commande VP Object to font retourne une chaîne de raccourci de police de fontObj.
Dans fontObj, passez un objet contenant les propriétés de police. Les propriétés suivantes sont prises en charge :
| Propriété | Type | Description | Valeurs possibles | Obligatoire |
|---|
| family | text | Définit la police. | tout type de famille de police standard ou générique. Ex : Ex : Ex : "Arial", "Helvetica", "serif", "arial,sans-serif" | Oui | | size | text | Le line-height peut être ajouté au font-size : font-size/line-height : Ex : "15pt/20pt" | un nombre avec l'une des unités suivantes : "em", "ex", "%", "px", "cm", "mm", "in", "pt", "pc", "ch", "rem", "vh", "vw", "vmin", "vmax"ou l'une des constantes suivantes :vk font size largevk font size largervk font size x largevk font size xx largevk font size smallvk font size smallervk font size x smallvk font size xx small | Oui | | style | text | Style de police. | vk font style italicvk font style oblique | Non | | variant | text | Police en petites majuscules. | vk font variant small caps | Non | | weight | text | Définit l'épaisseur de la police. | vk font weight 100vk font weight 200vk font weight 300vk font weight 400vk font weight 500vk font weight 600vk font weight 700vk font weight 800vk font weight 900vk font weight boldvk font weight boldervk font weight lighter | Non |
Cet objet peut être créé à l'aide de la commande VP Font to object.
La chaîne raccourcie retournée peut être affectée à la propriété "font" d'une cellule avec VP SET CELL STYLE, par exemple.
$cellStyle:=VP Get cell style($range)
$font:=VP Font to object($cellStyle.font)
$font.style:=vk font style oblique
$font.variant:=vk font variant small caps
$font.weight:=vk font weight bolder
$cellStyle.font:=VP Object to font($font)
///$cellStyle.font contient "bolder oblique small-caps 16pt arial"
4D View Pro Style Objects and Style Sheets
VP Font to object
VP SET CELL STYLE
VP SET DEFAULT STYLE
Historique
| Release | Modifications |
|---|
| 19 R4 | Ajout |
VP PASTE FROM OBJECT ( rangeObj : Object ; dataObject : Object {; options : Integer} )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Pour lire les détails du style par défaut de ce document : | | dataObject | Object | -> | Objet contenant les données à coller | | options | Integer | -> | Spécifie ce qui est collé |
La commande VP PASTE FROM OBJECT colle les contenus, styles et formules stockés dans dataObject dans l'objet rangeObj.
Dans rangeObj, passez l'objet de plage de cellules dans lequel les valeurs, le formatage et/ou les cellules de formule seront collés. Si rangeObj fait référence à plusieurs cellules, seule la première est utilisée.
Dans dataObject, passez l'objet qui contient les données de la cellule, la mise en forme et les formules à coller.
Dans le paramètre facultatif options, vous pouvez spécifier ce qu'il faut coller dans la plage de cellules. Valeurs possibles :
| Constante | Description |
|---|
vk clipboard options all | Colle tous les objets de données, y compris les valeurs, la mise en forme et les formules. | vk clipboard options formatting | Ne colle que la mise en forme. | vk clipboard options formulas | Colle uniquement les formules. | vk clipboard options formulas and formatting | Colle les formules et la mise en forme. | vk clipboard options values | Ne colle que les valeurs. | vk clipboard options value and formatting | Colle les valeurs et la mise en forme. |
Les options de collage définies dans workbook options sont prises en compte.
Si options fait référence à une option de collage qui n'est pas présente dans l'objet copié (par exemple, les formules), la commande ne fait rien.
Voir l'exemple de VP Copy to object
VP Copy to object
VP MOVE CELLS
VP Get workbook options
VP SET WORKBOOK OPTIONS
VP PRINT ( vpAreaName : Text { ; sheet : Integer } )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP PRINT ouvre une fenêtre de dialogue d'impression pour imprimer vpAreaName.
Passez la zone 4D View Pro à imprimer dans vpAreaName. La commande ouvrira la fenêtre de dialogue d'impression permettant de définir l'imprimante et les propriétés de la page.
Les propriétés définies dans la fenêtre de dialogue d'impression concernent le papier de l'imprimante, ce ne sont pas les propriétés d'impression de la zone 4D View Pro. Printing properties for 4D View Pro areas are defined using the VP SET PRINT INFO command. Il est fortement recommandé que les propriétés de l'imprimante et de la zone 4D View Pro correspondent, sinon le document imprimé pourrait ne pas correspondre à vos attentes.
Dans le paramètre optionnel sheet, vous pouvez définir une feuille (sheet) spécifique à imprimer (la numérotation démarre à zéro). S'il est omis, la feuille courante est utilisée par défaut. Vous pouvez sélectionner explicitement la feuille courante ou le workbook entier à l'aide des constantes suivantes :
vk current sheetvk workbook
- Les zones 4D View Pro ne peuvent être imprimées qu'avec la commande
VP PRINT.
- Les commandes du thème de langage 4D Printing ne sont pas supportées par
VP PRINT.
- Cette commande est destinée à l'impression individuelle par l'utilisateur final. Pour les tâches d'impression automatisés, il est conseillé d'exporter la zone 4D View Pro en format PDF avec la méthode [VP EXPORT DOCUMENT] (#vp-export-document).
Le code suivant :
... ouvrira une fenêtre de dialogue d'impression :
VP EXPORT DOCUMENT
VP SET PRINT INFO
VP RECOMPUTE FORMULAS ( vpAreaName : Text )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro |
La commande VP RECOMPUTE FORMULAS évalue immédiatement toutes les formules dans vpAreaName. . Par défaut, 4D calcule automatiquement les formules lorsqu'elles sont insérées, importées ou exportées. VP RECOMPUTE FORMULAS vous permet de forcer le calcul à tout moment (par exemple, si des modifications sont apportées aux formules ou si les formules contiennent des appels à la base de données). La commande lance l'exécution de la commande VP FLUSH COMMANDS pour exécuter toutes les commandes stockées et vider le buffer de commandes, puis calcule toutes les formules du classeur.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Assurez-vous que la commande VP SUSPEND COMPUTING n'a pas été exécutée avant d'utiliser VP RECOMPUTE FORMULAS, sinon la commande ne fait rien.
Pour actualiser toutes les forumules du workbook, saisissez le code suivant :
VP RECOMPUTE FORMULAS("ViewProArea")
VP RESUME COMPUTING
VP SUSPEND COMPUTING
VP REMOVE NAME ( vpAreaName : Text ; name : Text { ; scope : Integer } )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | name | Text | -> | Résultat: | | scope | Integer | -> | "Scope" cible (par défaut=feuille courante) |
La commande VP REMOVE NAME supprime la plage nommée ou la formule nommée passée dans le paramètre name dans le scope défini.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Passez la plage nommée ou la formule nommée que vous voulez supprimer avec name.
Vous pouvez définir où supprimer le nom dans scope en utilisant soit l'index de la feuille (le comptage commence à 0), soit les constantes suivantes :
vk current sheetvk workbook
$range:=VP Cell("ViewProArea";0;0)
VP ADD RANGE NAME("Total1";$range)
VP REMOVE NAME("ViewProArea";"Total1")
$formula:=VP Get formula by name("ViewProArea";"Total1")
//$formula=null
VP Name
VP REMOVE SHEET ( vpAreaName : Text ; index: Integer )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | index | Integer | -> | Index de la feuille à supprimer |
VP ADD SHEET
La commande VP REMOVE SHEET supprime la feuille avec l'index spécifié du document chargé dans vpAreaName.
Dans vpAreaName, passez le nom de la zone 4D View Pro.
Dans index, passez l'index de la feuille à supprimer. Si le index passé n'existe pas, la commande ne fait rien.
La numérotation démarre à 0.
Le document comporte actuellement 3 feuilles :
Supprimer la troisième feuille :
VP REMOVE SHEET("ViewProArea";2)
VP REMOVE SPAN ( rangeObj : Object )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage |
La commande VP REMOVE SPAN supprime la portée (span) des cellules dans rangeObj.
Dans rangeObj, passez un objet plage de la portée de la cellule. Les cellules fusionnées de la plage sont divisées en cellules individuelles.
Pour retirer toutes les fusions de cellules de ce document :
//identifier toutes les cellules fusionnées
$span:=VP Get spans(VP All("ViewProArea"))
//retirer les fusions
VP REMOVE SPAN($span)
Résultat:
VP ADD SPAN
VP Get spans
VP REMOVE STYLESHEET ( vpAreaName : Text ; styleName : Text { ; sheet : Integer } )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | styleName | Text | -> | Indique si les formules doivent être calculées uniquement lorsqu'elles sont demandées, la valeur par défaut est faux. | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP REMOVE STYLESHEET supprime la feuille de style passée dans le styleName du vpAreaName.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Passez la feuille de style à supprimer dans le paramètre styleName.
Vous pouvez définir, dans le paramètre optionnel sheet, l'emplacement dans lequel vous souhaitez supprimer le style, à l'aide de l'indice de la feuille (la numérotation commence à partir de 0) ou à l'aide des constantes suivantes :
vk current sheetvk workbook
Pour supprimer l'objet de style GreenDashDotStyle de la feuille courante :
VP REMOVE STYLESHEET("ViewProArea";"GreenDashDotStyle")
VP ADD STYLESHEET
VP Get stylesheet
VP Get stylesheets
Historique
| Release | Modifications |
|---|
| 19 R6 | Ajout |
VP REMOVE TABLE ( vpAreaName : Text; tableName : Text {; options : Integer} {; sheet : Integer} )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Résultat: | | tableName | Text | -> | $param:=New collection
$param.push(New collection(1;2;3;False)) //première ligne, 4 valeurs
$param.push(New collection) //deuxième ligne, inchangé
$param.push(New collection(4;5;Null;"hello";"world")) // troisième ligne, 5 valeurs
$param.push(New collection(6;7;8;9)) // quatrième ligne, 4 valeurs
$param.push(New collection(Null;New object("value";Current date;"time";42))) //cinquième ligne, 1 valeur
VP SET VALUES(VP Cell("ViewProArea";2;1);$param) | | options | Integer | -> | Options supplémentaires | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP REMOVE TABLE supprime une table que vous avez créée avec VP CREATE TABLE.
Dans vpAreaName, passez le nom de la zone contenant la table à supprimer.
Dans tableName, passez le nom de la table à supprimer.
Dans les options, vous pouvez spécifier des comportements supplémentaires. Valeurs possibles :
| Constante | Valeur | Description |
|---|
| vk table remove all | 0 | Tput supprimer y compris le style et les données | | vk table remove style | 1 | Supprimer le style mais conserver les données | | vk table remove data | 2 | Supprimer les données mais conserver le style |
Les noms des tables sont définis au niveau de la feuille. Vous pouvez spécifier où se trouve la table en utilisant le paramètre facultatif sheet (la numérotation commence à 0).
Pour supprimer la table "people" dans la deuxième feuille et conserver les données dans les cellules :
VP REMOVE TABLE("ViewProArea"; "people"; vk table remove style; 2)
VP CREATE TABLE
Historique
| Release | Modifications |
|---|
| 19 R7 | Ajout |
VP REMOVE TABLE COLUMNS ( vpAreaName : Text ; tableName : Text ; column : Integer {; count : Integer {; sheet : Integer }} )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | tableName | Text | -> | Nom de table | | column | Integer | -> | Indice dans la table de la colonne de départ à supprimer | | count | Text | -> | Nombre de colonnes à supprimer (doit être >0) | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP REMOVE TABLE COLUMNS supprime une ou count colonne(s) dans la tableName spécifiée à l'index column spécifié. La commande supprime les valeurs et les styles.
La commande supprime les colonnes de la table tableName, PAS de la feuille. Le nombre total de colonnes de la feuille n'est pas impacté par la commande. Le nombre total de colonnes de la feuille n'est pas impacté par la commande.
Si tableName n'existe pas, rien ne se passe.
Pour supprimer deux colonnes à partir de la 3ème colonne de la table "dataTable" :
VP REMOVE TABLE COLUMNS("ViewProArea"; "dataTable"; 3; 2)
VP INSERT TABLE COLUMNS
VP REMOVE TABLE ROWS
Historique
| Release | Modifications |
|---|
| 19 R7 | Ajout |
VP REMOVE TABLE ROWS ( vpAreaName : Text ; tableName : Text ; row : Integer {; count : Integer {; sheet : Integer }} )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | tableName | Text | -> | Nom de table | | row | Integer | -> | Indice dans la table de la ligne de départ à supprimer | | count | Text | -> | Nombre de lignes à supprimer (doit être >0) | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP REMOVE TABLE ROWS supprime une ou count ligne(s) de la tableName spécifiée à l'index row spécifié. La commande supprime les valeurs et les styles.
Cette commande supprime les lignes de la table tableName, PAS de la feuille. Le nombre total de lignes de la feuille n'est pas impacté par la commande. Le nombre total de lignes de la feuille n'est pas impacté par la commande.
Vous avez ajouté deux boutons au formulaire afin que l'utilisateur puisse suspendre/reprendre les calculs :
Si tableName n'existe pas, rien ne se passe.
Pour supprimer deux lignes à partir de la 3e ligne de la table "dataTable" :
VP REMOVE TABLE ROWS("ViewProArea"; "dataTable"; 3; 2)
VP INSERT TABLE ROWS
VP REMOVE TABLE COLUMNS
VP RESET SELECTION ( vpAreaName : Text { ; sheet : Integer } )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP RESET SELECTION désélectionne toutes les cellules, ce qui entraîne l'absence de sélection courante ou de cellule active visible.
Une cellule active par défaut (cellule A1) reste définie pour les commandes 4D View Pro.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Dans le paramètre optionnel sheet, vous pouvez désigner une feuille spécifique dans laquelle sera définie la plage (la numérotation commence à zéro). Si le paramètre est omis, la feuille courante est utilisée par défaut. Vous pouvez sélectionner explicitement la feuille courante à l'aide de la constante suivante :
Vous souhaitez déselectionner toutes les cellules (la cellule active et toute autre cellule sélectionée) :
VP RESET SELECTION("myVPArea")
VP ADD SELECTION
VP Get active cell
VP Get selection
VP SET ACTIVE CELL
VP SET SELECTION
VP SHOW CELL
Historique
| Release | Modifications |
|---|
| 19 R7 | Ajout |
VP RESIZE TABLE ( rangeObj : Object; tableName : Text )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Une erreur est retournée si le paramètre filePath est invalide, ou si le fichier est manquant ou mal-formé. | | tableName | Text | -> | Nom de la table |
La commande VP RESIZE TABLE modifie la taille de la tableName par rapport à rangeObj.
Les règles suivantes s'appliquent :
- Les en-têtes doivent rester dans la même ligne et la plage de table résultante doit chevaucher la plage de table originale.
- Si le nombre de lignes de la table redimensionnée est inférieur au nombre de lignes initiales, les valeurs à l'intérieur des lignes ou colonnes recadrées sont conservées si elles n'étaient pas liées à un contexte de données, sinon elles sont supprimées.
- Si la table se développe sur des cellules contenant des données :
- si des lignes sont ajoutées, les données sont supprimées,
- si des colonnes sont ajoutées, les données sont conservées et affichées dans de nouvelles colonnes.
Si tableName n'existe pas, rien ne se passe.
Vous créez une table avec un contexte de données :
var $context : Object
$context:=New object()
$context.col:=New collection
$context.col.push(New object("name"; "Smith"; "salary"; 10000))
$context.col.push(New object("name"; "Wesson"; "salary"; 50000))
$context.col.push(New object("name"; "Gross"; "salary"; 10500))
VP SET DATA CONTEXT("ViewProArea"; $context)
VP CREATE TABLE(VP Cells("ViewProArea"; 1; 1; 3; 3); "PeopleTable"; "col")
Vous voulez ajouter une colonne avant et après la table ainsi que deux lignes vides. Vous pouvez écrire :
VP RESIZE TABLE(VP Cells("ViewProArea"; 0; 1; 4; 6); "PeopleTable")
VP CREATE TABLE
VP Get table range
VP RESUME COMPUTING ( vpAreaName : Text )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro |
La commande VP RESUME COMPUTING relance le calcul des formules dans vpAreaName.
La commande réactive le service de calcul de 4D View Pro. Toutes les formules impactées par les changements effectués pendant que les calculs étaient suspendus sont mises à jour, et les formules ajoutées après l'exécution de VP RESUME COMPUTING sont calculées.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Le service de calcul de 4D View Pro maintient un compteur d'actions de suspension/reprise. Par conséquent, chaque exécution de VP RESUME COMPUTING doit être équilibrée par une exécution correspondante de la commande VP SUSPEND COMPUTING.
Voir l'exemple dans VP SUSPEND COMPUTING.
VP RECOMPUTE FORMULAS
VP SUSPEND COMPUTING
VP Row ( vpAreaName : Text; row : Integer { ; rowCount : Integer { ; sheet : Integer } } ) : Object
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | row | Integer | -> | Indice de la ligne | | rowCount | Integer | -> | Nombre de lignes | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) | | Résultat | Object | <- | Plage de ligne(s) |
La commande VP Row retourne un nouvel objet plage référençant une ou plusieurs lignes spécifiques.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Le paramètre row définit la première ligne de la plage de lignes. Passez l'indice de la ligne (la numérotation commence à zéro) dans ce paramètre. rowCount doit être supérieur à 0.
Le paramètre optionnel rowCount vous permet de définir le nombre total de lignes comprises dans la plage. rowCount doit être supérieur à 0. Si omis, la valeur sera définie à 1 par défaut.
Dans le paramètre optionnel sheet, vous pouvez désigner une feuille spécifique dans laquelle sera définie la plage (la numérotation commence à zéro). Si le paramètre est omis, la feuille courante est utilisée par défaut. Vous pouvez sélectionner explicitement la feuille courante à l'aide de la constante suivante :
Vous souhaitez définir une plage pour la ligne ci-dessous (dans la feuille courante) :
Vous pouvez écrire :
$row:=VP Row("ViewProArea";9) // row 10
VP All
VP Cell
VP Cells
VP Column
VP Combine ranges
VP Name
VP ROW AUTOFIT ( rangeObj : Object)
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage |
La commande VP ROW AUTOFIT dimensionne automatiquement les ligne(s) de rangeObj en fonction de leur contenu.
Dans rangeObj, passez un objet plage contenant une plage de lignes dont la taille sera automatiquement gérée.
Les lignes suivantes n'affichent pas correctement le texte :
VP ROW AUTOFIT(VP Row("ViewProArea";1;2))
Résultat:
VP Column autofit
VP Run offscreen area ( parameters : Object) : Mixed
| Paramètres | Type | | Description |
|---|
| parameters | Object | -> | Objet contenant les attributs de la zone hors écran | | Résultat | Mixed | <- | La propriété .result de l'objet .onEvent, ou Null si aucune valeur n'est retournée |
La commande VP Run offscreen area crée une zone hors écran en mémoire qui peut être utilisée pour traiter les commandes et les fonctions de la zone 4D View Pro.
Dans l'objet parameters, passez une ou plusieurs des propriétés optionnelles suivantes. Ces propriétés seront accessibles via la commande This au sein de la méthode onEvent et feront référence à l'instance :
| Propriété | Type | Description |
|---|
| area | text | Le nom de la zone hors écran. S'il est omis ou null, un nom générique est assigné (ex : OffscreenArea1). | | onEvent | objet (formula) | Une méthode callback qui sera lancée lorsque la zone hors écran sera prête. Il peut s'agir soitd'une fonction onEvent d'une classe,soit d'un objet Formula.Par défaut, la méthode de rappel est appelée lors de l'événement On VP Ready, On Load, On Unload, On End URL Loading, On URL Loading Error, On VP Range Changed ou On Timer. La méthode de rappel peut être utilisée pour accéder à la variable de l'objet de formulaire 4D View Pro. | | autoQuit | boolean | True (valeur par défaut) si la commande doit interrompre l'exécution de la formule lorsque les événements On End URL Loading ou On URL Loading Error sont générés. Si False, vous devez utiliser les commandes CANCEL ou ACCEPT dans la méthode callback onEvent. | | timeout | number | Durée maximale (exprimée en secondes) avant la fermeture de la zone si aucun événement n'est généré. Si elle est fixée à 0, aucune limitation n'est appliquée. Valeur par défaut : 60 | | Résultat | mixte | Résultat du traitement (le cas échéant) | <customProperty> | mixte | Tout attribut personnalisé qui sera disponible dans la méthode callback onEvent. |
La propriété suivante est automatiquement ajoutée par la commande, si nécessaire :
| Propriété | Type | Description |
|---|
| timeoutReached | boolean | Ajouté avec la valeur vrai si le timeout a été dépassé |
La zone hors écran n'est disponible que lors de l'exécution de la commande VP Run offscreen area. Elle sera automatiquement détruite à la fin de l'exécution.
Les commandes suivantes peuvent être utilisées dans la méthode callback (de rétro-appel) :
ACCEPTCANCELSET TIMERWA Evaluate JavaScriptWA EXECUTE JAVASCRIPT FUNCTION
Vous souhaitez créer une zone 4D View Pro hors écran et lire la valeur d'une cellule :
// cs.OffscreenArea class declaration
Class constructor ($path : Text)
This.filePath:=$path
// This function will be called on each event of the offscreen area
Function onEvent()
Case of
:(FORM Event.code=On VP Ready)
VP IMPORT DOCUMENT(This.area;This.filePath)
This.result:=VP Get value(VP Cell(This.area;6;22))
ALERT("The G23 cell contains the value: "+String(This.result))
End case
La méthode callback OffscreenArea :
$o:=cs.OffscreenArea.new()
$result:=VP Run offscreen area($o)
Vous souhaitez charger un grand document hors écran, attendre que tous les calculs soient terminés et l'exporter au format PDF :
//cs.OffscreenArea class declaration
Class constructor($pdfPath : Text)
This.pdfPath:=$pdfPath
This.autoQuit:=False
This.isWaiting:=False
Function onEvent()
Case of
:(FORM Event.code=On VP Ready)
// Document import
VP IMPORT DOCUMENT(This.area;$largeDocument4VP)
This.isWaiting:=True
// Start a timer to verify if all calculations are finished.
// If during this period the "On VP Range Changed" is thrown, the timer will be restarted
// The time must be defined according to the computer configuration.
SET TIMER(60)
:(FORM Event.code=On VP Range Changed)
// End of calculation detected. Restarts the timer
If(This.isWaiting)
SET TIMER(60)
End if
:(FORM Event.code=On Timer)
// To be sure to not restart the timer if you call others 4D View command after this point
This.isWaiting:=False
// Stop the timer
SET TIMER(0)
// Start the PDF export
VP EXPORT DOCUMENT(This.area;This.pdfPath;New object("formula";Formula(ACCEPT)))
:(FORM Event.code=On URL Loading Error)
CANCEL
End case
La méthode callback OffscreenArea :
$o:=cs.OffscreenArea.new()
$result:=VP Run offscreen area($o)
Article de blog : Fin du chargement du document
VP SET ACTIVE CELL ( rangeObj : Object)
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage |
La commande VP SET ACTIVE CELL définit une cellule spécifiée comme active.
In rangeObj, pass a range containing a single cell as an object (see VP Cell). Si rangeObj n'est pas une plage de cellules ou contient plusieurs plages, la première cellule de la première plage est utilisée.
Le code suivant déterminera comme active la cellule de la colonne D, ligne 5 :
$activeCell:=VP Cell("myVPArea";3;4)
VP SET ACTIVE CELL($activeCell)
VP ADD SELECTION
VP Get active cell
VP Get selection
VP RESET SELECTION
VP SET SELECTION
VP SHOW CELL
VP SET ALLOWED METHODS ( methodObj : Object)
| Paramètres | Type | | Description |
|---|
| methodObj | Object | -> | Méthodes autorisées dans les zones 4D View Pro |
Compatibilité
For greater flexiblity, it is recommended to use the VP SET CUSTOM FUNCTIONS command which allows you to designate 4D formulas that can be called from 4D View Pro areas. Dès que VP SET CUSTOM FUNCTIONS est appelé, les appels de VP SET ALLOWED METHODS sont ignorés. 4D View Pro supporte également la commande générique SET ALLOWED METHODS de 4D si ni VP SET CUSTOM FUNCTIONS ni VP SET ALLOWED METHODS ne sont appelés, Cependant, l'utilisation de la commande générique n'est pas recommandée.
La commande VP SET ALLOWED METHODS désigne les méthodes projets qui peuvent être appelées dans des formules 4D View Pro. Cette commande s'applique à toutes les zones 4D View Pro qui ont été crées après l'appel de la commande durant la session. Elle peut être appelée à plusieurs reprises dans la même session pour créer différentes configurations.
Par défaut, pour des raisons de sécurité, si vous n'exécutez pas la commande VP SET ALLOWED METHODS, aucun appel de méthode n'est autorisé dans les zones de 4D View Pro -- sauf si la commande générique SET ALLOWED METHODS de 4D a été utilisée (voir la note de compatibilité). L'utilisation d'une méthode non autorisée dans une formule affiche une erreur #NAME? dans la zone 4D View Pro.
Dans le paramètre methodObj, passez un objet dans lequel chaque propriété est le nom d'une fonction à définir dans les zones 4D View Pro:
| Propriété | | | Type | Description |
|---|
<functionName> | | | Object | Description de la fonction personnalisée. Le nom de propriété <functionName> définit le nom de la fonction personnalisée à afficher dans les formules de 4D View Pro (les espaces ne sont pas autorisés) | | method | | Text | (obligatoire) Nom de la méthode projet 4D existante à autoriser | | parameters | | Collection d'objets | Collection de paramètres (dans l'ordre dans lequel ils sont définis dans la méthode). | | | [ ].name | Text | Nom du paramètre à afficher pour le <functionName>.Note : les noms de paramètres ne doivent pas contenir d'espaces. | | | [ ].type | Number | Type de paramètre. Supported types:Is BooleanIs dateIs IntegerIs objectIs realIs textIs timeIf omitted, by default the value is automatically sent with its type, except date or time values which are sent as an object (see Parameters section). If type is Is object, the object has the same structure as the object returned by VP Get value. | | summary | | Text | Description de la fonction à afficher dans 4D View Pro | | minParams | | Number | Nombre minimum de paramètres | | maxParams | | Number | Nombre maximum de paramètres. Si vous passez un nombre supérieur à la largeur de parameters, il est possible de déclarer des paramètres "optionnels" avec leur type par défaut |
Vous souhaitez autoriser deux méthodes dans vos zones 4D View Pro :
var $allowed : Object
$allowed:=New object //paramètre de la commande
$allowed.Hello:=New object //Créer une première fonction simple nommée "Hello"
$allowed.Hello.method:="My_Hello_Method" //définit la méthode 4D
$allowed.Hello.summary:="Hello prints hello world"
$allowed.Byebye:=New object //Créer une deuxième fonction avec des paramètres nommée "Byebye"
$allowed.Byebye.method:="My_ByeBye_Method"
$allowed.Byebye.parameters:=New collection
$allowed.Byebye.parameters.push(New object("name";"Message";"type";Is text))
$allowed.Byebye.parameters.push(New object("name";"Date";"type";Is date))
$allowed.Byebye.parameters.push(New object("name";"Time";"type";Is time))
$allowed.Byebye.summary:="Byebye prints a custom timestamp"
$allowed.Byebye.minParams:=3
$allowed.Byebye.maxParams:=3
VP SET ALLOWED METHODS($allowed)
Une fois ce code exécuté, les fonctions définies peuvent être utilisées dans des formules 4D View Pro :
Dans les formules de 4D View Pro, les noms des fonctions sont automatiquement affichés en majuscules.
4D functions
VP SET CUSTOM FUNCTIONS
Historique
| Release | Modifications |
|---|
| 19 R5 | Ajout |
VP SET BINDING PATH ( rangeObj : Object ; dataContextAttribute : Text)
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | dataContextAttribute | Text | -> | Nom de l'attribut à lier à rangeObj |
La commande VP SET BINDING PATH lie un attribut du contexte de données d'une feuille à rangeObj. After you set a data context using the SET DATA CONTEXT method. Lors du chargement, si le contexte de données contient l'attribut, la valeur de dataContextAttribute est automatiquement affichée dans les cellules de rangeObj.
Dans rangeObj, passez un objet qui est soit une plage de cellules, soit une plage combinée de cellules.
- Si rangeObj est une plage avec plusieurs cellules, la commande lie l'attribut à la première cellule de la plage.
- Si rangeObj contient plusieurs plages de cellules, la commande lie l'attribut à la première cellule de chaque plage.
Dans dataContextAttribute, passez le nom de l'attribut à lier à rangeObj. Si dataContextAttribute est une chaîne vide, la fonction supprime la liaison courante.
Les attributs de type collection ne sont pas pris en charge. Lorsque vous passez le nom d'un attribut de collection, la commande ne fait rien.
Définir un contexte de données et lier les attributs firstName et lastName aux cellules :
var $p : Object
$p:=New object
$p.firstName:="Freehafer"
$p.lastName:="Nancy"
VP SET DATA CONTEXT("ViewProArea"; $p)
VP SET BINDING PATH(VP Cell("ViewProArea"; 0; 0); "firstName")
VP SET BINDING PATH(VP Cell("ViewProArea"; 1; 0); "lastName")
VP Get binding path
VP Get data context
VP SET DATA CONTEXT
VP SET BOOLEAN VALUE ( rangeObj : Object ; boolValue : Boolean)
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | boolValue | Boolean | -> | Valeur du booléen à fixer |
La commande VP SET BOOLEAN VALUE assigne une valeur booléenne spécifiée à une plage de cellules désignées.
In rangeObj, pass a range of the cell(s) (created for example with VP Cell or VP Column) whose value you want to specify. Si rangeObj inclut plusieurs cellules, la valeur spécifiée sera répétée dans chaque cellule.
Le paramètre boolValue vous permet de passer la valeur booléenne (True ou False) qui sera assignée à rangeObj.
//Fixez la valeur de la cellule à False
VP SET BOOLEAN VALUE(VP Cell("ViewProArea";3;2);False)
VP SET VALUE
VP SET BORDER ( rangeObj : Object ; borderStyleObj : Object ; borderPosObj : Object )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | borderStyleObj | Object | -> | Voici le résultat : | | borderPosObj | Object | -> | Objet contenant la position de la bordure |
La commande VP SET BORDER applique le(s) style(s) de bordure défini(s) dans borderStyleObj et borderPosObj à la plage définie dans rangeObj.
Dans rangeObj, passez une plage de cellules où le style de bordure sera appliqué. If the rangeObj contains multiple cells, borders applied with VP SET BORDER will be applied to the rangeObj as a whole (as opposed to the VP SET CELL STYLE command which applies borders to each cell of the rangeObj). Si une feuille de style a déjà été appliquée, VP SET BORDER remplacera les paramètres de bordure précédemment appliqués pour le rangeObj.
Le paramètre borderStyleObj vous permet de définir le style des lignes de la bordure. Le borderStyleObj prend en charge les propriétés suivantes :
| Propriété | Type | Description | Valeurs possibles |
|---|
| color | text | Définit la couleur de la bordure. . | Couleur CSS syntaxe "#rrggbb" (syntaxe préférée), couleur CSS syntaxe "rgb(r,g,b)" (syntaxe alternative), nom de couleur CSS (syntaxe alternative) | | style | Integer | Définit le style de la bordure. . | vk line style dash dotvk line style dash dot dotvk line style dashed vk line style dottedvk line style doublevk line style emptyvk line style hair vk line style mediumvk line style medium dash dotvk line style medium dash dot dotvk line style medium dashedvk line style slanted dash dotvk line style thickvk line style thin |
Vous pouvez définir la position du borderStyleObj (c'est-à-dire l'endroit où la ligne est appliquée) avec le borderPosObj :
| Propriété | Type | Description |
|---|
| all | boolean | Style de la ligne de bordure appliqué à toutes les bordures. | | left | boolean | Style de la ligne de bordure appliqué à la bordure de gauche. | | top | boolean | Style de la ligne de bordure appliqué à la bordure supérieure. | | right | boolean | Style de la ligne de bordure appliqué à la bordure de droite. | | bottom | boolean | Style de la ligne de bordure appliqué à la bordure inférieure. | | outline | boolean | Style de la ligne de bordure appliqué uniquemet aux bordures extérieures. | | inside | boolean | Style de la ligne de bordure appliqué uniquemet aux bordures intérieures. | | innerHorizontal | boolean | Style de la ligne de bordure appliqué uniquemet aux bordures horizontales intérieures. | | innerVertical | boolean | Style de la ligne de bordure appliqué uniquemet aux bordures verticales intérieures. |
Ce code applique la bordure suivante autour de la plage :
$border:=New object("color";"red";"style";vk line style thick)
$option:=New object("outline";True)
VP SET BORDER(VP Cells("ViewProArea";1;1;3;3);$border;$option)
This code demonstrates the difference between VP SET BORDER and setting borders with the VP SET CELL STYLE command:
// Appliquer des bordure à l'aide de VP SET BORDER
$border:=New object("color";"red";"style";vk line style thick)
$option:=New object("outline";True)
VP SET BORDER(VP Cells("ViewProArea";1;1;3;3);$border;$option)
// // Appliquer des bordures à l'aide de VP SET CELL STYLE
$cellStyle:=New object
$cellStyle.borderBottom:=New object("color";"blue";"style";vk line style thick)
$cellStyle.borderRight:=New object("color";"blue";"style";vk line style thick)
VP SET CELL STYLE(VP Cells("ViewProArea";4;4;3;3);$cellStyle)
VP SET CELL STYLE
VP SET CELL STYLE ( rangeObj : Object ; styleObj : Object)
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | styleObj | Object | -> | Le nom de la troisième feuille est "Total premier trimestre" : |
La commande VP SET CELL STYLE applique le(s) style(s) défini(s) dans styleObj aux cellules définies dans rangeObj.
Dans rangeObj, passez une plage de cellules où le style sera appliqué. Si le rangeObj contient plusieurs cellules, le style est appliqué à chaque cellule.
Borders applied with VP SET CELL STYLE will be applied to each cell of the rangeObj, as opposed to the VP SET BORDER command which applies borders to the rangeObj as a whole.
Le paramètre styleObj permet de transmettre un objet contenant des paramètres de style. Vous pouvez utiliser une feuille de style existante ou créer un nouveau style. Vous pouvez utiliser une feuille de style existante ou créer un nouveau style.
Attribuez la valeur NULL pour supprimer un style et rétablir les paramètres de style par défaut (le cas échéant) :
- si vous attribuez la valeur NULL au paramètre styleObj, tous les paramètres de style seront supprimés de rangeObj,
- si vous attribuez la valeur NULL à un attribut, cet attribut spécifique sera supprimé de rangeObj.
For more information about style objects and style sheets, see the Style Objects paragraph.
$style:=New object
$style.font:="8pt Arial"
$style.backColor:="Azure"
$style.foreColor:="red"
$style.hAlign:=1
$style.isVerticalText:=True
$style.borderBottom:=New object("color";"#800080";"style";vk line style thick)
$style.backgroundImage:=Null //supprimer un attribut spécifique
VP SET CELL STYLE(VP Cell("ViewProArea";1;1);$style)
VP ADD STYLESHEET
VP Font to object
VP Get cell style
VP Object to font
VP SET BORDER
VP SET DEFAULT STYLE
VP SET COLUMN ATTRIBUTES ( rangeObj : Object ; propertyObj : Object)
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | propertyObj | Object | -> | Objet contenant des propriétés de colonnes |
La commande VP SET COLUMN ATTRIBUTES applique les attributs définis dans le paramètre propertyObj pour les colonnes de rangeObj.
Dans rangeObj, passez un objet contenant une plage. Si la plage contient des colonnes et des lignes, les attributs s'appliquent uniquement aux colonnes.
Le paramètre propertyObj vous permet de renseigner les attributs à appliquer aux colonnes de rangeObj. Ces attributs sont :
| Propriété | Type | Description |
|---|
| width | number | Largeur de colonne exprimée en pixels | | pageBreak | boolean | Vrai pour insérer un saut de page avant la première colonne de la plage, sinon faux | | visible | boolean | Vrai si la colonne est visible, sinon faux | | resizable | boolean | Vrai si la colonne peut être redimensionnée, sinon faux | | header | text | Texte de l'en-tête de la colonne |
Pour modifier la taille de la deuxième colonne et définir un en-tête, le code suivant :
var $column; $properties : Object
$column:=VP Column("ViewProArea";1) //column B
$properties:=New object("width";100;"header";"Hello World")
VP SET COLUMN ATTRIBUTES($column;$properties)
VP Column
VP Get column attributes
VP Get row attributes
VP SET ROW ATTRIBUTES
VP SET COLUMN COUNT ( vpAreaName : Text ; columnCount : Integer { ; sheet : Integer } )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | columnCount | Integer | -> | Nombre de colonnes | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP SET COLUMN COUNT définit le nombre total de colonnes dans vpAreaName.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Passez le nombre total de colonnes dans le paramètre columnCount. columnCount doit être supérieur à 0.
Dans le paramètre facultatif sheet, vous pouvez désigner une feuille de calcul spécifique où le columnCount sera appliqué (le comptage commence à 0). Si le paramètre est omis, la feuille courante est utilisée par défaut. Vous pouvez sélectionner explicitement la feuille courante à l'aide de la constante suivante :
Le code suivant définit cinq colonnes dans la zone 4D View Pro :
VP SET COLUMN COUNT("ViewProArea";5)
VP Get column count
VP Get row count
VP SET ROW COUNT
VP SET CURRENT SHEET ( vpAreaName : Text ; sheet : Integer)
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | sheet | Integer | -> | Index de la nouvelle feuille courante |
La commande VP SET CURRENT SHEET définit la feuille courante dans vpAreaName. La feuille courante est la feuille sélectionnée dans le document.
Dans vpAreaName, passez le nom de la zone 4D View Pro.
Dans sheet, passez l'index de la feuille à définir comme feuille courante. Si le nombre passé est inférieur à 0 ou dépasse le nombre de feuilles, la commande ne fait rien.
La numérotation démarre à 0.
La feuille courante du document est la première feuille :
Définit la feuille courante à la troisième feuille :
VP SET CURRENT SHEET("ViewProArea";2)
VP Get current sheet
VP SET CUSTOM FUNCTIONS ( vpAreaName : Text ; formulaObj : Object )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | formulaObj | Object | -> | Objet formule |
La commande VP SET CUSTOM FUNCTIONS désigne les formules 4D qui peuvent être appelées directement à partir de formules 4D View Pro. Les fonctions personnalisées n'étant pas stockées dans le document, la commande VP SET CUSTOM FUNCTIONS doit être exécutée dans l'événement formulaire On Load.
Les formules spécifiées par VP SET CUSTOM FUNCTIONS apparaissent dans un menu pop-up lorsque la première lettre de leur nom est saisie. See the Formulas and Functions page.
Si VP SET CUSTOM FUNCTIONS est appelé plusieurs fois pour la même zone, dans la même session, seul le dernier appel est pris en compte.
Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.
Dans le paramètre formulaObj, passez un objet contenant les formules 4D qui peuvent être appelées à partir des formules 4D View Pro ainsi que des propriétés supplémentaires. Chaque propriété customFunction passée dans formulaObj devient le nom d'une fonction dans la zone 4D View Pro.
| Propriété | | | Type | Description |
|---|
<customFunction> | | | Object | Description de la fonction personnalisée. <customFunction> définit le nom de la fonction personnalisée à afficher dans les formules de 4D View Pro (les espaces ne sont pas autorisés) | | formula | | Object | Objet formule 4D (obligatoire). Voir la commande Formula. | | parameters | | Collection d'objets | Collection de paramètres (dans l'ordre dans lequel ils sont définis dans la formule) | | | [ ].name | Text | Nom du paramètre à afficher dans 4D View Pro | | | [ ].type | Number | Type de paramètre. Nom de table | | summary | | Text | Description de la formule à afficher dans 4D View Pro | | minParams | | Number | Nombre minimum de paramètres | | maxParams | | Number | Nombre maximum de paramètres. Passer un nombre supérieur à la taille de parameters permet de déclarer des paramètres "optionnels" avec un type par défaut |
ATTENTION
- As soon as
VP SET CUSTOM FUNCTIONS is called, the methods allowed by the VP SET ALLOWED METHODS command (if any) are ignored in the 4D View Pro area.
- Dès que
VP SET CUSTOM FUNCTIONS est appelé, les fonctions basées sur les commandes SET TABLE TITLES et SET FIELD TITLES sont ignorées dans la zone 4D View Pro.
Vous souhaitez utiliser des objets Formule dans une zone 4D View Pro pour ajouter des chiffres, récupérer le sexe et le nom de famille d'un client :
Case of
:(FORM Event.code=On Load)
var $o : Object
$o:=New object
// Définir la fonction "addnum" d'une méthode nommée "addnum"
$o.addnum:=New object
$o.addnum.formula:=Formula(addnum)
$o.addnum.parameters:=New collection
$o.addnum.parameters.push(New object("name";"num1";"type";Is Integer))
$o.addnum.parameters.push(New object("name";"num2";"type";Is Integer))
// Définir la fonction "ClientLastName" d'un champ de base de données
$o.ClientLastName:=New object
$o.ClientLastName.formula:=Formula([Customers]lastname)
$o.ClientLastName.summary:="Nom de famille du client courant"
// Définir la fonction "label" d'une expression 4D avec un paramètre
$o.label:=New object
$o.label.formula:=Formula(ds.Customers.get($1).label)
$o.label.parameters:=New collection
$o.label.parameters.push(New object("name";"ID";"type";Is Integer))
// Définir la fonction "Title" d'une variable nommée "Title"
$o.Title:=New object
$o.Title.formula:=Formula(Title)
VP SET CUSTOM FUNCTIONS("ViewProArea";$o)
End case
VP SET ALLOWED METHODS
VP SET DATA CONTEXT
Historique
| Release | Modifications |
|---|
| 19 R5 | Ajout |
VP SET DATA CONTEXT ( vpAreaName : Text ; dataObj : Object {; options : Object } {; sheet : Integer} )
VP SET DATA CONTEXT ( vpAreaName : Text ; dataColl : Collection ; {options : Object } {; sheet : Integer} )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | dataObj | Object | -> | Le même code ainsi que les sélecteurs verticaux et horizontaux ont été modifiés pour afficher la même cellule en haut à droite de la zone 4D View Pro : | | dataColl | Collection | -> | | | | options | Object | -> | Options supplémentaires | | sheet | Integer | -> | Indice de la feuille |
La commande VP SET DATA CONTEXT définit le contexte de données d'une feuille. A data context is an object or a collection bound to a worksheet, and whose contents can be used to automatically fill the sheet cells, either by using an autogenerate option or the VP SET BINDING PATH method. On the other hand, the VP Get data context command can return a context containing user modifications.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Dans dataObj ou dataColl, passez un objet ou une collection contenant les données à charger dans le contexte de données. Les images sont converties en schémas URI de données.
Pour passer une valeur Time dans dataObj ou dataColl, encapsulez-la dans un objet avec les propriétés suivantes (voir exemple 4):
| Propriété | Type | Description |
|---|
| value | Integer, Real, Boolean, Text, Date, Null | Valeur à placer dans le contexte | | time | Real | Valeur heure (en secondes) à placer dans le contexte |
Dans options, vous pouvez passer un objet qui spécifie des options supplémentaires. Il peut contenir les propriétés suivantes :
| Propriété | Type | Description |
|---|
| reset | Object | Vrai pour réinitialiser le contenu de la feuille avant de charger le nouveau contexte, Faux (par défaut) dans le cas contraire. | | autoGenerateColumns | Object | Utilisé uniquement lorsque les données sont une collection. Vrai (par défaut) pour spécifier que les colonnes doivent être générées automatiquement lorsque le contexte de données est lié. Dans ce cas, les règles suivantes s'appliquent : - Si dataColl est une collection d'objets, les noms d'attributs sont utilisés comme titres de colonnes (voir exemple 2).
- Si dataColl contient des sous-collections de valeurs scalaires, chaque sous-collection définit les valeurs d'une ligne (voir exemple 3). La première sous-collection détermine le nombre de colonnes créées.
|
Dans sheet,, transmettez l'index de la feuille qui recevra le contexte de données. Si aucun numéro d'indice n'est passé, le contexte est appliqué à la feuille courante.
If you export your document to an object using VP Export to object, or to a 4DVP document using VP EXPORT DOCUMENT, the includeBindingSource option lets you copy the contents of the current contexts as cell values in the exported object or document. Pour plus de détails, reportez-vous à la description de ces méthodes.
Passer un objet et lier les données de contexte aux cellules de la première ligne :
var $data : Object
$data:=New object
$data.firstName:="Freehafer"
$data.lastName:="Nancy"
VP SET DATA CONTEXT("ViewProArea"; $data)
VP SET BINDING PATH(VP Cell("ViewProArea"; 0; 0); "firstName")
VP SET BINDING PATH(VP Cell("ViewProArea"; 1; 0); "lastName")
Passer une collection d'objets et générer automatiquement des colonnes :
var $options : Object
var $data : Collection
$data:=New collection()
$data.push(New object("firstname"; "John"; "lastname"; "Smith"))
$data.push(New object("firstname"; "Mary"; "lastname"; "Poppins"))
$options:=New object("autoGenerateColumns"; True)
VP SET DATA CONTEXT("ViewProArea"; $data; $options)
Les données passées en paramètre sont une collection qui contient des sous-collections. Chaque sous-collection définit une ligne.
var $data : Collection
var $options : Object
$data:=New collection
$data.push(New collection(1; 2; 3; False; "")) // 5 colonnes sont créées
$data.push(New collection) // la 2e ligne est vide
$data.push(New collection(4; 5; Null; "hello"; "world")) // la 3e ligne a 5 valeurs
$data.push(New collection(6; 7; 8; 9)) // la 4e ligne a 4 valeurs
$options:=New object("autoGenerateColumns"; True)
VP SET DATA CONTEXT("ViewProArea"; $data; $options)
var $data : Collection
var $options : Object
$data:= New collection()
// Les dates peuvent être passées en valeurs scalaires
$data.push(New collection("Date"; Current date))
// Les heures doivent être passées en tant qu'attributs d'objet
$data.push(New collection("Time"; New object("time"; 5140)))
// exemple Date + heure
$data.push(New collection("Date + Time"; New object("value"; Current date; "time"; 5140)))
$options:=New object("autoGenerateColumns"; True)
VP SET DATA CONTEXT("ViewProArea"; $data; $options)
Voici le résultat une fois les colonnes générées :
VP SET BINDING PATH
VP Get binding path
VP Get data context
VP SET DATE TIME VALUE ( rangeObj : Object ; dateValue : Date ; timeValue : Time {; formatPattern : Text } )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | dateValue | Date | -> | Valeur date à fixer | | timeValue | Time | -> | Dans les formules de 4D View Pro, les noms des fonctions sont automatiquement affichés en majuscules. | | formatPattern | Text | -> | Format de la valeur |
La commande VP SET DATE TIME VALUE assigne une valeur date et heure spécifique à une plage de cellule désignée.
In rangeObj, pass a range of the cell(s) (created for example with VP Cell or VP Column) whose value you want to specify. Si rangeObj inclut plusieurs cellules, la valeur spécifiée sera répétée dans chaque cellule.
Le paramètre dateValue indique une valeur date à assigner à rangeObj.
Le paramètre timeValue indique une valeur heure (exprimée en secondes) à assigner à rangeObj.
Le paramètre optionnel formatPattern définit un modèle pour les paramètres dateValue et timeValue. For information on patterns and formatting characters, please refer to the Date and time formats section.
//Attribuer la date et l'heure locales à la valeur de la cellule
VP SET DATE TIME VALUE(VP Cell("ViewProArea";6;2);Current time;Current date;vk pattern full date time)
//Attribuer le 18 décembre à la valeur de la cellule
VP SET DATE TIME VALUE(VP Cell("ViewProArea";3;9);!2024-12-18!;?14:30:10?;vk pattern sortable date time)
4D View Pro cell format
VP SET DATE VALUE
VP SET TIME VALUE
VP SET VALUE
VP SET DATE VALUE ( rangeObj : Object ; dateValue : Date { ; formatPattern : Text } )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | dateValue | Date | -> | Valeur date à fixer | | formatPattern | Text | -> | Format de la valeur |
La commande VP SET DATE VALUE attribue une valeur de date spécifiée à une plage de cellules désignée.
Dans rangeObj, passez une plage de cellule(s) dont vous voulez spécifier la valeur. Si rangeObj inclut plusieurs cellules, la valeur spécifiée sera répétée dans chaque cellule.
Le paramètre dateValue indique une valeur date à assigner à rangeObj.
L'option formatPattern définit un modèle pour le paramètre dateValue. Passez un format personnalisé ou utilisez ou utilisez l'une des constantes suivantes :
| Constante | Description | Configuration par défaut des US |
|---|
vk pattern long date | Format ISO 8601 long pour la date | "dddd, dd MMMM yyyy" | vk pattern month day | Format ISO 8601 pour le mois et le jour | "MMMM dd" | vk pattern short date | Format ISO 8601 court pour la date | "MM/dd/yyyy" | vk pattern year month | Format ISO 8601 pour le mois et l'année | "yyyy MMMM" |
For information on patterns and formatting characters, please refer to the Date and time formats section.
//Définir la valeur de la cellule à la date du jour
VP SET DATE VALUE(VP Cell("ViewProArea";4;2);Current date))
//Définir la valeur de la cellule à une date spécifique avec un format désigné
VP SET DATE VALUE(VP Cell("ViewProArea";4;4);Date("12/25/94");"d/m/yy ")
VP SET DATE VALUE(VP Cell("ViewProArea";4;6);!2005-01-15!;vk pattern month day)
4D View Pro cell format
VP SET DATE TIME VALUE
VP SET VALUE
VP SET DEFAULT STYLE ( vpAreaName : Text ; styleObj : Object { ; sheet : Integer } )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | styleObj | Object | -> | Le nom de la troisième feuille est "Total premier trimestre" : | | sheet | Integer | -> | Indice de la feuille (par défaut = feuille courante) |
La commande VP SET DEFAULT STYLE définit le style dans le styleObj comme style par défaut pour une feuille sheet.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Le styleObj vous permet de passer un objet contenant des paramètres de style. Vous pouvez utiliser une feuille de style existante ou créer un nouveau style. For more information, see the Style objects paragraph.
Dans le paramètre optionnel sheet, vous pouvez désigner une feuille de calcul spécifique où le style sera défini. Si le paramètre est omis, la feuille courante est utilisée par défaut. Vous pouvez sélectionner explicitement la feuille courante à l'aide de la constante suivante :
$style:=New object
$style.hAlign:=vk horizontal align left
$style.font:="12pt papyrus"
$style.backColor:="#E6E6FA" //couleur light purple
VP SET DEFAULT STYLE("myDoc";$style)
VP ADD STYLESHEET
VP Font to object
VP Get default style
VP Object to font
VP SET BORDER
VP SET CELL STYLE
VP SET FIELD ( rangeObj : Object ; field : Pointer { ; formatPattern : Text } )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | champ | Pointer | -> | | | | formatPattern | Text | -> | Format du champ |
La commande VP SET FIELD attribue un champ virtuel de la base de données 4D à une plage de cellules désignée.
Dans rangeObj, passez une plage de cellule(s) dont vous voulez spécifier la valeur. Dans rangeObj, passez une plage de cellule(s) dont vous voulez spécifier la valeur.
The field parameter specifies a 4D database virtual field to be assigned to the rangeObj. Le nom de la structure virtuelle pour field peut être visualisé dans la barre de formule. Si l'une des cellules de rangeObj a un contenu existant, elle sera remplacée par field.
L'option formatPattern définit un modèle pour le paramètre field. You can pass any valid custom format.
VP SET FIELD(VP Cell("ViewProArea";5;2);->[TableName]Field)
VP SET VALUE
VP SET FORMULA ( rangeObj : Object ; formula : Text { ; formatPattern : Text } )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | formula | Text | -> | Nom d'un paramètre à afficher pour <functionName>.Note: Les noms des paramètres ne doivent pas contenir d'espace. | | formatPattern | Text | -> | Format du champ |
La commande VP SET FORMULA assigne une formule spécifiée ou une méthode 4D à une plage de cellules désignées.
In rangeObj, pass a range of the cell(s) (created for example with VP Cell or VP Column) whose value you want to specify. Si rangeObj comprend plusieurs cellules, la formule spécifiée sera liée à chaque cellule.
Le paramètre formula spécifie une formule ou un nom de méthode 4D à affecter à la rangeObj.
Si formula est une chaîne de caractères, utilisez le point . comme séparateur numérique et la virgule , comme séparateur de paramètres.
If a 4D method is used, it must be allowed with the VP SET ALLOWED METHODS command.
The optional formatPattern defines a pattern for the formula.
Vous supprimez la formule dans rangeObj en la remplaçant par une chaîne vide ("").
VP SET FORMULA(VP Cell("ViewProArea";5;2);"SUM($A$1:$C$10)")
Pour supprimer la formule :
VP SET FORMULA(VP Cell("ViewProArea";5;2);"")
VP SET FORMULA($range; "SUM(A1,B7,C11)") //"," pour séparer les paramètres
Cell format
VP Get Formula
VP SET FORMULAS
VP SET VALUE
VP SET FORMULAS ( rangeObj : Object ; formulasCol : Collection )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Pour lire les détails du style par défaut de ce document : | | formulasCol | Collection | -> | Collection de formules |
La commande VP SET FORMULAS attribue une collection de formules à partir de la plage de cellules spécifiée.
In rangeObj, pass a range of the cell (created with VP Cell) whose formula you want to specify. Si rangeObj comprend plusieurs plages, seule la première plage est utilisée.
Le formulesCol est une collection à deux dimensions :
- La collection de premier niveau contient des sous-collections de formules. Chaque sous-collection définit une ligne.
- Chaque sous-collection définit les valeurs des cellules de la ligne. Les valeurs doivent être des éléments textuels contenant les formules à associer aux cellules.
Si la formule est une chaîne de caractères, utilisez le point . comme séparateur numérique et la virgule , comme séparateur de paramètres.
If a 4D method is used, it must be allowed with the VP SET ALLOWED METHODS command.
Vous supprimez les formules dans rangeObj en les remplaçant par une chaîne vide ("").
$formulas:=New collection
$formulas.push(New collection("MAX(B11,C11,D11)";"myMethod(G4)")) // Première ligne
$formulas.push(New collection("SUM(B11:D11)";"AVERAGE(B11:D11)")) // Deuxième ligne
VP SET FORMULAS(VP Cell("ViewProArea";6;3);$formulas) // Associer les formules et les formules
myMethod :
Pour supprimer des formules :
$formulas:=New collection
$formulas.push(New collection("";"")) // première collection
$formulas.push(New collection("";"")) // deuxième collection
VP SET FORMULAS(VP Cell("ViewProArea";0;0);$formulas) // Assigner à des cellules
VP Get Formulas
VP GET VALUESVP SET FORMULA
VP SET VALUES
VP SET FROZEN PANES ( vpAreaName : Text ; paneObj : Object { ; sheet : Integer } )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | paneObj | Object | -> | Objet contenant des informations sur les colonnes et lignes figées | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP SET FROZEN PANES définit l'état gelé des colonnes et des lignes du paneObj afin qu'elles soient toujours affichées dans le vpAreaName. . Un trait continu s'affiche pour indiquer que des lignes et colonnes sont figées. L'emplacement du trait dépend de l'emplacement de la ligne ou colonne figée dans la feuille :
- Colonnes à gauche ou à droite : Pour les colonnes situées à gauche de la feuille, la ligne est affichée sur le côté droit de la dernière colonne gelée. Pour les colonnes situées à droite de la feuille, le trait s'affiche sur le côté gauche de la prmeière colonne figée.
- Lignes en haut ou en bas: Pour les lignes en haut de la feuille, la ligne est affichée en dessous de la dernière ligne gelée. Pour les lignes situées en bas de la feuille, le trait s'affiche au-dessus de la première ligne figée.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Vous pouvez passer un objet définissant les colonnes et les lignes à geler dans le paramètre paneObj. Si vous fixez la valeur d'une propriété de colonne ou de ligne à zéro, cela réinitialise (ne fige plus) la propriété. Si une propriété est définie sur une valeur inférieure à zéro, la commande ne fait rien. Vous pouvez passer :
| Propriété | Type | Description |
|---|
| columnCount | Integer | Le nombre de colonnes figées sur la gauche de la feuille | | trailingColumnCount | Integer | Le nombre de colonnes figées sur la droite de la feuille | | rowCount | Integer | Le nombre de lignes figées en haut de la feuille | | trailingRowCount | Integer | Le nombre de lignes figées en bas de la feuille |
Dans le paramètre optionnel sheet, vous pouvez désigner une feuille spécifique dans laquelle sera définie la plage (la numérotation commence à zéro). Si le paramètre est omis, la feuille courante est utilisée par défaut. Vous pouvez sélectionner explicitement la feuille courante à l'aide de la constante suivante :
Vous souhaitez figer les trois premières colonnes de gauche, deux colonnes de droite et la première ligne :
var $panes : Object
$panes:=New object
$panes.columnCount:=3
$panes.trailingColumnCount:=2
$panes.rowCount:=1
VP SET FROZEN PANES("ViewProArea";$panes)
VP Get frozen panes
VP SET NUM VALUE ( rangeObj : Object ; numberValue : Number { ; formatPattern : Text } )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | numberValue | Number | -> | Les colonnes suivantes sont toutes de la même taille et n'affichent pas certaines parties du texte : | | formatPattern | Text | -> | Format de la valeur |
La commande VP SET NUM VALUE assigne une valeur numérique spécifique à une plage de cellules désignée.
In rangeObj, pass a range of the cell(s) (created for example with VP Cell or VP Column) whose value you want to specify. Si rangeObj inclut plusieurs cellules, la valeur spécifiée sera répétée dans chaque cellule.
Le paramètre numberValue indique une valeur numérique à assigner à rangeObj.
The optional formatPattern defines a pattern for the numberValue parameter.
//Définir la valeur de la cellule à 2
VP SET NUM VALUE(VP Cell("ViewProArea";3;2);2)
//Définir la valeur de la cellule et la formater en dollars
VP SET NUM VALUE(VP Cell("ViewProArea";3;2);12.356;"_($* #,##0.00_)")
Cell format
VP SET VALUE
VP SET PRINT INFO ( vpAreaName : Text ; printInfo : Object { ; sheet : Integer } )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom de la zone 4D View Pro | | printInfo | Object | -> | Objet contenant les propriétés de la ligne | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP SET PRINT INFO définit les attributs à utiliser lors de l'impression du vpAreaName.
Passez le nom de la zone 4D View Pro pour l'imprimer dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.
Vous pouvez passer un objet contenant des définitions pour divers attributs d'impression dans le paramètre printInfo. To view the full list of the available attributes, see Print Attributes.
Dans le paramètre optionnel sheet, vous pouvez définir une feuille (sheet) spécifique à imprimer (la numérotation démarre à zéro). Si le paramètre est omis, la feuille courante est utilisée par défaut. Vous pouvez sélectionner explicitement la feuille courante à l'aide de la constante suivante :
Le code suivant imprimera une nouvelle zone 4D View Pro dans un document PDF :
var $printInfo : Object
//Déclarer l'objet attributs d'impression
$printInfo:=New object
//Définir attributs d'impression
$printInfo.headerCenter:="&BS.H.I.E.L.D. &A Sales Per Region"
$printInfo.firstPageNumber:=1
$printInfo.footerRight:="page &P of &N"
$printInfo.orientation:=vk print page orientation landscape
$printInfo.centering:=vk print centering horizontal
$printInfo.columnStart:=0
$printInfo.columnEnd:=8
$printInfo.rowStart:=0
$printInfo.rowEnd:=24
$printInfo.showGridLine:=True
//Ajouter le logo de l'entreprise
$printInfo.headerLeftImage:=logo.png
$printInfo.headerLeft:="&G"
$printInfo.showRowHeader:=vk print visibility hide
$printInfo.showColumnHeader:=vk print visibility hide
$printInfo.fitPagesWide:=1
$printInfo.fitPagesTall:=1
//Imprimer le document PDF
VP SET PRINT INFO ("ViewProArea";$printInfo)
//Exporter le PDF
VP EXPORT DOCUMENT("ViewProArea";"Sales2018.pdf";New object("formula";Formula(ALERT("PDF ready!"))))
Le PDF :
4D View Pro print attributes
VP Convert to picture
VP Get print info
VP PRINT
VP SET ROW ATTRIBUTES ( rangeObj : Object ; propertyObj : Object )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Une fois que l'export est terminé, VP EXPORT DOCUMENT exécute automatiquement la méthode définie dans la propriété formula de paramObj, le cas échéant. | | propertyObj | Object | -> | Objet contenant des propriétés de lignes |
La commande VP SET ROW ATTRIBUTES applique les attributs définis dans propertyObj aux lignes de rangeObj.
Dans rangeObj, passez un objet contenant une plage. Si la plage contient des colonnes et des lignes, les attributs s'appliquent uniquement aux lignes.
Le paramètre propertyObj vous permet de spécifier les attributs à appliquer aux lignes dans rangeObj. Ces attributs sont :
| Propriété | Type | Description |
|---|
| height | number | Hauteur de la ligne exprimée en pixels | | pageBreak | boolean | Vrai pour insérer un saut de page avant la première ligne de la plage, sinon faux | | visible | boolean | Vrai si la ligne est visible, sinon faux | | resizable | boolean | Vrai si la ligne peut être redimensionnée, sinon faux | | header | text | Texte de l'en-tête de la ligne |
Pour modifier la taille de la deuxième ligne et définir l'en-tête, saisissez le code suivant :
var $row; $properties : Object
$row:=VP Row("ViewProArea";1)
$properties:=New object("height";75;"header";"June")
VP SET ROW ATTRIBUTES($row;$properties)
VP Get row attributes
VP get column attributes
VP SET ROW ATTRIBUTES
VP SET ROW COUNT ( vpAreaName : Text ; rowCount : Integer { ; sheet : Integer } )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | rowCount | Integer | -> | Nombre de lignes | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP SET ROW COUNT définit le nombre total de lignes dans vpAreaName.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Passez le nombre total de lignes dans le paramètre rowCount. rowCount doit être supérieur à 0.
Dans le paramètre facultatif sheet, vous pouvez désigner une feuille de calcul spécifique où le rowCount sera appliqué (la numérotation commence à 0). Si le paramètre est omis, la feuille courante est utilisée par défaut. Vous pouvez sélectionner explicitement la feuille courante à l'aide de la constante suivante :
Le code suivant définit cinq lignes dans la zone 4D View Pro :
VP SET ROW COUNT("ViewProArea";5)
VP Get column count
VP get row-count
VP SET COLUMN COUNT
VP SET SELECTION ( rangeObj : Object )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage de toutes les cellules |
La commande VP SET SELECTION définit les cellules spécifiées comme la sélection et la première cellule comme la cellule active.
Dans rangeObj, passez un objet plage de cellule(s) à désigner comme sélection courante.
$currentSelection:=VP Combine ranges(VP Cells("myVPArea";3;2;1;6);VP Cells("myVPArea";5;7;1;7))
VP SET SELECTION($currentSelection)
VP Get active cell
VP Get selection
VP RESET SELECTION
VP SET ACTIVE CELL
VP ADD SELECTION
VP SHOW CELL
VP SET SHEET COUNT ( vpAreaName : Text ; number : Integer )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | number | Integer | -> | Nombre de feuilles |
La commande VP SET SHEET COUNT définit le nombre de feuilles dans vpAreaName.
Dans number, passez un nombre correspondant au nombre de feuilles que le document contiendra après l'exécution de la commande.
Avertissement : La commande supprimera des feuilles si le nombre précédent de feuilles dans votre document est supérieur au nombre transmis. Par exemple, si votre document comporte 5 feuilles et que vous avez fixé le nombre de feuilles à 3, la commande supprimera les feuilles numérotées 4 et 5.
Le document comporte actuellement une feuille :
Pour régler le nombre de feuilles sur 3 :
VP SET SHEET COUNT("ViewProArea";3)
VP Get sheet count
VP SET SHEET NAME ( vpAreaName : Text ; name : Text {; sheet: Integer} )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | name | Text | -> | La collection retournée par VP Get values contient une collection bidimensionnelle : | | sheet | Integer | -> | Index de la feuille à renommer |
La commande VP SET SHEET NAME renomme une feuille dans le document chargé dans vpAreaName.
Dans vpAreaName, passez le nom de la zone 4D View Pro.
Dans name, passez le nouveau nom de la feuille.
Dans sheet, passez le numéro de la feuille à renommer.
La numérotation démarre à 0.
Si aucune sheet n'est fournie, la commande renomme la feuille courante.
Le nouveau nom ne peut pas contenir les caractères suivants : *, :, [, ], ?,\,/
La commande ne fait rien si :
- le nouveau nom contient des caractères interdits
- la valeur du nouveau nom est vide
- le nouveau nom existe déjà
- the passed sheet does not exist
Le nom de la troisième feuille est "Total premier trimestre" :
VP SET SHEET NAME("ViewProArea";"Total first quarter";2)
VP SET SHEET OPTIONS ( vpAreaName : Text; sheetOptions : Object { ; sheet : Integer} )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom de la zone 4D View Pro | | sheetOptions | Object | -> | Une erreur est retournée si l'objet viewPro est invalide. | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP SET SHEET OPTIONS permet de définir différentes options de feuille de la zone vpAreaName .
Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.
Passez un objet contenant les options à définir dans le paramètre sheetOptions. To view the full list of the available options, see the Sheet Options paragraph.
Dans le paramètre optionnel sheet, vous pouvez désigner une feuille spécifique (la numérotation commence à zéro). Si le paramètre est omis, la feuille courante est utilisée par défaut. Vous pouvez sélectionner explicitement la feuille courante à l'aide de la constante suivante :
Vous souhaitez protéger toutes les cellules à l'exception de la plage C5:D10 :
// Activer la protection sur la feuille courante
var $options : Object
$options:=New object
$options.isProtected:=True
VP SET SHEET OPTIONS("ViewProArea" ;$options)
// marquer les cellules C5:D10 comme 'déverrouillées'
VP SET CELL STYLE(VP Cells("ViewProArea";2;4;2;6);New object("locked";False))
Vous souhaitez protéger votre document pendant que vos utilisateurs redimensionnent les lignes et colonnes :
var $options : Object
$options:=New object
// Activer la protection
$options.isProtected:=True
$options.protectionOptions:=New object
// Permettre à l'utilisateur de redimensionner les lignes
$options.protectionOptions.allowResizeRows=True;
// Permettre à l'utilisateur de redimensionner les colonnes
$options.protectionOptions.allowResizeColumns=True;
// Appliquer la protection à la feuille courante
VP SET SHEET OPTIONS("ViewProArea";$options)
Vous souhaitez personnaliser la couleur des onglets, des lignes figées, du quadrillage, du fond de la sélection et de la bordure de la sélection :
var $options : Object
$options:=New object
// Personnaliser la couleur de l'onglet de la feuille 1
$options.sheetTabColor:="Black"
$options.gridline:=New object("color";"Purple")
$options.selectionBackColor:="rgb(255,128,0,0.4)"
$options.selectionBorderColor:="Yellow"
$options.frozenlineColor:="Gold"
VP SET SHEET OPTIONS("ViewProArea";$options;0)
// Personnaliser la couleur de l'onglet de la feuille 2
$options.sheetTabColor:="red"
VP SET SHEET OPTIONS("ViewProArea";$options;1)
// Personnaliser la couleur de l'onglet de la feuille 3
$options.sheetTabColor:="blue"
VP SET SHEET OPTIONS("ViewProArea";$options;2)
Résultat:
Vous souhaitez masquer le quadrillage et les en-têtes des lignes et colonnes.
var $options : Object
$options:=New object
$options.gridline:=New object()
$options.gridline.showVerticalGridline:=False
$options.gridline.showHorizontalGridline:=False
$options.rowHeaderVisible:=False
$options.colHeaderVisible:=False
VP SET SHEET OPTIONS("ViewProArea";$options)
Résultat:
4D View Pro sheet options
VP Get sheet options
VP SET SHOW PRINT LINES ( vpAreaName : Text {; visible : Boolean}{; sheet : Integer} )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | visible | Boolean | -> | Collection de formules| | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP SET SHOW PRINT LINES détermine si les lignes de l'aperçu avant impression sont affichées dans une feuille de calcul..
Dans vpAreaName, passez le nom de la zone 4D View Pro.
Dans visible, passez True pour afficher les lignes d'impression, et False pour les cacher. True est passé par défaut.
Dans sheet, passez le numéro de la page cible. Si aucun numéro n'est spécifié, la commande s'applique à la feuille en cours.
La numérotation démarre à 0.
La position des lignes d'impression d'une feuille de calcul varie en fonction des sauts de page de cette feuille.
Le code suivant affiche les lignes d'impression dans la deuxième feuille d'un document :
VP SET SHOW PRINT LINES("ViewProArea";True;1)
Avec un saut de page :
4D Get show print lines
Historique
| Release | Modifications |
|---|
| 19 R7 | Ajout |
VP SET TABLE COLUMN ATTRIBUTES ( vpAreaName : Text ; tableName : Text ; column : Integer ; attributes : Object {; sheet : Integer } )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | tableName | Text | -> | Nom de table | | column | Integer | -> | Numéro de colonne de la table | | attributes | Object | -> | Attribut(s) à appliquer à column | | sheet | Integer | -> | Numéro d'indice de la feuille (feuille courante si omis) |
La commande VP SET TABLE COLUMN ATTRIBUTES applique les attributs définis à la colonne dans le tableName.
Dans vpAreaName, passez le nom de la zone 4D View Pro.
Dans le paramètre attributes, passez un objet qui contient les propriétés à définir :
| Propriété | Type | Description |
|---|
| dataField | text | Nom de la propriété de la colonne de la table dans le contexte de données. | | name | text | Nom de la colonne de la table. Doit être unique dans la table. Si ce nom est déjà utilisé par une autre colonne, il n'est pas appliqué et un nom par défaut est automatiquement utilisé. | | formula | text | Définit la formule pour chaque cellule de la colonne. See Structured Reference Formulas in the SpreadJS documentation | | footerText | text | Valeur du pied de colonne. | | footerFormula | text | Formule de pied de colonne. | | filterButtonVisible | boolean | Définit si le bouton de filtre de la colonne de la table est affiché (par défaut True lors de la création de la table). |
Dans sheet, passez le numéro de la page cible. Si aucune feuille nommée name n'est trouvée dans le document, la méthode retourne -1.
La numérotation démarre à 0.
Si tableName n'est pas trouvé ou si colonne est supérieure au nombre de colonnes, la commande ne fait rien.
Vous créez une table avec un contexte de données :
var $context;$options : Object
$context:=New object()
$context.col:=New collection()
$context.col.push(New object("name"; "Smith"; "firstname"; "John"; "salary"; 10000))
$context.col.push(New object("name"; "Wesson"; "firstname"; "Jim"; "salary"; 50000))
$context.col.push(New object("name"; "Gross"; "firstname"; "Maria"; "salary"; 10500))
VP SET DATA CONTEXT("ViewProArea"; $context)
//Définition des colonnes de la table
$options:=New object()
$options.tableColumns:=New collection()
$options.tableColumns.push(New object("name"; "Last Name"; "dataField"; "name"))
$options.tableColumns.push(New object("name"; "Salary"; "dataField"; "salary"))
VP CREATE TABLE(VP Cells("ViewProArea"; 1; 1; 2; 3); "PeopleTable"; "col"; $options)
Vous souhaitez ensuite insérer une colonne contenant des données provenant du contexte de données et masquer certains boutons de filtrage :
//insérer une colonne
VP INSERT TABLE COLUMNS("ViewProArea"; "PeopleTable"; 1; 1)
var $param : Object
$param:=New object()
// Lier la colonne au champ firstname du datacontext
$param.dataField:="firstname"
// Changer le nom par défaut de la colonne en "First name"
// et cacher le bouton de filtrage
$param.name:="Prénom"
$param.filterButtonVisible:=False
VP SET TABLE COLUMN ATTRIBUTES("ViewProArea"; "PeopleTable"; 1; $param)
// Masquer le bouton de filtrage de la première colonne
VP SET TABLE COLUMN ATTRIBUTES("ViewProArea"; "PeopleTable"; 0; \
New object("filterButtonVisible"; False))
VP CREATE TABLE
VP Find table
VP Get table column attributes
VP RESIZE TABLE
Historique
| Release | Modifications |
|---|
| 19 R8 | Ajout |
VP SET TABLE THEME ( vpAreaName : Text ; tableName : Text ; options : cs.ViewPro.TableTheme )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | tableName | Text | -> | Nom de table | | options | cs.ViewPro.TableTheme | -> | Propriétés du thème de la table à modifier |
La commande VP SET TABLE THEME modifie le thème actuel de la tableName.
Dans vpAreaName, passez le nom de la zone 4D View Pro et dans tableName, le nom de la table à modifier.
In the options parameter, pass an object of the cs.ViewPro.TableTheme class that contains the theme properties to modify.
Vous souhaitez définir un thème prédéfini pour une table :
var $param : cs.ViewPro.TableTheme
$param:=cs.ViewPro.TableTheme.new()
$param.theme:="medium2"
VP SET TABLE THEME("ViewProArea"; "myTable"; $param)
Vous souhaitez obtenir ce rendu de colonne alterné :
var $param : cs.ViewPro.TableTheme
$param:=cs.ViewPro.TableTheme.new()
// Activer le rendu bandColumn
$param.bandColumns:=True
$param.bandRows:=False
// Créer l'objet thème avec les styles d'en-tête et de colonne
$param.theme:=cs.ViewPro.TableThemeOptions.new()
var $styleHeader; $styleColumn; $styleColumn2 : cs.ViewPro.TableStyle
$styleHeader:=cs.ViewPro.TableStyle.new()
$styleHeader.backColor:="Gold"
$styleHeader.foreColor:="#03045E"
$param.theme.headerRowStyle:=$styleHeader
$styleColumn1:=cs.ViewPro.TableStyle.new()
$styleColumn1.backColor:="SkyBlue"
$styleColumn1.foreColor:="#03045E"
$param.theme.firstColumnStripStyle:=$styleColumn1
$styleColumn2:=cs.ViewPro.TableStyle.new()
$styleColumn2.backColor:="LightCyan"
$styleColumn2.foreColor:="#03045E"
$param.theme.secondColumnStripStyle:=$styleColumn2
VP SET TABLE THEME("ViewProArea" ; "myTable" ; $param)
VP CREATE TABLE
VP Get table theme
VP SET TEXT VALUE
VP SET TEXT VALUE ( rangeObj : Object ; textValue : Text { ; formatPattern : Text } )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | textValue | Text | -> | Nom de la zone 4D View Pro dans le formulaire| | | formatPattern | Text | -> | Format de la valeur |
La commande VP SET TEXT VALUE assigne une valeur texte spécifique à une plage de cellules désignée.
In rangeObj, pass a range of the cell(s) (created for example with VP Cell or VP Column) whose value you want to specify. Si rangeObj inclut plusieurs cellules, la valeur spécifiée sera répétée dans chaque cellule.
Le paramètre textValue indique une valeur texte à assigner à rangeObj.
Un objet de plage vide est retourné si aucun résultat n'est trouvé.
VP SET TEXT VALUE(VP Cell("ViewProArea";3;2);"Test 4D View Pro")
Cell Format
VP SET VALUE
VP SET TIME VALUE ( rangeObj : Object ; timeValue : Time { ; formatPattern : Text } )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | timeValue | Time | -> | Dans les formules de 4D View Pro, les noms des fonctions sont automatiquement affichés en majuscules. | | formatPattern | Text | -> | Format de la valeur |
La commande VP SET TIME VALUE attribue une valeur de temps spécifiée à une plage de cellules désignée.
In rangeObj, pass a range of the cell(s) (created for example with VP Cell or VP Column) whose value you want to specify. Si rangeObj inclut plusieurs cellules, la valeur spécifiée sera répétée dans chaque cellule.
Le paramètre *timeValue * spécifie une durée exprimée en secondes à attribuer à rangeObj.
The optional formatPattern defines a pattern for the timeValue parameter.
//Définit la valeur à l'heure courante
VP SET TIME VALUE(VP Cell("ViewProArea";5;2);Current time)
//Définit la valeur à une heure spécifique avec un format désigné
VP SET TIME VALUE(VP Cell("ViewProArea";5;2);?12:15:06?;vk pattern long time)
Cell Format
VP SET DATE TIME VALUE
VP SET VALUE
VP SET VALUE ( rangeObj : Object ; valueObj : Object )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | valueObj | Object | -> | Valeurs de la cellule et options de formatage |
La commande VP SET VALUE attribue une valeur spécifiée à une plage de cellules désignée.
The command allows you to use a generic code to set and format the types of values in rangeObj, whereas other commands, such as VP SET TEXT VALUE and VP SET NUM VALUE, reduce the values to specific types.
In rangeObj, pass a range of the cell(s) (created for example with VP Cell or VP Column) whose value you want to specify. Si rangeObj inclut plusieurs cellules, la valeur spécifiée sera répétée dans chaque cellule.
The parameter valueObj is an object that includes properties for the value and the format to assign to rangeObj. Il peut contenir les propriétés suivantes :
| Propriété | Type | Description |
|---|
| value | Integer, Real, Boolean, Text, Date, Null | Valeur à attribuer à rangeObj (sauf pour time). Passez null pour effacer le contenu de la cellule. | | time | Real | Valeur heure (en secondes) à assigner à rangeObj | | format | Text | Modèle pour la propriété value/time. For information on patterns and formatting characters, please refer to the Cell Format paragraph. |
//Set the cell value as False
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";False))
//Set the cell value as 2
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";2))
//Set the cell value as $125,571.35
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_($* #,##0.00_)"))
//Set the cell value as Hello World!
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";"Hello World!"))
//Set the cell value as current date
VP SET VALUE(VP Cell("ViewProArea";4;2);New object("value";Current date))
//Set the cell value as current hour
VP SET VALUE(VP Cell("ViewProArea";5;2);New object("time";Current hour))
//Set the cell value as specific date and time
VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time";?14:30:10?;"format";vk pattern full date time))
//Erase cell content
VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";Null))
Cell Format
VP Get values
VP SET VALUE
VP SET BOOLEAN VALUE
VP SET DATE TIME VALUE
VP SET FIELD
VP SET FORMULA
VP SET NUM VALUE
VP SET TEXT VALUE
VP SET TIME VALUE
VP SET VALUES ( rangeObj : Object ; valuesCol : Collection )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | valuesCol | Collection | -> | Collection de valeurs |
La commande VP SET VALUES attribue une collection de valeurs commençant à la plage de cellules spécifiée.
In rangeObj, pass a range for the cell (created with VP Cell) whose value you want to specify. La cellule définie dans rangeObj est utilisée pour déterminer le point de départ.
- Si rangeObj n'est pas une plage de cellules, seule la première cellule de la plage est utilisée.
- Si rangeObj comprend plusieurs plages, seule la première cellule de la première plage est utilisée.
Le paramètre valuesCol est bidimensionnel :
- La collection de premier niveau contient des sous-collections de valeurs. Chaque sous-collection définit une ligne. Passez une collection vide pour sauter une ligne.
- Chaque sous-collection définit les valeurs des cellules de la ligne. Les valeurs peuvent être de type entier long, réel, booléen, texte, date, null ou objet. Si la valeur est un objet, elle peut avoir les propriétés suivantes :
| Propriété | Type | Description |
|---|
| value | Integer, Real, Boolean, Text, Date, Null | Valeur dans la cellule (sauf heure) | | time | Real | Valeur heure (en secondes) |
$param:=New collection
$param.push(New collection(1;2;3;False)) //première ligne, 4 valeurs
$param.push(New collection) //deuxième ligne, inchangé
$param.push(New collection(4;5;Null;"hello";"world")) // troisième ligne, 5 valeurs
$param.push(New collection(6;7;8;9)) // quatrième ligne, 4 valeurs
$param.push(New collection(Null;New object("value";Current date;"time";42))) //cinquième ligne, 1 valeur
VP SET VALUES(VP Cell("ViewProArea";2;1);$param)
VP Get formulas
VP Get value
VP Get Values
VP SET FORMULAS
VP SET VALUE
VP SET WORKBOOK OPTIONS ( vpAreaName : Text ; optionObj : Object)
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro | | optionObj | Object | -> | Objet contenant les options du workbook à définir |
VP SET WORKBOOK OPTIONS
définit les options du classeur (workbook) dans vpAreaName.
Dans vpAreaName, passez le nom de la zone 4D View Pro.
Dans optionObj, passez les options du classeur à appliquer à vpAreaName.
Si optionObj est vide, la commande ne fait rien.
Les options modifiées du classeur sont enregistrées avec le document.
Le tableau suivant répertorie les options de classeur disponibles :
| Propriété | Type | Description |
|---|
| allowUserDragMerge | boolean | L'opération de fusion par glisser est autorisée (sélection des cellules et glisser de la sélection pour fusionner les cellules) | | allowAutoCreateHyperlink | boolean | Permet la création automatique d'hyperliens dans la feuille de calcul. | | allowContextMenu | boolean | Le menu contextuel intégré peut être ouvert. | | allowCopyPasteExcelStyle | boolean | Les styles d'une feuille de calcul peuvent être copiés et collés dans Excel, et vice-versa. | | allowDynamicArray | boolean | Active les tableaux dynamiques dans les feuilles de travail | | allowExtendPasteRange | boolean | Étend la plage collée si la plage collée n'est pas suffisante pour les données collées | | allowSheetReorder | boolean | La réorganisation de la feuille est autorisée | | allowUndo | boolean | L'annulation des modifications est autorisée. | | allowUserDeselect | boolean | La désélection de cellules spécifiques d'une sélection est autorisée. | | allowUserDragDrop | boolean | Glisser-déposer des données de plage est autorisé | | allowUserDragFill | boolean | Le remplissage par glisser est autorisé | | allowUserEditFormula | boolean | Des formules peuvent être saisies dans les cellules | | allowUserResize | boolean | Les colonnes et les lignes peuvent être redimensionnées | | allowUserZoom | boolean | Le zoom (ctrl + molette de la souris) est autorisé | | autoFitType | number | Le contenu est formaté pour tenir dans les cellules, les cellules et les en-têtes. Valeurs disponibles : | Constante | Valeur | Description |
|---|
| vk auto fit type cell | 0 | Le contenu ajuste automatiquement les cellules | | vk auto fit type cell with header | 1 | Le contenu ajuste automatiquement les cellules et les en-têtes |
| | backColor | string | Chaîne de couleur utilisée pour représenter la couleur de fond de la zone, comme "rouge", "#FFFF00", "rgb(255,0,0)", "Accent 5". La couleur de fond initiale est masquée lorsqu'une image de fond est définie. | | backgroundImage | string / picture / file | Image de fond de la zone. | | backgroundImageLayout | number | Comment l'image de fond s'affiche. Valeurs disponibles : | Constante | Valeur | Description |
|---|
| vk image layout center | 1 | Au centre de la zone. | | vk mise en page d'image aucun | 3 | Dans le coin supérieur gauche de la zone à sa taille originale. | | vk image layout stretch | 0 | Remplit la zone. | | vk image layout zoom | 2 | Affiché avec son rapport d'aspect d'origine. |
| | calcOnDemand | boolean | Les formules ne sont calculées que lorsqu'elles sont demandées. | | columnResizeMode | number | Mode redimensionnement pour les colonnes. Valeurs disponibles : | Constante | Valeur | Description |
|---|
| vk resize mode normal | 0 | Utilise le mode de redimensionnement normal (c'est-à-dire que les colonnes restantes sont affectées) | | vk resize mode split | 1 | Utiliser le mode fractionné (les colonnes restantes ne sont pas affectées) |
| | copyPasteHeaderOptions | number | En-têtes à inclure lorsque les données sont copiées ou collées. En-têtes à inclure lorsque les données sont copiées ou collées.Valeurs disponibles : | Constante | Valeur | Description |
|---|
| vk copy paste header options all headers | 3 | Inclut les en-têtes sélectionnés lors de la copie des données ; surcharge les en-têtes sélectionnés lors du collage des données. | | vk copy paste header options column headers | 2 | Inclut les en-têtes de colonnes sélectionnés lors de la copie des données ; surcharge les en-têtes de colonnes sélectionnés lors du collage des données. | | vk copy paste header options no headers | 0 | Les en-têtes de colonnes et de lignes ne sont pas incluses lors de la copie des données ; les en-têtes de colonnes ou de lignes sélectionnées ne sont pas superposées lors du collage des données. |
| | customList | collection | Liste pour que les utilisateurs personnalisent le remplissage par glisser-déposer, en priorisant la correspondance de cette liste dans chaque remplissage. Chaque élément de collection est une collection de strings. See on GrapeCity's website. | | cutCopyIndicatorBorderColor | string | Couleur de bordure de l'indicateur affiché lorsque l'utilisateur coupe ou copie la sélection. | | cutCopyIndicatorVisible | boolean | Afficher un indicateur lors du copier ou du coller de l'élément sélectionné. | | defaultDragFillType | number | Le type de remplissage par défaut du glisser-déposer. Valeurs disponibles :
| Constante | Valeur | Description |
|---|
| vk auto fill type auto | 5 | Remplit automatiquement les cellules. Le type de remplissage par défaut du glisser-déposer.Valeurs disponibles : | Constante | Valeur | Description |
|---|
| vk auto fill type auto | 5 | Remplit automatiquement les cellules. | | vk auto fill type clear values | 4 | Efface les valeurs des cellules. | | vk auto fill type copycells | 0 | Remplit les cellules avec tous les objets de données, y compris les valeurs, la mise en forme et les formules. | | vk auto fill type fill without formatting | 3 | Remplit les cellules avec des valeurs sans les formater. |
| | enableAccessibility | boolean | La prise en charge de l'accessibilité est activée dans la feuille de calcul. | | enableFormulaTextbox | boolean | La zone de texte de la formule est activée. | | grayAreaBackColor | string | Une chaîne de couleur utilisée pour représenter la couleur de fond de la zone grise, comme "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc. | | highlightInvalidData | boolean | Les données non valides sont surlignées. | | iterativeCalculation | boolean | Active le calcul itératif. See on Grapecity's website. | | iterativeCalculationMaximumChange | numérique | Montant maximum de changement entre deux valeurs de calcul. | | iterativeCalculationMaximumIterations | numérique | Nombre de fois maximum que la formule doit recalculer. | | newTabVisible | boolean | Afficher un onglet spécial pour permettre aux utilisateurs d'insérer de nouvelles feuilles. | | numbersFitMode | number | Modifie le mode d'affichage lorsque la largeur des données date/nombre est plus longue que la largeur des colonnes. Valeurs disponibles : vk| Constante | Valeur | Description |
|---|
| vk numbers fit mode mask | 0 | Remplace le contenu des données par "###" et affiche l'astuce | | numbers fit mode overflow | 1 | Affiche le contenu des données sous forme de chaîne de caractères. Si la cellule suivante est vide, le contenu est débordé. |
| | pasteSkipInvisibleRange | boolean | Paste or skip pasting data in invisible ranges: - False (default): paste data
- True: Skip pasting in invisible ranges
See Grapecity's docs for more information on invisible ranges. | | referenceStyle | number | Style pour les références de cellules et de plages dans les formules de cellules. Valeurs disponibles : | Constante | Valeur | Description |
|---|
| vk reference style A1 | 0 | Utilise le style A1. | | vk reference style R1C1 | 1 | Utiliser le style R1C1 |
| | resizeZeroIndicator | number | Règle de dessin lorsque la ligne ou la colonne est redimensionnée à zéro. Règle de dessin lorsque la ligne ou la colonne est redimensionnée à zéro.Valeurs disponibles : | Constante | Valeur | Description |
|---|
| vk resize zero indicator default | 0 | Utilise la politique de dessin actuelle lorsque la ligne ou la colonne est redimensionnée à zéro. |
| | rowResizeMode | number | La façon dont les lignes sont redimensionnées. Les valeurs disponibles sont les mêmes que columnResizeMode | | scrollbarAppearance | number | Apparence de la barre de défilement. Valeurs disponibles : Valeurs disponibles : | Constante | Valeur | Description |
|---|
| vk scrollbar appearance mobile | 1 | Apparence de la barre de défilement mobile |
| Constante | Valeur | Description |
|---|
| vk scrollbar appearance mobile | 1 | Apparence de la barre de défilement mobile | | vk scrollbar appearance skin (default) | 0 | Apparence classique de la barre de défilement, similaire à celle d'Excel. |
| | scrollbarMaxAlign | boolean | La barre de défilement s'aligne sur la dernière ligne et la dernière colonne de la feuille courante. | | scrollbarShowMax | boolean | Les barres de défilement affichées sont basées sur le nombre total de colonnes et de lignes dans la feuille. | | scrollByPixel | boolean | Activer le défilement de précision par pixel. | | scrollIgnoreHidden | boolean | La barre de défilement ignore les lignes ou colonnes cachées. | | scrollPixel | integer | Définit le défilement par ce nombre de pixels lorsque scrollByPixel est true. Définit le défilement par ce nombre de pixels lorsque scrollByPixel est true. Par exemple : le delta de défilement est de 3, scrollPixel est de 5, le défilement final de pixels est de 15. | | showDragDropTip | boolean | Afficher l'info bulle de glisser-déposer. | | showDragFillSmartTag | boolean | Afficher la boîte de dialogue de remplissage par glisser-déplacer. | | showDragFillTip | boolean | Afficher l'info bulle de glisser-remplir. | | showHorizontalScrollbar | boolean | Afficher la barre de défilement horizontale. | | showResizeTip | number | Comment afficher l'info-bulle de redimensionnement. Comment afficher l'info-bulle de redimensionnement.Valeurs disponibles : | Constante | Valeur | Description |
|---|
| vk show resize tip both | 3 | Des conseils pour le redimensionnement horizontal et vertical s'affichent. | | vk show resize tip column | 1 | Seul le conseil de redimensionnement horizontal s'affiche. | | vk show resize tip none | 0 | Aucune conseil de redimensionnement n'est affiché. |
| | showScrollTip | number | Comment afficher les info-bulles de défilement. Comment afficher les info-bulles de défilement.Valeurs disponibles : | Constante | Valeur | Description |
|---|
| vk show scroll tip both | 3 | Des conseils de défilement horizontal et vertical s'affichent. | | vk show scroll tip none | 0 | No scroll tip is displayed. | | vk show scroll tip none | Aucun conseil de défilement n'est affiché. |
| | showVerticalScrollbar | boolean | Afficher la barre de défilement verticale. | | tabEditable | boolean | La barre d'onglets de la feuille peut être modifiée. | | tabNavigationVisible | boolean | Afficher l'onglet de navigation de la feuille. | | tabStripPosition | number | Position de la barre d'onglets. Position de la barre d'onglets.Valeurs disponibles : | Constante | Valeur | Description |
|---|
| vk tab strip position bottom | 0 | La position de la barre de tabulation est relative au bas du classeur. | | vk tab strip position left | 2 | La position de la barre de tabulation est relative à la gauche du classeur. | | vk tab strip position right | 3 | La position de la barre de tabulation est relative à la droite du classeur. |
| | tabStripRatio | number | Valeur de pourcentage (0.x) qui spécifie combien d'espace horizontal sera alloué à la barre d'onglets. Le reste de la zone horizontale (1 - 0.x) sera alloué à la barre de défilement horizontale. | | tabStripVisible | boolean | Afficher la barre d'onglets de la feuille. | | tabStripWidth | number | Largeur de la barre d'onglets lorsque la position est à gauche ou à droite. Par défaut et minimum 80. | | useTouchLayout | boolean | Utiliser ou non le format tactile pour présenter le composant Spread. |
Pour définir l'option allowExtendpasteRange dans "ViewProArea" :
var $workbookOptions : Object
$workbookOptions:= New Object
$workbookOptions.allowExtendPasteRange:=True
VP SET WORKBOOK OPTIONS("ViewProArea";$workbookOptions)
VP Get workbook options
VP SHOW CELL ( rangeObj : Object { ; vPos : Integer; hPos : Integer } )
| Paramètres | Type | | Description |
|---|
| rangeObj | Object | -> | Objet plage | | vPos | Integer | -> | Position verticale de la vue de la cellule ou de la ligne | | hPos | Integer | -> | Position horizontale de la vue de la cellule ou de la ligne |
La commande VP SHOW CELL repositionne verticalement et horizontalement la vue de rangeObj.
Dans rangeObj, passez un objet plage de cellules que vous souhaitez afficher. La vue de rangeObj sera positionnée verticalement ou horizontalement (i.e., là où rangeObj apparait) en fonction des paramètres vPos et hPos. Le paramètre vPos définit la position verticale souhaitée pour afficher rangeObj et le paramètre hPos définit la position horizontale souhaitée pour afficher rangeObj.
Les sélecteurs suivants sont disponibles :
| Sélecteur | Description | Disponible avec vPos | Disponible avec hPos |
|---|
vk position bottom | Alignement vertical vers le bas de la cellule ou de la ligne. | X | | vk position center | Alignement vers le centre. L'alignement s'effectuera par rapport à la limite de la cellule, de la ligne ou de la colonne, selon la position de vue indiquée :Position de vue verticale : cellule ou ligne ;Position de vue horizontale : cellule ou colonne | X | X | vk position left | Alignement horizontal vers la gauche de la cellule ou de la colonne | | X | vk position nearest | Alignement vers la limite la plus proche (haut, bas, gauche, droite, centre). L'alignement s'effectuera par rapport à la limite de la cellule, de la ligne ou de la colonne, selon la position de vue indiquée :Position de vue verticale (haut, milieu, bas) : cellule ou ligne ;Position de vue horizontale (gauche, centre, droit) : cellule ou colonne | X | X | vk position right | Alignement horizontal vers la droite de la cellule ou de la colonne | | X | vk position top | Alignement vertical vers le haut de la cellule ou de la ligne | X | |
Cette commande n'est efficace que si le repositionnement de la vue est possible. Par example, si rangeObj est contenu dans la cellule A1 (la première colonne et la première ligne) de la feuille courante, le repositionnement de la vue n'apportera aucun changement, étant donné que les limites verticales et horizontales ont déjà été atteintes (i.e., il n'est pas possible de faire dérouler davantage vers le haut ou vers la gauche). De même si rangeObj est contenu dans la cellule C3 et que la vue est repositionnée au centre ou en bas à droite. La vue demeure inchangée.
Vous souhaitez visualiser la cellule dans la colonne AY, ligne 51, au centre de la zone 4D View Pro.
$displayCell:=VP Cell("myVPArea";50;50)
// Déplacez la vue pour afficher la cellule
VP SHOW CELL($displayCell;vk position center;vk position center)
Résultat:
Le même code ainsi que les sélecteurs verticaux et horizontaux ont été modifiés pour afficher la même cellule en haut à droite de la zone 4D View Pro :
$displayCell:=VP Cell("myVPArea";50;50)
// Déplacez la vue pour afficher la cellule
VP SHOW CELL($displayCell;vk position top;vk position right)
Résultat:
VP CELL
VP Get active cell
VP Get selection
VP RESET SELECTION
VP SET ACTIVE CELL
VP SET SELECTION
VP SUSPEND COMPUTING ( vpAreaName : Text )
| Paramètres | Type | | Description |
|---|
| vpAreaName | Text | -> | Nom d'objet formulaire zone 4D View Pro |
La commande VP SUSPEND COMPUTING arrête le calcul de toutes les formules dans vpAreaName. Cette commande est utile lorsque vous souhaitez suspendre les calculs dans cette zone 4D View Pro, afin de modifier manuellement les formules sans générer d'erreurs avant la fin de vos modifications.
La commande met en pause les calculs dans 4D View Pro. Les formules déjà calculées restent inchangées, mais les formules ajoutées après l'exécution de la commande VP SUSPEND COMPUTING ne sont pas calculées.
Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.
Le service de calcul de 4D View Pro maintient un compteur d'actions de suspension/reprise. Par conséquent, chaque exécution de la commande VP SUSPEND COMPUTING doit être balancée par une exécution correspondante de la commande VP RESUME COMPUTING. Toute formule modifiée durant la phase de suspension des calculs sera recalculée lorsque la commande sera exécutée.
Vous avez ajouté deux boutons au formulaire afin que l'utilisateur puisse suspendre/reprendre les calculs :
Le code du bouton Suspend Computing :
//pause calculations while users enter information
If(FORM Event.code=On Clicked)
VP SUSPEND COMPUTING("ViewProArea")
End if
If(FORM Event.code=On Clicked)
VP RESUME COMPUTING("ViewProArea")
End if
VP RECOMPUTE FORMULAS
VP RESUME COMPUTING
|
| 
