Graphique

www.altova.com Agrandir/Réduire tout Imprimer cette rubrique Page précédente Un niveau supérieur Page suivante

Accueil >  Commandes et événements de commande > Commandes >

Graphique

La commande Graphique permet d'afficher des données depuis un fichier de données source sous la forme de graphique. Les types de graphiques disponibles sont les suivants : camemberts, graphique à barres, à ligne, à aires, à chandelles et à jauge. Les données pour l'axe X, Y et autres composants de graphiques sont sélectionnées avec les expressions XPath. Le nœud de contexte pour ces expressions XPath est défini en le glissant depuis l'arborescence de données de source et en le déposant dans la commande du graphique dans le design.

 

Les paramètres d'affichage du graphique dans la page sont définis dans le Volet de Styles & Propriétés. Les paramètres pour le type de graphique, la sélection de données et l'apparence sont définis dans le dialogue de Configuration du graphique. Ce dialogue est accessible en cliquant sur le bouton Dialogue supplémentaire de la propriété de Paramètres de graphique ou en double-cliquant sur le graphique dans le design.

 

Pour plus d'informations concernant la configuration des graphiques, voir la section Graphiques.

 

Cliquer pour agrandir/réduireNotes
Lorsque la commande est associée à un nœud de source de données (lien de source de page), placer la souris au-dessus de la commande (dans Affichage Design de la page) pour afficher le nœud associé dans une fenêtre popup.
Tous les liens de source de page dans l'arborescence de source de page sont affichés dans une police d'écriture en gras. Les nœuds d'arborescence qui ne sont pas des liens de source de page sont affichés dans une police normale
Placer la souris au-dessus du lien de source de page dans l'arborescence de design pour afficher des informations concernant la commande associée.
Pour supprimer une association de nœud de source de données (et donc les données dans la commande), cliquer sur la commande avec le bouton de droite (dans Affichage Design de la page) et cliquer sur Supprimer le lien de la source de page.
Pour réinitialiser un style ou une propriété (dans le Volet Styles & Propriétés), sélectionner la propriété et cliquer sur Réinitialiser dans la barre outils du volet.
Les valeurs de plusieurs propriétés peuvent être définies en utilisant des expressions XPath. Cela permet aux valeurs d'être dynamiques : donc générées par le biais de calculs ou prélevées dans les nœuds de source de données lors de l'exécution. Pour définir une expression XPath, cliquer sur Éditer XPath dans la barre d'outils du volet Styles & Propriétés.
Pour éditer l'expression XPath d'un style ou d'une propriété (dans le Volet Styles & Propriétés), sélectionner le style ou la propriété et cliquer sur Éditer XPath dans la barre outils du volet.
Pour copier une commande dans un autre emplacement dans le design, appuyer sur Ctrl et glisser/déposer la commande dans l'emplacement de copie désiré.
Afin d'attribuer des propriétés spécifiques à une commande, définir une ou plusieurs classes pour cette commande (au moyen de la propriété de navigateur Classe CSS), puis attribuer des règles pour la/les classe/s dans un fichier CSS externe (que vous spécifierez dans le dialogue de Paramètres du navigateur).
Les propriétés CSS d'une commande peuvent être définies dans le Volet Styles & Propriétés et/ou dans un fichier CSS externe. Celles définies dans le Volet Styles & Propriétés ont priorité.

 

Événements de graphique

L'événement SurClicDeGraphique est disponible. Pour définir les actions de l'événement SurClicDeGraphique du graphique, cliquer sur le graphique avec le bouton de droite de la souris et, à partir du menu contextuel qui apparaît, choisir Actions de commande pour SurClicDuGraphique. Le dialogue Action pour les événements de graphique s'ouvre. Pour voir une description des actions pouvant être définies pour cet événement, voir la section Actions.

 

Cliquer pour agrandir/réduireSurClicDeGraphique (SurClic, SurLongClic)

L'utilisateur final peut cliquer sur la commande de deux manières : un tapotement bref ou une pression prolongée. Une séquence d'actions différentes peut être spécifiée pour chaque type de clic. Une séquence supplémentaire d'actions peut être réalisée après celle du clic de l'utilisateur final. Cette séquence supplémentaire est définie après l'événement SurLongClic.

MTDActionOnClick   MTDActionOnLongClick   MTDActionOnClickOnLongClick

 

SurClic : la/les action/s à exécuter lorsque la commande est tapotée (voir capture d'écran ci-dessus à gauche).
SurLongClic : la/les action/s à exécuter sur une pression de la commande un peu plus longue qu'un tapotement (voir capture d'écran ci-dessus au centre).
Actions supplémentaires : la/les action/s à exécuter après l'exécution des actions SurClic ou SurLongClic (voir capture d'écran ci-dessus à droite). Si aucune action n'a été définie pour les événements SurClic ou SurLongClic, l'action sera alors exécutée directement sur un clic ou un long clic.

 

Vous pouvez combiner les actions pour les différents événements de clic, telles que montrées, par exemple, dans la capture d'écran ci-dessous.

MTDActionOnClickMultiple

La capture d'écran ci-dessus montre que les événements SurClic ou SurLongClic ont une séquence d'actions définie pour chacun d'entre eux. Un événement supplémentaire MessageBox est défini après l'événement SurLongClic. Cet événement MessageBox sera exécuté une fois que la séquence d'actions SurClic ou SurLongClic aura été exécutée.

 

Sur Entrée/Échapper

Si la case à cocher Sur Entrée ou Sur Échapper de la commande a été sélectionnée, alors les actions de la commande sont exécutées lorsque la touche respective (Entrée ou Échapper) est effleurée. L'effleurement de touche (Entrée ou Échapper) sert en guise d'alternative dans l'événement SurClic, et fonctionnera en plus du clic. La capture d'écran ci-dessous montre les cases à cocher SurEntrée et SurÉchapper de l'événement Bouton. D'autres commandes qui fournissent cette option semblent similaires et fonctionnent de manière semblable.

 

MTDOnEnterEscapeCheckBoxes

 

Ce paramètre peut aussi être accédé par le biais de la propriété de la commande Sur Entrée/Échapper. Pour plus de détails, voir la description de la propriété ci-dessous.

 

Note :        Si vous choisissez la commande de menu Page | Afficher/Définir ordre d'onglet, les commandes dotées d'un key-tap Entrée ou Échapper sont marquées avec le symbole de la clé respective

 

Note :   Cette fonction est uniquement disponible sur les clients web et les clients Windows.

 

 

 

Propriétés de graphique

Les propriétés de la commande sont disponibles dans le Volet Styles & Propriétés, et sont classées ci-dessous dans leur ordre d'apparence.

 

Cliquer pour agrandir/réduireNom

Le nom est utilisé pour référencer la commande depuis un autre endroit de la page ou du projet. Double-cliquer dans le champ de valeur pour l'éditer.

 

Cliquer pour agrandir/réduireParamètres de graphique

Cliquer sur le Dialogue supplémentaire pour afficher le dialogue de Configuration des graphiques. Les paramètres que vous définirez dans ce dialogue s'appliqueront au graphique actuellement sélectionné dans le design. Pour une description de la configuration des graphiques, voir la section Graphiques.

Cliquer pour agrandir/réduireID

Cette propriété doit être saisie lorsque le graphique est placé dans une table répétitive ou la ligne répétitive d'une table dynamique. La valeur de la propriété ID peut être un string de tout genre mais il doit évaluer à une ID différente pour chaque graphique instancié. Cela peut être réalisé en attribuant une expression XPath dynamique en tant que la valeur de la propriété.

 

Cliquer pour agrandir/réduireCréer avant le chargement

Dans la liste de choix, sélectionner la valeur que vous souhaitez : vrai ou faux. Si la valeur est vrai, le graphique ou l'image Base64 est créé avant le chargement de la page. Si la valeur est faux, une action de source de page doit être utilisée pour créer le graphique ou l'image. Le règlement par défaut est vrai.

 

Cliquer pour agrandir/réduireLargeur de création de graphique

Définit la largeur en pixels du graphique à générer. Cliquer sur l'icône Éditer XPath et saisir dans le dialogue qui apparaît une expression qui retourne une valeur numérique. Cette valeur sera la largeur en pixels du graphique à générer.

 

Click to expand/collapsePoints vs pixels sur les appareils iOS

Si vous saisissez des valeurs de pixels pour des propriétés qui définissent les longueurs, lors du rendu pour les appareils iOS, ces valeurs seront lues comme des points dans le système de coordonnées du viewport. Le système de coordonnées du viewport est le canevas sur lequel sont dessinés les composants de design, et un point est l'unité de longueur utilisé dans ce système. Ici, un point n'est pas l'unité typographique égale à 1/72ème d'un pouce. L'appareil iOS mappe automatiquement les points du système de coordonnées du viewport vers les pixels dans le système de coordonnées de l'appareil. En mappant les valeurs de cette manière, (des valeurs du viewport vers les valeurs de l'appareil), les composants de design conservent le même rapport de taille aussi bien par rapport au canevas qu'entre eux, quelle que soit la résolution de l'appareil iOS ou de l'unité utilisée.

 

Dans MobileTogether Designer, vous pouvez utiliser les variables dynamiques $MT_CanvasX et $MT_CanvasY pour connaître les dimensions actuelles du viewport (canevas) et obtenir des longueurs relatives à ces dimensions. (En ce qui concerne les appareils iOS, les valeurs retournées par ces variables sont calculées comme suit : les dimensions de pixel du système de coordonnées de l'appareil actuelles sont converties (en utilisant un facteur de conversion approprié) vers des valeurs de points dans le système de coordonnées du viewport. Ces valeurs de point, comme des nombres, sont retournées par les variables en tant que pixels pour être utilisés dans le design. Par exemple, si vous souhaitez qu'une image ne présente que la moitié de la largeur du viewport, il faudra lui donner une largeur en pixels égale à $MT_CanvasX * 0.5, l'expression XPath pour cette largeur de l'image serait concat ($MT_CanvasX 0.5, 'px')

Cliquer pour agrandir/réduireHauteur de création du graphique

Définit la hauteur en pixels du graphique à générer. Cliquer sur l'icône Éditer XPath et saisir dans le dialogue qui apparaît une expression qui retourne une valeur numérique. Cette valeur sera la hauteur en pixels du graphique à générer.

 

Click to expand/collapsePoints vs pixels sur les appareils iOS

Si vous saisissez des valeurs de pixels pour des propriétés qui définissent les longueurs, lors du rendu pour les appareils iOS, ces valeurs seront lues comme des points dans le système de coordonnées du viewport. Le système de coordonnées du viewport est le canevas sur lequel sont dessinés les composants de design, et un point est l'unité de longueur utilisé dans ce système. Ici, un point n'est pas l'unité typographique égale à 1/72ème d'un pouce. L'appareil iOS mappe automatiquement les points du système de coordonnées du viewport vers les pixels dans le système de coordonnées de l'appareil. En mappant les valeurs de cette manière, (des valeurs du viewport vers les valeurs de l'appareil), les composants de design conservent le même rapport de taille aussi bien par rapport au canevas qu'entre eux, quelle que soit la résolution de l'appareil iOS ou de l'unité utilisée.

 

Dans MobileTogether Designer, vous pouvez utiliser les variables dynamiques $MT_CanvasX et $MT_CanvasY pour connaître les dimensions actuelles du viewport (canevas) et obtenir des longueurs relatives à ces dimensions. (En ce qui concerne les appareils iOS, les valeurs retournées par ces variables sont calculées comme suit : les dimensions de pixel du système de coordonnées de l'appareil actuelles sont converties (en utilisant un facteur de conversion approprié) vers des valeurs de points dans le système de coordonnées du viewport. Ces valeurs de point, comme des nombres, sont retournées par les variables en tant que pixels pour être utilisés dans le design. Par exemple, si vous souhaitez qu'une image ne présente que la moitié de la largeur du viewport, il faudra lui donner une largeur en pixels égale à $MT_CanvasX * 0.5, l'expression XPath pour cette largeur de l'image serait concat ($MT_CanvasX 0.5, 'px')

Cliquer pour agrandir/réduireAction de commande

Cliquer sur le bouton Dialogue supplémentaire pour afficher le dialogue d'actions de la commande. Vous pouvez définir l'exécution d'actions lors du déclenchement d'un événement de commande. Un ou plusieurs événements de commande sont prédéfinis et chacun est affiché dans un onglet propre dans le volet de droite du dialogue d'actions. Une bibliothèque d'actions est affichée dans le volet de gauche. Vous pouvez glisser une action depuis le volet de gauche dans un onglet d'événement puis définir les propriétés de l'action. Plusieurs actions peuvent être définies pour chaque événement. Elles seront exécutées dans l'ordre de leur occurrence, de haut en bas.

 

Une fois les actions de commande définies, vous pouvez y accéder et les éditer à tout moment en cliquant sur le bouton Dialogue supplémentaire de la propriété. En alternative, vous pouvez accéder à un événement de commande en cliquant dessus avec la touche de droite et en sélectionnant l'événement de la commande dans le menu contextuel qui apparaît.

 

Cliquer pour agrandir/réduireVisible

Une expression XPath qui doit évaluer à vrai() ou faux(). Si l'expression évalue à faux()(et seulement dans ce cas) la commande ne sera pas visible. Si l'expression évalue à vrai() ou retourne d'autres valeurs, la commande sera visible. Le réglage par défaut est vrai(). Double-cliquer dans le champ de valeur ou cliquer sur le bouton XPath pour saisir ou éditer une expression XPath. La propriété Visible peut être utilisée pour rendre un objet visible ou pas selon le fait qu'une expression XPath évalue à vrai()ou pas. En résultat, l'affichage d'un objet peut être forcé à être dynamiquement dépendant du contexte ou de la structure des données.

 

Note :  Pour plus d'informations concernant la visibilité des colonnes/lignes couvertes, voir les Propriétés de table.

 

Note :  La variable $MTControlValue n'est pas disponible pour l'évaluation de la propriété Visible. En cas d'utilisation, une erreur de validation en résultera

 

Cliquer pour agrandir/réduireAlignement horizontal

Définit l'alignement horizontal à gauche, centre ou droite. Le réglage par défaut est centre. La valeur peut aussi être spécifiée par le biais d'une expression XPath (qui permet de générer la valeur dynamiquement).

 

Cliquer pour agrandir/réduireLargeur de commande

Définit la largeur de la commande. Sélectionner une valeur depuis la liste de choix de la propriété. Les valeurs suivantes sont disponibles :

 

fill_parent : permet d'obtenir une commande de la même largeur que le parent. Cela peut être par exemple une cellule de la table ou la page
wrap_content : permet d'obtenir une commande ne dépassant pas la largeur du contenu de la commande ; lorsque cette valeur est sélectionnée, la propriété Largeur de commande maximum est disponible
valeur pourcentuelle : un pourcentage de la largeur de la page ; sélectionner une valeur depuis la liste déroulante ou saisir directement une valeur
valeur de pixel: sélectionner une valeur de pixel depuis la liste déroulante ou saisir directement une valeur

 

De fait, fill_parent crée une largeur maximum, alors que wrap_content crée une largeur minimum.

 

La valeur par défaut est fill_parent pour toutes les commandes sauf pour les éléments suivants :

 

Image et Chart: dans ces cas, le défaut est wrap_content.
Carte géolocalisation : le défaut est la plus petite des deux valeurs $MT_CanvasX et $MT_CanvasY. Ces deux variables dynamiques donnent, respectivement, la largeur et la hauteur du viewport de l'appareil. Puisque la valeur par défaut de Control Height et de Control Width sont les mêmes (dans chacun des cas, la valeur la plus petite de $MT_CanvasX et $MT_CanvasY), la forme et la taille par défaut du viewport dans la commande seront toujours un carré dont les côtés sont égaux à min($MT_CanvasX, $MT_CanvasY).

 

Click to expand/collapsePoints vs pixels sur les appareils iOS

Si vous saisissez des valeurs de pixels pour des propriétés qui définissent les longueurs, lors du rendu pour les appareils iOS, ces valeurs seront lues comme des points dans le système de coordonnées du viewport. Le système de coordonnées du viewport est le canevas sur lequel sont dessinés les composants de design, et un point est l'unité de longueur utilisé dans ce système. Ici, un point n'est pas l'unité typographique égale à 1/72ème d'un pouce. L'appareil iOS mappe automatiquement les points du système de coordonnées du viewport vers les pixels dans le système de coordonnées de l'appareil. En mappant les valeurs de cette manière, (des valeurs du viewport vers les valeurs de l'appareil), les composants de design conservent le même rapport de taille aussi bien par rapport au canevas qu'entre eux, quelle que soit la résolution de l'appareil iOS ou de l'unité utilisée.

 

Dans MobileTogether Designer, vous pouvez utiliser les variables dynamiques $MT_CanvasX et $MT_CanvasY pour connaître les dimensions actuelles du viewport (canevas) et obtenir des longueurs relatives à ces dimensions. (En ce qui concerne les appareils iOS, les valeurs retournées par ces variables sont calculées comme suit : les dimensions de pixel du système de coordonnées de l'appareil actuelles sont converties (en utilisant un facteur de conversion approprié) vers des valeurs de points dans le système de coordonnées du viewport. Ces valeurs de point, comme des nombres, sont retournées par les variables en tant que pixels pour être utilisés dans le design. Par exemple, si vous souhaitez qu'une image ne présente que la moitié de la largeur du viewport, il faudra lui donner une largeur en pixels égale à $MT_CanvasX * 0.5, l'expression XPath pour cette largeur de l'image serait concat ($MT_CanvasX 0.5, 'px')

Cliquer pour agrandir/réduireLargeur maximum de commande

Cette propriété est disponible uniquement lorsque la propriété de la commande Largeur de commande a été configurée sur wrap_content. La propriété Largeur de commande maximum définit la largeur maximum de la commande. Sélectionner une valeur depuis la liste de choix de la propriété. Les valeurs suivantes sont disponibles :

 

valeur pourcentuelle : un pourcentage de la largeur de la page ; choisir une valeur depuis la liste déroulante ou saisir une valeur directement
valeur de pixel : choisir une valeur de pixel depuis la liste déroulante ou saisir une valeur directement

 

Cliquer pour agrandir/réduireLimiter la hauteur par rapport au canevas

Sélectionner une des valeurs permises (vrai ou faux) dans la liste de choix. Dans le cas où la hauteur de la commande dépasse la hauteur de l'appareil, une valeur vrai restreint la hauteur à celle de la hauteur de l'appareil. Le réglage par défaut est vrai.

 

 

Cliquer pour agrandir/réduireMarge

Définit les décalages de marge de la commande relatifs aux objets environnants ou aux rebords de l'objet contenu. Sélectionner une valeur en pixels depuis la liste déroulante de la liste de choix ou double-cliquer dans le champ de valeur pour saisir une longueur de pixel. Le décalage spécifié sera créé sur les quatre côtés de la commande. Si vous souhaitez définir une marge différente pour un des quatre côtés, agrandir la propriété Marge pour afficher les propriétés de marge individuelles (gauche, droite, haut et bas), et définir la valeur différente. Par exemple : si vous définissez Marge sur 6px et Marge Bas sur 12px, alors les marges haut, gauche et droite seront 6px et la marge bas sera 12px.

 

Click to expand/collapsePoints vs pixels sur les appareils iOS

Si vous saisissez des valeurs de pixels pour des propriétés qui définissent les longueurs, lors du rendu pour les appareils iOS, ces valeurs seront lues comme des points dans le système de coordonnées du viewport. Le système de coordonnées du viewport est le canevas sur lequel sont dessinés les composants de design, et un point est l'unité de longueur utilisé dans ce système. Ici, un point n'est pas l'unité typographique égale à 1/72ème d'un pouce. L'appareil iOS mappe automatiquement les points du système de coordonnées du viewport vers les pixels dans le système de coordonnées de l'appareil. En mappant les valeurs de cette manière, (des valeurs du viewport vers les valeurs de l'appareil), les composants de design conservent le même rapport de taille aussi bien par rapport au canevas qu'entre eux, quelle que soit la résolution de l'appareil iOS ou de l'unité utilisée.

 

Dans MobileTogether Designer, vous pouvez utiliser les variables dynamiques $MT_CanvasX et $MT_CanvasY pour connaître les dimensions actuelles du viewport (canevas) et obtenir des longueurs relatives à ces dimensions. (En ce qui concerne les appareils iOS, les valeurs retournées par ces variables sont calculées comme suit : les dimensions de pixel du système de coordonnées de l'appareil actuelles sont converties (en utilisant un facteur de conversion approprié) vers des valeurs de points dans le système de coordonnées du viewport. Ces valeurs de point, comme des nombres, sont retournées par les variables en tant que pixels pour être utilisés dans le design. Par exemple, si vous souhaitez qu'une image ne présente que la moitié de la largeur du viewport, il faudra lui donner une largeur en pixels égale à $MT_CanvasX * 0.5, l'expression XPath pour cette largeur de l'image serait concat ($MT_CanvasX 0.5, 'px')

Click to expand/collapseSur Entrée/Échapper

Prend une des trois valeurs :

 

OnEnter: Spécifie que cette commande est dans le centre de l'attention et est "cliqué" lorsque la touche Entrée est effleurée.
OnEscape: Spécifie que cette commande est dans le centre de l'attention et est "cliqué" lorsque la touche Échapper est effleurée.
Aucun : Aucune action lorsque la touche est appuyée. Il s'agit de la valeur par défaut.

 

Si les expressions XPath sont utilisées pour générer les valeurs, les expressions doivent évaluer sur "OnEnter" ou "OnEscape". Si plus d'une commande sur une page reçoit la même valeur (OnEnter ou OnEscape), alors la première commande visible et activée qui a la valeur est sélectionnée lorsque la touche est effleurée. (Voir les propriétés Visible et Enabled/Editable.)

 

Cette configuration peut aussi être effectuée par le biais du dialogue pour définir les actions OnClicked de la commande (voir Événements de commande).

 

Note :   Cette fonction est uniquement disponible sur les clients Web et les clients Windows.

 

Cliquer pour agrandir/réduireFeuille de style

La propriété Feuille de style définit la feuille de style à utiliser pour la commande. La liste déroulante de la liste de choix de la propriété Feuille de style affiche toutes les feuilles de style créée par l'utilisateur qui ont été définies dans le projet. Sélectionner la feuille de style que vous souhaitez utiliser pour la commande. En alternative, vous pouvez utiliser une expression XPath pour sélectionner la feuille de style que vous souhaitez ; cela a l'avantage que vous pouvez rendre la sélection de la feuille de style conditionnelle (voir Appliquer les feuilles de style créées par l'utilisateur). Voir la section Feuilles de style pour plus d'informations.

 

Cliquer pour agrandir/réduireNavigateur classe CSS

Le nom d'une ou de plusieurs classes CSS que vous souhaitez associer avec cette commande. Ajouter un espace pour attribuer plusieurs classes : LabelClassOne LabelClassTwo. Ces classes peuvent ensuite être utilisées dans un fichier CSS (spécifié dans le dialogue de paramètres du navigateur) pour attribuer des propriétés spécifiquement à cette commande. Vous pouvez aussi utiliser une expression XPath pour générer ou aller chercher les noms de la (des) classe(s).

 

 

 


© 2019 Altova GmbH