Diagram Document Object Model

Pages provide individual workspaces within a drawing. Each page can contain shapes, connectors, and guides that assist with positioning and alignment.

Page items can be organized into multiple layers, making complex diagrams easier to manage.

There are two page types: foreground and background. Foreground pages contain the main diagram content. Background pages provide reusable elements, such as borders, logos, and titles, that appear behind the content of the foreground pages to which they are assigned. Changes to a shared background are reflected in all pages that use it.

Foreground and background pages are visually distinguished in the Page Navigator and Drawing Explorer. The Page Navigator provides quick access to pages, while the Drawing Explorer presents a hierarchical view of pages and their contents.

Groups are shapes that contain other shapes, allowing related elements to be moved, resized, and rotated as a single unit. They are useful for building composite symbols and organizing complex diagram content.

When a group is resized, each contained 2D shape follows one of two resize modes:

• Resize and Reposition changes both the shape's size and its position within the group.
• Reposition Only changes the shape's position within the group while preserving its size.

Contained 1D shapes are scaled by transforming their beginning and end points with the group.

Layers organize page items into named categories, making complex diagrams easier to manage. Each page has its own layers, and items can belong to multiple layers.

Users can show or hide layers, control whether their items are printed or exported, and lock them to prevent accidental editing. Additional options control snapping, gluing, and color highlighting, helping users identify and work with related content.

Layers can be marked as active so that shapes dropped onto the page are automatically assigned to them, simplifying organization as the diagram is built.