[Table of Contents] [docx version]

SpreadsheetML Reference Material - Table of Contents

queryTableField (QueryTable Field)

This element holds the properties related to a specific field or column in a query table.

Parent Elements

queryTableFields3.12.5)

 

Child Elements

Subclause

extLst (Future Feature Data Storage Area)

§3.2.10

 

Attributes

Description

clipped (Clipped Column)

Specifies whether this field/column is currently clipped and thus not visible in the worksheet.

 

Note: this state might occur for example when a query table is defined near the edge of a worksheet or other object in the spreadsheet that can't be overwritten with external data. In this case some of the fields are displayed, but not all of them.

 

 

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

dataBound (Data Bound Column)

Specifies whether this column is a user-defined column or comes from the external data query. User defined columns shall be preserved during data refresh operations. User-defined columns are only supported on query tables that are attached to table objects.

 

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

fillFormulas (Fill This Formula On Refresh)

Specifies whether the formula in this field/column should be filled down on data refresh.

 

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

id (Field Id)

Specifies the unique identifier of the query table field.

 

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

name (Name)

Specifies the unique name of the query table field.

 

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

rowNumbers (Row Numbers)

true if this column contains the row numbers for the records returned.

 

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

tableColumnId (Table Column Id)

Specifies the unique identifier for the table column if the query table is attached to a table object rather than just a range in the sheet.

 

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

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_QueryTableField">

   <sequence minOccurs="0">

   <element name="extLst" type="CT_ExtensionList" minOccurs="0" maxOccurs="1"/>

   </sequence>

   <attribute name="id" type="xsd:unsignedInt" use="required"/>

   <attribute name="name" type="ST_Xstring" use="optional"/>

   <attribute name="dataBound" type="xsd:boolean" use="optional" default="true"/>

   <attribute name="rowNumbers" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="fillFormulas" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="clipped" type="xsd:boolean" use="optional" default="false"/>

   <attribute name="tableColumnId" type="xsd:unsignedInt" default="0"/>

</complexType>