Objets style et feuilles de style 4D View Pro

4D v19

Aperçu

Les objets style et les feuilles de style 4D View Pro vous permettent de gérer les éléments graphiques et visuels de vos documents 4D View Pro.

Les objets style contiennent les paramètres de style. Ils peuvent être utilisés en tant que tels ou bien dans une feuille de style. Les objets style peuvent aussi être utilisés en complément d'une feuille de style, pour que différents paramètres soient renseignés pour les plages de cellules individuelles, sans modifier le reste du document.

Vous pouvez utiliser des objets style directement à l'aide des commandes VP SET CELL STYLE et VP SET DEFAULT STYLE.

Feuilles de style

Une feuille de style regroupe des propriétés dans un objet style (voir ci-dessous) pour définir l'aspect visuel de toutes les cellules de vos documents 4D View Pro. Les feuilles de style sauvegardées avec le document peuvent être utilisées pour définir les propriétés d'une ou plusieurs feuilles, ou d'un workbook (classeur) entier.

Une fois la feuille de style 4D View Pro créée, le nom qui lui est attribué est sauvegardé dans la propriété "name". Cela permet de faciliter l'utilisation de la feuille de style et, le cas échéant, de son identification et de son but (ex : Letterhead_internal, Letterhead_external).

Les feuilles de style sont créées à l'aide de la commande VP ADD STYLESHEET et sont appliquées via les commandes VP SET CELL STYLE. Vous pouvez supprimer une feuille de style à l'aide de la commande VP REMOVE STYLESHEET.

Vous pouvez utiliser la commande VP Get stylesheet pour retourner l'objet style d'une feuille de style ou la commande VP Get stylesheets pour récupérer une collection d'objets de style de plusieurs feuilles de style.

Propriétés des styles

Vous trouverez la description détaillée des valeurs ci-dessous dans la page Constantes 4D View Pro.

Fond & Avant-plan

Propriété	Type	Description	Valeurs possibles
backColor	texte	Définit la couleur de fond.	Syntaxe couleur CSS "#rrggbb" (syntaxe préférentielle), syntaxe couleur CSS "rgb(r,g,b)" (syntaxe alternative), nom de la couleur CSS (syntaxe alternative).
backgroundImage	image, texte	Spécifie une image de fond.	Peut être spécifiée directement ou via le chemin image (chemin complet ou nom du fichier uniquement). Si seul le nom du fichier est utilisé, le fichier doit être placé près du fichier de structure de la base de données. Quel que soit son type (image ou texte), une image est sauvegardée avec le document. Cela peut avoir une incidence sur la taille d'un document si l'image est grande. A noter que pour Windows, l'extension de fichier doit être inclue.
backgroundImageLayout	entier long	Définit la disposition de l'image de fond.	vk image layout center, vk image layout none, vk image layout stretch, vk image layout zoom
foreColor	texte	Définit la couleur de fond.	Syntaxe couleur CSS "#rrggbb" (syntaxe préférentielle), syntaxe couleur CSS "rgb(r,g,b)" (syntaxe alternative), nom de la couleur CSS (syntaxe alternative)

Bordures

Propriété	Sous-propriété	Type	Description	Valeurs possibles
borderBottom, borderLeft, borderRight, borderTop, diagonalDown,diagonalUp		objet	Définit la bordure correspondante
	color	texte	Définit la couleur de la bordure. Par défaut = noir. Ne peut pas être nulle ou indéfinie.	Syntaxe couleur CSS "#rrggbb" (syntaxe préférentielle), syntaxe couleur CSS "rgb(r,g,b)" (syntaxe alternative), nom de la couleur CSS (syntaxe alternative)
	style	entier long	Définit le style de la bordure. Par défaut = vide. Ne peut pas être nulle ou indéfinie.	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 thick

Polices et texte

Propriété	Sous-propriété	Type	Description	Valeurs possibles
font		texte	Définit les caractéristiques de la police en CSS abrégé ("font-style font-variant font-weight font-size/line-height font-family"). Exemple: "14pt Century Gothic". Les valeurs font-size et font-family sont obligatoires. Si l'une des autres valeurs est manquante, leur valeur par défaut est utilisée. A noter : Si un nom de police contient un espace, le nom doit être inséré entre guillemets.	Une police CSS abrégée. 4D propose des commandes utiles pour gérer les caractéristiques de police en tant qu'objets : VP Font to object et VP Object to font
formatter		texte	Modèle pour la propriété value/time.	Formats numérique/texte/date/heure, caractères spéciaux. Voir la section Format de cellule 4D View Pro.
isVerticalText		booléen	Indique l'orientation du texte.	Vrai = Texte vertical, Faux = texte horizontal.
labelOptions		objet	Définit les options du libellé de cellule (options du "watermark").
	alignment	entier long	Indique la position du libellé de cellule. Propriété optionnelle.	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
	visibility	entier long	Indique la visibilité de l'étiquette de cellule. Propriété optionnelle.	vk label visibility auto, vk label visibility hidden, vk label visibility visible
	foreColor	texte	Définit la couleur d'avant-plan. Propriété optionnelle.	Syntaxe couleur CSS "#rrggbb" (syntaxe préférentielle), syntaxe couleur CSS "rgb(r,g,b)" (syntaxe alternative), couleur nom CSS (syntaxe alternative)
	font	texte	Indique les caractéristiques de police avec CSS abrégé ("font-style font-variant font-weight font-size/line-height font-family"). Les valeurs font-size et font-family sont obligatoires.
textDecoration		entier long	Indique les caractéristiques décoratives appliquées au texte.	vk text decoration double underline, vk text decoration line through, vk text decoration none, vk text decoration overline, vk text decoration underline
textIndent		entier long	Définit l'unité d'indentation du texte. 1 = 8 pixels
textOrientation		entier long	Définit l'angle de rotation du texte dans une cellule.	Nombre compris entre -90 et 90
watermark		texte	Définit le contenu du watermark (libellé de la cellule)
wordWrap		booléen	Indique si le retour à la ligne automatique doit être activé.	Vrai = activé, Faux = non activé

Configuration

Propriété	Type	Description	Valeurs possibles
cellPadding	texte	Définit le padding de la cellule
hAlign	entier long	Définit l'alignement horizontal du contenu des cellules.	vk horizontal align center, vk horizontal align general, vk horizontal align left, vk horizontal align right
locked	booléen	Définit le statut de protection de la cellule. A noter que ceci est valable uniquement si la protection de la feuille est autorisée (voir la section Protection de la feuille).	Vrai = verrouillé, Faux = déverrouillé.
shrinkToFit	booléen	Indique si le contenu de la cellule doit être réduit.	Vrai = contenu réduit, Faux = aucune réduction.
tabStop	booléen	Indique si le focus de la cellule peut être paramétré à l'aide de la touche Tab.	Vrai = la touche Tab établit le focus, Faux = la touche Tab n'établit pas de focus.
vAlign	entier long	Définit l'alignement vertical du contenu des cellules.	vk vertical align bottom, vk vertical align center, vk vertical align top

Informations sur les styles

Propriété	Type	Description
name	texte	Définit le nom du style
parentName	texte	Indique le style sur lequel est basé le style courant. Les valeurs du style parent seront appliquées, suivies de toutes les valeurs du style courant. Les modifications apportées dans le style courant ne se reflèteront pas dans le style parent. Disponible uniquement en cas d'utilisation d'une style sheet.

Voir aussi

VP ADD STYLESHEET
VP Font to object
VP Get stylesheet
VP Object to font