2.2.1.2.89 editWith

The editWith element specifies an instance of a control that edits data in the form file.

Parent Elements

xmlToEdit

Child Elements

fragmentToInsert

masterDetail

Attributes:

allowedFileTypes: This attribute MUST be ignored.

autoComplete: This attribute specifies whether auto-completion of fields is on. If this attribute is not present, its value MUST be interpreted as "no".

caption: This attribute specifies an identifier for alternate forms of XML data to be used in the control. If this attribute is not present, its value MUST be interpreted as an empty string (1).

component: This attribute specifies the name of the control that is referenced by an instance of the xmlToEdit element, as specified in section 2.2.1.2.105. The specified value MUST be one of the following:

  • xCollection: A repeating section control, as specified in section 2.4.1.15, or a repeating table control, as specified in section 2.4.1.16.

  • xOptional: An optional section control, as specified in section 2.4.1.18.

  • xReplace: A choice section control, as specified in section 2.4.1.21.1.

  • xTextList: A list control, as specified in section 2.4.1.21.7.

  • xField: Specifies one of the following controls:

    • Check box control, as specified in section 2.4.1.6.

    • Combo box control, as specified in section 2.4.1.21.2.

    • Date picker control, as specified in section 2.4.1.8.

    • Drop-down list control, as specified in section 2.4.1.9.

    • Hyperlink input control, as specified in section 2.4.1.21.6.

    • List box control, as specified in section 2.4.1.13.

    • Option button control, as specified in section 2.4.1.14.

    • Rich text box control, as specified in section 2.4.1.17.

    • Text box control, as specified in section 2.4.1.20.

  • xImage: An image attachment control, as specified in section 2.4.1.21.8.

  • xFileAttachment: A file attachment control, as specified in section 2.4.1.11.

field: This attribute MUST be ignored.

filterDependency: This attribute specifies a relative XPath expression to a control that is dependent on the PREDICATE_XPATH expression. If multiple controls are dependent on the XPath expression, each control MUST be separated by ASCII character "124", which represents a logical OR.

maxLength: This attribute MUST be ignored.

proofing: This attribute MUST be ignored.

removeAncestors: This attribute MUST be ignored.

type: This attribute MUST be ignored if the specified value is not "rich". The specified value MUST be one of the following:

  • plain: The instance of the control specified by this editWidth element MUST only allow the input of unformatted text.

  • formatted: This value is deprecated.

  • plainMultiline: Same as "plain", with the additional support of newline characters.

  • formattedMultiline: This value is deprecated.

  • rich: The instance of the control specified by this editWidth element MUST allow rich formatting using HTML, as specified in [HTML], as a valid XML 1.0 fragment, as specified in [W3C-XML].If the value is "rich", the following MUST be true:

    • If the xmlToEditExtension element, as specified in section 2.2.2.2.36, is present, both the excludeEmbeddedImages and allowLinkedImages attributes of the xmlToEditExtension element MUST be set to "yes".

    • Otherwise, the clientOnly attribute of the viewExtension element, as specified in section 2.2.2.2.35, that is the parent of the xmlToEditExtension element MUST be set to "no".

useFilter: This attribute MUST be "yes" if a PREDICATE_XPATH is specified for the control. Otherwise, the attribute MUST be "no" if there is not a PREDICATE_XPATH specified for the control.

widgetIcon: This attribute specifies if an icon is displayed when a PREDICATE_XPATH has been evaluated. The value MUST be set to "filter" if a PREDICATE_XPATH is specified for the control. The value is set to “standard” when PREDICATE_XPATH is not specified for the control.

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

 <xsd:element name="editWith">
   <xsd:complexType>
     <xsd:sequence>
       <xsd:element ref="xsf:masterDetail" minOccurs="0" maxOccurs="1"/>
       <xsd:element ref="xsf:fragmentToInsert" minOccurs="0" maxOccurs="1"/>
     </xsd:sequence>
     <xsd:attribute name="component" use="required">
       <xsd:simpleType>
         <xsd:restriction base="xsd:NMTOKEN">
           <xsd:enumeration value="xCollection"/>
           <xsd:enumeration value="xOptional"/>
           <xsd:enumeration value="xReplace"/>
           <xsd:enumeration value="xTextList"/>
           <xsd:enumeration value="xField"/>
           <xsd:enumeration value="xImage"/>
           <xsd:enumeration value="xFileAttachment"/>
         </xsd:restriction>
       </xsd:simpleType>
     </xsd:attribute>
     <xsd:attribute name="caption" type="xsf:xdTitle" use="optional"/>
     <xsd:attribute name="autoComplete" type="xsf:xdYesNo" use="optional"/>
     <xsd:attribute name="proofing" type="xsf:xdYesNo" use="optional"/>
     <xsd:attribute name="type" use="optional">
       <xsd:simpleType>
         <xsd:restriction base="xsd:NMTOKEN">
           <xsd:enumeration value="plain"/>
           <xsd:enumeration value="formatted"/>
           <xsd:enumeration value="plainMultiline"/>
           <xsd:enumeration value="formattedMultiline"/>
           <xsd:enumeration value="rich"/>
         </xsd:restriction>
       </xsd:simpleType>
     </xsd:attribute>
     <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>
     <xsd:attribute name="widgetIcon" use="optional">
       <xsd:simpleType>
         <xsd:restriction base="xsd:string">
           <xsd:enumeration value="standard"/>
           <xsd:enumeration value="filter"/>
         </xsd:restriction>
       </xsd:simpleType>
     </xsd:attribute>
     <xsd:attribute name="filterDependency" type="xsd:string" use="optional"/>
     <xsd:attribute name="field" type="xsd:string" use="optional"/>
     <xsd:attribute name="removeAncestors" type="xsd:nonNegativeInteger" use="optional"/>
     <xsd:attribute name="maxLength" use="optional">
       <xsd:simpleType>
         <xsd:restriction base="xsd:integer">
           <xsd:minInclusive value="-1"/>
         </xsd:restriction>
       </xsd:simpleType>
     </xsd:attribute>
     <xsd:attribute name="allowedFileTypes" type="xsd:string" use="optional"/>
     <xsd:anyAttribute namespace="http://schemas.microsoft.com/office/infopath/2003" processContents="skip"/>
   </xsd:complexType>
 </xsd:element>