Document Editor · Editing Features

Drawings and Shapes

Insert and edit Word-compatible drawings and shapes.

Live Drawing API

Inspect drawings as document objects

Select the sample drawing to inspect its frame. Double-click inside it to switch from positioning the canvas to editing its individual shapes.

One canvas, multiple shapes

The drawing frame participates in the document; the shapes live inside that frame.

Show drawing boundariesKeep marker lines visible around borderless drawings.

Drawing canvases in this document

Choose a canvas here or select its border directly in the editor.

Reading...

Reading the drawing frames...

Select the drawingClick its outer border in the editor to inspect the complete drawing frame.

Two editing modes

The pointer location determines whether TX Text Control edits the frame or its contents.

Click the borderSelect, move, resize, wrap, or align the complete drawing.

Double-click insideActivate the canvas to edit and format its individual shapes.

What this demonstrates

A drawing is a canvas inside the document

Word-compatible shapes are stored together in a drawing frame. TX Text Control separates the frame's document layout from the editable drawing content, so the complete canvas moves through text as one object while every shape remains editable.

Drawing lifecycle

drawingSelected / drawingActivated

Frame access

TXTextControl.frames.getItem

Frame geometry

FrameBase.getSize / setSize

Accessibility

FrameBase.getDescriptiveText / setDescriptiveText

How it works

The drawingSelected event reports a DrawingEventArgs object. Its drawingFrame property is a lightweight FrameInfo containing the drawing's ID, name, location, and text position. The demo passes that ID to TXTextControl.frames.getItem to retrieve the live FrameBase.

The frame owns layout properties such as getSize, getLocation, getInsertionMode, and getAlignment. Updating setSize, setMoveable, or setSizeable changes how the complete canvas behaves in the document without flattening or altering its shapes.

Selection and activation are intentionally different. A selected drawing exposes its outer frame for document layout. An activated drawing passes input to its internal drawing canvas, where the built-in contextual tools edit shape type, fill, outline, geometry, and z-order.

TXTextControl.setDrawingMarkerLines controls non-printing boundaries around borderless drawings. The marker helps authors find the canvas while editing but is never part of the saved or printed document.