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
etwithFormulaBar
(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 :
Onglet | Actions | Interface Ruban | Interface Barre d'outils |
---|---|---|---|
File | Gestion de fichiers | X | |
Accueil | Apparence du texte | X | X |
Insérer | Ajouter des éléments | X | X |
Formules | Calculs de formules et bibliothèque | X | X |
Data | Gestion des données | X | X |
Affichage | Présentation visuelle | X | X |
Propriétés | Présentation de la feuille | X |
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 événements formulaire standard fournissent des informations étendues dans l'objet retourné par la commande FORM Event
lorsqu'ils sont générés pour les zones 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 Load | On VP Ready |
On Getting Focus | On Clicked |
On Losing Focus | On Double Clicked |
On Unload | On 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é | Type | Description | |
---|---|---|---|
allowCellOverflow | boolean | Indique si les données peuvent déborder sur des cellules vides adjacentes. | |
sheetTabColor | string | Une 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. | |
frozenlineColor | string | Une 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. | |
clipBoardOptions | entier long | L'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 | |
gridline | object | Les options du quadrillage. | |
color | string | Une chaîne couleur utilisée pour représenter la couleur du quadrillage, telle que "red", "#FFFF00", "rgb(255,0,0)", "Accent 5", etc. | |
showVerticalGridline | boolean | Indique s'il affiche le quadrillage vertical. | |
showHorizontalGridline | boolean | Indique s'il affiche le quadrillage horizontal. | |
rowHeaderVisible | boolean | Indique si l'en-tête de la ligne est visible. | |
colHeaderVisible | boolean | Indique si l'en-tête de la colonne est visible. | |
rowHeaderAutoText | entier long | Indique 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 | |
colHeaderAutoText | entier long | Indique 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 | |
selectionBackColor | string | La couleur d'arrière-plan de la sélection dans la feuille (de préférence au format Rgba). | |
selectionBorderColor | string | La couleur de bordure de la sélection dans la feuille. | |
sheetAreaOffset | object | Les options de sheetAreaOffset. | |
left | entier long | Le décalage gauche de la feuille à partir de l'hôte. | |
top | entier long | Le 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é | Type | Description | |
---|---|---|---|
isProtected | boolean | Indique si les cellules protégées de cette feuille peuvent être modifiées ou non. | |
protectionOptions | object | Une valeur qui indique les éléments que les utilisateurs peuvent modifier. Si null : le paramètre protectionOptions est réinitialisé. | |
allowSelectLockedCells | boolean | Indique si l'utilisateur peut sélectionner des cellules verrouillées, optionnel. Vrai par défaut. | |
allowSelectUnlockedCells | boolean | Indique si l'utilisateur peut sélectionner des cellules non verrouillées, optionnel. Vrai par défaut. | |
allowSort | boolean | Indique si l'utilisateur peut trier des plages, optionnel. Faux par défaut. | |
allowFilter | boolean | Indique si l'utilisateur peut filtrer des plages, optionnel. Faux par défaut. | |
allowEditObjects | boolean | Indique si l'utilisateur peut modifier des objets flottants, optionnel. Faux par défaut. | |
allowResizeRows | boolean | Indique si l'utilisateur peut redimensionner des lignes, optionnel. Faux par défaut. | |
allowResizeColumns | boolean | Indique si l'utilisateur peut redimensionner des colonnes, optionnel. Faux par défaut. | |
boolean | boolean | Indique si l'utilisateur peut effectuer des opérations de glissement pour insérer des lignes, optionnel. Faux par défaut. | |
allowDragInsertColumns | boolean | Indique si l'utilisateur peut effectuer des opérations de glissement pour insérer des colonnes, optionnel. Faux par défaut. | |
allowInsertRows | boolean | Indique si l'utilisateur peut insérer des lignes, optionnel. Faux par défaut. | |
allowInsertColumns | boolean | Indique si l'utilisateur peut insérer des colonnes, optionnel. Faux par défaut. | |
allowDeleteRows | boolean | Indique si l'utilisateur peut supprimer des lignes, optionnel. Faux par défaut. | |
allowDeleteColumns | boolean | Indique 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ère | Description | Exemple |
---|---|---|
0 | Placeholder that displays zeros. | #.00 affichera 1.10 au lieu de 1.1 |
. | Displays a decimal point | 0.00 affichera 1999.00 au lieu de 1999 |
, | Displays the thousands separator in a number. Thousands are separated by commas if the format contains a comma enclosed by number signs "#" or by zeros. A comma following a digit placeholder scales the number by 1,000. | #,0 affichera 12200000 au lieu de 12,200,000 |
_ | Skips the width of the next character. | Usually used in combination with parentheses to add left and right indents, _( and _) respectively. |
@ | Formatter for text. Applies the format to all text in the cell | "[Red]@" applies the red font color for text values. |
- | Repeats the next character to fill the column width. | 0*- will include enough dashes after a number to fill the cell, whereas *0 before any format will include leading zeros. |
" " | Displays the text within the quotes without interpreting it. | "8%" sera affiché comme suit : 8% |
% | Displays numbers as a percentage of 100. | 8% sera affiché comme suit : .08 |
# | Digit placeholder that does not display extra zeros. If a number has more digits to the right of the decimal than there are placeholders, the number is rounded up. | #.# affichera 1.5 au lieu de 1.54 |
? | Digit placeholder that leaves space for extra zeros, but does not display them. Typically used to align numbers by decimal point. | $?? displays a maximum of 2 decimals and causes dollar signs to line up for varying amounts. |
\ | Displays the character following it. | #.00? affichera 123.00? au lieu de 123 |
/ | When used with numbers, displays them as fractions. When used with text, date or time codes, displayed "as-is". | #/# affichera 3/4 au lieu de .75 |
[ ] | Creates conditional formats. | [>100][GREEN]#,##0;[<=-100 ][YELLOW]#,##0;[BLUE]#,##0 |
E | Scientific notation format. | #E+# - affichera 2E+6 au lieu de 1,500,500 |
[color] | Formats the text or number in the color specified | [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 :
Constante | Valeur | Commentaire |
---|---|---|
vk pattern full date time | "fullDateTimePattern" | ISO 8601 format for the full date and time in current localization.USA default pattern: "dddd, dd MMMM yyyy HH:mm:ss" |
vk pattern long date | "longDatePattern" | ISO 8601 format for the full date in current localization.USA default pattern: "dddd, dd MMMM yyyy" |
vk pattern long time | "longTimePattern" | ISO 8601 format for the time in current localization.USA default pattern: "HH:mm:ss" |
vk pattern month day | "monthDayPattern" | ISO 8601 format for the month and day in current localization.USA default pattern: "MMMM dd" |
vk pattern short date | "shortDatePattern" | Abbreviated ISO 8601 format for the date in current localization.USA default pattern: "MM/dd/yyyy" |
vk pattern short time | "shortTimePattern" | Abbreviated ISO 8601 format for the time in current localization.USA default pattern: "HH:mm" |
vk pattern sortable date time | "sortableDateTimePattern" | ISO 8601 format for the date and time in current localization which can be sorted.USA default pattern: "yyyy'-'MM'-'dd'T'HH':'mm':'ss" |
vk pattern universal sortable date time | "universalSortableDateTimePattern" | ISO 8601 format for the date and time in current localization using UTC which can be sorted.USA default pattern: "yyyy'-'MM'-'dd HH':'mm':'ss'Z'" |
vk pattern year month | "yearMonthPattern" | ISO 8601 format for the month and year in current localization.USA default pattern: "yyyy MMMM" |
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
To create your own date and time patterns, in your current localization, you can use combinations of the following codes:
Code (non sensible à la casse) | Description | Exemple | |
---|---|---|---|
Date | (January 1, 2019) | ||
m | Numéro du mois sans le premier zéro | 1 | |
mm | Numéro du mois avec le zéro en préfixe | 01 | |
mmm | Nom du mois, court | Jan | |
mmmm | Nom du mois, long | January | |
d | Numéro du jour sans le zéro en préfixe | 1 | |
dd | Numéro du jour avec le zéro en préfixe | 01 | |
ddd | Jour de la semaine, court | Tue | |
dddd | Jour de la semaine, long | Tuesday | |
yy | Année, format court | 19 | |
yyyy | Année, long format | 2019 | |
Time | (2:03:05 PM) | ||
h | Heure sans le zéro en préfixe. 0-23 | 2 | |
hh | Heure avec le zéro en préfixe. 00-23 | 02 | |
m | Minutes sans le zéro en préfixe. 0-59 | 3 | |
mm | Minutes avec le zéro en préfixe. 00-59 | 03 | |
s | Secondes sans le zéro en préfixe. 0-59 | 5 | |
ss | Secondes avec le zéro en préfixe. 00-59 | 05 | |
[h] | Temps écoulé en heures | 14 (peut aller au delà de 24) | |
[mm] | Temps écoulé en minutes | 843 | |
[ss] | Temps écoulé en secondes | 50585 | |
AM/PM | Périodes de la journée. S'il est omis, c'est le fomat de 24 heures qui est utilisé. | PM |
The code 'm' is interpreted depending on its position in the pattern. If it's immediately after 'h' or 'hh' or immediately before 's' or 'ss', it will be interpreted as minutes, otherwise it will be interpreted as months.
Symboles supplémentaires
In addition to the special characters and codes described in the previous sections, there are additional characters and symbols that can be used in your format patterns. These additional characters and symbols do not require a \ or "" and do not impact the interpretation of the format pattern. They appear "as-is" within the pattern.
Caractère | Description | Exemple |
---|---|---|
- et - | Plus and minus signs | ### + ### = ###,### |
( ) | Left and right parenthesis | (-###.##) |
: | Colon | hh:mm:ss |
^ | Caret | #^# |
' | Apostrophe | '###### |
{ } | Curly brackets | {###,###,###} |
< > | Less-than and greater than signs | ## >## |
= | Equal sign | #+#=## |
/ | Forward slash. When used with numbers, displays them as fractions. | mm/dd/yyyy |
! | Exclamation point | $###.00! |
& | Ampersand | "Hello" & "Welcome" |
~ | Tilde | ~## |
Space character | ||
€ | Euro | €###.00 |
£ | British Pound | £###.00 |
¥ | Japanese Yen | ¥###.00 |
$ | Dollar sign | $###.00 |
¢ | Cent sign | .00¢ |
Attributs d'impression
4D View Pro print attributes allow you to control all aspects of printing 4D View Pro areas. These attributes are handled by the following commands:
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é | Type | Description |
---|---|---|
columnEnd | entier long | The last column to print in a cell range. Default value = -1 (all columns) |
columnStart | entier long | The first column to print in a cell range. Default value = -1 (all columns) |
repeatColumnEnd | entier long | The last column of a range of columns to print on the left of each page. Default value = -1 (all columns) |
repeatColumnStart | entier long | The first column of a range of columns to print on the left of each page. Default value = -1 (all columns) |
repeatRowEnd | entier long | The last row of a range of rows to print on the top of each page. Default value = -1 (all rows) |
repeatRowStart | entier long | The first row of a range of rows to print at the top of each page. Default value = -1 (all rows) |
rowEnd | entier long | The last row to print in a cell range. Default value = -1 (all rows) |
rowStart | entier long | The first row to print in a cell range. Default value = -1 (all rows) |
Headers / Footers
Header and footer attributes are used to specify text or images in the left, right, and center header/footer sections.
Propriété | Type | Description |
---|---|---|
footerCenter | text | The text and format of the center footer on printed pages. |
footerCenterImage | picture | text* | The image for the center section of the footer. |
footerLeft | text | The text and format of the left footer on printed pages. |
footerLeftImage | picture | text* | The image for the left section of the footer. |
footerRight | text | The text and format of the right footer on printed pages. |
footerRightImage | picture | text* | The image for the right section of the footer. |
headerCenter | text | The text and format of the center header on printed pages. |
headerCenterImage | picture | text* | The image for the center section of the header. |
headerLeft | text | The text and format of the left header on printed pages. |
headerLeftImage | picture | text* | The image for the left section of the header. |
headerRight | text | The text and format of the right header on printed pages. |
headerRightImage | picture | text* | The image for the right section of the header. |
* If using text type, pass the filepath (absolute or relative) of the image. If you pass a relative path, the file should be located next to the database structure file. In Windows, the file extension must be indicated. 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
The following special characters allow the automatic addition or formatting of information in the header and footer when the 4D View Pro area is printed.
Caractère | Description | Exemple | Résultat | |
---|---|---|---|---|
& | Escape character | (see examples below) | ||
P | Current page | printInfo.headerLeft:="This is page &P." | This is page 5. | |
N | Page count | printInfo.headerLeft:="There are &N pages." | There are 10 pages. | |
D | Current date (yyyy/mm/dd format) | printInfo.headerLeft:="It is &D." | It is 2015/6/19. | |
T | Current time | printInfo.headerLeft:="It is &T." | It is 16:30:36. | |
G | Image | printInfo.headerLeftImage:=smiley printInfo.headerLeft:="&G" | ||
S | Strikethrough | printInfo.headerLeft:="&SThis is text." | ||
U | Souligné | printInfo.headerLeft:="&UThis is text." | This is text. (Underlined) | |
B | Souligné | printInfo.headerLeft:="&BThis is text." | This is text. | |
I | Italique | printInfo.headerLeft:="&IThis is text." | This is text. | |
" | Font prefix | printInfo.headerLeft:="&"Lucida Console"&14This is text." | ||
K | Text Color prefix | printInfo.headerLeft:="&KFF0000This is text." | This is text (in red). | |
F | Workbook name | printInfo.headerLeft:="&F" | 2019 Monthly Revenue Forecasts | |
A | Spreadsheet name | printInfo.headerLeft:="&A" | June 2019 revenue forecast |
Margins
Margin attributes are used to specify the 4D View Pro area margins for printing. Expressed in hundreds of an inch.
Propriété | Type | Description | |
---|---|---|---|
margin | object | The print margins | |
top | entier long | Top margin, in hundredths of an inch. Default value = 75 | |
bottom | entier long | Bottom margin, in hundredths of an inch. Default value = 75 | |
left | entier long | Left margin, in hundredths of an inch. Default value = 70 | |
right | entier long | Right margin, in hundredths of an inch. Default value = 70 | |
header | entier long | Header offset, in hundredths of an inch. Default value = 30 | |
footer | entier long | Footer offset, in hundredths of an inch. Default value = 30 |