Span de tempo - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura

    • . Span de tempo A API fornece métodos para definir um conjunto de propriedades que descrevem as características e o comportamento interativo de um elemento renderizado em um item de linha do tempo.

    Como é extremamente importante que toda a coleção de períodos de um item de linha do tempo seja exclusiva, a criação de uma nova instância deve ser realizada usando CreateTimelineItem() Método de uma instância de Item de linha do tempo existente.

    TimelineSpan - addPredecessor(Object Array objArray)

    Adiciona vários relacionamentos entre a instância atual e outros objetos TimelineSpan enumerando por meio da matriz de objetos JavaScript.

    Cada objeto deve ter uma propriedade interna relationship_sys_ide. predecessor_sys_idespecificado.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    ObjArray Matriz de objetos Matriz de objeto JavaScript que contém duas propriedades internas: relationship_sys_ide. predecessor_sys_id.
    Tabela 2. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - addPredecessor(cadeia de caracteres strPredecessorSysId , cadeia de caracteres strRelationshipSysId, cadeia de caracteres strTableName )

    Adiciona o relacionamento especificado entre a instância atual e outra Span de tempo e permite que o relacionamento abra um GlideWindow para exibir informações sobre o relacionamento.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    StrPredecessorSysId Cadeia de caracteres Sys_id do registro de tarefa planejada que é o antecessor do relacionamento.
    StrRelationshipSysId Cadeia de caracteres Sys_id do registro de relacionamento do relacionamento.
    StrTableName Cadeia de caracteres Nome da tabela do relacionamento.
    Tabela 4. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - addPredecessor(cadeia de caracteres strPredecessorSysId, cadeia de caracteres strRelationshipSysId)

    Adiciona o relacionamento especificado entre a instância atual e outro período de linha do tempo com sys_id strPredecessorSysId.

    A linha desenhada não terá manipuladores de clique duplo associados a ela.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    StrPredecessorSysId Cadeia de caracteres Sys_id do registro de tarefa planejada que é o antecessor do relacionamento.
    StrRelationshipSysId Cadeia de caracteres Sys_id do registro de relacionamento do relacionamento.
    Tabela 6. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - getAllowXDragLeft()

    Retorna o valor booliano de AllowXDragLeftpropriedade.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se a hora de início do objeto pode ser ajustada.
    Valores válidos:
    • Verdadeiro: A hora de início do objeto pode ser ajustada.
    • Falso: A hora de início do objeto não pode ser ajustada.

    TimelineSpan - getAllowXDragRight()

    Retorna o valor booliano de AllowXDragRightpropriedade.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se a hora de término do objeto pode ser ajustada.
    Valores válidos:
    • Verdadeiro: A hora de término do objeto pode ser ajustada.
    • Falso: A hora de término do objeto não pode ser ajustada.

    TimelineSpan - getAllowXMove()

    Retorna o valor booliano de AllowXMovepropriedade.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 12. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se o objeto pode ser movido horizontalmente.
    Valores válidos:
    • Verdadeiro: O objeto pode ser movido horizontalmente.
    • Falso: O objeto não pode ser movido horizontalmente.

    TimelineSpan - getAllowYMove()

    Retorna o valor booliano de AllowYMovepropriedade.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 14. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se o objeto pode ser movido verticalmente.
    Valores válidos:
    • Verdadeiro: O objeto pode ser movido verticalmente.
    • Falso: O objeto não pode ser movido verticalmente.

    TimelineSpan - getAllowYMovePredecessor()

    Retorna o valor booliano de AllowYMovePredecessorpropriedade.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 16. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se uma linha de relacionamento tracejada pode ser desenhada do objeto atual para um novo sucessor.
    Valores válidos:
    • Verdadeiro: A linha de relacionamento tracejada pode ser desenhada do objeto atual para um novo sucessor.
    • Falso: A linha de relacionamento tracejada não pode ser extraída do objeto atual para um novo sucessor.

    TimelineSpan - getInnerSegmentClass()

    Retorna o nome da classe de segmento interno atual para o período da linha do tempo.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 18. Retorna
    Tipo Descrição
    Cadeia de caracteres Nome da classe do estilo de segmento interno atual.

    TimelineSpan - getInnerSegmentEndTimeMs()

    Retorna o tempo em milissegundos da hora de término da parte do segmento interno do período da linha do tempo.

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 20. Retorna
    Tipo Descrição
    Número Hora de término da parte do segmento interno do período da linha do tempo.

    Unidade: Milissegundos

    TimelineSpan - getInnerSegmentStartTimeMs()

    Retorna o tempo em milissegundos da hora de início da parte do segmento interno do período da linha do tempo.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 22. Retorna
    Tipo Descrição
    Número Hora de início da parte do segmento interno do período da linha do tempo.

    Unidade: Milissegundos

    TimelineSpan - getIsChanged()

    Retorna um booliano que especifica se o item da linha do tempo atual foi modificado ou não após a inicialização.

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 24. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se o período atual foi marcado como alterado.
    Valores válidos:
    • Verdadeiro: Marcado como alterado.
    • Falso: Não marcado como alterado.

    TimelineSpan - getPointIconClass()

    Retorna uma cadeia de caracteres que especifica o nome da classe de ícone a ser usada para exibir o elemento na linha do tempo se a instância atual tiver duração zero.

    Tabela 25. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 26. Retorna
    Tipo Descrição
    Cadeia de caracteres Nome da classe de ícone a ser usada para exibir o período da linha do tempo atual se a duração for zero.

    TimelineSpan - getPredecessors()

    Retorna uma matriz de todos os objetos predecessores associados à instância atual. Cada objeto de matriz é um HashMap que contém um predecessor_sys_id e. relationship_sys_id propriedade.

    Tabela 27. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 28. Retorna
    Tipo Descrição
    Matriz de objetos Lista de HashMaps que contêm duas propriedades internas: predecessor_sys_id e. relationship_sys_id .

    TimelineSpan - getSpanColor()

    Retorna o nome da cadeia de caracteres da cor de fundo especificada para exibir este período.

    Tabela 29. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 30. Retorna
    Tipo Descrição
    Cadeia de caracteres Nome da cor HTML a ser usada como cor de fundo do elemento.

    TimelineSpan - getSpanText()

    Retorna a cadeia de caracteres que especifica o texto a ser exibido ao lado do elemento tempo.

    Nota:
    Este texto será exibido somente se o objeto GlideTimeline tiver habilitado o texto da linha do tempo definido usando GlideTimelineText.showTimelineText(verdadeiro) método.
    Tabela 31. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 32. Retorna
    Tipo Descrição
    Cadeia de caracteres Texto exibido ao lado do elemento.

    TimelineSpan - getStartTimeMs()

    Retorna a hora de início em milissegundos do objeto TimelineSpan atual.

    Tabela 33. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 34. Retorna
    Tipo Descrição
    Número Hora de início do elemento.

    Unidade: Milissegundos

    TimelineSpan - getSysId()

    Retorna o sys_id do objeto atual.

    Este método é útil para retornar o sys_id quando a instância do objeto atual foi criada sem um sys_id específico para obter o GUID gerado dinamicamente.

    Tabela 35. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 36. Retorna
    Tipo Descrição
    Cadeia de caracteres Sys_id exclusivo do elemento atual.

    TimelineSpan - getTable()

    Retorna o nome da tabela em que o sys_id é referenciado.

    Tabela 37. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 38. Retorna
    Tipo Descrição
    Cadeia de caracteres Nome da tabela.

    TimelineSpan - getTooltip()

    Retorna o texto/html a ser exibido na dica da ferramenta quando o elemento TimelineSpan está sendo passado.

    Tabela 39. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 40. Retorna
    Tipo Descrição
    Cadeia de caracteres Texto de dica da ferramenta.

    TimelineSpan - setAllowXDragLeft(boolian bFlag)

    Define um sinalizador que determina se a data de início do elemento pode ser arrastada para a esquerda ou para a direita, ajustando a duração da tarefa.

    O efeito desse comportamento é controlado pela inclusão de script que lida com o evento apropriado. O valor padrão desta propriedade é falso.

    Tabela 41. Parâmetros
    Nome Tipo Descrição
    BSinalizador Booliano Sinalizador que indica se a data de início do elemento pode ser ajustada.
    Valores válidos:
    • Verdadeiro: A data de início pode ser ajustada.
    • Falso: A data de início não pode ser ajustada.
    Tabela 42. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setAllowXDragRight(bFlag booliano)

    Define um sinalizador que determina se a data de término do elemento pode ser arrastada para a esquerda ou para a direita, ajustando a duração da tarefa.

    O efeito desse comportamento é controlado pela inclusão de script que lida com o evento apropriado. O valor padrão desta propriedade é falso.

    Tabela 43. Parâmetros
    Nome Tipo Descrição
    BSinalizador Booliano Sinalizador que indica se a data de término do elemento pode ser ajustada.
    Valores válidos:
    • Verdadeiro: A data de término pode ser ajustada.
    • Falso: A data de término não pode ser ajustada.
    Tabela 44. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setAllowXMove(bFlag booliano )

    Define um sinalizador que determina se o elemento pode ser movido para iniciar em um horário diferente.

    O efeito desse comportamento é controlado pela inclusão de script que lida com o evento apropriado. O valor padrão desta propriedade é falso.

    Tabela 45. Parâmetros
    Nome Tipo Descrição
    BSinalizador Booliano Sinalizador que indica se o elemento pode ser movido horizontalmente.
    Valores válidos:
    • Verdadeiro: O elemento pode ser movido horizontalmente.
    • Falso: O elemento não pode ser movido horizontalmente.
    Tabela 46. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setAllowYMove(bFlag booliano )

    Define um sinalizador que determina se o elemento pode ser arrastado verticalmente na linha do tempo.

    O efeito desse comportamento é controlado pela inclusão de script que lida com o evento apropriado. O valor padrão desta propriedade é falso.

    Tabela 47. Parâmetros
    Nome Tipo Descrição
    BSinalizador Booliano Sinalizador que indica se o elemento pode ser movido verticalmente.
    Valores válidos:
    • Verdadeiro: O elemento pode ser movido verticalmente.
    • Falso: O elemento não pode ser movido verticalmente.
    Tabela 48. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setAllowYMovePredecessor (bFlag booliano)

    Define um sinalizador que determina se uma linha de relacionamento tracejada pode ser desenhada a partir deste elemento interativamente na linha do tempo.

    O efeito desse comportamento é controlado pela inclusão de script que lida com o evento apropriado. O valor padrão desta propriedade é falso.

    Tabela 49. Parâmetros
    Nome Tipo Descrição
    BSinalizador Booliano Sinalizador que indica se uma linha de relacionamento tracejada pode ser desenhada do objeto atual para um novo sucessor.
    Valores válidos:
    • Verdadeiro: A linha de relacionamento tracejada pode ser desenhada do objeto atual para um novo sucessor.
    • Falso: A linha de relacionamento tracejada não pode ser extraída do objeto atual para um novo sucessor.
    Tabela 50. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setInnerSegmentClass(cadeia de caracteres styleClass)

    Define o nome da classe a ser usada para estilizar o segmento interno, se ele existir.

    Tabela 51. Parâmetros
    Nome Tipo Descrição
    StyleClass Cadeia de caracteres Nome da classe de cor a ser usada para estilizar o segmento interno.
    Valores válidos:
    • azul
    • verde
    • prata
    Padrão: Verde
    Tabela 52. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setInnerSegmentTimeSpan(Number startTimeMs, number endTimeMs )

    Cria um segmento interno para mostrar dentro do intervalo de tempo atual definido pelo intervalo especificado.

    Tabela 53. Parâmetros
    Nome Tipo Descrição
    StartTimeMs Número Hora de início.

    Unidade: Milissegundos
    EndTimeMs Número Hora de término.

    Unidade: Milissegundos
    Tabela 54. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setPointIconClass(cadeia de caracteres iconClassName )

    Define a classe de ícone a ser usada para exibir o elemento atual na linha do tempo se a instância atual tiver duração zero.

    Nota:
    Isso afeta somente a atual Span de tempo o objeto e terão precedência sobre DefaultPointIconClass especificado por GlideTimeline .
    Tabela 55. Parâmetros
    Nome Tipo Descrição
    IconClassName Cadeia de caracteres Classe de ícone a ser usada para exibir o elemento atual na linha do tempo se a instância atual tiver duração zero.
    Valores válidos:
    • black_circle
    • black_square
    • blue_circle
    • blue_square
    • green_circle
    • green_square
    • marco
    • red_circle
    • red_square
    • sépia_circle
    • sépia_square
    Tabela 56. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setSpanColor(cadeia de caracteres strColor)

    Define a cor para exibir este período.

    Tabela 57. Parâmetros
    Nome Tipo Descrição
    StrColor Cadeia de caracteres Nome HTML da cor deste período.
    Tabela 58. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setSpanText(cadeia de caracteres strSpanText)

    Define o texto a ser exibido ao lado do elemento tempo.

    Nota:
    Este texto será exibido somente se o objeto GlideTimeline tiver habilitado o conjunto de texto da linha do tempo usando GlideTimelineText.showTimelineText(verdadeiro) método.
    Tabela 59. Parâmetros
    Nome Tipo Descrição
    StrSpanText Cadeia de caracteres Texto a ser exibido ao lado do elemento tempo.
    Tabela 60. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setTimeSpan(number nStartTime, number nEndTimeMs)

    Define as datas de início e término do período atual.

    Tabela 61. Parâmetros
    Nome Tipo Descrição
    NStartTime Número Hora de início.

    Unidade: Milissegundos
    NEndTimeMs Número Hora de término.

    Unidade: Milissegundos
    Tabela 62. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setTimeSpan(cadeia de caracteres strStartTime, cadeia de caracteres strEndTimeMs)

    Define as horas de início e término do período atual.

    Tabela 63. Parâmetros
    Nome Tipo Descrição
    StrStartTime Cadeia de caracteres Hora de início.

    Unidade: Milissegundos
    StrEndTimeMs Cadeia de caracteres Hora de término.

    Unidade: Milissegundos
    Tabela 64. Retornos
    Tipo Descrição
    vazio

    TimelineSpan - setTooltip(cadeia de caracteres strTooltipText)

    Define o texto a ser exibido na dica da ferramenta quando o elemento TimelineSpan está sendo passado.

    Tabela 65. Parâmetros
    Nome Tipo Descrição
    StrTooltipText Cadeia de caracteres Texto a ser exibido na dica da ferramenta.
    Nota:
    Você pode especificar HTML válido nesta cadeia de caracteres.
    Tabela 66. Retornos
    Tipo Descrição
    vazio