Export (0) Print
Expand All

Diagram class

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

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

[ChildElementInfoAttribute(typeof(RelationTable))]
public class Diagram : OpenXmlCompositeElement

[ISO/IEC 29500-1 1st Edition]

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

Radial

Cycle

Pyramid

Venn

Bulls-eye

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>

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.

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

Community Additions

Show:
© 2014 Microsoft