DrawingFrame Class

An instance of the DrawingFrame class represents a drawing and its layout in a Text Control document. A drawing can be positioned in the document like an image or a textframe, either geometrically or as a single character. Geometrically its position can either be relative to a paragraph to which it is anchored or relative to the complete document. The DrawingFrame class handles the positioning of the drawing in the document. A drawing frame is always associated with a drawing control of the type TXTextControl.Drawing.TXDrawingControl or TXTextControl.WPF.Drawing.TXDrawingControl. This drawing control handles the appearance and the data of the drawing. A drawing control can be activated so that its contents can be edited. Activation occurs either through a mouse double-click or through programming code with the Activate method. All drawings in a document are contained in a DrawingCollection. The collection can also be used to add drawings to or to remove drawings from the document. The drawing collection can be obtained through the TextControl.Drawings, WPF.TextControl.Drawings or ServerTextControl.Drawings property.

Syntax

• C#
• VB.NET

​public class DrawingFrame : FrameBase

​Public Class DrawingFrame
  Inherits FrameBase

Examples

The following example shows how to use the TXTextControl.DataVisualization.DrawingFrame class.

• C#
• VB.NET

​TXTextControl.Drawing.TXDrawingControl myDrawingControl = new TXTextControl.Drawing.TXDrawingControl();
TXTextControl.DataVisualization.DrawingFrame drawingFrame = new TXTextControl.DataVisualization.DrawingFrame(myDrawingControl);

drawingFrame.Activate();
drawingFrame.ExportCompressionQuality = 100;
drawingFrame.ExportFileName = "";
drawingFrame.ExportFilterIndex = 1;
drawingFrame.ExportResolution = 100;
drawingFrame.SaveMode = TXTextControl.ImageSaveMode.Auto;

textControl1.Drawings.Add(drawingFrame, -1);

​Dim myDrawingControl As TXTextControl.Drawing.TXDrawingControl = New TXTextControl.Drawing.TXDrawingControl()
Dim drawingFrame As TXTextControl.DataVisualization.DrawingFrame = New TXTextControl.DataVisualization.DrawingFrame(myDrawingControl)

drawingFrame.Activate() ' here, the Activate method is used
drawingFrame.ExportCompressionQuality = 100
drawingFrame.ExportFileName = ""
drawingFrame.ExportFilterIndex = 1
drawingFrame.ExportResolution = 100
drawingFrame.SaveMode = TXTextControl.ImageSaveMode.Auto

textControl1.Drawings.Add(drawingFrame, -1)

Constructors

Methods

Properties