2.50.8 Matrix.DataElementOutput

Applies to RDL 2003/10 and RDL 2005/01

The Matrix.DataElementOutput element specifies whether a Matrix is included in a data rendering. This element is optional. If the Matrix.DataElementOutput element is present, its value MUST be a String ([XMLSCHEMA2/2] section 3.2.1) that is one of the following:

Auto (default): Specifies the default setting for how a matrix will be included in a data rendering.

Output: Specifies that the matrix is included in a data rendering.

NoOutput: Specifies that the matrix is not included in a data rendering.

ContentsOnly: Specifies that the matrix is included in a data rendering.

The value of the Matrix.DataElementOutput is interpreted as "NoOutput" if all the following conditions are true:

  • Matrix.Visibility is specified for the matrix.

  • Visibility.Hidden is specified for the Matrix.Visibility element.

  • Visibility.ToggleItem for the Matrix.Visibility element is not specified.

  • The value of Visibility.Hidden for the Matrix.Visibility element is the String literal value "true".

Alternatively, the value of the Matrix.DataElementOutput is interpreted as "NoOutput" if all the following conditions are true:

  • The matrix is contained within a table column.

  • TableColumn.Visibility is specified for the TableColumn.

  • Visibility.Hidden is specified for the TableColumn.Visibility element.

  • Visibility.ToggleItem for the TableColumn.Visibility element is not specified.

  • The value of Visibility.Hidden for the TableColumn.Visibility element is the String literal value "true".

Otherwise, the value of the Matrix.DataElementOutput element is interpreted as "Output".

If the Matrix.DataElementOutput element is not specified, its value is interpreted as "Auto".

Following is the parent element of the Matrix.DataElementOutput element.

Parent elements

Matrix

The following is the XML Schema definition of the Matrix.DataElementOutput element.

 <xsd:element name="DataElementOutput" minOccurs="0">
   <xsd:simpleType>
     <xsd:restriction base="xsd:string">
       <xsd:enumeration value="Output" />
       <xsd:enumeration value="NoOutput" />
       <xsd:enumeration value="ContentsOnly" />
       <xsd:enumeration value="Auto" />
     </xsd:restriction>
   </xsd:simpleType>
 </xsd:element>