Aller au contenu principal
Version: 20 R8 BETA

Configuration des zones 4D View Pro

Les propriétés de la zone 4D View Pro peuvent être configurées à l'aide de la liste des propriétés. Les propriétés des feuilles de calcul sont disponibles à l'aide du langage.

Propriétés de la zone de formulaire

En utilisant la liste des propriétés de la zone, vous pouvez définir des propriétés de l'objet 4D View Pro comme Nom de l'objet, Variable ou Expression, Apparence, Action et Événements.

Sélection d'une interface utilisateur

Vous pouvez sélectionner l'interface à utiliser avec vos zones de formulaire 4D View Pro dans la Liste de propriétés, dans Apparence :

Vous pouvez également utiliser les propriétés JSON userInterface et withFormulaBar (uniquement avec l'interface "toolbar").

Les interfaces permettent d'effectuer des modifications de base et de manipuler des données. Les modifications définies par l'utilisateur sont enregistrées dans l'objet 4D View Pro lorsque l'utilisateur enregistre le document.

Ruban

Toolbar (Barre d’outils)

L'activation de l'interface de la barre d'outils affiche l'option Afficher la barre de formule. Si la case de l'option est cochée, la barre de formule est visible en-dessous de l'interface Barre d'outils.

Lorsque la barre de formule est visible :

Fonctionnalités

Les interfaces de Ruban et de Barre d'outils regroupent les fonctionnalités qui s'y rattachent dans des onglets :

OngletActionsInterface RubanInterface Barre d'outils
FileGestion de fichiersX
AccueilApparence du texteXX
InsérerAjouter des élémentsXX
FormulesCalculs de formules et bibliothèqueXX
DataGestion des donnéesXX
AffichagePrésentation visuelleXX
PropriétésPrésentation de la feuilleX

Evénements formulaire

Les événements formulaire suivants sont disponibles dans la Liste de propriétés des zones 4D View Pro.

Certains de ces événements sont des événements formulaire standard (disponibles pour tous les objets actifs) et d'autres sont des événements formulaire spécifiques à 4D View Pro. Certains de ces événements sont des événements formulaire standard (disponibles pour tous les objets actifs) et d'autres sont des événements formulaire spécifiques à 4D View Pro. Le tableau suivant indique les événements standard et les événements spécifiques ou ceux qui fournissent des informations supplémentaires aux zones 4D View Pro :

Événements 4D standardÉvénements 4D View Pro spécifiques et étendus
On LoadOn VP Ready
On Getting FocusOn Clicked
On Losing FocusOn Double Clicked
On UnloadOn Header Click
On After Edit
On Selection Change
On Column Resize
On Row Resize
On VP Range Changed

Options feuille

L'objet options feuille 4D View Pro vous permet de contrôler plusieurs options pour vos zones 4D View Pro. Cet objet est géré par les commandes suivantes :

Apparence de la feuille

PropriétéTypeDescription
allowCellOverflowbooleanIndique si les données peuvent déborder sur des cellules vides adjacentes.
sheetTabColorstringUne chaîne couleur utilisée pour représenter la couleur de l'onglet de la feuille, telle que "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc.
frozenlineColorstringUne chaîne couleur utilisée pour représenter la couleur de ligne figée, telle que "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc.
clipBoardOptionsentier longL'option presse-papiers. Valeurs disponibles : vk clipboard paste options all, vk clipboard paste options formatting, vk clipboard paste options formulas, vk clipboard paste options formulas and formatting, vk clipboard paste options values, vk clipboard paste options values and formatting
gridlineobjectLes options du quadrillage.
colorstringUne chaîne couleur utilisée pour représenter la couleur du quadrillage, telle que "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc.
showVerticalGridlinebooleanIndique s'il affiche le quadrillage vertical.
showHorizontalGridlinebooleanIndique s'il affiche le quadrillage horizontal.
rowHeaderVisiblebooleanIndique si l'en-tête de la ligne est visible.
colHeaderVisiblebooleanIndique si l'en-tête de la colonne est visible.
rowHeaderAutoTextentier longIndique si l'en-tête de la ligne affiche des lettres ou des chiffres ou s'il n'affiche rien. Valeurs disponibles : vk header auto text blank, vk header auto text letters, vk header auto text numbers
colHeaderAutoTextentier longIndique si l'en-tête de la colonne affiche des lettres ou des chiffres ou s'il n'affiche rien. Valeurs disponibles : vk header auto text blank, vk header auto text letters, vk header auto text numbers
selectionBackColorstringLa couleur d'arrière-plan de la sélection dans la feuille (de préférence au format Rgba).
selectionBorderColorstringLa couleur de bordure de la sélection dans la feuille.
sheetAreaOffsetobjectLes options de sheetAreaOffset.
leftentier longLe décalage gauche de la feuille à partir de l'hôte.
topentier longLe décalage supérieur de la feuille à partir de l'hôte.

Toutes les propriétés sont optionnelles.

Protection de la feuille

Pour verrouiller l'intégralité de la feuille, il suffit de mettre la propriété isProtected à vrai. Vous pouvez alors déverrouiller les cellules individuellement en définissant la propriété de style de la cellule verrouillée.

PropriétéTypeDescription
isProtectedbooleanIndique si les cellules protégées de cette feuille peuvent être modifiées ou non.
protectionOptionsobjectUne valeur qui indique les éléments que les utilisateurs peuvent modifier. Si null : le paramètre protectionOptions est réinitialisé.
allowSelectLockedCellsbooleanIndique si l'utilisateur peut sélectionner des cellules verrouillées, optionnel. Vrai par défaut.
allowSelectUnlockedCellsbooleanIndique si l'utilisateur peut sélectionner des cellules non verrouillées, optionnel. Vrai par défaut.
allowSortbooleanIndique si l'utilisateur peut trier des plages, optionnel. Faux par défaut.
allowFilterbooleanIndique si l'utilisateur peut filtrer des plages, optionnel. Faux par défaut.
allowEditObjectsbooleanIndique si l'utilisateur peut modifier des objets flottants, optionnel. Faux par défaut.
allowResizeRowsbooleanIndique si l'utilisateur peut redimensionner des lignes, optionnel. Faux par défaut.
allowResizeColumnsbooleanIndique si l'utilisateur peut redimensionner des colonnes, optionnel. Faux par défaut.
booleanbooleanIndique si l'utilisateur peut effectuer des opérations de glissement pour insérer des lignes, optionnel. Faux par défaut.
allowDragInsertColumnsbooleanIndique si l'utilisateur peut effectuer des opérations de glissement pour insérer des colonnes, optionnel. Faux par défaut.
allowInsertRowsbooleanIndique si l'utilisateur peut insérer des lignes, optionnel. Faux par défaut.
allowInsertColumnsbooleanIndique si l'utilisateur peut insérer des colonnes, optionnel. Faux par défaut.
allowDeleteRowsbooleanIndique si l'utilisateur peut supprimer des lignes, optionnel. Faux par défaut.
allowDeleteColumnsbooleanIndique si l'utilisateur peut supprimer des colonnes, optionnel. Faux par défaut.

Toutes les propriétés sont optionnelles.

Format des cellules

La définition d'un modèle de format garantit que le contenu de vos documents 4D View Pro s'affiche comme souhaité. Les formats peuvent être définis à l'aide de l'interface 4D View Pro sélectionnée, ou à l'aide des commandes VP SET VALUE ou VP SET NUM VALUE.

4D View Pro dispose de formats intégrés pour les chiffres, les dates, les heures et le texte, mais il vous est possible de créer vos propres modèles pour formater le contenu des cellules à l'aide de caractères et de codes spéciaux.

Par exemple, lors de l'utilisation des commandes VP SET VALUE ou VP SET NUM VALUE pour saisir des montants dans une facture, vous pouvez vouloir utiliser les symboles monétaires ($, €, ¥, etc.) pour être aligné quel que soit l'espace nécessaire par le numéro (c'est-à-dire que le montant soit de 5,00 $ ou 5 000,00 $). Vous pourriez utiliser des caractères de formatage et indiquer le motif ($* #,##0.00) qui afficherait les montants comme indiqué:

A noter que lorsque vous créez vos propres modèles, seul l'affichage des données est modifié. La valeur des données reste inchangée.

Format texte et format numérique

Les formats numériques s'appliquent à tous les types de chiffres (ex : nombres positifs, négatifs, les zéros).

CaractèreDescriptionExemple
0Placeholder qui affiche des zéros.#.00 affichera 1.10 au lieu de 1.1
.Affiche un point décimal0.00 affichera 1999.00 au lieu de 1999
,Affiche le séparateur de milliers dans un nombre. Les milliers sont séparés par des virgules si le format contient une virgule entourée par des chiffres "#" ou par des zéros. Une virgule suivant un caractère de remplacement d'un chiffre multiplie le nombre par 1 000.#,0 affichera 12200000 au lieu de 12,200,000
_Saute la largeur du caractère suivant.Habituellement utilisé en combinaison avec des parenthèses pour ajouter respectivement les indentations gauche et droite, _( et _).
@Formats pour le texte. Applique le format à tous les textes de la cellule"[Red]@" applique la couleur de police rouge pour les valeurs texte.
*Répéte le caractère suivant pour remplir la largeur de la colonne.0*- inclura suffisamment de tirets après un nombre pour remplir la cellule, tandis que *0 avant tout format inclura les zéros précédents.
" "Affiche le texte entre les guillemets sans l'interpréter."8%" sera affiché comme suit : 8%
%Affiche les nombres en pourcentage de 100.8% sera affiché comme suit : .08
#Caractère de remplacement de chiffres qui n'affiche pas de zéros supplémentaires. Si un nombre a plus de chiffres à droite de la virgule qu'il y a de placeholders, le nombre est arrondi.#.# affichera 1.5 au lieu de 1.54
?Caractère de remplacement de chiffres qui affiche des espaces pour les zéros supplémentaires, mais ne les affiche pas. Généralement utilisé pour aligner les nombres sur le point décimal.$?? affiche un maximum de 2 décimales et les aligne les symboles ollars pour des montants variables.
\Affiche le caractère qui le suit.#.00? affichera 123.00? au lieu de 123
/Lorsqu'il est utilisé avec des nombres, les affiche comme des fractions. Lorsqu'il est utilisé avec des textes, dates ou heures, les affiche "tels quels".#/# affichera 3/4 au lieu de .75
[ ]Crée des formats conditionnels.[>100][GREEN]#,##0;[<=-100][YELLOW]#,##0;[BLUE]#,##0
EFormat de notation scientifique.#E+# - affichera 2E+6 au lieu de 1,500,500
[color]Formate le texte ou le nombre dans la couleur spécifiée[Green]###.##[Red]-###.###

Exemple

//Définir la valeur de la cellule sur $125,571.35
VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_($* #,##0.00_)")

Formats date et heure

4D View Pro fournit les constantes suivantes pour les modèles de date et heure au format ISO 8601 :

ConstanteValeurCommentaire
vk pattern full date time"fullDateTimePattern"Format ISO 8601 pour la date et l'heure complète dans la localisation actuelle. Modèle par défaut des USA : "dddd, dd MMMM yyyy HH:mm:ss"
vk pattern long date"longDatePattern"Format ISO 8601 pour la date complète dans la localisation courante. Modèle par défaut USA : "dddd, dd MMMM yyyy"
vk pattern long time"longTimePattern"Format ISO 8601 pour l'heure dans la localisation courante. Modèle par défaut des USA : "HH:mm:ss"
vk pattern month day"monthDayPattern"Format ISO 8601 pour le mois et le jour dans la localisation courante. Modèle par défaut des USA : "MMMM dd"
vk pattern short date"shortDatePattern"Format ISO 8601 abrégé pour la date dans la localisation courante. Modèle par défaut des USA : "MM/jj/aaaa"
vk pattern short time"shortTimePattern"Format ISO 8601 abrégé pour l'heure dans la localisation actuelle. Modèle par défaut des USA : "HH:mm"
vk pattern sortable date time"sortableDateTimePattern"Format ISO 8601 pour la date et l'heure de la localisation actuelle qui peut être triée. Modèle par défaut des USA : "yyyy'-'MM'-'dd'T'HH':'mm':'ss"
vk pattern universal sortable date time"universalSortableDateTimePattern"Format ISO 8601 pour la date et l'heure de la localisation en cours en utilisant UTC qui peut être trié. Modèle par défaut des USA : "yyyy'-'MM'-'dd HH':'mm':'ss'Z'"
vk pattern year month"yearMonthPattern"Format ISO 8601 pour le mois et l'année dans la localisation courante. Modèle par défaut des USA : "MMMMMM"

Exemple

//Définir la valeur de la cellule sur une date et une heure spécifique
VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time";?14:30:10?;"format";vk pattern full date time))

Formats date et heure personnalisés

Pour créer vos propres modèles de date et d'heure, dans votre localisation actuelle, vous pouvez utiliser les combinaisons des codes suivants :

Code
(non sensible à la casse)
DescriptionExemple
Date(January 1, 2019)
mNuméro du mois sans le premier zéro1
mmNuméro du mois avec le zéro en préfixe01
mmmNom du mois, courtJan
mmmmNom du mois, longJanuary
dNuméro du jour sans le zéro en préfixe1
ddNuméro du jour avec le zéro en préfixe01
dddJour de la semaine, courtTue
ddddJour de la semaine, longTuesday
yyAnnée, format court19
yyyyAnnée, long format2019
Time(2:03:05 PM)
hHeure sans le zéro en préfixe. 0-232
hhHeure avec le zéro en préfixe. 00-2302
mMinutes sans le zéro en préfixe. 0-593
mmMinutes avec le zéro en préfixe. 00-5903
sSecondes sans le zéro en préfixe. 0-595
ssSecondes avec le zéro en préfixe. 00-5905
[h]Temps écoulé en heures14 (peut aller au delà de 24)
[mm]Temps écoulé en minutes843
[ss]Temps écoulé en secondes50585
AM/PMPériodes de la journée. S'il est omis, c'est le format de 24 heures qui est utilisé.PM

Le code 'm' est interprété en fonction de sa position dans le motif. Si c'est immédiatement après 'h' ou 'hh' ou juste avant 's' ou 'ss', il sera interprété comme des minutes, sinon il sera interprété comme des mois.

Symboles supplémentaires

En plus des caractères spéciaux et des codes décrits dans les sections précédentes, des caractères et des symboles supplémentaires peuvent être utilisés dans vos modèles de format. Ces caractères et symboles supplémentaires ne nécessitent pas de \ ou "" et n'affectent pas l'interprétation du modèle de format. Ils apparaissent "tels quels" dans le modèle.

CaractèreDescriptionExemple
+ et -Signes en plus et moins### + ### = ###,###
( )Parenthèse gauche et droite(-###.##)
:Deux-pointshh:mm:ss
^Caret#^#
'Apostrophe'######
{ }Accolades{###,###,###}
< >Inférieur et supérieur à## >##
=Signe égal#+#=##
/Barre oblique. Lorsqu'il est utilisé avec des nombres, les affiche comme des fractions.mm/dd/yyyy
!Point d'exclamation$###.00!
&Esperluette"Hello" & "Welcome"
~Tilde~##
Caractère espace
Euro€###.00
£Livre Sterling£###.00
¥Yen japonais¥###.00
$Symbole Dollar$###.00
¢Symbole Cent.00¢

Attributs d'impression

Les attributs d'impression 4D View Pro vous permettent de contrôler tous les aspects de l'impression des zones 4D View Pro. Ces attributs sont gérés par les commandes suivantes :

Colonnes / Lignes

Les attributs de ligne et de colonne sont utilisés pour identifier le début, la fin et la répétition des lignes et colonnes.

PropriétéTypeDescription
columnEndentier longLa dernière colonne à imprimer dans une plage de cellules. Valeur par défaut = -1 (toutes les colonnes)
columnStartentier longLa première colonne à imprimer dans une plage de cellules. Valeur par défaut = -1 (toutes les colonnes)
repeatColumnEndentier longLa dernière colonne d'une plage de colonnes à imprimer à gauche de chaque page. Valeur par défaut = -1 (toutes les colonnes)
repeatColumnStartentier longLa première colonne d'une plage de colonnes à imprimer à gauche de chaque page. Valeur par défaut = -1 (toutes les colonnes)
repeatRowEndentier longLa dernière ligne d'une plage de lignes à afficher en haut de chaque page. Valeur par défaut = -1 (toutes les lignes)
repeatRowStartentier longLa première ligne d'une plage de lignes à afficher en haut de chaque page. Valeur par défaut = -1 (toutes les lignes)
rowEndentier longLa dernière ligne à imprimer dans une plage de cellules. Valeur par défaut = -1 (toutes les lignes)
rowStartentier longLa première ligne à imprimer dans une plage de cellules. Valeur par défaut = -1 (toutes les lignes)

En-têtes / Pied de page

Les attributs d'en-tête et de pied de page sont utilisés pour spécifier du texte ou des images dans les sections de gauche, de droite et du centre entête/pied de page.

PropriétéTypeDescription
footerCentertextLe texte et le format du pied de page central sur les pages imprimées.
footerCenterImagepicture | text*L'image de la section centrale du pied de page.
footerLefttextLe texte et le format du pied de page gauche sur les pages imprimées.
footerLeftImagepicture | text*L'image de la section gauche du pied de page.
footerRighttextLe texte et le format du pied de page droit sur les pages imprimées.
footerRightImagepicture | text*L'image de la section droite du pied de page.
headerCentertextLe texte et le format de l'en-tête central sur les pages imprimées.
headerCenterImagepicture | text*L'image pour la section centrale de l'en-tête.
headerLefttextLe texte et le format de l'en-tête de gauche sur les pages imprimées.
headerLeftImagepicture | text*L'image de la section gauche de l'en-tête.
headerRighttextLe texte et le format de l'en-tête de droite sur les pages imprimées.
headerRightImagepicture | text*L'image de la section droite de l'en-tête.

* Si vous utilisez un type texte, passez le chemin d'accès (absolu ou relatif) de l'image. Si vous passez un chemin relatif, le fichier doit être situé à côté du fichier de structure de la base de données. Sous Windows, l'extension de fichier doit être indiquée. Peu importe le type utilisé pour définir une image, l'image elle-même (pas une référence) est stockée dans la zone 4D View Pro et est retournée par VP Get print info.

Caractères spéciaux

Les caractères spéciaux suivants permettent l'ajout ou la mise en forme automatique d'informations dans l'en-tête et le pied de page lors de l'impression de la zone 4D View Pro.

CaractèreDescriptionExempleRésultat
&Caractère d'échappement(voir les exemples ci-dessous)
PPage couranteprintInfo.headerLeft:="This is page &P."This is page 5.
NNombre de pagesprintInfo.headerLeft:="There are &N pages."Il y a 10 pages.
DDate courante (format yyyy/mm/jj)printInfo.headerLeft:="It is &D."Nous sommes le 2025/6/19.
THeure couranteprintInfo.headerLeft:="It is &T."Il est 16:30:36.
GImageprintInfo.headerLeftImage:=smiley
printInfo.headerLeft:="&G"
SBarréprintInfo.headerLeft:="&SThis is text."This is text.
USoulignéprintInfo.headerLeft:="&UThis is text."This is text. (Souligné)
BSoulignéprintInfo.headerLeft:="&BThis is text."This is text.
IItaliqueprintInfo.headerLeft:="&IThis is text."This is text.
"Préfixe de policeprintInfo.headerLeft:="&"Lucida Console"&14This is text."
KPréfixe de couleur du texteprintInfo.headerLeft:="&KFF0000This is text."This is text (en rouge).
FNom du classeurprintInfo.headerLeft:="&F"Revenus mensuels 2025
ANom du tableurprintInfo.headerLeft:="&A"Prévision des revenus 2026

Margins

Les attributs de marge sont utilisés pour spécifier les marges de zone 4D View Pro pour l'impression. Exprimé en centièmes de pouce.

PropriétéTypeDescription
marginobjectLes marges d'impression
topentier longMarge supérieure, en centièmes de pouce. Valeur par défaut = 75
bottomentier longMarge inférieure, en centièmes de pouce. Valeur par défaut = 75
leftentier longMarge gauche, en centièmes de pouce. Valeur par défaut = 70
rightentier longMarge droite, en centièmes de pouce. Valeur par défaut = 70
headerentier longDécalage de l'en-tête, en centièmes de pouce. Valeur par défaut = 30
footerentier longDécalage du pied de page, en centièmes de pouce. Valeur par défaut = 30

Orientation

Les attributs d'orientation sont utilisés pour spécifier la direction de la mise en page imprimée.

Cet attribut définit uniquement les informations de rendu.

PropriétéTypeDescription
orientationentier longOrientation de la page. Valeurs disponibles : vk print page orientation landscape, vk print page orientation portrait (par défaut)

Page

Les attributs de page sont utilisés pour spécifier les paramètres généraux d'impression du document.

PropriétéTypeDescription
blackAndWhitebooleanImpression en noir et blanc seulement.

Valeur par défaut = false

Note: Les PDF ne sont pas affectés par cet attribut. Les couleurs en PDF restent.

centeringentier longComment le contenu est centré sur la page imprimée. Valeurs disponibles : vk print centering both, vk print centering horizontal, vk print centering none (par défaut), vk print centering vertical
firstPageNumberentier longLe numéro de page à imprimer sur la première page. Valeur par défaut = 1
pageOrderentier longL'ordre d'impression des pages. Valeurs disponibles : vk print page order auto (par défaut), vk print page order down then over, vk print page order over then down.
pageRangetextLa plage de pages pour l'impression
qualityFactorentier longLe facteur de qualité pour l'impression (1 - 8). Plus le facteur de qualité est élevé, meilleure est la qualité d'impression, cependant les performances d'impression peuvent être affectées.

Valeur par défaut = 2

useMaxbooleanSeules les colonnes et les lignes avec des données sont imprimées.

Valeur par défaut = true

zoomFactorréelLe montant de l'agrandissement ou de la réduction de la page imprimée.

Valeur par défaut = 1

Taille du papier

Les attributs de taille de papier sont utilisés pour spécifier les dimensions ou le modèle de papier à utiliser pour l'impression. Il y a deux façons de définir la taille du papier :

  • Taille personnalisée - attributs height et width
  • Taille standard - attribut kind
PropriétéTypeDescription
paperSizeobjectDimensions papier (height, width) ou format spécifique (kind) pour impression.
heightentier longHauteur du papier, en centièmes de pouce.
widthentier longLargeur du papier, en centièmes de pouce.
kindtextNom du format de papier standard (par exemple, A2, A4, legal, etc.) retourné par Get Print Option. Valeur par défaut = "letter"
  • Si le format du papier est spécifié en utilisant les propriétés height et width, VP Get print info retourne un format de papier avec custom comme valeur pour kind.

  • Si vous définissez le format du papier à l'aide de la propriété kind, vous pouvez utiliser l'une ou l'autre :

  • un des formats dans la liste des formats SpreadJS

  • un des formats retournés par la commande PRINT OPTION VALUES. Dans ce cas, VP Get print info retourne le format correspondant avec la hauteur et la largeur.

Graduation

Les attributs d'échelle sont utilisés pour spécifier l'optimisation d'impression et les ajustements.

PropriétéTypeDescription
bestFitColumnsbooleanLa largeur des colonnes est ajustée pour correspondre à la plus grande largeur de texte pour l'impression. Valeur par défaut = "false"
bestFitRowsbooleanLa hauteur de la ligne est ajustée pour s'adapter à la hauteur de texte la plus haute pour l'impression. Valeur par défaut = "false"
fitPagesTallentier longLe nombre de pages verticales (orientation portrait) à vérifier lors de l'optimisation de l'impression. Valeur par défaut = -1
fitPagesWideentier longLe nombre de pages horizontales (orientation paysage) à vérifier lors de l'optimisation de l'impression. Valeur par défaut = -1

Montrer / Cacher

Les attributs Montrer/Cacher sont utilisés pour spécifier la visibilité (impression) des éléments de la zone 4D View Pro.

PropriétéTypeDescription
showBorderbooleanAffiche la bordure du contour. Valeur par défaut = "true"
showColumnHeaderentier longParamètres d'impression des en-têtes des colonnes. Valeurs disponibles : vk print visibility hide, vk print visibility inherit (par défaut), vk print visibility show, vk print visibility show once
showGridLinebooleanAffiche les lignes de grille. Valeur par défaut = "false"
showRowHeaderentier longParamètres d'impression des en-têtes des lignes. Valeurs disponibles : vk print visibility hide, vk print visibility inherit (par défaut), vk print visibility show, vk print visibility show once

Watermark

Les attributs du filigrane sont utilisés pour superposer du texte ou une image dans la zone 4D View Pro.

PropriétéTypeDescription
watermarkcollectionCollection des paramètres du filigrane. Valeur par défaut: non définie
[ ].heightentier longLa hauteur du texte / image du filigrane.
[ ].imageSrcpicture | text*Le texte / image du filigrane.
[ ].pagetextLa ou les pages où le filigrane est imprimé. Pour toutes les pages : "all". Pour des pages spécifiques : numéros de page ou plages de pages séparées par des virgules. Ex.: "1,3,5-12"
[ ].widthentier longLa largeur du texte / image du filigrane.
[ ].xentier longLa position horizontale du point supérieur gauche du texte / image du filigrane.
[ ].yentier longLa position verticale du point supérieur gauche du texte / image du filigrane.

* Si vous utilisez un type texte, passez le chemin d'accès (absolu ou relatif) de l'image. Si vous passez un chemin relatif, le fichier doit être situé à côté du fichier de structure de la base de données. Sous Windows, l'extension de fichier doit être indiquée. Peu importe le type utilisé pour définir une image, l'image elle-même (pas une référence) est stockée dans la zone 4D View Pro et est retournée par VP Get print info.

Objets de style

Les objets et les feuilles de style 4D View Pro vous permettent de contrôler les aspects graphiques et l'apparence de vos documents 4D View Pro.

Objets de style et feuilles de style

Les objets de style contiennent les paramètres de style. Ils peuvent être utilisés dans une feuille de style ou par eux-mêmes. Les objets de style peuvent également être utilisés en plus d'une feuille de style afin que différents paramètres puissent être spécifiés pour chaque plage de cellules sans affecter le reste du document. Vous pouvez utiliser les objets de style directement avec les commandes VP SET CELL STYLE et VP SET DEFAULT STYLE. Vous pouvez également utiliser des objets de style lors de la définition de thèmes de tableau personnalisés à l'aide des commandes VP SET TABLE THEME ou VP CREATE TABLE.

Une feuille de style regroupe une combinaison de propriétés dans un objet de style pour spécifier l'apparence de toutes les cellules de vos documents 4D View Pro. Les feuilles de style enregistrées avec le document peuvent être utilisées pour définir les propriétés d'une seule feuille, de plusieurs feuilles ou d'un classeur entier. Une fois créée, une feuille de style 4D View Pro reçoit un nom qui est sauvegardé dans la feuille de style dans la propriété "name". Cela permet d'utiliser facilement une feuille de style et, si elle est soigneusement sélectionnée, peut faciliter son identification et son but (par exemple, Letterhead_internal, Letterhead_external).

Les feuilles de style sont créées avec la commande VP ADD STYLESHEET et appliquées avec les commandes VP SET DEFAULT STYLE ou VP SET CELL STYLE. Vous pouvez supprimer une feuille de style avec la commande VP REMOVE STYLESHEET.

La commande VP Get stylesheet peut être utilisée pour retourner l'objet style d'une feuille de style unique ou vous pouvez utiliser la commande VP Get stylesheets pour récupérer une collection d'objets style pour plusieurs feuilles de style.

Propriétés d'objet de style

Voici un exemple :

 $style:=New object
$style.hAlign:=vk horizontal align left
$style.font:="12pt papyrus"
$style.backColor:="#E6E6FA" //couleur violet clair

VP SET DEFAULT STYLE("myDoc";$style)

Arrière-plan & Premier plan

PropriétéTypeDescriptionValeurs possibles
backColortextDéfinit la couleur de l'arrière-plan.Couleur CSS syntaxe "#rrggbb" (syntaxe préférée), couleur CSS syntaxe "rgb(r,g,b)" (syntaxe alternative), nom de couleur CSS (syntaxe alternative)
backgroundImagepicture, textSpécifie une image de fond.Peut être spécifié directement ou via le chemin de l'image (chemin complet ou nom de fichier uniquement). Si seul le nom de fichier est utilisé, le fichier doit être situé à côté du fichier de structure de la base de données. Quelle que soit la configuration (image ou texte), une image est enregistrée avec le document. This could impact the size of a document if the image is large. Note for Windows: File extension must be included.
backgroundImageLayoutentier longDefines the layout for the background image.vk image layout center, vk image layout none, vk image layout stretch, vk image layout zoom
foreColortextDefines the color of the foreground.Couleur CSS syntaxe "#rrggbb" (syntaxe préférée), couleur CSS syntaxe "rgb(r,g,b)" (syntaxe alternative), nom de couleur CSS (syntaxe alternative)

Bordures

PropriétéTypeDescriptionValeurs possibles
borderBottom, borderLeft, borderRight, borderTop, diagonalDown, diagonalUpobjectDefines the corresponding border line
colortextDefines the color of the border. Par défaut = black.Couleur CSS syntaxe "#rrggbb" (syntaxe préférée), couleur CSS syntaxe "rgb(r,g,b)" (syntaxe alternative), nom de couleur CSS (syntaxe alternative)
styleentier longDefines the style of the border. Par défaut = vide. Cannot be null or undefined.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

Polices et texte

PropriétéTypeDescriptionValeurs possibles
fonttextSpecifies the font characteristics in CSS font shorthand ("font-style font-variant font-weight font-size/line-height font-family"). Example: "14pt Century Gothic". The font-size and font-family values are mandatory. If one of the other values is missing, their default values are used. Note: If a font name contains a space, the name must be within quotes.A CSS font shorthand. 4D fournit des commandes utilitaires pour gérer les caractéristiques des polices en tant qu'objets : VP Font to object et VP Object to font
formattertextModèle pour la propriété value/time.Number/text/date/time formats, special characters. Voir Format des cellules.
isVerticalTextbooleanSpecifies text direction.True = vertical text, False = horizontal text.
labelOptionsobjectDefines cell label options (watermark options).
alignmententier longSpecifies the position of the cell label. Optional property.vk label alignment top left, vk label alignment bottom left, vk label alignment top center, vk label alignment bottom center, vk label alignment top right, vk label alignment bottom right
visibilityentier longSpecifies the visibility of the cell label. Optional property.vk label visibility auto, vk label visibility hidden, vk label visibility visible
foreColortextDefines the color of the foreground. Optional property.Couleur CSS syntaxe "#rrggbb" (syntaxe préférée), couleur CSS syntaxe "rgb(r,g,b)" (syntaxe alternative), nom de couleur CSS (syntaxe alternative)
fonttextSpecifies the font characteristics with CSS font shorthand ("font-style font-variant font-weight font-size/line-height font-family"). The font-size and font-family values are mandatory.
textDecorationentier longSpecifies the decoration added to text.vk text decoration double underline, vk text decoration line through, vk text decoration none, vk text decoration overline, vk text decoration underline
textIndententier longDefines the unit of text indention. 1 = 8 pixels
textOrientationentier longDefines the rotation angle of the text in a cell. Number between -90 and 90
watermarktextDefines the watermark (cell label) content
wordWrapbooleanSpecifies if text should be wrapped.True = wrapped text, False = unwrapped text

Affichage

PropriétéTypeDescriptionValeurs possibles
cellPaddingtextDefines the cell padding
hAlignentier longDefines the horizontal alignment of cell contents.vk horizontal align center, vk horizontal align general, vk horizontal align left, vk horizontal align right
lockedbooleanSpecifies cell protection status. Notez que ce n'est disponible que si [protection de la feuille](#protection de la feuille) est activée.True = locked, False = unlocked.
shrinkToFitbooleanSpecifies if the contents of the cell should be reduced.True = reduced content, False = no reduction.
tabStopbooleanSpecifies if the focus to the cell can be set using the Tab key.True = Tab key sets focus, False = Tab key does not set focus.
vAlignentier longSpecifies the vertical alignment of cell contents.vk vertical align bottom, vk vertical align center, vk vertical align top

Style information

PropriétéTypeDescription
nametextDefines the name of the style
parentNametextSpecifies the style that the current style is based on. Values from the parent style will be applied, then any values from the current style are applied. Changes made in the current style will not be refelected in the parent style. Only available when using a style sheet.

Objet 4D View Pro

Le 4D View Pro object stocke l'ensemble du contenu du tableau. It is automatically handled by 4D View Pro. Vous pouvez configurer ou obtenir cet objet en utilisant les commandes VP IMPORT FROM OBJECT ou VP Export to object.

Il contient les propriétés suivantes :

PropriétéValue typeDescription
versionIntegerInternal component version
dateCreationTimestampCreation date
dateModifiedTimestampLast modification date
metaObjectFree contents, reserved for the 4D developer
spreadJSObjectReserved for the 4D View Pro component

4D View Pro Form Object Variable

La variable d'objet du formulaire 4D View Pro est la variable object associée à la zone de formulaire 4D View Pro. It manages information used by the 4D View Pro object.

The 4D View Pro form object variable is for information purposes only (i.e., debugging). Under no circumstances should it be modified.

Il contient les propriétés suivantes :

PropriétéValue typeDescription
ViewPro.areaTextNom de la zone 4D View Pro
ViewPro.callbacksObjectStores temporary information necessary for commands requiring callbacks such as importing and exporting.
ViewPro.commandBuffersCollectionStocke séquentiellement les commandes appelées par la méthode et les exécute en lot (plutôt que individuellement) lors de la sortie de la méthode, lorsque une commande renvoie une valeur, ou lorsque la commande VP FLUSH COMMANDS est appelée. This mechanism increases performance by reducing the number of requests sent.
ViewPro.eventsObjectListe des événements.
ViewPro.formulaBarBooleanIndicates whether or not the formula bar is displayed. Available only for the "toolbar" interface.
ViewPro.initedBooleanIndique si la zone 4D View Pro a été initialisée ou non (voir l'événement On VP Ready).
ViewPro.interfaceTextSpecifies the type of user interface:"ribbon", "toolbar", "none".