Show All

# useFilter Attribute

Indicates the user wants a filter widget.

## Type

`xsd:simpleType`

## Parent Elements

Element | Description
--- | ---
editWith | (Optional element) Specifies an instance of an editing component, and provides the corresponding parameters to determine its exact behavior.

## Definition

    <xsd:attribute name="useFilter" use="optional">
      <xsd:simpleType>
        <xsd:restriction base="xsd:string">
          <xsd:enumeration value="yes"/>
          <xsd:enumeration value="no"/>
        </xsd:restriction>
      </xsd:simpleType>
    </xsd:attribute>

## Remarks

The useFilter attribute is an optional attribute of the editWith element. Its default value is "no". If the user selects the filter widget check box in the property dialog of a repeating section or repeating table, and the useFilter attribute is set to "yes", the widgetIcon attribute is set to "Filter". The useFilter attribute is only applicable for repeating sections and tables.

Note This item is not supported when the Disable Service Pack features option on the Advanced tab of the Options dialog box in InfoPath is selected or when Microsoft Office 2003 Editions Service Pack 1 or later is not installed. Any form defined by a form definition file (.xsf) that includes this item cannot be opened in InfoPath when service pack features are disabled or unavailable.

## Example

The following is an example of the useFilter attribute as it is used in the editWith element:

    <editWith component="xCollection" widgetIcon="filter|standard"
     useFilter="yes|no" filterDependency="xpath1 | xpath2 | xpath3>

©2003-2004 Microsoft Corporation. All rights reserved. Permission to copy, display and distribute this document is available at: http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp