TimelineSpan : global

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 9 minutes de lecture

    • L’API TimelineSpan fournit des méthodes pour définir un ensemble de propriétés qui décrivent les caractéristiques et le comportement interactif d’un élément rendu dans un élément de ligne de temps.

    Étant donné qu’il est extrêmement important que l’ensemble de la collection de parcours d’un élément de ligne de temps soit unique, la création d’une nouvelle instance doit être effectuée à l’aide de la méthode createTimelineItem() d’une instance d’élément de ligne de temps existante.

    TimelineSpan : addPrédécesseur(Tableau d’objets, objArray)

    Ajoute plusieurs relations entre l’instance actuelle et d’autres objets TimelineSpan en énumérant via le tableau d’objets JavaScript.

    Chaque objet doit avoir une propriété relationship_sys_id interne et predecessor_sys_id spécifiée.

    Tableau 1. Paramètres
    Nom Type Description
    objArray (en anglais seulement) Tableau d’objets Tableau d’objets JavaScript qui contient deux propriétés internes : relationship_sys_id et predecessor_sys_id.
    Tableau 2. Renvoie
    Type Description
    nul

    TimelineSpan : addPredecessor(String strPredecessorSysId, String strRelationshipSysId, String strTableName)

    Ajoute la relation spécifiée entre l’instance actuelle et un autre TimelineSpan et permet à la relation d’ouvrir un GlideWindow pour afficher des informations sur la relation.

    Tableau 3. Paramètres
    Nom Type Description
    strPredecessorSysId Chaîne Sys_id de l’enregistrement de tâche planifiée qui est le prédécesseur de la relation.
    strRelationshipSysId Chaîne Sys_id de l’enregistrement de la relation.
    strTableName Chaîne Nom de la table pour la relation.
    Tableau 4. Renvoie
    Type Description
    nul

    TimelineSpan : addPrédécesseur(String strPredecessorSysId, String strRelationshipSysId)

    Ajoute la relation spécifiée entre l’instance actuelle et un autre intervalle de temps avec sys_id strPredecessorSysId.

    Aucun gestionnaire de double-clic n’est associé à la ligne tracée.

    Tableau 5. Paramètres
    Nom Type Description
    strPredecessorSysId Chaîne Sys_id de l’enregistrement de tâche planifiée qui est le prédécesseur de la relation.
    strRelationshipSysId Chaîne Sys_id de l’enregistrement de la relation.
    Tableau 6. Renvoie
    Type Description
    nul

    TimelineSpan : getAllowXDragLeft()

    Renvoie la valeur booléenne de la AllowXDragLeft propriété.

    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. Renvoie
    Type Description
    Booléen Marqueur indiquant si l’heure de début de l’objet peut être ajustée.
    Valeurs valides :
    • true : l’heure de début de l’objet peut être ajustée.
    • faux : l’heure de début de l’objet ne peut pas être ajustée.

    TimelineSpan : getAllowXDragRight()

    Renvoie la valeur booléenne de la AllowXDragRight propriété.

    Tableau 9. Paramètres
    Nom Type Description
    Aucun
    Tableau 10. Renvoie
    Type Description
    Booléen Marqueur indiquant si l’heure de fin de l’objet peut être ajustée.
    Valeurs valides :
    • true : l’heure de fin de l’objet peut être ajustée.
    • faux : l’heure de fin de l’objet ne peut pas être ajustée.

    TimelineSpan : getAllowXMove()

    Renvoie la valeur booléenne de la AllowXMove propriété.

    Tableau 11. Paramètres
    Nom Type Description
    Aucun
    Tableau 12. Renvoie
    Type Description
    Booléen Marqueur indiquant si l’objet peut être déplacé horizontalement.
    Valeurs valides :
    • true : l’objet peut être déplacé horizontalement.
    • faux : l’objet ne peut pas être déplacé horizontalement.

    TimelineSpan : getAllowYMove()

    Renvoie la valeur booléenne de la AllowYMove propriété.

    Tableau 13. Paramètres
    Nom Type Description
    Aucun
    Tableau 14. Renvoie
    Type Description
    Booléen Marqueur indiquant si l’objet peut être déplacé verticalement.
    Valeurs valides :
    • true : l’objet peut être déplacé verticalement.
    • false : l’objet ne peut pas être déplacé verticalement.

    TimelineSpan : getAllowYMovePrédécesseur()

    Renvoie la valeur booléenne de la AllowYMovePredecessor propriété.

    Tableau 15. Paramètres
    Nom Type Description
    Aucun
    Tableau 16. Renvoie
    Type Description
    Booléen Marqueur indiquant si une ligne de relation en pointillés peut être tracée de l’objet actuel vers un nouveau successeur.
    Valeurs valides :
    • true : une ligne de relation en pointillés peut être tracée à partir de l’objet actuel vers un nouveau successeur.
    • false : impossible de tracer une ligne de relation en pointillés de l’objet actuel vers un nouveau successeur.

    TimelineSpan : getInnerSegmentClass()

    Renvoie le nom de la classe de segments internes actuelle pour l’intervalle de temps.

    Tableau 17. Paramètres
    Nom Type Description
    Aucun
    Tableau 18. Renvoie
    Type Description
    Chaîne Nom de la classe pour le style de segment interne actuel.

    TimelineSpan : getInnerSegmentEndTimeMs()

    Renvoie l’heure, en millisecondes, de l’heure de fin de la partie du segment intérieur de la plage de chronologie.

    Tableau 19. Paramètres
    Nom Type Description
    Aucun
    Tableau 20. Renvoie
    Type Description
    Numéro Heure de fin de la partie du segment intérieur du parcours de chronologie.

    Unité : Millisecondes

    TimelineSpan : getInnerSegmentStartTimeMs()

    Renvoie l’heure, en millisecondes, de l’heure de début de la partie du segment intérieur de la plage de chronologie.

    Tableau 21. Paramètres
    Nom Type Description
    Aucun
    Tableau 22. Renvoie
    Type Description
    Numéro Heure de début de la partie du segment intérieur du parcours de chronologie.

    Unité : Millisecondes

    TimelineSpan : getIsChanged()

    Renvoie un booléen qui spécifie si l’élément de chronologie actuel a été modifié ou non après l’initialisation.

    Tableau 23. Paramètres
    Nom Type Description
    Aucun
    Tableau 24. Renvoie
    Type Description
    Booléen Marqueur indiquant si le parcours actuel a été marqué comme modifié.
    Valeurs valides :
    • true : marqué comme modifié.
    • false : non marqué comme modifié.

    TimelineSpan : getPointIconClass()

    Renvoie une chaîne qui spécifie le nom de la classe d’icônes à utiliser pour afficher l’élément sur la chronologie si l’instance actuelle a une durée nulle.

    Tableau 25. Paramètres
    Nom Type Description
    Aucun
    Tableau 26. Renvoie
    Type Description
    Chaîne Nom de la classe d’icônes à utiliser pour afficher la plage de chronologie actuelle si la durée est égale à zéro.

    TimelineSpan : getPredecessors()

    Renvoie un tableau de tous les objets prédécesseurs associés à l’instance actuelle. Chaque objet de tableau est une HashMap qui contient une propriété predecessor_sys_id et relationship_sys_id .

    Tableau 27. Paramètres
    Nom Type Description
    Aucun
    Tableau 28. Renvoie
    Type Description
    Tableau d’objets Liste des HashMaps qui contiennent deux propriétés internes : predecessor_sys_id et relationship_sys_id.

    TimelineSpan : getSpanColor()

    Renvoie le nom de la chaîne de la couleur d’arrière-plan spécifiée pour l’affichage de ce parcours.

    Tableau 29. Paramètres
    Nom Type Description
    Aucun
    Tableau 30. Renvoie
    Type Description
    Chaîne Nom de la couleur HTML à utiliser comme couleur d’arrière-plan de l’élément.

    TimelineSpan : getSpanText()

    Renvoie la chaîne qui spécifie le texte à afficher à côté de l’élément time.

    Remarque :
    Ce texte s’affiche uniquement si l’objet GlideTimeline a activé le texte de chronologie défini à l’aide de la méthode glideTimeline.showTimelineText(true).
    Tableau 31. Paramètres
    Nom Type Description
    Aucun
    Tableau 32. Renvoie
    Type Description
    Chaîne Texte affiché à côté de l’élément.

    TimelineSpan : getStartTimeMs()

    Renvoie l’heure de début, en millisecondes, de l’objet TimelineSpan actuel.

    Tableau 33. Paramètres
    Nom Type Description
    Aucun
    Tableau 34. Renvoie
    Type Description
    Numéro Heure de début de l’élément.

    Unité : Millisecondes

    TimelineSpan : getSysId()

    Renvoie la sys_id de l’objet actuel.

    Cette méthode est utile pour renvoyer le sys_id lorsque l’instance d’objet actuelle a été créée sans sys_id spécifique afin d’obtenir le GUID généré dynamiquement.

    Tableau 35. Paramètres
    Nom Type Description
    Aucun
    Tableau 36. Renvoie
    Type Description
    Chaîne sys_id unique de l’élément actuel.

    TimelineSpan : getTable()

    Renvoie le nom de la table dans laquelle le sys_id est référencé.

    Tableau 37. Paramètres
    Nom Type Description
    Aucun
    Tableau 38. Renvoie
    Type Description
    Chaîne Nom de table.

    TimelineSpan : getTooltip()

    Renvoie le texte/HTML à afficher dans l’info-bulle lorsque l’élément TimelineSpan est survolé.

    Tableau 39. Paramètres
    Nom Type Description
    Aucun
    Tableau 40. Renvoie
    Type Description
    Chaîne Texte de l’info-bulle.

    TimelineSpan : setAllowXDragLeft(bFlag booléen)

    Définit un marqueur qui détermine si la date de début de l’élément peut être déplacée vers la gauche ou vers la droite, ajustant ainsi la durée de la tâche.

    L’effet de ce comportement est contrôlé par l’include de script qui gère l’événement approprié. La valeur par défaut de cette propriété est faux.

    Tableau 41. Paramètres
    Nom Type Description
    bMarqueur Booléen Marqueur indiquant si la date de début de l’élément peut être ajustée.
    Valeurs valides :
    • true : la date de début peut être ajustée.
    • faux : la date de début ne peut pas être ajustée.
    Tableau 42. Renvoie
    Type Description
    nul

    TimelineSpan : setAllowXDragRight(bFlag booléen)

    Définit un marqueur qui détermine si la date de fin de l’élément peut être déplacée vers la gauche ou vers la droite, ajustant ainsi la durée de la tâche.

    L’effet de ce comportement est contrôlé par l’include de script qui gère l’événement approprié. La valeur par défaut de cette propriété est faux.

    Tableau 43. Paramètres
    Nom Type Description
    bMarqueur Booléen Marqueur indiquant si la date de fin de l’élément peut être ajustée.
    Valeurs valides :
    • true : la date de fin peut être ajustée.
    • faux : la date de fin ne peut pas être ajustée.
    Tableau 44. Renvoie
    Type Description
    nul

    TimelineSpan : setAllowXMove(Boolean bFlag)

    Définit un marqueur qui détermine si l’élément peut être déplacé pour démarrer à un autre moment.

    L’effet de ce comportement est contrôlé par l’include de script qui gère l’événement approprié. La valeur par défaut de cette propriété est faux.

    Tableau 45. Paramètres
    Nom Type Description
    bMarqueur Booléen Marqueur indiquant si l’élément peut être déplacé horizontalement.
    Valeurs valides :
    • true : l’élément peut être déplacé horizontalement.
    • false : l’élément ne peut pas être déplacé horizontalement.
    Tableau 46. Renvoie
    Type Description
    nul

    TimelineSpan : setAllowYMove(Boolean bFlag)

    Définit un marqueur qui détermine si l’élément peut être déplacé verticalement sur la chronologie.

    L’effet de ce comportement est contrôlé par l’include de script qui gère l’événement approprié. La valeur par défaut de cette propriété est faux.

    Tableau 47. Paramètres
    Nom Type Description
    bMarqueur Booléen Marqueur indiquant si l’élément peut être déplacé verticalement.
    Valeurs valides :
    • true : l’élément peut être déplacé verticalement.
    • false : l’élément ne peut pas être déplacé verticalement.
    Tableau 48. Renvoie
    Type Description
    nul

    TimelineSpan : setAllowYMovePrédécesseur(bFlag booléen)

    Définit un marqueur qui détermine si une ligne de relation en pointillés peut être tracée à partir de cet élément de manière interactive sur la chronologie.

    L’effet de ce comportement est contrôlé par l’include de script qui gère l’événement approprié. La valeur par défaut de cette propriété est faux.

    Tableau 49. Paramètres
    Nom Type Description
    bMarqueur Booléen Marqueur indiquant si une ligne de relation en pointillés peut être tracée de l’objet actuel vers un nouveau successeur.
    Valeurs valides :
    • true : une ligne de relation en pointillés peut être tracée à partir de l’objet actuel vers un nouveau successeur.
    • false : impossible de tracer une ligne de relation en pointillés de l’objet actuel vers un nouveau successeur.
    Tableau 50. Renvoie
    Type Description
    nul

    TimelineSpan : setInnerSegmentClass(String styleClass)

    Définit le nom de la classe à utiliser pour styliser le segment intérieur, s’il existe.

    Tableau 51. Paramètres
    Nom Type Description
    Classe de style Chaîne Nom de la classe de couleurs à utiliser pour styliser le segment intérieur.
    Valeurs valides :
    • bleu
    • vert
    • argent
    Par défaut : vert
    Tableau 52. Renvoie
    Type Description
    nul

    TimelineSpan : setInnerSegmentTimeSpan(nombre startTimeMs, nombre endTimeMs)

    Crée un segment interne à afficher dans l’intervalle de temps actuel défini par la plage spécifiée.

    Tableau 53. Paramètres
    Nom Type Description
    startTimeMs Numéro Heure de début.

    Unité : Millisecondes
    endTimeMs Numéro Heure de fin.

    Unité : Millisecondes
    Tableau 54. Renvoie
    Type Description
    nul

    TimelineSpan : setPointIconClass(String iconClassName)

    Définit la classe d’icône à utiliser pour afficher l’élément actuel sur la chronologie si l’instance actuelle a une durée nulle.

    Remarque :
    Cela n’affecte que l’objet TimelineSpan actuel et sera prioritaire sur la defaultPointIconClass spécifiée par la GlideTimeline.
    Tableau 55. Paramètres
    Nom Type Description
    iconClassName Chaîne Classe d’icône à utiliser pour afficher l’élément actuel sur la chronologie si l’instance actuelle a une durée nulle.
    Valeurs valides :
    • black_circle
    • black_square
    • blue_circle
    • blue_square
    • green_circle
    • green_square
    • jalon
    • red_circle
    • red_square
    • sepia_circle
    • sepia_square
    Tableau 56. Renvoie
    Type Description
    nul

    TimelineSpan : setSpanColor(String strColor)

    Définit la couleur d’affichage de ce parcours.

    Tableau 57. Paramètres
    Nom Type Description
    strColor Chaîne Nom HTML de la couleur de ce parcours.
    Tableau 58. Renvoie
    Type Description
    nul

    TimelineSpan : setSpanText(String strSpanText)

    Définit le texte à afficher adjacent à l’élément de temps.

    Remarque :
    Ce texte s’affiche uniquement si l’objet GlideTimeline a activé le texte de chronologie défini à l’aide de la méthode glideTimeline.showTimelineText(true).
    Tableau 59. Paramètres
    Nom Type Description
    strSpanText Chaîne Texte à afficher à côté de l’élément d’heure.
    Tableau 60. Renvoie
    Type Description
    nul

    TimelineSpan : setTimeSpan(nombre nStartTime, nombre nEndTimeMs)

    Définit les dates de début et de fin du parcours actuel.

    Tableau 61. Paramètres
    Nom Type Description
    Heure de début Numéro Heure de début.

    Unité : Millisecondes
    nEndTimeMs Numéro Heure de fin.

    Unité : Millisecondes
    Tableau 62. Renvoie
    Type Description
    nul

    TimelineSpan : setTimeSpan(String strStartTime, String strEndTimeMs)

    Définit les heures de début et de fin du parcours actuel.

    Tableau 63. Paramètres
    Nom Type Description
    strStartTime Chaîne Heure de début.

    Unité : Millisecondes
    strEndTimeMs Chaîne Heure de fin.

    Unité : Millisecondes
    Tableau 64. Renvoie
    Type Description
    nul

    TimelineSpan : setTooltip(String strTooltipText)

    Définit le texte à afficher dans l’info-bulle lorsque l’élément TimelineSpan est survolé.

    Tableau 65. Paramètres
    Nom Type Description
    strTooltipText Chaîne Texte à afficher dans l’info-bulle.
    Remarque :
    Vous pouvez spécifier du code HTML valide dans cette chaîne.
    Tableau 66. Renvoie
    Type Description
    nul