Share via

2.4.6.2.7 CT_DataGraphics_Shape

  • Article

Referenced by: CT_DataGraphics_Page

The CT_DataGraphics_Shape complex type specifies information used to update the data graphics associated with a shape.

Child Elements:

DataGraphicDefinitions : An optional CT_DataGraphicDefinitions element. It MUST exist if Formulas does not exist.

Formulas : An optional CT_Formulas element.  It MUST exist if DataGraphicDefinitions does not exist.

FormulaReferences : An optional CT_FormulaReferences element.  It MUST NOT exist if Formulas does not exist.

Attributes:

ID : An xsd:string ([XMLSCHEMA2] section 3.2.1) attribute that specifies an identifier for the data graphic. It MUST NOT be an empty string and MUST be unique amongst the ID attributes of the CT_DataGraphics_Shape elements in this XML part.

ShapeName : An xsd:string ([XMLSCHEMA2] section 3.2.1) attribute that specifies the identifier of the shape that references this data graphic. It MUST match the Name attribute of a Canvas element in the ShapeGraphic Part.

DataRefs : An optional xsd:string ([XMLSCHEMA2] section 3.2.1) attribute that specifies the external data that is bound to this data graphic. If this attribute does not exist or if it is an empty string then the external data bound to this data graphic is unknown.  If a string for this attribute does exist it MUST have the following format:

  rowID1,colID1;rowID2,colID2;…;rowIDn,colIDn

Name

Description

rowID

An integer that specifies the row in the recordset that this shape is bound to. MUST be the value of the BindingID attribute of a CT_Binding element in the DataBinding XML Part.

colID

A string that specifies the field in the recordset that this shape is bound to. MUST be the value of the Name attribute of a CT_DataColumn element in the DataConnection XML Part.

The following W3C XML Schema ([XMLSCHEMA1] section 2.1) fragment specifies the contents of this complex type.

 <xsd:complexType name="CT_DataGraphics_Shape">
   <xsd:sequence>
     <xsd:element name="DataGraphicDefinitions" minOccurs="0" maxOccurs="1" type="CT_DataGraphicDefinitions"/>
     <xsd:element name="Formulas" minOccurs="0" maxOccurs="1" type="CT_Formulas"/>
     <xsd:element name="FormulaReferences" minOccurs="0" maxOccurs="1" type="CT_FormulaReferences"/>
   </xsd:sequence>
   <xsd:attribute name="ID" type="xsd:string" use="required"/>
   <xsd:attribute name="ShapeName" type="xsd:string" use="required"/>
   <xsd:attribute name="DataRefs" type="xsd:string" use="optional"/>
 </xsd:complexType>