Diagram Class

VML Diagram.When the object is serialized out as xml, its qualified name is o:diagram.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Vml.Office.Diagram

Namespace:  DocumentFormat.OpenXml.Vml.Office
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(RelationTable))> _
Public Class Diagram _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As Diagram
[ChildElementInfoAttribute(typeof(RelationTable))]
public class Diagram : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • RelationTable <o:relationtable>

[ISO/IEC 29500-1 1st Edition]

14.2.2.8 diagram (VML Diagram)

This element specifies semantic information for a limited set of structured diagrams that have VML representations. Diagrams should be defined using DrawingML; this representation is included for compatibility with applications that rely on VML. The following diagram types have VML representations:

Diagram Type

Example (non-normative)

Organization chart

DocumentFormat.OpenXml.Vml.Office.Diagram-image001

Radial

DocumentFormat.OpenXml.Vml.Office.Diagram-image002

Cycle

DocumentFormat.OpenXml.Vml.Office.Diagram-image003

Pyramid

DocumentFormat.OpenXml.Vml.Office.Diagram-image004

Venn

DocumentFormat.OpenXml.Vml.Office.Diagram-image005

Bulls-eye

DocumentFormat.OpenXml.Vml.Office.Diagram-image006

Each of these types of diagrams contains shapes that are positioned relative to one another. Each shape also has optional associated text.

Parent Elements

background (Part 1, §17.2.1); group (§14.1.2.7); hdrShapeDefaults (§9.7.2.1); object (Part 1, §17.3.3.19); pict (§9.2.2.2); pict (§9.5.1); shapeDefaults (§9.7.2.2)

Child Elements

Subclause

relationtable (Diagram Relationship Table)

§14.2.2.25

Attributes

Description

autoformat (Diagram Automatic Format)

Specifies whether the diagram is formatted automatically by the application and user overrides are locked. Default is false.

[Example:

<o:diagram  autoformat="true">
</o:diagram>

end example]

The possible values for this attribute are defined by the ST_TrueFalse simple type (§15.1.2.5).

autolayout (Diagram Automatic Layout)

Specifies whether the diagram elements are laid out automatically by the application and user overrides are locked. Default is true.

[Example:

<o:diagram  autolayout="false">
</o:diagram>

end example]

The possible values for this attribute are defined by the ST_TrueFalse simple type (§15.1.2.5).

constrainbounds (Diagram Layout Extents)

Specifies an optional, application-specific parameter related to the diagram's extents intended to be used by the application to assist laying out the diagram.

[Example:

<o:diagram  constrainbounds="2910,2696,9773,9558">
</o:diagram>

end example]

The possible values for this attribute are defined by the W3C XML Schema string datatype.

dgmbasetextscale (Diagram Base Font Size)

Specifies the diagram's original font size. This is used in subsequent font size recalculations. If the most recent diagram font size is used to calculate the font size after a rescale, the font size would be wrong after non-isometric diagram rescalings.

[Example:

<o:diagram  dgmbasetextscale="12">
</o:diagram>

end example]

The possible values for this attribute are defined by the W3C XML Schema integer datatype.

dgmfontsize (Diagram Font Size)

Specifies the font size for attached text when a new diagram node is added.

[Example:

<o:diagram  dgmfontsize="12">
</o:diagram>

end example]

The possible values for this attribute are defined by the W3C XML Schema integer datatype.

dgmscalex (Diagram Layout X Scale)

Specifies an optional, application-specific parameter related to the horizontal scaling of the diagram that is intended to be used by the application to assist laying out the diagram.

[Example:

<o:diagram  dgmscalex="50000">
</o:diagram>

end example]

The possible values for this attribute are defined by the W3C XML Schema integer datatype.

dgmscaley (Diagram Layout Y Scale)

Specifies an optional, application-specific parameter related to the vertical scaling of the diagram that is intended to be used by the application to assist laying out the diagram.

[Example:

<o:diagram  dgmscaley="75000">
</o:diagram>

end example]

The possible values for this attribute are defined by the W3C XML Schema integer datatype.

dgmstyle (Diagram Style Options)

Specifies an optional, application-specific parameter related to the styling of the diagram that is intended to be used by the application to assist in formatting the diagram.

[Example:

<o:diagram  dgmstyle="1">
</o:diagram>

end example]

The possible values for this attribute are defined by the W3C XML Schema integer datatype.

ext (VML Extension Handling Behavior)

Namespace: urn:schemas-microsoft-com:vml

Specifies an optional value that indicates how applications that implement VML should interpret extensions not defined as part of the original specification of core VML.

[Rationale: This part of the original VML specification is included to assist applications that leverage existing VML support in implementing the Office Open XML Format. end rationale]

The possible values for this attribute are defined by the ST_Ext simple type (§14.1.3.2).

reverse (Diagram Reverse Direction)

Specifies whether the order of the diagram nodes is reversed. This is only relevant to diagrams that have linear ordering.

[Example:

<o:diagram  reverse="true">
</o:diagram>
DocumentFormat.OpenXml.Vml.Office.Diagram-image007DocumentFormat.OpenXml.Vml.Office.Diagram-image008

end example

The possible values for this attribute are defined by the ST_TrueFalse simple type (§15.1.2.5).

[Note: The W3C XML Schema definition of this element’s content model (CT_Diagram) is located in §A.6.2. end note]

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Diagram Members

DocumentFormat.OpenXml.Vml.Office Namespace