ShowGraphic()

Identifiant

La propriété d’identité est le nom exclusif identifiant l’instance qui a ouvert le graphique.

L’identité ne peut pas contenir plus de 329 caractères et doit contenir au moins une lettre. Les caractères valides sont les caractères alphanumériques et les caractères spéciaux ($, #, _).

Il s’agit d’une propriété obligatoire du type de données chaîne.

Valeur par défaut : aucune

Exemple :

graphicInfo.Identity = "i1";

GraphicName

GraphicName est le nom du graphique à montrer.

GraphicName ne peut pas contenir plus de 329 caractères et doit contenir au moins une lettre. Les caractères valides sont les caractères alphanumériques et les caractères spéciaux ($, #, _).

Il s’agit d’une propriété obligatoire du type de données chaîne.

Valeur par défaut : aucune

Parcourez à l'aide de votre navigateur d'applications HMI/SCADA, comme Afficher l'explorateur du Galaxy ou équivalent dans votre logiciel HMI/SCADA, ou entrez directement le nom du graphique. Le nom de l'application peut provenir de :

• Dossier Visualisation, par exemple :
  "Symbol_001"

• Des instances, en absolu ou hiérarchiques, par exemple :
  « definitionUtilisateur_001.Symbole1 », « definitionUtilisateur_001.Pompe_001.S1 »

• Des références relatives, par exemple :
  "Me.Symbol_001"

  Si vous utilisez un assistant d’objet avec la sélection de propriétés personnalisées d’un assistant de symboles, utilisez un nom absolu pour spécifier le nom du graphique et l’objet propriétaire. Cela permet d'afficher la configuration graphique correcte pour l'instance. Voir OwningObject, ci-dessous, pour plus d’informations.

  Si vous avez tapé un caractère invalide ou dépassé la limite de longueur, le système présente un avertissement en temps d'exploitation. Il n'y a pas de validation pendant la conception.

  Le nom du graphique peut être la concaténation de constantes chaînes ou de références chaînes. Par exemple :

  "Pompe_001" + ".Symbole_001"; cp1 + ".Symbole_001", où la valeur de cp1 = "Pompe_001"; ou Obj1.Str1 + ".Symbole_001", où la valeur de Obj.Str1 = "Pompe_001".

  Exemples :

  Pour spécifier une référence du dossier Visualisation :

  graphicInfo.GraphicName = "S1";

  Pour spécifier une référence absolue :

  graphicInfo.GraphicName = "nomObjetPropriétaire.SymbolName";

OwningObject

Le nom de l’objet propriétaire du graphique affiché par la fonction de script ShowGraphic().

OwningObject est une propriété facultative. Il peut s'agir d'une concaténation de chaînes constantes et de chaînes de référence. OwningObject peut être parcouru à l’aide d’Afficher l’explorateur d’objet Automation, ou vous pouvez saisir le nom de l’objet propriétaire.

La propriété OwningObject définit des références pour le graphique, mais n'est pas associée avec la propriété GraphicName si le graphique fait partie d'un assistant d'objet. Par conséquent, si vous créez le script pour un graphique avec un objet propriétaire, spécifiez le nom de l’objet propriétaire comme partie de la propriété GraphicName, par exemple :

UserDefined_001.Pump_001.

Il s’agit d’une propriété facultative du type de données chaîne.

Valeur par défaut : vide

Exemple :

graphicInfo.OwningObject = "UserDefined_001";

HasTitleBar

HasTitleBar détermine si le graphique montre une barre de titre.

Il s’agit d’une propriété facultative de type de données Boolean.

Valeur par défaut : True

Exemple :

graphicInfo.HasTitleBar = false;

WindowTitle

WindowTitle spécifie le titre affiché dans la barre de titre de la fenêtre.

Il s’agit d’une propriété facultative du type de données chaîne.

Valeur par défaut : Empty

Plage valide : limite de 1 024 caractères.

WindowTitle peut être une constante chaîne, une référence ou une expression. Si vous changez l’objet propriétaire d’un graphique AutomationObject, WindowTitle est mis à jour en conséquence. Si WindowTitle est vide, la valeur de la propriété Identité est affichée dans la barre de titre.

Exemple :

Il s’agit d’une propriété facultative de type de données Boolean.

graphicInfo.WindowTitle = "Graphic01";

WindowType

WindowType spécifie si la fenêtre est de type modal ou non modal.

Il s’agit d’une propriété facultative du type de données énum.

Valeur par défaut : Sans mode

Plage valide : 0 ou 1 où

• 0 = Modal

• 1 = Sans mode.

Exemples :

graphicInfo.WindowType = aaGraphic.WindowType.<windowtype>;

graphicInfo.WindowType = 1;

HasCloseButton

HasCloseButton détermine si la fenêtre indépendante possède un bouton de fermeture.

Il s’agit d’une propriété facultative de type de données Boolean.

Valeur par défaut : True

Exemple :

graphicInfo.HasCloseButton = false;

Redimensionnable

Resizable détermine si la fenêtre indépendante est redimensionnable.

Il s’agit d’une propriété facultative de type de données Boolean.

Valeur par défaut : False

Exemple :

graphicInfo.Resizable = true;

WindowLocation

WindowLocation spécifie l’emplacement de la fenêtre indépendante.

Il s’agit d’une propriété facultative du type de données énum.

Valeur par défaut : 0 (centre)

Plage valide : 0 à 12, où l’emplacement de la fenêtre est défini par l’énumération correspondante  :

0 = Center
1 = Above
2 = TopLeftCorner
3 = Top
4 = TopRightCorner
5= LeftOf
6= LeftSide
7= RightSide
8 = RightOf
9 = BottomLeftCorner
10 = Bottom
11 = BottomRightCorner
12 = Below

Si la position relative de la fenêtre est Desktop (bureau), les valeurs Au dessus (1), À gauche (6), À droite (8) et En dessous (12) (Above, LeftOf, RightOf et Below) sont invalides. Pour plus d’informations sur le comportement du paramètre WindowLocation, voir la section Travailler avec les fonctions de script d’affichage ou masquage de graphiques du document Création et gestion de graphiques industriels - Guide de l’utilisateur?

Exemples :

graphicInfo.WindowLocation = aaGraphic.WindowLocation.<WindowLocation>;

graphicInfo.WindowLocation = 1;

WindowRelative
Position

WindowRelativePosition spécifie la position relative de la fenêtre indépendante.

Il s’agit d’une propriété facultative du type de données énum.

Valeur par défaut : 0 (bureau)

Plage valide : 0 à 8, où la position relative de la fenêtre est définie par l’énumération correspondante.

0 = Desktop
1 = Window
2 = ClientArea
3 = ParentGraphic
4 = ParentElement
5 = Mouse
6 = DesktopXY
7 = WindowXY
8 = ClientAreaXY

Exemples :

graphicInfo.WindowRelativePosition = aaGraphic.WindowRelativePosition.<WindowRelativePosition>;

graphicInfo.WindowRelativePosition = 1;

RelativeTo

RelativeTo spécifie la taille de la fenêtre indépendante relativement au graphique, au bureau ou à une largeur et hauteur personnalisées.

Il s’agit d’une propriété facultative du type de données énum.

Valeur par défaut : 0 (Graphique)

Plage valide : 0, 1, 2 où

0 = Graphic
1 = Desktop
2 = CustomizedWidthHeight

Si vous spécifiez aaGraphic.RelativeTo.CustomizedWidthHeight, vous pouvez inclure les valeurs de hauteur et largeur dans le script. Autrement, les valeurs par défaut sont utilisées.

Exemples :

graphicInfo.RelativeTo = aaGraphic.RelativeTo.<RelativeTo>;

graphicInfo.RelativeTo = 1;

X

X spécifie la position horizontale de la fenêtre indépendante.

Il s’agit d’une propriété facultative du type de données integer.

Valeur par défaut : 0

Plage valide : -2,147,483,648 à 2,147,483,647

Si X est hors intervalle, un message de débordement est consigné dans le Logger pendant l’exploitation.

Ce paramètre ne s’applique que si la valeur du paramètre WindowRelativePosition est DesktopXY, WindowXYou ClientAreaXY. A la différence de l'animation ShowSymbol, il n'y a pas de limite de valeur.

Exemple :

graphicInfo.X = 100;

O

Y spécifie la position verticale de la fenêtre indépendante.

Il s’agit d’une propriété facultative du type de données integer.

Valeur par défaut : 0

Plage valide : -2,147,483,648 à 2,147,483,647

Si Y est hors intervalle, un message de débordement est consigné dans le Logger pendant l’exploitation. Ce paramètre ne s’applique que si la valeur du paramètre WindowRelativePosition est DesktopXY, WindowXYou ClientAreaXY. A la différence de l'animation ShowSymbol, il n'y a pas de limite de valeur.

Exemple :

graphicInfo.Y = 100;

Largeur

Width spécifie la largeur de la fenêtre indépendante.

Il s’agit d’une propriété facultative du type de données integer.

Valeur par défaut : 100

Plage valide : 0-10000

Applicable uniquement si RelativeTo est CustomizedWidthHeight. Vous pouvez spécifier la hauteur ou la largeur de la fenêtre contextuelle. Le système calcule la valeur non précisée en fonction du rapport d'aspect du graphique. Si une valeur hors-intervalle est indiquée, le système affiche un message « Out of range » en exploitation. Si la valeur est supérieure à 10000, elle est redéfinie à 10000. Si la valeur est inférieure à 0, elle est définie à 0.

Exemple :

graphicInfo.width = 500;

Hauteur

Height spécifie la hauteur de la fenêtre indépendante.

Il s’agit d’une propriété facultative du type de données integer.

Valeur par défaut : 100

Plage valide : 0-10000

Height est applicable uniquement si RelativeTo a la valeur du paramètre CustomizedWidthHeight. Vous pouvez définir la hauteur ou la largeur de la fenêtre indépendante. Le système calcule la valeur non précisée en fonction du rapport d'aspect du graphique. Si une valeur hors-intervalle est indiquée, le système affiche un message « Out of range » en exploitation. Si la valeur est supérieure à 10000, elle est redéfinie à 10000. Si la valeur est inférieure à 0, elle est définie à 0.

Exemple :

graphicInfo.height = 500;

TopMost

TopMostDéfinit une valeur indiquant que la fonction ShowGraphic() affiche le graphique au sommet du Z-order des fenêtres. Un ShowGraphique dont la propriété Topmost est vraie s’affiche au-dessus de toutes les fenêtres dont la propriété TopMost est définie à faux (même effet que pour le Gestionnaire de tâches de Windows).

Il s’agit d’une propriété facultative de type de données Boolean.

Valeur par défaut : False

Dans un groupe de fenêtres dont la propriété Topmost est vraie, la fenêtre active est placée au sommet des autres. Ne créez pas de scripts ouvrant un dialogue modal dont la propriété TopMost est fausse depuis une boîte de dialogue dont la propriété TopMost est vraie. Les utilisateurs ne pourront pas interagir dans la vue si le dialogue modal est complètement masqué par une autre fenêtre dont la propriété TopMost est vraie.

Exemple :

graphicInfo.TopMost = true;

ScalePercentage

ScalePercentage définit l’échelle en pourcentage de la fenêtre indépendante et du graphique qu’elle contient.

Il s’agit d’une propriété facultative du type de données integer.

Valeur par défaut : 100

Plage valide : 0-1000

Si une valeur hors-intervalle est indiquée, le système affiche un message « Out of range » en exploitation. Si la valeur est supérieure à 1000, elle est définie à 1000. Si la valeur est inférieure à 0, elle est définie à 0.

Exemple :

graphicInfo.ScalePercentage = 150;

KeepOnMonitor

KeepOnMonitor spécifie qu’une fenêtre indépendante apparaît entièrement dans les limites d’une fenêtre d’application.

Il s’agit d’une propriété facultative de type de données Boolean.

Valeur par défaut : True

Exemple :

graphicInfo.KeepOnMonitor = true;

StretchGraphicToFit
WindowSize

StretchGraphicToFitWindowSize détermine si le graphique est mis à l’échelle de la taille actuelle de la fenêtre indépendante.

Il s’agit d’une propriété facultative de type de données Boolean.

Valeur par défau t: True

Applicable uniquement si la valeur du paramètre ScalePercentage est supérieure à 100.

Exemple :

graphicInfo.StretchGraphicToFitWindowSize = false;

StretchWindowTo
ScreenWidth

StretchWindowToScreenWidth détermine si la fenêtre indépendante est mise à l’échelle de la largeur de l’écran.

Il s’agit d’une propriété facultative de type de données Boolean.

Valeur par défaut : False

Applicable uniquement si la valeur du paramètre WindowRelativePosition est Desktop, Window, ClientArea, ParentGraphic ou ParentElement.

Exemple :

graphicInfo.StretchWindowToScreenWidth = vrai ;

StretchWindow
ToScreenHeight

StretchWindowToScreenHeight détermine si la fenêtre indépendante est mise à l’échelle de la hauteur de l’écran.

Il s’agit d’une propriété facultative de type de données Boolean.

Valeur par défaut : False

Applicable uniquement si la valeur du paramètre WindowRelativePosition est définie sur Desktop, Window, ClientArea, ParentGraphic ou ParentElement.

Exemple :

graphicInfo.StretchWindowToScreenHeight = true;

CustomProperties

CustomProperties est une matrice ValuePair[] utilisée pour définir les propriétés personnalisées du graphique affiché.

Il s’agit d’une propriété facultative de type de données ValuePair[].

Les trois premiers paramètres sont :

• Nom de propriété personnalisé

• Valeur

• ,IsConstant

  Le nom de propriété personnalisée et la valeur peuvent être une constante chaîne, une référence ou une concaténation de chaînes. Si le paramètre IsConstant = True, la valeur est considérée une constante. Autrement, la valeur est considérée une référence. Le premier index du tableau est 1.

  Exemple :

  Dim cpValeurs [4] as aaGraphic.CustomPropertyValuePair;

  cpValues[1] = new aaGraphic.CustomPropertyValuePair("CP1", 20, true);

  cpValues[2] = new aaGraphic.CustomPropertyValuePair("CP2", Pompe.PV.TagName, true);

  cpValues[3] = new aaGraphic.CustomPropertyValuePair("CP3", "CP"+var1, CP2 + "001" + ".Speed", true);

  cpValues[4] = new aaGraphic.CustomPropertyValuePair("CP3", "<HMIName>:Tag1", false);

  graphicInfo.CustomProperties = cpValues;