All Implemented Interfaces:
HasHandlers

public class Lane extends RefDataClass
Lane shown in a Timeline view, or in a day view when showDayLanes is true. Each lane is a row or column, respectively, that can contain a set of CalendarEvents. CalendarEvents are placed in lanes by matching the name property to the value of the Calendar.laneNameField property on the CalendarEvent.

Lanes are typically used to show tasks assigned to different people, broadcasts planned for different channels, and similar displays.

  • Constructor Details

  • Method Details

    • getOrCreateRef

      public static Lane getOrCreateRef(JavaScriptObject jsObj)
    • setEventStyleName

      public Lane setEventStyleName(String eventStyleName)
      The base name for the CSS class applied to events when they're rendered in this lane. See Calendar.eventStyleName.

      If set directly on a sublane, overrides the corresponding value on the parent lane. See getEventCanvasStyle() for more information.

      Parameters:
      eventStyleName - New eventStyleName value. Default value is null
      Returns:
      Lane instance, for chaining setter calls
      See Also:
    • getEventStyleName

      public String getEventStyleName()
      The base name for the CSS class applied to events when they're rendered in this lane. See Calendar.eventStyleName.

      If set directly on a sublane, overrides the corresponding value on the parent lane. See getEventCanvasStyle() for more information.

      Returns:
      Current eventStyleName value. Default value is null
      See Also:
    • setFieldStyleName

      public Lane setFieldStyleName(String fieldStyleName)
      The base style-name for lane-fields displayed in this Lane.
      Parameters:
      fieldStyleName - New fieldStyleName value. Default value is null
      Returns:
      Lane instance, for chaining setter calls
      See Also:
    • getFieldStyleName

      public String getFieldStyleName()
      The base style-name for lane-fields displayed in this Lane.
      Returns:
      Current fieldStyleName value. Default value is null
      See Also:
    • setHeight

      public Lane setHeight(Integer height)
      In Timelines, the height of this Lane's row. Has no effect when set on a Lane being displayed in a day view as a result of Calendar.showDayLanes being true.

      If set directly on a sublane, overrides the default behavior of dividing the height equally among the lane's sublanes. Each sublane is still initially assigned an equal slice of the parent height, and the value for this sublane is then updated. So the overall height of the parent lane will change by the delta between the initial slice and the specified one.

      Parameters:
      height - New height value. Default value is null
      Returns:
      Lane instance, for chaining setter calls
    • getHeight

      public Integer getHeight()
      In Timelines, the height of this Lane's row. Has no effect when set on a Lane being displayed in a day view as a result of Calendar.showDayLanes being true.

      If set directly on a sublane, overrides the default behavior of dividing the height equally among the lane's sublanes. Each sublane is still initially assigned an equal slice of the parent height, and the value for this sublane is then updated. So the overall height of the parent lane will change by the delta between the initial slice and the specified one.

      Returns:
      Current height value. Default value is null
    • setName

      public Lane setName(String name)
      To determine whether a CalendarEvent should be placed in this lane, the value of this attribute is compared with the Calendar.laneNameField property on the CalendarEvent.
      Parameters:
      name - New name value. Default value is null
      Returns:
      Lane instance, for chaining setter calls
    • getName

      public String getName()
      To determine whether a CalendarEvent should be placed in this lane, the value of this attribute is compared with the Calendar.laneNameField property on the CalendarEvent.
      Returns:
      Current name value. Default value is null
    • setStyleName

      public Lane setStyleName(String styleName)
      The base style-name for normal cells in this Lane.
      Parameters:
      styleName - New styleName value. Default value is null
      Returns:
      Lane instance, for chaining setter calls
      See Also:
    • getStyleName

      public String getStyleName()
      The base style-name for normal cells in this Lane.
      Returns:
      Current styleName value. Default value is null
      See Also:
    • setSublanes

      public Lane setSublanes(Lane... sublanes)
      Array of Lane objects that will share the available space in the parent Lane, vertically in timelines and horizontally in day views.

      Only one level of sublanes is supported, so this attribute only has an effect on top-level lanes.

      Note that this feature is mutually exclusive with the auto arrangement of events that share time.

      Parameters:
      sublanes - New sublanes value. Default value is null
      Returns:
      Lane instance, for chaining setter calls
    • getSublanes

      public Lane[] getSublanes()
      Array of Lane objects that will share the available space in the parent Lane, vertically in timelines and horizontally in day views.

      Only one level of sublanes is supported, so this attribute only has an effect on top-level lanes.

      Note that this feature is mutually exclusive with the auto arrangement of events that share time.

      Returns:
      Current sublanes value. Default value is null
    • setTitle

      public Lane setTitle(String title)
      Title to show for this lane. Has no effect if set directly on sublanes.
      Parameters:
      title - New title value. Default value is null
      Returns:
      Lane instance, for chaining setter calls
      See Also:
    • getTitle

      public String getTitle()
      Title to show for this lane. Has no effect if set directly on sublanes.
      Returns:
      Current title value. Default value is null
      See Also:
    • setWidth

      public Lane setWidth(Integer width)
      When set on a Lane being displayed in a day view as a result of Calendar.showDayLanes being set, dictates the width of the Lane's column. Has no effect in Timelines.

      If set directly on a sublane, overrides the default behavior of dividing the width equally among the lane's sublanes. Each sublane is still initially assigned an equal slice of the original parent width, and the value for this sublane is then updated. So the overall width of the parent lane will change by the delta between the initial slice and the specified one.

      Parameters:
      width - New width value. Default value is null
      Returns:
      Lane instance, for chaining setter calls
    • getWidth

      public Integer getWidth()
      When set on a Lane being displayed in a day view as a result of Calendar.showDayLanes being set, dictates the width of the Lane's column. Has no effect in Timelines.

      If set directly on a sublane, overrides the default behavior of dividing the width equally among the lane's sublanes. Each sublane is still initially assigned an equal slice of the original parent width, and the value for this sublane is then updated. So the overall width of the parent lane will change by the delta between the initial slice and the specified one.

      Returns:
      Current width value. Default value is null