Vertical Layout Mode Overview

Vertical Layout mode is a quick and easy way to populate Envision documents with contents. You need to provide a page configuration and object items. The system places these object items one after another on automatically created pages.

The Vertical Layout mode workflow is the following:

1. Prepare and group object items into document sections and subsections.

2. Initiate the mode with the StartLayout(config: EvVLayoutConfig): Promise<void> function, passing the configuration of an automatically added page.

3. Add object items that should constitute the first subsection of the first section with the AddObjects(objs: EvItem[]): Promise<void> function.

4. The system places object items on the active layer below each other starting from the top of the current page. If an object item reaches the page height, the system automatically adds a new page and continues placing object items from the top of that new page, and so on. If an object item is higher than the page, the system automatically adjusts the page height to accommodate such an object item.

5. If you need to add an extra vertical space between two object items, like to separate subsections, call the AddSpace(size: number): Promise<void> function before placing the following object item.

6. If you need to place object items on a new page explicitly, like to start a new document section, call the AddPage(name?: string, title?: string): Promise<EvItem> function.

7. Repeat steps 3–6 for the rest of the document sections and subsections.

8. Once all the object items are added, quit Vertical Layout mode with the FinishLayout(): Promise<void> function.

The added object items are centered horizontally on the page. Horizontal object item arrangements are not supported in Vertical Layout mode. However, there are no restrictions on moving the added object items after quitting Vertical Layout mode.