ImageGear .NET
Drawing

The DrawingML Main namespace of the Office Open XML defines all of the base constructs for all kinds of DrawingML objects (charts, diagrams, shapes, pictures, and so on). Within a WordprocessingML document, it is possible to include graphical DrawingML objects:

VML (Vector Markup Language) is a format deprecated by ECMA OpenXML Specification. However, it is in use for drawing by Microsoft Word and ImageGear supports VML drawing too. VML drawing objects may be located in the VML groups. ImageGear supports such groups with any nested level.

The following objects are supported by ImageGear:

Object

Supported Types

Comment

Picture

Embedded picture

ImageGear supports only embedded into WordprocessingML package images – no any external links.

Line

Following line types are supported:

  • Line
  • Arrow
  • Double Arrow
  • Elbow Connector
  • Elbow Arrow Connector
  • Elbow Double Arrow Connector
 

Basic Shape

Following basic Shapes are supported:

  • Text Box
  • Rectangle
  • Parallelogram
  • Trapezoid
  • Diamond
  • Rounded Rectangle
  • Octagon
  • Isosceles Triangle
  • Right Triangle
  • Oval
  • Hexagon
  • Cross
  • Regular Pentagon
  • Lightning Bolt

Currently ImageGear doesn't support curves and composite path segments for the drawing - the shape is drawn with cut corner instead of the folded corner.

Block Arrow

Following Block Arrows are supported:

  • Right Arrow
  • Left Arrow
  • Down Arrow
  • Up Arrow
  • Left-Right Arrow
  • Up-Down Arrow
  • Quad Arrow
  • Left-Right-Up Arrow
  • Left-Up Arrow
  • Bent-Up Arrow
  • Notched Right Arrow
  • Pentagon
  • Chevron
  • Right Arrow Callout
  • Down Arrow Callout
  • Left Arrow Callout
  • Up Arrow Callout
  • Left Right Arrow Callout
  • Quad Arrow Callout

The following arrow styles are supported:

  • Begin style: arrow, open arrow, oval arrow.
  • End style: arrow, open arrow, oval arrow.

The diamond arrow style is drawn as oval arrow style.

Flow Chart

Following Flow Charts are supported:

  • Process
  • Decision
  • Data
  • Preparation
  • Manual Input
  • Manual Operation
  • Off-page connector
  • Card
  • Collate
  • Extract
  • Merge
 

Stars and Banners

Following Stars and Banners are supported:

  • Explosion 1
  • Explosion 2
  • 4-Point Star
  • 5-Point Star
  • 8-Point Star
  • 16-Point Star
  • 24-Point Star
  • 32-Point Star
 

 

ImageGear supports Solid, Linear Gradient and Radial Gradient fills for Drawing Shapes. For Gradients, there are a few limitations that should be considered:

The Word ML objects not listed in the table above will not be rendered by ImageGear. Those objects might be added in a future release.

Positioning of Drawing Objects

Within a WordprocessingML document, drawing objects can exist in two states:

ImageGear supports both states. For inline drawings there are no issues, but for floating objects there are few limitations that should be considered:

Horizontal positioning:

ImageGear supports all "relative to"/"to the right of" objects, except "Inside Margin" and "Outside Margin".

Vertical positioning:

ImageGear supports all "relative to"/"below" objects, except "Inside Margin" and "Outside Margin". Additionally, if the absolute positioning is below Paragraph or below Line, only positive values are supported for position value. Negative values will lead to incorrect layout of the page. In this case, adjust the anchor of the drawing object to avoid a negative value.

Supported Wrapping styles:

Tight and Through wrap styles will be treated as a Square.

 

 


©2017. Accusoft Corporation. All Rights Reserved.

Send Feedback