11. Two fixed levels containers

Run containers fixed in two levels

• Example UI

  
  There are two container levels, the first level Pairing, the second level Duty.
  The container can be added from popup menu on right click to the box. The container can be removed or boxes in the container can be deleted from popup menu on right click to the container.
  Dragging box or container will remove it from its container and place it to new container.
  Dragging with shift horizontally preserves the box or container position in parent containers. Dragging with shift vertically to another row preserves its horizontal position.
  The dragged box or container will be dropped to the hovered container (with red border) or to the container of the hovered box.
  Dragging with ctrl will copy the box, selected boxes or container.
  Dragging with right mouse button will select area of boxes. Dragging with right mouse button in header will select area of boxes in selected or focused rows.
  Dragging with shift and right mouse button will move the box or container out of its parent container.
  Dragging with ctrl and right mouse button will copy the box or container without its parent container.
  Dragging container edge in the 4th row will resize the container.
  Ctrl + click deletes the box or container. Double click selects or unselects the run box or container. All boxes can be selected or unselected in right click popup menu.
  All actions can be fully customized - assigned to different events.
  The box text shows: box identification (one letter), colon, Pairing container with index, dot, Duty container with index. Box not in any container shows question mark. Generated by API OnGetGanttRunText.

• Container definition

  
  The containers have no specific definition, they are defined per run box, in 15th attribute Container of GanttRun.
  The Container attribute can contain more containers, dot separated. To have fixed container levels, let the unused container position empty, e.g. Containers:".X...Y".
  The container name consist from two parts, type and id, separated by @, e.g "X@1". For fixed levels containers the type is usually one different per level and id differs the containers on the same level.
  The container name must be unique within one cell. All boxes with the same container name are placed to the same container.
  The container size is always exactly to accommodate all its boxes.
  

• Dragging containers

  
  Containers can be dragged like single boxes. When the container is dragged, it moves all its boxes (and inner containers).
  How the boxes and containers are dropped to destination container or empty place is controlled by GanttRunAdjust attribute.
  Add flag "Containers" to the GanttRunAdjust to control the containers when the box is dropped. If the flag "Containers" is not set, the boxes and containers are dropped unchanged, with their actual Containers value.
  For fixed level containers add also "ContainersLevels" and "ContainersUnique" to GanttRunAdjust to preserve the nesting levels and make the container unique when dropping.
  Possibly add also "ContainersMerge" to GanttRunAdjust to merge containers on the same or higher levels to make the dropping more easy.
  Possibly add also "ContainersDelete" to GanttRunAdjust to delete original containers when dropped to lower container levels or empty place. It is not set in this sample.
  The containers can be copied by dragging similarly to copying boxes by adding "Copy" to GanttRunMove instead of "Move" or "Slide".
  

• Adding, deleting and disabling containers

  
  The containers can be controlled in three ways: from right click popup menu, by single actions or by API.
  For fixed level containers define containers GanttRunContainers (for adding and changing container) with assigned levels to the container names (by dot), to be added or changed only on assigned level.
  
  • In popup menu on box there are items to control the container: AddGanttRunContainer (adds new container to the box).
    In popup menu on container there are items to control the container: DelGanttRunContainerOnly (delete the container only, remove it from its boxes Containers attribute), ChooseGanttRunContainer (change container type).
    In popup menu on container there are items to control boxes in the container: DelGanttRunContainer (delete all boxes in the container and the container itself), ChooseGanttRunContainerType (change all boxes in container), DisableGanttRunContainer (disable all boxes in container), LockGanttRunContainer (lock all boxes), EnableGanttRunContainer (enable all boxes).
    
  • Actions for container: DeleteGanttRunContainerOnly (delete the container only, remove it from its boxes Containers attribute), DeleteGanttRunContainer (delete all boxes and the container itself), ChooseGanttRunContainer (change container type).
    Actions for box: AddGanttRunContainer (adds new container to the box).
    
  • API for adding, changing, deleting and disabling containers is described in documentation. It contains also API to get all actual containers.
    

• Resizing containers and empty space around

  
  The containers can define their edges different from their edge boxes by hidden box of Type Edge. The Edge type box can be only on container edge and must not be joined to another box.
  If the container has Edge type box on its edge or if set GanttRunContainersResize='2' it can be resized by mouse dragging. Its size can be freely increased and it can be decreased to the first box on the edge.
  If the container has Edge type boxes on its edges, it can be also empty without any other boxes, except if set GanttRunContainersDelete='3'.