Version: 20

Liste des méthodes

Attention : Les commandes listées dans cette page ne sont pas thread-safe.

A - C - D - E - F - G - I - M - N - O - P - R - S

A

VP ADD FORMULA NAME

VP ADD FORMULA NAME ( vpAreaName : Text ; vpFormula : Text ; name : Text { ; options : Object } )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
vpFormula	Text	->	Formule 4D View Pro
name	Text	->	Nom de la formule
options	Object	->	Options de la formule nommée

Description

La commande VP ADD FORMULA NAME permet de créer ou de modifier une formule nommée dans le document courant.

Les formules nommées créées par cette commande sont stockées dans le document.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Passez la formule 4D View Pro que vous souhaitez nommer dans vpFormula. Pour plus d'informations sur la syntaxe des formules, veuillez consulter la section Formules et Fonctions.

Passez le nouveau nom de la formule dans name. Si le nom est déjà utilisé dans le même scope, la nouvelle formule nommée remplace la formule existante. A noter que vous pouvez utiliser le même nom pour plusieurs scopes (ci-dessous).

Vous pouvez passer un objet avec des propriétés additionnelles pour la plage nommée dans options. Les propriétés suivantes sont prises en charge :

Propriété	Type	Description
scope	Number	Scope de la formule. Vous pouvez passer l'indice de la feuille (la numérotation commence à zéro) ou utiliser les constantes suivantes : `vk current sheet` `vk workbook` Le scope détermine si le nom d'une formule est propre à une feuille (scope=sheet index ou `vk current sheet`), ou s'il s'applique à l'ensemble du classeur (scope=`vk workbook`).
comment	Text	Commentaire associé à une formule nommée

Exemple

VP ADD FORMULA NAME("ViewProArea";"SUM($A$1:$A$10)";"Total2")

Voir également

Cell references
VP Get formula by name
VP Get names

VP ADD RANGE NAME

VP ADD RANGE NAME ( rangeObj : Object ; name : Text { ; options : Object } )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
name	Text	->	Nom de la formule
options	Object	->	Options de la formule nommée

Description

La commande VP ADD RANGE NAME crée ou modifie une plage nommée dans le document courant.

Les plages nommées créées par cette commande sont stockées dans le document.

Dans rangeObj, passez la plage que vous souhaitez nommer, et passez le nouveau nom de la plage dans name. Si le nom est déjà utilisé dans le même scope, la nouvelle plage nommée remplace la plage existante. A noter que vous pouvez utiliser le même nom pour plusieurs scopes (ci-dessous).

Vous pouvez passer un objet avec des propriétés supplémentaires pour la plage nommée dans options. Les propriétés suivantes sont prises en charge :

Propriété	Type	Description
scope	Number	Scope de la plage. Vous pouvez passer l'indice de la feuille (la numérotation commence à zéro) ou utiliser les constantes suivantes : `vk current sheet` `vk workbook` Le scope détermine si le nom d'une plage est propre à une feuille (scope=sheet index ou `vk current sheet`), ou s'il s'applique à l'ensemble du classeur (scope=`vk workbook`).
comment	Text	Commentaire associé à une plage nommée

Une plage nommée est en réalité une formule nommée contenant des coordonnées. VP ADD RANGE NAME facilite la création de plages nommées, mais la commande VP ADD FORMULA NAME permet également d'en créer.
Les formules définissant des plages nommées peuvent être récupérées à l'aide de la commande VP Get formula by name.

Exemple

Vous souhaitez créer une plage nommée à partir d'une plage contenant une cellule :

$range:=VP Cell("ViewProArea";2;10)
VP ADD RANGE NAME($range;"Total1")

Voir également

VP Get names
VP Name

VP ADD SELECTION

VP ADD SELECTION ( rangeObj : Object )

Paramètres	Type		Description
rangeObj	Text	->	Objet plage

Description

La commande VP ADD SELECTION ajoute les cellules spécifiées aux cellules sélectionnées.

Dans rangeObj, passez un objet plage de plusieurs cellules à ajouter à la sélection courante.

La cellule active n'est pas modifiée.

Exemple

Les cellules sélectionnées sont les suivantes :

Le code suivant ajoutera des cellules à votre sélection :

$currentSelection:=VP Cells("myVPArea";3;4;2;3)
VP ADD SELECTION($currentSelection)

Résultat:

Voir également

VP Get active cell
VP Get selection
VP RESET SELECTION
VP SET ACTIVE CELL
VP SET SELECTION
VP SHOW CELL

VP ADD SHEET

VP ADD SHEET ( vpAreaName : Text )
VP ADD SHEET ( vpAreaName : Text ; index : Integer )
VP ADD SHEET ( vpAreaName : Text ; sheet : Integer ; name : Text )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
sheet	Integer	->	Indice de la nouvelle feuille
name	Text	->	Nom de la feuille

Description

La commande VP ADD SHEET insère une feuille dans le document chargé dans vpAreaName.

Passez le nom de la zone 4D View Pro dans vpAreaName.

Dans sheet, vous pouvez passer le numéro de la nouvelle feuille. Si l'index passé est inférieur ou égal à 0, la commande insère la nouvelle feuille au début. Si l'index est supérieur au nombre de feuilles, la commande insère la nouvelle feuille après les feuilles existantes.

La numérotation démarre à 0.

Dans name, vous pouvez passer un nom pour la nouvelle feuille. Le nouveau nom ne peut pas contenir les caractères suivants : *, :, [, ], ?,\,/

Exemple

Le document comporte actuellement 3 feuilles :

vp-document-with-3-sheets

Pour insérer une feuille à la troisième position (index 2) et la nommer "March" :

VP ADD SHEET("ViewProArea";2;"March")

vp-add-sheet

Voir également

VP REMOVE SHEET

VP ADD SPAN

VP ADD SPAN ( rangeObj : Object )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage

Description

La commande VP ADD SPAN combine les cellules de rangeObj en une seule cellule fusionnée.

Dans rangeObj, passez une plage de cellules. Les cellules de la plage sont jointes, afin de créer une cellule plus large qui s'étend sur plusieurs colonnes et/ou lignes. Vous pouvez passer plusieurs plages de cellules pour créer plusieurs fusions de cellules en même temps. A noter que si les plages de cellules se chevauchent, seule la première plage est utilisée.

Seules les données contenues dans la cellule supérieure gauche sont affichées. Les données des autres cellules combinées sont cachées jusqu'à ce que la fusion soit retirée.
Les données masquées, contenues dans les cellules fusionnées, sont accessibles via des formules (commençant par la cellule supérieure gauche).

Exemple

Pour fusionner les cellules First quarter et Second quarter avec les deux cellules côte à côte, et de fusionner la cellule South area avec les deux lignes en-dessous :

initial-document

 //  Plage First quarter
 $q1:=VP Cells("ViewProArea";2;3;3;1)

// Plage Second quarter
 $q2:=VP Cells("ViewProArea";5;3;3;1)

  // Plage South area
 $south:=VP Cells("ViewProArea";0;5;1;3)

 VP ADD SPAN(VP Combine ranges($q1;$q2;$south))

vp-add-span-result

Voir également

4D View Pro Range Object Properties
VP Get spans
VP REMOVE SPAN

VP ADD STYLESHEET

VP ADD STYLESHEET ( vpAreaName : Text ; styleName : Text ; styleObj : Object { ; sheet : Integer } )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
styleName	Text	->	Nom du style
styleObj	Object	->	Objet définissant les propriétés de l'attribut
sheet	Integer	->	Indice de la feuille (feuille courante si omis)

Description

La commande VP ADD STYLESHEET crée ou modifie la feuille de style styleName basée sur la combinaison de propriétés indiquées dans styleObj dans le document courant. Si une feuille de style ayant le même nom et le même index existe déjà dans le document, cette commande l'écrasera et le remplacera avec les nouvelles valeurs.

Les feuilles de style créées par cette commande sont sauvegardées avec le document.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Le paramètre styleName vous permet de nommer la feuille de style. Si le nom existe déjà dans le même scope, la nouvelle feuille de style remplace la feuille existante. A noter que vous pouvez utiliser le même nom pour plusieurs scopes (ci-dessous).

Dans styleObj, définissez les propriétés de la feuille de style (ex : police, alignement, bordures, etc.). For the full list of style properties, see Style object properties.

Vous pouvez désigner l'emplacement dans lequel vous souhaitez définir la feuille de style dans le paramètre optionnel sheet, à l'aide de l'indice de la feuille (la numérotation commence à zéro) ou à l'aide des constantes suivantes :

vk current sheet
vk workbook

Si une feuille de style styleName est définie au niveau du workbook et de la feuille lors de son paramétrage, le niveau de la feuille est prioritaire par rapport à celui du workbook.

Vous pouvez appliquer la feuille de style à l'aide des commandes VP SET DEFAULT STYLE ou VP SET CELL STYLE.

Exemple

Le code suivant :

$styles:=New object
$styles.backColor:="green"

//Objet Bordure de ligne
$borders:=New object("color";"green";"style";vk line style medium dash dot)

$styles.borderBottom:=$borders
$styles.borderLeft:=$borders
$styles.borderRight:=$borders
$styles.borderTop:=$borders

VP ADD STYLESHEET("ViewProArea";"GreenDashDotStyle";$styles)

//Pour appliquer le style
VP SET CELL STYLE(VP Cells("ViewProArea";1;1;2;2);New object("name";"GreenDashDotStyle"))

créera et appliquera l'objet style GreenDashDotStyle suivant :

{
 backColor:green,
 borderBottom:{color:green,style:10},
 borderLeft:{color:green,style:10},
 borderRight:{color:green,style:10},
 borderTop:{color:green,style:10}
}

Voir également

4D View Pro Style Objects and Style Sheets
VP Get stylesheet
VP Get stylesheets
VP REMOVE STYLESHEET
VP SET CELL STYLE
VP SET DEFAULT STYLE

VP All

VP All ( vpAreaName : Text { ; sheet : Integer } ) : Object

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)
Résultat	Object	<-	Objet plage de toutes les cellules

Description

La commande VP ALL retourne une nouvelle plage référençant toutes les cellules.

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 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 ou si vous passez vk current sheet, la feuille courante est utilisée.

Exemple

Vous souhaitez définir une plage pour toutes les cellules de la feuille courante :

$all:=VP All("ViewProArea") // toutes les cellules de la feuille courante

Voir également

VP Cell
VP Cells
VP Column
VP Combine ranges
VP Name
VP Row

C

VP Cell

VP Cell ( vpAreaName ; column : Integer ; row : Integer ; Text { ; sheet : Integer } ) : Object

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
column	Longint	->	Indice de la colonne
row	Longint	->	Indice de la ligne
sheet	Integer	->	Numéro d'indice de la feuille (feuille courante si omis)
Résultat	Object	<-	Objet plage d'une seule cellule

Description

La commande VP Cells retourne une nouvelle plage référençant une cellule.

Cette commande s'applique aux plages d'une seule cellule. Pour créer une plage de plusieurs cellules, utilisez la commande VP Cells.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Le paramètre column définit la colonne de la plage. Passez l'indice de la colonne dans ce paramètre.

Le paramètre row définit la ligne de la plage. Passez l'indice de la ligne dans ce paramètre.

Dans le paramètre optionnel sheet, vous pouvez désigner l'indice de la feuille dans laquelle sera définie la plage. Si le paramètre est omis ou si vous passez vk current sheet, la feuille courante est utilisée par défaut.

l'indexation démarre à 0.

Exemple

Vous souhaitez définir une plage pour la cellule de la feuille courante (sur la feuille courante) :

vp-cell

Le code est le suivant :

$cell:=VP Cell("ViewProArea";2;4) // C5

Voir également

VP All
VP Cells
VP Column
VP Combine ranges
VP Name
VP Row

VP Cells

VP Cells ( vpAreaName : Text ; column: Integer ; row: Integer ; columnCount : Integer ; rowCount : Integer { ; sheet : Integer } ) : Object

Historique

Release	Modifications
17 R4	Ajout

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
column	Integer	->	Indice de la colonne
row	Integer	->	Indice de la ligne
columnCount	Integer	->	Nombre de colonnes
rowCount	Integer	->	Nombre de lignes
sheet	Integer	->	Numéro d'indice de la feuille (feuille courante si omis)
Résultat	Object	<-	Objet de plage de cellules

Description

La commande VP Cells retourne une nouvelle plage référençant des cellules spécifiques.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Le paramètre column définit la première colonne de la plage de cellules. Passez l'indice de la colonne (la numérotation commence à zéro) dans ce paramètre. Si la plage contient plusieurs colonnes, vous devez également utiliser le paramètre columnCount.

Dans le paramètre row, vous pouvez définir l'emplacement de la ou des lignes de la plage de cellules. Passez l'indice de la ligne (la numérotation commence à zéro) dans ce paramètre. Si la plage contient plusieurs lignes, vous devez également utiliser le paramètre rowCount.

Le paramètre columnCount vous permet de définir le nombre total de colonnes comprises dans la plage. columnCount doit être supérieur à 0.

Le paramètre rowCount vous permet de définir le nombre total de lignes comprises dans la plage. rowCount doit être supérieur à 0.

Exemple

Vous souhaitez définir un objet plage pour les cellules suivantes (de la feuille courante) :

Le code est le suivant :

$cells:=VP Cells("ViewProArea";2;4;2;3) // de C5 à D7

Voir également

VP All
VP Cells
VP Column
VP Combine ranges
VP Name
VP Row

VP Column

VP Column ( vpAreaName : Text ; column: Integer ; columnCount : Integer { ; sheet : Integer } ) : Object

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
column	Integer	->	Indice de la colonne
columnCount	Integer	->	Nombre de colonnes
sheet	Integer	->	Numéro d'indice de la feuille (feuille courante si omis)
Résultat	Object	<-	Objet de plage de cellules

Description

La commande VP Column retourne une nouvelle plage référençant une ou plusieurs colonnes.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Le paramètre column définit la première colonne de la plage. Passez l'indice de la colonne (la numérotation commence à zéro) dans ce paramètre. Si la plage contient plusieurs colonnes, vous devez également utiliser le paramètre optionnel columnCount.

Le paramètre optionnel columnCount vous permet de définir le nombre total de colonnes comprises dans la plage. columnCount doit être supérieur à 0. Si le paramètre est omis, la valeur 1 sera définie par défaut et une plage de type colonne sera créée.

Exemple

Vous souhaitez définir une plage pour la colonne ci-dessous (dans la feuille courante) :

Le code est le suivant :

 $column:=VP Column("ViewProArea";3) // colonne D

Voir également

VP All
VP Cells
VP Column
VP Combine ranges
VP Name
VP Row
VP SET COLUMN ATTRIBUTES

VP COLUMN AUTOFIT

VP COLUMN AUTOFIT ( rangeObj : Object )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage

Description

La commande VP COLUMN AUTOFIT dimensionne automatiquement la ou les colonne(s) dans rangeObj en fonction de leur contenu.

Dans rangeObj, passez un objet plage contenant une plage de colonnes dont la taille doit être gérée automatiquement.

Exemple

Les colonnes suivantes sont toutes de la même taille et n'affichent pas certaines parties du texte :

La sélection des colonnes et l'exécution du code suivant :

 VP COLUMN AUTOFIT(VP Get selection("ViewProarea"))

redimensionne les colonnes pour correspondre à la taille du contenu :

Voir également

VP ROW AUTOFIT

VP Combine ranges

VP Combine ranges ( rangeObj : Object ; otherRangeObj : Object {;...otherRangeObjN : Object } ) : Object

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
otherRangeObj	Object	->	Objet plage
Résultat	Object	<-	Objet contenant une plage combinée

Description

La commande VP Combine Ranges retourne une nouvelle plage qui comprend au moins deux plages existantes. Toutes les plages doivent provenir de la même zone 4D View Pro.

Dans rangeObj, passez la première plage.

Dans otherRangeObj, passez une ou plusieurs autres plages à combiner avec rangeObj.

La commande incorpore rangeObj et otherRangeObj par référence.

Exemple

Vous souhaitez combiner des plages de type cellule, colonne et ligne dans une nouvelle plage distincte :

 $cell:=VP Cell("ViewProArea";2;4) // C5
 $column:=VP Column("ViewProArea";3) // colonne D
 $row:=VP Row("ViewProArea";9) // ligne 10

 $combine:=VP Combine ranges($cell;$column;$row)

Voir également

VP All
VP Cells
VP Column
VP Combine ranges
VP Name
VP Row
VP SET COLUMN ATTRIBUTES

VP Convert from 4D View

VP Convert from 4D View ( 4DViewDocument : Blob ) : Object

Paramètres	Type		Description
4DViewDocument	Blob	->	Document 4D View
Résultat	Object	<-	Objet 4D View Pro

Description

La commande VP Convert from 4D View vous permet de convertir un document 4D View existant en un objet 4D View Pro.

Cette commande ne nécessite pas l'installation du plug-in 4D View dans votre environnement.

Dans le paramètre 4DViewDocument, passez une variable ou un champ BLOB contenant le document 4D View à convertir. La commande retourne un objet 4D View Pro dans lequel toutes les informations stockées à l'origine dans le document 4D View sont converties en attributs 4D View Pro.

Exemple

Vous souhaitez obtenir un objet 4D View Pro à partir d'une zone 4D View stockée dans un BLOB :

C_OBJECT($vpObj)
$vpObj:=VP Convert from 4D View($pvblob)

VP Convert to picture

VP Convert to picture ( vpObject : Object {; rangeObj : Object} ) : Picture

Paramètres	Type		Description
vpObject	Object	->	Objet 4D View Pro contenant la zone à convertir
rangeObj	Object	->	Objet plage
Résultat	Picture	<-	Image SVG de la zone

Description

La commande VP Convert to picture convertit l'objet 4D View Pro vpObject (ou la plage rangeObj dans vpObject) en une image SVG.

Cette commande est utile, par exemple :

pour intégrer un document 4D View Pro dans un autre document, tel qu'un document 4D Write Pro
pour imprimer un document 4D View Pro sans le charger dans une zone 4D View Pro.

Dans vpObject, passez l'objet 4D View Pro que vous souhaitez convertir. Cet objet doit avoir été préalablement analysé à l'aide de VP Export to object ou enregistré avec VP EXPORT DOCUMENT.

Le processus de conversion SVG nécessite que les expressions et les formats (cf. Format de cellule 4D View Pro) inclus dans la zone 4D View Pro soient évalués au moins une fois, afin d'être correctement exportés. Si vous convertissez un document qui n'a pas été évalué au préalable, les expressions ou les formats peuvent être rendus de manière inattendue.

Dans rangeObj, passez une plage de cellules à convertir. Par défaut, si ce paramètre est omis, tout le contenu du document est converti.

Les contenus de document sont convertis en tenant compte de leurs attributs d'affichage, y compris les formats (voir la note ci-dessus), la visibilité des en-têtes, des colonnes et des lignes. La conversion des éléments suivants est prise en charge :

Texte : style / police / taille / alignement / rotation / format
Arrière-plan de cellule : couleur / image
Bordure de cellule : épaisseur / couleur / style
Fusion de cellules
Images
Hauteur de lignes
Largeur de colonnes
Visibilité : colonnes / lignes cachées.
La visibilité du quadrillage dépend de l'attribut de document défini avec VP SET PRINT INFO.

Résultat

La commande retourne une image au format SVG.

Exemple

Vous souhaitez convertir une zone 4D View Pro en SVG, prévisualiser le résultat et l'envoyer dans une variable image :

C_OBJECT($vpAreaObj)
C_PICTURE($vPict)
$vpAreaObj:=VP Export to object("ViewProArea")
$vPict:=VP Convert to picture($vpAreaObj) //exporter toute la zone

Voir également

VP EXPORT DOCUMENT
VP Export to object
VP SET PRINT INFO

VP Copy to object

Historique

Release	Modifications
19 R4	Ajout

VP Copy to object ( rangeObj : Object {; options : Object} ) : Object

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
options	Object	->	Options supplémentaires
Résultat	Object	<-	Objet retourné. Contient les données copiées

Description

La commande VP Copy to object copie le contenu, le style et les formules de rangeObj vers un objet.

Dans rangeObj, passez la plage de cellules contenant les valeurs, formatages et formules à copier. Si rangeObj est une plage combinée, seule la première est utilisée.

Vous pouvez passer un paramètre facultatif options contenant les propriétés suivantes :

Propriété Type Description

copy Boolean Vrai (par défaut) pour conserver les valeurs, formatages et formules après exécution de la commande. Faux pour les supprimer.

copyOptions

Longint

Spécifie ce qui est copié ou déplacé. Valeurs possibles :

Valeur	Description
`vk clipboard options all` (par défaut)	Copie tous les objets de données, y compris les valeurs, formats et formules.
`vk clipboard options formatting`	Copie uniquement les formats.
`vk clipboard options formulas`	Copie uniquement les formules.
`vk clipboard options formulas and formatting`	Copie les formules et les formats.
`vk clipboard options values`	Copie uniquement les valeurs.
`vk clipboard options value and formatting`	Copie les valeurs et les formats.

Les options de collage définies dans les options de workbook sont prises en compte.

La commande retourne un objet qui contient les données copiées.

Exemple

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 :

var $originRange; $targetRange; $dataObject; $options : Object

$originRange:=VP Cells("ViewProArea"; 0; 0; 2; 5)

$options:=New object
$options.copy:=True
$options.copyOptions:=vk clipboard options all

$dataObject:=VP Copy to object($originRange; $options)

$targetRange:=VP Cell("ViewProArea"; 4; 0)
VP PASTE FROM OBJECT($targetRange; $dataObject; vk clipboard options all)

Voir également

VP PASTE FROM OBJECT
VP MOVE CELLS
VP Get workbook options
VP SET WORKBOOK OPTIONS

VP CREATE TABLE

Historique

Release	Modifications
19 R8	Support of theme options: `bandColumns`, `bandRows`, `highlightFirstColumn`, `highlightLastColumn`, `theme`
19 R7	Prise en charge de l'option `allowAutoExpand`
19 R6	Ajout

VP CREATE TABLE ( rangeObj : Object ; tableName : Text {; source : Text} {; options : cs.ViewPro.TableOptions} )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
tableName	Text	->	Nom de la table
source	Text	->	Nom de la propriété du Data context à afficher dans la table
options	cs.ViewPro.TableOptions	->	Options supplémentaires

Description

La commande VP CREATE TABLE crée une table dans la plage spécifiée. Vous pouvez créer une table dans une plage de cellules pour faciliter la gestion et l'analyse d'un groupe de données connexes. Un tableau contient généralement des données liées dans des lignes et des colonnes, et tire parti d'un contexte de données.

Dans rangeObj, passez la plage de cellules dans laquelle la table sera créée.

Dans tableName, passez un nom pour la table. Le nom doit :

être unique dans la feuille
inclure au moins 5 caractères
ne pas inclure d'espaces ou commencer par un nombre

In source, you can pass a property name of a data context to display its data in the table. This binds the table to the data context. When the data context is updated, the data displayed in the table is updated accordingly. The source property must contain a collection of objects and each element represents a row.

If you don't specify a source, the command creates an empty table with the size defined in rangeObj.
If the specified source cannot be fully displayed in the document, no table is created.

In the options parameter, pass an object of the cs.ViewPro.TableOptions class that contains the table properties to set.

columnCount doit être supérieur à 0. Passez le nombre total de colonnes dans le paramètre columnCount.

When the column count in rangeObj exceeds the number of columns in tableColumns, the table is filled with additional empty columns.
When the column count in rangeObj is inferior to the number of tableColumns, the table displays a number of columns that match the range's column count.

If you pass a source but no tableColumn option, the command generates columns automatically. In this case, rangeObj must be a cell range. Otherwise, the first cell of the range is used. When generating columns automatically, the following rules apply:

If the data passed to the command is a collection of objects, the property names are used as column titles. Par exemple :

([{ LastName: \"Freehafer\", FirstName: \"Nancy\"},{ LastName: \"John\", FirstName: \"Doe\"})

Here the titles of the columns would be LastName and FirstName.

If the data passed to the command is a collection of scalar values, it must contain a collection of subcollections:
- 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. The number of values in the first subcollection determines how many columns are created.
- The subcollections' indices are used as column titles.
- Chaque sous-collection définit les valeurs des cellules de la ligne. Values can be Integer, Real, Boolean, Text, Date, Null, Time or Picture. A Time value must be an a object containing a time attribute, as described in VP SET VALUE.

This only works when generating columns automatically. You cannot use a collection of scalar data with the tableColumns option.

Exemple

Pour créer une table en utilisant un contexte de données :

// Définir un contexte de données
var $data : Object

$data:=New object()
$data.people:=New collection()
$data.people.push(New object("firstName"; "John"; "lastName"; "Smith"; "email"; "johnsmith@gmail.com"))
$data.people.push(New object("firstName"; "Mary"; "lastName"; "Poppins"; "email"; "marypoppins@gmail.com"))


VP SET DATA CONTEXT("ViewProArea"; $data)

// Définir les colonnes de la table
var $options : cs.ViewPro.TableOptions

$options:=cs.ViewPro.TableOptions.new()
$options.tableColumns:=New collection()
$options.tableColumns.push(cs.ViewPro.TableColumns.new("name"; "First name"; "dataField"; "firstName"))
$options.tableColumns.push(cs.ViewPro.TableColumns.new("name"; "Last name"; "dataField"; "lastName"))
$options.tableColumns.push(cs.ViewPro.TableColumns.new("name"; "Email"; "dataField"; "email"))

// Créer une table à partir de la collection "people"
VP CREATE TABLE(VP Cells("ViewProArea"; 1; 1; $options.tableColumns.length; 1); "ContextTable"; "people"; $options)

Voici le résultat :

Voir également

VP Find table
VP Get table column attributes
VP Get table column index
VP INSERT TABLE COLUMNS
VP INSERT TABLE ROWS
VP REMOVE TABLE
VP RESIZE TABLE
VP SET DATA CONTEXT
VP SET TABLE COLUMN ATTRIBUTES
VP SET TABLE THEME

D

VP DELETE COLUMNS

VP DELETE COLUMNS ( rangeObj : Object )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage

Description

La commande VP DELETE COLUMNS supprime les colonnes de rangeObj.

Dans rangeObj, passez un objet contenant les colonnes à supprimer. Si la plage qui est passée contient :

des lignes et des colonnes, seules les colonnes sont supprimées.
uniquement des lignes, la commande ne fait rien.
Les colonnes sont supprimées de droite à gauche.

Exemple

Pour supprimer les colonnes sélectionnées par l'utilisateur (colonnes B, C et D de l'image ci-dessous) :

saisissez le code suivant :

VP DELETE COLUMNS(VP Get selection("ViewProArea"))

Voir également

VP All
VP Cells
VP Column

VP DELETE ROWS

VP DELETE ROWS ( rangeObj : Object )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage

Description

La commande VP DELETE ROWS supprime les lignes de rangeObj.

Dans rangeObj, passez un objet contenant les lignes à supprimer. Si la plage qui est passée contient :

des lignes et des colonnes, seules les lignes sont supprimées.
uniquement des colonnes, la commande ne fait rien.
Les lignes sont supprimées du bas vers le haut.

Exemple

Pour supprimer les lignes sélectionnées par l'utilisateur (lignes 1, 2 et 3 de l'image ci-dessous) :

saisissez le code suivant :


 VP DELETE ROWS(VP Get selection("ViewProArea"))

Voir également

VP All
VP Cells
VP Column

E

VP EXPORT DOCUMENT

VP EXPORT DOCUMENT ( vpAreaName : Text ; filePath : Text {; paramObj : Object} )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
filePath	Text	->	Chemin d'accès du document
paramObj	Object	->	Options d'export

Description

La commande VP EXPORT DOCUMENT exporte l'objet 4D View Pro attaché à la zone 4D View Pro vpAreaName vers un document sur disque en fonction des paramètres filePath et paramObj.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Dans filePath, passez le chemin de destination et le nom du document que vous souhaitez exporter. Si vous ne spécifiez pas de chemin, le document sera sauvegardé au même niveau que le dossier Projet.

Vous pouvez préciser le format du document en incluant une extension après son nom :

4D View Pro (".4vp")
Microsoft Excel (".xlsx")
PDF (".pdf")
CSV (".txt", or ".csv")

Si l'extension n'est pas incluse mais que le format est spécifié dans paramObj, le fichier exporté aura l'extension qui correspond au format, à l'exception du format CSV (aucune extension n'est ajoutée dans ce cas).

Le paramètre optionnel paramObj vous permet de définir plusieurs propriétés de l'objet 4D View Pro exporté et de lancer une méthode callback (ou méthode de rétro-appel) lorsque l'export est terminé.

Propriété Type Description

format text (optionnel) Désigne le format du fichier exporté : ".4vp" (par défaut), ".xlsx", ".pdf", ".csv" ou ".txt". Vous pouvez passer une des constantes suivantes :
vk 4D View Pro format
vk csv format
vk MS Excel format
vk pdf format
4D ajoute l'extension appropriée au nom du fichier si nécessaire. Si le format défini ne correspond pas à l'extension dans le filePath, il sera ajouté à la fin du filePath. Si un format n'est pas précisé et si aucune extension n'est fournie dans filePath, le format de fichier par défaut est utilisé.

password text Microsoft Excel uniquement (optionnel) - Mot de passe utilisé pour protéger le document MS Excel

formula object Méthode callback à lancer lorsque l'export est terminé. L'utilisation d'une méthode callback est nécessaire lorsque l'export est asynchrone (ce qui est le cas pour les formats PDF et Excel) si vous avez besoin d'un code à exécuter après l'export. La méthode callback doit être utilisée avec la commande Formula (voir ci-dessous pour plus d'informations).

valuesOnly boolean Précise que seules les valeurs issues de formules (le cas échéant) seront exportées.

includeFormatInfo boolean True pour inclure les informations de formatage, sinon False (True par défaut). Les informations de formatage sont utiles dans certains cas, par exemple pour un export en SVG. D'un autre côté, mettre cette propriété à false permet de réduire la durée de l'export.

includeBindingSource Boolean 4DVP et Microsoft Excel uniquement. True (par défaut) pour exporter les valeurs du contexte de données courant en tant que valeurs de cellule dans le document exporté (les contextes de données eux-mêmes ne sont pas exportés). Sinon Faux. La liaison de cellule est toujours exportée. Pour la gestion des contextes de données et des fusions de cellules, voir VP SET DATA CONTEXT et VP SET BINDING PATH.

sheet number PDF uniquement (optionnel) - Numéro de la feuille à exporter (débute à 0). -2=toutes les feuilles visibles (par défaut), -1=feuille courante uniquement

pdfOptions

object

PDF uniquement (optionnel) - Options pour l'export en PDF

Propriété	Type	Description
creator	text	nom de l'application qui a créé le document original à partir duquel il a été converti.
title	text	titre du document.
author	text	nom de la personne ayant créé ce document.
keywords	text	mots-clés associés au document.
subject	text	sujet du document.

csvOptions

object

CSV uniquement (optionnel) - Options pour l'export en CSV

Propriété	Type	Description
range	object	Objet plage de toutes les cellules
rowDelimiter	text	Délimiteur de ligne. Par défaut : "\r\n"
columnDelimiter	text	Délimiteur de colonne. Par défaut : ","

\<customProperty> any Propriété personnalisée qui sera disponible via le paramètre $3 dans la méthode de callback.

Notes sur le format Excel:

Lors de l'export d'un document 4D View Pro en un fichier au format Microsoft Excel, certains paramètres peuvent être perdus. Par exemple, les méthodes et formules 4D ne sont pas prises en charge par Excel. Vous pouvez vérifier les autres paramètres avec cette liste proposée par GrapeCity.
L'export dans ce format est exécuté de manière asynchrone, utilisez la propriété formula de paramObj pour le code à exécuter après l'export.

Notes sur le format PDF :

Lors de l'export d'un document 4D View Pro en un fichier au format PDF, les polices utilisées dans le document sont automatiquement intégrées dans le fichier PDF. Seules les polices OpenType (fichiers .OTF ou .TTF) ayant une table Unicode peuvent être intégrées. Si aucun fichier de polices valide n'est trouvé pour une police, une police par défaut est utilisée à sa place.
L'export dans ce format est exécuté de manière asynchrone, utilisez la propriété formula de paramObj pour le code à exécuter après l'export.

Notes sur le format CSV :

Lors de l'export d'un document 4D View Pro en un fichier au format PDF, certains paramètres peuvent être perdus, car seuls le texte et les valeurs sont sauvegardés.
Toutes les valeurs sont enregistrées sous la forme de chaînes entre guillemets. Pour plus d'informations sur les valeurs séparées par des délimiteurs, consultez cet article de Wikipedia.

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.

Passer une méthode callback (formula)

Lorsque vous passez le paramètre optionnel paramObj, la commande VP EXPORT DOCUMENT vous permet d'utiliser la commande Formula pour appeler une méthode 4D qui sera exécutée une fois que l'export sera terminé. La méthode callback recevra les valeurs suivantes dans des variables locales :

Variable		Type	Description
$1		text	Nom de l'objet 4D View Pro
$2		text	Chemin d'accès de l'objet 4D View Pro exporté
$3		object	Référence au paramObj de la commande
$4		object	Objet retourné par la méthode avec un message de statut
	.success	boolean	Vrai si l'export est réussi, Faux sinon.
	.errorCode	entier	Code d'erreur. Peut être retourné par 4D ou JavaScript.
	.errorMessage	text	Message d'erreur. Peut être retourné par 4D ou JavaScript.

Exemple 1

Vous souhaitez exporter le contenu de la zone "VPArea" vers un document 4D View Pro sur le disque :

var $docPath: Text

$docPath:="C:\\Bases\\ViewProDocs\\MyExport.4VP"
VP EXPORT DOCUMENT("VPArea";$docPath)
//MyExport.4VP est sauvegardé sur votre disque

Exemple 2

Vous souhaitez exporter la feuille courante au format PDF :

var $params: Object
$params:=New object
$params.format:=vk pdf format
$params.sheet:=-1
$params.pdfOptions:=New object("title";"Annual Report";"author";Current user)
VP EXPORT DOCUMENT("VPArea";"report.pdf";$params)

Exemple 3

Vous souhaitez exporter un document 4D View Pro au format ".xlsx" et appeler une méthode qui lance Microsoft Excel avec le document ouvert une fois que l'export est terminé :

 $params:=New object
 $params.formula:=Formula(AfterExport)
 $params.format:=vp MS Excel format //".xlsx"
 $params.valuesOnly:=True

 VP EXPORT DOCUMENT("ViewProArea";"c:\\tmp\\convertedfile";$params)

Méthode AfterExport :

 C_TEXT($1;$2)
 C_OBJECT($3;$4)
 $areaName:=$1
 $filePath:=$2
 $params:=$3
 $status:=$4

 If($status.success=False)
    ALERT($status.errorMessage)
 Else
    LAUNCH EXTERNAL PROCESS("C:\\Program Files\\Microsoft Office\\Office15\\excel "+$filePath)
 End if

Exemple 4

Vous souhaitez exporter la feuille courante dans un fichier .txt avec des valeurs séparées par des "|" :

example-export-csv

var $params : Object
$params:=New object
$params.range:=VP Cells("ViewProArea";0;0;2;5)
$params.rowDelimiter:="\n"
$params.columnDelimiter:="|"
VP EXPORT DOCUMENT("ViewProArea";"c:\\tmp\\data.txt";New object("format";vk csv format;"csvOptions";$params))

Voici le résultat :

example-export-csv

Voir également

VP Convert to picture
VP Export to object
VP Column
VP Print

VP Export to object

VP Export to object ( vpAreaName : Text {; options : Object} ) : Object

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
options	Object	->	Options d'export
Résultat	Object	<-	Objet 4D View Pro

Description

La commande VP Export to object retourne l'objet 4D View Pro attaché à la zone 4D View Pro vpAreaName. Vous pouvez utiliser cette commande par exemple pour stocker la zone 4D View Pro dans un champ objet de la base de données 4D.

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 options, vous pouvez passer l'option d'export suivante, si nécessaire :

Propriété	Type	Description
includeFormatInfo	Boolean	True (défaut) pour inclure les informations de formatage, sinon False. Les informations de formatage sont utiles dans certains cas, par exemple pour un export en SVG. D'un autre côté, mettre cette propriété à false permet de réduire la durée de l'export.
includeBindingSource	Boolean	True (par défaut) pour exporter les valeurs du contexte de données courant en tant que valeurs de cellule dans l'objet exporté (les contextes de données eux-mêmes ne sont pas exportés). Sinon Faux. La liaison de cellule est toujours exportée.

Pour plus d'informations sur les objets 4D View Pro, veuillez vous référer au paragraphe objet 4D View Pro.

Exemple 1

Vous souhaitez lire la propriété "version" de la zone 4D View Pro courante :

var $vpAreaObj : Object
var $vpVersion : Number
$vpAreaObj:=VP Export to object("vpArea")
 // $vpVersion:=OB Get($vpAreaObj;"version")
$vpVersion:=$vpAreaObj.version

Exemple 2

Vous souhaitez exporter la zone, en excluant les informations de formatage :

var $vpObj : Object
$vpObj:=VP Export to object("vpArea";New object("includeFormatInfo";False))

Voir également

VP Convert to picture
VP EXPORT DOCUMENT
VP IMPORT FROM OBJECT

F

VP Find

VP Find ( rangeObj : Object ; searchValue : Text ) : Object
VP Find ( rangeObj : Object ; searchValue : Text ; searchCondition : Object } ) : Object
VP Find ( rangeObj : Object ; searchValue : Text ; searchCondition : Object ; replaceValue : Text ) : Object

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
searchValue	Text	->	Valeur de recherche
searchCondition	Object	->	Objet contenant la/les condition(s) de recherche
replaceValue	Text	->	Valeur de remplacement
Résultat	Object	<-	Objet plage

Description

La commande VP Find recherche dans rangeObj la searchValue. Des paramètres facultatifs peuvent être utilisés pour affiner la recherche et/ou remplacer les résultats trouvés.

Dans le paramètre rangeObj, passez un objet contenant une plage à rechercher.

Le paramètre searchValue vous permet de passer le texte à rechercher dans rangeObj.

Vous pouvez passer le paramètre optionnel searchCondition pour préciser le fonctionnement de la recherche. Les propriétés suivantes sont prises en charge :

Propriété Type Description

afterColumn Integer Le numéro de la colonne située juste avant la colonne de départ de la recherche. Si rangeObj est une plage combinée, le numéro de colonne indiqué doit provenir de la première plage. Valeur par défaut : -1 (début de rangeObj)

afterRow Integer Le numéro de la colonne située juste avant la colonne de départ de la recherche. Si rangeObj est une plage combinée, le numéro de ligne indiqué doit provenir de la première plage. Valeur par défaut : -1 (début de rangeObj)

all Boolean True -Toutes les cellules de rangeObj correspondant à searchValue sont retournées
False - (valeur par défaut) Seule la première cellule de rangeObj correspondant à searchValue est retournée

flags

Integer

`vk find flag exact match`	Tout le contenu de la cellule doit entièrement correspondre à la valeur de recherche
`vk find flag ignore case`	Les majuscules et les minuscules sont considérées comme identiques. Ex : "a" est considérée comme identique à "A".
`vk find flag none`	Aucun indicateur de recherche n'est pris en compte (par défaut)
`vk find flag use wild cards`	Les caractères génériques (,?) peuvent être utilisés dans la chaîne de recherche. Les caractères joker peuvent être utilisés dans n'importe quelle comparaison de chaînes pour correspondre à n'importe quel nombre de caractères : - Pour le caractère zéro ou plusieurs caractères (par exemple, rechercher "bl*" peut donner comme résultat "bl", "black", "blue", et "blob") ? pour un seul caractère (par exemple, rechercher "h?t" peut donner comme résultat "hot", "hat", et "hit"

Ces marqueurs peuvent être combinés. Par exemple: $search.flags:=vk find flag use wild cards+vk find flag ignore case

order

Integer

`vk find order by columns`	La recherche est effectuée par colonnes. Chaque ligne d'une colonne est recherchée avant que la recherche ne passe à la colonne suivante.
`vk find order by rows`	La recherche est effectuée par lignes. Chaque colonne d'une ligne est recherchée avant que la recherche ne passe à la colonne suivante (par défaut)

target

Integer

`vk find target formula`	La recherche est effectuée dans la formule de la cellule
`vk find target tag`	La recherche est effectuée dans la balise de la cellule
`vk find target text`	La recherche est effectuée dans le texte de la cellule (par défaut)

Ces marqueurs peuvent être combinés. Par exemple :$search.target:=vk find target formula+vk find target text

Dans le paramètre optionnel replaceValue, vous pouvez passer du texte pour remplacer toute instance du texte dans la searchValue trouvée dans rangeObj.

Objet retourné

La fonction retourne un objet de plage décrivant chaque valeur de recherche trouvée ou remplacée. Un objet de plage vide est retourné si aucun résultat n'est trouvé.

Exemple 1

Pour trouver la première cellule contenant le mot "Total" :

var $range;$result : Object

$range:=VP All("ViewProArea")

$result:=VP Find($range;"Total")

Exemple 2

Pour trouver "Total" et le remplacer par "Grand Total" :

var $range;$condition;$result : Object

 $range:=VP All("ViewProArea")

 $condition:=New object
 $condition.target:=vk find target text
 $condition.all:=True //Rechercher le document entier
 $condition.flags:=vk find flag exact match

  // Remplacer les cellules contenant uniquement 'Total' dans la feuille courante par "Grand Total"
 $result:=VP Find($range;"Total";$condition;"Grand Total")

  // Rechercher un objet de plage vide
 If($result.ranges.length=0)
    ALERT("Aucun résultat trouvé")
 Else
    ALERT($result.ranges.length+" résultats trouvés")
 End if

VP Find table

Historique

Release	Modifications
19 R7	Ajout

VP Find table ( rangeObj : Object ) : Text

Paramètres	Type		Description
rangeObj	Object	->	Plage de cellule
Résultat	Text	<-	Nom de table

Description

La commande VP Find table retourne le nom de la table à laquelle appartient la cellule de rangeObj.

Dans rangeObj, passez une plage de cellules. Si les cellules désignées n'appartiennent pas à une table, la commande retourne une chaîne vide.

Si rangeObj n'est pas une plage de cellule ou contient plusieurs plages, seule la première cellule de la première plage est utilisée.

Exemple

var $attributes : Object
$attributes:=VP Get table column attributes("ViewProArea"; $tableName; 1)
If ($attributes.dataField#"")
     ...
     End if

Voir également

VP Get table range

VP FLUSH COMMANDS

VP FLUSH COMMANDS ( vpAreaName : Text )

Paramètres	Type		Description
vpAreaName	Text	->	Nom de la zone 4D View Pro dans le formulaire

Description

La commande VP FLUSH COMMANDS exécute immédiatement les commandes empilées et vide le buffer de commandes.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Afin d'améliorer la performance et de réduire le nombre de requêtes envoyées, les commandes 4D View Pro appelées par le développeur sont stockées temporairement dans un buffer de commandes. Lorsqu'elle est appelée, la commande VP FLUSH COMMANDS exécute les commandes en lot au moment de quitter la méthode et vide le buffer de commandes.

Exemple

Vous souhaitez tracer l'exécution des commandes et vider le buffer :

 VP SET TEXT VALUE(VP Cell("ViewProArea1";10;1);"INVOICE")
 VP SET TEXT VALUE(VP Cell("ViewProArea1";10;2);"Invoice date: ")
 VP SET TEXT VALUE(VP Cell("ViewProArea1";10;3);"Due date: ")

 VP FLUSH COMMANDS(("ViewProArea1")
 TRACE

VP Font to object

VP Font to object ( font : Text ) : Object

Paramètres	Type		Description
font	Text	->	Chaîne raccourcie pour la police (shorthand)
Résultat	Object	<-	Objet police

Description

La commande utilitaire VP Font to object retourne un objet à partir d'une chaîne de police abrégée. .

Dans le paramètre font, passez une chaîne de police abrégée pour indiquer les différentes propriétés d'une police (ex : "12 pt Arial"). Cliquez ici pour en savoir plus sur les chaînes raccourcies pour la police.

L'objet retourné contient les attributs de police définis comme propriétés. Pour plus d'informations sur les propriétés disponibles, veuillez vous reporter à la commande VP Object to font.

Exemple 1

Le code suivant :

$font:=VP Font to object("16pt arial")

retournera l'objet $font suivant :

{

family:arial
size:16pt
}

Exemple 2

Voir l'exemple de VP Object to font.

Voir également

4D View Pro Style Objects and Style Sheets
VP Object to font
VP SET CELL STYLE
VP SET DEFAULT STYLE

G

VP Get active cell

VP Get active cell ( vpAreaName : Text { ; sheet : Integer } ) : Object

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)
Résultat	Object	<-	Objet plage d'une seule cellule

Description

La commande VP Get active cell retourne un nouvel objet plage référençant la cellule active, dans laquelle de nouvelles données seront saisies.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Exemple

Le code suivant récupèrera les coordonnées de la cellule active :

$activeCell:=VP Get active cell("myVPArea")

  //returns a range object containing: 
  //$activeCell.ranges[0].column=3
  //$activeCell.ranges[0].row=4
  //$activeCell.ranges[0].sheet=0

Voir également

VP ADD SELECTION
VP Get selection
VP RESET SELECTION
VP SET ACTIVE CELL
VP SET SELECTION
VP SHOW CELL

VP Get binding path

Historique

Release	Modifications
19 R5	Ajout

VP Get binding path ( rangeObj : Object ) : Text

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
Résultat	Text	<-	Nom de l'attribut associé à la cellule

Description

La commande VP Get binding path retourne dans rangeObj le nom de l'attribut associé à la cellule spécifiée.

Dans rangeObj, passez un objet qui est soit une plage de cellules, soit une plage combinée de cellules. A noter que :

Si rangeObj est une plage de plusieurs cellules, la commande retourne le nom d'attribut associé à la première cellule de la plage.
Si rangeObj contient plusieurs plages de cellules, la commande retourne le nom d'attribut associé à la première cellule de la première plage.

Exemple

var $p; $options : Object
var $myAttribute : Text

$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")

$myAttribute:=VP Get binding path(VP Cell("ViewProArea"; 1; 0)) // "lastName"

Voir également

VP SET BINDING PATH
VP Get data context
VP SET DATA CONTEXT

VP Get cell style

VP Get cell style ( rangeObj : Object ) : Object

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
Résultat	Object	<-	Objet style

Description

La commande VP Get cell style retourne un object style pour la première cellule de rangeObj.

Dans rangeObj, passez une plage contenant le style à récupérer.

Si rangeObj contient une plage cellule, le style de la cellule est retourné.
Si rangeObj contient une plage qui n'est pas une plage cellule, le style de la première cellule de la plage est retourné.
Si rangeObj contient plusieurs plages, seul le style de la première cellule de la première plage est retourné.

Exemple

Pour obtenir les détails concernant le style de la cellule sélectionnée (B2) :

Le code suivant :

$cellStyle:=VP Get cell style(VP Get selection("myDoc"))

... retournera cet objet :

{
  "backColor":"Azure",
  "borderBottom":
   {
     "color":#800080,
     "style":5
   }
  "font":"8pt Arial",
  "foreColor":"red",
  "hAlign":1,
  "isVerticalText":"true",
  "vAlign":0
}

Voir également

VP GET DEFAULT STYLE
VP SET CELL STYLE

VP Get column attributes

VP Get column attributes ( rangeObj : Object ) : Collection

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
Résultat	Collection	<-	Collection de propriétés de colonnes

Description

La commande VP Get column attributes retourne une collection de propriétés pour les colonnes de rangeObj.

Dans rangeObj, passez un objet contenant une plage de colonnes dont les attributs seront récupérés.

La collection retournée contient les propriétés des colonnes, qu'elles aient ou non été définies par la commande VP SET COLUMN ATTRIBUTES.

Exemple

Le code suivant :

C_OBJECT($range)
C_COLLECTION($attr)

$range:=VP Column("ViewProArea";1;2)
$attr:=VP Get column attributes($range)

... retournera une collection d'attributs de la plage donnée :

Voir également

VP Get row attributes
VP SET COLUMN ATTRIBUTES
VP SET ROW ATTRIBUTES

VP Get column count

VP Get column count ( vpAreaName : Text { ; sheet : Integer } ) : 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)
Résultat	Integer	<-	Nombre total de colonnes

Description

La commande VP Get column count retourne le nombre total de colonnes de la sheet désignée.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Vous pouvez définir où compter les colonnes à l'aide du paramètre optionnel sheet en passant le numéro d'indice de la feuille (la numérotation démarre à zéro). Si le paramètre est omis ou si vous passez vk current sheet, la feuille courante est utilisée.

Exemple

Le code suivant retourne le nombre de colonnes dans la zone 4D View Pro :

C_INTEGER($colCount)
$colCount:=VP Get column count("ViewProarea")

Voir également

VP Get row count
VP SET COLUMN COUNT
VP SET ROW COUNT

VP Get current sheet

VP Get current sheet ( vpAreaName : Text )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
Résultat	Integer	<-	Indice de la feuille courante

Description

La commande VP Get current sheet retourne le numéro de la feuille courante dans vpAreaName. La feuille courante est la feuille sélectionnée dans le document.

Passez le nom de la zone 4D View Pro dans vpAreaName.

La numérotation démarre à 0.

Exemple

Lorsque la troisième feuille est sélectionnée :

third-sheet

La commande retourne 2 :

$index:=VP Get current sheet("ViewProArea")

Voir également

VP SET CURRENT SHEET

VP Get data context

Historique

Release	Modifications
19 R5	Ajout

VP Get data context ( vpAreaName : Text {; sheet : Integer } ) : Object
VP Get data context ( vpAreaName : Text {; sheet : Integer } ) : Collection

Paramètres	Type		Description
vpAreaName	Object	->	Nom d'objet formulaire zone 4D View Pro
sheet	Integer	->	Indice de la feuille de laquelle obtenir le data context
Résultat	Object \| Collection	<-	Data context

Description

La commande VP Get data context retourne le data context courant d'une feuille de calcul. The returned context includes any modifications made to the contents of the data context.

In sheet, pass the index of the sheet to get the data context from. If no index is passed, the command returns the data context of the current worksheet. If there is no context for the worksheet, the command returns Null.

The function returns an object or a collection depending on the type of data context set with VP SET DATA CONTEXT.

Exemple

To get the data context bound to the following cells:

var $dataContext : Object

$dataContext:=VP Get data context("ViewProArea") // {firstName:Freehafer,lastName:Nancy}

Voir également

VP SET DATA CONTEXT
VP Get binding path
VP SET BINDING PATH

VP Get default style

VP Get default style ( vpAreaName : Text { ; sheet : Integer } ) : Object

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)
Résultat	Object	<-	Default style settings

Description

La commande VP Get default style retourne un objet style par défaut pour une feuille. L'objet retourné contient des propriétés basiques de rendu d'un document ainsi que les propriétés du style par défaut (le cas échéant) définies préalablement à l'aide de la méthode VP SET DEFAULT STYLE. Pour plus d'informations sur les propriétés de style, consultez Objets style et feuilles de style.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Exemple

Pour lire les détails du style par défaut de ce document :

Le code suivant :

$defaultStyle:=VP Get default style("myDoc")

retournera les informations suivantes dans l'objet $defaultStyle :

{
 backColor:#E6E6FA,
 hAlign:0,
 vAlign:0,
 font:12pt papyrus
}

Voir également

VP Get cell style
VP SET DEFAULT STYLE

VP Get formula

VP Get formula ( rangeObj : Object) : Text

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
Résultat	Text	<-	Formula

Description

La commande VP Get formula récupère la formule depuis une plage de cellules désignée.

Dans rangeObj, passez la plage dont vous souhaitez récupérer la formule. Si rangeObj désigne plusieurs cellules ou plusieurs plages, la formule de la première cellule est retournée. Si rangeObj est une cellule qui ne contient pas de formule, la commande retourne une chaine vide.

Exemple

  //fixer une formule
 VP SET FORMULA(VP Cell("ViewProArea";5;2);"SUM($A$1:$C$10)")

 $result:=VP Get formula(VP Cell("ViewProArea";5;2)) // $result="SUM($A$1:$C$10)"

Voir également

VP Get formulas
VP SET FORMULA
VP SET ROW COUNT

VP Get formula by name

VP Get formula by name ( vpAreaName : Text ; name : Text { ; scope : Number } ) : Object

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
name	Text	->	Nom de la plage nommée
scope	Number	->	"Scope" cible (par défaut=feuille courante)
Résultat	Object	<-	Définition de la formule nommée ou de la plage nommée

Description

La commande VP Get formula by name retourne la formule et le commentaire correspondant à la plage nommée ou à la formule nommée qui a été passée dans le paramètre name, ou retourne null si le nom n'existe pas dans le scope défini.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Passez la plage nommée ou la formule nommée que vous souhaitez lire dansname. A noter que les plages nommées sont retournées sous forme de formules contenant des références absolues de cellules.

Le paramètre scope vous permet de définir l'espace de la zone dans lequel lire la formule, en passant l'indice de la feuille (la numérotation débute à 0) ou l'une des constantes suivantes :

vk current sheet
vk workbook

Objet retourné

L'objet retourné contient les propriétés suivantes :

Propriété	Type	Description
formula	Text	Texte de la formule correspondant à la formule nommée ou à la plage nommée. Pour les plages nommées, la formule est une séquence de coordonnées absolues.
comment	Text	Commentaire correspondant à la formule nommée ou à la plage nommée

Exemple

$range:=VP Cell("ViewProArea";0;0)
VP ADD RANGE NAME("Total1";$range)

$formula:=VP Get formula by name("ViewProArea";"Total1")
  //$formula.formula=Sheet1!$A$1

$formula:=VP Get formula by name("ViewProArea";"Total")
  //$formula=null (if not existing)

Voir également

VP ADD FORMULA NAME
VP Get names

VP Get formulas

VP Get formulas ( rangeObj : Object ) : Collection

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
Résultat	Collection	<-	Collection de valeurs d'une formule

Description

La commande VP Get formulas récupère les formules de rangeObj.

Dans rangeObj, passez une plage dont vous souhaitez récupérer les formules. Si rangeObj désigne plusieurs plages, la formule de la première plage est retournée. Si rangeObj ne contient pas de formules, la commande retourne une chaîne vide.

La collection retournée est bidemensionnelle :

La collection de premier niveau contient des sous-collections de formules. Chaque sous-collection représente une ligne.
Chaque sous-collection définit les valeurs des cellules de la ligne. Les valeurs sont des éléments textuels contenant les formules des cellules.

Exemple

Vous souhaitez récupérer les formules des colonnes Sum et Average de ce document :

Vous pouvez utiliser ce code :

$formulas:=VP Get formulas(VP Cells("ViewProArea";5;1;2;3))
//$formulas[0]=[Sum(B2:D2),Average(B2:D2)]
//$formulas[1]=[Sum(B3:D3),Average(B3:D3)]
//$formulas[2]=[Sum(B4:D4),Average(C4:D4)]

Voir également

VP Get formula
VP Get values
VP SET FORMULAS
VP SET VALUES

VP Get frozen panes

VP Get frozen panes ( vpAreaName : Text { ; sheet : Integer } ) : Object

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)
Résultat	Object	<-	Objet contenant des informations sur les colonnes et lignes figées

Description

La commande VP Get frozen panes retourne un objet contenant des informations sur les lignes et colonnes figées de vpAreaName.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Objet retourné

La commande retourne un objet décrivant les lignes et colonnes figées. Cet objet peut avoir les propriétés suivantes :

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

Exemple

Vous souhaitez récupérer des informations sur le nombre de colonnes et de lignes figées :

var $panesObj : Object

$panesObj:=VP Get frozen panes("ViewProArea")

L'objet retourné contient, par exemple :

Voir également

VP SET FROZEN PANES

VP Get names

VP Get names ( vpAreaName : Text { ; scope : Number } ) : Collection

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
scope	Number	->	"Scope" cible (par défaut=feuille courante)
Résultat	Collection	<-	Noms existant dans la zone définie

Description

La commande VP Get names retourne une collection de tous les "noms" définis dans la feuille courante ou dans la zone définie dans le paramètre scope.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Le paramètre scope vous permet de définir l'espace de la zone dans lequel lire la formule, en passant l'indice de la feuille (la numérotation débute à 0) ou l'une des constantes suivantes :

vk current sheet
vk workbook

Collection retournée

La collection retournée contient un objet par nom. Les propriétés d'objets suivantes peuvent être retournées :

Propriété	Type	Description
result[ ].name	Text	nom de cellule ou de plage
result[ ].formula	Text	formula
result[ ].comment	Text	Commentaire associé au nom

Les propriétés disponibles dépendent du type d'élément nommé (cellule nommée, plage nommée ou formule nommée).

Exemple

var $list : Collection

$list:=VP Get names("ViewProArea";2) //noms de la 3e feuille

Voir également

VP ADD FORMULA NAME
VP ADD RANGE NAME
VP Get formula by name
VP Name

VP Get print info

VP Get print info ( vpAreaName : Text { ; sheet : Integer } ) : Object

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)
Résultat	Object	<-	Objet contenant les informations d'impression

Description

La commande VP Get print info retourne un objet contenant les attributs d'impression de vpAreaName.

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 optionnel sheet, vous pouvez désigner une feuille spécifique (la numérotation commence à zéro) dont vous souhaitez retourner les attributs d'impression. Si le paramètre est omis ou si vous passez vk current sheet, la feuille courante est utilisée.

Exemple

Le code suivant :

$pinfo:=VP Get print info("ViewProArea")

... renvoie les attributs d'impression de la zone 4D View Pro définis dans la commande VP SET PRINT INFO :

{
bestFitColumns:false,
bestFitRows:false,
blackAndWhite:false,
centering:0,
columnEnd:8,
columnStart:0,
firstPageNumber:1,
fitPagesTall:1,
fitPagesWide:1,
footerCenter:"&BS.H.I.E.L.D. &A Sales Per Region",
footerCenterImage:,
footerLeft:,
footerLeftImage:,
footerRight:"page &P of &N",
footerRightImage:,
headerCenter:,
headerCenterImage:,
headerLeft:"&G",
headerLeftImage:logo.png,
headerRight:,
headerRightImage:,
margin:{top:75,bottom:75,left:70,right:70,header:30,footer:30},
orientation:2,
pageOrder:0,
pageRange:,
paperSize:{width:850,height:1100,kind:1},
qualityFactor:2,
repeatColumnEnd:-1,
repeatColumnStart:-1,
repeatRowEnd:-1,
repeatRowStart:-1,
rowEnd:24,
rowStart:0,
showBorder:false,
showColumnHeader:0,
showGridLine:false,
showRowHeader:0,
useMax:true,
watermark:[],
zoomFactor:1
}

Voir également

4D View Pro Print Attributes
VP SET PRINT INFO

VP Get row attributes

VP Get row attributes ( rangeObj : Object ) : Collection

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
Résultat	Collection	<-	Collection de propriétés de lignes

Description

La commande VP Get row attributes retourne une collection de propriétés pour les lignes de rangeObj.

Dans rangeObj, passez un objet contenant une plage de lignes dont les attributs seront récupérés.

La collection retournée contient les propriétés des lignes, qu'elles aient été définies ou non par la méthode VP SET ROW ATTRIBUTES.

Exemple

Le code suivant retourne une collection d'attributs de la plage donnée :

var $range : Object
var $attr : Collection

$range:=VP Column("ViewProArea";1;2)
$attr:=VP Get row attributes($range)

Voir également

VP Get column attributes
VP SET COLUMN ATTRIBUTES
VP SET ROW ATTRIBUTES

VP Get row count

VP Get row count ( vpAreaName : Text {; sheet : Integer } ) : 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)
Résultat	Integer	<-	Nombre total de lignes

Description

La commande VP Get row count retourne le nombre total de lignes de la sheet.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Vous pouvez définir l'emplacement du nombre de colonnes dans le paramère optionnel sheet à l'aide de l'indice de la feuille (la numérotation démarre à zéro). Si le paramètre est omis ou si vous passez vk current sheet, la feuille courante est utilisée.

Exemple

Le code suivant retourne le nombre de lignes dans la zone 4D View Pro :

var $rowCount : Integer
$rowCount:=VP Get row count("ViewProarea")

Voir également

VP Get column count
VP SET COLUMN COUNT
VP SET ROW COUNT

VP Get selection

VP Get selection ( vpAreaName : Text {; sheet : Integer } ) ) : Object

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)
Résultat	Object	<-	Objet de plage de cellules

Description

La commande VP Get selection retourne un nouvel objet plage référençant les cellules courantes sélectionnées.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Exemple

Le code suivant récupèrera les coordonnées de la cellule active :

$currentSelection:=VP Get selection("myVPArea")


//returns a range object containing:  
//$currentSelection.ranges[0].column=5
//$currentSelection.ranges[0].columnCount=2
//$currentSelection.ranges[0].row=8
//$currentSelection.ranges[0].rowCount=6

Voir également

VP ADD SELECTION
VP Get active cell
VP SET ACTIVE CELL
VP SET SELECTION
VP SHOW CELL

VP Get sheet count

VP Get sheet count ( vpAreaName : Text ) : Integer

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
Résultat	Integer	<-	Nombre de feuilles

Description

La commande VP Get sheet count retourne le nombre de feuilles dans le document chargé dans vpAreaName.

Passez le nom de la zone 4D View Pro dans vpAreaName.

Exemple

Dans le document suivant :

Pour obtenir le nombre de feuilles et définir la feuille courante comme étant la dernière feuille :

 $count:=VP Get sheet count("ViewProArea")
  //définir la feuille courante comme étant la dernière feuille (l'indexation commence à 0) VP SET CURRENT SHEET("ViewProArea";$count-1)

Voir également

VP Get sheet index
VP SET SHEET COUNT

VP Get sheet index

VP Get sheet index ( vpAreaName : Text ; name : Text ) : Integer

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
name	Text	->	Nom de la feuille
Résultat	Integer	<-	Numéro d'indice de la feuille

Description

Si aucune feuille nommée name n'est trouvée dans le document, la méthode retourne -1. Dans name, passez le nom de la feuille dont l'index sera retourné.

Passez le nom de la zone 4D View Pro dans vpAreaName.

In index, pass the index of the sheet to remove. If the passed index does not exist, the command does nothing.

La numérotation démarre à 0.

Exemple

Dans le document suivant :

Lire l'index de la feuille appelée "Total premier trimester" :

$index:=VP Get sheet index("ViewProArea";"Total premier trimestre") //retourne 2

Voir également

VP Get sheet count
VP Get sheet name

VP Get sheet name

VP Get sheet name ( vpAreaName : Text ; sheet : Integer ) : Text

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
sheet	Integer	->	Numéro d'indice de la feuille
Résultat	Text	<-	Nom de la feuille

Description

La commande VP Get sheet name retourne le nom de la feuille de vpAreaName dont vous avez le numéro en paramètre.

Passez le nom de la zone 4D View Pro dans vpAreaName.

Dans sheet, passez le numéro de la feuille dont le nom sera retourné.

Si l'index passé n'existe pas, la méthode retourne un nom vide.

La numérotation démarre à 0.

Exemple

Lire le nom de la troisième feuille du document :

$sheetName:=VP Get sheet name("ViewProArea";2)

Voir également

VP Get sheet index

VP Get sheet options

VP Get sheet options ( vpAreaName : Text {; sheet : Integer } ) ) : Object

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)
Résultat	Object	<-	Objet options de la feuille

Description

La commande VP Get sheet options retourne un objet contenant les options relatives à la feuille courante 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.

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 ou si vous passez vk current sheet, la feuille courante est utilisée.

Objet retourné

La commande retourne un objet contenant les valeurs courantes pour toutes les options de feuille disponibles. La valeur d'une option peut avoir été modifiée par l'utilisateur ou par la méthode VP SET SHEET OPTIONS.

Pour visualiser la liste complète des options, voir Options feuille.

Exemple

$options:=VP Get sheet options("ViewProArea")
 If($options.colHeaderVisible) //les en-têtes des colonnes sont visibles
    ... //faire quelque chose
 End if

Voir également

4D VIEW PRO SHEET OPTIONS
VP SET SHEET OPTIONS

VP Get show print lines

VP Get show print lines ( vpAreaName : Text {; sheet : Integer } ) : Boolean

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
sheet	Integer	<-	Numéro d'indice de la feuille
Résultat	Boolean	<-	Vrai si les lignes d'impression sont visibles, sinon Faux

Description

retourne True si les lignes de prévisualisation d'impression sont visibles et False si elles sont masquées. La commande VP Get show print lines

Passez le nom de la zone 4D View Pro dans vpAreaName.

Dans sheet, passez le numéro de la page cible. Si sheet est omis, la commande s'applique à la feuille courante.

La numérotation démarre à 0.

Exemple

Le code suivant permet de vérifier si les lignes d'aperçu sont visibles ou masquées dans le document :

 var $result : Boolean
 $result:=VP Get show print lines("ViewProArea";1)

Voir également

VP SET SHOW PRINT LINES

VP Get spans

VP Get spans ( rangeObj : Object ) : Object

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
Résultat	Object	<-	Objet de cellules fusionnées (cell spans) dans la plage définie

Description

La commande VP Get spans récupère les cellules fusionnées (cell spans) de rangeObj.

Dans rangeObj, passez une plage de cellules fusionnées que vous souhaitez récupérer. Si rangeObj ne contient pas de cellules fusionnées, une plage vide est retournée.

Exemple

Pour centrer le texte des cellules fusionnées dans ce document :

// Rechercher toutes les cellules fusionnées
 $range:=VP Get spans(VP All("ViewProArea"))

 //centrer le texte
 $style:=New object("vAlign";vk vertical align center;"hAlign";vk horizontal align center)
 VP SET CELL STYLE($range;$style)

Voir également

VP ADD SPAN
VP REMOVE SPAN

VP Get stylesheet

VP Get stylesheet ( vpAreaName : Text ; styleName : Text { ; sheet : Integer } ) : Object

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
styleName	Text	->	Nom du style
sheet	Integer	->	Numéro d'indice de la feuille (feuille courante si omis)
Résultat	Object	<-	Objet feuille de style

Description

La commande VP Get stylesheet retourne l'objet feuille de style styleName qui contient les valeurs des propriétés définies.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Dans styleName, passez le nom de la feuille de style que vous souhaitez lire.

Vous pouvez définir où lire la feuille de style via le paramètre sheet en passant le numéro d'indice de la feuille (la numérotation commence à partir de 0) ou à l'aide des constantes suivantes :

vk current sheet
vk workbook

Exemple

Le code suivant :

$style:=VP Get stylesheet("ViewProArea";"GreenDashDotStyle")

... retournera l'objet style GreenDashDotStyle de la feuille courante :

{
backColor:green,
borderBottom:{color:green,style:10},
borderLeft:{color:green,style:10},
borderRight:{color:green,style:10},
borderTop:{color:green,style:10}
}

Voir également

4D View Pro Style Objects and Style Sheets
VP ADD STYLESHEET
VP Get stylesheets
VP REMOVE STYLESHEET

VP Get stylesheets

VP Get stylesheets ( vpAreaName : Text { ; sheet : Integer } ) : Collection

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
sheet	Integer	->	Cible (par défaut = feuille courante)
Résultat	Collection	<-	Collection d'objets feuille de style

Description

La commande VP Get stylesheets retourne une collection d'objets feuille de style définis dans la sheet.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Vous pouvez définir où lire les feuilles de style via le paramètre sheet en passant le numéro d'indice de la feuille (la numérotation commence à partir de 0) ou à l'aide des constantes suivantes :

vk current sheet
vk workbook

Exemple

Le code suivant retournera une collection de tous les objets style de la feuille courante :

$styles:=VP Get stylesheets("ViewProArea")

Dans ce cas, la feuille courante utilise deux objets style :

[
   {
     backColor:green,
     borderLeft:{color:green,style:10}, 
     borderTop:{color:green,style:10}, 
     borderRight:{color:green,style:10}, 
     borderBottom:{color:green,style:10}, 
     name:GreenDashDotStyle
   },
   {
     backColor:red,
     textIndent:10,
     name:RedIndent
   }
]

Voir également

VP ADD STYLESHEET
VP Get stylesheet
VP REMOVE STYLESHEET

VP Get table column attributes

Historique

Release	Modifications
19 R7	Ajout

VP Get table column attributes ( vpAreaName : Text ; tableName : Text ; column : Integer {; sheet : Integer } ) : Object

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
sheet	Integer	->	Numéro d'indice de la feuille (feuille courante si omis)
Résultat	Object	<-	Numéro d'indice de columnName

Description

La commande VP Get table column attributes retourne les attributs courants de la colonne column de la table tableName.

Passez le nom de la zone 4D View Pro dans vpAreaName.

Dans sheet, passez le numéro de la page cible. Si aucun numéro n'est spécifié ou si vous passez -1, la commande s'applique à la feuille courante.

La numérotation démarre à 0.

The command returns an object describing the current attributes of the column:

Propriété	Type	Description
dataField	text	Nom de la propriété de la colonne de la table dans le contexte de données. Not returned if the table is displayed automatically
name	text	Nom de la colonne de la table.
footerText	text	Valeur du pied de colonne.
footerFormula	text	Formule de pied de colonne.
filterButtonVisible	boolean	True if the table column's filter button is displayed, False otherwise.

If tableName is not found or if column index is higher than the number of columns, the command returns null.

Exemple

$options:=VP Get sheet options("ViewProArea")
 If($options.colHeaderVisible) //les en-têtes des colonnes sont visibles
    ...
End if

Voir également

VP CREATE TABLE
VP Find table
VP SET TABLE COLUMN ATTRIBUTES
VP RESIZE TABLE

VP Get table column index

Historique

Release	Modifications
19 R7	Ajout

VP Get table column index ( vpAreaName : Text ; tableName : Text ; columnName : Text {; sheet : Integer } ) : Integer

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
tableName	Text	->	Nom de table
columnName	Text	->	Nom de la colonne de la table
sheet	Integer	->	Numéro d'indice de la feuille (feuille courante si omis)
Résultat	Integer	<-	Numéro d'indice de columnName

Description

La commande VP Get table column index retourne le numéro d'indice de la colonne columnName dans la table tableName.

Passez le nom de la zone 4D View Pro dans vpAreaName.

In columnName, pass the name of the table column for which you want to get the index.

Dans sheet, passez le numéro de la page cible. Si aucun numéro n'est spécifié ou si vous passez -1, la commande s'applique à la feuille courante.

La numérotation démarre à 0.

Si tableName ou columnName n'est pas trouvé, la commande renvoie -1.

Exemple

    // Rechercher l'id colonne en fonction du nom de la colonne
var $id : Integer
$id:=VP Get table column index($area; $tableName; "Weight price")
    // Supprimer la colonne par id
VP REMOVE TABLE COLUMNS($area; $tableName; $id)

Voir également

VP CREATE TABLE
VP Find table
VP Get table column attributes
VP SET TABLE COLUMN ATTRIBUTES

VP Get table dirty rows

Historique

Release	Modifications
19 R8	Ajout

VP Get table dirty rows ( vpAreaName : Text ; tableName : Text { ; reset : Boolean {; sheet : Integer }} ) : Collection

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
tableName	Text	->	Nom de table
reset	Boolean	->	True to clear the dirty status from the current table, False to keep it untouched. Default=True
sheet	Integer	->	Numéro d'indice de la feuille (feuille courante si omis)
Résultat	Collection	<-	Collection of objects with all the items modified since the last reset

Description

The VP Get table dirty rows command returns a collection of dirty row objects, containing items that were modified since the last reset in the specified tableName.

Passez le nom de la zone 4D View Pro dans vpAreaName.

In tableName, pass the name of the table for which you want to get the dirty rows. Only modified columns bound to a data context will be taken into account.

By default, calling the command will clear the dirty status from the current table. To keep this status untouched, pass False in the reset parameter.

Dans sheet, passez le numéro de la page cible. Si aucun numéro n'est spécifié ou si vous passez -1, la commande s'applique à la feuille courante.

La numérotation démarre à 0.

Each dirty row object in the returned collection contains the following properties:

Propriété	Type	Description
item	object	Objet modifié de la ligne modifiée
originalItem	object	Objet avant modification
row	entier	Index de la ligne modifiée

Si tableName n'est pas trouvé ou s'il ne contient pas de colonne modifiée, la commande renvoie une collection vide.

Exemple

Vous souhaitez compter le nombre de lignes éditées :

var $dirty : Collection
$dirty:=VP Get table dirty rows("ViewProArea"; "ContextTable"; False)
VP SET NUM VALUE(VP Cell("ViewProArea"; 0; 0); $dirty.length)

Voir également

VP CREATE TABLE
VP Find table
VP SET TABLE COLUMN ATTRIBUTES
VP RESIZE TABLE

VP Get table range

Historique

Release	Modifications
19 R7	Ajout

VP Get table range ( vpAreaName : Text ; tableName : Text {; onlyData : Integer {; sheet : Integer }} ) : Object

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
tableName	Text	->	Nom de table
onlyData	Integer	->	`vk table full range` (par défaut) ou `vk table data range`
sheet	Integer	->	Numéro d'indice de la feuille (feuille courante si omis)
Résultat	Object	<-	Plage contenant la table

Description

La commande VP Get table range retourne la plage de tableName.

Passez le nom de la zone 4D View Pro dans vpAreaName.

In the onlyData parameter, you can pass one of the following constants to indicate if you want to get the data only:

Constante	Valeur	Description
`vk table full range`	0	Get the cell range for the table area with footer and header (default if omitted)
`vk table data range`	1	Get the cell range for the table data area only

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.

Si tableName n'est pas trouvé, la commande renvoie null.

Voir également

VP RESIZE TABLE
VP Find table

VP Get table theme

Historique

Release	Modifications
19 R8	Ajout

VP Get table theme ( vpAreaName : Text ; tableName : Text ) : cs.ViewPro.TableTheme

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
tableName	Text	->	Nom de table
Résultat	cs.ViewPro.TableTheme	<-	Valeurs des propriétés du thème de la table actuelle

Description

La commande VP Get table theme renvoie les valeurs des propriétés du thème actuel de la tableName. Un thème de table peut être défini à l'aide de la commande VP CREATE TABLE ou VP SET TABLE THEME, ou via l'interface.

Dans vpAreaName, passez le nom de la zone 4D View Pro et dans tableName, le nom de la table.

La commande renvoie un objet de la classe cs.ViewPro.TableTheme avec des propriétés et des valeurs qui décrivent le thème de table actuel.

Exemple

La commande renvoie un objet theme complet même si un un nom de thème SpreadJS natif a été utilisé pour définir le thème.

var $param : cs.ViewPro.TableTheme
$param:=cs.ViewPro.TableTheme.new()
$param.theme:="dark10" //utilisation d'un nom de thème natif

VP SET TABLE THEME("ViewProArea"; "ContextTable"; $param)
$vTheme:=VP Get table theme("ViewProArea"; "ContextTable")
$result:=Asserted(Value type($vTheme.theme)=Is object) //vrai

Voir également

VP CREATE TABLE
VP SET TABLE THEME

VP Get tables

Historique

Release	Modifications
19 R7	Ajout

VP Get tables ( vpAreaName : Text { ; sheet : Integer } ) : Collection

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)
Résultat	Collection	<-	Collection de textes avec tous les noms des tables

Description

La commande VP Get tables retourne une collection de tous les noms des tables définies dans sheet.

Passez le nom de la zone 4D View Pro dans vpAreaName.

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.

Exemple

Le code suivant retournera une collection de tous les noms de tables de la feuille courante :

$tables:=VP Get tables("ViewProArea")
//$tables contient par exemple ["contextTable","emailTable"]

Voir également

VP CREATE TABLE

VP Get value

VP Get value ( rangeObj : Object ) : Object

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
Résultat	Object	<-	Objet contenant une valeur de cellule

Description

The VP SET VALUE command récupère la valeur d'une cellule depuis une plage de cellules.

Dans rangeObj, passez la plage dont vous souhaitez récupérer la valeur.

Objet retourné

L'objet retourné contiendra la propriété value, et la propriété time dans le cas d'une valeur date :

Propriété	Type	Description
value	Entier long, Réel, Booléen, Texte, Date	Valeur de rangeObj (exceptée - time)
time	Real	Valeur heure (en secondes) si la valeur est du type js

Si l'objet retourné inclut une date ou une heure, il est traité en tant que datetime et est complété comme suit :

valeur heure - la date est complétée comme suit : December 30, 1899 au format dd/MM/yyyy (30/12/1899)
valeur date - l'heure est complétée comme suit : minuit au format HH:mm:ss (00:00:00)

Si rangeObj contient plusieurs cellules ou plusieurs plages, la valeur de la première cellule est retournée. La commande retourne un objet null si la cellule est vide.

Exemple

$cell:=VP Cell("ViewProArea";5;2)
$value:=VP Get value($cell)
If(Value type($value.value)=Is text)
    VP SET TEXT VALUE($cell;New object("value";Uppercase($value.value))
End if

Voir également

VP Get values
VP SET VALUE
VP SET VALUES

VP Get values

VP Get values ( rangeObj : Object ) : Collection

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
Résultat	Collection	<-	Collection de valeurs

Description

La commande VP Get values récupère les valeurs de rangeObj.

Dans rangeObj, passez une plage dont vous souhaitez récupérer les valeurs. Si rangeObj comprend plusieurs plages, seule la première plage est utilisée.

La collection retournée par VP Get values contient une collection bidimensionnelle :

Chaque élément de la collection de premier niveau représente une ligne et contient une sous-collection de valeurs
Chaque sous-collection contient des valeurs des cellule de la ligne. Les valeurs peuvent être de type entier, réel, booléen, texte, null. Si une valeur est de type date ou heure, elle est retournée en un objet dont les propriétés sont les suivantes :
Propriété Type Description
value Date Valeur dans la cellule (sauf heure)
time Real Valeur heure (en secondes) si la valeur est du type js

Les dates ou les heures sont considérées comme un datetime et sont complétées comme suit :

valeur de type heure - la partie date est complétée comme étant le 30 décembre 1899
valeur de type date - la partie heure est complétée comme étant minuit (00:00:00:000)

Exemple

Vous souhaitez lire les valeurs allant de C4 à G6 :

$result:=VP Get values(VP Cells("ViewProArea";2;3;5;3))
// $result[0]=[4,5,null,hello,world]
// $result[1]=[6,7,8,9,null]
// $result[2]=[null,{time:42,value:2019-05-29T00:00:00.000Z},null,null,null]

Voir également

VP Get formulas
VP Get value
VP SET FORMULAS
VP SET VALUES

VP Get workbook options

VP Get workbook options ( vpAreaName : Text ) : Object

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
Résultat	Object	<-	Objet contenant les options de workbook

Description

VP Get workbook options retourne un objet contenant les options du workbook dans vpAreaName

Passez le nom de la zone 4D View Pro dans vpAreaName.

The returned object contains all the workbook options (default and modified ones), in the workbook.

The list of workbook options is referenced in VP SET WORKBOOK OPTIONS's description.

Exemple

var $workbookOptions : Object

$workbookOptions:=VP Get workbook options("ViewProArea")

Voir également

VP SET WORKBOOK OPTIONS

I

VP IMPORT DOCUMENT

VP IMPORT DOCUMENT ( vpAreaName : Text ; filePath : Text { ; paramObj : Object} )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
filePath	Text	->	Chemin d'accès du document
paramObj	Object	->	Options d'import

Description

La commande VP IMPORT DOCUMENT importe et affiche le document désigné par filePath dans la zone 4D View Pro vpAreaName. Le document importé remplace toutes les données déjà présentes dans la zone.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Dans filePath, passez le chemin et le nom du document à importer. Les formats suivants sont pris en charge :

Les documents 4D View Pro (extension ".4vp")
Microsoft Excel (extension ".xlsx")
documents texte (extension ".txt", ".csv", le document doit être en utf-8)

Si l'extension du document n'est pas une extension reconnue, telle que .4vp ou .xslx, le document est considéré comme un document texte. Vous devez passer un chemin d'accès complet, sauf si le document est situé au même niveau que le dossier Project, auquel cas vous pouvez simplement passer son nom.

When importing a Microsoft Excel-formatted file into a 4D View Pro document, some settings may be lost. You can verify your settings with this list from GrapeCity.

Une erreur est retournée si le paramètre filePath est invalide, ou si le fichier est manquant ou mal-formé.

Le paramètre optionnel paramObj vous permet de définir les propriétés du document importé :

Paramètres		Type	Description
formula		object	Nom d'une méthode callback (ou méthode rétro-rappel) à lancer lorsque l'import est terminé. La méthode doit utiliser la commande `Formula`. The callback method must be passed with the `Formula` command.
password		text	Microsoft Excel uniquement (optionnel) - Mot de passe utilisé pour protéger un document Microsoft Excel.
csvOptions		object	options d'import csv
	range	object	Plage de cellules contenant la première cellule dans laquelle les données seront saisies. Si la plage spécifiée n'est pas une plage de cellules, seule la première cellule de la plage est utilisée.
	rowDelimiter	text	Délimiteur de ligne. S'il n'est pas défini, le délimiteur est automatiquement déterminé par 4D.
	columnDelimiter	text	Délimiteur de colonne. Par défaut : ","

Pour plus d'informations sur le format CSV et les valeurs séparées par un délimiteur en général, voir cet article sur Wikipedia

Exemple 1

Vous souhaitez importer un document 4D View Pro stocké sur le disque, à l'ouverture du formulaire :

C_TEXT($docPath)
If(Form event code=On VP Ready) //La zone 4D View Pro est chargée et prête
    $docPath:="C:\\Bases\\ViewProDocs\\MyExport.4VP"
    VP IMPORT DOCUMENT("VPArea";$docPath)
End if

Exemple 2

Vous souhaitez importer un document Microsoft Excel protégé par un mot de passe dans 4D View Pro :

$o:=New object
$o.password:="excel123"

VP IMPORT DOCUMENT("ViewProArea";"c:\\tmp\\excelfilefile.xlsx";$o)

    //myImport callback method
#DECLARE($area : Text; $filePath : Text; $param : Object; $status : Object)

If ($status.success)
     ALERT("Import successfully completed")
Else 
     ALERT("Error: "+$status.errorMessage)
End if

Exemple 3

Vous souhaitez importer un fichier .txt qui utilise une virgule (",") comme délimiteur :

example-import-csv

$params:=New object
$params.range:=VP Cells("ViewProArea";0;0;2;5)
VP IMPORT DOCUMENT("ViewProArea";"c:\\import\\my-file.txt";New object("csvOptions";$params))

Here's the result: example-import-csv

Voir également

VP EXPORT DOCUMENT
VP NEW DOCUMENT

VP IMPORT FROM OBJECT

VP IMPORT FROM OBJECT ( vpAreaName : Text { ; viewPro : Object} )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
viewPro	Object	->	Objet 4D View Pro

Description

La commande VP IMPORT FROM OBJECT importe et affiche l'objet 4D View Pro viewPro dans la zone 4D View Pro vpAreaName. Le contenu de l'objet importé remplace toutes les données insérées auparavant dans la zone.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Dans viewPro, passez un objet 4D View Pro valide. Cet objet peut avoir été créé en utilisant VP Export to object ou manuellement. For more information on 4D View Pro objects, please refer to the 4D View Pro object section.

Une erreur est retournée si l'objet viewPro est invalide.

Exemple

Vous souhaitez importer une feuille de calcul précédemment stockée dans un champ objet :

QUERY([VPWorkBooks];[VPWorkBooks]ID=10)
VP IMPORT FROM OBJECT("ViewProArea1";[VPWorkBooks]SPBook)

Voir également

VP Export to object

VP INSERT COLUMNS

VP INSERT COLUMNS ( rangeObj : Object )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage

Description

La commande VP INSERT COLUMNS insère les colonnes définies dans rangeObj.

Dans rangeObj, passez un objet plage indiquant la colonne de début (la colonne qui définit l'emplacement de la nouvelle colonne à insérer) et le nombre de colonnes à insérer. Si le nombre de colonnes à insérer est omis (non défini), une seule colonne est insérée.

De nouvelles colonnes sont insérées sur la gauche, directement avant la première colonne de rangeObj.

Exemple

Pour insérer 3 colonnes avant la deuxième colonne :

VP INSERT COLUMNS(VP Column("ViewProArea";1;3))

Le résultat est le suivant :

Voir également

VP DELETE COLUMNS
VP DELETE ROWS
VP INSERT ROWS

VP INSERT ROWS

VP INSERT ROWS ( rangeObj : Object )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage

Description

La commande VP INSERT ROWS insère les lignes définies dans rangeObj.

Dans rangeObj, passez un objet plage indiquant la ligne de début (la ligne qui définit l'emplacement de la nouvelle ligne à insérer) et le nombre de lignes à insérer. Si le nombre de lignes à insérer est omis (non défini), une seule ligne est insérée.

De nouvelles lignes sont insérées directement avant la première ligne de rangeObj.

Exemple

Pour insérer 3 lignes avant la première ligne :

VP INSERT ROWS(VP Row("ViewProArea";0;3))

Le résultat est le suivant :

Voir également

VP DELETE COLUMNS
VP DELETE ROWS
VP INSERT COLUMNS

VP INSERT TABLE COLUMNS

Historique

Release	Modifications
19 R7	Ajout

VP INSERT TABLE COLUMNS ( vpAreaName : Text ; tableName : Text ; column : Integer {; count : Integer {; insertAfter : Integer {; sheet : Integer }}} )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
tableName	Text	->	Nom de table
column	Integer	->	Index dans la table de la colonne de départ à insérer
count	Text	->	Nombre de colonnes à ajouter (doit être >0)
insertAfter	Integer	->	`vk table insert before` ou `vk table insert after` column
sheet	Integer	->	Indice de la feuille (feuille courante si omis)

Description

La commande VP INSERT TABLE COLUMNS inserts one or count empty column(s) in the specified tableName at the specified column index.

When a column has been inserted with this command, you typically modify its contents using the VP SET TABLE COLUMN ATTRIBUTES command.

In the insertAfter parameter, you can pass one of the following constants to indicate if the column(s) must be inserted before or after the column index:

Constante	Valeur	Description
`vk table insert before`	0	Insert column(s) before the column (default if omitted)
`vk table insert after`	1	Insert column(s) after the column

This command inserts some columns in the tableName table, NOT in the sheet. The total number of columns of the sheet is not impacted by the command. Data present at the right of the table (if any) are automatically moved right according to the number of added columns.

If tableName does not exist or if there is not enough space in the sheet, nothing happens.

Exemple

Voir les exemples pour VP INSERT TABLE ROWS et VP SET TABLE COLUMN ATTRIBUTES.

Voir également

VP INSERT TABLE ROWS
VP REMOVE TABLE COLUMNS
VP SET TABLE COLUMN ATTRIBUTES

VP INSERT TABLE ROWS

Historique

Release	Modifications
19 R7	Ajout

VP INSERT TABLE ROWS ( vpAreaName : Text ; tableName : Text ; row : Integer {; count : Integer {; insertAfter : Integer {; sheet : Integer }}} )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
tableName	Text	->	Nom de table
row	Integer	->	Index in the table of the starting row to insert
count	Text	->	Number of rows to add (must be >0)
insertAfter	Integer	->	`vk table insert before` or `vk table insert after` row
sheet	Integer	->	Indice de la feuille (feuille courante si omis)

Description

The VP INSERT TABLE ROWS command inserts one or count empty row(s) in the specified tableName at the specified row index.

In the insertAfter parameter, you can pass one of the following constants to indicate if the row(s) must be inserted before or after the row index:

Constante	Valeur	Description
`vk table insert before`	0	Insert row(s) before the row (default if omitted)
`vk table insert after`	1	Insert row(s) after the row

This command inserts some rows in the tableName table, NOT in the sheet. The total number of rows of the sheet is not impacted by the command. Data present below the table (if any) are automatically moved down according to the number of added rows.

If the tableName table is bound to a data context, the command inserts new, empty element(s) in the collection.

If tableName does not exist or if there is not enough space in the sheet, nothing happens.

Exemple

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")

You want to insert two rows and two columns in the table, you can write:

VP INSERT TABLE ROWS("ViewProArea"; "PeopleTable"; 1; 2)
VP INSERT TABLE COLUMNS("ViewProArea"; "PeopleTable"; 1; 2)

Voir également

VP INSERT TABLE COLUMNS
VP REMOVE TABLE ROWS

M

VP MOVE CELLS

Historique

Release	Modifications
19 R4	Ajout

VP MOVE CELLS ( originRange : Object ; targetRange : Object ; options : Object )

Paramètres	Type		Description
originRange	Object	->	Cell range to copy from
targetRange	Object	->	Target range for the values, formatting and formulas
options	Object	->	Options supplémentaires

Description

The VP MOVE CELLS command moves or copies the values, style and formulas from originRange to targetRange.

originRange and targetRange can refer to different View Pro areas.

In originRange, pass a range object containing the values, style, and formula cells to copy or move. If originRange is a combined range, only the first one is used.

In targetRange, pass the range of cells where the cell values, style, and formulas will be copied or moved.

The options parameter has several properties:

Propriété Type Description

copy

Boolean

Determines if the values, formatting and formulas of the cells in originRange are removed after the command executes:

False (default) to remove them
True to keep them

pasteOptions

Longint

Specifies what is pasted. Valeurs possibles :

Valeur	Description
`vk clipboard options all` (par défaut)	Pastes all data objects, including values, formatting, and formulas.
`vk clipboard options formatting`	Pastes only the formatting.
`vk clipboard options formulas`	Pastes only the formulas.
`vk clipboard options formulas and formatting`	Pastes the formulas and formatting.
`vk clipboard options values`	Pastes only the values.
`vk clipboard options value and formatting`	Pastes the values and formatting.

Les options de collage définies dans les options de workbook sont prises en compte.

Exemple

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)

Voir également

VP Copy to object
VP PASTE FROM OBJECT
VP SET WORKBOOK OPTIONS

N

VP Name

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	->	Nom de plage existante
sheet	Integer	->	Emplacement de la plage (si omis, feuille courante)
Résultat	Object	<-	Plage nommée

Description

La commande VP Name retourne un nouvel objet plage référençant une plage nommée.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Le paramètre rangeName indique une plage de cellule nommée existante.

In the optional sheet parameter, you can designate a specific spreadsheet where rangeName is defined. 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 sheet
vk workbook

Exemple

Vous souhaitez assigner une valeur à une plage nommée "Total".

// nommez 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")

Voir également

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

VP NEW DOCUMENT ( vpAreaName : Text )

Paramètres	Type		Description
vpAreaName	Text	->	Nom de la zone 4D View Pro dans le formulaire

Description

La commande VP NEW DOCUMENT charge et affiche un nouveau document par défaut dans l'objet de la zone de formulaire 4D View Pro vpAreaName. Le nouveau document vide remplace toutes les données auparavant insérées dans la zone.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Exemple

Vous souhaitez afficher un document vide dans l'objet formulaire "myVPArea" :

VP NEW DOCUMENT("myVPArea")

Voir également

VP IMPORT DOCUMENT

O

VP Object to font

VP Object to font ( fontObj : Object ) : Text

Paramètres	Type		Description
fontObj	Object	->	Objet police
Résultat	Text	<-	Police raccourcie (shorthand)

Description

La commande VP Object to font returns a font shorthand string from 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	Définit la taille de la police. Le line-height peut être ajouté au font-size : font-size/line-height : Ex : "15pt/20pt"	un chiffre 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 large` `vk font size larger` `vk font size x large` `vk font size xx large` `vk font size small` `vk font size smaller` `vk font size x small` `vk font size xx small`	Oui
style	text	Style de police.	`vk font style italic` `vk 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 100` `vk font weight 200` `vk font weight 300` `vk font weight 400` `vk font weight 500` `vk font weight 600` `vk font weight 700` `vk font weight 800` `vk font weight 900` `vk font weight bold` `vk font weight bolder` `vk 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 à l'aide, par exemple, de VP SET CELL STYLE.

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"

Voir également

4D View Pro Style Objects and Style Sheets
VP Font to object
VP SET CELL STYLE
VP SET DEFAULT STYLE

P

VP PASTE FROM OBJECT

Historique

Release	Modifications
19 R4	Ajout

VP PASTE FROM OBJECT ( rangeObj : Object ; dataObject : Object {; options : Longint} )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage de cellules
dataObject	Object	->	Object containing the data to be pasted
options	Longint	->	Specifies what is pasted

Description

The VP PASTE FROM OBJECT command pastes the contents, style and formulas stored in dataObject to the rangeObj object.

In rangeObj, pass the cell range object where the values, formatting, and/or formula cells will be pasted. If rangeObj refers to more than one cell, only the first one is used.

In dataObject, pass the object that contains the cell data, formatting, and formulas to be pasted.

In the optional options parameter, you can specify what to paste in the cell range. Valeurs possibles :

Constante	Description
`vk clipboard options all`	Pastes all data objects, including values, formatting, and formulas.
`vk clipboard options formatting`	Pastes only the formatting.
`vk clipboard options formulas`	Pastes only the formulas.
`vk clipboard options formulas and formatting`	Pastes formulas and formatting.
`vk clipboard options values`	Pastes only values.
`vk clipboard options value and formatting`	Pastes values and formatting.

Les options de collage définies dans les options de workbook sont prises en compte.

Collection de données à charger dans le contexte de données

Exemple

Voir l'exemple de VP Copy to object

Voir également

VP Copy to object
VP MOVE CELLS
VP Get workbook options
VP SET WORKBOOK OPTIONS

VP PRINT

VP PRINT ( vpAreaName : Text { ; sheet : Integer } )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
sheet	Integer	->	Indice de la feuille (feuille courante si omis)

Description

The VP PRINT command opens a print dialog window to print vpAreaName.

Passez la zone 4D View Pro à imprimer dans le paramètre 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.

The properties defined in the print dialog window are for the printer paper, they are not the printing properties for the 4D View Pro area. Printing properties for 4D View Pro areas are defined using the VP SET PRINT INFO command. It is highly recommended that the properties for both the printer and the 4D View Pro area match, otherwise the printed document may not correspond to your expectations.

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 sheet
vk workbook

4D View Pro areas can only be printed with the VP PRINT command.
Commands from the 4D Printing language theme are not supported by VP PRINT.
This command is intended for individual printing by the final end user. For automated print jobs, it is advised to export the 4D View Pro area as a PDF with the VP EXPORT DOCUMENT method.

Exemple

Le code suivant :

 VP PRINT("myVPArea")

Ouvrira une fenêtre de dialogue d'impression :

Voir également

VP EXPORT DOCUMENT
VP SET PRINT INFO

R

VP RECOMPUTE FORMULAS

VP RECOMPUTE FORMULAS ( vpAreaName : Text )

Paramètres	Type		Description
vpAreaName	Text	->	Nom de la zone 4D View Pro dans le formulaire

Description

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 (ex : si les formules sont modifiées ou si les formules contiennent des appels vers la base). La commande lance l'exécution de la commande VP FLUSH COMMANDS pour exécuter les commandes stockées et vider le tampon de commandes, puis calcule toutes les formules dans le workbook.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Assurez-vous que la commande n'a pas été exécutée auparavant à l'aide de VP RECOMPUTE FORMULAS, sinon la commande ne fait rien.

Exemple

Pour actualiser toutes les forumules du workbook, saisissez le code suivant :

VP RECOMPUTE FORMULAS("ViewProArea")

Voir également

VP RESUME COMPUTING
VP SUSPEND COMPUTING

VP REMOVE NAME

VP REMOVE NAME ( vpAreaName : Text ; name : Text { ; sheet : Integer } )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
name	Text	->	Nom de la plage nommée ou de la formule nommée à supprimer
scope	Integer	->	"Scope" cible (par défaut=feuille courante)

Description

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.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Passez la plage nommée ou la formule nommée que vous souhaitez supprimer dans name.

Le paramètre scope vous permet de définir l'emplacement dans lequel vous souhaitez supprimer le nom, en passant l'indice de la feuille (la numérotation débute à 0) ou l'une des constantes suivantes :

vk current sheet
vk workbook

Exemple

$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

Voir également

VP Name

VP REMOVE SHEET

VP REMOVE SHEET ( vpAreaName : Text ; index: Integer )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
index	Integer	->	Index of the sheet to remove

Voir également

VP ADD SHEET

Description

The VP REMOVE SHEET command removes the sheet with the specified index from the document loaded in vpAreaName.

Passez le nom de la zone 4D View Pro dans vpAreaName.

In sheet, pass the index of the sheet to be set as current sheet. If the index passed is inferior to 0 or exceeds the number of sheets, the command does nothing.

La numérotation démarre à 0.

Exemple

Le document comporte actuellement 3 feuilles :

Supprimer la troisième feuille :

VP REMOVE SHEET("ViewProArea";2)

VP REMOVE SPAN

VP REMOVE SPAN ( rangeObj : Object )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage

Description

La commande VP REMOVE SPAN removes the span from the cells in rangeObj.

Dans rangeObj, passez un objet plage de la fusion. Les cellules fusionnées de la plage sont divisées en cellules individuelles.

Exemple

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:

Voir également

VP ADD SPAN
VP Get spans

VP REMOVE STYLESHEET

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	->	Nom du style à supprimer
sheet	Integer	->	Indice de la feuille (feuille courante si omis)

Description

La commande VP REMOVE STYLESHEET supprime la feuille de style transmise dans styleName depuis la vpAreaName.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Passez le nom de la feuille de style que vous souhaitez 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 sheet
vk workbook

Exemple

Pour supprimer l'objet style GreenDashDotStyle de la feuille courante :

VP REMOVE STYLESHEET("ViewProArea";"GreenDashDotStyle")

Voir également

VP ADD STYLESHEET
VP Get stylesheet
VP Get stylesheets

VP REMOVE TABLE

Historique

Release	Modifications
19 R6	Ajout

VP REMOVE TABLE ( vpAreaName : Object; tableName : Text {; options : Integer} {; sheet : Integer}} )

Paramètres	Type		Description
vpAreaName	Text	->	Nom de la zone 4D View Pro
tableName	Text	->	Nom de la table à supprimer
options	Integer	->	Options supplémentaires
sheet	Integer	->	Indice de la feuille (feuille courante si omis)

Description

The VP REMOVE TABLE command removes a table that you created with VP CREATE TABLE.

In vpAreaName, pass the name of the area where the table to remove is located.

In tableName, pass the name of the table to remove.

In options, you can specify additional behavior. Valeurs possibles :

Constante	Valeur	Description
vk table remove all	0	Remove all including style and data
vk table remove style	1	Remove style but keep data
vk table remove data	2	Remove data but keep style

Table names are defined at sheet level. You can specify where the table is located using the optional sheet parameter (indexing starts at 0).

Exemple

To remove the "people" table in the second sheet and keep the data in the cells:

VP REMOVE TABLE("ViewProArea"; "people"; vk table remove style; 2)

Voir également

VP CREATE TABLE

VP REMOVE TABLE COLUMNS

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	->	Index in the table of the starting column to remove
count	Text	->	Number of columns to remove (must be >0)
sheet	Integer	->	Indice de la feuille (feuille courante si omis)

Description

The VP REMOVE TABLE COLUMNS command removes one or count column(s) in the specified tableName at the specified column index. The command removes values and styles.

The command removes columns from the tableName table, NOT from the sheet. The total number of columns of the sheet is not impacted by the command. The total number of columns of the sheet is not impacted by the command.

If tableName does not exist, nothing happens.

Exemple

To remove two columns from 3rd column of the "dataTable" table:

VP REMOVE TABLE COLUMNS("ViewProArea"; "dataTable"; 3; 2)

Voir également

VP INSERT TABLE COLUMNS
VP REMOVE TABLE ROWS

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	->	Index in the table of the starting row to remove
count	Text	->	Number of rows to remove (must be >0)
sheet	Integer	->	Indice de la feuille (feuille courante si omis)

Description

La commande VP REMOVE TABLE ROWS The VP REMOVE TABLE ROWS command. The command removes values and styles.

This command removes rows from the tableName table, NOT from the sheet. The total number of rows of the sheet is not impacted by the command. The total number of rows of the sheet is not impacted by the command.

If the tableName table is bound to a data context, the command removes element(s) from the collection.

If tableName does not exist, nothing happens.

Exemple

To remove two rows from 3rd row of the "dataTable" table:

VP REMOVE TABLE ROWS("ViewProArea"; "dataTable"; 3; 2)

Voir également

VP INSERT TABLE ROWS
VP REMOVE TABLE COLUMNS

VP RESET SELECTION

VP RESET SELECTION ( vpAreaName : Text { ; sheet : Integer } )

Paramètres	Type		Description
vpAreaName	Text	->	Nom d'objet formulaire zone 4D View Pro
sheet	Integer	->	Indice de la feuille (feuille courante si omis)

Description

La commande VP RESET SELECTION désélectionne toutes les cellules, ce qui fait qu'il n'y a pas 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.

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 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 :

vk current sheet

Exemple

Vous souhaitez déselectionner toutes les cellules (la cellule active et toute autre cellule sélectionée) :

VP RESET SELECTION("myVPArea")

Voir également

VP ADD SELECTION
VP Get active cell
VP Get selection
VP SET ACTIVE CELL
VP SET SELECTION
VP SHOW CELL

VP RESIZE TABLE

Historique

Release	Modifications
19 R7	Ajout

VP RESIZE TABLE ( rangeObj : Object; tableName : Text )

Paramètres	Type		Description
rangeObj	Object	->	Nouvelle plage de la table
tableName	Text	->	Nom de la table

Description

La commande VP RESIZE TABLE modifie la taille du tableName par rapport au rangeObj.

Les règles suivantes s'appliquent :

Headers must remain in the same row and the resulting table range must overlap the original table range.
If the row count of the resized table is inferior to the initial row count, values inside cropped rows or columns are kept if they were not bound to a data context, otherwise they are deleted.
If the table expands on cells containing data:
- if rows are added, data is deleted,
- if columns are added, data are kept and are displayed in new columns.

If tableName does not exist, nothing happens.

Exemple

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")

You want to add one column before and after the table as well as two empty rows. Vous pouvez écrire :

VP RESIZE TABLE(VP Cells("ViewProArea"; 0; 1; 4; 6); "PeopleTable")

Voir également

VP CREATE TABLE
VP Get table range

VP RESUME COMPUTING

VP RESUME COMPUTING ( vpAreaName : Text )

Paramètres	Type		Description
vpAreaName	Text	->	Nom de la zone 4D View Pro dans le formulaire

Description

La commande VP RESUME COMPUTING recommence le calcul des formules dans vpAreaName.

La commande réactive le service de calcul de 4D View Pro. Les formules impactées par des modifications apportées durant la suspension des calculs sont mises à jour, et les formules ajoutées après l'exécution de VP RESUME COMPUTING sont calculées.

Passez le nom de la zone 4D View Pro dans vpAreaName. 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. Ainsi, chaque exécution de commande VP RESUME COMPUTING doit être compensée par une exécution correspondante de la commande VP SUSPEND COMPUTING.

Exemple

Voir l'exemple dans VP SUSPEND COMPUTING.

Voir également

VP RECOMPUTE FORMULAS
VP SUSPEND COMPUTING

VP Row

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

Description

La commande VP Row retourne un nouvel objet de plage référençant une ou plusieurs lignes spécifiques.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Le paramètre row définit la première ligne de la plage. Passez l'indice de la ligne (la numérotation commence à zéro) dans ce paramètre. Pass the row index (counting begins at 0) in this parameter.

Dans le paramètre row, vous pouvez définir l'emplacement de la ou des lignes de la plage de cellules. rowCount doit être supérieur à 0. Passez l'indice de la ligne (la numérotation commence à zéro) dans ce paramètre.

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 :

vk current sheet

Exemple

Vous pouvez écrire :

$row:=VP Row("ViewProArea";9) // row 10

Voir également

VP All
VP Cell
VP Cells
VP Column
VP Combine ranges
VP Name

VP ROW AUTOFIT

VP ROW AUTOFIT ( rangeObj : Object)

Paramètres	Type		Description
rangeObj	Object	->	Objet plage

Description

La commande VP ROW AUTOFIT dimensionne automatiquement la ou les ligne(s) dans rangeObj en fonction de leur contenu.

Dans rangeObj, passez un objet plage contenant une plage de lignes dont la taille est gérée automatiquement.

Exemple

Les lignes suivantes n'affichent pas correctement le texte :

 VP ROW AUTOFIT(VP Row("ViewProArea";1;2))

Résultat:

Voir également

VP Column autofit

VP Run offscreen area

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	<-	Propriété `.result` de l'objet `.onEvent`, ou Null s'il ne retourne pas de valeur

Description

La commande VP Run offscreen area crée une zone hors écran dans la 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 l'une des propriétés optionnelles suivantes. Ces propriétés seront disponibles grâce à la commande This dans la méthode onEvent et référencent 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. Elle peut être soit : une fonction `onEvent` d'une classe, soit un objet `Formula` Par défaut, la méthode callback est appelée sur les événements `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 callback peut être utilisée pour accéder à l'objet 4D View Pro.
autoQuit	boolean	Vrai (valeur par défaut) si la commande doit stopper l'exécution de la formule lorsque les événements `On End URL Loading` ou `On URL Loading Error` se produisent. Si faux, 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
result	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 est uniquement disponible durant 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) :

ACCEPT
CANCEL
SET TIMER
WA Evaluate JavaScript
WA EXECUTE JAVASCRIPT FUNCTION

Exemple 1

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 (de rétro-appel) OffscreenArea :

$o:=cs.OffscreenArea.new()
$result:=VP Run offscreen area($o)

Exemple 2

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 (de rétro-appel) OffscreenArea :

$o:=cs.OffscreenArea.new()

$result:=VP Run offscreen area($o)

Voir également

Article de blog : Fin du chargement des documents

S

VP SET ACTIVE CELL

VP SET ACTIVE CELL ( rangeObj : Object)

Paramètres	Type		Description
rangeObj	Object	->	Objet plage

Description

La commande VP SET ACTIVE CELL définit une cellule spécifiée comme active.

Dans rangeObj, passez une plage contenant une seule cellule en tant qu'objet (reportez-vous à VP Cell). Si rangeObj n'est pas une plage de cellule ou contient plusieurs plages, seule la première cellule de la première plage est utilisée.

Exemple

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)

Voir également

VP ADD SELECTION
VP Get active cell
VP Get selection
VP RESET SELECTION
VP SET SELECTION
VP SHOW CELL

VP SET ALLOWED METHODS

VP SET ALLOWED METHODS ( methodObj : Object)

Paramètres	Type		Description
methodObj	Object	->	Méthodes autorisées dans les zones 4D View Pro

Compatibilité
Pour plus de flexibilité, il est recommandé d'utiliser la commande VP SET CUSTOM FUNCTIONS qui vous permet de désigner des formules 4D pouvant être appelées depuis des zones 4D View Pro. Dès que VP SET CUSTOM FUNCTIONS est appelé, VP SET ALLOWED METHODS est ignoré. 4D View Pro prend également en charge la commande générique de 4D SET ALLOWED METHODS dans le cas où ni VP SET CUSTOM FUNCTIONS ni VP SET ALLOWED METHODS sont appelées, néanmoins l'utilisation de la commande générique n'est pas recommandée.

Description

La commande VP SET ALLOWED METHODS désigne les méthodes de projet qui peuvent être appelées dans les formules de 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, à des fins de sécurité, si vous n'exécutez pas la commande VP SET ALLOWED METHODS, aucun appel à une méthode n'est autorisé dans les zones 4D View Pro -- sauf si la commande générique de 4D, SET ALLOWED METHODS, 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é porte 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 la propriété `<functionName>` définit le nom de la fonction personnalisée à afficher dans les formules de 4D View Pro (aucun espace n'est autorisé)
	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 d'un paramètre à afficher pour `<functionName>`.Note: Les noms des paramètres ne doivent pas contenir d'espace.
		[ ].type	Number	Type de paramètre. Types pris en charge : `Is Boolean` `Is date` `Is Integer` `Is object` `Is real` `Is text` `Is time` S'il est omis, par défaut la valeur est automatiquement envoyée avec son type, exceptées les valeurs date ou heure qui sont envoyées sous forme d'objet (voir la section Paramètres). Si type est défini sur `Is object`, l'objet possède la même structure que l'objet retourné par `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

Exemple

Vous souhaitez autoriser deux méthodes dans vos zones 4D View Pro :

C_OBJECT($allowed)
 $allowed:=New object //paramètre pour la commande

 $allowed.Hello:=New object //crée 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ée 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.

Voir également

4D functions
VP SET CUSTOM FUNCTIONS

VP SET BINDING PATH

Historique

Release	Modifications
19 R5	Ajout

VP SET BINDING PATH ( rangeObj : Object ; dataContextAttribute : Text)

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
dataContextAttribute	Text	->	Name of the attribute to bind to rangeObj

Description

The VP SET BINDING PATH command The VP SET BINDING PATH command. After you set a data context using the SET DATA CONTEXT method. When loaded, if the data context contains the attribute, the value of dataContextAttribute is automatically displayed in the cells in rangeObj.

Dans rangeObj, passez un objet qui est soit une plage de cellules, soit une plage combinée de cellules.

If rangeObj is a range with several cells, the command binds the attribute to the first cell of the range.
If rangeObj contains several ranges of cells, the command binds the attribute to the first cell of each range.

If dataContextAttribute is an empty string, the function removes the current binding. In dataContextAttribute, pass the name of the attribute to bind to rangeObj.

Attributes of type collection are not supported. When you pass the name of a collection attribute, the command does nothing.

Exemple

Set a data context and bind the firstName and lastName attribute to cells:

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")

Voir également

VP Get binding path
VP Get data context
VP SET DATA CONTEXT

VP SET BOOLEAN VALUE

VP SET BOOLEAN VALUE ( rangeObj : Object ; boolValue : Boolean)

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
boolValue	Boolean	->	Valeur booléen à fixer

Description

La commande VP SET BOOLEAN VALUE affecte une valeur spécifiée à une plage de cellules désignée.

Dans rangeObj, passez la plage de cellule(s) (créée par exemple avec VP Cell ou VP Column) dont vous souhaitez indiquer la valeur. Si rangeObj comprend plusieurs cellules, la valeur indiqué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.

Exemple

//Fixez la valeur de la cellule à False
 VP SET BOOLEAN VALUE(VP Cell("ViewProArea";3;2);False)

Voir également

VP SET VALUE

VP SET BORDER

VP SET BORDER ( rangeObj : Object ; borderStyleObj : Object ; borderPosObj : Object )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
borderStyleObj	Object	->	Objet contenant le style de bordure
borderPosObj	Object	->	Objet contenant le placement des bordures

Description

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 à laquelle s'appliquera le style de bordure. Si rangeObj contient plusieurs cellules, les bordures appliquées avec VP SET BORDER seront appliquées à rangeObj dans son intégralité (contrairement à la commande VP SET CELL STYLE qui les applique à chaque cellule de rangeObj). Si une feuille de style a déjà été appliquée, VP SET BORDER remplaceront les paramètres de bordure appliqués antérieurement à rangeObj.

Le paramètre borderStyleObj vous permet de définir le style des lignes de la bordure. borderStyleObj prend en charge les propriétés suivantes :

Propriété	Type	Description	Valeurs possibles
color	text	Defines the color of the border. Default = black.	CSS color "#rrggbb" syntax (preferred syntax), CSS color "rgb(r,g,b)" syntax (alternate syntax), CSS color name (alternate syntax)
style	Integer	Defines the style of the border. Default = empty.	`vk line style dash dot` `vk line style dash dot dot` `vk line style dashed` `vk line style dotted` `vk line style double` `vk line style empty` `vk line style hair` `vk line style medium` `vk line style medium dash dot` `vk line style medium dash dot dot` `vk line style medium dashed` `vk line style slanted dash dot` `vk line style thick` `vk line style thin`

Les bordures appliquées à l'aide de VP SET CELL STYLE seront appliquées à chaque cellule de rangeObj, contrairement à la commande VP SET BORDER qui applique les bordures à l'ensemble de rangeObj.

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.

Exemple 1

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)

Exemple 2

Ce code illustre, en termes de définition des bordures, la différence entre la commande VP SET BORDER et la commande VP SET CELL STYLE :

// 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)

Voir également

VP SET CELL STYLE

VP SET CELL STYLE ( rangeObj : Object ; styleObj : Object)

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
styleObj	Object	->	Objet style

Description

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 à laquelle s'appliquera le style. Si rangeObj contient plusieurs cellules, le style s'applique à chaque cellule.

Voir également

Le paramètre styleObj vous permet de passer un objet contenant des propriétés de style. Vous pouvez utiliser une feuille de style existante ou créer un nouveau style. Si styleObj contient à la fois une feuille de style existante et des propriétés de style supplémentaires, la feuille de style existante s'applique, suivie des propriétés supplémentaires.

Attribuez la valeur NULL pour supprimer un style et rétablir les paramètres de style par défaut (le cas échéant) :

attribuer la valeur NULL à styleObj supprimera toutes les propriétés de style de rangeObj,
attribuer la valeur NULL à un attribut supprimera l'attribut spécifique de rangeObj.

Pour plus d'informations sur les objets style et les feuilles de style, consultez le paragraphe Objets style.

Exemple

$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)

Voir également

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

VP SET COLUMN ATTRIBUTES ( rangeObj : Object ; propertyObj : Object)

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
propertyObj	Object	->	Objet contenant les propriétés de la colonne

Description

La commande VP SET COLUMN ATTRIBUTES applique les attributs définis dans la propriété propertyObj aux colonnes de la plage 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

Exemple

Pour modifier la taille de la deuxième colonne et définir un en-tête, le code suivant :

C_OBJECT($column;$properties)

$column:=VP Column("ViewProArea";1) //colonne B
$properties:=New object("width";100;"header";"Hello World")

VP SET COLUMN ATTRIBUTES($column;$properties)

Voir également

VP Column
VP Get column attributes
VP Get row attributes
VP SET ROW ATTRIBUTES

VP SET COLUMN COUNT

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	->	Indice de la feuille (feuille courante si omis)

Description

La commande VP SET COLUMN COUNT définit le nombre total de colonnes dans vpAreaName.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Passez le nombre total de lignes dans le paramètre rowCount. columnCount doit être supérieur à 0.

Dans le paramètre optionnel sheet, vous pouvez désigner une feuille de calcul spécifique dans laquelle s'appliquera columnCount (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 :

vk current sheet

Exemple

Le code suivant définit cinq colonnes dans la zone 4D View Pro :

VP SET COLUMN COUNT("ViewProArea";5)

Voir également

VP Get column count
VP Get row count
VP SET ROW COUNT

VP SET CURRENT SHEET

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

Description

La commande VP SET CURRENT SHEET The VP SET CURRENT SHEET command . La feuille courante est la feuille sélectionnée dans le document.

Passez le nom de la zone 4D View Pro dans vpAreaName.

Dans sheet, passez le numéro de la page cible. If no index is specified or if you pass -1, the command applies to the current sheet.

La numérotation démarre à 0.

Exemple

The document's current sheet is the first sheet:

first-sheet-selected

Set the current sheet to the third sheet:

VP SET CURRENT SHEET("ViewProArea";2)

Voir également

VP Get current sheet

VP SET CUSTOM FUNCTIONS

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

Description

La commande VP SET CUSTOM FUNCTIONS désigne les formules 4D qui peuvent être appelées directement depuis des formules 4D View Pro. .

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. Voir la page Formules et Fonctions.

La numérotation démarre à 0.

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 pouvant être appelées par des formules 4D View Pro et 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 (aucun espace n'est autorisé)
	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. Types pris en charge : `Is Boolean` `Is date` `Is Integer` `Is object` `Is real` `Is text` `Is time` If type is omitted or if the default value (-1) is passed, 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 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 longueur de parameters permet de déclarer les paramètres "optionnels" avec un type par défaut

ATTENTION
Dès que VP SET CUSTOM FUNCTIONS est appelé, les méthodes autorisées par la commande VP SET ALLOWED METHODS (le cas échéant) sont ignorées dans la zone 4D View Pro.
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.

Exemple

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

Voir également

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	Object	->	Nom d'objet formulaire zone 4D View Pro
dataObj	Object	->	Objet de données à charger dans le contexte de données
dataColl	Collection	->	Collection de données à charger dans le contexte de données
options	Object	->	Options supplémentaires
sheet	Integer	->	Numéro d'indice de la feuille

Description

La commande VP SET DATA CONTEXT définit le contexte de données d'une feuille. Un contexte de données est un objet ou une collection lié à une feuille de calcul et dont le contenu peut être utilisé pour remplir automatiquement les cellules de la feuille, soit en utilisant une option de génération automatique, soit la méthode VP SET BINDING PATH. En revanche, la commande VP Get data context peut renvoyer un contexte contenant des modifications apportées par l'utilisateur.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Dans dataObj ou dataColl, transmettez 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 heure dans dataObj ou dataColl, encapsulez-la dans un objet possédant les propriétés suivantes (voir example 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

Le paramètre valueObj est un objet qui définit la valeur et le format à assigner à rangeObj. 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. If no index is passed, the context is applied to the current sheet.

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. For more details, refer to the description of those methods.

Exemple

Pass an object and bind the context data to cells in the first row:

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")

Exemple 2

Pass a collection of objects and generate columns automatically:

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)

Exemple 3

The data passed as a parameter is a collection that contains subcollections. Each subcollection defines the contents of a row:

var $data : Collection
var $options : Object

$data:=New collection
$data.push(New collection(1; 2; 3; False; ""))  // 5 columns are created
$data.push(New collection)  // Second row is empty
$data.push(New collection(4; 5; Null; "hello"; "world"))  // Third row has 5 values
$data.push(New collection(6; 7; 8; 9))  // Fourth row has 4 values

$options:=New object("autoGenerateColumns"; True)

VP SET DATA CONTEXT("ViewProArea"; $data; $options)

Example 4 - Date and time syntax

var $data : Collection
var $options : Object

$data:= New collection()

// Dates can be passed as scalar values
$data.push(New collection("Date"; Current date)) 

// Time values must be passed as object attributes
$data.push(New collection("Time"; New object("time"; 5140)))

// Date + time example
$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 :

Voir également

VP SET BINDING PATH
VP Get binding path
VP Get data context

VP SET DATE TIME VALUE

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	->	Valeur heure à fixer
formatPattern	Text	->	Format de la valeur

Description

La commande VP SET DATE TIME VALUE affecte une valeur de date et d'heure spécifiée à une plage de cellules désignée.

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. Pour plus d'informations sur les modèles et les caractères de formatage, veuillez consulter la section Format date et heure.

Exemple

//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)

Voir également

4D View Pro cell format
VP SET DATE VALUE
VP SET TIME VALUE
VP SET VALUE

VP SET DATE 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

Description

La commande VP SET DATE VALUE affecte une valeur de date spécifiée à une plage de cellules désignée.

Dans rangeObj, passez la plage de cellule(s) dont vous souhaitez indiquer la valeur. Si rangeObj comprend plusieurs cellules, la valeur indiquée sera répétée dans chaque cellule.

Le paramètre dateValue indique une valeur date à assigner à rangeObj.

Le paramètre optionnel 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"

Pour plus d'informations sur les modèles et les caractères de formatage, veuillez consulter la section Format date et heure.

Exemple

//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)

Voir également

4D View Pro cell format
VP SET DATE TIME VALUE
VP SET VALUE

VP SET DEFAULT STYLE

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	->	Objet style
sheet	Integer	->	Indice de la feuille (par défaut = feuille courante)

Description

La commande VP SET DEFAULT STYLE définit le style dans styleObj comme style par défaut pour une sheet.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Le paramètre 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. Pour plus d'informations, consultez Objets style.

Dans le paramètre optionnel sheet, vous pouvez désigner une feuille spécifique dans laquelle 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 :

vk current sheet

Exemple

$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)

Voir également

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

VP SET FIELD ( rangeObj : Object ; field : Pointer { ; formatPattern : Text } )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
champ	Pointer	->	Référence au champ dans la structure virtuelle
formatPattern	Text	->	Format du champ

Description

La commande VP SET FIELD affecte un champ virtuel de la base de données 4D à une plage de cellules désignée.

Dans rangeObj, passez la plage de cellule(s) dont vous souhaitez indiquer la valeur. Si rangeObj comprend plusieurs cellules, le champ spécifié sera lié à chaque cellule.

Le paramètre field indique un champ virtuel de la base 4D à assigner à rangeObj. Le nom de la structure virtuelle pour le field peut être visualisé dans la barre de formule. Si du contenu est déjà présent dans l'une des cellules de rangeObj, il sera remplacé par rangeObj.

Le paramètre optionnel formatPattern définit un modèle pour le paramètre field. Vous pouvez passer n'importe quel format personnalisé valide.

Exemple

VP SET FIELD(VP Cell("ViewProArea";5;2);->[TableName]Field)

Voir également

VP SET VALUE

VP SET FORMULA

VP SET FORMULA ( rangeObj : Object ; formula : Text { ; formatPattern : Text } )

| Paramètres | Type | | Description | | ---------- | ---- | | ----------- | | | | | |

Description

La commande VP SET FORMULA affecte une formule ou une méthode 4D spécifique à une plage de cellules désignée.

Le paramètre formula indique un nom de formule ou de méthode 4D à assigner à rangeObj.

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. Si une méthode 4D est utilisée, elle doit être autorisée à l'aide de la commande VP SET ALLOWED METHODS.

Le paramètre optionnel formatPattern définit un pattern (modèle) pour le paramètre formula.

Vous pouvez supprimer la formule de rangeObj en la remplaçant par une chaîne vide ("").

Exemple 1

VP SET FORMULA(VP Cell("ViewProArea";5;2);"SUM($A$1:$C$10)")

Exemple 2

Pour supprimer la formule :

VP SET FORMULA(VP Cell("ViewProArea";5;2);"")

Exemple 3

VP SET FORMULA($range; "SUM(A1,B7,C11)") //"," pour séparer les paramètres

Voir également

Cell format
VP Get Formula
VP SET FORMULAS
VP SET VALUE

VP SET FORMULAS

VP SET FORMULAS ( rangeObj : Object ; formulasCol : Collection )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage de cellules
formulasCol	Collection	->	Collection de formules

Description

La commande VP SET FORMULAS assigne une collection de formules à partir de la plage de cellules spécifiée.

Dans rangeObj, passez la plage de la cellule (créée avec VP Cell) dont vous souhaitez indiquer la formule. Si rangeObj comprend plusieurs plages, seule la première plage est utilisée.

Le paramètre formulasCol est une collection bidimensionnelle :

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, utilisez le point . comme séparateur numérique et la virgule , comme séparateur de paramètres. Si une méthode 4D est utilisée, elle doit être autorisée à l'aide de la commande VP SET ALLOWED METHODS.

Vous pouvez supprimer les formules dans rangeObj en les remplaçant par une chaîne vide ("").

Exemple 1

$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 :

$0:=$1*3.33

Exemple 2

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

Voir également

VP Get Formulas
VP GET VALUES VP SET FORMULA
VP SET VALUES

VP SET FROZEN PANES

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)

Description

La commande VP SET FROZEN PANES définit l'état gelé des colonnes et des lignes dans paneObj afin qu'elles soient toujours affichées dans 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 de gauche ou de droite : Pour les colonnes situées à gauche de la feuille, le trait s'affiche sur le côté droit de la dernière colonne figé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 du haut ou du bas : Pour les lignes situées en haut de la feuille, le trait s'affiche en-dessous de la première ligne figée. Pour les lignes situées en bas de la feuille, le trait s'affiche au-dessus de la première ligne figée.

Passez le nom de la zone 4D View Pro dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Vous pouvez passer un objet définissant les lignes et colonnes à figer 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 :

vk current sheet

Exemple

Vous souhaitez figer les trois premières colonnes de gauche, deux colonnes de droite et la première ligne :

C_OBJECT($panes)

$panes:=New object
$panes.columnCount:=3
$panes.trailingColumnCount:=2
$panes.rowCount:=1

VP SET FROZEN PANES("ViewProArea";$panes)

Voir également

VP Get frozen panes

VP SET NUM VALUE

VP SET NUM VALUE ( rangeObj : Object ; numberValue : Number { ; formatPattern : Text } )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
numberValue	Number	->	Valeur du nombre à fixer
formatPattern	Text	->	Format de la valeur

Description

La commande VP SET NUM VALUE affecte une valeur numérique spécifiée à une plage de cellules désignée.

Le paramètre numberValue indique une valeur numérique à assigner à rangeObj.

Le paramètre optionnel formatPattern définit un pattern pour le paramètre numberValue.

Exemple

//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_)")

Voir également

Cell format
VP SET VALUE

VP SET PRINT INFO

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 attributs d'impression
sheet	Integer	->	Indice de la feuille (feuille courante si omis)

Description

La commande VP SET PRINT INFO définit les attributs à utiliser lors de l'impression de vpAreaName.

Passez le nom de la zone 4D View Pro que vous souhaitez imprimer dans vpAreaName. Si vous passez un nom inexistant, une erreur est retournée.

Vous pouvez passer un objet contenant les définitions de plusieurs attributs d'impression dans le paramètre printInfo. Pour consulter la liste complète des attributs disponibles, veuillez vous reporter à Attributs d'impression.

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 :

vk current sheet

Exemple

Le code suivant imprimera une nouvelle zone 4D View Pro dans un document PDF :

var $printInfo : Object

//déclarer l'objet d'attributs d'impression
$printInfo:=New object

//definir les 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 un logo
$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 un 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 :

Voir également

4D View Pro print attributes
VP Convert to picture
VP Get print info
VP PRINT

VP SET ROW ATTRIBUTES

VP SET ROW ATTRIBUTES ( rangeObj : Object ; propertyObj : Object )

Paramètres	Type		Description
rangeObj	Object	->	Plage de lignes
propertyObj	Object	->	Objet contenant les propriétés de la ligne

Description

La commande VP SET ROW ATTRIBUTES applique les attributs définis dans la propriété propertyObj aux lignes de la plage 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 renseigner les attributs à appliquer aux lignes de 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

Exemple

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)

Voir également

VP Get row attributes
VP get column attributes
VP SET ROW ATTRIBUTES

VP SET ROW COUNT

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	->	Indice de la feuille (feuille courante si omis)

Description

La commande VP SET ROW COUNT définit le nombre total de lignes dans vpAreaName.

Passez le nom de la zone 4D View Pro dans vpAreaName. 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 optionnel sheet, vous pouvez désigner une feuille de calcul spécifique dans laquelle s'appliquera rowCount (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 :

vk current sheet

Exemple

Le code suivant définit cinq lignes dans la zone 4D View Pro :

VP SET ROW COUNT("ViewProArea";5)

Voir également

VP Get column count
VP get row-count
VP SET COLUMN COUNT

VP SET SELECTION

VP SET SELECTION ( rangeObj : Object )

Paramètres	Type		Description
rangeObj	Object	->	Objet de plage de cellules

Description

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.

Exemple

$currentSelection:=VP Combine ranges(VP Cells("myVPArea";3;2;1;6);VP Cells("myVPArea";5;7;1;7))
VP SET SELECTION($currentSelection)

Voir également

VP Get active cell
VP Get selection
VP RESET SELECTION
VP SET ACTIVE CELL
VP ADD SELECTION
VP SHOW CELL

VP SET SHEET COUNT

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

Description

La commande VP SET SHEET COUNT définit le nombre de feuilles dans vpAreaName.

Dans number, indiquez un nombre correspondant au nombre de feuilles que le document contiendra après l'exécution de la commande.

Attention: La commande supprimera des feuilles si le nombre précédent de feuilles dans votre document est supérieur au nombre passé. 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.

Exemple

Le document comporte actuellement une feuille :

Pour régler le nombre de feuilles sur 3 :

VP SET SHEET COUNT("ViewProArea";3)

Voir également

VP Get sheet count

VP SET SHEET NAME

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	->	Nouveau nom de la feuille
sheet	Integer	->	Index de la feuille à renommer

Description

La commande VP SET SHEET NAME renomme une feuille dans le document chargé dans vpAreaName.

Passez le nom de la zone 4D View Pro dans vpAreaName.

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

Exemple

Le nom de la troisième feuille est "Total premier trimestre" :

VP SET SHEET NAME("ViewProArea";"Total first quarter";2)

VP SET SHEET OPTIONS

VP SET SHEET OPTIONS ( vpAreaName : Text; sheetOptions : Object { ; sheet : Integer} )

Paramètres	Type		Description
vpAreaName	Object	->	Nom de la zone 4D View Pro
sheetOptions	Object	->	Option(s) de la feuille à définir
sheet	Object	->	Indice de la feuille (feuille courante si omis)

Description

La commande VP SET SHEET OPTIONS permet de définir diverses 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. Pour visualiser la liste complète des options disponibles, veuillez vous reporter aux Sheet Options de 4D View Pro.

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 :

vk current sheet

Exemple 1

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))

Exemple 2

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)

Exemple 3

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:

Exemple 4

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:

Voir également

4D View Pro sheet options
VP Get sheet options

VP SET SHOW PRINT LINES

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	->	Lignes d'impression affichées si True (par défaut), cachées si False
sheet	Integer	->	Indice de la feuille (feuille courante si omis)

Description

La commande VP SET SHOW PRINT LINES permet d'afficher ou non les lignes d'aperçu avant impression dans une feuille de calcul..

Passez le nom de la zone 4D View Pro dans vpAreaName.

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.

Exemple

Le code suivant affiche les lignes d'impression dans la deuxième feuille d'un document :

VP SET SHOW PRINT LINES("ViewProArea";True;1)

set-show-print-lines

Avec un saut de page :

set-show-print-lines-with-page-break

Voir également

4D Get show print lines

VP SET TABLE COLUMN ATTRIBUTES

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	->	Indice de la feuille (feuille courante si omis)

Description

La commande VP SET TABLE COLUMN ATTRIBUTES applique les attribute définis à la colonne column dans la tableName.

Passez le nom de la zone 4D View Pro dans vpAreaName.

Dans le paramètre attributes, passez un objet contenant 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. Voir Structured Reference Formulas dans la documentation de SpreadJS
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é (la valeur par défaut est `True` lors de la création de la table).

Dans sheet, passez le numéro de la page cible. Si aucun numéro n'est spécifié ou si vous passez -1, la commande s'applique à la feuille courante.

La numérotation démarre à 0.

Si tableName n'est pas trouvé ou si column est supérieur au nombre de colonnes, la commande ne fait rien.

Exemple

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))

Voir également

VP CREATE TABLE
VP Find table
VP Get table column attributes
VP RESIZE TABLE

VP SET TABLE THEME

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

Description

La commande VP SET TABLE THEME modifie le thème courant de la table tableName.

Dans vpAreaName, passez le nom de la zone 4D View Pro et dans tableName, le nom de la table à modifier.

Dans le paramètre options , passez un objet de la classe cs.ViewPro.TableTheme qui contient les propriétés du thème à modifier.

Exemple 1

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)

Exemple 2

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)

Voir également

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	->	Valeur texte à fixer
formatPattern	Text	->	Format de la valeur

Description

La commande VP SET TEXT VALUE affecte une valeur de texte spécifiée à une plage de cellules désignée.

Le paramètre textValue indique une valeur texte à assigner à rangeObj.

Le paramètre optionnel formatPattern définit un pattern pour le paramètre textValue.

Exemple

VP SET TEXT VALUE(VP Cell("ViewProArea";3;2);"Test 4D View Pro")

Voir également

Cell Format
VP SET VALUE

VP SET TIME VALUE

VP SET TIME VALUE ( rangeObj : Object ; timeValue : Text { ; formatPattern : Text } )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
timeValue	Text	->	Valeur heure à fixer
formatPattern	Text	->	Format de la valeur

Description

La commande VP SET TIME VALUE affecte une valeur temporelle spécifiée à une plage de cellules désignée.

Le paramètre timeValue spécifie une heure exprimée en secondes à attribuer à rangeObj.

Le paramètre optionnel formatPattern définit un pattern (modèle) pour le paramètre timeValue.

Exemple

//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)

Voir également

Cell Format
VP SET DATE TIME VALUE
VP SET VALUE

VP SET VALUE

VP SET VALUE ( rangeObj : Object ; valueObj : Object )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
valueObj	Object	->	Valeurs des cellules et options de format

Description

La commande VP SET VALUE affecte une valeur spécifiée à une plage de cellules désignée.

Cette commande vous permet d'utiliser un code générique pour définir et formater les types de valeurs dans rangeObj, alors que d'autres commandes, telles que VP SET TEXT VALUE et VP SET NUM VALUE, limitent les valeurs à des types spécifiques.

Le paramètre valueObj est un objet qui définit la valeur et le format à assigner à rangeObj. Il peut contenir les propriétés suivantes :

Propriété	Type	Description
value	Integer, Real, Boolean, Text, Date, Null	Valeur à assigner à rangeObj (exceptée heure). 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. Pour plus d'informations sur les modèles et les caractères de formatage, veuillez consulter la section Format de cellule.

Exemple

//Fixer la valeur de la cellule à Faux
 VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";False))

 //Fixer la valeur de la cellule à 2
 VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";2))

 //Fixer la valeur de la cellule à $125,571.35
 VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_($* #,##0.00_)"))

 //Fixer la valeur de la cellule à Hello World!
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";"Hello World!"))

 //Fixer la valeur de la cellule à date du jour
 VP SET VALUE(VP Cell("ViewProArea";4;2);New object("value";Current date))

 //Fixer la valeur de la cellule à heure courante
 VP SET VALUE(VP Cell("ViewProArea";5;2);New object("time";Current time))

 //Fixer la valeur de la cellule à une date et une heure spécifiques
 VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time";?14:30:10?;"format";vk pattern full date time))

 //Effacer le contenu de la cellule
 VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";Null))!

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))

Voir également

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

VP SET VALUES ( rangeObj : Object ; valuesCol : Collection )

Paramètres	Type		Description
rangeObj	Object	->	Objet plage
valuesCol	Collection	->	Collection de valeurs

Description

La commande VP SET VALUES assigne une collection de valeurs à partir de la plage de cellules spécifiée.

Dans rangeObj, passez une plage de cellule (créée via VP Cell) dont vous souhaitez indiquer la valeur. 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)

Exemple

$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)

Voir également

VP Get formulas
VP Get value
VP Get Values
VP SET FORMULAS
VP SET VALUE

VP SET WORKBOOK OPTIONS

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 de workbook

Description

VP SET WORKBOOK OPTIONS définit les options du classeur dans vpAreaName.

Passez le nom de la zone 4D View Pro dans vpAreaName.

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 The drag merge operation is allowed (select cells and drag the selection to merge cells)

allowAutoCreateHyperlink boolean Enables automatic creation of hyperlinks in the spreadsheet.

allowContextMenu boolean The built-in context menu can be opened.

allowCopyPasteExcelStyle boolean Styles from a spreadsheet can be copied and pasted to Excel, and vice-versa.

allowDynamicArray boolean Enables dynamic arrays in worksheets

allowExtendPasteRange boolean Extends the pasted range if the pasted range is not enough for the pasted data

allowSheetReorder boolean Sheet reordering is allowed

allowUndo boolean Undoing edits is allowed.

allowUserDeselect boolean Deselecting specific cells from a selection is allowed.

allowUserDragDrop boolean Drag and drop of range data is allowed

allowUserDragFill boolean Drag fill is allowed

allowUserEditFormula boolean Formulas can be entered in cells

allowUserResize boolean Columns and rows can be resized

allowUserZoom boolean Zooming (ctrl + mouse wheel) is allowed

autoFitType

number

Content is formatted to fit in cells, or cells and headers. Valeurs disponibles :

Constante	Valeur	Description
vk auto fit type cell	0	The content autofits cells
vk auto fit type cell with header	1	The content autofits cells and headers

backColor string A color string used to represent the background color of the area, such as "red", "#FFFF00", "rgb(255,0,0)", "Accent 5". The initial backgroundcolor is hidden when a backgroundImage is set.

backgroundImage string / picture / file Background image for the area.

backgroundImageLayout

number

How the background image is displayed. Valeurs disponibles :

Constante	Valeur	Description
vk image layout center	1	In the center of the area.
vk image layout none	3	In the upper left corner of the area with its original size.
vk image layout stretch	0	Fills the area.
vk image layout zoom	2	Displayed with its original aspect ratio.

calcOnDemand boolean Formulas are calculated only when they are demanded.

columnResizeMode

number

Resize mode for columns. Valeurs disponibles :

Constante	Valeur	Description
vk resize mode normal	0	Use normal resize mode (i.e remaining columns are affected)
vk resize mode split	1	Use split mode (i.e remaining columns are not affected)

copyPasteHeaderOptions

number

Headers to include when data is copied to or pasted. Valeurs disponibles :

Constante	Valeur	Description
vk copy paste header options all headers	3	Includes selected headers when data is copied; overwrites selected headers when data is pasted.
vk copy paste header options column headers	2	Includes selected column headers when data is copied; overwrites selected column headers when data is pasted.
vk copy paste header options no headers	0	Column and row headers are not included when data is copied; does not overwrite selected column or row headers when data is pasted.
vk copy paste header options row headers	1	Includes selected row headers when data is copied; overwrites selected row headers when data is pasted.

customList collection The list for users to customize drag fill, prioritize matching this list in each fill. Each collection item is a collection of strings. See on GrapeCity's website.

cutCopyIndicatorBorderColor string Border color for the indicator displayed when the user cuts or copies the selection.

cutCopyIndicatorVisible boolean Display an indicator when copying or cutting the selected item.

defaultDragFillType

number

The default drag fill type. Available values :

Constante	Valeur	Description
vk auto fill type auto	5	Automatically fills cells.
vk auto fill type clear values	4	Clears cell values.
vk auto fill type copycells	0	Fills cells with all data objects, including values, formatting, and formulas.
vk auto fill type fill formatting only	2	Fills cells only with formatting.
vk auto fill type fill series	1	Fills cells with series.
vk auto fill type fill without formatting	3	Fills cells with values and not formatting.

enableAccessibility boolean Accessibility support is enabled in the spreadsheet.

enableFormulaTextbox boolean The formula text box is enabled.

grayAreaBackColor string A color string used to represent the background color of the gray area , such as "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", and so on.

highlightInvalidData boolean Invalid data is highlighted.

iterativeCalculation boolean Enables iterative calculation. See on Grapecity's website.

iterativeCalculationMaximumChange numérique Maximum amount of change between two calculation values.

iterativeCalculationMaximumIterations numérique Number of times the formula should recalculate.

newTabVisible boolean Display a special tab to let users insert new sheets.

numbersFitMode

number

Changes display mode when date/number data width is longer than column width. Valeurs disponibles :

Constante	Valeur	Description
vk numbers fit mode mask	0	Replace data content with "###" and shows tip
vk numbers fit mode overflow	1	Display data content as a string. If next cell is empty, overflow the content.

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 for cell and range references in cell formulas. Valeurs disponibles :

Constante	Valeur	Description
vk reference style A1	0	Use A1 style.
vk reference style R1C1	1	Use R1C1 style

resizeZeroIndicator

number

Drawing policy when the row or column is resized to zero. Valeurs disponibles :

Constante	Valeur	Description
vk resize zero indicator default	0	Uses the current drawing policy when the row or column is resized to zero.
vk resize zero indicator enhanced	1	Draws two short lines when the row or column is resized to zero.

rowResizeMode number The way rows are resized. Available values are the same as columnResizeMode

scrollbarAppearance

number

Scrollbar appearance. Valeurs disponibles :

Constante	Valeur	Description
vk scrollbar appearance mobile	1	Mobile scrollbar appearance.
vk scrollbar appearance skin (default)	0	Excel-like classic scrollbar appearance.

scrollbarMaxAlign boolean The scroll bar aligns with the last row and column of the active sheet.

scrollbarShowMax boolean The displayed scroll bars are based on the entire number of columns and rows in the sheet.

scrollByPixel boolean Enable precision scrolling by pixel.

scrollIgnoreHidden boolean The scroll bar ignores hidden rows or columns.

scrollPixel entier Decides scrolling by that number of pixels at a time when scrollByPixel is true. The final scrolling pixels are the result of scrolling delta * scrollPixel. For example: scrolling delta is 3, scrollPixel is 5, the final scrolling pixels are 15.

showDragDropTip boolean Display the drag-drop tip.

showDragFillSmartTag boolean Display the drag fill dialog.

showDragFillTip boolean Display the drag-fill tip.

showHorizontalScrollbar boolean Display the horizontal scroll bar.

showResizeTip

number

How to display the resize tip. Valeurs disponibles :

Constante	Valeur	Description
vk show resize tip both	3	Horizontal and vertical resize tips are displayed.
vk show resize tip column	1	Only the horizontal resize tip is displayed.
vk show resize tip none	0	No resize tip is displayed.
vk show resize tip row	2	Only the vertical resize tip is displayed.

showScrollTip

number

How to display the scroll tip. Valeurs disponibles :

Constante	Valeur	Description
vk show scroll tip both	3	Horizontal and vertical scroll tips are displayed.
vk show scroll tip horizontal	1	Only the horizontal scroll tip is displayed.
vk show scroll tip none	No scroll tip is displayed.
vk show scroll tip vertical	2	Only the vertical scroll tip is displayed.

showVerticalScrollbar boolean Display the vertical scroll bar.

tabEditable boolean The sheet tab strip can be edited.

tabNavigationVisible boolean Display the sheet tab navigation.

tabStripPosition

number

Position of the tab strip. Valeurs disponibles :

Constante	Valeur	Description
vk tab strip position bottom	0	Tab strip position is relative to the bottom of the workbook.
vk tab strip position left	2	Tab strip position is relative to the left of the workbook.
vk tab strip position right	3	Tab strip position is relative to the right of the workbook.
vk tab strip position top	1	Tab strip position is relative to the top of the workbook.

tabStripRatio number Percentage value (0.x) that specifies how much of the horizontal space will be allocated to the tab strip. The rest of the horizontal area (1 - 0.x) will allocated to the horizontal scrollbar.

tabStripVisible boolean Display the sheet tab strip.

tabStripWidth number Width of the tab strip when position is left or right. Default and minimum is 80.

useTouchLayout boolean Whether to use touch layout to present the Spread component.

Exemple

Pour définir l'option allowExtendpasteRange dans "ViewProArea" :

var $workbookOptions : Object

$workbookOptions:= New Object
$workbookOptions.allowExtendPasteRange:=True

VP SET WORKBOOK OPTIONS("ViewProArea";$workbookOptions)

Voir également

VP Get workbook options

VP SHOW CELL

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

Description

La commande VP SHOW CELL repositionne verticalement et horizontalement la vue du rangeObj.

Dans rangeObj, passez, en tant qu'objet, une 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 vPos 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'appliquera à la limite de la cellule, ligne ou colonne, en fonction de la position de la vue indiquée : Position verticale de la vue - cellule ou ligne Position horizontale de la vue - cellule ou ligne	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'appliquera à la limite de la cellule, ligne ou colonne, en fonction de la position de la vue indiquée : Position verticale de la vue (haut, centre, bas) - cellule ou ligne Position horizontale de la vue (gauche, centre, droite) - cellule ou ligne	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.

Exemple

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:

Voir également

VP ADD CELL
VP Get active cell
VP Get selection
VP RESET SELECTION
VP SET ACTIVE CELL
VP SET SELECTION

VP SUSPEND COMPUTING

VP SUSPEND COMPUTING ( vpAreaName : Text )

Paramètres	Type		Description
vpAreaName	Text	->	Nom de la zone 4D View Pro dans le formulaire

Description

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 VP SUSPEND COMPUTING et qui sont exécutées, ne sont pas calculées.

Passez le nom de la zone 4D View Pro dans vpAreaName. 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. Ainsi, chaque exécution de VP SUSPEND COMPUTING doit être compensé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.

Exemple

Vous avez ajouté deux boutons au formulaire afin que l'utilisateur puisse suspendre/reprendre les calculs :

Le code du bouton Suspend Computing :

 //mettre les calculs sur pause pendant que les utilisateurs saisissent les informations
 If(FORM Event.code=On Clicked)

    VP SUSPEND COMPUTING("ViewProArea")

 End if

If(FORM Event.code=On Clicked)

    VP RESUME COMPUTING("ViewProArea")

End if

Voir également

VP RECOMPUTE FORMULAS
VP RESUME COMPUTING

Propriété	Type	Description
value	Date	Valeur dans la cellule (sauf heure)
time	Real	Valeur heure (en secondes) si la valeur est du type js

A​

VP ADD FORMULA NAME​

Description​

Exemple​

Voir également​

VP ADD RANGE NAME​

Description​

Exemple​

Voir également​

VP ADD SELECTION​

Description​

Exemple​

Voir également​

VP ADD SHEET​

Description​

Exemple​

Voir également​

VP ADD SPAN​

Description​

Exemple​

Voir également​

VP ADD STYLESHEET​

Description​

Exemple​

Voir également​

VP All​

Description​

Exemple​

Voir également​

C​

VP Cell​

Description​

Exemple​

Voir également​

VP Cells​

Description​

Exemple​

Voir également​

VP Column​

Description​

Exemple​

Voir également​

VP COLUMN AUTOFIT​

Description​

Exemple​

Voir également​

VP Combine ranges​

Description​

Exemple​

Voir également​

VP Convert from 4D View​

Description​

Exemple​

VP Convert to picture​

Description​

Résultat​

Exemple​

Voir également​

VP Copy to object​

Description​

Exemple​

Voir également​

VP CREATE TABLE​

Description​

Exemple​

Voir également​

D​

VP DELETE COLUMNS​

Description​

Exemple​

Voir également​

VP DELETE ROWS​

Description​

Exemple​

Voir également​

E​

VP EXPORT DOCUMENT​

Description​

Passer une méthode callback (formula)​

Exemple 1​

A

VP ADD FORMULA NAME

Description

Exemple

Voir également

VP ADD RANGE NAME

Description

Exemple

Voir également

VP ADD SELECTION

Description

Exemple

Voir également

VP ADD SHEET

Description

Exemple

Voir également

VP ADD SPAN

Description

Exemple

Voir également

VP ADD STYLESHEET

Description

Exemple

Voir également

VP All

Description

Exemple

Voir également

C

VP Cell

Description

Exemple

Voir également

VP Cells

Description

Exemple

Voir également

VP Column

Description

Exemple

Voir également

VP COLUMN AUTOFIT

Description

Exemple

Voir également

VP Combine ranges

Description

Exemple

Voir également

VP Convert from 4D View

Description

Exemple

VP Convert to picture

Description

Résultat

Exemple

Voir également

VP Copy to object

Description

Exemple

Voir également

VP CREATE TABLE

Description

Exemple

Voir également

D

VP DELETE COLUMNS

Description

Exemple

Voir également

VP DELETE ROWS

Description

Exemple

Voir également

E

VP EXPORT DOCUMENT

Description

Passer une méthode callback (formula)

Exemple 1