TimelineSpan : Global

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 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 chronologie.

    Étant donné qu’il est extrêmement important que toute la collection de parcours d’un élément de chronologie 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 chronologie existante.

    TimelineSpan : addPredecessor(Object Array objArray)

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

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

    Tableau 1. Paramètres
    Nom Type Description
    Tableau obj Tableau d’objets Tableau d’objets JavaScript contenant 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 une fenêtre 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 de la relation.
    strTableName Chaîne Nom de la table pour la relation.
    Tableau 4. Renvoie
    Type Description
    nul

    TimelineSpan : addPredecessor(String strPredecessorSysId, String strRelationshipSysId)

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

    Aucun gestionnaire de double-clic n’est associé à la ligne dessiné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 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.
    • false : 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 :
    • vrai : l’objet peut être déplacé horizontalement.
    • false : 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 :
    • vrai : l’objet peut être déplacé verticalement.
    • false : l’objet ne peut pas être déplacé verticalement.

    TimelineSpan : getAllowYMovePredecessor()

    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 la 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 de l’objet actuel à un nouveau successeur.
    • false : une ligne de relation en pointillés ne peut pas être tracée de l’objet actuel à un nouveau successeur.

    TimelineSpan : getInnerSegmentClass()

    Renvoie le nom de la classe de segment interne actuelle pour le parcours chronologique.

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

    TimelineSpan : getInnerSegmentEndTimeMs()

    Renvoie l’heure, en millisecondes, de l’heure de fin de la partie du segment interne du parcours de chronologie.

    Tableau 19. Paramètres
    Nom Type Description
    Aucun
    Tableau 20. Renvoie
    Type Description
    Numéro Heure de fin de la portion de segment interne de parcours de chronologie.

    Unité : millisecondes

    TimelineSpan : getInnerSegmentStartTimeMs()

    Renvoie l’heure en millisecondes de l’heure de début de la partie du segment interne du parcours 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 interne du parcours de chronologie.

    Unité : millisecondes

    TimelineSpan : getIsChanged()

    Renvoie une valeur booléenne qui indique si l’élément de chronologie actuel a été modifié 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 :
    • vrai : marqué comme changé.
    • faux : non marqué comme changé.

    TimelineSpan : getPointIconClass()

    Renvoie une chaîne qui spécifie le nom de la classe d’icône à 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ône à utiliser pour afficher le parcours de chronologie actuel 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 cartes de hachage qui contiennent deux propriétés internes : predecessor_sys_id et relationship_sys_id.

    TimelineSpan : getSpanColor()

    Renvoie le nom de 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 couleur HTML à utiliser comme couleur d’arrière-plan pour l’élément.

    TimelineSpan : getSpanText()

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

    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 le 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 pour 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 où 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 d’info-bulle.

    TimelineSpan : setAllowXDragLeft(booléen bFlag)

    Définit un marqueur qui détermine si la date de début de l’élément peut être glissée vers la gauche ou 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 :
    • vrai : 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(booléen bFlag)

    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 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 :
    • vrai : 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(Marqueur booléen)

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

    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 :
    • vrai : 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(booléen 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 :
    • vrai : 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 : setAllowYMovePredecessor(Boolean bFlag)

    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 la 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 de l’objet actuel à un nouveau successeur.
    • false : une ligne de relation en pointillés ne peut pas être tracée de l’objet actuel à 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 interne, s’il existe.

    Tableau 51. Paramètres
    Nom Type Description
    classe de style Chaîne Nom de la classe de couleur à utiliser pour styliser le segment interne.
    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 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 à côté de l’élément de temps.

    Remarque :
    Ce texte s’affiche uniquement si l’objet GlideTimeline a activé la configuration du texte de chronologie à 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 de temps.
    Tableau 60. Renvoie
    Type Description
    nul

    TimelineSpan : setTimeSpan(Number nStartTime, Number nEndTimeMs)

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

    Tableau 61. Paramètres
    Nom Type Description
    nStartTime 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