Affecte les informations d'en-tête à une valeur.
Syntaxe
AssignHeader(Value, le [ DataObject ] [ , le ElementNames ])
La syntaxe de la fonction AssignHeader se compose des éléments suivants :
Section |
Description |
|---|---|
Value |
La valeur à laquelle l'information d'en-tête est attribuée. Toutes les structures de données sont autorisées. Tous les types de données sont autorisés. |
DataObject |
Est une référence à un objet de données dont les informations d'en-tête doivent être attribuées, ou une valeur avec des informations d'en-tête attachées qui doivent être attribuées. Si vous omettez l'argument, des informations d'en-tête sont créées et attribuées sans être liées à un objet de données. Si vous utilisez comme argument DataObject une référence à la formule dans laquelle vous appelez la fonction AssignHeader, les paramètres de l'onglet "Résultat" de cette formule sont alors pris en compte. Toutes les structures de données sont autorisées. Tous les types de données ainsi que les références d'objets sont autorisés. |
ElementNames |
Est une liste dont les noms d'éléments doivent être utilisés pour former les noms d'éléments du résultat. Cet argument n'est utilisé que si vous avez spécifié comme argument DataObject une référence à la formule dans laquelle vous appelez la fonction AssignHeader et dont la propriété "Noms des éléments de la liste" a la valeur "Automatique". AssignHeader attribue alors aux éléments de la liste de résultats des noms formés à partir des noms d'éléments de la liste passée en paramètre et des paramètres de l'onglet "Résultat" de la formule. L'utilisation de AssignHeader avec cet argument est obsolète. Utilisez plutôt la variable locale SourceData, comme indiqué dans les exemples ci-dessous. Toutes les structures de données sont autorisées. Tous les types de données ainsi que les références d'objets sont autorisés. |
Remarques
Le résultat est la valeur transmise à laquelle les informations d'en-tête ont été ajoutées ou dont elles ont été retirées. Si Value est une liste, alors les informations d'en-tête sont attribuées à chaque élément de la liste. Si un élément de la liste est nommé, une copie indépendante des informations d'en-tête est créée pour cet élément et le nom de l'élément de la liste est saisi comme attribut "Nom".
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
Result = AssignHeader(Result, This) |
Attribue les informations d'en-tête de la formule avec le code FPScript à la valeur "Result". |
Result = AssignHeader(Result, Formula As Object) |
Affecte les informations d'en-tête de la formule à la valeur "Result". |
Result = AssignHeader(Result, Formula) |
Affecte à la valeur "Result" l'information d'en-tête, qui est annexée au résultat de la formule "Formula". |
Result = AssignHeader(Result, $"\Data\Channel1"$) |
Affecte à la valeur "Result" les informations d'en-tête de l'ensemble de données avec le nom de chemin spécifié dans la chaîne. |
Result = AssignHeader(Integral(Data)) |
Attribue la valeur "Result" aux informations d'en-tête qui ne sont pas liées à un objet de données, puis leur attribue un nom. |
Dim Data = [Signal1, Signal2] |
Calcule l'intégrale de deux ensembles de données et renvoie le résultat sous forme de liste. Chaque élément de la liste se voit attribuer une copie indépendante des informations d'en-tête de la formule dans laquelle se trouve le code FPScript. Si dans l'onglet "Résultat" de la formule, sous "Noms des éléments de la liste", le choix "Automatique" est sélectionné et que le modèle est "Automatique", l'attribut "Nom" est alors défini sur "Signal1Integral" ou "Signal2Integral". C'est-à-dire que l'expression Result.[0].Name donnerait par exemple "Signal1Integral". |
Dim SourceData = [Signal1, Signal2] |
Ce code est équivalent à l'exemple précédent et ne nécessite pas la fonction AssignHeader. Si vous attribuez les données sources à la variable locale SourceData, FlexPro peut alors, après le calcul, accéder aux noms des éléments des données sources et attribuer automatiquement les informations d'en-tête. |