Application d'un style personnalisé à un graphique

Définition de la hauteur et de la largeur du graphique

Comment :

La valeur de 760 pixels est automatiquement attribuée à la largeur (ou axe horizontal) de chaque graphe, qui comprends tout le texte. Lors de la définition de la valeur de la largeur du graphe, vous devez permettre l'inclusion du texte requis pour les axes verticaux et leurs étiquettes le long de la marge de gauche.

Pour agrandir l'espace d'affichage, vous pouvez limiter la taille des étiquettes en utilisant soit des phrases AS soit des expressions DECODE.

La valeur de 405 pixels est automatiquement attribuée à la hauteur (ou axe vertical) de votre graphe.

L'axe vertical est automatiquement définie (VAUTO=ON) pour couvrir l'ensemble des valeurs représentées. La valeur la plus haute possible est donnée à la hauteur de l'axe (en prennant en compte la présence d'en-têtes ou de pieds de pages et le besoin de rendre compte de marqueurs de classe verticale arrondis de façon adaptée. L'ensemble est divisé en intervalles appelés “classes.” L'échelle est normalisée pour fournir des valeurs de classe arrondies aux multiples et à la puissance 10 adaptés pour les intervalles représentés sur l'axe.

Haut de page

Syntaxe : Définir la largeur d'un graphique

SET HAXIS={nn|760}

où :

{nn|760}

Est une valeur numérique positive. La valeur par défaut est 760 pixels.

Remarque : la taille maximale de HAXIS pour les graphiques SVG est de 40 pouces.

Haut de page

Syntaxe : Définir la hauteur d'un graphique

SET VAXIS={nn|400}

où :

{nn|400}

Est une valeur numérique positive. La valeur par défaut est 400 pixels.

Remarque : la taille maximale de VAXIS pour les graphiques SVG est de 40 pouces.

Personnalisation de graphiques à l'aide de paramètres SET

Comment :

Utiliser des paramètres SET avec des requêtes GRAPH

Référence :

Valeurs et fonctionnalités des paramètres SET pour les graphiques

L'environnement GRAPH comprend un jeu de paramètres qui contrôlent l'apparence du graphique et vous donne plus de contrôle lorsque vous exécutez la requête.

Par exemple, le paramètre BSTACK vous permet pour spécifier que les barres dans un graphique à barres soient empilées et non pas positionnées côte à côte.

Haut de page

Syntaxe : Utiliser des paramètres SET avec des requêtes GRAPH

Pour définir les paramètres qui contrôlent l'environnement du graphique, utilisez la version du paramètre SET appropriée.

SET parameter=value,parameter=value...

Pour obtenir une liste des paramètres GRAPH, consultez Valeurs et fonctionnalités des paramètres SET pour les graphiques.

Remarque :

Ressaisissez la commande SET sur chaque nouvelle ligne.
Si vous saisissez plusieurs paramètres sur une ligne, séparez-les par des virgules.
Vous pouvez utiliser des troncatures uniques des noms de paramètre. Assurez-vous que les noms de paramètre sont uniques.

Haut de page

Exemple : Utilisation de paramètres SET avec des requêtes GRAPH

L'exemple suivant illustre comment définir la hauteur (l'axe Y) et la largeur (l'axe X) d'un graphique.

SET HAXIS=75,VAXIS=40
GRAPH FILE filename 
.
.
.
END

Haut de page

Référence : Valeurs et fonctionnalités des paramètres SET pour les graphiques

Paramètre SET des graphiques	Valeurs	Fonctionnalité du paramètre
3D	ON\|OFF	Lorsqu'il est activé (ON), un graphique tridimensionnel est généré. Lorsqu'il est désactivé (OFF), un graphique bi-dimensionnel est généré. ON est la valeur par défaut.
AUTOTICK	ON\|OFF	Lorsqu'il est activé (ON), des intervalles de marque de graduation sont automatiquement définis. ON est la valeur par défaut. (Voir aussi HTICK et VTICK).
BARNUMB	ON\|OFF	Lorsqu'il est activé (ON), il positionne les valeurs récapitulatives à la fin des barres dans les graphiques à barres ou des graphiques circulaires. OFF est la valeur par défaut.
BSTACK	ON\|OFF	Lorsqu'il est activé (ON), il spécifie que les barres sur un graphique à barres doivent être empilées et non pas positionnées côte à côte. OFF est la valeur par défaut.
GRAPHEDIT	graphedit	Depuis WebFOCUS 8.0, ce paramètre est obsolète. Pour plus d'informations sur l'édition de graphique, consultez le Manuel de l'utilisateur InfoAssist WebFOCUS.
GRID	ON\|OFF	Lorsqu'il est activé (ON), il spécifie qu'une grille doit être dessinée sur le graphique aux marqueurs de classe horizontale et verticale (voir aussi VGRID). OFF est la valeur par défaut.
HAUTO	ON\|OFF	Lorsqu'il est activé (ON), il spécifie la mise en échelle automatique de l'axe horizontal à moins qu'il ne soit annulé par l'utilisateur. S'il est désactivé (OFF), l'utilisateur doit saisir des valeurs pour HMAX et HMIN. ON est la valeur par défaut.
HAXIS		Spécifie la largeur en caractères de l'axe horizontal. Ce paramètre peut être réglé pour les graphiques générés hors ligne. HAXIS est ignoré par les affichages en ligne car la largeur du graphique est automatiquement adaptée en fonction de la largeur de la zone d'affichage.
HCLASS	nnn	Spécifie le marqueur d'intervalle horizontal lorsque AUTOTICK=OFF (voir aussi HTICK).
HISTOGRAM	ON\|OFF	Lorsqu'il est activé (ON), un histogramme est dessiné au lieu d'une courbe lorsque les valeurs sur l'axe horizontal ne sont pas numériques. ON est la valeur par défaut.
HMAX	nnn	Spécifie la valeur maximale de l'axe horizontal lorsque la mise à l'échelle automatique n'est pas utilisée (HAUTO=OFF).
HMIN	nnn	Spécifie la valeur maximale de l'axe horizontal lorsque la mise à l'échelle automatique n'est pas utilisée (HAUTO=OFF).
HSTACK	ON\|OFF	Lorsqu'il est activé (ON), il spécifie que les barres sur l'histogramme soient empilées et non pas positionnées côte à côte. OFF est la valeur par défaut.
HTICK	nnn	Spécifie le marqueur d'intervalle horizontal lorsque AUTOTICK=OFF (voir aussi HCLASS).
LOOKGRAPH	option	Spécifie le type de graphique. Pour plus d'informations, consultez Détermination de styles de graphiques avec LOOKGRAPH.
PIE	ON\|OFF	Lorsqu'il est activé (ON), il spécifie qu'un graphique à secteurs est souhaité. OFF est la valeur par défaut.
VAUTO	ON\|OFF	Lorsqu'il est activé (ON), il spécifie la mise à l'échelle automatique de l'axe vertical à moins qu'il ne soit annulé par l'utilisateur. S'il est désactivé (OFF), l'utilisateur doit saisir des valeurs pour VMAX et VMIN. ON est la valeur par défaut.
VAXIS		Spécifie la longueur de lignes en lignes. Ce paramètre peut être réglé pour les graphiques générés hors ligne. VAXIS est ignoré par les affichages en ligne car la hauteur du graphique est automatiquement adaptée en fonction de la zone d'affichage.
VCLASS	nnn	Spécifie le marqueur d'intervalle horizontal lorsque AUTOTICK=OFF (voir aussi VTICK).
VGRID	ON\|OFF	Lorsqu'il est activé (ON), il spécifie qu'une grille doit être dessinée sur le graphique aux marqueurs de classe horizontale et verticale (voir aussi GRID). OFF est la valeur par défaut.
VMAX	nnn	Spécifie la valeur maximale de l'axe vertical lorsque la mise à l'échelle automatique n'est pas utilisée (HAUTO=OFF).
VMIN	nnn	Spécifie la valeur minimale de l'axe vertical lorsque la mise à l'échelle automatique n'est pas utilisée (HAUTO=OFF).
VTICK	nnn	Spécifie le marqueur d'intervalle horizontal lorsque AUTOTICK=OFF (voir aussi VCLASS).
VZERO	ON\|OFF	Détermine si les valeurs sur l'axe Y sont stockées ou ignorées. S'il est activé (ON), les données manquantes sur l'axe Y sont traitées comme zéro. S'il est désactivé (OFF), les données manquantes sur l'axe Y sont ignorées et les valeurs ne sont pas stockées dans la matrice de traçage. OFF est la valeur par défaut.

Définition d'échelles fixes pour l'axe X

Comment :

Définir des échelles fixes pour l'axe X

L'échelle horizontale est définie automatiquement de manière à couvrir toute la plage de valeurs à représenter graphiquement (HAUTO=ON). La plage est divisée en intervalles appelés classes. L'échelle est normalisée de sorte à fournir des valeurs de classe arrondies aux multiples de 10 appropriés pour les intervalles représentés sur l'axe.

Pour attribuer des limites fixes supérieures et inférieures (servant à générer une série de graphiques où des échelles homogènes sont nécessaires), vous pouvez désactiver le mécanisme de mise à l'échelle automatique et définir des nouvelles valeurs de limite en définissant HAUTO=OFF.

Haut de page

Syntaxe : Définir des échelles fixes pour l'axe X

SET HAUTO=OFF, HMAX=nn, HMIN=nn

où :

HAUTO: est la fonctionnalité de mise à l'échelle automatique. Si HAUTO est activé (ON), toute valeur de HMAX et HMIN est annulée.
HMAX=nn: définit la limite supérieure de l'axe horizontal. La valeur par défaut est 0.
HMIN=nn: contrôle la limite inférieure de l'axe horizontal lorsque HAUTO égale OFF. La valeur par défaut est 0.

Remarque :

si vous saisissez plusieurs paramètres SET sur une ligne, séparez-les par des virgules.
si vous définissez des limites qui n'incorporent pas toutes les valeurs de données, OVER ou UNDER s'affichent pour indiquer que certaines données extraites ne sont pas reflétées dans le graphique.

Définition d'échelles fixes pour l'axe Y

Comment :

Définir des échelles fixes pour l'axe Y

Pour appliquer des limites supérieures et inférieures fixes aux échelles verticales (cela est utile pour générer une série de graphiques où des échelles homogènes sont nécessaires), vous pouvez désactiver le mécanisme de mise à l'échelle automatique et définir des limites fixes en utilisant la commande SET VAUTO=OFF.

Haut de page

Syntaxe : Définir des échelles fixes pour l'axe Y

SET VAUTO=OFF, VMAX=nn, VMIN=nn

où :

VAUTO: est la fonctionnalité de mise à l'échelle automatique. Si VAUTO est activé (ON), toute valeur de VMAX et VMIN est annulée.
VMAX=nn: définit la limite supérieure de l'axe vertical lorsque VAUTO est désactivé (OFF). La valeur par défaut est 0.
VMIN=nn: contrôle la limite inférieure de l'axe vertical lorsque VAUTO est désactivé (OFF). La valeur par défaut est 0.

Remarque :

si vous saisissez plusieurs paramètres SET sur une ligne, séparez-les par des virgules.
si vous définissez des limites qui n'incorporent pas toutes les valeurs de données, OVER ou UNDER s'affichent pour indiquer que certaines données extraites ne sont pas reflétées dans le graphique.

Personnalisation des graphiques avec l'API graphique et les propriétés HTML5 JSON

Comment :

Personnaliser un graphique avec l'API graphique

Vous pouvez améliorer votre graphique en ajoutant des appels API au sein des commandes ON GRAPH SET STYLE * et ENDSTYLE dans la requête de GRAPH. Si vous es en train de créer un graphique HTML5, vous pouvez aussi inclure des méthodes et des propriétés de notation d'objet JavaScript (JSON). Lorsque vous enregistrez vos changements, les appels et les propriétés API correspondant seront écrits sur la feuille de style graphique.

Pour plus d'informations sur le graphique API, consultez le manuel Graphiques WebFOCUS.

Vous pouvez inclure les deux appels JSON et API dans la section de feuille de style de la requête, les appels API étant analysés un premier, avant les JSON. Par conséquent, si JSON renseigne la même propriété qu'un appel API, le JSON aura préséance. En général, les dernières déclarations remplacent le jeu de propriétés des premières.

Haut de page

Syntaxe : Personnaliser un graphique avec l'API graphique

GRAPH FILE filename 
graph commands 
ON GRAPH SET STYLE *
*GRAPH_SCRIPT 
API calls 
*END

*GRAPH_JS 
JSON 
*END

WEBFOCUS StyleSheet commands 
ENDSTYLE
END

où :

filename: Spécifie une source de données pour le graphique.
appels API: Sont des appels API. Il doit être inclus dans un bloc GRAPH_SCRIPT au sein des déclarations *GRAPH_SCRIPT et *END. Une requête peut contenir plusieurs blocs GRAPH_SCRIPT à n'importe quel endroit de la section de style. Pour plus d'informations sur le graphique API, consultez le manuel Graphiques WebFOCUS.
JSON: Sont les méthodes et les propriétés JSON s'appliquant à la sortie graphique HTML5. Il doit être inclus dans un bloc GRAPH_JS au sein des déclarations *GRAPH_JS *END. Une requête peut contenir plusieurs blocs GRAPH_JS à n'importe quel endroit de la section de style. Pour les informations de référence sur les méthodes les propriétés JSON, consultez le Guide API Moteur graphique JavaScript.
commandes de la Feuille de style WEBFOCUS: Pour en savoir plus au sujet des feuilles de style, consultez Création et gestion d’une feuille de style WebFOCUS.

Haut de page

Exemple : Personnalisation de graphiques avec l'API graphique

L'exemple suivant illustre comment personnaliser un graphique avec la commande ON GRAPH SET STYLE *. Le code d'API graphique est mis en évidence dans la requête.

   GRAPH FILE SALES
   SUM RETURNS
   RETAIL_PRICE
   ACROSS PROD_CODE AS 'Product Code'
   ON GRAPH SET STYLE *
   *GRAPH_SCRIPT
1. setLegendMarkerPosition(4);
2. setO1LabelRotate(0);
3. setTitleString("Sales Report");
4. setTextJustHoriz(getTitle(),1);
   *END  
   DEFMACRO=COND0001, MACTYPE=RULE, WHEN=RETURNS GT 4,$
   TYPE=DATA,MACRO=COND0001,ACROSSCOLUMN=RETURNS,COLOR=RED,$
   ENDSTYLE
   END

où :

Affiche le texte légende au sein du marqueur de légende.
Affiche les étiquettes de l'axe X horizontalement.
Affiche le titre (Sales Report) sans guillemets.
Centre le titre.

La sortie est :